-.\" $OpenBSD: oldrdist.1,v 1.6 2000/03/04 22:19:25 aaron Exp $
+.\" $OpenBSD: oldrdist.1,v 1.7 2000/03/10 20:17:48 aaron Exp $
+.\"
.\" Copyright (c) 1985, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.Ar distfile .
If
.Ar distfile
-is `-', the standard input is used.
+is
+.Dq - ,
+the standard input is used.
.El
.Pp
If either the
If no names are specified on the command line,
.Nm rdist
will update all of the files and directories listed in
-.Ar distfile .
+.Ar distfile .
Otherwise, the argument is taken to be the name of a file to be updated
-or the label of a command to execute. If label and file names conflict,
-it is assumed to be a label.
+or the label of a command to execute.
+If label and file names conflict, it is assumed to be a label.
These may be used together to update specific files
using specific commands.
.Pp
Forces
.Nm rdist
to interpret the remaining arguments as a small
-.Ar distfile .
+.Ar distfile .
.Pp
The equivalent distfile is as follows.
.Pp
Options common to both forms:
.Bl -tag -width Ic
.It Fl b
-Binary comparison. Perform a binary comparison and update files if they differ
+Binary comparison.
+Perform a binary comparison and update files if they differ
rather than comparing dates and sizes.
.It Fl d Ar var=value
Define
.Ar var
to have
-.Ar value .
+.Ar value .
The
.Fl d
option is used to define or override variable definitions in the
-.Ar distfile .
+.Ar distfile .
.Ar Value
can be the empty string, one name, or a list of names surrounded by
parentheses and separated by tabs and/or spaces.
.It Fl h
-Follow symbolic links. Copy the file that the link points to rather than the
-link itself.
+Follow symbolic links.
+Copy the file that the link points to rather than the link itself.
.It Fl i
Ignore unresolved links.
.Nm rdist
will normally try to maintain the link structure of files being transferred
and warn the user if all the links cannot be found.
.It Fl m Ar host
-Limit which machines are to be updated. Multiple
+Limit which machines are to be updated.
+Multiple
.Fl m
arguments can be given to limit updates to a subset of the hosts listed in the
-.Ar distfile .
+.Ar distfile .
.It Fl n
-Print the commands without executing them. This option is
-useful for debugging
-.Ar distfile .
+Print the commands without executing them.
+This option is useful for debugging
+.Ar distfile .
.It Fl q
-Quiet mode. Files that are being modified are normally
-printed on standard output. The
+Quiet mode.
+Files that are being modified are normally printed on standard output.
+The
.Fl q
option suppresses this.
.It Fl R
-Remove extraneous files. If a directory is being updated, any files that exist
+Remove extraneous files.
+If a directory is being updated, any files that exist
on the remote host that do not exist in the master directory are removed.
This is useful for maintaining truly identical copies of directories.
.It Fl v
-Verify that the files are up to date on all the hosts. Any files
+Verify that the files are up to date on all the hosts.
+Any files
that are out of date will be displayed but no files will be changed
nor any mail sent.
.It Fl w
-Whole mode. The whole file name is appended to the destination directory
-name. Normally, only the last component of a name is used when renaming files.
+Whole mode.
+The whole file name is appended to the destination directory
+name.
+Normally, only the last component of a name is used when renaming files.
This will preserve the directory structure of the files being
-copied instead of flattening the directory structure. For example,
+copied instead of flattening the directory structure.
+For example,
renaming a list of files such as ( dir1/f1 dir2/f2 ) to dir3 would create
files dir3/dir1/f1 and dir3/dir2/f2 instead of dir3/f1 and dir3/f2.
.It Fl y
-Younger mode. Files are normally updated if their
+Younger mode.
+Files are normally updated if their
.Ar mtime
and
.Ar size
(see
-.Xr stat 2 )
-disagree. The
+.Xr stat 2 )
+disagree.
+The
.Fl y
option causes
.Nm rdist
.Ar distfile
contains a sequence of entries that specify the files
to be copied, the destination hosts, and what operations to perform
-to do the updating. Each entry has one of the following formats:
+to do the updating.
+Each entry has one of the following formats:
.Pp
.Bd -literal -offset indent -compact
<variable name> `=' <name list>
The
.Ar destination list
is the list of hosts to which these files are to be
-copied. Each file in the source list is added to a list of changes
+copied.
+Each file in the source list is added to a list of changes
if the file is out of date on the host which is being updated (second format) or
the file is newer than the time stamp file (third format).
.Pp
-Labels are optional. They are used to identify a command for partial updates.
+Labels are optional.
+They are used to identify a command for partial updates.
.Pp
Newlines, tabs, and blanks are only used as separators and are
-otherwise ignored. Comments begin with `#' and end with a newline.
+otherwise ignored.
+Comments begin with
+.Ql #
+and end with a newline.
.Pp
-Variables to be expanded begin with `$' followed by one character or
+Variables to be expanded begin with
+.Ql $
+followed by one character or
a name enclosed in curly braces (see the examples at the end).
.Pp
The source and destination lists have the following format:
`(' <zero or more names separated by whitespace> `)'
.Ed
.Pp
-The shell meta-characters `[', `]', `{', `}', `*', and `?'
+The shell meta-characters
+.Ql [ ,
+.Ql \&] ,
+.Ql { ,
+.Ql } ,
+.Ql * ,
+and
+.Ql ?
are recognized and expanded (on the local host only) in the same way as
-.Xr csh 1 .
+.Xr csh 1 .
They can be escaped with a backslash.
-The `~' character is also expanded in the same way as
+The
+.Ql ~
+character is also expanded in the same way as
.Xr csh 1
but is expanded separately on the local and destination hosts.
When the
.Fl w
-option is used with a file name that begins with `~', everything except the
+option is used with a file name that begins with
+.Ql ~ ,
+everything except the
home directory is appended to the destination name.
-File names which do not begin with `/' or `~' use the destination user's
+File names which do not begin with
+.Ql /
+or
+.Ql ~
+use the destination user's
home directory as the root directory for the rest of the file name.
.Pp
The command list consists of zero or more commands of the following
the source file name is used.
Directories in the path name will be created if they
do not exist on the remote host.
+.Pp
To help prevent disasters, a non-empty directory on a target host will
never be replaced with a regular file or a symbolic link.
-However, under the `\-R' option a non-empty directory will be removed
+However, under the
+.Fl R
+option a non-empty directory will be removed
if the corresponding filename is completely absent on the master host.
The
.Ar options
-are `\-R', `\-h', `\-i', `\-v', `\-w', `\-y', and `\-b'
+are
+.Fl R ,
+.Fl h ,
+.Fl i ,
+.Fl v ,
+.Fl w ,
+.Fl y ,
+and
+.Fl b
and have the same semantics as
options on the command line except they only apply to the files
in the source list.
The login name used on the destination host is the same as the local host
-unless the destination name is of the format ``login@host''.
+unless the destination name is of the format
+.Dq login@host .
.Pp
The
.Ic notify
command is used to mail the list of files updated (and any errors
that may have occurred) to the listed names.
-If no `@' appears in the name, the destination host is appended to
-the name
+If no
+.Ql @
+appears in the name, the destination host is appended to the name
(e.g., name1@host, name2@host, ...).
.Pp
The
.Ic except
command is used to update all of the files in the source list except
for the files listed in
-.Ar name list .
+.Ar name list .
This is usually used to copy everything in a directory except certain files.
.Pp
The
.Ar pattern list
is a list of regular expressions
(see
-.Xr ed 1
+.Xr ed 1
for details).
If one of the patterns matches some string within a file name, that file will
be ignored.
-Note that since `\e' is a quote character, it must be doubled to become
-part of the regular expression. Variables are expanded in
+Note that since
+.Ql \e
+is a quote character, it must be doubled to become
+part of the regular expression.
+Variables are expanded in
.Ar pattern list
-but not shell file pattern matching characters. To include a `$', it
-must be escaped with `\e'.
+but not shell file pattern matching characters.
+To include a
+.Ql $ ,
+it must be escaped with
+.Ql \e .
.Pp
The
.Ic special
command is used to specify
-.Xr sh 1
+.Xr sh 1
commands that are to be executed on the
remote host after the file in
.Ar name list
If the
.Ar name list
is omitted then the shell commands will be executed
-for every file updated or installed. The shell variable FILE is set
+for every file updated or installed.
+The shell variable FILE is set
to the current filename before executing the commands in
-.Ar string .
+.Ar string .
.Ar string
-starts and ends with `"' and can cross multiple lines in
+starts and ends with
+.Ql \&"
+and can cross multiple lines in
.Ar distfile .
-Multiple commands to the shell should be separated by `;'.
+Multiple commands to the shell should be separated by
+.Ql \&; .
Commands are executed in the user's home directory on the host
being updated.
The
.Nm rdist
aborts on files which have a negative mtime (before Jan 1, 1970).
.Pp
-There should be a `force' option to allow replacement of non-empty directories
-by regular files or symlinks. A means of updating file modes and owners
+There should be a
+.Dq force
+option to allow replacement of non-empty directories
+by regular files or symlinks.
+A means of updating file modes and owners
of otherwise identical files is also needed.
-.\" $OpenBSD: passwd.1,v 1.8 1999/06/05 01:21:36 aaron Exp $
+.\" $OpenBSD: passwd.1,v 1.9 2000/03/10 20:17:49 aaron Exp $
+.\"
.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" This should really be: passwd [-l] [-y] [-k [-n name] [-i instance] [-r realm] [-u username[.instance][@realm]]] [user]
.Sh DESCRIPTION
.Nm passwd
-changes the user's local, Kerberos, or YP password. First, the user is prompted
-for their current password.
+changes the user's local, Kerberos, or YP password.
+First, the user is prompted for their current password.
If the current password is correctly typed, a new password is
requested.
The new password must be entered twice to avoid typing errors.
(currently 128 characters).
Numbers, upper case letters and meta-characters
are encouraged.
+.Pp
+The options are as follows:
.Bl -tag -width flag
.It Fl l
Causes the password to be updated only in the local
-password file. When changing only the local password,
-.Xr pwd_mkdb 8
+password file.
+When changing only the local password,
+.Xr pwd_mkdb 8
is used to update the password databases.
.It Fl y
Forces the YP password database entry to be changed, even if
-the user has an entry in the local database. The
+the user has an entry in the local database.
+The
.Xr rpc.yppasswdd 8
daemon should be running on the YP master server.
.It Fl k
.It Fl n Ar name
Specifies a
.Ar name
-that will be used as the principal name rather than the username
+that will be used as the principal name rather than the username
of the user running
.Nm passwd .
-(This is determined from the ticket file if it exists; otherwise,
+(This is determined from the ticket file if it exists; otherwise,
it is determined from the Unix user ID.)
.It Fl i Ar instance
Specifies an
.Ar realm
instead of the local realm.
.It Fl u Ar username[.instance][@realm]
-Specifies a fully qualified kerberos principal.
+Specifies a fully qualified Kerberos principal.
.El
.Pp
This is the behavior if no flags are specified:
-.\" $OpenBSD: paste.1,v 1.4 1999/06/05 01:21:36 aaron Exp $
+.\" $OpenBSD: paste.1,v 1.5 2000/03/10 20:17:49 aaron Exp $
+.\"
.\" Copyright (c) 1989, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.Pp
The options are as follows:
.Bl -tag -width Fl
-.It Fl d Ar list
+.It Fl d Ar list
Use one or more of the provided characters to replace the newline
characters instead of the default tab.
The characters in
.El
.Pp
If
-.Ql Fl
+.Dq -
is specified for one or more of the input files, the standard
input is used; standard input is read one line at a time, circularly,
for each instance of
-.Ql Fl .
+.Dq - .
.Pp
The
.Nm paste
-.\" $OpenBSD: pctr.1,v 1.3 1998/12/16 02:38:50 aaron Exp $
+.\" $OpenBSD: pctr.1,v 1.4 2000/03/10 20:17:49 aaron Exp $
.\"
.\" Copyright (c) 1998, Jason Downs. All rights reserved.
.\"
.Nm
command displays the current values of the TSC and any vendor specific
counter registers.
-.Sh OPTIONS
+.Pp
+The options are as follows:
.Bl -tag -width indent
-There is one available option:
.It Fl l Ar 5 | 6
List all possible vendor specific counters. The argument specifies which
.Dq family
.Dq family
designation of the current processor.
.El
-.Sh RETURN VALUES
+.Pp
The
.Nm
program exits with a value of 0 on success or 1 on failure.
-.Sh BUGS
-The
-.Nm
-program is still orientated towards Intel brand microprocessors.
.Sh SEE ALSO
.Xr pctr 4
.Sh HISTORY
.Nm
program appeared in
.Ox 2.0 .
+.Sh BUGS
+The
+.Nm
+program is still orientated towards Intel brand microprocessors.
-.\" $OpenBSD: pr.1,v 1.10 2000/03/06 03:15:59 aaron Exp $
+.\" $OpenBSD: pr.1,v 1.11 2000/03/10 20:17:49 aaron Exp $
+.\"
.\" Copyright (c) 1991 Keith Muller.
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
When multiple input files are specified, each is read, formatted,
and written to standard output.
By default, the input is separated into 66-line pages, each with
-.sp
-.in +2
-.ti -2
-\(bu A 5-line header with the page number, date, time, and
+.Bl -bullet -offset indent
+.It
+A 5-line header with the page number, date, time, and
the pathname of the file.
-.sp
-.ti -2
-\(bu A 5-line trailer consisting of blank lines.
-.in -2
+.It
+A 5-line trailer consisting of blank lines.
+.El
.Pp
Optionally, the trailer can be replaced by a
.Em <form-feed>
.Fl column
option.
.It Fl d
-Produce output that is double spaced. An extra
+Produce output that is double spaced.
+An extra
.Em <newline>
character is output following every
.Em <newline>
If
.Ar char
(any nondigit character) is given, it is appended to the line number to
-separate it from whatever follows. The default for
+separate it from whatever follows.
+The default for
.Ar char
is a
.Em <tab> .
operands are specified, or if a
.Ar file
operand is
-.Sq Fl ,
+.Dq - ,
the standard input is used.
The standard input is used only if no
.Ar file
operands are specified, or if a
.Ar file
operand is
-.Sq Fl .
+.Dq - .
.El
.Pp
The
.Em <form-feed>s
in the input stream is that they are special
.Em <newline>s
-which have the side effect of causing a page break. While this works
+which have the side effect of causing a page break.
+While this works
correctly for all cases, strict interpretation also implies that the
common convention of placing a
.Em <form-feed>
errors when input lines are longer than actual line width of the output device.
.Pp
The default width of 72 is archaic and non-obvious since it is normally
-ignored in the default single column mode. Using the
+ignored in the default single column mode.
+Using the
.Fl m
option with one column provides a way to truncate single column output but
there's no way to wrap long times to a fixed line width.
-.\" $OpenBSD: printenv.1,v 1.3 1998/09/27 16:57:50 aaron Exp $
+.\" $OpenBSD: printenv.1,v 1.4 2000/03/10 20:17:49 aaron Exp $
+.\"
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.Sh DESCRIPTION
.Nm printenv
prints out the names and values of the variables in the environment,
-with one name/value pair per line. If
+with one name/value pair per line.
+If
.Ar name
is specified, only
its value is printed.
-.\" $OpenBSD: printf.1,v 1.9 2000/03/06 03:15:59 aaron Exp $
+.\" $OpenBSD: printf.1,v 1.10 2000/03/10 20:17:49 aaron Exp $
+.\"
.\" Copyright (c) 1989, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.Nm printf
formats and prints its arguments, after the first, under control
of the
-.Ar format .
+.Ar format .
The
.Ar format
is a character string which contains three types of objects: plain characters,
which are simply copied to standard output, character escape sequences which
are converted and copied to the standard output, and format specifications,
each of which causes printing of the next successive
-.Ar argument .
+.Ar argument .
.Pp
The
.Ar arguments
or
.Cm s ;
otherwise it is evaluated as a C constant, with the following extensions:
-.Pp
-.Bl -bullet -offset indent -compact
+.Bl -bullet -offset indent
.It
A leading plus or minus sign is allowed.
.It
.El
.Pp
The format string is reused as often as necessary to satisfy the
-.Ar arguments .
+.Ar arguments .
Any extra format specifications are evaluated with zero or the null
string.
.Pp
Character escape sequences are in backslash notation as defined in
.St -ansiC .
-The characters and their meanings
-are as follows:
-.Bl -tag -width Ds -offset indent
+The characters and their meanings are as follows:
+.Pp
+.Bl -tag -width Ds -offset indent -compact
.It Cm \ee
Write an <escape> character.
.It Cm \ea
Each format specification is introduced by the percent
.Pq Sq \&%
character.
-The remainder of the format specification includes,
+The remainder of the format specifiers include,
in the following order:
.Bl -tag -width Ds
.It "Zero or more of the following flags:"
Specifies that the value should be printed in an
.Dq alternate form .
For the
-.Cm c ,
+.Cm c ,
.Cm d ,
and
.Cm s
-formats, this option has no effect. For the
+formats, this option has no effect.
+For the
.Cm o
format the precision of the number is increased to force the first
-character of the output string to a zero. For the
+character of the output string to a zero.
+For the
.Cm x
.Pq Cm X
format, a non-zero result has the string
.Li 0x
.Pq Li 0X
-prepended to it. For
-.Cm e ,
+prepended to it.
+For
+.Cm e ,
.Cm E ,
-.Cm f ,
+.Cm f ,
.Cm g ,
and
.Cm G
formats, the result will always contain a decimal point, even if no
digits follow the point (normally, a decimal point only appears in the
-results of those formats if a digit follows the decimal point). For
+results of those formats if a digit follows the decimal point).
+For
.Cm g
and
.Cm G
a sign placed before the number when using signed formats.
.It Sq \&\ \&
A space specifies that a blank should be left before a positive number
-for a signed format. A
-.Dq +
+for a signed format.
+A
+.Ql +
overrides a space if both are used.
.It Cm \&0
A zero character specifies that zero-padding should be used
-rather than blank-padding. This flag is ignored if used with a precision
+rather than blank-padding.
+This flag is ignored if used with a precision
specifier and any of the
.Cm d , i , o , u ,
or
.Cm x
.Pq Cm X
-formats. A
-.Dq \&-
+formats.
+A
+.Ql \&-
overrides a
-.Dq \&0
+.Ql \&0
if both are used.
.El
.It "Field Width:"
.El
.Pp
A field width or precision may be
-.Dq \&*
+.Ql \&*
instead of a digit string.
In this case an
.Ar argument
the precision specification for the argument; when the precision is
missing, 6 digits are produced.
An upper-case
-.Dq E
+.Sq E
is used for an
.Cm E
format.
precision is 0 or missing, all characters in the string are printed.
.It Cm \&%
Print a
-.Dq \&% ;
+.Ql \&% ;
no argument is used.
.El
.Pp
-.\" $OpenBSD: quota.1,v 1.9 2000/03/06 03:17:39 aaron Exp $
+.\" $OpenBSD: quota.1,v 1.10 2000/03/10 20:17:49 aaron Exp $
+.\"
.\" Copyright (c) 1983, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
-.\" $OpenBSD: ranlib.1,v 1.5 1999/08/27 08:43:22 fgsch Exp $
+.\" $OpenBSD: ranlib.1,v 1.6 2000/03/10 20:17:50 aaron Exp $
+.\"
.\" Copyright (c) 1990 Regents of the University of California.
.\" All rights reserved.
.\"
creates a table of external references for archive libraries,
normally used by the loader,
.Xr ld 1 .
-This table is named ``__.SYMDEF'' and is prepended to the archive.
+This table is named
+.Dq __.SYMDEF
+and is prepended to the archive.
Files in the archive which are not executable and symbols which are
uninteresting to the loader are ignored.
.Pp
The options are as follows:
.Bl -tag -width indent
.It Fl t
-Set the modification time of the __.SYMDEF file.
+Set the modification time of the
+.Pa __.SYMDEF
+file.
This time is compared by the loader with the modification time of the
archive to verify that the table is up-to-date with respect to the
archive.
.Xr cp 1 ) ,
the
.Fl t
-option can be used to ``touch'' the modification time so that it
+option can be used to
+.Dq touch
+the modification time so that it
appears that the table is up-to-date.
This is also useful after using the
.Fl t
.Xr make 1 .
.El
.Sh ENVIRONMENT
-.Bl -tag -width TMPDIR -compact
+The following environment variables affect the execution of
+.Nm ranlib :
+.Bl -tag -width TMPDIR
.It Ev TMPDIR
The pathname of the directory to use when creating temporary files.
.El
-.\" $OpenBSD: ranlib.5,v 1.3 1998/09/27 16:57:50 aaron Exp $
+.\" $OpenBSD: ranlib.5,v 1.4 2000/03/10 20:17:50 aaron Exp $
+.\"
.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
function
prepends a new file to the archive which has three separate parts.
The first part is a standard archive header, which has a special name
-field, "__.SYMDEF".
+field,
+.Dq __.SYMDEF .
.Pp
-The second part is a ``long'' followed by a list of ranlib structures.
+The second part is a
+.Li long
+followed by a list of ranlib structures.
The long is the size, in bytes, of the list of ranlib structures.
Each of the ranlib structures consists of a zero based offset into the
next section (a string table of symbols) and an offset from the beginning
The actual number of ranlib structures is this number divided by the size
of an individual ranlib structure.
.Pp
-The third part is a ``long'' followed by a string table.
+The third part is a
+.Li long
+followed by a string table.
The long is the size, in bytes of the string table.
.Sh SEE ALSO
.Xr ar 1 ,
-.\" $OpenBSD: readlink.1,v 1.5 2000/03/05 00:28:53 aaron Exp $
+.\" $OpenBSD: readlink.1,v 1.6 2000/03/10 20:17:50 aaron Exp $
.\"
.\" Copyright (c) 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.Ar file
.Sh DESCRIPTION
The
-.Nm readlink
+.Nm
utility when invoked with the pathname of a symbolic link as its
argument dereferences the symbolic link and prints the name of target
-on standard output. If readlink is invoked with an argument other
-than the pathname of a symbolic link, it exits with a non-zero exit
+on standard output.
+If readlink is invoked with an argument other
+than the pathname of a symbolic link, it exits with a nonzero exit
code without printing anything.
.Pp
The options are as follows:
.El
.Pp
The
-.Nm readlink
+.Nm
utility exits 0 on success or >0 if an error occurred.
.Sh SEE ALSO
.Xr readlink 2
.Sh HISTORY
The
-.Nm readlink
+.Nm
utility first appeared in
.Ox 2.1 .
-.\" $OpenBSD: renice.8,v 1.9 2000/03/04 20:02:23 aaron Exp $
+.\" $OpenBSD: renice.8,v 1.10 2000/03/10 20:17:50 aaron Exp $
+.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.Pp
Users other than the super-user may only alter the priority of
processes they own,
-and can only monotonically increase their ``nice value''
+and can only monotonically increase their
+.Dq nice value
within the range 0 to
.Dv PRIO_MAX
(20).
Useful priorities are:
20 (the affected processes will run only when nothing else
in the system wants to),
-0 (the ``base'' scheduling priority),
+0 (the
+.Dq base
+scheduling priority),
anything negative (to make things go very fast).
.Sh FILES
.Bl -tag -width /etc/passwd -compact
-.\" $OpenBSD: rlogin.1,v 1.5 1999/06/05 01:21:38 aaron Exp $
+.\" $OpenBSD: rlogin.1,v 1.6 2000/03/10 20:17:50 aaron Exp $
.\" $NetBSD: rlogin.1,v 1.4 1995/08/18 15:07:35 pk Exp $
.\"
.\" Copyright (c) 1983, 1990, 1993
.Op Fl l Ar username
.Ar host
.Sh DESCRIPTION
-.Nm rlogin
+.Nm
starts a terminal session on a remote host
-.Ar host .
+.Ar host .
.Pp
-.Nm rlogin
+.Nm
first attempts to use the Kerberos authorization mechanism, described below.
If the remote host does not support Kerberos the standard Berkeley
.Pa rhosts
authorization mechanism is used.
+.Pp
The options are as follows:
.Bl -tag -width flag
.It Fl 8
.It Fl L
The
.Fl L
-option allows the rlogin session to be run in ``litout'' (see
+option allows the rlogin session to be run in
+.Dq litout
+(see
.Xr tty 4 )
mode.
.It Fl d
The
.Fl e
option allows user specification of the escape character, which is
-``~'' by default.
+.Ql ~
+by default.
This specification may be as a literal character, or as an octal
value in the form \ennn.
.It Fl k Ar realm
in realm
.Ar realm
instead of the remote host's realm as determined by
-.Xr krb_realmofhost 3 .
+.Xr krb_realmofhost 3 .
.It Fl x
The
.Fl x
If this option is not specified, your local username will be used.
.El
.Pp
-A line of the form ``<escape char>.'' disconnects from the remote host.
-Similarly, the line ``<escape char>^Z'' will suspend the
-.Nm rlogin
-session, and ``<escape char><delayed-suspend char>'' suspends the
+A line of the form
+.Dq <escape char>.
+disconnects from the remote host.
+Similarly, the line
+.Dq <escape char>^Z
+will suspend the
+.Nm
+session, and
+.Dq <escape char><delayed-suspend char>
+suspends the
send portion of the rlogin, but allows output from the remote system.
-By default, the tilde (``~'') character is the escape character, and
-normally control-Y (``^Y'') is the delayed-suspend character.
+By default, the tilde
+.Pq Ql ~
+character is the escape character, and
+normally control-Y
+.Pq Ql ^Y
+is the delayed-suspend character.
.Pp
All echoing takes place at the remote site, so that (except for delays)
the
-.Nm rlogin
+.Nm
is transparent.
Flow control via ^S/^Q and flushing of input and output on interrupts
are handled properly.
in their home directory.
Each line in this file should contain a Kerberos principal name of the
form
-.Ar principal.instance@realm .
+.Ar principal.instance@realm .
If the originating user is authenticated to one of the principals named
in
.Pa .klogin ,
file.
Otherwise a login and password will be prompted for on the remote machine
as in
-.Xr login 1 .
+.Xr login 1 .
To avoid certain security problems, the
.Pa .klogin
file must be owned by
.Pp
If Kerberos authentication fails, a warning message is printed and the
standard Berkeley
-.Nm rlogin
+.Nm
is used instead.
.Sh ENVIRONMENT
-The following environment variable is utilized by
+The following environment variables affect the execution of
.Nm rlogin :
.Bl -tag -width TERM
.It Ev TERM
.Sh BUGS
.Nm rlogin
will be replaced by
-.Xr telnet 1
+.Xr telnet 1
in the near future.
.Pp
More of the environment should be propagated.
-.\" $OpenBSD: rpcgen.1,v 1.5 1999/07/07 10:50:07 aaron Exp $
+.\" $OpenBSD: rpcgen.1,v 1.6 2000/03/10 20:17:50 aaron Exp $
.\" $NetBSD: rpcgen.1,v 1.5.2.1 1995/12/05 02:51:02 jtc Exp $
.\" from: @(#)rpcgen.new.1 1.1 90/11/09 TIRPC 1.0; from 40.10 of 10/10/89
.\" Copyright (c) 1988,1990 Sun Microsystems, Inc. - All Rights Reserved.
.Op Fl o Ar outfile
.Op Ar infile
.Sh DESCRIPTION
-.Nm rpcgen
+.Nm
is a tool that generates C code to implement an
.Tn RPC
protocol.
-The input to
-.Nm
-is a language similar to C known as
+The input is a language similar to C known as
.Tn RPC
Language (Remote Procedure Call Language).
-.Nm rpcgen
+.Nm
is normally used as in the first synopsis where
it takes an input file and generates up to four output files.
If the
is named
.Pa proto.x ,
then
-.Nm rpcgen
+.Nm
will generate a header file in
.Pa proto.h ,
.Tn XDR
.Fl S\&c
option,
it will also generate sample code which would illustrate how to use the
-remote procedures on the client side. This code would be created in
+remote procedures on the client side.
+This code would be created in
.Pa proto_client.c .
With the
.Fl S\&s
option,
it will also generate a sample server code which would illustrate how to write
-the remote procedures. This code would be created in
+the remote procedures.
+This code would be created in
.Pa proto_server.c .
.Pp
The server created can be started both by the port monitors
by setting up the environment variable
.Ev PM_TRANSPORT .
When the server generated by
-.Nm rpcgen
+.Nm
is executed,
it creates server handles for all the transports
specified in
one does not want to generate all the output files,
but only a particular one.
Some examples of their usage is described in the
-EXAMPLE
+.Sx EXAMPLES
section below.
When
-.Nm rpcgen
+.Nm
is executed with the
.Fl s
option,
If
.Ar infile
is not specified,
-.Nm rpcgen
+.Nm
accepts the standard input.
.Pp
The C preprocessor,
is run on the input file before it is actually interpreted by
.Nm rpcgen .
For each type of output file,
-.Nm rpcgen
+.Nm
defines a special preprocessor symbol for use by the
-.Nm rpcgen
+.Nm
programmer:
.Pp
.Bl -tag -width RPC_CLNT -compact
.Pp
For every data type referred to in
.Ar infile
-.Nm rpcgen
+.Nm
assumes that there exists a
routine with the string
.Dq xdr_
allows customization of
.Tn XDR
routines.
-.Sh OPTIONS
+.Pp
+The options are as follows:
.Bl -tag -width indent
.It Fl a
Generate all the files including sample code for client and server side.
.It Fl b
This generates code for the
.Tn SunOS4.1
-style of RPC. This is the default.
+style of RPC.
+This is the default.
.It Fl c
Compile into
.Tn XDR
routines.
.It Fl C
-Generate code in ANSI C. This option also generates code that could be
+Generate code in ANSI C.
+This option also generates code that could be
compiled with the C++ compiler.
.It Fl D Ar name Ns Op Ar =value
Define a symbol
dispatch tables.
.It Fl K Ar secs
By default, services created using
-.Nm rpcgen
+.Nm
wait 120 seconds
after servicing a request before exiting.
That interval can be changed using the
If it is known that a server will be used with such a monitor, the
server should exit immediately on completion.
For such servers,
-.Nm rpcgen
+.Nm
should be used with
.Dq Fl K No -1 .
.It Fl l
Use the newstyle of
.Nm rpcgen .
This allows procedures to have multiple arguments.
-It also uses the style of parameter passing that closely resembles C. So, when
+It also uses the style of parameter passing that closely resembles C.
+So, when
passing an argument to a remote procedure you do not have to pass a pointer to
-the argument but the argument itself. This behaviour is different from the oldstyle
+the argument but the argument itself.
+This behaviour is different from the oldstyle
of
-.Nm rpcgen
-generated code. The newstyle is not the default case because of
+.Nm
+generated code.
+The newstyle is not the default case because of
backward compatibility.
.It Fl o Ar outfile
Specify the name of the output file.
.Em udp
[see
.Xr rpc 3
-for the meanings associated with these classes. Note:
+for the meanings associated with these classes.
+Note:
.Bx
currently supports only the
.Em tcp
to the server before calling the client side stubs generated by
.Nm rpcgen .
.It Fl S\&s
-Generate skeleton code for the remote procedures on the server side. You would need
+Generate skeleton code for the remote procedures on the server side.
+You would need
to fill in the actual code for the remote procedures.
.It Fl t
Compile into
option refers to the transport indicated by
.Em netid
and hence is very site specific.
-.Sh EXAMPLE
+.Sh EXAMPLES
The command
.Pp
.Bd -literal -offset indent
-.\" $OpenBSD: rpcinfo.8,v 1.4 1999/06/05 01:21:38 aaron Exp $
+.\" $OpenBSD: rpcinfo.8,v 1.5 2000/03/10 20:17:50 aaron Exp $
.\" from: @(#)rpcinfo.8c 2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI
.\"
.Dd December 17, 1987
.Fl d
.Ar program version
.Sh DESCRIPTION
-.Nm rpcinfo
+.Nm
makes an
.Tn RPC
call to an
.Tn RPC
server and reports what it finds.
-.Sh OPTIONS
+.Pp
+The options are as follows:
.Bl -tag -width indent
.It Fl p
Probe the portmapper on
.Ar host ,
and print a list of all registered
.Tn RPC
-programs. If
+programs.
+If
.Ar host
is not specified, it defaults to the value returned by
.Xr hostname 1 .
If a
.Ar version
is specified,
-.Nm rpcinfo
+.Nm
attempts to call that version of the specified
.Ar program .
Otherwise,
-.Nm rpcinfo
+.Nm
attempts to find all the registered version
numbers for the specified
.Ar program
by calling version 0 (which is presumed not
to exist; if it does exist,
-.Nm rpcinfo
+.Nm
attempts to obtain this information by calling
an extremely high version
number instead) and attempts to call each registered version.
.Sh BUGS
In releases prior to SunOS 3.0, the Network File System (NFS) did not
register itself with the portmapper;
-.Nm rpcinfo
+.Nm
cannot be used to make
.Tn RPC
calls to the
-.\" $OpenBSD: rsh.1,v 1.5 1999/06/05 01:21:38 aaron Exp $
+.\" $OpenBSD: rsh.1,v 1.6 2000/03/10 20:17:51 aaron Exp $
+.\"
.\" Copyright (c) 1983, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.Ar host
.Op Ar command
.Sh DESCRIPTION
-.Nm rsh
+.Nm
executes
.Ar command
on
-.Ar host .
+.Ar host .
.Pp
-.Nm rsh
+.Nm
copies its standard input to the remote command, the standard
output of the remote command to its standard output, and the
standard error of the remote command to its standard error.
Interrupt, quit and terminate signals are propagated to the remote
command;
-.Nm rsh
+.Nm
normally terminates when the remote command does.
+.Pp
The options are as follows:
.Bl -tag -width flag
.It Fl K
The
.Fl d
option turns on socket debugging (using
-.Xr setsockopt 2 )
+.Xr setsockopt 2 )
on the
.Tn TCP
sockets used for communication with the remote host.
The
.Fl k
option causes
-.Nm rsh
+.Nm
to obtain tickets for the remote host in
.Ar realm
instead of the remote host's realm as determined by
-.Xr krb_realmofhost 3 .
+.Xr krb_realmofhost 3 .
.It Fl l
By default, the remote username is the same as the local username.
The
option allows the remote name to be specified.
Kerberos authentication is used, and authorization is determined
as in
-.Xr rlogin 1 .
+.Xr rlogin 1 .
.It Fl n
The
.Fl n
If no
.Ar command
is specified, you will be logged in on the remote host using
-.Xr rlogin 1 .
+.Xr rlogin 1 .
.Pp
Shell meta-characters which are not quoted are interpreted on local machine,
while quoted meta-characters are interpreted on the remote machine.
.Xr rcmd 3
.Sh HISTORY
The
-.Nm rsh
+.Nm
command appeared in
.Bx 4.2 .
.Sh BUGS
If you are using
-.Xr csh 1
+.Xr csh 1
and put a
-.Nm rsh
+.Nm
in the background without redirecting its input away from the terminal,
it will block even if no reads are posted by the remote command.
If no input is desired you should redirect the input of
-.Nm rsh
+.Nm
to
.Pa /dev/null
using the
.Pp
You cannot run an interactive command
(like
-.Xr rogue 6
+.Xr rogue 6
or
-.Xr vi 1 )
+.Xr vi 1 )
using
-.Nm rsh ;
+.Nm rsh ;
use
-.Xr rlogin 1
+.Xr rlogin 1
instead.
.Pp
Stop signals stop the local
-.Nm rsh
+.Nm
process only; this is arguably wrong, but currently hard to fix for reasons
too complicated to explain here.
-.\" $OpenBSD: rup.1,v 1.5 2000/03/05 00:28:54 aaron Exp $
-.\" -*- nroff -*-
+.\" $OpenBSD: rup.1,v 1.6 2000/03/10 20:17:51 aaron Exp $
.\"
.\" Copyright (c) 1985, 1991 The Regents of the University of California.
.\" All rights reserved.
work.
.Nm
uses an RPC protocol defined in /usr/include/rpcsvc/rstat.x.
-.Sh EXAMPLE
+.Sh EXAMPLES
.Bd -unfilled -offset indent -compact
example% rup otherhost
otherhost up 6 days, 16:45, load average: 0.20, 0.23, 0.18
.Xr rpc.rstatd 8
daemon has not been started on the remote host.
.It rup: RPC: Timed out
-A communication error occurred. Either the network is
-excessively congested, or the
+A communication error occurred.
+Either the network is excessively congested, or the
.Xr rpc.rstatd 8
daemon has terminated on the remote host.
.It rup: RPC: Port mapper failure - RPC: Timed out
The remote host is not running the portmapper (see
.Xr portmap 8 ),
-and cannot accommodate any RPC-based services. The host may be down.
+and cannot accommodate any RPC-based services.
+The host may be down.
.El
.Sh SEE ALSO
.Xr ruptime 1 ,
-.\" $OpenBSD: ruptime.1,v 1.7 2000/03/06 03:17:39 aaron Exp $
+.\" $OpenBSD: ruptime.1,v 1.8 2000/03/10 20:17:51 aaron Exp $
+.\"
.\" Copyright (c) 1983, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.Nm ruptime
.Op Fl alrtu
.Sh DESCRIPTION
-.Nm ruptime
+.Nm
gives a status line like
-.Ar uptime
+.Xr uptime 1
for each machine on the local network; these are formed from packets
broadcast by each host on the network once a minute.
.Pp
.Xr rwhod 8
.Sh HISTORY
The
-.Nm ruptime
+.Nm
command appeared in
.Bx 4.2 .
-.\" $OpenBSD: rusers.1,v 1.5 2000/03/05 00:28:54 aaron Exp $
+.\" $OpenBSD: rusers.1,v 1.6 2000/03/10 20:17:51 aaron Exp $
+.\"
.\" Copyright (c) 1983, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.Op Ar host ...
.Sh DESCRIPTION
The
-.Nm rusers
+.Nm
command produces output similar to
.Xr who 1 ,
but for the list of hosts or all machines on the local
network. For each host responding to the rusers query,
the hostname with the names of the users currently logged
on is printed on each line. The
-.Nm rusers
+.Nm
command will wait for
one minute to catch late responders.
.Pp
.Xr rpc.rusersd 8
daemon has not been started on the remote host.
.It rusers: RPC: Timed out
-A communication error occurred. Either the network is
-excessively congested, or the
+A communication error occurred.
+Either the network is excessively congested, or the
.Xr rpc.rusersd 8
daemon has terminated on the remote host.
.It rusers: RPC: Port mapper failure - RPC: Timed out
The remote host is not running the portmapper (see
.Xr portmap 8 ),
-and cannot accommodate any RPC-based services. The host may be down.
+and cannot accommodate any RPC-based services.
+The host may be down.
.El
.Sh SEE ALSO
.Xr rwho 1 ,
.Xr rpc.rusersd 8
.Sh HISTORY
The
-.Nm rusers
+.Nm
command
appeared in
.Tn SunOS .
-.\" $OpenBSD: rwall.1,v 1.3 1999/06/05 01:21:39 aaron Exp $
+.\" $OpenBSD: rwall.1,v 1.4 2000/03/10 20:17:51 aaron Exp $
+.\"
.\" Copyright (c) 1983, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.Op Ar file
.Sh DESCRIPTION
The
-.Nm rwall
+.Nm
command sends a message to the users logged into the specified host. The
message to be sent can be typed in and terminated with EOF or it can
be in a
.Xr rpc.rwalld 8
daemon has not been started on the remote host.
.It rwall: RPC: Timed out
-A communication error occurred. Either the network is
-excessively congested, or the
+A communication error occurred.
+Either the network is excessively congested, or the
.Xr rpc.rwalld 8
daemon has terminated on the remote host.
.It rwall: RPC: Port mapper failure - RPC: Timed out
The remote host is not running the portmapper (see
.Xr portmap 8 ),
-and cannot accommodate any RPC-based services. The host may be down.
+and cannot accommodate any RPC-based services.
+The host may be down.
.El
.Sh SEE ALSO
.Xr wall 1 ,
.Xr rpc.rwalld 8
.Sh HISTORY
The
-.Nm rwall
+.Nm
command
appeared in
.Tn SunOS .
-.\" $OpenBSD: rwho.1,v 1.4 1999/06/05 01:21:39 aaron Exp $
+.\" $OpenBSD: rwho.1,v 1.5 2000/03/10 20:17:51 aaron Exp $
+.\"
.\" Copyright (c) 1983, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.Op Fl a
.Sh DESCRIPTION
The
-.Nm rwho
+.Nm
command produces output similar to
.Xr who 1 ,
but for all machines on the local network.
If no report has been
received from a machine for 11 minutes then
-.Nm rwho
+.Nm
assumes the machine is down, and does not report users last known
to be logged into that machine.
.Pp
If a user hasn't typed to the system for a minute or more, then
-.Nm rwho
-reports this idle time. If a user hasn't typed to the system for
-an hour or more, then
-the user will be omitted from the output of
-.Nm rwho
+.Nm
+reports this idle time.
+If a user hasn't typed to the system for an hour or more,
+then the user will be omitted from the output of
+.Nm
unless the
.Fl a
flag is given.
.Xr rwhod 8
.Sh HISTORY
The
-.Nm rwho
+.Nm
command
appeared in
.Bx 4.3 .
-.\" $OpenBSD: script.1,v 1.5 2000/03/06 13:12:49 aaron Exp $
+.\" $OpenBSD: script.1,v 1.6 2000/03/10 20:17:51 aaron Exp $
.\" $NetBSD: script.1,v 1.3 1994/12/21 08:55:41 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
saves all dialogue in
.Ar file .
If no file name is given, the typescript is saved in the file
-.Pa typescript .
+.Pa typescript .
.Pp
The options are as follows:
.Bl -tag -width Ds
-.\" $OpenBSD: sed.1,v 1.11 2000/03/06 03:17:39 aaron Exp $
+.\" $OpenBSD: sed.1,v 1.12 2000/03/10 20:17:52 aaron Exp $
+.\"
.\" Copyright (c) 1992, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
-.\" $OpenBSD: shar.1,v 1.5 2000/03/06 03:17:39 aaron Exp $
+.\" $OpenBSD: shar.1,v 1.6 2000/03/10 20:17:52 aaron Exp $
.\" $NetBSD: shar.1,v 1.4 1995/08/18 14:55:40 pk Exp $
.\"
.\" Copyright (c) 1990, 1993
.Pp
.Nm shar
is normally used for distributing files by
-.Xr ftp 1
+.Xr ftp 1
or
-.Xr mail 1 .
+.Xr mail 1 .
.Sh EXAMPLES
To create a shell archive of the program
-.Xr ls 1
+.Xr ls 1
and mail it to Rick:
.Bd -literal -offset indent
cd ls
files.
It is strongly recommended that all shell archive files be examined
before running them through
-.Xr sh 1 .
+.Xr sh 1 .
Archives produced using this implementation of
.Nm shar
may be easily examined with the command:
-.\" $OpenBSD: showmount.8,v 1.7 2000/03/06 03:17:39 aaron Exp $
+.\" $OpenBSD: showmount.8,v 1.8 2000/03/10 20:17:52 aaron Exp $
.\" $NetBSD: showmount.8,v 1.5 1995/08/31 22:26:07 jtc Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.Op Fl ade3
.Op Ar host
.Sh DESCRIPTION
-.Nm showmount
+.Nm
shows status information about the
.Tn NFS
server on
.Xr mountd 8
.Sh HISTORY
The
-.Nm showmount
+.Nm
utility first appeared in
.Bx 4.4 .
.Sh BUGS
since the
.Tn NFS
server is stateless.
-.Nm showmount
+.Nm
will only display the information
as accurately as the mount daemon reports it.
-.\" $OpenBSD: size.1,v 1.6 1999/06/05 01:21:40 aaron Exp $
+.\" $OpenBSD: size.1,v 1.7 2000/03/10 20:17:52 aaron Exp $
.\" $NetBSD: size.1,v 1.6 1996/01/14 23:07:11 pk Exp $
.\"
.\" Copyright (c) 1990, 1993, 1994
.Nm
attempts to report on the file
.Pa a.out .
+.Pp
+The options are as follows:
.Bl -tag -width flag
.It Fl t
At the end of the output print a total of the
-.\" $OpenBSD: skey.1,v 1.18 1999/08/17 16:34:51 millert Exp $
+.\" $OpenBSD: skey.1,v 1.19 2000/03/10 20:17:52 aaron Exp $
.\" @(#)skey.1 1.1 10/28/93
.\"
.Dd October 28, 1993
You can enter the passwords using small letters, even though
.Nm skey
prints them capitalized.
-.Sh OPTIONS
+.Pp
+The options are as follows:
.Bl -tag -width XXXXXXX
.It Fl n Ar count
Prints out
.Ar count
-one-time passwords. The default is to print one.
+one-time passwords.
+The default is to print one.
.It Fl p Ar password
Uses
.Ar password
-as the secret password. Use of this option is discouraged as
+as the secret password.
+Use of this option is discouraged as
your secret password could be visible in a process listing.
.It Fl x
Causes output to be in hexadecimal instead of ASCII.
.It Fl rmd160
Selects RMD-160 (160 bit Ripe Message Digest) as the hash algorithm.
.El
-.Sh EXAMPLE
+.Sh EXAMPLES
.sp 0
% skey 99 th91334
.sp 0
projects / openbsd / commitdiff