diff options
Diffstat (limited to 'usr.sbin')
-rw-r--r-- | usr.sbin/rmt/rmt.8 | 63 |
1 files changed, 21 insertions, 42 deletions
diff --git a/usr.sbin/rmt/rmt.8 b/usr.sbin/rmt/rmt.8 index 92455d77467..a48d3d5e3dc 100644 --- a/usr.sbin/rmt/rmt.8 +++ b/usr.sbin/rmt/rmt.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rmt.8,v 1.11 2007/05/31 19:20:28 jmc Exp $ +.\" $OpenBSD: rmt.8,v 1.12 2011/07/23 15:40:13 schwarze Exp $ .\" .\" Copyright (c) 1983, 1991 The Regents of the University of California. .\" All rights reserved. @@ -28,9 +28,8 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)rmt.8 6.5 (Berkeley) 3/16/91 -.\" $Id: rmt.8,v 1.11 2007/05/31 19:20:28 jmc Exp $ .\" -.Dd $Mdocdate: May 31 2007 $ +.Dd $Mdocdate: July 23 2011 $ .Dt RMT 8 .Os .Sh NAME @@ -55,28 +54,17 @@ The program accepts requests specific to the manipulation of magnetic tapes, performs the commands, then responds with a status indication. -All responses are in -.Tn ASCII -and in -one of two forms. +All responses are in ASCII and in one of two forms. Successful commands have responses of: -.Bd -filled -offset indent -.Sm off -.Sy A Ar number No \en -.Sm on -.Ed +.Pp +.D1 Sy A Ns Ar number Ns \en .Pp .Ar number -is an -.Tn ASCII -representation of a decimal number. +is an ASCII representation of a decimal number. Unsuccessful commands are responded to with: .Bd -filled -offset indent .Sm off -.Xo Sy E Ar error-number -.No \en Ar error-message -.No \en -.Xc +.Sy E Ar error-number No \en Ar error-message No \en .Sm on .Ed .Pp @@ -96,9 +84,10 @@ between the command and its arguments, or between its arguments, and indicates that a newline should be supplied: .Bl -tag -width Ds .Sm off -.It Xo Sy \&O Ar device +.It Xo Ic \&O Ar device .No \en Ar mode No \en .Xc +.Sm on Open the specified .Ar device using the indicated @@ -106,20 +95,18 @@ using the indicated .Ar device is a full pathname and .Ar mode -is an -.Tn ASCII -representation of a decimal +is an ASCII representation of a decimal number suitable for passing to .Xr open 2 . If a device had already been opened, it is closed before a new open is performed. -.It Xo Sy C Ar device No \en -.Xc +.It Ic C Ns Ar device Ns \en Close the currently open device. The .Ar device specified is ignored. -.It Xo Sy L +.Sm off +.It Xo Ic L .Ar offset No \en .Ar whence No \en .Xc @@ -128,11 +115,9 @@ Perform an .Xr lseek 2 operation using the specified parameters. The response value is that returned from the -.Xr lseek +.Xr lseek 2 call. -.Sm off -.It Sy W Ar count No \en -.Sm on +.It Ic W Ns Ar count Ns \en Write data onto the open device. .Nm reads @@ -143,9 +128,7 @@ The response value is that returned from the .Xr write 2 call. -.Sm off -.It Sy R Ar count No \en -.Sm on +.It Ic R Ns Ar count Ns \en Read .Ar count bytes of data from the open device. @@ -157,15 +140,13 @@ truncated to the data buffer size. then performs the requested .Xr read 2 and responds with -.Sm off -.Sy A Ar count-read No \en -.Sm on +.Sy A Ns Ar count-read Ns \en if the read was successful; otherwise an error in the standard format is returned. If the read was successful, the data read is then sent. .Sm off -.It Xo Sy I Ar operation +.It Xo Ic I Ar operation .No \en Ar count No \en .Xc .Sm on @@ -174,19 +155,18 @@ Perform an .Xr ioctl 2 command using the specified parameters. The parameters are interpreted as the -.Tn ASCII -representations of the decimal values +ASCII representations of the decimal values to place in the .Ar mt_op and .Ar mt_count fields of the structure used in the -.Fn ioctl +.Xr ioctl 2 call. The return value is the .Ar count parameter when the operation is successful. -.It Sy S +.It Ic S Return the status of the open device, as obtained with a .Dv MTIOCGET @@ -197,7 +177,6 @@ If the operation was successful, an is sent with the size of the status buffer, then the status buffer is sent (in binary). .El -.Sm on .Pp Any other command causes .Nm |