GnuPG::Options(3) User Contributed Perl Documentation GnuPG::Options(3)NAMEGnuPG::Options - GnuPG options embodiment
SYNOPSIS
# assuming $gnupg is a GnuPG::Interface object
$gnupg->options->armor( 1 );
$gnupg->options->push_recipients( 'ftobin', '0xABCD1234' );
DESCRIPTIONGnuPG::Options objects are generally not instantiated on their own, but
rather as part of a GnuPG::Interface object.
OBJECT METHODS
new( %initialization_args )
This methods creates a new object. The optional arguments are
initialization of data members.
hash_init( %args ).
copy
Returns a copy of this object. Useful for 'saving' options.
get_args
Returns a list of arguments to be passed to GnuPG based on data
members which are 'meta_' options, regular options, and then
extra_args, in that order.
OBJECT DATA MEMBERS
homedir
armor
textmode
default_key
no_greeting
verbose
no_verbose
quiet
batch
always_trust
comment
status_fd
logger_fd
passphrase_fd
compress_algo
force_v3_sigs
rfc1991
openpgp
options
no_options
encrypt_to
recipients
These options correlate directly to many GnuPG options. For those that
are boolean to GnuPG, simply that argument is passed. For those that
are associated with a scalar, that scalar is passed passed as an
argument appropriate. For those that can be specified more than once,
such as recipients, those are considered lists and passed accordingly.
Each are undefined or false to begin.
Meta Options
Meta options are those which do not correlate directly to any option in
GnuPG, but rather are generally a bundle of options used to accomplish
a specific goal, such as obtaining compatibility with PGP 5. The
actual arguments each of these reflects may change with time. Each
defaults to false unless otherwise specified.
These options are being designed and to provide a non-GnuPG-specific
abstraction, to help create compatibility with a possible
PGP::Interface module.
To help avoid confusion, methods with take a form of a key as an object
shall be prepended with _id(s) if they only take an id; otherwise
assume an object of type GnuPG::Key is required.
meta_pgp_5_compatible
If true, arguments are generated to try to be compatible with PGP
5.x.
meta_pgp_2_compatible
If true, arguments are generated to try to be compatible with PGP
2.x.
meta_interactive
If false, arguments are generated to try to help the using program
use GnuPG in a non-interactive environment, such as CGI scripts.
Default is true.
meta_signing_key_id
This scalar reflects the key used to sign messages. Currently this
is synonymous with default-key.
meta_signing_key
This GnuPG::Key object reflects the key used to sign messages.
meta_recipients_key_ids
This list of scalar key ids are used to generate the appropriate
arguments having these keys as recipients.
meta_recipients_keys
This list of keys of the type GnuPG::Key are used to generate the
appropriate arguments having these keys as recipients. You
probably want to have this list be of the inherited class
GnuPG::SubKey, as in most instances, OpenPGP keypairs have the
encyrption key as the subkey of the primary key, which is used for
signing.
Other Data Members
extra_args
This is a list of any other arguments used to pass to GnuPG.
Useful to pass an argument not yet covered in this package.
SEE ALSO
GnuPG::Interface,
perl v5.14.1 2010-05-08 GnuPG::Options(3)
