EDGe uses a configuration file to store default options. This configuration file is

a text file containing a list of setting/value pairs. Basic options are the location

of the default secret and public keyrings, the default signing user ID.

You can specify options directly at the command-line or by modifying the

configuration file used by the EDGe.

You can change the default options by specifying them at the command-line or

by editing the configuration file (with a text editor such as NotePad on Windows

or vi on UNIX systems).

Options can be changed at the command-line by using the following syntax:

EDGe +[option_name]=[option_value]

EDGe +PUBRING=/home/keyrings/pubring.pgp

EDGe +PUBRING="/Documents and Settings/Keyrings/pubring.pgp"

EDGe +FORCE=ON

EDGe +FORCE=1

EDGe +FORCE

To display the location of the configuration file, type:

EDGe –v

EDGe displays version information followed by default paths and the

configuration file path.

To display the content of the configuration file used by the EDGe, type:

EDGe –vv

EDGe displays the configuration file.

You can specify another configuration file by setting the PGPPATH environment

variable. If this environment variable is defined, EDGe uses the defined value

as the default directory for the configuration file.

set PGPPATH="C:\"

EDGe -v

To display the content of the default keyring used by the EDGe, just type:

EDGe –kv

EDGe displays the content of the current keyring followed by the number of

keys contained if the default public keyring.

To display keys matching a specified user ID, just specify the user ID after the

keyring view command (-kv):

EDGe –kv [userID]

where [userID] is the user ID you want to display.

To display all keys contained in your default public keyring, just type:

EDGe –kv

To display all keys contained in a keyring file, type:

EDGe –kv * [keyring_file_path]

EDGe –kv "" [keyring_file_path]

where [keyring_file_path] is the path of the keyring file you want to display.

EDGe –kv

EDGe –kv * keyring.asc

EDGe –kv * keyring.pgp

EDGe –kv * "/Documents and Settings/Keyrings/myKeyring.pgp"

To add keys to your default keyrings, use the .ka command:

EDGe –ka [key_file]

where [key_file] is the path of the file containing the keys you want to add.

EDGe –ka keyring.pgp

EDGe –ka "\Documents and Settings\All Users\Keyrings\pubring.pgp"

By default, EDGe adds public keys to your default public keyring and secret

keys to your default secret keyring.

Some key files contain both public and secret keys. If you want to add only

public keys contained in that file, use the .ka command with the

ADDPUBLICKEYS and ADDSECRETKEYS options:

EDGe –ka [key_file] +ADDPUBLICKEYS +ADDSECRETKEYS=0

where [key_file] is the path of the file containing the keys you want to add.

EDGe –ka keyring.pgp +ADDPUBLICKEYS +ADDSECRETKEYS=0

EDGe adds only public keys contained if the specified file to your default public

keyring even if that file contains also secret keys.

Some key files contain both public and secret keys. If you want to add only

secret keys contained in that file, use the .ka command with the

ADDPUBLICKEYS and ADDSECRETKEYS options:

EDGe –ka [key_file] +ADDPUBLICKEYS=0 +ADDSECRETKEYS

where [key_file] is the path of the file containing the keys you want to add.

EDGe –ka keyring.pgp +ADDPUBLICKEYS=0 +ADDSECRETKEYS

EDGe adds only secret keys contained if the specified file to your default secret

keyring even if that file contains also public keys.

To update your public and secret default keyrings with keys contained in a key

file without adding new keys to your default keyrings, use the .ka command

with the MERGEONLY option:

EDGe –ka [key_file] +MERGEONLY

where [key_file] is the path of the file containing the keys you want to use to

update your default keyrings.

EDGe –ka keyring.pgp +MERGEONLY

EDGe updates your keyring with keys contained in the specified file. Only keys

that are already in you keyring are updated. No new key is added to your

default keyrings.

To extract a key from your default public keyring, use the .kx command:

EDGe .kx [userID] [key_file]

where [userID] is the user ID of the key you want to extract and [key_file]

is the path of the file containing the extracted key. This file is created by the

EDGe.

Example:

EDGe –kx myKey keyring.pgp

EDGe creates a file named .keyring.pgp. containing all keys matching .myKey..

To extract keys as a text file, use the .kxa command:

EDGe .kxs [userID] [key_file]

where [userID] is the user ID of the key you want to extract and [key_file]

is the path of the file containing the extracted key. This file is created by the

EDGe.

EDGe –kxa myKey keyring.asc

EDGe creates a file named .keyring.asc. containing all keys matching .myKey..

An OpenPGP key converted to text looks like this:

-----BEGIN PGP PUBLIC KEY BLOCK-----

Version: EDGe 1.0

mQBPAz6LCsQAAAECAMkn8PgdV9H0SOwHtLaDPRpvXk7pe1+MyXCf7lo1du0ckEUW

wZdvVoA8R0mUAU3P2r+HMWX4mWqFk3ldlDkmUV8AEQEAAbQDcnNhiQBVAwUQPosK

xJN5XZQ5JlFfAQGy3AH/Wctd4C2QPRgxKsDhF1sE0iQS6836iKeAb3bH6Kif5Yhh

am2tVW31O9FhKGHNPoZd1X1r8QqOGpc210SHu9Ekkg==

=kSg8

-----END PGP PUBLIC KEY BLOCK-----

make sure the "compatible" option is on.  This option forces the generation of PGP 2.6 files. And with PGP 2.6, file size is encoded using 32 bits (4GB).

The default value for this setting is OFF. Files generated by EDGe are therefore not compatible with older versions of OpenPGP clients.

EDGe –e file.txt aUserID +COMPATIBLE

EDGe –e file.txt aUserID +COMPATIBLE=ON

EDGe –e file.txt aUserID +COMPATIBLE=OFF