g10/options.skel

   1 # These first three lines are not copied to the gpg.conf file in
   2 # the users home directory.
   3 # $Id$
   4 # Options for GnuPG
   5 # Copyright 1998-2003, 2010 Free Software Foundation, Inc.
   6 # Copyright 1998-2003, 2010 Werner Koch
   7 #
   8 # This file is free software; as a special exception the author gives
   9 # unlimited permission to copy and/or distribute it, with or without
  10 # modifications, as long as this notice is preserved.
  11 #
  12 # This file is distributed in the hope that it will be useful, but
  13 # WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
  14 # implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  15 #
  16 # Unless you specify which option file to use (with the command line
  17 # option "--options filename"), GnuPG uses the file ~/.gnupg/gpg.conf
  18 # by default.
  19 #
  20 # An options file can contain any long options which are available in
  21 # GnuPG. If the first non white space character of a line is a '#',
  22 # this line is ignored.  Empty lines are also ignored.
  23 #
  24 # See the gpg man page for a list of options.
  25
  26
  27 # If you have more than 1 secret key in your keyring, you may want to
  28 # uncomment the following option and set your preferred keyid.
  29
  30 #default-key 621CC013
  31
  32
  33 # If you do not pass a recipient to gpg, it will ask for one.  Using
  34 # this option you can encrypt to a default key.  Key validation will
  35 # not be done in this case.  The second form uses the default key as
  36 # default recipient.
  37
  38 #default-recipient some-user-id
  39 #default-recipient-self
  40
  41
  42 # Group names may be defined like this:
  43 #   group mynames = paige 0x12345678 joe patti
  44 #
  45 # Any time "mynames" is a recipient (-r or --recipient), it will be
  46 # expanded to the names "paige", "joe", and "patti", and the key ID
  47 # "0x12345678".  Note there is only one level of expansion - you
  48 # cannot make an group that points to another group.  Note also that
  49 # if there are spaces in the recipient name, this will appear as two
  50 # recipients.  In these cases it is better to use the key ID.
  51
  52 #group mynames = paige 0x12345678 joe patti
  53
  54
  55 # GnuPG can automatically locate and retrieve keys as needed using
  56 # this option.  This happens when encrypting to an email address (in
  57 # the "user@@example.com" form) and there are no keys matching
  58 # "user@example.com" in the local keyring.  This option takes any
  59 # number mechanisms which are tried in the given order.  The default
  60 # is "--auto-key-locate local" to search for keys only in the local
  61 # key database.  Uncomment the next line to locate a missing key using
  62 # two DNS based mechanisms.
  63
  64 #auto-key-locate local,pka,dane
  65
  66
  67 # Common options for keyserver functions:
  68 # (Note that the --keyserver option has been moved to dirmngr.conf)
  69 #
  70 # include-disabled = when searching, include keys marked as "disabled"
  71 #                    on the keyserver (not all keyservers support this).
  72 #
  73 # no-include-revoked = when searching, do not include keys marked as
  74 #                      "revoked" on the keyserver.
  75 #
  76 # verbose = show more information as the keys are fetched.
  77 #           Can be used more than once to increase the amount
  78 #           of information shown.
  79 #
  80 # auto-key-retrieve = automatically fetch keys as needed from the keyserver
  81 #                     when verifying signatures or when importing keys that
  82 #                     have been revoked by a revocation key that is not
  83 #                     present on the keyring.
  84 #
  85 # no-include-attributes = do not include attribute IDs (aka "photo IDs")
  86 #                         when sending keys to the keyserver.
  87
  88 #keyserver-options auto-key-retrieve
  89
  90
  91 # Uncomment this line to display photo user IDs in key listings and
  92 # when a signature from a key with a photo is verified.
  93
  94 #show-photos
  95
  96
  97 # Use this program to display photo user IDs
  98 #
  99 # %i is expanded to a temporary file that contains the photo.
 100 # %I is the same as %i, but the file isn't deleted afterwards by GnuPG.
 101 # %k is expanded to the key ID of the key.
 102 # %K is expanded to the long OpenPGP key ID of the key.
 103 # %t is expanded to the extension of the image (e.g. "jpg").
 104 # %T is expanded to the MIME type of the image (e.g. "image/jpeg").
 105 # %f is expanded to the fingerprint of the key.
 106 # %% is %, of course.
 107 #
 108 # If %i or %I are not present, then the photo is supplied to the
 109 # viewer on standard input.  If your platform supports it, standard
 110 # input is the best way to do this as it avoids the time and effort in
 111 # generating and then cleaning up a secure temp file.
 112 #
 113 # The default program is "xloadimage -fork -quiet -title 'KeyID 0x%k' stdin"
 114 # On Mac OS X and Windows, the default is to use your regular JPEG image
 115 # viewer.
 116 #
 117 # Some other viewers:
 118 # photo-viewer "qiv %i"
 119 # photo-viewer "ee %i"
 120 # photo-viewer "display -title 'KeyID 0x%k'"
 121 #
 122 # This one saves a copy of the photo ID in your home directory:
 123 # photo-viewer "cat > ~/photoid-for-key-%k.%t"
 124 #
 125 # Use your MIME handler to view photos:
 126 # photo-viewer "metamail -q -d -b -c %T -s 'KeyID 0x%k' -f GnuPG"
 127
 128
 129 # Because some mailers change lines starting with "From " to ">From "
 130 # it is good to handle such lines in a special way when creating
 131 # cleartext signatures; all other PGP versions do it this way too.
 132 # To enable full OpenPGP compliance you may want to use this option.
 133
 134 #no-escape-from-lines
 135
 136
 137 # Uncomment the following option to get rid of the copyright notice
 138
 139 #no-greeting