X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famcrypt.8;h=f0f201f37ceccd7c0be9d7191dfd2d760db549e8;hb=HEAD;hp=07fab4ab5587493e1b645c1ee020193a01ea8b4f;hpb=ac973066bc508cb82728e46eaf499e9424d4e0f1;p=debian%2Famanda diff --git a/man/amcrypt.8 b/man/amcrypt.8 index 07fab4a..f0f201f 100644 --- a/man/amcrypt.8 +++ b/man/amcrypt.8 @@ -1,19 +1,36 @@ +'\" t .\" Title: amcrypt -.\" Author: -.\" Generator: DocBook XSL Stylesheets v1.72.0 -.\" Date: 06/06/2007 -.\" Manual: -.\" Source: +.\" Author: Kevin Till +.\" Generator: DocBook XSL Stylesheets v1.76.1 +.\" Date: 01/10/2013 +.\" Manual: System Administration Commands +.\" Source: Amanda 3.3.3 +.\" Language: English .\" -.TH "AMCRYPT" "8" "06/06/2007" "" "" +.TH "AMCRYPT" "8" "01/10/2013" "Amanda 3\&.3\&.3" "System Administration Commands" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- .SH "NAME" amcrypt \- reference crypt program for Amanda symmetric data encryption .SH "SYNOPSIS" -.HP 8 +.HP \w'\fBamcrypt\fR\ 'u \fBamcrypt\fR .SH "DESCRIPTION" .PP @@ -24,12 +41,12 @@ requires \fBuuencode\fR and \fBgpg\fR -to work. Aespipe is available from -\fI\%http://loop\-aes.sourceforge.net\fR +to work\&. Aespipe is available from +: http://loop-aes.sourceforge.net .PP \fBamcrypt\fR -will search for the aespipe program in the following directories: /usr/bin:/usr/local/bin:/sbin:/usr/sbin. +will search for the aespipe program in the following directories: /usr/bin:/usr/local/bin:/sbin:/usr/sbin\&. .PP \fBamcrypt\fR @@ -37,33 +54,30 @@ calls \fBamaespipe\fR and pass the \fBpassphrase\fR -through file descriptor 3. The passphrase should be stored in ~amanda/.am_passphrase. +through file descriptor 3\&. The passphrase should be stored in ~amanda/\&.am_passphrase\&. .SH "HOW TO CREATE ENCRYPTION KEYS FOR AMCRYPT" .PP -1. Create 65 random encryption keys and encrypt those keys using gpg. Reading from /dev/random may take indefinitely long if kernel's random entropy pool is empty. If that happens, do some other work on some other console (use keyboard, mouse and disks). +1\&. Create 65 random encryption keys and encrypt those keys using gpg\&. Reading from /dev/random may take indefinitely long if kernel\*(Aqs random entropy pool is empty\&. If that happens, do some other work on some other console (use keyboard, mouse and disks)\&. .PP -head \-c 2925 /dev/random | uuencode \-m \- | head \-n 66 | tail \-n 65 \e | gpg \-\-symmetric \-a > ~amanda/.gnupg/am_key.gpg +head \-c 2925 /dev/random | uuencode \-m \- | head \-n 66 | tail \-n 65 \e | gpg \-\-symmetric \-a > ~amanda/\&.gnupg/am_key\&.gpg .PP -This will ask for a passphrase. Remember this passphrase as you will need it in the next step. +This will ask for a passphrase\&. Remember this passphrase as you will need it in the next step\&. .PP -2. Store the passphrase inside the home\-directory of the AMANDA\-user and protect it with proper permissions: -.sp -.RS 4 +2\&. Store the passphrase inside the home\-directory of the AMANDA\-user and protect it with proper permissions: .nf -echo my_secret_passphrase > ~amanda/.am_passphrase -chown amanda:disk ~amanda/.am_passphrase -chmod 700 ~amanda/.am_passphrase +echo my_secret_passphrase > ~amanda/\&.am_passphrase +chown amanda:disk ~amanda/\&.am_passphrase +chmod 700 ~amanda/\&.am_passphrase .fi -.RE .SH "KEY AND PASSPHRASE" .PP \fBamcrypt\fR -uses the same key to encrypt and decrypt data. +uses the same key to encrypt and decrypt data\&. .PP -It is very important to store and protect the key and the passphrase properly. Encrypted backup data can +It is very important to store and protect the key and the passphrase properly\&. Encrypted backup data can \fBonly\fR -be recovered with the correct key and passphrase. +be recovered with the correct key and passphrase\&. .SH "SEE ALSO" .PP \fBamanda\fR(8), @@ -71,3 +85,12 @@ be recovered with the correct key and passphrase. \fBaespipe\fR(1), \fBamaespipe\fR(8), \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