X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=man%2Famservice.8;h=d08bb04e7190142ef5a31ee6c3832f550d95e7d8;hb=HEAD;hp=d870612b1a091bb4ce533c55cb69c0ee84013bf0;hpb=e9de482962ca61612054c6e0382814b04e416129;p=debian%2Famanda diff --git a/man/amservice.8 b/man/amservice.8 index d870612..d08bb04 100644 --- a/man/amservice.8 +++ b/man/amservice.8 @@ -1,13 +1,22 @@ '\" t .\" Title: amservice .\" Author: Jean-Louis Martineau -.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 -.\" Date: 11/05/2009 +.\" Generator: DocBook XSL Stylesheets v1.76.1 +.\" Date: 01/10/2013 .\" Manual: System Administration Commands -.\" Source: Amanda 2.6.1p2 +.\" Source: Amanda 3.3.3 .\" Language: English .\" -.TH "AMSERVICE" "8" "11/05/2009" "Amanda 2\&.6\&.1p2" "System Administration Commands" +.TH "AMSERVICE" "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,18 +31,15 @@ amservice \- run an amanda service on a client .SH "SYNOPSIS" .HP \w'\fBamservice\fR\ 'u -\fBamservice\fR \fIhostname\fR \fIauth\fR \fIservice\fR [\-f\ \fIinput_file\fR] [\-o\ \fIconfigoption\fR]... +\fBamservice\fR [\-f\ \fIinput_file\fR\ [\-s]] [\fB\-o\fR\ \fIconfigoption\fR...] \fIhostname\fR \fIauth\fR \fIservice\fR .SH "DESCRIPTION" .PP \fBAmservice\fR -execute an -\fIAmanda\fR -service on a client\&. It can be used without amanda server configuration (amanda\&.conf and disklist)\&. It can be used to check communication between a server and a client\&. Amservice reads stdin to capture the REQ packet to send to the client\&. +execute an Amanda service on a client\&. It can be used without amanda server configuration (amanda\&.conf and disklist)\&. It can be used to check communication between a server and a client\&. Amservice reads stdin to capture the REQ packet to send to the client\&. .PP See the \fBamanda\fR(8) -man page for more details about -\fIAmanda\fR\&. +man page for more details about Amanda\&. .SH "OPTIONS" .PP \fBhostname\fR @@ -56,16 +62,22 @@ The amanda service to execute on the client\&. One of noop, selfcheck or sendsiz Use the file input_file instead of stdin to read the REQ packet from\&. .RE .PP -\fB\-o\fR \fIconfigoption\fR +\fB\-s\fR +.RS 4 +Redirect the first connected stream to stdin/stdout\&. The \-f argument is required for the REQ packet, the REP packet is not printed on stdout\&. +.RE +.PP +\fB\-o \fR\fB\fIconfigoption\fR\fR .RS 4 -See the "\fBCONFIGURATION OVERRIDE\fR" section in +See the "CONFIGURATION OVERRIDE" section in \fBamanda\fR(8)\&. .RE .SH "EXAMPLE" .PP The noop service is easy to execute because it does not require a REQ packet: .nf -amservice hostname bsdtcp noop < /dev/null.fi +amservice hostname bsdtcp noop < /dev/null +.fi .PP The example executes the noop service on the client using bsdtcp auth\&. This is useful for debugging connection problems\&. It print an OPTIONS line upon success\&. .PP @@ -80,15 +92,19 @@ The exit code of \fBamservice\fR is one of: .PP As \fBamservice\fR -doesn\'t parse the REP packet, it can only detect failures in executing amandad on the client\&. +doesn\*(Aqt parse the REP packet, it can only detect failures in executing amandad on the client\&. \fBamservice\fR can exit with value 0 even if the user is not authorized to execute the service\&. An error message will be printed\&. .SH "SEE ALSO" .PP \fBamanda\fR(8), +\fBamanda\fR(8), \fBamcheck\fR(8), \fBamdump\fR(8), \fBamadmin\fR(8) +.PP +The Amanda Wiki: +: http://wiki.zmanda.com/ .SH "AUTHOR" .PP \fBJean\-Louis Martineau\fR <\&martineau@zmanda\&.com\&>