home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 February / PCWorld_1999-02_cd.bin / software / servis / Pgp31 / pgpcfg.doc < prev    next >
Text File  |  1998-03-14  |  5KB  |  127 lines
  1.  
  2. PGP(5.0)                         User Manual                         PGP(5.0)
  3.  
  4. NAME
  5.   pgp.cfg - Format of the configuration file used by pgp(1).
  6.  
  7. DESCRIPTION
  8.   The default location for this file is ~/.pgp.  You may specify another
  9.   location by setting the environment variable PGPPATH.  SH COMMAND-LINE
  10.   SPECIFICATION All PGP applications accept these options as command-line
  11.   arguments, as well.  Command line arguments always override the configura-
  12.   tion file.  Options are specified with a double-dash (--) or plus (+), fol-
  13.   lowed by an equal sign (=) and the value, if appropriate.  For example, to
  14.   specify the public keyring to use on an encryption operation:
  15.  
  16.   pgpe -r foo@bar.baz.com --pubring=~/fooring.pkr
  17.  
  18.   To turn on text mode, in an encryption:
  19.  
  20.   pgpe -r foo@bar.baz.com --textmode
  21.  
  22. OPTIONS
  23.   The following configuration options are supported, both in the pgp.cfg file
  24.   and on the command line of PGP applications.  Case is not important in
  25.   specifying the variable names, but may be in specifying filenames, depend-
  26.   ing on your operating environment.  Immediately following each option is a
  27.   description of its type:  Boolean is either "1" or "on" or "0" or "off";
  28.   String is a string; and Integer is a number.
  29.  
  30.   Armor
  31.        Boolean.  Turns ASCII armoring on or off.  The default is off.
  32.  
  33.   ArmorLines
  34.        Integer.  Specifies the maximum number of lines that may be contained
  35.        in an ASCII armored message.  Messages longer than this number of
  36.        lines will be broken up into multi-part ASCII armored messages.  A
  37.        value of zero indicates an unlimited number of lines.  The default is
  38.        zero.
  39.  
  40.   AutoServerFetch
  41.        Boolean.  If on, when adding keys with pgpk(1), if a specified key
  42.        file is not found, it is assumed to be the name of a key to retrieve
  43.        from your default key server (see HTTPKeyServerHost and HTTPKeyServer-
  44.        Port, below).  Some intelligence is attempted; even if this is on, if
  45.        it is obvious a file was intended (if the first characters are either
  46.        "/" or "./"), a fetch will not be made.  The default is on.
  47.  
  48.   Compress
  49.        Boolean.  Specifies whether messages should be compressed prior to
  50.        encryption.  The default is on.
  51.  
  52.   EncryptToSelf
  53.        Boolean.  If on, automatically encrypts all messages to your default
  54.        key, as well as to the intended recipient.  Intended to allow you to
  55.        read encrypted mail you've sent.  The default is off.
  56.  
  57.   FastKeyGen
  58.        Boolean.  Utilizes pre-generated prime numbers for certain initial
  59.        operations on DSS/Diffie-Hellman key generation.  This only works for
  60.        "standard" key sizes (1024, 1596 and 2048).  The default is on.  To
  61.        turn this off, use: pgpk +fastkeygen=0 -g
  62.  
  63.   HTTPKeyServerHost
  64.        String.  The name of a keyserver to use in default lookups (see
  65.        AutoServerFetch, above).  The default is pgpkeys.mit.edu.
  66.  
  67.   HTTPKeyServerPort
  68.        Integer.  The port to use for connections to the default key server as
  69.        specified in HTTPKeyServerHost, above.  The default is 11371, the
  70.        default port for the Horowitz Key Protocol.
  71.  
  72.   Language
  73.        String.  The country code of the language you wish to use.  The
  74.        default is "us."
  75.  
  76.   LanguageFile
  77.        String.  The file from which to load runtime strings.  The default is
  78.        "language50.txt" in your .pgp directory.  If this file does not exist,
  79.        PGP will use internal defaults.
  80.  
  81.   MyName
  82.        String.  The key ID you wish to be default for signing operations and
  83.        the EncryptToSelf option, above.  There is no default; however, if
  84.        none is specified, the first secret key on your secret keyring will be
  85.        used for most operations.
  86.  
  87.   NoBatchInvalidKeys
  88.        Boolean.  If True, batch mode will fail if the user attempts to
  89.        encrypt to a key that is invalid or not completely valid.  If false,
  90.        batch mode will use invalid keys.  Note that this option only applies
  91.        to batch mode; normally, PGP will ask the user to confirm prior to
  92.        encrypting to in an invalid key.  The default is on.
  93.  
  94.   PubRing
  95.        String.  Your public keyring file.  The default is "pubring.pkr" in
  96.        your .pgp directory.
  97.  
  98.   RandomDevice
  99.        String.  Entropy-generating device.  If present, it will be used in
  100.        favor of asking the user for keyboard input.  The default is
  101.        "/dev/random."
  102.  
  103.   SecRing
  104.        String.  Your secret keyring file.  The default is "secring.skr" in
  105.        your .pgp directory.
  106.  
  107.   WarnOnMixRSADiffieHellman
  108.        Boolean.  Warns the user if encrypting to multiple keys, one or more
  109.        of which is RSA and one or more of which is DSS/Diffie-Hellman.  The
  110.        reason for this warning is that most RSA key owners will still be
  111.        using 2.6.3, which will not properly decrypt such messages.  The
  112.        default is on.
  113.  
  114.   WarnOnRSARecipAndNonRSASigner
  115.        Boolean.  Warns the user if encrypting to an RSA key, but signing with
  116.        a DSS/Diffie-Hellman key.  The reason for this warning is that most
  117.        RSA key owners will still be using 2.6.3, which will not properly
  118.        decrypt such messages.  The default is on.
  119.  
  120. BUGS
  121.   See pgp(1).
  122.  
  123. SEE ALSO
  124.   pgp(1), pgpe(1), pgpv(1), pgps(1), pgpk(1), pgp-integration(7),
  125.   http://www.pgp.com (US versions) and http://www.pgpi.com (International
  126.   versions)
  127.