1 |
/* wptGPGOptSkel.h - Options.skel file from the G10 directory. |
2 |
* Copyright (C) 2000, 2001, 2002, 2003 Timo Schulz |
3 |
* |
4 |
* This file is part of WinPT. |
5 |
* |
6 |
* WinPT is free software; you can redistribute it and/or |
7 |
* modify it under the terms of the GNU General Public License |
8 |
* as published by the Free Software Foundation; either version 2 |
9 |
* of the License, or (at your option) any later version. |
10 |
* |
11 |
* WinPT is distributed in the hope that it will be useful, |
12 |
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
13 |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
14 |
* General Public License for more details. |
15 |
* |
16 |
* You should have received a copy of the GNU General Public License |
17 |
* along with WinPT; if not, write to the Free Software Foundation, |
18 |
* Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
19 |
*/ |
20 |
|
21 |
#ifndef WPT_GPGOPTSKEL_H |
22 |
#define WPT_GPGOPTSKEL_H |
23 |
|
24 |
/* gpg 1.2.3-cvs */ |
25 |
static const char options_skel[] = |
26 |
"# Options for GnuPG\r\n" |
27 |
"# Copyright 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.\r\n" |
28 |
"# \r\n" |
29 |
"# This file is free software; as a special exception the author gives\r\n" |
30 |
"# unlimited permission to copy and/or distribute it, with or without\r\n" |
31 |
"# modifications, as long as this notice is preserved.\r\n" |
32 |
"# \r\n" |
33 |
"# This file is distributed in the hope that it will be useful, but\r\n" |
34 |
"# WITHOUT ANY WARRANTY, to the extent permitted by law; without even the\r\n" |
35 |
"# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\r\n" |
36 |
"#\r\n" |
37 |
"# Unless you specify which option file to use (with the command line\r\n" |
38 |
"# option \"--options filename\"), GnuPG uses the file ~/.gnupg/gpg.conf\r\n" |
39 |
"# by default.\r\n" |
40 |
"#\r\n" |
41 |
"# An options file can contain any long options which are available in\r\n" |
42 |
"# GnuPG. If the first non white space character of a line is a '#',\r\n" |
43 |
"# this line is ignored. Empty lines are also ignored.\r\n" |
44 |
"#\r\n" |
45 |
"# See the man page for a list of options.\r\n" |
46 |
"\r\n" |
47 |
"# Uncomment the following option to get rid of the copyright notice\r\n" |
48 |
"\r\n" |
49 |
"#no-greeting\r\n" |
50 |
"\r\n" |
51 |
"# If you have more than 1 secret key in your keyring, you may want to\r\n" |
52 |
"# uncomment the following option and set your preferred keyid.\r\n" |
53 |
"\r\n" |
54 |
"#default-key DEADBEEF\r\n" |
55 |
"\r\n" |
56 |
"# If you do not pass a recipient to gpg, it will ask for one. Using\r\n" |
57 |
"# this option you can encrypt to a default key. Key validation will\r\n" |
58 |
"# not be done in this case. The second form uses the default key as\r\n" |
59 |
"# default recipient.\r\n" |
60 |
"\r\n" |
61 |
"#default-recipient some-user-id\r\n" |
62 |
"#default-recipient-self\r\n" |
63 |
"\r\n" |
64 |
"# By default GnuPG creates version 3 signatures for data files. This\r\n" |
65 |
"# is not strictly OpenPGP compliant but PGP 6 and most versions of PGP\r\n" |
66 |
"# 7 require them. To disable this behavior, you may use this option\r\n" |
67 |
"# or --openpgp.\r\n" |
68 |
"\r\n" |
69 |
"#no-force-v3-sigs\r\n" |
70 |
"\r\n" |
71 |
"# Because some mailers change lines starting with \"From \" to \">From \"\r\n" |
72 |
"# it is good to handle such lines in a special way when creating\r\n" |
73 |
"# cleartext signatures; all other PGP versions do it this way too.\r\n" |
74 |
"# To enable full OpenPGP compliance you may want to use this option.\r\n" |
75 |
"\r\n" |
76 |
"#no-escape-from-lines\r\n" |
77 |
"\r\n" |
78 |
"# If you do not use the Latin-1 (ISO-8859-1) charset, you should tell\r\n" |
79 |
"# GnuPG which is the native character set. Please check the man page\r\n" |
80 |
"# for supported character sets. This character set is only used for\r\n" |
81 |
"# metadata and not for the actual message which does not undergo any\r\n" |
82 |
"# translation. Note that future version of GnuPG will change to UTF-8\r\n" |
83 |
"# as default character set.\r\n" |
84 |
"\r\n" |
85 |
"#charset utf-8\r\n" |
86 |
"\r\n" |
87 |
"# Group names may be defined like this:\r\n" |
88 |
"# group mynames = paige 0x12345678 joe patti\r\n" |
89 |
"#\r\n" |
90 |
"# Any time \"mynames\" is a recipient (-r or --recipient), it will be\r\n" |
91 |
"# expanded to the names \"paige\", \"joe\", and \"patti\", and the key ID\r\n" |
92 |
"# \"0x12345678\". Note there is only one level of expansion - you\r\n" |
93 |
"# cannot make an group that points to another group. Note also that\r\n" |
94 |
"# if there are spaces in the recipient name, this will appear as two\r\n" |
95 |
"# recipients. In these cases it is better to use the key ID.\r\n" |
96 |
"\r\n" |
97 |
"#group mynames = paige 0x12345678 joe patti\r\n" |
98 |
"\r\n" |
99 |
"# Some old Windows platforms require 8.3 filenames. If your system\r\n" |
100 |
"# can handle long filenames, uncomment this.\r\n" |
101 |
"\r\n" |
102 |
"no-mangle-dos-filenames\r\n" |
103 |
"\r\n" |
104 |
"# Lock the file only once for the lifetime of a process. If you do\r\n" |
105 |
"# not define this, the lock will be obtained and released every time\r\n" |
106 |
"# it is needed - normally this is not needed.\r\n" |
107 |
"\r\n" |
108 |
"#lock-once\r\n" |
109 |
"\r\n" |
110 |
"# GnuPG can send and receive keys to and from a keyserver. These\r\n" |
111 |
"# servers can be HKP, email, or LDAP (if GnuPG is built with LDAP\r\n" |
112 |
"# support).\r\n" |
113 |
"#\r\n" |
114 |
"# Example HKP keyserver:\r\n" |
115 |
"# x-hkp://pgp.mit.edu\r\n" |
116 |
"#\r\n" |
117 |
"# Example email keyserver:\r\n" |
118 |
"# mailto:[email protected]\r\n" |
119 |
"#\r\n" |
120 |
"# Example LDAP keyservers:\r\n" |
121 |
"# ldap://pgp.surfnet.nl:11370\r\n" |
122 |
"# ldap://keyserver.pgp.com\r\n" |
123 |
"#\r\n" |
124 |
"# Regular URL syntax applies, and you can set an alternate port\r\n" |
125 |
"# through the usual method:\r\n" |
126 |
"# x-hkp://keyserver.example.net:22742\r\n" |
127 |
"#\r\n" |
128 |
"# If you have problems connecting to a HKP server through a buggy http\r\n" |
129 |
"# proxy, you can use keyserver option broken-http-proxy (see below),\r\n" |
130 |
"# but first you should make sure that you have read the man page\r\n" |
131 |
"# regarding proxies (keyserver option honor-http-proxy)\r\n" |
132 |
"#\r\n" |
133 |
"# Most users just set the name and type of their preferred keyserver.\r\n" |
134 |
"# Most servers do synchronize with each other and DNS round-robin may\r\n" |
135 |
"# give you a quasi-random server each time.\r\n" |
136 |
"\r\n" |
137 |
"#keyserver x-hkp://pgp.mit.edu\r\n" |
138 |
"#keyserver mailto:[email protected]\r\n" |
139 |
"#keyserver ldap://pgp.surfnet.nl:11370\r\n" |
140 |
"#keyserver ldap://keyserver.pgp.com\r\n" |
141 |
"\r\n" |
142 |
"# Common options for keyserver functions:\r\n" |
143 |
"#\r\n" |
144 |
"# include-disabled = when searching, include keys marked as \"disabled\"\r\n" |
145 |
"# on the keyserver (not all keyservers support this).\r\n" |
146 |
"#\r\n" |
147 |
"# no-include-revoked = when searching, do not include keys marked as\r\n" |
148 |
"# \"revoked\" on the keyserver.\r\n" |
149 |
"#\r\n" |
150 |
"# verbose = show more information as the keys are fetched.\r\n" |
151 |
"# Can be used more than once to increase the amount\r\n" |
152 |
"# of information shown.\r\n" |
153 |
"#\r\n" |
154 |
"# use-temp-files = use temporary files instead of a pipe to talk to the\r\n" |
155 |
"# keyserver. Some platforms (Win32 for one) always\r\n" |
156 |
"# have this on.\r\n" |
157 |
"#\r\n" |
158 |
"# keep-temp-files = do not delete temporary files after using them\r\n" |
159 |
"# (really only useful for debugging)\r\n" |
160 |
"#\r\n" |
161 |
"# honor-http-proxy = if the keyserver uses HTTP, honor the http_proxy\r\n" |
162 |
"# environment variable\r\n" |
163 |
"#\r\n" |
164 |
"# broken-http-proxy = try to work around a buggy HTTP proxy\r\n" |
165 |
"#\r\n" |
166 |
"# auto-key-retrieve = automatically fetch keys as needed from the keyserver\r\n" |
167 |
"# when verifying signatures or when importing keys that\r\n" |
168 |
"# have been revoked by a revocation key that is not\r\n" |
169 |
"# present on the keyring.\r\n" |
170 |
"#\r\n" |
171 |
"# no-include-attributes = do not include attribute IDs (aka \"photo IDs\")\r\n" |
172 |
"# when sending keys to the keyserver.\r\n" |
173 |
"\r\n" |
174 |
"#keyserver-options auto-key-retrieve\r\n" |
175 |
"\r\n" |
176 |
"# Uncomment this line to display photo user IDs in key listings and\r\n" |
177 |
"# when a signature from a key with a photo is verified.\r\n" |
178 |
"\r\n" |
179 |
"#show-photos\r\n" |
180 |
"\r\n" |
181 |
"# Use this program to display photo user IDs\r\n" |
182 |
"#\r\n" |
183 |
"# %i is expanded to a temporary file that contains the photo.\r\n" |
184 |
"# %I is the same as %i, but the file isn't deleted afterwards by GnuPG.\r\n" |
185 |
"# %k is expanded to the key ID of the key.\r\n" |
186 |
"# %K is expanded to the long OpenPGP key ID of the key.\r\n" |
187 |
"# %t is expanded to the extension of the image (e.g. \"jpg\").\r\n" |
188 |
"# %T is expanded to the MIME type of the image (e.g. \"image/jpeg\").\r\n" |
189 |
"# %f is expanded to the fingerprint of the key.\r\n" |
190 |
"# %% is %, of course.\r\n" |
191 |
"#\r\n" |
192 |
"# If %i or %I are not present, then the photo is supplied to the\r\n" |
193 |
"# viewer on standard input. If your platform supports it, standard\r\n" |
194 |
"# input is the best way to do this as it avoids the time and effort in\r\n" |
195 |
"# generating and then cleaning up a secure temp file.\r\n" |
196 |
"#\r\n" |
197 |
"# The default program is \"xloadimage -fork -quiet -title 'KeyID 0x%k' stdin\"\r\n" |
198 |
"# On Mac OS X and Windows, the default is to use your regular JPEG image\r\n" |
199 |
"# viewer.\r\n" |
200 |
"#\r\n" |
201 |
"# Some other viewers:\r\n" |
202 |
"# photo-viewer \"qiv %i\"\r\n" |
203 |
"# photo-viewer \"ee %i\"\r\n" |
204 |
"# photo-viewer \"display -title 'KeyID 0x%k'\"\r\n" |
205 |
"#\r\n" |
206 |
"# This one saves a copy of the photo ID in your home directory:\r\n" |
207 |
"# photo-viewer \"cat > ~/photoid-for-key-%k.%t\"\r\n" |
208 |
"#\r\n" |
209 |
"# Use your MIME handler to view photos:\r\n" |
210 |
"# photo-viewer \"metamail -q -d -b -c %T -s 'KeyID 0x%k' -f GnuPG\"\r\n" |
211 |
"\r\n" |
212 |
"# Passphrase agent\r\n" |
213 |
"#\r\n" |
214 |
"# We support the old experimental passphrase agent protocol as well as\r\n" |
215 |
"# the new Assuan based one (currently available in the \"newpg\" package\r\n" |
216 |
"# at ftp.gnupg.org/gcrypt/alpha/aegypten/). To make use of the agent,\r\n" |
217 |
"# you have to run an agent as daemon and use the option\r\n" |
218 |
"#\r\n" |
219 |
"# use-agent\r\n" |
220 |
"#\r\n" |
221 |
"# which tries to use the agent but will fallback to the regular mode\r\n" |
222 |
"# if there is a problem connecting to the agent. The normal way to\r\n" |
223 |
"# locate the agent is by looking at the environment variable\r\n" |
224 |
"# GPG_AGENT_INFO which should have been set during gpg-agent startup.\r\n" |
225 |
"# In certain situations the use of this variable is not possible, thus\r\n" |
226 |
"# the option\r\n" |
227 |
"# \r\n" |
228 |
"# --gpg-agent-info=<path>:<pid>:1\r\n" |
229 |
"#\r\n" |
230 |
"# may be used to override it.\r\n"; |
231 |
|
232 |
|
233 |
#endif /* WPT_GPGOPTSKEL_H */ |