Use `The .Nm utility'
This commit is contained in:
Philippe Charnier
parent
1c2451c24d
commit
e8937ba009
@ -50,8 +50,9 @@
|
||||
.Sm on
|
||||
.Oc
|
||||
.Sh DESCRIPTION
|
||||
.Nm Calendar
|
||||
checks the current directory for a file named
|
||||
The
|
||||
.Nm
|
||||
utility checks the current directory for a file named
|
||||
.Pa calendar
|
||||
and displays lines that begin with either today's date
|
||||
or tomorrow's.
|
||||
@ -231,5 +232,6 @@ A
|
||||
command appeared in
|
||||
.At v7 .
|
||||
.Sh BUGS
|
||||
.Nm Calendar
|
||||
doesn't handle Jewish holidays and moon phases.
|
||||
The
|
||||
.Nm
|
||||
utility doesn't handle Jewish holidays and moon phases.
|
||||
|
||||
@ -37,8 +37,9 @@
|
||||
.Op Fl o Ar out_file
|
||||
.Op Ar filename
|
||||
.Sh DESCRIPTION
|
||||
.Nm Colldef
|
||||
converts a collation sequence source definition
|
||||
The
|
||||
.Nm
|
||||
utility converts a collation sequence source definition
|
||||
into a format usable by the
|
||||
.Fn strxfrm
|
||||
and
|
||||
@ -60,8 +61,9 @@ or
|
||||
transforms its arguments and does a
|
||||
comparison.
|
||||
.Pp
|
||||
.Nm Colldef
|
||||
reads the collation sequence source definition
|
||||
The
|
||||
.Nm
|
||||
utility reads the collation sequence source definition
|
||||
from the standard input and stores the converted definition in filename.
|
||||
The output file produced contains the
|
||||
database with collating sequence information in a form
|
||||
@ -240,8 +242,9 @@ is used for continuation.
|
||||
In this case, no characters are permitted
|
||||
after the backslash character.
|
||||
.Sh DIAGNOSTICS
|
||||
.Nm Colldef
|
||||
exits with the following values:
|
||||
The
|
||||
.Nm
|
||||
utility exits with the following values:
|
||||
.Bl -tag -width indent
|
||||
.It Li 0
|
||||
No errors were found and the output was successfully created.
|
||||
|
||||
@ -48,8 +48,9 @@
|
||||
.Op Ar pathname ...
|
||||
.Ar expression
|
||||
.Sh DESCRIPTION
|
||||
.Nm Find
|
||||
recursively descends the directory tree for each
|
||||
The
|
||||
.Nm
|
||||
utility recursively descends the directory tree for each
|
||||
.Ar pathname
|
||||
listed, evaluating an
|
||||
.Ar expression
|
||||
|
||||
@ -47,8 +47,9 @@
|
||||
.Op Fl u Ar user
|
||||
.Op Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Fstat
|
||||
identifies open files.
|
||||
The
|
||||
.Nm
|
||||
utility identifies open files.
|
||||
A file is considered open by a process if it was explicitly opened,
|
||||
is the working directory, root directory, active executable text, or kernel
|
||||
trace file for that process.
|
||||
|
||||
@ -43,8 +43,9 @@
|
||||
.Op options
|
||||
.Op Ar a.out Op Ar a.out.gmon ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Gprof
|
||||
produces an execution profile of C, Pascal, or Fortran77 programs.
|
||||
The
|
||||
.Nm
|
||||
utility produces an execution profile of C, Pascal, or Fortran77 programs.
|
||||
The effect of called routines is incorporated in the profile of each caller.
|
||||
The profile data is taken from the call graph profile file
|
||||
which is created by programs that are compiled with the
|
||||
@ -69,8 +70,7 @@ compiler or linker you can use
|
||||
.Fl l Ns Ar c_p
|
||||
instead of
|
||||
.Fl l Ns Ar c .
|
||||
.Nm Gprof
|
||||
reads the given object file (the default is
|
||||
Read the given object file (the default is
|
||||
.Pa a.out)
|
||||
and establishes the relation between its symbol table
|
||||
and the call graph profile.
|
||||
@ -83,8 +83,9 @@ the
|
||||
.Nm
|
||||
output shows the sum of the profile information in the given profile files.
|
||||
.Pp
|
||||
.Nm Gprof
|
||||
calculates the amount of time spent in each routine.
|
||||
The
|
||||
.Nm
|
||||
utility calculates the amount of time spent in each routine.
|
||||
Next, these times are propagated along the edges of the call graph.
|
||||
Cycles are discovered, and calls into a cycle are made to share the time
|
||||
of the cycle.
|
||||
|
||||
@ -27,8 +27,9 @@
|
||||
.Op Fl bl
|
||||
.Ar HesiodName HesiodNameType
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
takes two arguments, a name to be resolved and a string, known
|
||||
utility takes two arguments, a name to be resolved and a string, known
|
||||
as a
|
||||
.Ar HesiodNameType .
|
||||
It then prints the information returned by
|
||||
@ -39,8 +40,7 @@ The value returned by
|
||||
is of the type
|
||||
.Ar HesiodNameType .
|
||||
.Pp
|
||||
.Nm
|
||||
understands the following options:
|
||||
The following options are available:
|
||||
.Bl -tag -width indent
|
||||
.It Fl l
|
||||
Selects long format.
|
||||
|
||||
@ -81,11 +81,12 @@
|
||||
.Op Fl troff
|
||||
.Op Fl v | Fl \&nv
|
||||
.Sh DESCRIPTION
|
||||
.Nm Indent
|
||||
is a
|
||||
.Ar C
|
||||
The
|
||||
.Nm
|
||||
utility is a
|
||||
.Em C
|
||||
program formatter. It reformats the
|
||||
.Ar C
|
||||
.Em C
|
||||
program in the
|
||||
.Ar input-file
|
||||
according to the switches. The switches which can be
|
||||
@ -381,7 +382,9 @@ switches. The switches should be separated by spaces, tabs or newlines.
|
||||
.Ss Comments
|
||||
.Sq Em Box
|
||||
.Em comments .
|
||||
.Nm Indent
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
assumes that any comment with a dash or star immediately after the start of
|
||||
comment (that is, `/*\-' or `/**') is a comment surrounded by a box of stars.
|
||||
Each line of such a comment is left unchanged, except that its indentation
|
||||
@ -390,8 +393,9 @@ of the comment.
|
||||
.Pp
|
||||
.Em Straight text .
|
||||
All other comments are treated as straight text.
|
||||
.Nm Indent
|
||||
fits as many words (separated by blanks, tabs, or newlines) on a
|
||||
The
|
||||
.Nm
|
||||
utility fits as many words (separated by blanks, tabs, or newlines) on a
|
||||
line as possible. Blank lines break paragraphs.
|
||||
.Pp
|
||||
.Ss Comment indentation
|
||||
@ -421,8 +425,9 @@ attempts to correctly
|
||||
compensate for the syntactic peculiarities introduced.
|
||||
.Pp
|
||||
.Ss C syntax
|
||||
.Nm Indent
|
||||
understands a substantial amount about the syntax of C, but it
|
||||
The
|
||||
.Nm
|
||||
utility understands a substantial amount about the syntax of C, but it
|
||||
has a `forgiving' parser. It attempts to cope with the usual sorts of
|
||||
incomplete and misformed syntax. In particular, the use of macros like:
|
||||
.Pp
|
||||
@ -430,8 +435,9 @@ incomplete and misformed syntax. In particular, the use of macros like:
|
||||
.Pp
|
||||
is handled properly.
|
||||
.Sh ENVIRONMENT
|
||||
.Nm Indent
|
||||
uses the
|
||||
The
|
||||
.Nm
|
||||
utility uses the
|
||||
.Ev HOME
|
||||
environment variable.
|
||||
.Sh FILES
|
||||
@ -447,8 +453,9 @@ The
|
||||
command appeared in
|
||||
.Bx 4.2 .
|
||||
.Sh BUGS
|
||||
.Nm Indent
|
||||
has even more switches than
|
||||
The
|
||||
.Nm
|
||||
utility has even more switches than
|
||||
.Xr ls 1 .
|
||||
.Pp
|
||||
A common mistake that often causes grief is typing:
|
||||
@ -456,5 +463,6 @@ A common mistake that often causes grief is typing:
|
||||
.Dl indent *.c
|
||||
.Pp
|
||||
to the shell in an attempt to indent all the
|
||||
C programs in a directory.
|
||||
.Em C
|
||||
programs in a directory.
|
||||
This is probably a bug, not a feature.
|
||||
|
||||
@ -39,8 +39,9 @@
|
||||
.Op Fl S Ar semkey
|
||||
.Ar ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Ipcrm
|
||||
removes the specified message queues, semaphores and shared memory
|
||||
The
|
||||
.Nm
|
||||
utility removes the specified message queues, semaphores and shared memory
|
||||
segments. These System V IPC objects can be specified by their
|
||||
creation id or any associated key.
|
||||
.Pp
|
||||
|
||||
@ -43,7 +43,7 @@
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
program provides information on System V interprocess communication
|
||||
utility provides information on System V interprocess communication
|
||||
(IPC) facilities on the system.
|
||||
.Pp
|
||||
The options are as follows:
|
||||
|
||||
@ -47,8 +47,9 @@
|
||||
.Op Fl p Ar precision
|
||||
.Op reps Op begin Op end Op s
|
||||
.Sh DESCRIPTION
|
||||
.Nm Jot
|
||||
is used to print out increasing, decreasing, random,
|
||||
The
|
||||
.Nm
|
||||
utility is used to print out increasing, decreasing, random,
|
||||
or redundant data, usually numbers, one per line.
|
||||
.Pp
|
||||
The following options are available:
|
||||
|
||||
@ -11,8 +11,9 @@
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Sh DESCRIPTION
|
||||
.Nm Keylogin
|
||||
prompts the user for their login password, and uses it to decrypt
|
||||
The
|
||||
.Nm
|
||||
utility prompts the user for their login password, and uses it to decrypt
|
||||
the user's secret key stored in the
|
||||
.Xr publickey 5
|
||||
database.
|
||||
|
||||
@ -10,8 +10,9 @@
|
||||
.Nm
|
||||
.Op Fl f
|
||||
.Sh DESCRIPTION
|
||||
.Nm Keylogout
|
||||
deletes the key stored by the key server process
|
||||
The
|
||||
.Nm
|
||||
utility deletes the key stored by the key server process
|
||||
.Xr keyserv 8
|
||||
to be used by any secure network services, such as NFS.
|
||||
Further access to the key is revoked,
|
||||
@ -25,7 +26,8 @@ Also since only one copy is kept on a machine of the key,
|
||||
it is a bad idea to place this in your
|
||||
.Pa .logout
|
||||
file since it will affect other sessions on the same machine.
|
||||
.Sh OPTIONS
|
||||
.Pp
|
||||
The following option is available:
|
||||
.Bl -tag -width indent
|
||||
.It Fl f
|
||||
Forget the rootkey.
|
||||
|
||||
@ -45,8 +45,9 @@
|
||||
.Op Fl SIGNAL
|
||||
.Op Ar procname ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Killall
|
||||
kills processes selected by name, as opposed to the selection by pid
|
||||
The
|
||||
.Nm
|
||||
utility kills processes selected by name, as opposed to the selection by pid
|
||||
as done by
|
||||
.Xr kill 1 .
|
||||
By default, it will send a
|
||||
@ -111,7 +112,7 @@ if there are zombie processes that match the specified pattern.
|
||||
.El
|
||||
.Sh ALL PROCESSES
|
||||
Sending a signal to all processes with uid
|
||||
.Nm XYZ
|
||||
.Em XYZ
|
||||
is already supported by
|
||||
.Xr kill 1 .
|
||||
So use
|
||||
|
||||
@ -52,7 +52,7 @@
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
command enables kernel trace logging for the specified processes.
|
||||
utility enables kernel trace logging for the specified processes.
|
||||
Kernel trace data is logged to the file
|
||||
.Pa ktrace.out .
|
||||
The kernel operations that are traced include system calls, namei
|
||||
|
||||
@ -50,8 +50,9 @@
|
||||
.Op Fl t Ar c
|
||||
.Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Lam
|
||||
copies the named files side by side onto the standard output.
|
||||
The
|
||||
.Nm
|
||||
utility copies the named files side by side onto the standard output.
|
||||
The
|
||||
.Em n-th
|
||||
input lines from the input
|
||||
@ -66,7 +67,7 @@ Normally, each option affects only the
|
||||
after it.
|
||||
If the option letter is capitalized it affects all subsequent files
|
||||
until it appears again uncapitalized.
|
||||
The options are described below.
|
||||
The options are described below:
|
||||
.Bl -tag -width indent
|
||||
.It Fl f Ar min . Ns Ar max
|
||||
Print line fragments according to the format string
|
||||
|
||||
@ -58,8 +58,9 @@
|
||||
.Op Fl w
|
||||
.Op Ar user ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Last
|
||||
will either list the sessions of specified
|
||||
The
|
||||
.Nm
|
||||
utility will either list the sessions of specified
|
||||
.Ar users ,
|
||||
.Ar ttys ,
|
||||
and
|
||||
@ -75,6 +76,7 @@ a crash or shutdown,
|
||||
.Nm
|
||||
will so indicate.
|
||||
.Pp
|
||||
The following options are available:
|
||||
.Bl -tag -width indent-two
|
||||
.It Fl Ar n
|
||||
Limits the report to
|
||||
@ -140,8 +142,7 @@ If the
|
||||
.Ar SS
|
||||
letter pair is not specified, the value defaults to 0.
|
||||
.It Fl f Ar file
|
||||
.Nm Last
|
||||
reads the file
|
||||
Read the file
|
||||
.Ar file
|
||||
instead of the default,
|
||||
.Pa /var/log/wtmp .
|
||||
@ -210,6 +211,7 @@ In this case,
|
||||
.Nm
|
||||
will indicate the logout time as "shutdown".
|
||||
.Sh HISTORY
|
||||
.Nm Last
|
||||
appeared in
|
||||
A
|
||||
.Nm
|
||||
utility last appeared in
|
||||
.Bx 3.0 .
|
||||
|
||||
@ -13,8 +13,9 @@
|
||||
.Op Fl f Ar format
|
||||
.Ar program ...
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
displays all shared objects that are needed to run the given program or
|
||||
utility displays all shared objects that are needed to run the given program or
|
||||
to load the given shared object.
|
||||
Contrary to
|
||||
.Xr nm 1 ,
|
||||
|
||||
@ -42,8 +42,9 @@
|
||||
.Nm
|
||||
.Op Oo Cm \&+ Oc Ns Ar hhmm
|
||||
.Sh DESCRIPTION
|
||||
.Nm Leave
|
||||
waits until the specified time, then reminds you that you
|
||||
The
|
||||
.Nm
|
||||
utility waits until the specified time, then reminds you that you
|
||||
have to leave.
|
||||
You are reminded 5 minutes and 1 minute before the actual
|
||||
time, at the time, and every minute thereafter.
|
||||
|
||||
@ -51,8 +51,9 @@
|
||||
.Op Ar name Ns = Ns Ar value ...
|
||||
.Op Ar command
|
||||
.Sh DESCRIPTION
|
||||
.Nm Limits
|
||||
either prints or sets kernel resource limits, and may optionally set
|
||||
The
|
||||
.Nm
|
||||
utility either prints or sets kernel resource limits, and may optionally set
|
||||
environment variables like
|
||||
.Xr env 1
|
||||
and run a program with the selected resources.
|
||||
@ -300,7 +301,9 @@ When invoked to execute a program, the failure of
|
||||
to raise a hard limit is considered a fatal error.
|
||||
.El
|
||||
.Sh DIAGNOSTICS
|
||||
.Nm Limits
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
exits with EXIT_FAILURE if usage is incorrect in any way; i.e. an invalid
|
||||
option, or set/display options are selected in the same invocation,
|
||||
.Fl e
|
||||
@ -321,8 +324,9 @@ will be whatever the executed program returns.
|
||||
.Xr login.conf 5 ,
|
||||
.Xr sysctl 8
|
||||
.Sh BUGS
|
||||
.Nm Limits
|
||||
does not handle commands with equal (``='') signs in their
|
||||
The
|
||||
.Nm
|
||||
utility does not handle commands with equal (``='') signs in their
|
||||
names, for obvious reasons.
|
||||
.Pp
|
||||
When eval output is selected, the
|
||||
@ -340,8 +344,9 @@ in eval mode prior mounting
|
||||
may only occur in standard bourne
|
||||
shell scripts.
|
||||
.Pp
|
||||
.Nm Limits
|
||||
makes no effort to ensure that resource settings emitted or displayed
|
||||
The
|
||||
.Nm
|
||||
utility makes no effort to ensure that resource settings emitted or displayed
|
||||
are valid and settable by the current user.
|
||||
Only a superuser account may raise hard limits, and when doing so
|
||||
the
|
||||
|
||||
@ -44,8 +44,9 @@
|
||||
.Op Fl p
|
||||
.Op Fl t Ar timeout
|
||||
.Sh DESCRIPTION
|
||||
.Nm Lock
|
||||
requests a password from the user, reads it again for verification
|
||||
The
|
||||
.Nm
|
||||
utility requests a password from the user, reads it again for verification
|
||||
and then will normally not relinquish the terminal until the password is
|
||||
repeated.
|
||||
There are two other conditions under which it will terminate: it
|
||||
|
||||
@ -101,7 +101,9 @@ as follows:
|
||||
.It Dv EX_TEMPFAIL
|
||||
The specified lock file was already locked by another process.
|
||||
.It Dv EX_CANTCREAT
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
was unable to create the lock file, e.g., because of insufficient access
|
||||
privileges.
|
||||
.It Dv EX_USAGE
|
||||
@ -115,8 +117,9 @@ A system call (e.g., fork) failed unexpectedly.
|
||||
.Xr flock 2 ,
|
||||
.Xr sysexits 3
|
||||
.Sh HISTORY
|
||||
A
|
||||
.Nm
|
||||
first appeared in
|
||||
utility first appeared in
|
||||
.Fx 2.2 .
|
||||
.Sh AUTHORS
|
||||
.An John Polstra Aq jdp@polstra.com .
|
||||
|
||||
@ -47,8 +47,9 @@
|
||||
.Op Fl t Ar tag
|
||||
.Op Ar message ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Logger
|
||||
provides a shell command interface to the
|
||||
The
|
||||
.Nm
|
||||
utility provides a shell command interface to the
|
||||
.Xr syslog 3
|
||||
system log module.
|
||||
.Pp
|
||||
|
||||
@ -105,15 +105,17 @@ If the file
|
||||
exists in the user's home directory, all of these messages are suppressed.
|
||||
This is to simplify logins for non-human users, such as
|
||||
.Xr uucp 1 .
|
||||
.Nm Login
|
||||
then records an entry in the
|
||||
The
|
||||
.Nm
|
||||
utility then records an entry in the
|
||||
.Xr wtmp 5
|
||||
and
|
||||
.Xr utmp 5
|
||||
files and executes the user's command interpreter.
|
||||
.Pp
|
||||
.Nm Login
|
||||
enters information into the environment (see
|
||||
The
|
||||
.Nm
|
||||
utility enters information into the environment (see
|
||||
.Xr environ 7 )
|
||||
specifying the user's home directory (HOME), command interpreter (SHELL),
|
||||
search path (PATH), terminal type (TERM) and user name (both LOGNAME and
|
||||
|
||||
@ -101,6 +101,7 @@ option was specified.
|
||||
This was incorrect and the current man page matches the historic
|
||||
implementation.
|
||||
.Sh HISTORY
|
||||
.Nm Look
|
||||
appeared in
|
||||
A
|
||||
.Nm
|
||||
utility appeared in
|
||||
.At v7 .
|
||||
|
||||
@ -48,8 +48,9 @@ utility uses
|
||||
.Xr nm 1
|
||||
to determine interdependencies in the list of object files
|
||||
specified on the command line.
|
||||
.Nm Lorder
|
||||
outputs a list of file names where the first file contains a symbol
|
||||
The
|
||||
.Nm
|
||||
utility outputs a list of file names where the first file contains a symbol
|
||||
which is defined by the second file.
|
||||
.Pp
|
||||
The output is normally used with
|
||||
|
||||
@ -111,8 +111,9 @@ ranges (e.g., a-z), regular expressions mimic emacs behavior,
|
||||
and the number of diversions is unlimited.
|
||||
.El
|
||||
.Sh SYNTAX
|
||||
.Nm m4
|
||||
provides the following built-in macros.
|
||||
The
|
||||
.Nm
|
||||
utility provides the following built-in macros.
|
||||
They may be redefined, losing their original meaning.
|
||||
Return values are null unless otherwise stated.
|
||||
.Bl -tag -width changequotexxx
|
||||
|
||||
@ -56,8 +56,9 @@
|
||||
.Op Fl EiInNv
|
||||
.Op Fl u Ar user
|
||||
.Sh INTRODUCTION
|
||||
.Nm Mail
|
||||
is an intelligent mail processing system, which has
|
||||
The
|
||||
.Nm
|
||||
utility is an intelligent mail processing system, which has
|
||||
a command syntax reminiscent of
|
||||
.Xr ed 1
|
||||
with lines replaced by messages.
|
||||
@ -144,8 +145,9 @@ option.
|
||||
Next, the commands in the user's personal command file
|
||||
.Pa ~/.mailrc
|
||||
are executed.
|
||||
The
|
||||
.Nm
|
||||
then examines its command line options to determine whether a
|
||||
utility then examines its command line options to determine whether a
|
||||
new message is to be sent, or whether an existing mailbox is to
|
||||
be read.
|
||||
.Ss "Sending Mail"
|
||||
@ -303,8 +305,9 @@ See
|
||||
.Xr mailaddr 7
|
||||
for a description of network addresses.
|
||||
.Pp
|
||||
.Nm Mail
|
||||
has a number of options which can be set in the
|
||||
The
|
||||
.Nm
|
||||
utility has a number of options which can be set in the
|
||||
.Pa .mailrc
|
||||
file to alter its behavior; thus
|
||||
.Dq Li "set askcc"
|
||||
@ -714,8 +717,9 @@ program text over the message system.
|
||||
A synonym for
|
||||
.Ic exit .
|
||||
.It Ic z
|
||||
.Nm Mail
|
||||
presents message headers in windowfuls as described under the
|
||||
The
|
||||
.Nm
|
||||
utility presents message headers in windowfuls as described under the
|
||||
.Ic headers
|
||||
command.
|
||||
You can move
|
||||
@ -1108,8 +1112,9 @@ with the
|
||||
command; normally, the first five lines are printed.
|
||||
.El
|
||||
.Sh ENVIRONMENT
|
||||
.Nm Mail
|
||||
utilizes the
|
||||
The
|
||||
.Nm
|
||||
utility utilizes the
|
||||
.Ev HOME
|
||||
and
|
||||
.Ev USER
|
||||
|
||||
@ -54,8 +54,9 @@
|
||||
.Op Ar variable Ns No = Ns Ar value
|
||||
.Op Ar target ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Make
|
||||
is a program designed to simplify the maintenance of other programs.
|
||||
The
|
||||
.Nm
|
||||
utility is a program designed to simplify the maintenance of other programs.
|
||||
Its input is a list of specifications
|
||||
describing dependency relationships between the generation of
|
||||
files and programs.
|
||||
@ -467,8 +468,9 @@ was executed with
|
||||
A path to the directory where
|
||||
.Nm
|
||||
was executed.
|
||||
.Nm Make
|
||||
sets
|
||||
The
|
||||
.Nm
|
||||
utility sets
|
||||
.Va .CURDIR
|
||||
to the canonical path given by
|
||||
.Xr getcwd 3 .
|
||||
@ -512,8 +514,9 @@ If they are undefined and
|
||||
is unable to change into any of the remaining three directories,
|
||||
then the current directory is used.
|
||||
.Pp
|
||||
.Nm Make
|
||||
sets
|
||||
The
|
||||
.Nm
|
||||
utility sets
|
||||
.Va .OBJDIR
|
||||
to the canonical path given by
|
||||
.Xr getcwd 3 .
|
||||
@ -1120,7 +1123,9 @@ variable.
|
||||
.It Ic .PATH\fIsuffix\fR
|
||||
The sources are directories which are to be searched for suffixed files
|
||||
not found in the current directory.
|
||||
.Nm Make
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
first searches the suffixed search path, before reverting to the default
|
||||
path if the file is not found there.
|
||||
This form is required for
|
||||
@ -1173,8 +1178,9 @@ Most of the more esoteric features of
|
||||
.Nm
|
||||
should probably be avoided for greater compatibility.
|
||||
.Sh ENVIRONMENT
|
||||
.Nm Make
|
||||
uses the following environment variables, if they exist:
|
||||
The
|
||||
.Nm
|
||||
utility uses the following environment variables, if they exist:
|
||||
.Ev MACHINE ,
|
||||
.Ev MAKE ,
|
||||
.Ev MAKEFLAGS ,
|
||||
|
||||
@ -35,8 +35,9 @@
|
||||
.Op Fl d
|
||||
.Op Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Minigzip
|
||||
is a minimal implementation of the
|
||||
The
|
||||
.Nm
|
||||
utility is a minimal implementation of the
|
||||
.Xr gzip 1
|
||||
utility. It supports
|
||||
compression and decompression of individual files, as well as
|
||||
@ -66,6 +67,7 @@ to standard output.
|
||||
.Sh SEE ALSO
|
||||
.Xr gzip 1
|
||||
.Sh AUTHORS
|
||||
.Nm Minigzip
|
||||
was written by
|
||||
The
|
||||
.Nm
|
||||
utility was written by
|
||||
.An Jean-loup Gailly .
|
||||
|
||||
@ -45,8 +45,9 @@
|
||||
.Op Ar flags
|
||||
.Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Mkdep
|
||||
takes a set of flags for the C compiler and a list
|
||||
The
|
||||
.Nm
|
||||
utility takes a set of flags for the C compiler and a list
|
||||
of C source files as arguments and constructs a set of include
|
||||
file dependencies which are written into the file ``.depend''.
|
||||
An example of its use in a Makefile might be:
|
||||
|
||||
@ -48,7 +48,7 @@
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
command creates the fifos requested, in the order specified.
|
||||
utility creates the fifos requested, in the order specified.
|
||||
.Pp
|
||||
The options are as follows:
|
||||
.Bl -tag -width indent
|
||||
@ -78,7 +78,7 @@ modified by the
|
||||
of the calling process.
|
||||
The
|
||||
.Nm
|
||||
command requires write permission in the parent directory.
|
||||
utility requires write permission in the parent directory.
|
||||
.Sh DIAGNOSTICS
|
||||
.Ex -std
|
||||
.Sh STANDARDS
|
||||
|
||||
@ -44,8 +44,9 @@
|
||||
.Ar messagefile
|
||||
.Ar prefix Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Mkstr
|
||||
creates files containing error messages extracted from C source,
|
||||
The
|
||||
.Nm
|
||||
utility creates files containing error messages extracted from C source,
|
||||
and restructures the same C source, to utilize the created error message
|
||||
file.
|
||||
The intent of
|
||||
@ -55,8 +56,9 @@ reduce swapping (see
|
||||
.Sx BUGS
|
||||
section below).
|
||||
.Pp
|
||||
.Nm Mkstr
|
||||
processes each of the specified
|
||||
The
|
||||
.Nm
|
||||
utility processes each of the specified
|
||||
.Ar files ,
|
||||
placing a restructured version of the input in a file whose name
|
||||
consists of the specified
|
||||
@ -81,13 +83,13 @@ Options:
|
||||
.It Fl
|
||||
Error messages are placed at the end of the specified
|
||||
message file for recompiling part of a large
|
||||
.Nm
|
||||
ed
|
||||
.Nm Ns ed
|
||||
program.
|
||||
.El
|
||||
.Pp
|
||||
.Nm Mkstr
|
||||
finds error messages in the source by
|
||||
The
|
||||
.Nm
|
||||
utility finds error messages in the source by
|
||||
searching for the string
|
||||
.Li \&`error("'
|
||||
in the input stream.
|
||||
@ -121,12 +123,14 @@ error(a1, a2, a3, a4)
|
||||
.Xr xstr 1 ,
|
||||
.Xr lseek 2
|
||||
.Sh HISTORY
|
||||
.Nm Mkstr
|
||||
appeared in
|
||||
A
|
||||
.Nm
|
||||
utility appeared in
|
||||
.Bx 3.0 .
|
||||
.Sh BUGS
|
||||
.Nm Mkstr
|
||||
was intended for the limited architecture of the PDP 11 family.
|
||||
The
|
||||
.Nm
|
||||
utility was intended for the limited architecture of the PDP 11 family.
|
||||
Very few programs actually use it.
|
||||
The Pascal interpreter,
|
||||
.Xr \&pi 1
|
||||
|
||||
@ -106,8 +106,9 @@ including one based on the internal template resulting from the
|
||||
.Fl t
|
||||
flag.
|
||||
.Pp
|
||||
.Nm Mktemp
|
||||
is provided to allow shell scripts to safely use temporary files.
|
||||
The
|
||||
.Nm
|
||||
utility is provided to allow shell scripts to safely use temporary files.
|
||||
Traditionally, many shell scripts take the name of the program with
|
||||
the pid as a suffix and use that as a temporary file name. This
|
||||
kind of naming scheme is predictable and the race condition it creates
|
||||
|
||||
@ -49,15 +49,17 @@
|
||||
.Op Fl c
|
||||
.Op \-days
|
||||
.Sh DESCRIPTION
|
||||
.Nm Msgs
|
||||
is used to read system messages.
|
||||
The
|
||||
.Nm
|
||||
utility is used to read system messages.
|
||||
These messages are
|
||||
sent by mailing to the login `msgs' and should be short
|
||||
pieces of information which are suitable to be read once by most users
|
||||
of the system.
|
||||
.Pp
|
||||
.Nm Msgs
|
||||
is normally invoked each time you login, by placing it in the file
|
||||
The
|
||||
.Nm
|
||||
utility is normally invoked each time you login, by placing it in the file
|
||||
.Pa .login
|
||||
(or
|
||||
.Pa .profile
|
||||
@ -99,8 +101,9 @@ is invoked on that mailbox.
|
||||
Both `m' and `s' accept a numeric argument in place of the `\-'.
|
||||
.El
|
||||
.Pp
|
||||
.Nm Msgs
|
||||
keeps track of the next message you will see by a number in the file
|
||||
The
|
||||
.Nm
|
||||
utility keeps track of the next message you will see by a number in the file
|
||||
.Pa \&.msgsrc
|
||||
in your home directory.
|
||||
In the directory
|
||||
@ -203,8 +206,9 @@ you can also go to any specific message by typing its number when
|
||||
.Nm
|
||||
requests input as to what to do.
|
||||
.Sh ENVIRONMENT
|
||||
.Nm Msgs
|
||||
uses the
|
||||
The
|
||||
.Nm
|
||||
utility uses the
|
||||
.Ev HOME
|
||||
and
|
||||
.Ev TERM
|
||||
|
||||
@ -45,8 +45,9 @@
|
||||
.Ar command
|
||||
.Op Ar count
|
||||
.Sh DESCRIPTION
|
||||
.Nm \&Mt
|
||||
is used to give commands to a magnetic tape drive.
|
||||
The
|
||||
.Nm
|
||||
utility is used to give commands to a magnetic tape drive.
|
||||
By default
|
||||
.Nm
|
||||
performs the requested operation once. Operations
|
||||
@ -226,8 +227,9 @@ does not exist;
|
||||
uses the device
|
||||
.Pa /dev/nsa0 .
|
||||
.Pp
|
||||
.Nm \&Mt
|
||||
returns a 0 exit status when the operation(s) were successful,
|
||||
The
|
||||
.Nm
|
||||
utility returns a 0 exit status when the operation(s) were successful,
|
||||
1 if the command was unrecognized, and 2 if an operation failed.
|
||||
.Pp
|
||||
The following density table was taken from the
|
||||
@ -306,8 +308,9 @@ If the following environment variable exists, it is utilized by
|
||||
.Nm Ns .
|
||||
.Bl -tag -width Fl
|
||||
.It Ev TAPE
|
||||
.Nm \&Mt
|
||||
checks the
|
||||
The
|
||||
.Nm
|
||||
utility checks the
|
||||
.Ev TAPE
|
||||
environment variable if the
|
||||
argument
|
||||
|
||||
@ -49,8 +49,9 @@
|
||||
.Op Fl Jeo
|
||||
.Op Ar year
|
||||
.Sh DESCRIPTION
|
||||
.Nm Cal
|
||||
displays a simple calendar in traditional format and
|
||||
The
|
||||
.Nm
|
||||
utility displays a simple calendar in traditional format and
|
||||
.Nm ncal
|
||||
offers an alternative layout, more options and the date of easter.
|
||||
The new format is a little cramped but it makes a year fit
|
||||
|
||||
@ -181,8 +181,9 @@ Only the superuser can override the
|
||||
attribute for a connection.
|
||||
.It Fl P
|
||||
Mark the connection as permanent.
|
||||
The
|
||||
.Nm
|
||||
always creates permanent connections.
|
||||
utility always creates permanent connections.
|
||||
This option can be used in other ncp*
|
||||
programs.
|
||||
.It Fl R Ar retry_count
|
||||
|
||||
@ -16,7 +16,7 @@
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
will schedule a connection created by
|
||||
utility will schedule a connection created by
|
||||
.Xr ncplogin 1
|
||||
command to be closed.
|
||||
If the connection is busy (i.e. used by other processes) it will
|
||||
|
||||
@ -44,8 +44,9 @@
|
||||
.Ar command
|
||||
.Op Ar arguments
|
||||
.Sh DESCRIPTION
|
||||
.Nm Nice
|
||||
runs
|
||||
The
|
||||
.Nm
|
||||
utility runs
|
||||
.Ar command
|
||||
at a low priority.
|
||||
(Think of low and slow).
|
||||
@ -56,8 +57,9 @@ is not given,
|
||||
assumes the value 10.
|
||||
The priority is a value in the range -20 to 20.
|
||||
The default priority is 0, priority 20 is the lowest possible.
|
||||
.Nm Nice
|
||||
will execute
|
||||
The
|
||||
.Nm
|
||||
utility will execute
|
||||
.Ar command
|
||||
at priority
|
||||
.Ar number
|
||||
|
||||
@ -88,8 +88,9 @@ command appeared in
|
||||
.Fx 3.0 .
|
||||
.Sh AUTHORS
|
||||
.An -nosplit
|
||||
The
|
||||
.Nm
|
||||
was written by
|
||||
utility was written by
|
||||
.An Peter Wemm Aq peter@netplex.com.au .
|
||||
This manual page was written by
|
||||
.An David O'Brien Aq obrien@NUXI.com .
|
||||
|
||||
@ -41,8 +41,9 @@
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Sh DESCRIPTION
|
||||
.Nm Pagesize
|
||||
prints the size of a page of memory in bytes, as
|
||||
The
|
||||
.Nm
|
||||
utility prints the size of a page of memory in bytes, as
|
||||
returned by
|
||||
.Xr getpagesize 3 .
|
||||
This program is useful in constructing portable
|
||||
|
||||
@ -49,8 +49,9 @@
|
||||
.Op Fl h Ar host
|
||||
.Op Fl o
|
||||
.Sh DESCRIPTION
|
||||
.Nm Passwd
|
||||
changes the user's local, Kerberos, or NIS password.
|
||||
The
|
||||
.Nm
|
||||
utility changes the user's local, Kerberos, or NIS password.
|
||||
If the user is not the super-user,
|
||||
.Nm
|
||||
first prompts for the current password and will not continue unless the correct
|
||||
@ -58,8 +59,9 @@ password is entered.
|
||||
.Pp
|
||||
When entering the new password, the characters entered do not echo, in order to
|
||||
avoid the password being seen by a passer-by.
|
||||
The
|
||||
.Nm
|
||||
prompts for the new password twice in order to detect typing errors.
|
||||
utility prompts for the new password twice in order to detect typing errors.
|
||||
.Pp
|
||||
The new password should be at least six characters long (which
|
||||
may be overridden using the
|
||||
@ -106,8 +108,9 @@ followed by
|
||||
The super-user is not required to provide a user's current password
|
||||
if only the local password is modified.
|
||||
.Sh NIS INTERACTION
|
||||
.Nm Passwd
|
||||
has built-in support for NIS.
|
||||
The
|
||||
.Nm
|
||||
utility has built-in support for NIS.
|
||||
If a user exists in the NIS password
|
||||
database but does not exist locally,
|
||||
.Nm
|
||||
|
||||
@ -49,8 +49,9 @@
|
||||
.Op Ar name Ns = Ns Ar value ...
|
||||
.Op Ar command
|
||||
.Sh DESCRIPTION
|
||||
.Nm Printenv
|
||||
prints out the names and values of the variables in the environment,
|
||||
The
|
||||
.Nm
|
||||
utility prints out the names and values of the variables in the environment,
|
||||
with one name/value pair per line.
|
||||
If
|
||||
.Ar name
|
||||
@ -64,8 +65,9 @@ Consult the
|
||||
.Xr builtin 1
|
||||
manual page.
|
||||
.Pp
|
||||
.Nm Env
|
||||
executes
|
||||
The
|
||||
.Nm env
|
||||
utility executes
|
||||
.Ar command
|
||||
after modifying the environment as
|
||||
specified on the command line.
|
||||
@ -98,8 +100,9 @@ If no command is specified,
|
||||
prints out the names and values
|
||||
of the variables in the environment, with one name/value pair per line.
|
||||
.Pp
|
||||
The
|
||||
.Nm env
|
||||
is sometimes useful with the
|
||||
utility is sometimes useful with the
|
||||
.Dq Li #!
|
||||
construct (see
|
||||
.Xr execve 2 ) .
|
||||
@ -142,6 +145,7 @@ The
|
||||
command appeared in
|
||||
.Bx 3.0 .
|
||||
.Sh BUGS
|
||||
.Nm Env
|
||||
doesn't handle commands with equal (``='') signs in their
|
||||
The
|
||||
.Nm env
|
||||
utility doesn't handle commands with equal (``='') signs in their
|
||||
names, for obvious reasons.
|
||||
|
||||
@ -45,8 +45,9 @@
|
||||
.Nm
|
||||
.Ar format Op Ar arguments ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Printf
|
||||
formats and prints its arguments, after the first, under control
|
||||
The
|
||||
.Nm
|
||||
utility formats and prints its arguments, after the first, under control
|
||||
of the
|
||||
.Ar format .
|
||||
The
|
||||
|
||||
@ -55,8 +55,9 @@
|
||||
.Op Fl v | Fl q
|
||||
.Ar group
|
||||
.Sh DESCRIPTION
|
||||
.Nm Quota
|
||||
displays users' disk usage and limits.
|
||||
The
|
||||
.Nm
|
||||
utility displays users' disk usage and limits.
|
||||
By default only the user quotas are printed.
|
||||
.Pp
|
||||
The following options are available:
|
||||
@ -68,8 +69,7 @@ The optional
|
||||
.Fl u
|
||||
flag is equivalent to the default.
|
||||
.It Fl v
|
||||
.Nm Quota
|
||||
will display quotas on filesystems
|
||||
Display quotas on filesystems
|
||||
where no storage is allocated.
|
||||
.It Fl q
|
||||
Print a more terse message,
|
||||
@ -101,8 +101,9 @@ flag takes precedence over the
|
||||
.Fl v
|
||||
flag.
|
||||
.Pp
|
||||
.Nm Quota
|
||||
tries to report the quotas of all mounted filesystems.
|
||||
The
|
||||
.Nm
|
||||
utility tries to report the quotas of all mounted filesystems.
|
||||
If the filesystem is mounted via
|
||||
.Tn NFS ,
|
||||
it will attempt to contact the
|
||||
|
||||
@ -43,8 +43,9 @@
|
||||
.Op Fl t
|
||||
.Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Ranlib
|
||||
creates a table of external references for archive libraries,
|
||||
The
|
||||
.Nm
|
||||
utility 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.
|
||||
|
||||
@ -47,11 +47,14 @@
|
||||
.Op Fl l Ar username
|
||||
.Ar host
|
||||
.Sh DESCRIPTION
|
||||
.Nm Rlogin
|
||||
starts a terminal session on a remote host
|
||||
The
|
||||
.Nm
|
||||
utility starts a terminal session on a remote host
|
||||
.Ar host .
|
||||
.Pp
|
||||
.Nm Rlogin
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
first attempts to use the Kerberos authorization mechanism, described below.
|
||||
If the remote host does not support Kerberos the standard Berkeley
|
||||
.Pa rhosts
|
||||
@ -231,8 +234,9 @@ command appeared in
|
||||
.Pp
|
||||
IPv6 support was added by WIDE/KAME project.
|
||||
.Sh BUGS
|
||||
.Nm Rlogin
|
||||
will be replaced by
|
||||
The
|
||||
.Nm
|
||||
utility will be replaced by
|
||||
.Xr telnet 1
|
||||
in the near future.
|
||||
.Pp
|
||||
|
||||
@ -1,6 +1,7 @@
|
||||
.\" @(#)rpcgen.1 1.35 93/06/02 SMI
|
||||
.\" $FreeBSD$
|
||||
.\" Copyright 1985-1993 Sun Microsystems, Inc.
|
||||
.\"
|
||||
.Dd March 28, 1993
|
||||
.Dt RPCGEN 1
|
||||
.Os
|
||||
@ -50,8 +51,9 @@
|
||||
.\" .LP
|
||||
.\" SUNWcsu
|
||||
.Sh DESCRIPTION
|
||||
.Nm Rpcgen
|
||||
is a tool that generates C code to implement an
|
||||
The
|
||||
.Nm
|
||||
utility is a tool that generates C code to implement an
|
||||
.Tn RPC
|
||||
protocol.
|
||||
The input to
|
||||
@ -60,8 +62,9 @@ is a language similar to C known as
|
||||
.Tn RPC
|
||||
Language (Remote Procedure Call Language).
|
||||
.Pp
|
||||
.Nm Rpcgen
|
||||
is normally used as in the first synopsis where
|
||||
The
|
||||
.Nm
|
||||
utility is normally used as in the first synopsis where
|
||||
it takes an input file and generates three output files.
|
||||
If the
|
||||
.Ar infile
|
||||
@ -85,8 +88,9 @@ it also generates the
|
||||
dispatch table in
|
||||
.Pa proto_tbl.i .
|
||||
.Pp
|
||||
.Nm Rpcgen
|
||||
can also generate sample client and server files
|
||||
The
|
||||
.Nm
|
||||
utility can also generate sample client and server files
|
||||
that can be customized to suit a particular application.
|
||||
The
|
||||
.Fl \&Sc ,
|
||||
@ -382,7 +386,7 @@ However, the
|
||||
functions are not yet MT-safe, which means that rpcgen generated server-side
|
||||
code will not be MT-safe.
|
||||
.It Fl N
|
||||
This option allows procedures to have multiple arguments.
|
||||
Allow procedures to have multiple arguments.
|
||||
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 can pass the argument itself.
|
||||
|
||||
@ -47,8 +47,9 @@
|
||||
.Oc
|
||||
.Op Ar rows Op Ar cols
|
||||
.Sh DESCRIPTION
|
||||
.Nm Rs
|
||||
reads the standard input, interpreting each line as a row
|
||||
The
|
||||
.Nm
|
||||
utility reads the standard input, interpreting each line as a row
|
||||
of blank-separated entries in an array,
|
||||
transforms the array according to the options,
|
||||
and writes it on the standard output.
|
||||
@ -168,8 +169,9 @@ unless the first non-ignored line is longer than the display width.
|
||||
Option letters which take numerical arguments interpret a missing
|
||||
number as zero unless otherwise indicated.
|
||||
.Sh EXAMPLES
|
||||
.Nm Rs
|
||||
can be used as a filter to convert the stream output
|
||||
The
|
||||
.Nm
|
||||
utility can be used as a filter to convert the stream output
|
||||
of certain programs (e.g.,
|
||||
.Xr spell ,
|
||||
.Xr du ,
|
||||
|
||||
@ -47,14 +47,16 @@
|
||||
.Ar host
|
||||
.Op command
|
||||
.Sh DESCRIPTION
|
||||
.Nm Rsh
|
||||
executes
|
||||
The
|
||||
.Nm
|
||||
utility executes
|
||||
.Ar command
|
||||
on
|
||||
.Ar host .
|
||||
.Pp
|
||||
.Nm Rsh
|
||||
copies its standard input to the remote command, the standard
|
||||
The
|
||||
.Nm
|
||||
utility 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
|
||||
|
||||
@ -43,8 +43,9 @@
|
||||
.Nm
|
||||
.Op Ar host ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Rup
|
||||
displays a summary of the current system status of a particular
|
||||
The
|
||||
.Nm
|
||||
utility displays a summary of the current system status of a particular
|
||||
.Ar host
|
||||
or all hosts on the local network.
|
||||
The output shows the current time of day, how long the system has
|
||||
@ -57,8 +58,9 @@ The
|
||||
.Xr rpc.rstatd 8
|
||||
daemon must be running on the remote host for this command to
|
||||
work.
|
||||
.Nm Rup
|
||||
uses an RPC protocol defined in
|
||||
The
|
||||
.Nm
|
||||
utility uses an RPC protocol defined in
|
||||
.Pa /usr/include/rpcsvc/rstat.x .
|
||||
.Sh EXAMPLES
|
||||
.Bd -literal
|
||||
|
||||
@ -42,8 +42,9 @@
|
||||
.Nm
|
||||
.Op Fl alrtu
|
||||
.Sh DESCRIPTION
|
||||
.Nm Ruptime
|
||||
gives a status line like
|
||||
The
|
||||
.Nm
|
||||
utility gives a status line like
|
||||
.Xr uptime 1
|
||||
for each machine on the local network; these are formed from packets
|
||||
broadcast by each host on the network once every three minutes.
|
||||
@ -78,6 +79,7 @@ data files
|
||||
.Xr uptime 1 ,
|
||||
.Xr rwhod 8
|
||||
.Sh HISTORY
|
||||
.Nm Ruptime
|
||||
appeared in
|
||||
A
|
||||
.Nm
|
||||
utility appeared in
|
||||
.Bx 4.2 .
|
||||
|
||||
@ -46,8 +46,9 @@
|
||||
.Op Fl t Ar time
|
||||
.Op Ar file Op command ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Script
|
||||
makes a typescript of everything printed on your terminal.
|
||||
The
|
||||
.Nm
|
||||
utility makes a typescript of everything printed on your terminal.
|
||||
It is useful for students who need a hardcopy record of an interactive
|
||||
session as proof of an assignment, as the typescript file
|
||||
can be printed out later with
|
||||
@ -108,8 +109,9 @@ C-shell,
|
||||
Certain interactive commands, such as
|
||||
.Xr vi 1 ,
|
||||
create garbage in the typescript file.
|
||||
.Nm Script
|
||||
works best with commands that do not manipulate the screen.
|
||||
The
|
||||
.Nm
|
||||
utility works best with commands that do not manipulate the screen.
|
||||
The results are meant to emulate a hardcopy terminal, not an addressable one.
|
||||
.Sh ENVIRONMENT
|
||||
The following environment variable is utilized by
|
||||
@ -138,8 +140,9 @@ The
|
||||
command appeared in
|
||||
.Bx 3.0 .
|
||||
.Sh BUGS
|
||||
.Nm Script
|
||||
places
|
||||
The
|
||||
.Nm
|
||||
utility places
|
||||
.Sy everything
|
||||
in the log file, including linefeeds and backspaces.
|
||||
This is not what the naive user expects.
|
||||
|
||||
@ -42,8 +42,9 @@
|
||||
.Nm
|
||||
.Op Ar object_file ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Size
|
||||
displays the text, data and bss segment sizes of the specified
|
||||
The
|
||||
.Nm
|
||||
utility displays the text, data and bss segment sizes of the specified
|
||||
.Ar object_file
|
||||
in bytes (in decimal), and the sum of the three segments (in
|
||||
decimal and hexadecimal).
|
||||
|
||||
@ -42,7 +42,9 @@
|
||||
.Nm
|
||||
.Op Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Soelim
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
reads the specified files or the standard input and performs the textual
|
||||
inclusion implied by the
|
||||
.Xr nroff 1
|
||||
|
||||
@ -44,7 +44,9 @@
|
||||
.Op Fl n Ar number
|
||||
.Op Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Strings
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
displays the sequences of printable characters in each of the specified
|
||||
files, or in the standard input, by default.
|
||||
By default, a sequence must be at least four characters in length
|
||||
@ -73,8 +75,9 @@ Each string is preceded by its decimal offset in the
|
||||
file.
|
||||
.El
|
||||
.Pp
|
||||
.Nm Strings
|
||||
is useful for identifying random binaries, among other things.
|
||||
The
|
||||
.Nm
|
||||
utility is useful for identifying random binaries, among other things.
|
||||
.Sh SEE ALSO
|
||||
.Xr hexdump 1
|
||||
.Sh BUGS
|
||||
|
||||
@ -60,8 +60,9 @@ Delete only debugging and empty symbols.
|
||||
Delete only debugging, compiler identification, and local symbols.
|
||||
.El
|
||||
.Pp
|
||||
.Nm Strip
|
||||
exits 0 on success and 1 if an error occurred.
|
||||
The
|
||||
.Nm
|
||||
utility exits 0 on success and 1 if an error occurred.
|
||||
.Sh SEE ALSO
|
||||
.Xr cc 1 ,
|
||||
.Xr ld 1 ,
|
||||
|
||||
@ -45,8 +45,9 @@
|
||||
.Op Fl c Ar class
|
||||
.Op Ar login Op Ar args
|
||||
.Sh DESCRIPTION
|
||||
.Nm Su
|
||||
requests appropriate user credentials via PAM
|
||||
The
|
||||
.Nm
|
||||
utility requests appropriate user credentials via PAM
|
||||
and switches to that user ID
|
||||
(the default user is the superuser).
|
||||
A shell is then executed.
|
||||
|
||||
@ -43,8 +43,9 @@
|
||||
.Op Fl display
|
||||
.Op Ar refresh-interval
|
||||
.Sh DESCRIPTION
|
||||
.Nm Systat
|
||||
displays various system statistics in a screen oriented fashion
|
||||
The
|
||||
.Nm
|
||||
utility displays various system statistics in a screen oriented fashion
|
||||
using the curses screen display library,
|
||||
.Xr ncurses 3 .
|
||||
.Pp
|
||||
|
||||
@ -43,8 +43,9 @@
|
||||
.Ar person
|
||||
.Op Ar ttyname
|
||||
.Sh DESCRIPTION
|
||||
.Nm Talk
|
||||
is a visual communication program which copies lines from your
|
||||
The
|
||||
.Nm
|
||||
utility is a visual communication program which copies lines from your
|
||||
terminal to that of another user.
|
||||
.Pp
|
||||
Options available:
|
||||
|
||||
@ -27,8 +27,9 @@
|
||||
.Op Fl OUGdk
|
||||
.Op Ar file
|
||||
.Sh DESCRIPTION
|
||||
.Nm Tconv
|
||||
converts between the three terminal descriptions,
|
||||
The
|
||||
.Nm
|
||||
utility converts between the three terminal descriptions,
|
||||
termcap, terminfo source, and terminfo binary,
|
||||
that the
|
||||
.Em tinfo
|
||||
@ -98,8 +99,9 @@ but not of much use in most cases, as
|
||||
fields will be followed and incorporated into the output terminal
|
||||
description.
|
||||
.Pp
|
||||
.Nm Tconv
|
||||
should be able translate all standard termcap parameterized strings
|
||||
The
|
||||
.Nm
|
||||
utility should be able translate all standard termcap parameterized strings
|
||||
terminfo format, but complex strings using GNU's %a code may be
|
||||
too hard to translate.
|
||||
If
|
||||
@ -161,7 +163,8 @@ may refer to the last line of an entry instead of the line in the entry
|
||||
that generated the warning.
|
||||
.Sh BUGS
|
||||
More warning messages could be generated.
|
||||
.Nm Tconv
|
||||
can't translate to termcap. Binaries generated will have canceled
|
||||
The
|
||||
.Nm
|
||||
utility can't translate to termcap. Binaries generated will have canceled
|
||||
capabilities marked as canceled, which is incompatible with
|
||||
System V Release 2.0 terminfo.
|
||||
|
||||
@ -45,11 +45,13 @@
|
||||
.Oo Ar src Op Ar dest
|
||||
.Oc
|
||||
.Sh DESCRIPTION
|
||||
.Nm Tcopy
|
||||
is designed to copy magnetic tapes. The only assumption made
|
||||
The
|
||||
.Nm
|
||||
utility is designed to copy magnetic tapes. The only assumption made
|
||||
about the tape is that there are two tape marks at the end.
|
||||
.Nm Tcopy
|
||||
with only a source tape
|
||||
The
|
||||
.Nm
|
||||
utility with only a source tape
|
||||
.Pf ( Ar /dev/rsa0
|
||||
by default) specified will print
|
||||
information about the sizes of records and tape files. If a destination
|
||||
|
||||
@ -1380,8 +1380,9 @@ is specified,
|
||||
will print the help information for just that command.
|
||||
.El
|
||||
.Sh ENVIRONMENT
|
||||
The
|
||||
.Nm
|
||||
uses at least the
|
||||
utility uses at least the
|
||||
.Ev HOME ,
|
||||
.Ev SHELL ,
|
||||
.Ev DISPLAY ,
|
||||
|
||||
@ -42,8 +42,9 @@
|
||||
.Nm
|
||||
.Op Ar host
|
||||
.Sh DESCRIPTION
|
||||
.Nm Tftp
|
||||
is the user interface to the Internet
|
||||
The
|
||||
.Nm
|
||||
utility is the user interface to the Internet
|
||||
.Tn TFTP
|
||||
(Trivial File Transfer Protocol),
|
||||
which allows users to transfer files to and from a remote machine.
|
||||
|
||||
@ -80,12 +80,14 @@ Escape to a shell (exiting the shell will
|
||||
return you to tip).
|
||||
.It Ic \&~>
|
||||
Copy file from local to remote.
|
||||
.Nm Tip
|
||||
prompts for the name of a local file to transmit.
|
||||
The
|
||||
.Nm
|
||||
utility prompts for the name of a local file to transmit.
|
||||
.It Ic \&~<
|
||||
Copy file from remote to local.
|
||||
.Nm Tip
|
||||
prompts first for the name of the file to be sent, then for
|
||||
The
|
||||
.Nm
|
||||
utility prompts first for the name of the file to be sent, then for
|
||||
a command to be executed on the remote machine.
|
||||
.It Ic \&~p Ar from Op Ar to
|
||||
Send a file to a remote
|
||||
@ -161,8 +163,9 @@ the side that displays output from the remote host, is left running.
|
||||
Get a summary of the tilde escapes
|
||||
.El
|
||||
.Pp
|
||||
.Nm Tip
|
||||
uses the file
|
||||
The
|
||||
.Nm
|
||||
utility uses the file
|
||||
.Pa /etc/remote
|
||||
to find how to reach a particular
|
||||
system and to find out how it should operate while talking
|
||||
@ -192,8 +195,9 @@ erase and kill characters. A null line in response to a prompt,
|
||||
or an interrupt, will abort the dialogue and return you to the
|
||||
remote machine.
|
||||
.Pp
|
||||
.Nm Tip
|
||||
guards against multiple users connecting to a remote system
|
||||
The
|
||||
.Nm
|
||||
utility guards against multiple users connecting to a remote system
|
||||
by opening modems and terminal lines with exclusive access,
|
||||
and by honoring the locking protocol used by
|
||||
.Xr uucico 8 .
|
||||
@ -215,18 +219,21 @@ When
|
||||
.Nm
|
||||
must dial a phone number to connect to a system it will print
|
||||
various messages indicating its actions.
|
||||
.Nm Tip
|
||||
supports modems that use the AT command set.
|
||||
.Nm Tip
|
||||
uses the file
|
||||
The
|
||||
.Nm
|
||||
utility supports modems that use the AT command set.
|
||||
The
|
||||
.Nm
|
||||
utility uses the file
|
||||
.Pa /etc/modems
|
||||
to find out how to operate with a particular
|
||||
modem; refer to
|
||||
.Xr modems 5
|
||||
for a full description.
|
||||
.Ss VARIABLES
|
||||
.Nm Tip
|
||||
maintains a set of
|
||||
The
|
||||
.Nm
|
||||
utility maintains a set of
|
||||
.Ar variables
|
||||
which control its operation.
|
||||
Some of these variables are read-only to normal users (root is allowed
|
||||
@ -291,8 +298,9 @@ a ~> file transfer command; abbreviated
|
||||
.Ar eofw .
|
||||
.It Ar eol
|
||||
(str) The set of characters which indicate an end-of-line.
|
||||
.Nm Tip
|
||||
will recognize escape characters only after an end-of-line.
|
||||
The
|
||||
.Nm
|
||||
utility will recognize escape characters only after an end-of-line.
|
||||
.It Ar escape
|
||||
(char) The command prefix (escape) character; abbreviated
|
||||
.Ar es ;
|
||||
@ -398,8 +406,9 @@ of lines transferred during a file transfer operations,
|
||||
and more.
|
||||
.El
|
||||
.Sh ENVIRONMENT
|
||||
.Nm Tip
|
||||
uses the following environment variables:
|
||||
The
|
||||
.Nm
|
||||
utility uses the following environment variables:
|
||||
.Bl -tag -width Fl
|
||||
.It Ev SHELL
|
||||
(str) The name of the shell to use for the ~! command; default
|
||||
|
||||
@ -62,6 +62,6 @@ manual page.
|
||||
.Sh STANDARDS
|
||||
The
|
||||
.Nm
|
||||
function is expected to be
|
||||
utility is expected to be
|
||||
.St -p1003.2
|
||||
compatible.
|
||||
|
||||
@ -17,8 +17,9 @@
|
||||
command
|
||||
.Op args
|
||||
.Sh DESCRIPTION
|
||||
.Nm Truss
|
||||
traces the system calls called by the specified process or program.
|
||||
The
|
||||
.Nm
|
||||
utility traces the system calls called by the specified process or program.
|
||||
Output is to the specified output file, or standard error by default.
|
||||
It does this by stopping and restarting the process being monitored via
|
||||
.Xr procfs 5 .
|
||||
|
||||
@ -57,10 +57,10 @@
|
||||
.Op Fl m Ar mapping
|
||||
.Op Ar terminal
|
||||
.Sh DESCRIPTION
|
||||
.Nm Tset
|
||||
initializes terminals.
|
||||
.Nm Tset
|
||||
first determines the type of terminal that you are using.
|
||||
The
|
||||
.Nm
|
||||
utility initializes terminals.
|
||||
It first determines the type of terminal that you are using.
|
||||
This determination is done as follows, using the first terminal type found.
|
||||
.Pp
|
||||
.Bl -bullet -compact -offset indent
|
||||
|
||||
@ -48,8 +48,9 @@
|
||||
.Op Fl q
|
||||
.Op Ar file
|
||||
.Sh DESCRIPTION
|
||||
.Nm Tsort
|
||||
takes a list of pairs of node names representing directed arcs in
|
||||
The
|
||||
.Nm
|
||||
utility takes a list of pairs of node names representing directed arcs in
|
||||
a graph and prints the nodes in topological order on standard output.
|
||||
Input is taken from the named
|
||||
.Ar file ,
|
||||
|
||||
@ -65,7 +65,9 @@ option is deprecated in favor of the
|
||||
command.
|
||||
.El
|
||||
.Pp
|
||||
.Nm Tty
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
exits 0 if the standard input is a terminal, 1 if the standard input is
|
||||
not a terminal, and >1 if an error occurs.
|
||||
.Sh SEE ALSO
|
||||
|
||||
@ -34,8 +34,9 @@
|
||||
.Nm
|
||||
.Op Fl fprs
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
sets the per-process handling of
|
||||
utility sets the per-process handling of
|
||||
.Dq Unaligned Access
|
||||
events.
|
||||
Unlike many other CPU's the DEC Alpha processor cannot access unaligned data.
|
||||
@ -88,8 +89,9 @@ command syntax is incompatible with the DEC OSF/1 syntax.
|
||||
.Sh SEE ALSO
|
||||
.Xr signal 3
|
||||
.Sh HISTORY
|
||||
A
|
||||
.Nm
|
||||
first appeared in DEC OSF/1.
|
||||
utility first appeared in DEC OSF/1.
|
||||
.Sh AUTHORS
|
||||
.An -nosplit
|
||||
The
|
||||
|
||||
@ -44,8 +44,9 @@
|
||||
.Op Fl t Ar terminal
|
||||
.Op Ar name Ar ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Ul
|
||||
reads the named files (or standard input if none are given)
|
||||
The
|
||||
.Nm
|
||||
utility reads the named files (or standard input if none are given)
|
||||
and translates occurrences of underscores to the sequence
|
||||
which indicates underlining for the terminal in use, as specified
|
||||
by the environment variable
|
||||
|
||||
@ -53,11 +53,13 @@
|
||||
.Ar ...
|
||||
.Op Ar file
|
||||
.Sh DESCRIPTION
|
||||
.Nm Unifdef
|
||||
is useful for removing ifdef'ed lines
|
||||
The
|
||||
.Nm
|
||||
utility removes ifdef'ed lines
|
||||
from a file while otherwise leaving the file alone.
|
||||
.Nm Unifdef
|
||||
acts on
|
||||
The
|
||||
.Nm
|
||||
utility acts on
|
||||
#ifdef, #ifndef, #else, and #endif lines,
|
||||
and it knows only enough about C
|
||||
to know when one of these is inactive
|
||||
@ -130,8 +132,9 @@ and
|
||||
above.
|
||||
.El
|
||||
.Pp
|
||||
.Nm Unifdef
|
||||
copies its output to
|
||||
The
|
||||
.Nm
|
||||
utility copies its output to
|
||||
.Em stdout
|
||||
and will take its input from
|
||||
.Em stdin
|
||||
@ -139,8 +142,9 @@ if no
|
||||
.Ar file
|
||||
argument is given.
|
||||
.Pp
|
||||
.Nm Unifdef
|
||||
works nicely with the
|
||||
The
|
||||
.Nm
|
||||
utility works nicely with the
|
||||
.Fl D Ns Ar sym
|
||||
option added to
|
||||
.Xr diff 1
|
||||
|
||||
@ -42,8 +42,9 @@
|
||||
.Nm
|
||||
.Op Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Unvis
|
||||
is the inverse function of
|
||||
The
|
||||
.Nm
|
||||
utility is the inverse function of
|
||||
.Xr vis 1 .
|
||||
It reverts
|
||||
a visual representation of data back to its original form on standard output.
|
||||
|
||||
@ -52,8 +52,9 @@
|
||||
.Op Fl v
|
||||
.Op Ar item ...
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
can be used to dump the state of a USB HID (Human Interface Device).
|
||||
utility can be used to dump the state of a USB HID (Human Interface Device).
|
||||
Each named
|
||||
.Ar item
|
||||
is printed.
|
||||
@ -79,8 +80,9 @@ Be verbose.
|
||||
.Pa /usr/share/misc/usb_hid_usages
|
||||
The default HID usage table.
|
||||
.Sh BUGS
|
||||
The
|
||||
.Nm
|
||||
cannot show nor set output and feature items.
|
||||
utility cannot show nor set output and feature items.
|
||||
.Sh SEE ALSO
|
||||
.Xr usb 3 ,
|
||||
.Xr uhid 4 ,
|
||||
|
||||
@ -41,8 +41,9 @@
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Sh DESCRIPTION
|
||||
.Nm Users
|
||||
lists the login names of the users currently on the system,
|
||||
The
|
||||
.Nm
|
||||
utility lists the login names of the users currently on the system,
|
||||
in sorted order, space separated, on a single line.
|
||||
.Sh FILES
|
||||
.Bl -tag -width /var/run/utmp
|
||||
|
||||
@ -53,16 +53,18 @@
|
||||
.Fl o Ar output_file
|
||||
.Op Ar file
|
||||
.Sh DESCRIPTION
|
||||
.Nm Uuencode
|
||||
The
|
||||
.Nm
|
||||
and
|
||||
.Nm uudecode
|
||||
are used to transmit binary files over transmission mediums
|
||||
utilities are used to transmit binary files over transmission mediums
|
||||
that do not support other than simple
|
||||
.Tn ASCII
|
||||
data.
|
||||
.Pp
|
||||
.Nm Uuencode
|
||||
reads
|
||||
The
|
||||
.Nm
|
||||
utility reads
|
||||
.Ar file
|
||||
(or by default the standard input) and writes an encoded version
|
||||
to the standard output, or
|
||||
@ -76,8 +78,9 @@ mode of the file and the operand
|
||||
for use by
|
||||
.Nm uudecode .
|
||||
.Pp
|
||||
.Nm Uudecode
|
||||
transforms
|
||||
The
|
||||
.Nm uudecode
|
||||
utility transforms
|
||||
.Em uuencoded
|
||||
files (or by default, the standard input) into the original form.
|
||||
The resulting file is named either
|
||||
@ -87,8 +90,9 @@ or (depending on options passed to
|
||||
.Ar output_file
|
||||
and will have the mode of the original file except that setuid
|
||||
and execute bits are not retained.
|
||||
.Nm Uudecode
|
||||
ignores any leading and trailing lines.
|
||||
The
|
||||
.Nm uudecode
|
||||
utility ignores any leading and trailing lines.
|
||||
.Pp
|
||||
The following options are available for
|
||||
.Nm :
|
||||
|
||||
@ -53,16 +53,18 @@
|
||||
.Op Fl x
|
||||
.Ar name Ar ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Vgrind
|
||||
formats the program sources which are arguments
|
||||
The
|
||||
.Nm
|
||||
utility formats the program sources which are arguments
|
||||
in a nice style using
|
||||
.Xr troff 1
|
||||
Comments are placed in italics, keywords in bold face,
|
||||
and the name of the current function is listed down the margin of each
|
||||
page as it is encountered.
|
||||
.Pp
|
||||
.Nm Vgrind
|
||||
runs in two basic modes, filter mode (see the
|
||||
The
|
||||
.Nm
|
||||
utility runs in two basic modes, filter mode (see the
|
||||
.Fl f
|
||||
option) or regular mode. In filter mode
|
||||
.Nm
|
||||
|
||||
@ -44,8 +44,9 @@
|
||||
.Op Fl F Ar foldwidth
|
||||
.Op Ar
|
||||
.Sh DESCRIPTION
|
||||
.Nm Vis
|
||||
is a filter for converting non-printable characters
|
||||
The
|
||||
.Nm
|
||||
utility is a filter for converting non-printable characters
|
||||
into a visual representation. It differs from
|
||||
.Ql cat -v
|
||||
in that
|
||||
|
||||
@ -43,8 +43,9 @@
|
||||
.Op Fl g Ar group
|
||||
.Op Ar file
|
||||
.Sh DESCRIPTION
|
||||
.Nm Wall
|
||||
displays the contents of
|
||||
The
|
||||
.Nm
|
||||
utility displays the contents of
|
||||
.Ar file
|
||||
or, by default, its standard input, on the terminals of all
|
||||
currently logged in users.
|
||||
|
||||
@ -40,7 +40,9 @@
|
||||
.Op Ar command
|
||||
.Ar ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Which
|
||||
The
|
||||
.Nm
|
||||
utility
|
||||
takes a list of command names and searches the path for each executable
|
||||
file that would be run had these commands actually been invoked.
|
||||
.Pp
|
||||
|
||||
@ -45,8 +45,9 @@
|
||||
.Op Fl p Ar port
|
||||
.Ar name ...
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
looks up records in the databases maintained by several
|
||||
utility looks up records in the databases maintained by several
|
||||
Network Information Centers
|
||||
.Pq Tn NICs .
|
||||
.Pp
|
||||
|
||||
@ -49,8 +49,9 @@
|
||||
.Op Fl e Ar escape-char
|
||||
.Op Fl c Ar command
|
||||
.Sh DESCRIPTION
|
||||
.Nm Window
|
||||
implements a window environment on
|
||||
The
|
||||
.Nm
|
||||
utility implements a window environment on
|
||||
.Tn ASCII
|
||||
terminals.
|
||||
.Pp
|
||||
@ -367,8 +368,9 @@ A statement is either a conditional or an expression. Expression
|
||||
statements are terminated with a new line or ``;''. To continue
|
||||
an expression on the next line, terminate the first line with ``\\''.
|
||||
.Ss Conditional Statement
|
||||
.Nm Window
|
||||
has a single control structure:
|
||||
The
|
||||
.Nm
|
||||
utility has a single control structure:
|
||||
the fully bracketed if statement in the form
|
||||
.Pp
|
||||
.Bd -literal -offset indent -compact
|
||||
@ -926,8 +928,9 @@ field of the terminal's
|
||||
entry, is used.
|
||||
.El
|
||||
.Sh ENVIRONMENT
|
||||
.Nm Window
|
||||
utilizes these environment variables:
|
||||
The
|
||||
.Nm
|
||||
utility utilizes these environment variables:
|
||||
.Ev HOME ,
|
||||
.Ev SHELL ,
|
||||
.Ev TERM ,
|
||||
|
||||
@ -46,8 +46,9 @@
|
||||
.Ar user
|
||||
.Op Ar ttyname
|
||||
.Sh DESCRIPTION
|
||||
.Nm Write
|
||||
allows you to communicate with other users, by copying lines from
|
||||
The
|
||||
.Nm
|
||||
utility allows you to communicate with other users, by copying lines from
|
||||
your terminal to theirs.
|
||||
.Pp
|
||||
When you run the
|
||||
|
||||
@ -224,12 +224,14 @@ exits abnormally.
|
||||
File flags cannot be set by
|
||||
.Xr fchflags 2
|
||||
over a NFS file system. Other file systems do not have a concept of flags.
|
||||
The
|
||||
.Nm
|
||||
will only warn when flags could not be set on a file system
|
||||
utility will only warn when flags could not be set on a file system
|
||||
that does not support them.
|
||||
.Pp
|
||||
The
|
||||
.Nm
|
||||
with
|
||||
utility with
|
||||
.Fl v
|
||||
falsely says a file is copied when
|
||||
.Fl C
|
||||
|
||||
@ -67,14 +67,16 @@
|
||||
.Ar
|
||||
.Ek
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
attempts to detect features of the named C program files
|
||||
utility attempts to detect features of the named C program files
|
||||
that are likely to be bugs, to be non-portable, or to be
|
||||
wasteful.
|
||||
It also performs stricter type checking than does
|
||||
the C compiler.
|
||||
The
|
||||
.Nm
|
||||
runs the C preprocessor as its first phase, with the
|
||||
utility runs the C preprocessor as its first phase, with the
|
||||
preprocessor symbol
|
||||
.Dq Dv lint
|
||||
defined to allow certain questionable code to be altered
|
||||
@ -119,14 +121,16 @@ files are analogous to the
|
||||
from
|
||||
.Pa .c
|
||||
files.
|
||||
The
|
||||
.Nm
|
||||
also accepts special libraries specified with the
|
||||
utility also accepts special libraries specified with the
|
||||
.Fl l
|
||||
option, which contain definitions of library routines and
|
||||
variables.
|
||||
.Pp
|
||||
The
|
||||
.Nm
|
||||
takes all the
|
||||
utility takes all the
|
||||
.Pa .c , .ln ,
|
||||
and
|
||||
.Pa llib-l Ns Ar library Ns Pa .ln
|
||||
@ -357,8 +361,9 @@ and
|
||||
before searching the standard place.
|
||||
.It Fl F
|
||||
Print pathnames of files.
|
||||
The
|
||||
.Nm
|
||||
normally prints the filename without the path.
|
||||
utility normally prints the filename without the path.
|
||||
.It Fl H
|
||||
If a complaint stems from an included file
|
||||
.Nm
|
||||
@ -405,8 +410,9 @@ and ids can be found in
|
||||
.Ss Input Grammar
|
||||
.Nm Ns 's
|
||||
first pass reads standard C source files.
|
||||
The
|
||||
.Nm
|
||||
recognizes the following C comments as commands.
|
||||
utility recognizes the following C comments as commands.
|
||||
.Bl -tag -width indent
|
||||
.It Li /* ARGSUSED Ns Ar n Li */
|
||||
makes
|
||||
|
||||
@ -45,8 +45,9 @@
|
||||
.Op Fl v
|
||||
.Op Ar file
|
||||
.Sh DESCRIPTION
|
||||
.Nm Xstr
|
||||
maintains a file
|
||||
The
|
||||
.Nm
|
||||
utility maintains a file
|
||||
.Pa strings
|
||||
into which strings in component parts of a large program are hashed.
|
||||
These strings are replaced with references to this common area.
|
||||
@ -56,11 +57,9 @@ are also read-only.
|
||||
Available options:
|
||||
.Bl -tag -width Ds
|
||||
.It Fl
|
||||
.Nm Xstr
|
||||
reads from the standard input.
|
||||
Read from the standard input.
|
||||
.It Fl c
|
||||
.Nm Xstr
|
||||
will extract the strings from the C source
|
||||
Extract the strings from the C source
|
||||
.Ar file
|
||||
or the standard input
|
||||
.Pq Fl ,
|
||||
@ -98,8 +97,9 @@ of the program.
|
||||
If possible, the array can be made read-only (shared) saving
|
||||
space and swap overhead.
|
||||
.Pp
|
||||
.Nm Xstr
|
||||
can also be used on a single file.
|
||||
The
|
||||
.Nm
|
||||
utility can also be used on a single file.
|
||||
A command
|
||||
.Bd -literal -offset indent
|
||||
xstr name
|
||||
@ -128,8 +128,9 @@ cc \-c x.c
|
||||
mv x.o name.o
|
||||
.Ed
|
||||
.Pp
|
||||
.Nm Xstr
|
||||
does not touch the file
|
||||
The
|
||||
.Nm
|
||||
utility does not touch the file
|
||||
.Pa strings
|
||||
unless new items are added, thus
|
||||
.Xr make 1
|
||||
|
||||
@ -50,14 +50,16 @@
|
||||
.Op Fl p Ar symbol_prefix
|
||||
.Ar filename
|
||||
.Sh DESCRIPTION
|
||||
.Nm Yacc
|
||||
reads the grammar specification in the file
|
||||
The
|
||||
.Nm
|
||||
utility reads the grammar specification in the file
|
||||
.Ar filename
|
||||
and generates an LR(1) parser for it.
|
||||
The parsers consist of a set of LALR(1) parsing tables and a driver routine
|
||||
written in the C programming language.
|
||||
.Nm Yacc
|
||||
normally writes the parse tables and the driver routine to the file
|
||||
The
|
||||
.Nm
|
||||
utility normally writes the parse tables and the driver routine to the file
|
||||
.Pa y.tab.c .
|
||||
.Pp
|
||||
The following options are available:
|
||||
|
||||
@ -42,8 +42,9 @@
|
||||
.Nm
|
||||
.Op Ar expletive
|
||||
.Sh DESCRIPTION
|
||||
.Nm Yes
|
||||
outputs
|
||||
The
|
||||
.Nm
|
||||
utility outputs
|
||||
.Ar expletive ,
|
||||
or, by default,
|
||||
.Dq y ,
|
||||
|
||||
@ -42,8 +42,9 @@
|
||||
.Nm
|
||||
.Fl x
|
||||
.Sh DESCRIPTION
|
||||
.Nm Ypcat
|
||||
prints out the values of all keys from the
|
||||
The
|
||||
.Nm
|
||||
utility prints out the values of all keys from the
|
||||
.Tn YP
|
||||
database specified by
|
||||
.Ar mapname ,
|
||||
|
||||
@ -43,8 +43,9 @@
|
||||
.Nm
|
||||
.Fl x
|
||||
.Sh DESCRIPTION
|
||||
.Nm Ypmatch
|
||||
prints out the values of one or more keys from the
|
||||
The
|
||||
.Nm
|
||||
utility prints out the values of one or more keys from the
|
||||
.Tn YP
|
||||
database specified by
|
||||
.Ar mapname ,
|
||||
|
||||
@ -46,8 +46,9 @@
|
||||
.Nm
|
||||
.Fl x
|
||||
.Sh DESCRIPTION
|
||||
.Nm Ypwhich
|
||||
tells which
|
||||
The
|
||||
.Nm
|
||||
utility tells which
|
||||
.Tn YP
|
||||
server supplies
|
||||
.Tn YP
|
||||
|
||||
Loading…
Reference in New Issue
Block a user