X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famzfs-sendrecv.8;h=2181db1f366b27b4363e1f8f47e0095715fe8906;hb=HEAD;hp=6482760adf03834b8f0d3ab3d1c4544727cc27b7;hpb=3469241adf5f8b45020b0896ee13d17c4c7a2abf;p=debian%2Famanda diff --git a/man/amzfs-sendrecv.8 b/man/amzfs-sendrecv.8 index 6482760..2181db1 100644 --- a/man/amzfs-sendrecv.8 +++ b/man/amzfs-sendrecv.8 @@ -1,13 +1,22 @@ '\" t .\" Title: amzfs-sendrecv .\" Author: Jean-Louis Martineau -.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 -.\" Date: 04/10/2009 +.\" Generator: DocBook XSL Stylesheets v1.76.1 +.\" Date: 01/10/2013 .\" Manual: System Administration Commands -.\" Source: Amanda 2.6.1p1 +.\" Source: Amanda 3.3.3 .\" Language: English .\" -.TH "AMZFS\-SENDRECV" "8" "04/10/2009" "Amanda 2\&.6\&.1p1" "System Administration Commands" +.TH "AMZFS\-SENDRECV" "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 .\" ----------------------------------------------------------------- @@ -22,9 +31,7 @@ amzfs-sendrecv \- Amanda script to create zfs sendrecv .SH "DESCRIPTION" .PP -amzfs\-sendrecv is an -\fIAmanda\fR -application implementing the Application API\&. It should not be run by users directly\&. It create a zfs snapshot of the filesystem and backup the snapshot with \'zfs send\'\&. Snapshot are kept after the backup is done, this increase the disk space use on the client but it is neccesary to be able do to incremental backup\&. If you want only full backup, you can disable this feature by setting the KEEP\-SNAPSHOT property to \'NO\'\&. Only the restoration of the complete backup is allowed, it is impossible to restore a single file\&. +amzfs\-sendrecv is an Amanda application implementing the Application API\&. It should not be run by users directly\&. It create a zfs snapshot of the filesystem and backup the snapshot with \*(Aqzfs send\*(Aq\&. Snapshot are kept after the backup is done, this increase the disk space use on the client but it is neccesary to be able do to incremental backup\&. If you want only full backup, you can disable this feature by setting the KEEP\-SNAPSHOT property to \*(AqNO\*(Aq\&. Only the restoration of the complete backup is allowed, it is impossible to restore a single file\&. .PP The application is run as the amanda user, it must have many zfs priviledge: .sp @@ -32,14 +39,16 @@ The application is run as the amanda user, it must have many zfs priviledge: zfs allow \-ldu AMANDA_USER mount,create,rename,snapshot,destroy,send,receive FILESYSTEM .fi .PP -Some system doesn\'t have "zfs allow", but you can give the Amanda backup user the rights to manipulate ZFS filesystems by using the following command: +Some system doesn\*(Aqt have "zfs allow", but you can give the Amanda backup user the rights to manipulate ZFS filesystems by using the following command: .sp .nf usermod \-P "ZFS File System Management,ZFS Storage Management" AMANDA_USER .fi This will require that your run zfs under pfexec, set the PFEXEC property to YES\&. .PP -The format of the DLE must be one of: +The format of the +\fBdiskdevice\fR +in the disklist (DLE) must be one of: .sp .nf Desciption Example @@ -50,17 +59,17 @@ ZFS filesystem datapool/database ZFS logical volume datapool/dbvol .fi .PP -The filesystem doesn\'t need to be mounted\&. +The filesystem doesn\*(Aqt need to be mounted\&. .SH "PROPERTIES" .PP -This section lists the properties that control amzfs\-sendrecv\'s functionality\&. See +This section lists the properties that control amzfs\-sendrecv\*(Aqs functionality\&. See \fBamanda-applications\fR(7) for information on the Application API, application configuration\&. .PP DF\-PATH .RS 4 -Path to the \'df\' binary, search in $PATH by default\&. +Path to the \*(Aqdf\*(Aq binary, search in $PATH by default\&. .RE .PP KEEP\-SNAPSHOT @@ -72,13 +81,13 @@ If "YES" (the default), snapshot are kept after the backup, if set to "NO" then ZFS\-PATH .RS 4 -Path to the \'zfs\' binary, search in $PATH by default\&. +Path to the \*(Aqzfs\*(Aq binary, search in $PATH by default\&. .RE .PP PFEXEC\-PATH .RS 4 -Path to the \'pfexec\' binary, search in $PATH by default\&. +Path to the \*(Aqpfexec\*(Aq binary, search in $PATH by default\&. .RE .PP PFEXEC @@ -102,16 +111,19 @@ In this example, a dumptype is defined to use amzfs\-sendrecv application to bac } define dumptype user\-zfs\-sendrecv { - program "APPLICATAION" + program "APPLICATION" application "amzfs_sendrecv" } .fi .SH "SEE ALSO" .PP - +\fBamanda\fR(8), \fBamanda.conf\fR(5), \fBamanda-client.conf\fR(5), \fBamanda-applications\fR(7) +.PP +The Amanda Wiki: +: http://wiki.zmanda.com/ .SH "AUTHOR" .PP \fBJean\-Louis Martineau\fR <\&martineau@zmanda\&.com\&>