Imported Upstream version 2.6.0p1
[debian/amanda] / man / xml-source / amcryptsimple.8.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3                    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
4 [
5   <!-- entities files to use -->
6   <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
7   %global_entities;
8 ]>
9
10 <refentry id='amcryptsimple.8'>
11 <refmeta>
12 <refentrytitle>amcryptsimple</refentrytitle>
13 <manvolnum>8</manvolnum>
14 </refmeta>
15 <refnamediv>
16 <refname>amcryptsimple</refname>
17 <refpurpose>reference simple crypt program for &A; symmetric data encryption</refpurpose>
18 </refnamediv>
19 <!-- body begins here -->
20 <refsynopsisdiv>
21 <cmdsynopsis>
22   <command>amcryptsimple</command>  to be called by &A; only 
23 </cmdsynopsis>
24 </refsynopsisdiv>
25
26 <refsect1><title>DESCRIPTION</title>
27 <para>&amcryptsimple;
28 calls <emphasis remap='B'>gpg</emphasis> to perform symmetric data encryption
29 on &A; backup.
30 &amcryptsimple; will search for the gpg program in the following directories:
31 /usr/local/bin:/usr/bin:/usr/sbin:/bin:/sbin</para>
32 <para>&amcryptsimple; uses one passphrase to encrypt the &A; data
33 and uses the same passphrase to decrypt the &A; backup data. &amcryptsimple; uses
34 AES256 as the symmetric cipher.</para> 
35 </refsect1>
36
37
38 <refsect1><title>How to Create Passphrase</title>
39
40 Store  the  passphrase  inside the home-directory of the AMANDA-user($amanda_user) and protect it with proper permissions:
41
42    echo my_secret_passphrase > ~$amanda_user/.am_passphrase
43    chown $amanda_user:disk ~$amanda_user/.am_passphrase
44    chmod 700 ~$amanda_user/.am_passphrase
45 </refsect1>
46
47 <refsect1><title>NOTES</title>
48 <para>Choose a good passphrase and protect it properly. Backup data can only be
49 restored with the passphrase. There is no backdoor.</para>
50 <para>If storing and securing passphrase in your environment presents challenges,
51 &A; provide public-key data encryption through &amgpgcrypt;. Public-key
52 encryption uses the public key to encrypt and uses the private key to decrypt.</para>
53 </refsect1>
54
55 <refsect1><title>AUTHOR</title>
56   <para>
57     The tool and its documentation was written by Zmanda, Inc (http://www.zmanda.com/). 
58   </para>
59 </refsect1>
60
61 <refsect1><title>SEE ALSO</title>
62 <para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
63 <citerefentry><refentrytitle>amanda.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
64 <citerefentry><refentrytitle>amcrypt</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
65 <citerefentry><refentrytitle>amgpgcrypt</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
66 <citerefentry><refentrytitle>amrestore</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
67 <citerefentry><refentrytitle>gpg</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
68 <ulink url="http://wiki.zmanda.com"/>
69 </para>
70 </refsect1>
71 </refentry>
72