3 .\" Author: Jean-Louis Martineau <martineau@zmanda.com>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6 .\" Manual: System Administration Commands
7 .\" Source: Amanda 3.3.2
10 .TH "AMSERVICE" "8" "07/25/2012" "Amanda 3\&.3\&.2" "System Administration Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 amservice \- run an amanda service on a client
33 .HP \w'\fBamservice\fR\ 'u
34 \fBamservice\fR [\-f\ \fIinput_file\fR\ [\-s]] [\fB\-o\fR\ \fIconfigoption\fR...] \fIhostname\fR \fIauth\fR \fIservice\fR
38 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\&.
42 man page for more details about Amanda\&.
47 The hostname of the client\&.
52 The auth to use, one of: bsd, bsdudp, bsdtcp, ssh, rsh or krb5\&. The client must be configured with this auth\&.
57 The amanda service to execute on the client\&. One of noop, selfcheck or sendsize\&.
62 Use the file input_file instead of stdin to read the REQ packet from\&.
67 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\&.
70 \fB\-o \fR\fB\fIconfigoption\fR\fR
72 See the "CONFIGURATION OVERRIDE" section in
77 The noop service is easy to execute because it does not require a REQ packet:
79 amservice hostname bsdtcp noop < /dev/null
82 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\&.
84 It is more difficult to execute the selfcheck or sendsize service, as these require a valid REQ packet\&. If you have already uccessfully run amanda, you can find valid REQ packets in the amandad\&.*\&.debug files\&.
87 The exit code of \fBamservice\fR is one of:
90 1 = error executing amandad on the client\&.
95 doesn\*(Aqt parse the REP packet, it can only detect failures in executing amandad on the client\&.
97 can exit with value 0 even if the user is not authorized to execute the service\&. An error message will be printed\&.
107 : http://wiki.zmanda.com/
110 \fBJean\-Louis Martineau\fR <\&martineau@zmanda\&.com\&>
112 Zmanda, Inc\&. (http://www\&.zmanda\&.com)