← Back to branch summary

~ubuntu-branches/ubuntu/raring/gnupg2/raring-proposed

« back to all changes in this revision

Viewing changes to doc/DETAILS

  • Committer: Bazaar Package Importer
  • Author(s): Eric Dorland
  • Date: 2010-01-09 21:15:18 UTC
  • mfrom: (1.1.14 upstream)
  • Revision ID: james.westby@ubuntu.com-20100109211518-jy03kb8hv1a12gfz
Tags: 2.0.14-1
http://bugs.debian.org/548922
http://bugs.debian.org/551792
* New upstream release.
* debian/control: Build depend on libreadline-dev instead of
  libreadline5-dev, since libreadline6-dev is out. (Closes: #548922)
* debian/source/format, debian/source/options,
  debian/source/patch-header: Convert to v3 quilt format, with
  single-debian-patch.
* debian/control: Tighten dependency on gnupg-agent. (Closes: #551792)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/DETAILS
681
681
        KEYID.
682
682
 
683
683
 
 
684
 
684
685
Format of the "--attribute-fd" output
685
686
=====================================
686
687
 
817
818
     used. Some syntactically checks may be performed.
818
819
     The currently defined parameters are:
819
820
     Key-Type: <algo-number>|<algo-string>
820
 
        Starts a new parameter block by giving the type of the
821
 
        primary key. The algorithm must be capable of signing.
822
 
        This is a required parameter.
 
821
        Starts a new parameter block by giving the type of the primary
 
822
        key. The algorithm must be capable of signing.  This is a
 
823
        required parameter.  It may be "default" to use the default
 
824
        one; in this case don't give a Key-Usage and use "default" for
 
825
        the Subkey-Type.
823
826
     Key-Length: <length-in-bits>
824
 
        Length of the key in bits.  Default is 1024.
 
827
        Length of the key in bits.  The default is returned by running
 
828
        the command "gpg --gpgconf-list".
825
829
     Key-Usage: <usage-list>
826
830
        Space or comma delimited list of key usage, allowed values are
827
831
        "encrypt", "sign", and "auth".  This is used to generate the
829
833
        this usage.  Note that OpenPGP requires that all primary keys
830
834
        are capable of certification, so no matter what usage is given
831
835
        here, the "cert" flag will be on.  If no Key-Usage is
832
 
        specified, all the allowed usages for that particular
833
 
        algorithm are used.
 
836
        specified and the key-type is not "default", all allowed
 
837
        usages for that particular algorithm are used; if it is not
 
838
        given but "default" is used the usage will be "sign".
834
839
     Subkey-Type: <algo-number>|<algo-string>
835
840
        This generates a secondary key.  Currently only one subkey
836
 
        can be handled.
 
841
        can be handled.  "default" is also supported.
837
842
     Subkey-Length: <length-in-bits>
838
 
        Length of the subkey in bits.  Default is 1024.
 
843
        Length of the subkey in bits.  The default is returned by running
 
844
        the command "gpg --gpgconf-list".
839
845
     Subkey-Usage: <usage-list>
840
846
        Similar to Key-Usage.
841
847
     Passphrase: <string>
886
892
        keyserver URL for the key.
887
893
 
888
894
 
889
 
Here is an example:
 
895
Here is an example on how to create a key:
890
896
$ cat >foo <<EOF
891
 
     %echo Generating a standard key
 
897
     %echo Generating a basic OpenPGP key
892
898
     Key-Type: DSA
893
899
     Key-Length: 1024
894
900
     Subkey-Type: ELG-E
913
919
sec  1024D/915A878D 2000-03-09 Joe Tester (with stupid passphrase) <joe@foo.bar>
914
920
ssb  1024g/8F70E2C0 2000-03-09
915
921
 
 
922
If you want to create a key with the default algorithms you would
 
923
use these parameters:
 
924
 
 
925
     %echo Generating a default key
 
926
     Key-Type: default
 
927
     Subkey-Type: default
 
928
     Name-Real: Joe Tester
 
929
     Name-Comment: with stupid passphrase
 
930
     Name-Email: joe@foo.bar
 
931
     Expire-Date: 0
 
932
     Passphrase: abc
 
933
     %pubring foo.pub
 
934
     %secring foo.sec
 
935
     # Do a commit here, so that we can later print "done" :-)
 
936
     %commit
 
937
     %echo done
 
938
 
 
939
 
916
940
 
917
941
 
918
942
Layout of the TrustDB