X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famgpgcrypt.8;h=3d2fdaca0e6b7469a59d4a1e0810837626ebdf69;hb=b116e9366c7b2ea2c2eb53b0a13df4090e176235;hp=bb71017b829b3a940ad8c757878caac76960a93e;hpb=a6127998ee6dcab6bb034f6ca985b07804a86f9a;p=debian%2Famanda diff --git a/man/amgpgcrypt.8 b/man/amgpgcrypt.8 index bb71017..3d2fdac 100644 --- a/man/amgpgcrypt.8 +++ b/man/amgpgcrypt.8 @@ -1,83 +1,81 @@ +'\" t .\" Title: amgpgcrypt -.\" Author: -.\" Generator: DocBook XSL Stylesheets v1.73.2 -.\" Date: 05/14/2008 -.\" Manual: -.\" Source: +.\" Author: Kevin Till +.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 +.\" Date: 10/18/2010 +.\" Manual: System Administration Commands +.\" Source: Amanda 3.2.0 +.\" Language: English .\" -.TH "AMGPGCRYPT" "8" "05/14/2008" "" "" +.TH "AMGPGCRYPT" "8" "10/18/2010" "Amanda 3\&.2\&.0" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- .SH "NAME" -amgpgcrypt - reference crypt program for Amanda public-key data encryption +amgpgcrypt \- reference crypt program for Amanda public\-key data encryption .SH "SYNOPSIS" -.HP 11 -\fBamgpgcrypt\fR to be called by \fIAmanda\fR only +.HP \w'\fBamgpgcrypt\fR\ 'u +\fBamgpgcrypt\fR to be called by Amanda only .SH "DESCRIPTION" .PP \fBamgpgcrypt\fR calls \fBgpg\fR -to perform public\-key data encryption on -\fIAmanda\fR -backup\. +to perform public\-key data encryption on Amanda backup\&. \fBamgpgcrypt\fR will search for the gpg program in the following directories: /usr/local/bin:/usr/bin:/usr/sbin:/bin:/sbin .PP \fBamgpgcrypt\fR -sets GNUPGHOME to $AMANDA_HOME/\.gnupg where gpg will look for the gpg keys\. +sets GNUPGHOME to $AMANDA_HOME/\&.gnupg where gpg will look for the gpg keys\&. \fBamgpgcrypt\fR -uses the public key to encrypt the -\fIAmanda\fR -data and uses the private key to decrypt the -\fIAmanda\fR -backup data\. Thus, passphrase is only required at the time of data restore\. +uses the public key to encrypt the Amanda data and uses the private key to decrypt the Amanda backup data\&. Thus, passphrase is only required at the time of data restore\&. .SH "KEY AND PASSPHRASE" .PP \fBamgpgcrypt\fR -uses the private key to decrypt -\fIAmanda\fR -backup data\. +uses the private key to decrypt Amanda backup data\&. It is very important to store, manage and protect the key and the passphrase -properly\. Encrypted backup data can \fBonly\fR be recovered with the correct key and -passphrase\. +properly\&. Encrypted backup data can \fBonly\fR be recovered with the correct key and +passphrase\&. .SH "HOW TO CREATE ENCRYPTION KEYS AND PASSPHRASE FOR AMGPGCRYPT" .PP Store the passphrase that you used in following "gpg \-\-gen\-key" command inside the home\-directory of the AMANDA\-user($amanda_user) and protect it with proper permissions: - echo my_secret_passphrase > ~$amanda_user/\.am_passphrase - chown $amanda_user:disk ~$amanda_user/\.am_passphrase - chmod 700 ~$amanda_user/\.am_passphrase + echo my_secret_passphrase > ~$amanda_user/\&.am_passphrase + chown $amanda_user:disk ~$amanda_user/\&.am_passphrase + chmod 700 ~$amanda_user/\&.am_passphrase .PP -Run "gpg \-\-gen\-key"\. Below is an example: -.sp -.RS 4 +Run "gpg \-\-gen\-key"\&. Below is an example: .nf $ gpg \-\-gen\-key -gpg (GnuPG) 1\.2\.6; Copyright (C) 2004 Free Software Foundation, Inc\. -This program comes with ABSOLUTELY NO WARRANTY\. +gpg (GnuPG) 1\&.2\&.6; Copyright (C) 2004 Free Software Foundation, Inc\&. +This program comes with ABSOLUTELY NO WARRANTY\&. This is free software, and you are welcome to redistribute it -under certain conditions\. See the file COPYING for details\. +under certain conditions\&. See the file COPYING for details\&. Please select what kind of key you want: (1) DSA and ElGamal (default) (2) DSA (sign only) (4) RSA (sign only) Your selection? 1 -DSA keypair will have 1024 bits\. -About to generate a new ELG\-E keypair\. +DSA keypair will have 1024 bits\&. +About to generate a new ELG\-E keypair\&. minimum keysize is 768 bits default keysize is 1024 bits highest suggested keysize is 2048 bits What keysize do you want? (1024) Requested keysize is 1024 bits -Please specify how long the key should be valid\. +Please specify how long the key should be valid\&. 0 = key does not expire (n) = key expires in n days (n)w = key expires in n weeks @@ -89,7 +87,7 @@ Is this correct (y/n)? y You need a User\-ID to identify your key; the software constructs the user id from Real Name, Comment and Email Address in this form: - "Heinrich Heine (Der Dichter) (heinrichh@duesseldorf\.de)" + "Heinrich Heine (Der Dichter) (heinrichh@duesseldorf\&.de)" Real name: amandabackup Email address: @@ -98,60 +96,61 @@ You selected this USER\-ID: "amandabackup (gpg keys for amandabackup)" Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? o -You need a Passphrase to protect your secret key\. +You need a Passphrase to protect your secret key\&. -We need to generate a lot of random bytes\. It is a good idea to perform +We need to generate a lot of random bytes\&. It is a good idea to perform some other action (type on the keyboard, move the mouse, utilize the disks) during the prime generation; this gives the random number -generator a better chance to gain enough entropy\. +generator a better chance to gain enough entropy\&. -We need to generate a lot of random bytes\. It is a good idea to perform +We need to generate a lot of random bytes\&. It is a good idea to perform some other action (type on the keyboard, move the mouse, utilize the disks) during the prime generation; this gives the random number -generator a better chance to gain enough entropy\. +generator a better chance to gain enough entropy\&. -public and secret key created and signed\. -key marked as ultimately trusted\. +public and secret key created and signed\&. +key marked as ultimately trusted\&. pub 1024D/4417A8CB 2006\-02\-07 amandabackup (gpg keys for amandabackup) Key fingerprint = 139C 6369 44FC 7F1A 655C E5E9 7EAA 515A 4417 A8CB sub 1024g/8C3A6A78 2006\-02\-07 [expires: 2006\-08\-06] - .fi -.RE .SH "FILES" .PP -\fB$AMANDA_HOME/\.gnupg/pubring\.gpg\fR +\fB$AMANDA_HOME/\&.gnupg/pubring\&.gpg\fR .RS 4 -The public key\. +The public key\&. \fBamgpgcrypt\fR -encrypt data with this public key along with the cipher algorithm\. +encrypt data with this public key along with the cipher algorithm\&. .RE .PP -\fB$AMANDA_HOME/\.gnupg/secring\.gpg\fR +\fB$AMANDA_HOME/\&.gnupg/secring\&.gpg\fR .RS 4 -The private/secret key\. It\'s only needed during amrecover/amrestore\. Store and protect it properly during other time\. +The private/secret key\&. It\'s only needed during amrecover/amrestore\&. Store and protect it properly during other time\&. .RE .PP -\fB$AMANDA_HOME/\.am_passphrase\fR +\fB$AMANDA_HOME/\&.am_passphrase\fR .RS 4 -The passphrase\. It\'s only needed during amrecover/amrestore\. Store and protect it properly during other time\. +The passphrase\&. It\'s only needed during amrecover/amrestore\&. Store and protect it properly during other time\&. .RE .SH "BUGS" .PP -\fIAmanda\fR -has problem with gpg mdc(modification detection code) in the binary mode\. +Amanda has problem with gpg mdc(modification detection code) in the binary mode\&. \fBamgpgcrypt\fR calls gpg with mdc disabled -.SH "AUTHOR" -.PP -The tool and its documentation was written by Zmanda, Inc (http://www\.zmanda\.com/)\. .SH "SEE ALSO" .PP - \fBamanda\fR(8), \fBamanda.conf\fR(5), \fBamcrypt\fR(8), \fBamrestore\fR(8), -\fBgpg\fR(1), -\fI\%http://wiki.zmanda.com\fR +\fBgpg\fR(1) +.PP +The Amanda Wiki: +: http://wiki.zmanda.com/ +.SH "AUTHOR" +.PP +\fBKevin Till\fR <\&kevin\&.till@zmanda\&.com\&> +.RS 4 +Zmanda, Inc\&. (http://www\&.zmanda\&.com) +.RE