1GnuPG::Options(3) User Contributed Perl Documentation GnuPG::Options(3)
2
6 GnuPG::Options - GnuPG options embodiment
7
9 # assuming $gnupg is a GnuPG::Interface object
10 $gnupg->options->armor( 1 );
11 $gnupg->options->push_recipients( 'ftobin', '0xABCD1234' );
12
14 GnuPG::Options objects are generally not instantiated on their own, but
15 rather as part of a GnuPG::Interface object.
16
18 new( %initialization_args )
19 This methods creates a new object. The optional arguments are
20 initialization of data members.
21 hash_init( %args ).
23 copy
24 Returns a copy of this object. Useful for 'saving' options.
25 get_args
27 Returns a list of arguments to be passed to GnuPG based on data
28 members which are 'meta_' options, regular options, and then
29 extra_args, in that order.
30
32 homedir
33 armor
34 textmode
35 default_key
36 no_greeting
37 verbose
38 no_verbose
39 quiet
40 batch
41 always_trust
42 comment
43 status_fd
44 logger_fd
45 passphrase_fd
46 compress_algo
47 force_v3_sigs
48 rfc1991
49 openpgp
50 options
51 no_options
52 encrypt_to
53 recipients
54 These options correlate directly to many GnuPG options. For those
55 that are boolean to GnuPG, simply that argument is passed. For
56 those that are associated with a scalar, that scalar is passed
57 passed as an argument appropriate. For those that can be specified
58 more than once, such as recipients, those are considered lists and
59 passed accordingly. Each are undefined or false to begin.
60 Meta Options
62 Meta options are those which do not correlate directly to any option in
63 GnuPG, but rather are generally a bundle of options used to accomplish
64 a specific goal, such as obtaining compatibility with PGP 5. The
65 actual arguments each of these reflects may change with time. Each
66 defaults to false unless otherwise specified.
67 These options are being designed and to provide a non-GnuPG-specific
69 abstraction, to help create compatibility with a possible
70 PGP::Interface module.
71 To help avoid confusion, methods with take a form of a key as an object
73 shall be prepended with _id(s) if they only take an id; otherwise
74 assume an object of type GnuPG::Key is required.
75 meta_pgp_5_compatible
77 If true, arguments are generated to try to be compatible with PGP
78 5.x.
79 meta_pgp_2_compatible
81 If true, arguments are generated to try to be compatible with PGP
82 2.x.
83 meta_interactive
85 If false, arguments are generated to try to help the using program
86 use GnuPG in a non-interactive environment, such as CGI scripts.
87 Default is true.
88 meta_signing_key_id
90 This scalar reflects the key used to sign messages. Currently this
91 is synonymous with default-key.
92 meta_signing_key
94 This GnuPG::Key object reflects the key used to sign messages.
95 meta_recipients_key_ids
97 This list of scalar key ids are used to generate the appropriate
98 arguments having these keys as recipients.
99 meta_recipients_keys
101 This list of keys of the type GnuPG::Key are used to generate the
102 appropriate arguments having these keys as recipients. You
103 probably want to have this list be of the inherited class
104 GnuPG::SubKey, as in most instances, OpenPGP keypairs have the
105 encyrption key as the subkey of the primary key, which is used for
106 signing.
107 Other Data Members
109 extra_args
110 This is a list of any other arguments used to pass to GnuPG.
111 Useful to pass an argument not yet covered in this package.
112
114 GnuPG::Interface,
115
117 Hey! The above document had some coding errors, which are explained
118 below:
119 Around line 282:
121 You forgot a '=back' before '=head2'
122 Around line 300:
124 '=item' outside of any '=over'
125perl v5.12.0 2009-07-13 GnuPG::Options(3)