![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to rmt.8c CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man8|
Return to rmt.8c CVS log | Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man8 |
1.1 root 1: .TH RMT 8C "4 March 1983"
2: .UC 4
3: .SH NAME
4: rmt \- remote magtape protocol module
5: .SH SYNOPSIS
6: .B /etc/rmt
7: .SH DESCRIPTION
8: .I Rmt
9: is a program used by the remote dump and restore programs
10: in manipulating a magnetic tape drive through an interprocess
11: communication connection.
12: .I Rmt
13: is normally started up with an
14: .IR rexec (3X)
15: or
16: .IR rcmd (3X)
17: call.
18: .PP
19: The
20: .I rmt
21: program accepts requests specific to the manipulation of
22: magnetic tapes, performs the commands, then responds with
23: a status indication. All responses are in ASCII and in
24: one of two forms.
25: Successful commands have responses of
26: .PP
27: .ti +0.5i
28: \fBA\fInumber\fR\en
29: .PP
30: where
31: .I number
32: is an ASCII representation of a decimal number.
33: Unsuccessful commands are responded to with
34: .PP
35: .ti +0.5i
36: \fBE\fIerror-number\fR\en\fIerror-message\fR\en,
37: .PP
38: where
39: .I error-number
40: is one of the possible error
41: numbers described in
42: .IR intro (2)
43: and
44: .I error-message
45: is the corresponding error string as printed
46: from a call to
47: .IR perror (3).
48: The protocol is comprised of the
49: following commands (a space is present between each token).
50: .TP 15
51: .B O device mode
52: Open the specified
53: .I device
54: using the indicated
55: .IR mode .
56: .I Device
57: is a full pathname and
58: .I mode
59: is an ASCII representation of a decimal
60: number suitable for passing to
61: .IR open (2).
62: If a device had already been opened, it is
63: closed before a new open is performed.
64: .TP 15
65: .B C device
66: Close the currently open device. The
67: .I device
68: specified is ignored.
69: .TP 15
70: .B L whence offset
71: Perform an
72: .IR lseek (2)
73: operation using the specified parameters.
74: The response value is that returned from the
75: .I lseek
76: call.
77: .TP 15
78: .B W count
79: Write data onto the open device.
80: .I Rmt
81: reads
82: .I count
83: bytes from the connection, aborting if
84: a premature end-of-file is encountered.
85: The response value is that returned from
86: the
87: .IR write (2)
88: call.
89: .TP 15
90: .B R count
91: Read
92: .I count
93: bytes of data from the open device.
94: If
95: .I count
96: exceeds the size of the data buffer (10 kilobytes), it is
97: truncated to the data buffer size.
98: .I Rmt
99: then performs the requested
100: .IR read (2)
101: and responds with
102: \fBA\fIcount-read\fR\en if the read was
103: successful; otherwise an error in the
104: standard format is returned. If the read
105: was successful, the data read is then sent.
106: .TP 15
107: .B I operation count
108: Perform a MTIOCOP
109: .IR ioctl (2)
110: command using the specified parameters.
111: The parameters are interpreted as the
112: ASCII representations of the decimal values
113: to place in the
114: .I mt_op
115: and
116: .I mt_count
117: fields of the structure used in the
118: .I ioctl
119: call. The return value is the
120: .I count
121: parameter when the operation is successful.
122: .TP 15
123: .B S
124: Return the status of the open device, as
125: obtained with a MTIOCGET
126: .I ioctl
127: call. If the operation was successful,
128: an ``ack'' is sent with the size of the
129: status buffer, then the status buffer is
130: sent (in binary).
131: .PP
132: Any other command causes
133: .I rmt
134: to exit.
135: .SH DIAGNOSTICS
136: All responses are of the form described above.
137: .SH "SEE ALSO"
138: rcmd(3X),
139: rexec(3X),
140: mtio(4),
141: rdump(8C),
142: rrestore(8C)
143: .SH BUGS
144: People tempted to use this for a remote file access protocol
145: are discouraged.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.