* options.c, gpg.c (main), keyserver.c (keyserver_spawn): No special
[gnupg.git] / g10 / options.h
1 /* options.h
2  * Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004,
3  *               2005 Free Software Foundation, Inc.
4  *
5  * This file is part of GnuPG.
6  *
7  * GnuPG 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  * GnuPG 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, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
20  * USA.
21  */
22 #ifndef G10_OPTIONS_H
23 #define G10_OPTIONS_H
24
25 #include <sys/types.h>
26 #include <types.h>
27 #include "main.h"
28 #include "packet.h"
29
30 #ifndef EXTERN_UNLESS_MAIN_MODULE
31 /* Norcraft can't cope with common symbols */
32 #if defined (__riscos__) && !defined (INCLUDED_BY_MAIN_MODULE)
33 #define EXTERN_UNLESS_MAIN_MODULE extern
34 #else
35 #define EXTERN_UNLESS_MAIN_MODULE 
36 #endif
37 #endif
38
39 EXTERN_UNLESS_MAIN_MODULE
40 struct
41 {
42   int verbose;
43   int quiet;
44   unsigned debug;
45   int armor;
46   char *outfile;
47   off_t max_output;
48   int dry_run;
49   int list_only;
50   int textmode;
51   int expert;
52   const char *def_sig_expire;
53   int ask_sig_expire;
54   const char *def_cert_expire;
55   int ask_cert_expire;
56   int batch;        /* run in batch mode */
57   int answer_yes; /* answer yes on most questions */
58   int answer_no;  /* answer no on most questions */
59   int check_sigs; /* check key signatures */
60   int with_colons;
61   int with_key_data;
62   int with_fingerprint; /* opt --with-fingerprint active */
63   int fingerprint; /* list fingerprints */
64   int list_sigs;   /* list signatures */
65   int no_armor;
66   int list_packets; /* list-packets mode: 1=normal, 2=invoked by command*/
67   int def_cipher_algo;
68   int force_v3_sigs;
69   int force_v4_certs;
70   int force_mdc;
71   int disable_mdc;
72   int def_digest_algo;
73   int cert_digest_algo;
74   int compress_algo;
75   int compress_level;
76   int bz2_compress_level;
77   int bz2_decompress_lowmem;
78   const char *def_secret_key;
79   char *def_recipient;
80   int def_recipient_self;
81   int def_cert_level;
82   int min_cert_level;
83   int ask_cert_level;
84   int no_version;
85   int marginals_needed;
86   int completes_needed;
87   int max_cert_depth;
88   const char *homedir;
89
90   char *display;      /* 5 options to be passed to the gpg-agent */
91   char *ttyname;     
92   char *ttytype;
93   char *lc_ctype;
94   char *lc_messages;
95
96   int skip_verify;
97   int compress_keys;
98   int compress_sigs;
99   /* TM_CLASSIC must be zero to accomodate trustdbs generated before
100      we started storing the trust model inside the trustdb. */
101   enum
102     {
103       TM_CLASSIC=0, TM_PGP=1, TM_EXTERNAL=2, TM_ALWAYS, TM_DIRECT, TM_AUTO
104     } trust_model;
105   int force_ownertrust;
106   int pka_trust_increase;  /* Valid PKA information increases the trust. */
107   int allow_pka_lookup;    /* PKA lookups are only done if this is set. */
108   enum
109     {
110       CO_GNUPG=0, CO_RFC2440, CO_RFC1991, CO_PGP2, CO_PGP6, CO_PGP7, CO_PGP8
111     } compliance;
112   enum
113     {
114       KF_SHORT, KF_LONG, KF_0xSHORT, KF_0xLONG
115     } keyid_format;
116   int pgp2_workarounds;
117   int shm_coprocess;
118   const char *set_filename;
119   STRLIST comments;
120   int throw_keyid;
121   const char *photo_viewer;
122   int s2k_mode;
123   int s2k_digest_algo;
124   int s2k_cipher_algo;
125   int simple_sk_checksum; /* create the deprecated rfc2440 secret
126                              key protection*/
127   int not_dash_escaped;
128   int escape_from;
129   int lock_once;
130   struct keyserver_spec
131   {
132     char *uri;
133     char *scheme;
134     char *auth;
135     char *host;
136     char *port;
137     char *path;
138     char *opaque;
139     STRLIST options;
140     struct
141     {
142       unsigned int direct_uri:1;
143     } flags;
144   } *keyserver;
145   struct
146   {
147     unsigned int options;
148     unsigned int import_options;
149     unsigned int export_options;
150     STRLIST other;
151   } keyserver_options;
152   int exec_disable;
153   int exec_path_set;
154   unsigned int import_options;
155   unsigned int export_options;
156   unsigned int list_options;
157   unsigned int verify_options;
158   char *def_preference_list;
159   prefitem_t *personal_cipher_prefs;
160   prefitem_t *personal_digest_prefs;
161   prefitem_t *personal_compress_prefs;
162   int no_perm_warn;
163   int no_mdc_warn;
164   char *temp_dir;
165   int no_encrypt_to;
166   int interactive;
167   STRLIST sig_notation_data;
168   STRLIST cert_notation_data;
169   STRLIST sig_policy_url;
170   STRLIST cert_policy_url;
171   STRLIST sig_keyserver_url;
172   STRLIST cert_subpackets;
173   STRLIST sig_subpackets;
174   int use_embedded_filename;
175   int allow_non_selfsigned_uid;
176   int allow_freeform_uid;
177   int no_literal;
178   ulong set_filesize;
179   int fast_list_mode;
180   int fixed_list_mode;
181   int ignore_time_conflict;
182   int ignore_valid_from;
183   int ignore_crc_error;
184   int ignore_mdc_error;
185   int command_fd;
186   const char *override_session_key;
187   int show_session_key;
188   int use_agent;
189   const char *gpg_agent_info;
190   int try_all_secrets;
191   int no_expensive_trust_checks;
192   int no_sig_cache;
193   int no_sig_create_check;
194   int no_auto_check_trustdb;
195   int preserve_permissions;
196   int no_homedir_creation;
197   struct groupitem *grouplist;
198   int strict;
199   int mangle_dos_filenames;
200   int enable_progress_filter;
201   unsigned int screen_columns;
202   unsigned int screen_lines;
203   byte *show_subpackets;
204   int rfc2440_text;
205
206   /* If true, let write failures on the status-fd exit the process. */
207   int exit_on_status_write_error;
208
209   /* If > 0, limit the number of card insertion prompts to this
210      value. */
211   int limit_card_insert_tries; 
212
213 #ifdef ENABLE_CARD_SUPPORT
214   const char *ctapi_driver; /* Library to access the ctAPI. */
215   const char *pcsc_driver;  /* Library to access the PC/SC system. */
216   int disable_ccid;    /* Disable the use of the internal CCID driver. */
217 #endif /*ENABLE_CARD_SUPPORT*/
218
219   /* If set, require an 0x19 backsig to be present on signatures made
220      by signing subkeys.  If not set, a missing backsig is not an
221      error (but an invalid backsig still is). */
222   int require_backsigs;
223
224   /* Linked list of ways to find a key if the key isn't on the local
225      keyring. */
226   struct akl
227   {
228     enum {AKL_CERT, AKL_PKA, AKL_LDAP, AKL_KEYSERVER, AKL_SPEC} type;
229     struct keyserver_spec *spec;
230     struct akl *next;
231   } *auto_key_locate;
232
233 } opt;
234
235 /* CTRL is used to keep some global variables we currently can't
236    avoid.  Future concurrent versions of gpg will put it into a per
237    request structure CTRL. */
238 EXTERN_UNLESS_MAIN_MODULE
239 struct {
240   int in_auto_key_retrieve; /* True if we are doing an
241                                auto_key_retrieve. */
242 } glo_ctrl;
243
244 #define DBG_PACKET_VALUE  1     /* debug packet reading/writing */
245 #define DBG_MPI_VALUE     2     /* debug mpi details */
246 #define DBG_CIPHER_VALUE  4     /* debug cipher handling */
247                                 /* (may reveal sensitive data) */
248 #define DBG_FILTER_VALUE  8     /* debug internal filter handling */
249 #define DBG_IOBUF_VALUE   16    /* debug iobuf stuff */
250 #define DBG_MEMORY_VALUE  32    /* debug memory allocation stuff */
251 #define DBG_CACHE_VALUE   64    /* debug the cacheing */
252 #define DBG_MEMSTAT_VALUE 128   /* show memory statistics */
253 #define DBG_TRUST_VALUE   256   /* debug the trustdb */
254 #define DBG_HASHING_VALUE 512   /* debug hashing operations */
255 #define DBG_EXTPROG_VALUE 1024  /* debug external program calls */
256 #define DBG_CARD_IO_VALUE 2048  /* debug smart card I/O.  */
257
258 #define DBG_PACKET (opt.debug & DBG_PACKET_VALUE)
259 #define DBG_FILTER (opt.debug & DBG_FILTER_VALUE)
260 #define DBG_CACHE  (opt.debug & DBG_CACHE_VALUE)
261 #define DBG_TRUST  (opt.debug & DBG_TRUST_VALUE)
262 #define DBG_HASHING (opt.debug & DBG_HASHING_VALUE)
263 #define DBG_EXTPROG (opt.debug & DBG_EXTPROG_VALUE)
264 #define DBG_CARD_IO (opt.debug & DBG_CARD_IO_VALUE)
265
266
267 #define GNUPG   (opt.compliance==CO_GNUPG)
268 #define RFC1991 (opt.compliance==CO_RFC1991 || opt.compliance==CO_PGP2)
269 #define RFC2440 (opt.compliance==CO_RFC2440)
270 #define PGP2    (opt.compliance==CO_PGP2)
271 #define PGP6    (opt.compliance==CO_PGP6)
272 #define PGP7    (opt.compliance==CO_PGP7)
273 #define PGP8    (opt.compliance==CO_PGP8)
274
275 /* Various option flags.  Note that there should be no common string
276    names between the IMPORT_ and EXPORT_ flags as they can be mixed in
277    the keyserver-options option. */
278
279 #define IMPORT_LOCAL_SIGS                (1<<0)
280 #define IMPORT_REPAIR_PKS_SUBKEY_BUG     (1<<1)
281 #define IMPORT_FAST                      (1<<2)
282 #define IMPORT_SK2PK                     (1<<3)
283 #define IMPORT_MERGE_ONLY                (1<<4)
284 #define IMPORT_MINIMAL                   (1<<5)
285 #define IMPORT_CLEAN                     (1<<6)
286
287 #define EXPORT_LOCAL_SIGS                (1<<0)
288 #define EXPORT_ATTRIBUTES                (1<<1)
289 #define EXPORT_SENSITIVE_REVKEYS         (1<<2)
290 #define EXPORT_RESET_SUBKEY_PASSWD       (1<<3)
291 #define EXPORT_MINIMAL                   (1<<4)
292 #define EXPORT_CLEAN                     (1<<5)
293
294 #define LIST_SHOW_PHOTOS                 (1<<0)
295 #define LIST_SHOW_POLICY_URLS            (1<<1)
296 #define LIST_SHOW_STD_NOTATIONS          (1<<2)
297 #define LIST_SHOW_USER_NOTATIONS         (1<<3)
298 #define LIST_SHOW_NOTATIONS (LIST_SHOW_STD_NOTATIONS|LIST_SHOW_USER_NOTATIONS)
299 #define LIST_SHOW_KEYSERVER_URLS         (1<<4)
300 #define LIST_SHOW_UID_VALIDITY           (1<<5)
301 #define LIST_SHOW_UNUSABLE_UIDS          (1<<6)
302 #define LIST_SHOW_UNUSABLE_SUBKEYS       (1<<7)
303 #define LIST_SHOW_KEYRING                (1<<8)
304 #define LIST_SHOW_SIG_EXPIRE             (1<<9)
305 #define LIST_SHOW_SIG_SUBPACKETS         (1<<10)
306
307 #define VERIFY_SHOW_PHOTOS               (1<<0)
308 #define VERIFY_SHOW_POLICY_URLS          (1<<1)
309 #define VERIFY_SHOW_STD_NOTATIONS        (1<<2)
310 #define VERIFY_SHOW_USER_NOTATIONS       (1<<3)
311 #define VERIFY_SHOW_NOTATIONS (VERIFY_SHOW_STD_NOTATIONS|VERIFY_SHOW_USER_NOTATIONS)
312 #define VERIFY_SHOW_KEYSERVER_URLS       (1<<4)
313 #define VERIFY_SHOW_UID_VALIDITY         (1<<5)
314 #define VERIFY_SHOW_UNUSABLE_UIDS        (1<<6)
315
316 #define KEYSERVER_USE_TEMP_FILES         (1<<0)
317 #define KEYSERVER_KEEP_TEMP_FILES        (1<<1)
318 #define KEYSERVER_ADD_FAKE_V3            (1<<2)
319 #define KEYSERVER_AUTO_KEY_RETRIEVE      (1<<3)
320 #define KEYSERVER_HONOR_KEYSERVER_URL    (1<<4)
321 #define KEYSERVER_HONOR_PKA_RECORD       (1<<5)
322
323 #endif /*G10_OPTIONS_H*/