-.\" $OpenBSD: cdio.1,v 1.16 2000/03/05 00:28:52 aaron Exp $
+.\" $OpenBSD: cdio.1,v 1.17 2000/03/05 20:09:19 aaron Exp $
.Dd July 3, 1995
.Dt CDIO 1
.Os
.Sh DESCRIPTION
The
.Nm
-program controls audio features of a CD drive. The
+program controls audio features of a CD drive.
+The
.Ar device
is a name such
as
-.Dq cd0 ,
+.Dq cd0
or
.Dq mcd0 .
.Pp
The options are as follows:
.Bl -tag -width flag
.It Fl s
-Silent mode. Do not print table headers or human-readable comments.
+Silent mode.
+Do not print table headers or human-readable comments.
.It Fl v
-Verbose mode. Print as much information as possible.
+Verbose mode.
+Print as much information as possible.
.It Fl f Ar device
Specifies a device name such as
.Pa /dev/rcd0d
The raw partition name is added if needed.
.El
.Pp
-The available commands are listed below. Only as many
-characters as are required to uniquely identify a command
-need be specified. The word
-.Cm play
+The available commands are listed below.
+Only as many characters as are required to uniquely identify a command
+need be specified.
+The word
+.Ic play
may be omitted.
-.Bl -tag -width Cm
-.It Cm play Ar first_track Op Ar last_track
+.Bl -tag -width Ic
+.It Ic play Ar first_track Op Ar last_track
Play from track
.Ar first_track
to track
.Ar last_track .
The first track has number 1 and may be omitted in all cases.
-.It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
+.It Ic play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
Play from the absolute address
(MSF) defined by
.Ar start_m
in minutes,
-.Ar start_s,
-in seconds and
+.Ar start_s
+in seconds, and
.Ar start_f
(frame number) to the absolute address defined by
.Ar end_m
in minutes,
-.Ar end_s,
-in seconds and
+.Ar end_s
+in seconds, and
.Ar end_f
-(frame number). Minutes are in the range 0-99. Seconds are in the range 0-59.
+(frame number).
+Minutes are in the range 0-99.
+Seconds are in the range 0-59.
Frame numbers are in the range 0-74.
-.It Cm play Op Ar #start_block Op length
+.It Ic play Op Ar #start_block Op length
Play starting from the logical block
.Ar start_block
using
.Ar length
logical blocks.
-.It Cm pause
-Stop playing. Do not stop the disc.
-.It Cm next
-Play the next track. If we're at the last track, stop.
-.It Cm previous
-Play the previous track. If we're at the first track, restart.
-.It Cm replay
+.It Ic pause
+Stop playing.
+Do not stop the disc.
+.It Ic next
+Play the next track.
+If we're at the last track, stop.
+.It Ic previous
+Play the previous track.
+If we're at the first track, restart.
+.It Ic replay
Replay the current track again.
-.It Cm resume
-Resume playing. Used after the
-.Cm pause
+.It Ic resume
+Resume playing.
+Used after the
+.Ic pause
command.
-.It Cm stop
+.It Ic stop
Stop the disc.
-.It Cm eject
+.It Ic eject
Eject the disc.
-.It Cm close
+.It Ic close
Inject the disc.
-.It Cm volume Ar left_channel Ar right_channel
+.It Ic volume Ar left_channel Ar right_channel
Set the volume of the left channel to
.Ar left_channel
and the volume of the right channel to
.Ar right_channel .
Allowed values are in the range 0-255.
-.It Cm volume Ar mute
+.It Ic volume Ar mute
Turn the sound off.
-.It Cm volume Ar mono
+.It Ic volume Ar mono
Set the mono mode.
-.It Cm volume Ar stereo
+.It Ic volume Ar stereo
Set the stereo mode.
-.It Cm volume Ar left
+.It Ic volume Ar left
Play the left subtrack on both left and right channels.
-.It Cm volume Ar right
+.It Ic volume Ar right
Play the right subtrack on both left and right channels.
-.It Cm info
+.It Ic info
Print the table of contents.
-.It Cm status
+.It Ic status
Print information about the disc:
the current playing status and position,
the current media catalog status,
-the current values of the volume for left and right channels.
-.It Cm help
+and the current values of the volume for left and right channels.
+.It Ic help
Print the list of available commands.
-.It Cm debug Ar on
+.It Ic debug Ar on
Enable the debugging mode of the CD device driver.
-.It Cm debug Ar off
+.It Ic debug Ar off
Disable the driver debugging mode.
-.It Cm device Ar devname
+.It Ic device Ar devname
Make
.Ar devname
-the current CD device. This is the equivalent of quitting
+the current CD device.
+This is the equivalent of quitting
.Nm
and restarting with a different device.
-.It Cm reset
+.It Ic reset
Perform a hardware reset of the device.
-.It Cm set Ar msf
+.It Ic set Ar msf
Set minute-second-frame ioctl mode (default).
-.It Cm set Ar lba
+.It Ic set Ar lba
Set LBA ioctl mode.
-.It Cm quit
+.It Ic quit
Quit the program.
.Sh FILES
.Bl -tag -width /dev/rmcd0c -compact
-.\" $OpenBSD: checknr.1,v 1.7 1999/10/17 20:24:34 aaron Exp $
+.\" $OpenBSD: checknr.1,v 1.8 2000/03/05 20:09:20 aaron Exp $
.\" $NetBSD: checknr.1,v 1.5 1995/03/26 04:10:14 glass Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
another period,
and the second macro name.
For example, to define a pair .BS and .ES, use
-.Sq Li \-a.BS.ES
+.Dq Li \-a.BS.ES
.It Fl c
Define commands which would otherwise be complained about
as undefined.
-.\" $OpenBSD: chflags.1,v 1.9 1999/12/15 16:08:23 aaron Exp $
+.\" $OpenBSD: chflags.1,v 1.10 2000/03/05 20:09:20 aaron Exp $
.\" $NetBSD: chflags.1,v 1.4 1995/08/31 22:50:22 jtc Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993, 1994
Only the super-user can change the user flags on block and
character devices.
.Pp
-You can use "ls -lo" to see the flags of existing files.
+You can use
+.Ic ls -lo
+to see the flags of existing files.
.Pp
The
.Nm
.Xr stat 2 ,
.Xr fts 3 ,
.Xr symlink 7
+.Sh HISTORY
+The
+.Nm
+command first appeared in
+.Bx 4.4 .
-.\" $OpenBSD: cksum.1,v 1.10 1999/07/21 01:25:42 deraadt Exp $
+.\" $OpenBSD: cksum.1,v 1.11 2000/03/05 20:09:20 aaron Exp $
.\" $NetBSD: cksum.1,v 1.8 1995/09/02 05:45:15 jtc Exp $
.\"
.\" Copyright (c) 1991, 1993
.Op Ar file ...
.Sh DESCRIPTION
The
-.Nm
+.Nm cksum
utility writes to the standard output three whitespace separated
fields for each input file.
These fields are a checksum
The
.Nm sum
utility is identical to the
-.Nm
+.Nm cksum
utility, except that it defaults to using historic algorithm 1, as
described below.
It is provided for compatibility only.
.Ed
.Pp
The
-.Nm
+.Nm cksum
and
.Nm sum
utilities exit 0 on success or >0 if an error occurred.
.Sh WARNING
Do not use
-.Nm sum
+.Nm cksum
or
-.Nm
-to detect hostile binary modifications. An attacker
-can trivially produce backdoored daemons which have the same CRC as the
-standard versions. Use a cryptographic checksum (such as MD5) instead.
+.Nm sum
+to detect hostile binary modifications.
+An attacker can trivially produce backdoored daemons which have the same
+CRC as the standard versions.
+Use a cryptographic checksum (such as MD5) instead.
.Sh SEE ALSO
.Xr md5 1 ,
.Xr rmd160 1 ,
.Re
.Sh STANDARDS
The
-.Nm
+.Nm cksum
utility is compliant with the
.St -p1003.2-92
specification.
.Sh HISTORY
The
-.Nm
+.Nm cksum
utility appeared in
.Bx 4.4 .
-.\" .Pp
-.\" The
-.\" .Nm sum
-.\" utility appeared in
-.\" .Bx ?.?
-.\" and
-.\" .At V .
-.\" $OpenBSD: cmp.1,v 1.7 2000/03/05 00:28:52 aaron Exp $
+.\" $OpenBSD: cmp.1,v 1.8 2000/03/05 20:09:21 aaron Exp $
.\" $NetBSD: cmp.1,v 1.4 1995/09/08 03:22:55 tls Exp $
.\"
.\" Copyright (c) 1987, 1990, 1993
.Ar file2 ,
respectively, where the comparison will begin.
The offset is decimal by default, but may be expressed as a hexadecimal
-or octal value by preceding it with a leading ``0x'' or ``0''.
+or octal value by preceding it with a leading
+.Dq 0x
+or
+.Dq 0 .
.Pp
The
.Nm
.Fl s
option has not been specified,
.Nm
-writes to standard error that EOF was reached in the shorter
+writes to standard error that
+.Dv EOF
+was reached in the shorter
file (before any differences were found).
.It >1
An error occurred.
utility is expected to be
.St -p1003.2
compatible.
+.Sh HISTORY
+A
+.Nm
+command appeared in
+.At v1 .
.\" Copyright (c) 1988 Massachusetts Institute of Technology,
.\" Student Information Processing Board. All rights reserved.
.\"
-.\" $OpenBSD: compile_et.1,v 1.8 2000/02/19 12:07:18 hin Exp $
-.\" $Header: /home/cvs/src/usr.bin/compile_et/Attic/compile_et.1,v 1.8 2000/02/19 12:07:18 hin Exp $
+.\" $OpenBSD: compile_et.1,v 1.9 2000/03/05 20:09:21 aaron Exp $
+.\" $Header: /home/cvs/src/usr.bin/compile_et/Attic/compile_et.1,v 1.9 2000/03/05 20:09:21 aaron Exp $
.\"
.Dd November 22, 1988
.Dt COMPILE_ET 1
.Xr com_err 3
library.
.Pp
-The source file name must end with a suffix of ``.et''; the file
+The source file name must end with a suffix of
+.Dq .et ;
+the file
consists of headers and declarations supplying the name (up to four characters
long) of the error-code table.
-
+.Pp
The file may have these declarations:
-
-.Em id string
-
-where string is a revision control system tag.
-
-.Em prefix string
-
-where string is prepended to all error codes specified in the file.
-
-.Em error_table name
-
-which specifies the name of the error table.
-
-.Em index number
-
-sets the assigned error number for the next entry.
-
-.Em error_code name ,
-"
-.Em string
-"
-
-declares an error code called name with description name. Upto
-256 error codes are allowed.
-
-and a final
-
-.Em end
-
-to indicate the end of the table.
-
+.Bl -tag -width Ds
+.It Sy id Ar string
+Specify
+.Ar string
+as a revision control system tag.
+.It Sy prefix Ar string
+Prepends
+.Ar string
+to all error codes specified in the file.
+.It Sy error_table Ar name
+Specifies the name of the error table.
+.It Sy index Ar number
+Sets the assigned error number for the next entry.
+.It Xo Sy error_code
+.Ar name ,
+.Qq Ar string
+.Xc
+Declares an error code called
+.Ar name
+with description
+.Ar string ;
+up to 256 error codes are allowed.
+.It Sy end
+Indicates the end of the table.
+.El
.Pp
The name of the table is used to construct the name of a subroutine
.Em initialize_XXXX_error_table
with the object files which reference these error codes; it contains
the text of the messages and the initialization subroutine. Both C
files have names derived from that of the original source file, with
-the ``.et'' suffix replaced by ``.c'' and ``.h''.
+the
+.Dq .et
+suffix replaced by
+.Dq \&.c
+and
+.Dq \&.h .
.Pp
-A ``#'' in the source file is treated as a comment character, and all
-remaining text to the end of the source line will be ignored.
+A hash mark
+.Pq Ql #
+in the source file is treated as a comment character; subsequent
+characters to the end of the source line will be ignored.
.Sh BUGS
Since
.Nm
.Sh SEE ALSO
.Xr yacc 1 ,
.Xr com_err 3
+.\" XXX - use .br here to work-around apparent bug in mdoc
+.br
.Pp
.Rs
.%A Ken Raeburn
-.\" $OpenBSD: compress.1,v 1.9 1999/10/05 17:09:11 aaron Exp $
+.\" $OpenBSD: compress.1,v 1.10 2000/03/05 20:09:21 aaron Exp $
.\" $NetBSD: compress.1,v 1.5 1995/03/26 09:44:34 glass Exp $
.\"
.\" Copyright (c) 1986, 1990, 1993
flag is reached.
.Ar bits
must be between 9 and 16 (the default is 16).
+.\" XXX - use .br here to work-around an apparent bug in mdoc
+.br
.Pp
After the
.Ar bits
-.\" $OpenBSD: zopen.3,v 1.4 1997/01/19 17:25:12 millert Exp $
+.\" $OpenBSD: zopen.3,v 1.5 2000/03/05 20:09:21 aaron Exp $
.\" $NetBSD: zopen.3,v 1.3 1995/03/26 09:44:49 glass Exp $
.\"
.\" Copyright (c) 1992, 1993
Upon successful completion
.Fn zopen
returns a
-.Tn FILE
+.Dv FILE
pointer.
Otherwise,
.Dv NULL
-.\" $OpenBSD: ctags.1,v 1.8 2000/03/04 22:19:22 aaron Exp $
+.\" $OpenBSD: ctags.1,v 1.9 2000/03/05 20:09:21 aaron Exp $
.\" $NetBSD: ctags.1,v 1.4 1995/03/26 20:14:04 glass Exp $
.\"
.\" Copyright (c) 1987, 1990, 1993
Each line of the tags file contains the object name, the file in which it
is defined, and a search pattern for the object definition, separated by
whitespace.
+.Pp
Using the
.Ar tags
file,
.Nm ctags ,
objects will consist of subroutines, typedefs, defines, structs,
enums, and unions.
+.Pp
+The options are as follows:
.Bl -tag -width Ds
.It Fl B
Use backward searching patterns
.Ar tags
file, that is, all
references to them are deleted, and the new values are appended to the
-file. (Beware: this option is implemented in a way which is rather
+file.
+(Beware: this option is implemented in a way which is rather
slow; it is usually faster to simply rebuild the
.Ar tags
file.)
.It Fl v
An index of the form expected by
.Xr vgrind 1
-is produced on the standard output. This listing
-contains the object name, file name, and page number (assuming 64
-line pages). Since the output will be sorted into lexicographic order,
+is produced on the standard output.
+This listing contains the object name, file name, and page number (assuming
+64 line pages).
+Since the output will be sorted into lexicographic order,
it may be desired to run the output through
.Xr sort 1 .
Sample use:
.Nm
produces a list of object
names, the line number and file name on which each is defined, as well
-as the text of that line and prints this on the standard output. This
-is a simple index which can be printed out as an off-line readable
+as the text of that line and prints this on the standard output.
+This is a simple index which can be printed out as an off-line readable
function index.
.El
.Pp
Files whose names end in
-.Nm \&.c
+.Dq \&.c
or
-.Nm \&.h
+.Dq \&.h
are assumed to be C
source files and are searched for C style routine and macro definitions.
Files whose names end in
-.Nm \&.y
+.Dq \&.y
are assumed to be
.Tn YACC
source files.
Files whose names end in
-.Nm \&.l
+.Dq \&.l
are assumed to be lisp files if their
-first non-blank character is `;', `(', or `[',
+first non-blank character is
+.Ql \&; ,
+.Ql ( ,
+or
+.Ql [ ,
otherwise, they are
-treated as lex files. Other files are first examined to see if they
+treated as lex files.
+Other files are first examined to see if they
contain any Pascal or Fortran routine definitions, and, if not, are
searched for C style definitions.
.Pp
The tag
.Li main
-is treated specially in C programs. The tag formed
-is created by prepending
-.Ar M
+is treated specially in C programs.
+The tag formed is created by prepending
+.Sq M
to the name of the file, with the
trailing
-.Nm \&.c
-and any leading pathname components removed. This
-makes use of
+.Dq \&.c
+and any leading pathname components removed.
+This makes use of
.Nm
-practical in directories with more than one
-program.
+practical in directories with more than one program.
.Pp
Yacc and lex files each have a special tag.
.Ar Yyparse
.Nm procedures
for
.Tn FORTRAN
-and Pascal is done in a very simple-minded way. No attempt
+and Pascal is done in a very simple-minded way.
+No attempt
is made to deal with block structure; if you have two Pascal procedures
in different blocks with the same name you lose.
.Nm
.Pp
.Nm
relies on the input being well formed, and any syntactical
-errors will completely confuse it. It also finds some legal syntax
-confusing; for example, since it doesn't understand
+errors will completely confuse it.
+It also finds some legal syntax confusing; for example,
+since it doesn't understand
.Li #ifdef Ns 's
(incidentally, that's a feature, not a bug), any code with unbalanced
braces inside
will cause it to become somewhat disoriented.
In a similar fashion, multiple line changes within a definition will
cause it to enter the last line of the object, rather than the first, as
-the searching pattern. The last line of multiple line
+the searching pattern.
+The last line of multiple line
.Li typedef Ns 's
will similarly be noted.
.Sh HISTORY
-.\" $OpenBSD: cut.1,v 1.5 1999/07/04 11:53:52 aaron Exp $
+.\" $OpenBSD: cut.1,v 1.6 2000/03/05 20:09:21 aaron Exp $
.\" $NetBSD: cut.1,v 1.6 1995/10/02 20:19:26 jtc Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993
The
.Nm
utility selects portions of each line (as specified by
-.Ar list )
+.Ar list )
from each
.Ar file
(or the standard input by default), and writes them to the
The items specified by
.Ar list
can be in terms of column position or in terms of fields delimited
-by a special character. Column numbering starts from 1.
+by a special character.
+Column numbering starts from 1.
.Pp
.Ar list
is a comma or whitespace separated set of increasing numbers and/or
Number ranges consist of a number, a dash
.Pq Sq \- ,
and a second number
-and select the fields or columns from the first number to the second,
+which select the fields or columns from the first number to the second,
inclusive.
Numbers or number ranges may be preceded by a dash, which selects all
fields or columns from 1 to the first number.
-.\" $OpenBSD: du.1,v 1.10 1999/07/04 11:53:53 aaron Exp $
+.\" $OpenBSD: du.1,v 1.11 2000/03/05 20:09:22 aaron Exp $
.\" $NetBSD: du.1,v 1.6 1996/10/18 07:20:31 thorpej Exp $
.\"
.\" Copyright (c) 1990, 1993
This option exists solely for conformance with
.St -xpg4 .
.It Fl x
-Filesystem mount points are not traversed.
+File system mount points are not traversed.
.El
.Pp
.Nm
execution.
.Sh ENVIRONMENT
.Bl -tag -width BLOCKSIZE
+The following environment variables affect the execution of
+.Nm du :
+.Pp
.It Ev BLOCKSIZE
-If the environment variable
-.Ev BLOCKSIZE
-is set, and the
+Block counts will be displayed in units of this size block, unless the
.Fl k
-option is not specified, the block counts will be displayed in units of that
-size block.
+option is also specified.
.El
.Sh SEE ALSO
.Xr df 1 ,
-.\" $OpenBSD: encrypt.1,v 1.13 2000/03/05 00:28:52 aaron Exp $
+.\" $OpenBSD: encrypt.1,v 1.14 2000/03/05 20:09:22 aaron Exp $
.\"
.\" Copyright (c) 1996, Jason Downs. All rights reserved.
.\"
is specified,
.Nm
reads one string per line from standard input, encrypting each one
-with the chosen algorithm from above. In case that no specific algorithm
+with the chosen algorithm from above.
+In case that no specific algorithm
was given as a command line option, the default will be looked up from
.Pa /etc/passwd.conf .
.Pp
-.\" $OpenBSD: env.1,v 1.5 1999/06/05 01:21:23 aaron Exp $
+.\" $OpenBSD: env.1,v 1.6 2000/03/05 20:09:22 aaron Exp $
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
executes
.Ar utility
after modifying the environment as
-specified on the command line. The option
+specified on the command line.
+The option
.Ar name Ns No = Ns Ar value
specifies
an environment variable,
-.Ar name ,
+.Ar name ,
with a value of
-.Ar value .
-The
-.Fl i
-option
-causes
+.Ar value .
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl i
+Causes
.Nm
-to completely ignore the environment
-it inherits.
+to completely ignore the environment it inherits.
+.El
.Pp
If no
.Ar utility
projects / openbsd / commitdiff