Merge branch 'master' into squeeze
[debian/amanda] / man / amsuntar.8
diff --git a/man/amsuntar.8 b/man/amsuntar.8
new file mode 100644 (file)
index 0000000..cb6d161
--- /dev/null
@@ -0,0 +1,147 @@
+'\" t
+.\"     Title: amsuntar
+.\"    Author: Satya Ganga <gast@zmanda.com>
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\"      Date: 02/21/2012
+.\"    Manual: System Administration Commands
+.\"    Source: Amanda 3.3.1
+.\"  Language: English
+.\"
+.TH "AMSUNTAR" "8" "02/21/2012" "Amanda 3\&.3\&.1" "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"
+amsuntar \- Amanda Application to interface with native tar utility available on solaris platforms
+.SH "DESCRIPTION"
+.PP
+Amsuntar is an Amanda Application API script\&. It should not be run by users directly\&. It uses Solaris bundled tar utility to backup and restore data\&. Currenty ACLs from ZFS file system can only be backed up using the solaris supplied tar utility\&.
+.PP
+The
+\fBdiskdevice\fR
+in the disklist (DLE) must be the directory to backup\&.
+.PP
+Solaris 10 supports Role Based Access Control(RBAC) which is enabled by default\&. To run backup operations using sun tar utility by under privileged user like amandabackup, amandabackup user need to have proper roles and profiles, specially "Media Backup" profile/role\&. This can be done using \*(Aqusermod \-P "Media Backup" amandabackup\*(Aq command\&.
+.SH "PROPERTIES"
+.PP
+This section lists the properties that control amsuntar\*(Aqs functionality\&. See
+\fBamanda-applications\fR(7)
+for information on application properties and how they are configured\&.
+.PP
+BLOCK\-SIZE
+.RS 4
+
+Optional tar read or write block size\&.  The default is 256\&.
+.RE
+.PP
+DIRECTORY
+.RS 4
+
+If set, suntar will backup from that directory instead of the \fIdiskdevice\fR set by the DLE\&. On restore, the data is restore in that directory instead of the current working directory\&.
+.RE
+.PP
+EXTENDED\-ATTRIBUTES
+.RS 4
+
+Include extended attributes in archive\&.  The default is YES\&.
+.RE
+.PP
+EXTENDED\-HEADERS
+.RS 4
+
+Write tar file with extended headers\&. With this optiion the modification time
+is maintained with a  granularity of microseconds,Long file names and file 
+sizes greater than 8GB can be archived\&. The default is YES\&.
+.RE
+.PP
+SUNTAR\-PATH
+.RS 4
+
+The path to the suntar binary\&. The default is set when Amanda is built\&.
+.RE
+.PP
+LANG
+.RS 4
+
+Default LANG is "C"\&. suntar require an UTF\-8 LANG if you have UTF\-8 filename and it is configured for extended headers\&. A good value can be "en_US\&.UTF\-8" if that locale is installed on your machine\&.
+.RE
+.PP
+NORMAL
+.RS 4
+List all regex (Perl Regular Expression syntax) that are normal output from sun tar\&. These output are in the "FAILED DUMP DETAILS" section of the email report if the dump result is STRANGE or FAILED\&. Default values:
+.sp
+.nf
+is not a file\&. Not dumped\e$
+same as archive file\e$
+.fi
+.sp
+To treat one of these default patterns differently, specify it explicitly in a different property\&.
+.RE
+.PP
+IGNORE
+.RS 4
+List all regex (Perl Regular Expression syntax) that amanda ignore\&. These output are never in the email report\&.
+.RE
+.PP
+STRANGE
+.RS 4
+List all regex (Perl Regular Expression syntax) that are strange output from sun tar\&. The result of the dump is STRANGE if sun tar produce a strange output\&. These output are in the "FAILED DUMP DETAILS" section of the email report\&. Default values:
+.sp
+.nf
+: invalid character in UTF\-8 conversion of 
+: UTF\-8 conversion failed\&.\e$
+.fi
+.sp
+To treat one of these default patterns differently, specify it explicitly in a different property\&.
+.RE
+.PP
+ERROR
+.RS 4
+List all regex (perl Regular Expression syntax) that are error output from sun tar\&. All sun tar output that doesn\*(Aqt match a normal, ignore or strange regex are error by default\&. The result of the dump is FAILED if sun tar produce an error output\&. These output are in the "FAILED DUMP DETAILS" section of the email report\&. Default values:
+.sp
+.nf
+: Permission denied\e$
+.fi
+.sp
+To treat one of these default patterns differently, specify it explicitly in a different property\&.
+.RE
+.SH "SEE ALSO"
+.PP
+\fBamanda\fR(8),
+\fBamanda.conf\fR(5),
+\fBamanda-applications\fR(7)
+.PP
+The Amanda Wiki:
+: http://wiki.zmanda.com/
+.SH "AUTHORS"
+.PP
+\fBSatya Ganga\fR <\&gast@zmanda\&.com\&>
+.RS 4
+Zmanda, Inc\&. (http://www\&.zmanda\&.com)
+.RE
+.PP
+\fBJean\-Louis Martineau\fR <\&martineau@zmanda\&.com\&>
+.RS 4
+Zmanda, Inc\&. (http://www\&.zmanda\&.com)
+.RE
+.PP
+\fBDustin J\&. Mitchell\fR <\&dustin@zmanda\&.com\&>
+.RS 4
+Zmanda, Inc\&. (http://www\&.zmanda\&.com)
+.RE