1 .\" This file is part of GNU tar. -*- nroff -*-
2 .\" Copyright 2013 Free Software Foundation, Inc.
4 .\" GNU tar is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 3 of the License, or
7 .\" (at your option) any later version.
9 .\" GNU tar is distributed in the hope that it will be useful,
10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 .\" GNU General Public License for more details.
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program. If not, see <http://www.gnu.org/licenses/>.
16 .TH RMT 1 "January 27, 2014" "RMT" "GNU TAR Manual"
18 rmt \- remote magnetic tape server
23 provides remote access to files and devices for
26 and similar backup utilities. It is normally called by running
30 to the remote machine, optionally using a different
31 login name if one is supplied.
33 The calling program communicates with
35 by sending requests on its standard input and reading replies from the
36 standard output. A request consists of a request letter followed by
37 an argument (if required) and a newline character. Additional data,
38 if any, are sent after the newline. On success,
45 where \fInumber\fR is an ASCII representation of a decimal return
46 code. Additional data are returned after this line. On error, the
47 following response is returned:
50 .BI E errno \en error-message \en
52 where \fIerrno\fR is one of the system error codes, as described in
54 and \fIerror-message\fR is a one-line human-readable description of
55 the error, as printed by
58 Available commands and possible responses are discussed in detail in
59 the subsequent section.
62 .BI O device \en flags \en
63 Opens the \fIdevice\fR with given \fIflags\fR. If a
64 device had already been opened, it is closed before opening the new one.
70 The name of the device to open.
75 a decimal number, or any valid \fBO_*\fR constant from
77 (the initial \fBO_\fR may be omitted), or a bitwise or (using \fB|\fR)
78 of any number of these, e.g.:
86 In addition, a combined form is also allowed, i.e. a decimal mode followed
87 by its symbolic representation. In this case the symbolic representation
99 BSD version allows only decimal number as \fIflags\fR.
102 \fBC\fR[\fIdevice\fR]\fB\en\fR
103 Close the currently open device.
108 Any arguments are silently ignored.
116 .BI L whence \en offset \en
120 on the currently open device with the specified
127 Where to measure offset from. Valid values are:
131 0, SET, SEEK_SET seek from the file beginning
132 1, CUR, SEEK_CUR seek from the current location
133 2, END, SEEK_END seek from the file end
140 on success. The \fIoffset\fR is the new offset in file.
143 BSD version allows only 0,1,2 as \fIwhence\fR.
148 Read \fIcount\fR bytes of data from the current device.
155 number of bytes to read.
166 followed by \fIrdcount\fR bytes of data read from the device.
170 Writes data onto the current device. The command is followed by
171 \fIcount\fR bytes of input data.
178 Number of bytes to write.
183 On success: \fBA\fIwrcount\fB\en\fR, where \fIwrcount\fR is the number of
184 bytes actually written.
187 .BI I opcode \en count \en
191 command with the specified paramedters.
207 On success: \fBA0\en\fR.
211 Returns the status of the currently open device, as obtained from a
223 On success: \fBA\fIcount\fB\en\fR followed by \fIcount\fR bytes of
229 Using this utility as a general-purpose remote file access tool is
232 Report bugs to <bug\-tar@gnu.org>.
236 command appeared in 4.2BSD. The GNU
238 is written from scratch, using the BSD specification.
240 Copyright \(co 2013 Free Software Foundation, Inc.
243 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
246 This is free software: you are free to change and redistribute it.
247 There is NO WARRANTY, to the extent permitted by law.
249 .\" eval: (add-hook 'write-file-hooks 'time-stamp)
250 .\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \""
251 .\" time-stamp-format: "%:B %:d, %:y"
252 .\" time-stamp-end: "\""
253 .\" time-stamp-line-limit: 20