Make it build on W32 again.
[gnupg.git] / dirmngr / dirmngr.h
1 /* dirmngr.h - Common definitions for the dirmngr
2  *      Copyright (C) 2002 Klarälvdalens Datakonsult AB
3  *      Copyright (C) 2004 g10 Code GmbH
4  *
5  * This file is part of DirMngr.
6  *
7  * DirMngr is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * DirMngr is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, see <http://www.gnu.org/licenses/>.
19  */
20
21 #ifndef DIRMNGR_H
22 #define DIRMNGR_H
23
24 #ifdef GPG_ERR_SOURCE_DEFAULT
25 #error GPG_ERR_SOURCE_DEFAULT already defined
26 #endif
27 #define GPG_ERR_SOURCE_DEFAULT  GPG_ERR_SOURCE_DIRMNGR
28 #include <gpg-error.h>
29 #define map_assuan_err(a) \
30         map_assuan_err_with_source (GPG_ERR_SOURCE_DEFAULT, (a))
31 #include <errno.h>
32 #include <gcrypt.h>
33 #include <ksba.h>
34
35 #include "../common/util.h"
36 #include "../common/membuf.h"
37 #include "../common/sysutils.h" /* (gnupg_fd_t) */
38 #include "../common/i18n.h"
39
40
41 /* This objects keeps information about a particular LDAP server and
42    is used as item of a single linked list of servers. */
43 struct ldap_server_s 
44 {
45   struct ldap_server_s* next;
46   
47   char *host;
48   int   port;
49   char *user;
50   char *pass;
51   char *base;
52 };
53 typedef struct ldap_server_s *ldap_server_t;
54
55
56 /* A list of fingerprints.  */
57 struct fingerprint_list_s;
58 typedef struct fingerprint_list_s *fingerprint_list_t;
59 struct fingerprint_list_s
60 {
61   fingerprint_list_t next;
62   char hexfpr[20+20+1];
63 };
64
65
66 /* A large struct named "opt" to keep global flags.  */
67 struct 
68 {
69   unsigned int debug; /* debug flags (DBG_foo_VALUE) */
70   int verbose;        /* verbosity level */
71   int quiet;          /* be as quiet as possible */
72   int dry_run;        /* don't change any persistent data */
73   int batch;          /* batch mode */
74   const char *homedir;      /* Configuration directory name */
75   const char *homedir_data; /* Ditto for data files (/usr/share/dirmngr).  */
76   const char *homedir_cache; /* Ditto for cache files (/var/cache/dirmngr).  */
77
78   char *config_filename;     /* Name of a config file, which will be
79                                 reread on a HUP if it is not NULL. */
80
81   char *ldap_wrapper_program; /* Override value for the LDAP wrapper
82                                  program.  */
83   char *http_wrapper_program; /* Override value for the HTTP wrapper
84                                  program.  */
85
86   int system_service;   /* We are running as W32 service (implies daemon).  */
87   int system_daemon;    /* We are running in system daemon mode.  */
88   int running_detached; /* We are running in detached mode.  */
89
90   int force;          /* Force loading outdated CRLs. */
91
92   int disable_http;       /* Do not use HTTP at all.  */
93   int disable_ldap;       /* Do not use LDAP at all.  */
94   int honor_http_proxy;   /* Honor the http_proxy env variable. */
95   const char *http_proxy; /* Use given HTTP proxy.  */
96   const char *ldap_proxy; /* Use given LDAP proxy.  */
97   int only_ldap_proxy;    /* Only use the LDAP proxy; no fallback.  */
98   int ignore_http_dp;     /* Ignore HTTP CRL distribution points.  */
99   int ignore_ldap_dp;     /* Ignore LDAP CRL distribution points.  */
100   int ignore_ocsp_service_url; /* Ignore OCSP service URLs as given in
101                                   the certificate.  */
102
103   /* A list of certificate extension OIDs which are ignored so that
104      one can claim that a critical extension has been handled.  One
105      OID per string.  */
106   strlist_t ignored_cert_extensions;
107
108   int allow_ocsp;     /* Allow using OCSP. */
109
110   int max_replies;
111   unsigned int ldaptimeout;
112   
113   ldap_server_t ldapservers;
114   int add_new_ldapservers;
115
116   const char *ocsp_responder;     /* Standard OCSP responder's URL. */
117   fingerprint_list_t ocsp_signer; /* The list of fingerprints with allowed
118                                      standard OCSP signer certificates.  */
119   
120   unsigned int ocsp_max_clock_skew; /* Allowed seconds of clocks skew. */
121   unsigned int ocsp_max_period;     /* Seconds a response is at maximum
122                                        considered valid after thisUpdate. */
123   unsigned int ocsp_current_period; /* Seconds a response is considered 
124                                        current after nextUpdate. */
125 } opt;
126
127
128 #define DBG_X509_VALUE    1     /* debug x.509 parsing */
129 #define DBG_LOOKUP_VALUE  2     /* debug lookup details */
130 #define DBG_CRYPTO_VALUE  4     /* debug low level crypto */
131 #define DBG_MEMORY_VALUE  32    /* debug memory allocation stuff */
132 #define DBG_CACHE_VALUE   64    /* debug the caching */
133 #define DBG_MEMSTAT_VALUE 128   /* show memory statistics */
134 #define DBG_HASHING_VALUE 512   /* debug hashing operations */
135 #define DBG_ASSUAN_VALUE  1024  /* debug assuan communication */
136
137 #define DBG_X509    (opt.debug & DBG_X509_VALUE)
138 #define DBG_LOOKUP  (opt.debug & DBG_LOOKUP_VALUE)
139 #define DBG_CRYPTO  (opt.debug & DBG_CRYPTO_VALUE)
140 #define DBG_MEMORY  (opt.debug & DBG_MEMORY_VALUE)
141 #define DBG_CACHE   (opt.debug & DBG_CACHE_VALUE)
142 #define DBG_HASHING (opt.debug & DBG_HASHING_VALUE)
143 #define DBG_ASSUAN   (opt.debug & DBG_ASSUAN_VALUE)
144
145 /* A simple list of certificate references. */
146 struct cert_ref_s
147 {
148   struct cert_ref_s *next;
149   unsigned char fpr[20];
150 };
151 typedef struct cert_ref_s *cert_ref_t;
152
153 /* Forward references; access only through server.c.  */
154 struct server_local_s;
155
156 /* Connection control structure.  */
157 struct server_control_s
158 {
159   int refcount;      /* Count additional references to this object.  */
160   int no_server;     /* We are not running under server control. */
161   int status_fd;     /* Only for non-server mode. */
162   struct server_local_s *server_local;
163   int force_crl_refresh; /* Always load a fresh CRL. */
164   
165   int check_revocations_nest_level; /* Internal to check_revovations.  */
166   cert_ref_t ocsp_certs; /* Certificates from the current OCSP
167                             response. */
168
169   int audit_events;  /* Send audit events to client.  */
170 };
171
172
173 /*-- dirmngr.c --*/
174 void dirmngr_exit( int );  /* Wrapper for exit() */
175 void dirmngr_init_default_ctrl (ctrl_t ctrl);
176
177 /*-- server.c --*/
178 ldap_server_t get_ldapservers_from_ctrl (ctrl_t ctrl);
179 ksba_cert_t get_cert_local (ctrl_t ctrl, const char *issuer);
180 ksba_cert_t get_issuing_cert_local (ctrl_t ctrl, const char *issuer);
181 ksba_cert_t get_cert_local_ski (ctrl_t ctrl,
182                                 const char *name, ksba_sexp_t keyid);
183 gpg_error_t get_istrusted_from_client (ctrl_t ctrl, const char *hexfpr);
184 void start_command_handler (gnupg_fd_t fd);
185 gpg_error_t dirmngr_status (ctrl_t ctrl, const char *keyword, ...);
186 gpg_error_t dirmngr_tick (ctrl_t ctrl);
187
188
189 #endif /*DIRMNGR_H*/