Mechanically kill hard sentence breaks.
This commit is contained in:
parent
f97d4ddfed
commit
6a3e8b0adc
@ -60,7 +60,8 @@ object files that are produced.
|
|||||||
.It Fl D Ar name Ns Op = Ns Ar value
|
.It Fl D Ar name Ns Op = Ns Ar value
|
||||||
Define name as if by a C-language
|
Define name as if by a C-language
|
||||||
.Ic #define
|
.Ic #define
|
||||||
directive. If
|
directive.
|
||||||
|
If
|
||||||
no
|
no
|
||||||
.Dq = Ns Ar value
|
.Dq = Ns Ar value
|
||||||
is given, a value of 1 will be used.
|
is given, a value of 1 will be used.
|
||||||
@ -69,11 +70,13 @@ translation as specified by
|
|||||||
.St -p1003.2
|
.St -p1003.2
|
||||||
you need to define
|
you need to define
|
||||||
.Dv _POSIX_SOURCE
|
.Dv _POSIX_SOURCE
|
||||||
either in the source or using this option. The
|
either in the source or using this option.
|
||||||
|
The
|
||||||
.Fl D
|
.Fl D
|
||||||
option has lower precedence than the
|
option has lower precedence than the
|
||||||
.Fl U
|
.Fl U
|
||||||
option. That is, if
|
option.
|
||||||
|
That is, if
|
||||||
.Ar name
|
.Ar name
|
||||||
is used in both a
|
is used in both a
|
||||||
.Fl U
|
.Fl U
|
||||||
@ -81,7 +84,8 @@ and a
|
|||||||
.Fl D
|
.Fl D
|
||||||
option,
|
option,
|
||||||
.Ar name
|
.Ar name
|
||||||
will be undefined regardless of the order of the options. The
|
will be undefined regardless of the order of the options.
|
||||||
|
The
|
||||||
.Fl D
|
.Fl D
|
||||||
option may be specified more than once.
|
option may be specified more than once.
|
||||||
.It Fl E
|
.It Fl E
|
||||||
@ -93,20 +97,24 @@ Produce symbolic information in the object or executable files.
|
|||||||
Change the algorithm for searching for headers whose names are not
|
Change the algorithm for searching for headers whose names are not
|
||||||
absolute pathnames to look in the directory named by the
|
absolute pathnames to look in the directory named by the
|
||||||
.Ar directory
|
.Ar directory
|
||||||
pathname before looking in the usual places. Thus, headers whose
|
pathname before looking in the usual places.
|
||||||
|
Thus, headers whose
|
||||||
names are enclosed in double-quotes ("") will be searched for first
|
names are enclosed in double-quotes ("") will be searched for first
|
||||||
in the directory of the file with the
|
in the directory of the file with the
|
||||||
.Ic #include
|
.Ic #include
|
||||||
line, then in
|
line, then in
|
||||||
directories named in
|
directories named in
|
||||||
.Fl I
|
.Fl I
|
||||||
options, and last in the usual places. For
|
options, and last in the usual places.
|
||||||
|
For
|
||||||
headers whose names are enclosed in angle brackets (<>), the header
|
headers whose names are enclosed in angle brackets (<>), the header
|
||||||
will be searched for only in directories named in
|
will be searched for only in directories named in
|
||||||
.Fl I
|
.Fl I
|
||||||
options and then in the usual places. Directories named in
|
options and then in the usual places.
|
||||||
|
Directories named in
|
||||||
.Fl I
|
.Fl I
|
||||||
options shall be searched in the order specified. The
|
options shall be searched in the order specified.
|
||||||
|
The
|
||||||
.Fl I
|
.Fl I
|
||||||
option may be specified more than once.
|
option may be specified more than once.
|
||||||
.It Fl L Ar directory
|
.It Fl L Ar directory
|
||||||
@ -114,9 +122,11 @@ Change the algorithm of searching for the libraries named in the
|
|||||||
.Fl l
|
.Fl l
|
||||||
objects to look in the directory named by the
|
objects to look in the directory named by the
|
||||||
.Ar directory
|
.Ar directory
|
||||||
pathname before looking in the usual places. Directories named in
|
pathname before looking in the usual places.
|
||||||
|
Directories named in
|
||||||
.Fl L
|
.Fl L
|
||||||
options will be searched in the order specified. The
|
options will be searched in the order specified.
|
||||||
|
The
|
||||||
.Fl L
|
.Fl L
|
||||||
option may be specified more than once.
|
option may be specified more than once.
|
||||||
.It Fl o Ar outfile
|
.It Fl o Ar outfile
|
||||||
@ -141,11 +151,14 @@ option may be specified more than once.
|
|||||||
.Pp
|
.Pp
|
||||||
An operand is either in the form of a pathname or the form
|
An operand is either in the form of a pathname or the form
|
||||||
.Fl l
|
.Fl l
|
||||||
library. At least one operand of the pathname form needs to be
|
library.
|
||||||
specified. Supported operands are of the form:
|
At least one operand of the pathname form needs to be
|
||||||
|
specified.
|
||||||
|
Supported operands are of the form:
|
||||||
.Bl -tag -offset indent -width "-l library"
|
.Bl -tag -offset indent -width "-l library"
|
||||||
.It Ar file Ns Pa .c
|
.It Ar file Ns Pa .c
|
||||||
A C-language source file to be compiled and optionally linked. The
|
A C-language source file to be compiled and optionally linked.
|
||||||
|
The
|
||||||
operand must be of this form if the
|
operand must be of this form if the
|
||||||
.Fl c
|
.Fl c
|
||||||
option is used.
|
option is used.
|
||||||
|
@ -128,7 +128,7 @@ or negative integer.
|
|||||||
``Paskha'', is Orthodox Easter for this year, and may be followed by a
|
``Paskha'', is Orthodox Easter for this year, and may be followed by a
|
||||||
positive or negative integer.
|
positive or negative integer.
|
||||||
.Pp
|
.Pp
|
||||||
Weekdays may be followed by ``-4'' ... ``+5'' (aliases for
|
Weekdays may be followed by ``-4'' ...\& ``+5'' (aliases for
|
||||||
last, first, second, third, fourth) for moving events like
|
last, first, second, third, fourth) for moving events like
|
||||||
``the last Monday in April''.
|
``the last Monday in April''.
|
||||||
.Pp
|
.Pp
|
||||||
@ -217,7 +217,7 @@ Calendar of events in France.
|
|||||||
.It Pa calendar.german
|
.It Pa calendar.german
|
||||||
Calendar of events in Germany.
|
Calendar of events in Germany.
|
||||||
.It Pa calendar.history
|
.It Pa calendar.history
|
||||||
Everything else, mostly U.S. historical events.
|
Everything else, mostly U.S.\& historical events.
|
||||||
.It Pa calendar.holiday
|
.It Pa calendar.holiday
|
||||||
Other holidays, including the not-well-known, obscure, and
|
Other holidays, including the not-well-known, obscure, and
|
||||||
.Em really
|
.Em really
|
||||||
@ -236,7 +236,7 @@ Russian calendar.
|
|||||||
.It Pa calendar.southafrica
|
.It Pa calendar.southafrica
|
||||||
Calendar of events in South Africa.
|
Calendar of events in South Africa.
|
||||||
.It Pa calendar.usholiday
|
.It Pa calendar.usholiday
|
||||||
U.S. holidays.
|
U.S.\& holidays.
|
||||||
This calendar should be updated yearly by the local system administrator
|
This calendar should be updated yearly by the local system administrator
|
||||||
so that roving holidays are set correctly for the current year.
|
so that roving holidays are set correctly for the current year.
|
||||||
.It Pa calendar.world
|
.It Pa calendar.world
|
||||||
|
@ -90,11 +90,11 @@ size changes.
|
|||||||
Delimiters checked are:
|
Delimiters checked are:
|
||||||
.Bl -enum
|
.Bl -enum
|
||||||
.It
|
.It
|
||||||
Font changes using \efx ... \efP.
|
Font changes using \efx ...\& \efP.
|
||||||
.It
|
.It
|
||||||
Size changes using \esx ... \es0.
|
Size changes using \esx ...\& \es0.
|
||||||
.It
|
.It
|
||||||
Macros that come in open ... close forms, for example,
|
Macros that come in open ...\& close forms, for example,
|
||||||
the .TS and .TE macros which must always come in pairs.
|
the .TS and .TE macros which must always come in pairs.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -163,7 +163,8 @@ Both of these fields should be unique across the system (and often
|
|||||||
across a group of systems) as they control file access.
|
across a group of systems) as they control file access.
|
||||||
.Pp
|
.Pp
|
||||||
While it is possible to have multiple entries with identical login names
|
While it is possible to have multiple entries with identical login names
|
||||||
and/or identical user id's, it is usually a mistake to do so. Routines
|
and/or identical user id's, it is usually a mistake to do so.
|
||||||
|
Routines
|
||||||
that manipulate these files will often return only one of the multiple
|
that manipulate these files will often return only one of the multiple
|
||||||
entries, and that one by random selection.
|
entries, and that one by random selection.
|
||||||
.Pp
|
.Pp
|
||||||
@ -447,7 +448,8 @@ When invoked by the super-user on the NIS master server,
|
|||||||
allows unrestricted changes to the NIS passwd maps using dedicated,
|
allows unrestricted changes to the NIS passwd maps using dedicated,
|
||||||
non-RPC-based mechanism (in this case, a
|
non-RPC-based mechanism (in this case, a
|
||||||
.Ux
|
.Ux
|
||||||
domain socket). The
|
domain socket).
|
||||||
|
The
|
||||||
.Fl o
|
.Fl o
|
||||||
flag can be used to force
|
flag can be used to force
|
||||||
.Nm
|
.Nm
|
||||||
|
@ -128,7 +128,8 @@ If it is increasing,
|
|||||||
continues to use the existing code dictionary.
|
continues to use the existing code dictionary.
|
||||||
However, if the compression ratio decreases,
|
However, if the compression ratio decreases,
|
||||||
.Nm
|
.Nm
|
||||||
discards the table of substrings and rebuilds it from scratch. This allows
|
discards the table of substrings and rebuilds it from scratch.
|
||||||
|
This allows
|
||||||
the algorithm to adapt to the next "block" of the file.
|
the algorithm to adapt to the next "block" of the file.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
|
@ -72,11 +72,13 @@ This is the default.
|
|||||||
.It Fl a
|
.It Fl a
|
||||||
Display an entry for each file in a file hierarchy.
|
Display an entry for each file in a file hierarchy.
|
||||||
.It Fl h
|
.It Fl h
|
||||||
"Human-readable" output. Use unit suffixes: Byte, Kilobyte, Megabyte,
|
"Human-readable" output.
|
||||||
|
Use unit suffixes: Byte, Kilobyte, Megabyte,
|
||||||
Gigabyte, Terabyte and Petabyte
|
Gigabyte, Terabyte and Petabyte
|
||||||
.It Fl r
|
.It Fl r
|
||||||
Generate messages about directories that cannot be read, files
|
Generate messages about directories that cannot be read, files
|
||||||
that cannot be opened, and so on. This is the default case.
|
that cannot be opened, and so on.
|
||||||
|
This is the default case.
|
||||||
This option exists solely for conformance with
|
This option exists solely for conformance with
|
||||||
.St -xpg4 .
|
.St -xpg4 .
|
||||||
.It Fl s
|
.It Fl s
|
||||||
|
128
usr.bin/ee/ee.1
128
usr.bin/ee/ee.1
@ -20,9 +20,11 @@
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility
|
utility
|
||||||
is a simple screen oriented text editor. It is always in text insertion
|
is a simple screen oriented text editor.
|
||||||
|
It is always in text insertion
|
||||||
mode unless there is a prompt at the bottom of the terminal, or a
|
mode unless there is a prompt at the bottom of the terminal, or a
|
||||||
menu present (in a box in the middle of the terminal). The
|
menu present (in a box in the middle of the terminal).
|
||||||
|
The
|
||||||
.Nm ree
|
.Nm ree
|
||||||
utility is the same as
|
utility is the same as
|
||||||
.Nm ,
|
.Nm ,
|
||||||
@ -33,12 +35,14 @@ For
|
|||||||
.Nm
|
.Nm
|
||||||
to work properly, the environment variable
|
to work properly, the environment variable
|
||||||
.Ev TERM
|
.Ev TERM
|
||||||
must be set to indicate the type of terminal being used. For
|
must be set to indicate the type of terminal being used.
|
||||||
|
For
|
||||||
example, for an
|
example, for an
|
||||||
.Tn HP 700/92
|
.Tn HP 700/92
|
||||||
terminal, the
|
terminal, the
|
||||||
.Ev TERM
|
.Ev TERM
|
||||||
variable should be set to "70092". See your System Administrator if
|
variable should be set to "70092".
|
||||||
|
See your System Administrator if
|
||||||
you need more information.
|
you need more information.
|
||||||
.Pp
|
.Pp
|
||||||
The following options are available:
|
The following options are available:
|
||||||
@ -67,7 +71,8 @@ arrow keys, etc.).
|
|||||||
Since not all terminals have function keys,
|
Since not all terminals have function keys,
|
||||||
.Nm
|
.Nm
|
||||||
has the basic cursor movement functions assigned to control keys as
|
has the basic cursor movement functions assigned to control keys as
|
||||||
well as more intuitive keys on the keyboard when available. For
|
well as more intuitive keys on the keyboard when available.
|
||||||
|
For
|
||||||
instance, to move the cursor up, the user can use the up arrow key,
|
instance, to move the cursor up, the user can use the up arrow key,
|
||||||
or
|
or
|
||||||
.Em ^u .
|
.Em ^u .
|
||||||
@ -126,9 +131,11 @@ Pop up menu.
|
|||||||
.Ss "EMACS keys mode"
|
.Ss "EMACS keys mode"
|
||||||
Since many shells provide an Emacs mode (for cursor movement and other editing
|
Since many shells provide an Emacs mode (for cursor movement and other editing
|
||||||
operations), some bindings that may be more useful for people familiar with
|
operations), some bindings that may be more useful for people familiar with
|
||||||
those bindings have been provided. These are accessible via the
|
those bindings have been provided.
|
||||||
|
These are accessible via the
|
||||||
.Em settings
|
.Em settings
|
||||||
menu, or via the initialization file (see below). The mappings are as follows:
|
menu, or via the initialization file (see below).
|
||||||
|
The mappings are as follows:
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It ^a
|
.It ^a
|
||||||
Move to the beginning of the line.
|
Move to the beginning of the line.
|
||||||
@ -196,10 +203,12 @@ Move the cursor in the direction indicated.
|
|||||||
.El
|
.El
|
||||||
.Ss Commands
|
.Ss Commands
|
||||||
Some operations require more information than a single keystroke can
|
Some operations require more information than a single keystroke can
|
||||||
provide. For the most basic operations, there is a menu that can be
|
provide.
|
||||||
|
For the most basic operations, there is a menu that can be
|
||||||
obtained by pressing the
|
obtained by pressing the
|
||||||
.Tn ESC
|
.Tn ESC
|
||||||
key. The same operations, and more can be performed by obtaining the
|
key.
|
||||||
|
The same operations, and more can be performed by obtaining the
|
||||||
command prompt (^c) and typing in one of the commands below.
|
command prompt (^c) and typing in one of the commands below.
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It ! Ns Ar cmd
|
.It ! Ns Ar cmd
|
||||||
@ -242,8 +251,10 @@ key (or
|
|||||||
.Em ^[
|
.Em ^[
|
||||||
if no
|
if no
|
||||||
.Em escape
|
.Em escape
|
||||||
key is present). When in the menu, the escape key can be
|
key is present).
|
||||||
used to leave the menu without performing any operations. Use the up and
|
When in the menu, the escape key can be
|
||||||
|
used to leave the menu without performing any operations.
|
||||||
|
Use the up and
|
||||||
down arrow keys, or
|
down arrow keys, or
|
||||||
.Em ^u
|
.Em ^u
|
||||||
for moving up and
|
for moving up and
|
||||||
@ -272,11 +283,14 @@ the editor to a print command (see the section
|
|||||||
.It redraw screen
|
.It redraw screen
|
||||||
Provide a means to repaint the screen if the screen has been corrupted.
|
Provide a means to repaint the screen if the screen has been corrupted.
|
||||||
.It settings
|
.It settings
|
||||||
Show the current values of the operating modes, and right margin. By
|
Show the current values of the operating modes, and right margin.
|
||||||
|
By
|
||||||
pressing return when the cursor is on a particular item, the value can be
|
pressing return when the cursor is on a particular item, the value can be
|
||||||
changed. To leave this menu, press the
|
changed.
|
||||||
|
To leave this menu, press the
|
||||||
.Em escape
|
.Em escape
|
||||||
key. (See
|
key.
|
||||||
|
(See
|
||||||
.Sx Modes
|
.Sx Modes
|
||||||
below.)
|
below.)
|
||||||
.It search
|
.It search
|
||||||
@ -304,7 +318,8 @@ A paragraph may be formatted two ways: explicitly by choosing the
|
|||||||
menu item, or by setting
|
menu item, or by setting
|
||||||
.Nm
|
.Nm
|
||||||
to automatically
|
to automatically
|
||||||
format paragraphs. The automatic mode may be set via a menu, or via the
|
format paragraphs.
|
||||||
|
The automatic mode may be set via a menu, or via the
|
||||||
initialization file.
|
initialization file.
|
||||||
.Pp
|
.Pp
|
||||||
There are three states for text operation in
|
There are three states for text operation in
|
||||||
@ -312,29 +327,34 @@ There are three states for text operation in
|
|||||||
free-form, margins,
|
free-form, margins,
|
||||||
and automatic formatting.
|
and automatic formatting.
|
||||||
.Pp
|
.Pp
|
||||||
"Free-form" is best used for things like programming. There are no
|
"Free-form" is best used for things like programming.
|
||||||
|
There are no
|
||||||
restrictions on the length of lines, and no formatting takes place.
|
restrictions on the length of lines, and no formatting takes place.
|
||||||
.Pp
|
.Pp
|
||||||
"Margins" allows the user to type in text without having to worry about going
|
"Margins" allows the user to type in text without having to worry about going
|
||||||
beyond the right margin (the right margin may be set in the
|
beyond the right margin (the right margin may be set in the
|
||||||
.Em settings
|
.Em settings
|
||||||
menu, the default is for the margin to be the right edge of the
|
menu, the default is for the margin to be the right edge of the
|
||||||
terminal). This is the mode that allows the
|
terminal).
|
||||||
|
This is the mode that allows the
|
||||||
.Em format paragraph
|
.Em format paragraph
|
||||||
menu item to work.
|
menu item to work.
|
||||||
.Pp
|
.Pp
|
||||||
"Automatic formatting" provides word-processor-like behavior. The user
|
"Automatic formatting" provides word-processor-like behavior.
|
||||||
|
The user
|
||||||
may type in text, while
|
may type in text, while
|
||||||
.Nm
|
.Nm
|
||||||
will make sure the entire paragraph fits
|
will make sure the entire paragraph fits
|
||||||
within the width of the terminal every time the user inserts a space after
|
within the width of the terminal every time the user inserts a space after
|
||||||
typing or deleting text. Margin observation must also be enabled in order for
|
typing or deleting text.
|
||||||
|
Margin observation must also be enabled in order for
|
||||||
automatic formatting to occur.
|
automatic formatting to occur.
|
||||||
.Ss Modes
|
.Ss Modes
|
||||||
Although
|
Although
|
||||||
.Nm
|
.Nm
|
||||||
is a 'modeless' editor (it is in text insertion mode all the
|
is a 'modeless' editor (it is in text insertion mode all the
|
||||||
time), there are modes in some of the things it does. These include:
|
time), there are modes in some of the things it does.
|
||||||
|
These include:
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It tab expansion
|
.It tab expansion
|
||||||
Tabs may be inserted as a single tab character, or replaced with spaces.
|
Tabs may be inserted as a single tab character, or replaced with spaces.
|
||||||
@ -348,7 +368,7 @@ While typing in text, the editor can try to keep it looking reasonably well
|
|||||||
within the width of the screen.
|
within the width of the screen.
|
||||||
.It eightbit characters
|
.It eightbit characters
|
||||||
Toggle whether eight bit characters are displayed as their value in angle
|
Toggle whether eight bit characters are displayed as their value in angle
|
||||||
brackets (e.g. "<220>") or as a character.
|
brackets (e.g.\& "<220>") or as a character.
|
||||||
.It info window
|
.It info window
|
||||||
A window showing the keyboard operations that can be performed can be
|
A window showing the keyboard operations that can be performed can be
|
||||||
displayed or not.
|
displayed or not.
|
||||||
@ -356,7 +376,8 @@ displayed or not.
|
|||||||
Control keys may be given bindings similar to emacs, or not.
|
Control keys may be given bindings similar to emacs, or not.
|
||||||
.It 16 bit characters
|
.It 16 bit characters
|
||||||
Toggles whether sixteen bit characters are handled as one 16-bit quantities or
|
Toggles whether sixteen bit characters are handled as one 16-bit quantities or
|
||||||
two 8-bit quantities. This works primarily with the Chinese Big 5 code set.
|
two 8-bit quantities.
|
||||||
|
This works primarily with the Chinese Big 5 code set.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
You may set these modes via the initialization file (see below), or with a
|
You may set these modes via the initialization file (see below), or with a
|
||||||
@ -374,7 +395,8 @@ command.
|
|||||||
Using
|
Using
|
||||||
.Nm spell ,
|
.Nm spell ,
|
||||||
the words that are not recognized will be placed at the top
|
the words that are not recognized will be placed at the top
|
||||||
of the file. For the
|
of the file.
|
||||||
|
For the
|
||||||
.Nm ispell
|
.Nm ispell
|
||||||
option, the file is written to disk,
|
option, the file is written to disk,
|
||||||
then
|
then
|
||||||
@ -391,13 +413,15 @@ initialization command
|
|||||||
.Em printcommand
|
.Em printcommand
|
||||||
(see the section
|
(see the section
|
||||||
.Sx Initializing ee from a file
|
.Sx Initializing ee from a file
|
||||||
below). The default is to send the contents to
|
below).
|
||||||
|
The default is to send the contents to
|
||||||
.Xr lp 1 .
|
.Xr lp 1 .
|
||||||
.Pp
|
.Pp
|
||||||
Whatever the user assigns to
|
Whatever the user assigns to
|
||||||
.Em printcommand
|
.Em printcommand
|
||||||
must take input from
|
must take input from
|
||||||
standard input. See your system administrator for more details.
|
standard input.
|
||||||
|
See your system administrator for more details.
|
||||||
.Ss "Shell operations"
|
.Ss "Shell operations"
|
||||||
Shell commands can be executed from within
|
Shell commands can be executed from within
|
||||||
.Nm
|
.Nm
|
||||||
@ -408,25 +432,31 @@ item in the
|
|||||||
menu, or by placing an exclamation mark ("!") before the command to
|
menu, or by placing an exclamation mark ("!") before the command to
|
||||||
execute at the
|
execute at the
|
||||||
.Em command:
|
.Em command:
|
||||||
prompt. Additionally, the user may direct the contents of the edit buffer
|
prompt.
|
||||||
|
Additionally, the user may direct the contents of the edit buffer
|
||||||
out to a shell operation (via a pipe) by using the left angle bracket
|
out to a shell operation (via a pipe) by using the left angle bracket
|
||||||
(">"), followed by a "!" and the shell command to execute. The output of
|
(">"), followed by a "!" and the shell command to execute.
|
||||||
|
The output of
|
||||||
a shell operation can also be directed into the edit buffer by using a
|
a shell operation can also be directed into the edit buffer by using a
|
||||||
right angle bracket ("<") before the exclamation mark. These can even be
|
right angle bracket ("<") before the exclamation mark.
|
||||||
|
These can even be
|
||||||
used together to send output to a shell operation and read back the
|
used together to send output to a shell operation and read back the
|
||||||
results into the editor. So, if the editor contained a list of words
|
results into the editor.
|
||||||
|
So, if the editor contained a list of words
|
||||||
to be sorted, they could be sorted by typing the following at the command
|
to be sorted, they could be sorted by typing the following at the command
|
||||||
prompt:
|
prompt:
|
||||||
.Dl ><!sort
|
.Dl ><!sort
|
||||||
This would send the contents of the editor to be piped into the
|
This would send the contents of the editor to be piped into the
|
||||||
.Xr sort 1
|
.Xr sort 1
|
||||||
utility and the result would be placed into the edit buffer at the current
|
utility and the result would be placed into the edit buffer at the current
|
||||||
cursor location. The old information would have to be deleted by the user.
|
cursor location.
|
||||||
|
The old information would have to be deleted by the user.
|
||||||
.Ss "Initializing ee from a file"
|
.Ss "Initializing ee from a file"
|
||||||
Since different users have different preferences,
|
Since different users have different preferences,
|
||||||
.Nm
|
.Nm
|
||||||
allows some
|
allows some
|
||||||
slight configurability. There are three possible locations for an
|
slight configurability.
|
||||||
|
There are three possible locations for an
|
||||||
initialization file for
|
initialization file for
|
||||||
.Nm :
|
.Nm :
|
||||||
the file
|
the file
|
||||||
@ -436,7 +466,8 @@ the file
|
|||||||
in the user's home directory, or the file
|
in the user's home directory, or the file
|
||||||
.Pa .init.ee
|
.Pa .init.ee
|
||||||
in the current directory (if different from the home
|
in the current directory (if different from the home
|
||||||
directory). This allows system administrators to set some preferences for
|
directory).
|
||||||
|
This allows system administrators to set some preferences for
|
||||||
the users on a system-wide basis (for example, the
|
the users on a system-wide basis (for example, the
|
||||||
.Em print
|
.Em print
|
||||||
command),
|
command),
|
||||||
@ -518,38 +549,48 @@ the editor (see
|
|||||||
.Sx Initializing ee from a file
|
.Sx Initializing ee from a file
|
||||||
above) to a file named
|
above) to a file named
|
||||||
.Pa .init.ee
|
.Pa .init.ee
|
||||||
in the current directory or the user's home directory. If a file named
|
in the current directory or the user's home directory.
|
||||||
|
If a file named
|
||||||
.Pa .init.ee
|
.Pa .init.ee
|
||||||
already exists, it will be renamed
|
already exists, it will be renamed
|
||||||
.Pa .init.ee.old .
|
.Pa .init.ee.old .
|
||||||
.Sh CAVEATS
|
.Sh CAVEATS
|
||||||
THIS MATERIAL IS PROVIDED "AS IS". THERE ARE
|
THIS MATERIAL IS PROVIDED "AS IS".
|
||||||
|
THERE ARE
|
||||||
NO WARRANTIES OF ANY KIND WITH REGARD TO THIS
|
NO WARRANTIES OF ANY KIND WITH REGARD TO THIS
|
||||||
MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE
|
MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
||||||
FITNESS FOR A PARTICULAR PURPOSE. Neither
|
FITNESS FOR A PARTICULAR PURPOSE.
|
||||||
|
Neither
|
||||||
Hewlett-Packard nor Hugh Mahon shall be liable
|
Hewlett-Packard nor Hugh Mahon shall be liable
|
||||||
for errors contained herein, nor for
|
for errors contained herein, nor for
|
||||||
incidental or consequential damages in
|
incidental or consequential damages in
|
||||||
connection with the furnishing, performance or
|
connection with the furnishing, performance or
|
||||||
use of this material. Neither Hewlett-Packard
|
use of this material.
|
||||||
|
Neither Hewlett-Packard
|
||||||
nor Hugh Mahon assumes any responsibility for
|
nor Hugh Mahon assumes any responsibility for
|
||||||
the use or reliability of this software or
|
the use or reliability of this software or
|
||||||
documentation. This software and
|
documentation.
|
||||||
documentation is totally UNSUPPORTED. There
|
This software and
|
||||||
is no support contract available. Hewlett-Packard
|
documentation is totally UNSUPPORTED.
|
||||||
|
There
|
||||||
|
is no support contract available.
|
||||||
|
Hewlett-Packard
|
||||||
has done NO Quality Assurance on ANY
|
has done NO Quality Assurance on ANY
|
||||||
of the program or documentation. You may find
|
of the program or documentation.
|
||||||
|
You may find
|
||||||
the quality of the materials inferior to
|
the quality of the materials inferior to
|
||||||
supported materials.
|
supported materials.
|
||||||
.Pp
|
.Pp
|
||||||
Always make a copy of files that cannot be easily reproduced before
|
Always make a copy of files that cannot be easily reproduced before
|
||||||
editing. Save files early, and save often.
|
editing.
|
||||||
|
Save files early, and save often.
|
||||||
.Ss "International Code Set Support"
|
.Ss "International Code Set Support"
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility supports single-byte character code sets (eight-bit clean), or the
|
utility supports single-byte character code sets (eight-bit clean), or the
|
||||||
Chinese Big-5 code set. (Other multi-byte code sets may function, but the
|
Chinese Big-5 code set.
|
||||||
|
(Other multi-byte code sets may function, but the
|
||||||
reason Big-5 works is that a two-byte character also takes up two columns on
|
reason Big-5 works is that a two-byte character also takes up two columns on
|
||||||
the screen.)
|
the screen.)
|
||||||
.Sh WARNINGS
|
.Sh WARNINGS
|
||||||
@ -569,7 +610,8 @@ was developed by
|
|||||||
.Pp
|
.Pp
|
||||||
This software and documentation contains
|
This software and documentation contains
|
||||||
proprietary information which is protected by
|
proprietary information which is protected by
|
||||||
copyright. All rights are reserved.
|
copyright.
|
||||||
|
All rights are reserved.
|
||||||
.Pp
|
.Pp
|
||||||
Copyright (c) 1990, 1991, 1992, 1993, 1995, 1996 Hugh Mahon.
|
Copyright (c) 1990, 1991, 1992, 1993, 1995, 1996 Hugh Mahon.
|
||||||
.Sh "SEE ALSO"
|
.Sh "SEE ALSO"
|
||||||
|
@ -31,14 +31,17 @@ is a
|
|||||||
.Em very
|
.Em very
|
||||||
simple encryption program, working on a
|
simple encryption program, working on a
|
||||||
.Dq secret-key
|
.Dq secret-key
|
||||||
basis. It operates as a filter, i. e. it encrypts or decrypts a
|
basis.
|
||||||
|
It operates as a filter, i.e.,
|
||||||
|
it encrypts or decrypts a
|
||||||
stream of data from standard input, and writes the result to standard
|
stream of data from standard input, and writes the result to standard
|
||||||
output.
|
output.
|
||||||
Since its operation is fully symmetrical, feeding the encrypted data
|
Since its operation is fully symmetrical, feeding the encrypted data
|
||||||
stream again through the engine (using the same secret key) will
|
stream again through the engine (using the same secret key) will
|
||||||
decrypt it.
|
decrypt it.
|
||||||
.Pp
|
.Pp
|
||||||
There are several ways to provide the secret key to the program. By
|
There are several ways to provide the secret key to the program.
|
||||||
|
By
|
||||||
default, the program prompts the user on the controlling terminal for
|
default, the program prompts the user on the controlling terminal for
|
||||||
the key, using
|
the key, using
|
||||||
.Xr getpass 3 .
|
.Xr getpass 3 .
|
||||||
@ -47,7 +50,8 @@ This is the only safe way of providing it.
|
|||||||
Alternatively, the key can be provided as the sole command-line
|
Alternatively, the key can be provided as the sole command-line
|
||||||
argument
|
argument
|
||||||
.Ar password
|
.Ar password
|
||||||
when starting the program. Obviously, this way the key can easily be
|
when starting the program.
|
||||||
|
Obviously, this way the key can easily be
|
||||||
spotted by other users running
|
spotted by other users running
|
||||||
.Xr ps 1 .
|
.Xr ps 1 .
|
||||||
As yet another alternative,
|
As yet another alternative,
|
||||||
@ -73,7 +77,8 @@ little more secure, but incompatible with other implementations.
|
|||||||
.Ss Warning
|
.Ss Warning
|
||||||
The cryptographic value of
|
The cryptographic value of
|
||||||
.Nm
|
.Nm
|
||||||
is rather small. This program is only provided here for compatibility
|
is rather small.
|
||||||
|
This program is only provided here for compatibility
|
||||||
with other operating systems that also provide an implementation
|
with other operating systems that also provide an implementation
|
||||||
(usually called
|
(usually called
|
||||||
.Xr crypt 1
|
.Xr crypt 1
|
||||||
@ -121,6 +126,7 @@ Implementations of
|
|||||||
.Nm crypt
|
.Nm crypt
|
||||||
are very common among
|
are very common among
|
||||||
.Ux
|
.Ux
|
||||||
operating systems. This implementation has been taken from the
|
operating systems.
|
||||||
|
This implementation has been taken from the
|
||||||
.Em Cryptbreakers Workbench
|
.Em Cryptbreakers Workbench
|
||||||
which is in the public domain.
|
which is in the public domain.
|
||||||
|
@ -81,7 +81,8 @@ The following options are available:
|
|||||||
.Nm ( unexpand
|
.Nm ( unexpand
|
||||||
only.)
|
only.)
|
||||||
By default, only leading blanks and tabs
|
By default, only leading blanks and tabs
|
||||||
are reconverted to maximal strings of tabs. If the
|
are reconverted to maximal strings of tabs.
|
||||||
|
If the
|
||||||
.Fl a
|
.Fl a
|
||||||
option is given, then tabs are inserted whenever they would compress the
|
option is given, then tabs are inserted whenever they would compress the
|
||||||
resultant file by replacing two or more characters.
|
resultant file by replacing two or more characters.
|
||||||
|
@ -424,7 +424,9 @@ directory (source for the
|
|||||||
file) is too long to include here.
|
file) is too long to include here.
|
||||||
You know who you are; thank you.
|
You know who you are; thank you.
|
||||||
.Sh LEGAL NOTICE
|
.Sh LEGAL NOTICE
|
||||||
Copyright (c) Ian F. Darwin, Toronto, Canada, 1986-1999.
|
Copyright (c)
|
||||||
|
.An Ian F. Darwin ,
|
||||||
|
Toronto, Canada, 1986-1999.
|
||||||
Covered by the standard Berkeley Software Distribution copyright; see the file
|
Covered by the standard Berkeley Software Distribution copyright; see the file
|
||||||
.Pa LEGAL.NOTICE
|
.Pa LEGAL.NOTICE
|
||||||
in the source distribution.
|
in the source distribution.
|
||||||
|
@ -105,15 +105,17 @@ The numeric types may optionally be followed by
|
|||||||
.Em &
|
.Em &
|
||||||
and a numeric value,
|
and a numeric value,
|
||||||
to specify that the value is to be AND'ed with the
|
to specify that the value is to be AND'ed with the
|
||||||
numeric value before any comparisons are done. Prepending a
|
numeric value before any comparisons are done.
|
||||||
|
Prepending a
|
||||||
.Em u
|
.Em u
|
||||||
to the type indicates that ordered comparisons should be unsigned.
|
to the type indicates that ordered comparisons should be unsigned.
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It test
|
.It test
|
||||||
The value to be compared with the value from the file. If the type is
|
The value to be compared with the value from the file.
|
||||||
|
If the type is
|
||||||
numeric, this value
|
numeric, this value
|
||||||
is specified in C form; if it is a string, it is specified as a C string
|
is specified in C form; if it is a string, it is specified as a C string
|
||||||
with the usual escapes permitted (e.g. \en for new-line).
|
with the usual escapes permitted (e.g.\& \en for new-line).
|
||||||
.It ""
|
.It ""
|
||||||
Numeric values
|
Numeric values
|
||||||
may be preceded by a character indicating the operation to be performed.
|
may be preceded by a character indicating the operation to be performed.
|
||||||
@ -157,12 +159,14 @@ and
|
|||||||
.Em & )
|
.Em & )
|
||||||
can be applied to strings.
|
can be applied to strings.
|
||||||
The length used for matching is that of the string argument
|
The length used for matching is that of the string argument
|
||||||
in the magic file. This means that a line can match any string, and
|
in the magic file.
|
||||||
|
This means that a line can match any string, and
|
||||||
then presumably print that string, by doing
|
then presumably print that string, by doing
|
||||||
.Em >\e0
|
.Em >\e0
|
||||||
(because all strings are greater than the null string).
|
(because all strings are greater than the null string).
|
||||||
.It message
|
.It message
|
||||||
The message to be printed if the comparison succeeds. If the string
|
The message to be printed if the comparison succeeds.
|
||||||
|
If the string
|
||||||
contains a
|
contains a
|
||||||
.Xr printf 3
|
.Xr printf 3
|
||||||
format specification, the value from the file (with any specified masking
|
format specification, the value from the file (with any specified masking
|
||||||
@ -170,9 +174,11 @@ performed) is printed using the message as the format string.
|
|||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
Some file formats contain additional information which is to be printed
|
Some file formats contain additional information which is to be printed
|
||||||
along with the file type. A line which begins with the character
|
along with the file type.
|
||||||
|
A line which begins with the character
|
||||||
.Em >
|
.Em >
|
||||||
indicates additional tests and messages to be printed. The number of
|
indicates additional tests and messages to be printed.
|
||||||
|
The number of
|
||||||
.Em >
|
.Em >
|
||||||
on the line indicates the level of the test; a line with no
|
on the line indicates the level of the test; a line with no
|
||||||
.Em >
|
.Em >
|
||||||
@ -186,7 +192,8 @@ If the test on a line at level
|
|||||||
.Em n
|
.Em n
|
||||||
succeeds, the tests specified in all the subsequent lines at level
|
succeeds, the tests specified in all the subsequent lines at level
|
||||||
.Em n+1
|
.Em n+1
|
||||||
are performed, and the messages printed if the tests succeed. The next
|
are performed, and the messages printed if the tests succeed.
|
||||||
|
The next
|
||||||
line at level
|
line at level
|
||||||
.Em n
|
.Em n
|
||||||
terminates this.
|
terminates this.
|
||||||
|
@ -94,7 +94,8 @@ option, the office location and office phone information is displayed
|
|||||||
instead of the name of the remote host.
|
instead of the name of the remote host.
|
||||||
.It Fl g
|
.It Fl g
|
||||||
This option restricts the gecos output to only the users' real
|
This option restricts the gecos output to only the users' real
|
||||||
name. It also has the side-effect of restricting the output
|
name.
|
||||||
|
It also has the side-effect of restricting the output
|
||||||
of the remote host when used in conjunction with the
|
of the remote host when used in conjunction with the
|
||||||
.Fl h
|
.Fl h
|
||||||
option.
|
option.
|
||||||
@ -247,6 +248,8 @@ command appeared in
|
|||||||
.Bx 3.0 .
|
.Bx 3.0 .
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
The current FINGER protocol RFC requires that the client keep the connection
|
The current FINGER protocol RFC requires that the client keep the connection
|
||||||
fully open until the server closes. This prevents the use of the optimal
|
fully open until the server closes.
|
||||||
three-packet T/TCP exchange. (Servers which depend on this requirement are
|
This prevents the use of the optimal
|
||||||
|
three-packet T/TCP exchange.
|
||||||
|
(Servers which depend on this requirement are
|
||||||
bogus but have nonetheless been observed in the Internet at large.)
|
bogus but have nonetheless been observed in the Internet at large.)
|
||||||
|
@ -79,7 +79,8 @@ which is the kernel image the system has booted from.
|
|||||||
Include memory-mapped files in the listing; normally these are excluded
|
Include memory-mapped files in the listing; normally these are excluded
|
||||||
due to the extra processing required.
|
due to the extra processing required.
|
||||||
.It Fl n
|
.It Fl n
|
||||||
Numerical format. Print the device number (maj,min) of the file system
|
Numerical format.
|
||||||
|
Print the device number (maj,min) of the file system
|
||||||
the file resides in rather than the mount point name; for special
|
the file resides in rather than the mount point name; for special
|
||||||
files, print the
|
files, print the
|
||||||
device number that the special device refers to rather than the filename
|
device number that the special device refers to rather than the filename
|
||||||
@ -91,12 +92,15 @@ Report all files open by the specified process.
|
|||||||
.It Fl u
|
.It Fl u
|
||||||
Report all files open by the specified user.
|
Report all files open by the specified user.
|
||||||
.It Fl v
|
.It Fl v
|
||||||
Verbose mode. Print error messages upon failures to locate particular
|
Verbose mode.
|
||||||
system data structures rather than silently ignoring them. Most of
|
Print error messages upon failures to locate particular
|
||||||
|
system data structures rather than silently ignoring them.
|
||||||
|
Most of
|
||||||
these data structures are dynamically created or deleted and it is
|
these data structures are dynamically created or deleted and it is
|
||||||
possible for them to disappear while
|
possible for them to disappear while
|
||||||
.Nm
|
.Nm
|
||||||
is running. This
|
is running.
|
||||||
|
This
|
||||||
is normal and unavoidable since the rest of the system is running while
|
is normal and unavoidable since the rest of the system is running while
|
||||||
.Nm
|
.Nm
|
||||||
itself is running.
|
itself is running.
|
||||||
@ -145,7 +149,8 @@ major/minor number of the device that this file resides in.
|
|||||||
.It Li INUM
|
.It Li INUM
|
||||||
The inode number of the file.
|
The inode number of the file.
|
||||||
.It Li MODE
|
.It Li MODE
|
||||||
The mode of the file. If the
|
The mode of the file.
|
||||||
|
If the
|
||||||
.Fl n
|
.Fl n
|
||||||
flag isn't specified, the mode is printed
|
flag isn't specified, the mode is printed
|
||||||
using a symbolic format (see
|
using a symbolic format (see
|
||||||
@ -154,7 +159,8 @@ otherwise, the mode is printed
|
|||||||
as an octal number.
|
as an octal number.
|
||||||
.It Li SZ\&|DV
|
.It Li SZ\&|DV
|
||||||
If the file is not a character or block special, prints the size of
|
If the file is not a character or block special, prints the size of
|
||||||
the file in bytes. Otherwise, if the
|
the file in bytes.
|
||||||
|
Otherwise, if the
|
||||||
.Fl n
|
.Fl n
|
||||||
flag is not specified, prints
|
flag is not specified, prints
|
||||||
the name of the special file as located in
|
the name of the special file as located in
|
||||||
@ -177,7 +183,8 @@ flag is not, then
|
|||||||
this field is present and is the name associated with the given file.
|
this field is present and is the name associated with the given file.
|
||||||
Normally the name cannot be determined since there is no mapping
|
Normally the name cannot be determined since there is no mapping
|
||||||
from an open file back to the directory entry that was used to open
|
from an open file back to the directory entry that was used to open
|
||||||
that file. Also, since different directory entries may reference
|
that file.
|
||||||
|
Also, since different directory entries may reference
|
||||||
the same file (via
|
the same file (via
|
||||||
.Xr ln 1 ) ,
|
.Xr ln 1 ) ,
|
||||||
the name printed may not be the actual
|
the name printed may not be the actual
|
||||||
|
@ -68,8 +68,10 @@ Write the core file to the specified file instead of
|
|||||||
.Dq Pa core.<pid> .
|
.Dq Pa core.<pid> .
|
||||||
.It Fl s
|
.It Fl s
|
||||||
Stop the process while gathering the core image, and resume it
|
Stop the process while gathering the core image, and resume it
|
||||||
when done. This guarantees that the resulting core dump will
|
when done.
|
||||||
be in a consistent state. The process is resumed even if it was
|
This guarantees that the resulting core dump will
|
||||||
|
be in a consistent state.
|
||||||
|
The process is resumed even if it was
|
||||||
already stopped.
|
already stopped.
|
||||||
The same effect can be achieved manually with
|
The same effect can be achieved manually with
|
||||||
.Xr kill 1 .
|
.Xr kill 1 .
|
||||||
|
@ -45,7 +45,8 @@ into a formatted message catalog file
|
|||||||
.Ar "output-file" .
|
.Ar "output-file" .
|
||||||
The file
|
The file
|
||||||
.Ar "output-file"
|
.Ar "output-file"
|
||||||
will be created if it does not already exist. If
|
will be created if it does not already exist.
|
||||||
|
If
|
||||||
.Ar "output-file"
|
.Ar "output-file"
|
||||||
does exist, its messages will be included in the new
|
does exist, its messages will be included in the new
|
||||||
.Ar "output-file" .
|
.Ar "output-file" .
|
||||||
@ -54,7 +55,8 @@ If set and message numbers collide, the new message text defined in
|
|||||||
will replace the old message text currently contained in
|
will replace the old message text currently contained in
|
||||||
.Ar "output-file" .
|
.Ar "output-file" .
|
||||||
.Sh INPUT FILES
|
.Sh INPUT FILES
|
||||||
The format of a message text source file is defined below. Note that
|
The format of a message text source file is defined below.
|
||||||
|
Note that
|
||||||
the fields of a message text source line are separated by a single space
|
the fields of a message text source line are separated by a single space
|
||||||
character: any other space characters are considered to be part of the
|
character: any other space characters are considered to be part of the
|
||||||
field contents.
|
field contents.
|
||||||
@ -64,21 +66,27 @@ field contents.
|
|||||||
This line specifies the set identifier of the following messages until
|
This line specifies the set identifier of the following messages until
|
||||||
the next
|
the next
|
||||||
.Li $set
|
.Li $set
|
||||||
or end-of-file appears. The argument
|
or end-of-file appears.
|
||||||
|
The argument
|
||||||
.Ar n
|
.Ar n
|
||||||
is the set identifier which is defined as a number in the range
|
is the set identifier which is defined as a number in the range
|
||||||
[1, (NL_SETMAX)]. Set identifiers must occur in ascending order within
|
[1, (NL_SETMAX)].
|
||||||
a single source file, but need not be contiguous. Any string following
|
Set identifiers must occur in ascending order within
|
||||||
a space following the set identifier is treated as a comment. If no
|
a single source file, but need not be contiguous.
|
||||||
|
Any string following
|
||||||
|
a space following the set identifier is treated as a comment.
|
||||||
|
If no
|
||||||
.Li $set
|
.Li $set
|
||||||
directive is specified in a given source file, all messages will
|
directive is specified in a given source file, all messages will
|
||||||
be located in the default message set NL_SETD.
|
be located in the default message set NL_SETD.
|
||||||
.It Li $del Ar n comment
|
.It Li $del Ar n comment
|
||||||
This line deletes messages from set
|
This line deletes messages from set
|
||||||
.Ar n
|
.Ar n
|
||||||
from a message catalog. The
|
from a message catalog.
|
||||||
|
The
|
||||||
.Ar n
|
.Ar n
|
||||||
specifies a set number. Any string following a space following the set
|
specifies a set number.
|
||||||
|
Any string following a space following the set
|
||||||
number is treated as a comment.
|
number is treated as a comment.
|
||||||
.It Li $ Ar comment
|
.It Li $ Ar comment
|
||||||
A line beginning with
|
A line beginning with
|
||||||
@ -87,7 +95,8 @@ followed by a space is treated as a comment.
|
|||||||
.It Ar m message-text
|
.It Ar m message-text
|
||||||
A message line consists of a message identifier
|
A message line consists of a message identifier
|
||||||
.Ar m
|
.Ar m
|
||||||
in the range [1, (NL_MSGMAX)]. The
|
in the range [1, (NL_MSGMAX)].
|
||||||
|
The
|
||||||
.Ar message-text
|
.Ar message-text
|
||||||
is stored in the message catalog with the set identifier specified by
|
is stored in the message catalog with the set identifier specified by
|
||||||
the last
|
the last
|
||||||
@ -97,13 +106,16 @@ directive, and the message identifier
|
|||||||
If the
|
If the
|
||||||
.Ar message-text
|
.Ar message-text
|
||||||
is empty, and there is a space character following the message identifier,
|
is empty, and there is a space character following the message identifier,
|
||||||
an empty string is stored in the message catalog. If the
|
an empty string is stored in the message catalog.
|
||||||
|
If the
|
||||||
.Ar message-text
|
.Ar message-text
|
||||||
is empty, and if there is no space character following the message
|
is empty, and if there is no space character following the message
|
||||||
identifier, then the existing message in the current set with the
|
identifier, then the existing message in the current set with the
|
||||||
specified message identifier is deleted from the catalog. Message
|
specified message identifier is deleted from the catalog.
|
||||||
|
Message
|
||||||
identifiers must be in ascending order within a single set, but
|
identifiers must be in ascending order within a single set, but
|
||||||
need not be contiguous. The
|
need not be contiguous.
|
||||||
|
The
|
||||||
.Ar message-text
|
.Ar message-text
|
||||||
length must be in the range [0, (NL_TEXTMAX)].
|
length must be in the range [0, (NL_TEXTMAX)].
|
||||||
.It Li $quote Ar c
|
.It Li $quote Ar c
|
||||||
@ -112,19 +124,22 @@ This line specifies an optional quote character
|
|||||||
which can be used to surround
|
which can be used to surround
|
||||||
.Ar message-text
|
.Ar message-text
|
||||||
so that trailing space or empty messages are visible in message
|
so that trailing space or empty messages are visible in message
|
||||||
source files. By default, or if an empty
|
source files.
|
||||||
|
By default, or if an empty
|
||||||
.Li $quote
|
.Li $quote
|
||||||
directive is specified, no quoting of
|
directive is specified, no quoting of
|
||||||
.Ar message-text
|
.Ar message-text
|
||||||
will be recognized.
|
will be recognized.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
Empty lines in message source files are ignored. The effect of lines
|
Empty lines in message source files are ignored.
|
||||||
|
The effect of lines
|
||||||
beginning with any character other than those described above is
|
beginning with any character other than those described above is
|
||||||
undefined.
|
undefined.
|
||||||
.Pp
|
.Pp
|
||||||
Text strings can contain the following special characters and escape
|
Text strings can contain the following special characters and escape
|
||||||
sequences. In addition, if a quote character is defined, it may be
|
sequences.
|
||||||
|
In addition, if a quote character is defined, it may be
|
||||||
escaped as well to embed a literal quote character.
|
escaped as well to embed a literal quote character.
|
||||||
.Pp
|
.Pp
|
||||||
.Bl -tag -width "\eooo" -offset indent -compact
|
.Bl -tag -width "\eooo" -offset indent -compact
|
||||||
|
@ -109,7 +109,8 @@ has.
|
|||||||
.Pp
|
.Pp
|
||||||
Arguments containing white space or embedded shell metacharacters
|
Arguments containing white space or embedded shell metacharacters
|
||||||
generally will not survive intact; this looks easy to fix but
|
generally will not survive intact; this looks easy to fix but
|
||||||
isn't. People trying to fix
|
isn't.
|
||||||
|
People trying to fix
|
||||||
.Nm
|
.Nm
|
||||||
or the example in this manpage should check the history of this file
|
or the example in this manpage should check the history of this file
|
||||||
in
|
in
|
||||||
@ -129,6 +130,7 @@ command to set the arguments without disrupting the value(s) of
|
|||||||
shell options varies from one shell version to another.
|
shell options varies from one shell version to another.
|
||||||
.Pp
|
.Pp
|
||||||
Each shellscript has to carry complex code to parse arguments halfway
|
Each shellscript has to carry complex code to parse arguments halfway
|
||||||
correctly (like the example presented here). A better getopt-like tool
|
correctly (like the example presented here).
|
||||||
|
A better getopt-like tool
|
||||||
would move much of the complexity into the tool and keep the client
|
would move much of the complexity into the tool and keep the client
|
||||||
shell scripts simpler.
|
shell scripts simpler.
|
||||||
|
@ -67,7 +67,7 @@ option also links in versions of the library routines
|
|||||||
that are compiled for profiling.
|
that are compiled for profiling.
|
||||||
By convention these libraries have their name suffixed with
|
By convention these libraries have their name suffixed with
|
||||||
.Pa _p ,
|
.Pa _p ,
|
||||||
i.e. the profiled version of
|
i.e., the profiled version of
|
||||||
.Pa libc.a
|
.Pa libc.a
|
||||||
is
|
is
|
||||||
.Pa libc_p.a
|
.Pa libc_p.a
|
||||||
@ -237,10 +237,12 @@ to accumulate profile data across several runs of an
|
|||||||
file.
|
file.
|
||||||
.It Fl u
|
.It Fl u
|
||||||
Suppress the printing of functions whose names are not visible to
|
Suppress the printing of functions whose names are not visible to
|
||||||
C programs. For the ELF object format, this means names that
|
C programs.
|
||||||
|
For the ELF object format, this means names that
|
||||||
contain the
|
contain the
|
||||||
.Ql .\&
|
.Ql .\&
|
||||||
character. For the a.out object format, it means names that do not
|
character.
|
||||||
|
For the a.out object format, it means names that do not
|
||||||
begin with a
|
begin with a
|
||||||
.Ql _
|
.Ql _
|
||||||
character.
|
character.
|
||||||
|
@ -58,7 +58,7 @@ database.
|
|||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It Aq Ar username
|
.It Aq Ar username
|
||||||
the 8\-character\-or\-less string used to identify users or classes
|
the 8\-character\-or\-less string used to identify users or classes
|
||||||
(e.g. joeuser, root, 1.00, etc).
|
(e.g.\& joeuser, root, 1.00, etc).
|
||||||
Used with the
|
Used with the
|
||||||
.Ar Hesiod_Name_Types
|
.Ar Hesiod_Name_Types
|
||||||
.Cm passwd ,
|
.Cm passwd ,
|
||||||
@ -84,9 +84,9 @@ the name of an
|
|||||||
.Tn NFS
|
.Tn NFS
|
||||||
server and its partition separated by a colon.
|
server and its partition separated by a colon.
|
||||||
.It Aq Ar workstation\-name
|
.It Aq Ar workstation\-name
|
||||||
the machine name of an Athena workstation (e.g. E40\-343\-3).
|
the machine name of an Athena workstation (e.g.\& E40\-343\-3).
|
||||||
.It Aq Ar service\-name
|
.It Aq Ar service\-name
|
||||||
name of an Athena service (e.g. Zephyr).
|
name of an Athena service (e.g.\& Zephyr).
|
||||||
.It Aq Ar service\-type
|
.It Aq Ar service\-type
|
||||||
name of
|
name of
|
||||||
.Ux
|
.Ux
|
||||||
|
@ -310,7 +310,7 @@ If, as a result of the specification of the
|
|||||||
.Fl n
|
.Fl n
|
||||||
option or end-of-file being reached, input data only partially
|
option or end-of-file being reached, input data only partially
|
||||||
satisfies a format string, the input block is zero-padded sufficiently
|
satisfies a format string, the input block is zero-padded sufficiently
|
||||||
to display all available data (i.e. any format units overlapping the
|
to display all available data (i.e., any format units overlapping the
|
||||||
end of data will display some number of the zero bytes).
|
end of data will display some number of the zero bytes).
|
||||||
.Pp
|
.Pp
|
||||||
Further output by such format strings is replaced by an equivalent
|
Further output by such format strings is replaced by an equivalent
|
||||||
|
@ -88,12 +88,15 @@ The
|
|||||||
.Nm
|
.Nm
|
||||||
utility is a
|
utility is a
|
||||||
.Em C
|
.Em C
|
||||||
program formatter. It reformats the
|
program formatter.
|
||||||
|
It reformats the
|
||||||
.Em C
|
.Em C
|
||||||
program in the
|
program in the
|
||||||
.Ar input-file
|
.Ar input-file
|
||||||
according to the switches. The switches which can be
|
according to the switches.
|
||||||
specified are described below. They may appear before or after the file
|
The switches which can be
|
||||||
|
specified are described below.
|
||||||
|
They may appear before or after the file
|
||||||
names.
|
names.
|
||||||
.Pp
|
.Pp
|
||||||
.Sy NOTE :
|
.Sy NOTE :
|
||||||
@ -104,7 +107,8 @@ done `in-place', that is, the formatted file is written back into
|
|||||||
.Ar input-file
|
.Ar input-file
|
||||||
and a backup copy of
|
and a backup copy of
|
||||||
.Ar input-file
|
.Ar input-file
|
||||||
is written in the current directory. If
|
is written in the current directory.
|
||||||
|
If
|
||||||
.Ar input-file
|
.Ar input-file
|
||||||
is named
|
is named
|
||||||
.Sq Pa /blah/blah/file ,
|
.Sq Pa /blah/blah/file ,
|
||||||
@ -125,24 +129,28 @@ The options listed below control the formatting style imposed by
|
|||||||
If
|
If
|
||||||
.Fl bad
|
.Fl bad
|
||||||
is specified, a blank line is forced after every block of
|
is specified, a blank line is forced after every block of
|
||||||
declarations. Default:
|
declarations.
|
||||||
|
Default:
|
||||||
.Fl nbad .
|
.Fl nbad .
|
||||||
.It Fl bap , nbap
|
.It Fl bap , nbap
|
||||||
If
|
If
|
||||||
.Fl bap
|
.Fl bap
|
||||||
is specified, a blank line is forced after every procedure body. Default:
|
is specified, a blank line is forced after every procedure body.
|
||||||
|
Default:
|
||||||
.Fl nbap .
|
.Fl nbap .
|
||||||
.It Fl bbb , nbbb
|
.It Fl bbb , nbbb
|
||||||
If
|
If
|
||||||
.Fl bbb
|
.Fl bbb
|
||||||
is specified, a blank line is forced before every block comment. Default:
|
is specified, a blank line is forced before every block comment.
|
||||||
|
Default:
|
||||||
.Fl nbbb .
|
.Fl nbbb .
|
||||||
.It Fl \&bc , nbc
|
.It Fl \&bc , nbc
|
||||||
If
|
If
|
||||||
.Fl \&bc
|
.Fl \&bc
|
||||||
is specified, then a newline is forced after each comma in a declaration.
|
is specified, then a newline is forced after each comma in a declaration.
|
||||||
.Fl nbc
|
.Fl nbc
|
||||||
turns off this option. Default:
|
turns off this option.
|
||||||
|
Default:
|
||||||
.Fl \&nbc .
|
.Fl \&nbc .
|
||||||
.It Fl \&br , \&bl
|
.It Fl \&br , \&bl
|
||||||
Specifying
|
Specifying
|
||||||
@ -165,12 +173,15 @@ if (...) {
|
|||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
.It Fl c Ns Ar n
|
.It Fl c Ns Ar n
|
||||||
The column in which comments on code start. The default is 33.
|
The column in which comments on code start.
|
||||||
|
The default is 33.
|
||||||
.It Fl cd Ns Ar n
|
.It Fl cd Ns Ar n
|
||||||
The column in which comments on declarations start. The default
|
The column in which comments on declarations start.
|
||||||
|
The default
|
||||||
is for these comments to start in the same column as those on code.
|
is for these comments to start in the same column as those on code.
|
||||||
.It Fl cdb , ncdb
|
.It Fl cdb , ncdb
|
||||||
Enables (disables) the placement of comment delimiters on blank lines. With
|
Enables (disables) the placement of comment delimiters on blank lines.
|
||||||
|
With
|
||||||
this option enabled, comments look like this:
|
this option enabled, comments look like this:
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
/*
|
/*
|
||||||
@ -184,18 +195,21 @@ Rather than like this:
|
|||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
This only affects block comments, not comments to the right of
|
This only affects block comments, not comments to the right of
|
||||||
code. The default is
|
code.
|
||||||
|
The default is
|
||||||
.Fl cdb .
|
.Fl cdb .
|
||||||
.It Fl ce , nce
|
.It Fl ce , nce
|
||||||
Enables (disables) forcing of `else's to cuddle up to the immediately preceding
|
Enables (disables) forcing of `else's to cuddle up to the immediately preceding
|
||||||
`}'. The default is
|
`}'.
|
||||||
|
The default is
|
||||||
.Fl \&ce .
|
.Fl \&ce .
|
||||||
.It Fl \&ci Ns Ar n
|
.It Fl \&ci Ns Ar n
|
||||||
Sets the continuation indent to be
|
Sets the continuation indent to be
|
||||||
.Ar n .
|
.Ar n .
|
||||||
Continuation
|
Continuation
|
||||||
lines will be indented that far from the beginning of the first line of the
|
lines will be indented that far from the beginning of the first line of the
|
||||||
statement. Parenthesized expressions have extra indentation added to
|
statement.
|
||||||
|
Parenthesized expressions have extra indentation added to
|
||||||
indicate the nesting, unless
|
indicate the nesting, unless
|
||||||
.Fl \&lp
|
.Fl \&lp
|
||||||
is in effect
|
is in effect
|
||||||
@ -210,17 +224,21 @@ tab stops to the right of the containing
|
|||||||
.Ic switch
|
.Ic switch
|
||||||
statement.
|
statement.
|
||||||
.Fl cli0.5
|
.Fl cli0.5
|
||||||
causes case labels to be indented half a tab stop. The
|
causes case labels to be indented half a tab stop.
|
||||||
|
The
|
||||||
default is
|
default is
|
||||||
.Fl cli0 .
|
.Fl cli0 .
|
||||||
.It Fl d Ns Ar n
|
.It Fl d Ns Ar n
|
||||||
Controls the placement of comments which are not to the
|
Controls the placement of comments which are not to the
|
||||||
right of code. For example,
|
right of code.
|
||||||
|
For example,
|
||||||
.Fl \&d\&1
|
.Fl \&d\&1
|
||||||
means that such comments are placed one indentation level to the
|
means that such comments are placed one indentation level to the
|
||||||
left of code. Specifying the default
|
left of code.
|
||||||
|
Specifying the default
|
||||||
.Fl \&d\&0
|
.Fl \&d\&0
|
||||||
lines-up these comments with the code. See the section on comment
|
lines-up these comments with the code.
|
||||||
|
See the section on comment
|
||||||
indentation below.
|
indentation below.
|
||||||
.It Fl \&di Ns Ar n
|
.It Fl \&di Ns Ar n
|
||||||
Specifies the indentation, in character positions,
|
Specifies the indentation, in character positions,
|
||||||
@ -232,18 +250,21 @@ The default is
|
|||||||
.Fl \&dj
|
.Fl \&dj
|
||||||
left justifies declarations.
|
left justifies declarations.
|
||||||
.Fl ndj
|
.Fl ndj
|
||||||
indents declarations the same as code. The default is
|
indents declarations the same as code.
|
||||||
|
The default is
|
||||||
.Fl ndj .
|
.Fl ndj .
|
||||||
.It Fl \&ei , nei
|
.It Fl \&ei , nei
|
||||||
Enables (disables) special
|
Enables (disables) special
|
||||||
.Ic else-if
|
.Ic else-if
|
||||||
processing. If it's enabled, an
|
processing.
|
||||||
|
If it's enabled, an
|
||||||
.Ic if
|
.Ic if
|
||||||
following an
|
following an
|
||||||
.Ic else
|
.Ic else
|
||||||
will have the same indentation as the preceding
|
will have the same indentation as the preceding
|
||||||
.Ic \&if
|
.Ic \&if
|
||||||
statement. The default is
|
statement.
|
||||||
|
The default is
|
||||||
.Fl ei .
|
.Fl ei .
|
||||||
.It Fl fbs , nfbs
|
.It Fl fbs , nfbs
|
||||||
Enables (disables) splitting the function declaration and opening brace
|
Enables (disables) splitting the function declaration and opening brace
|
||||||
@ -253,10 +274,12 @@ The default is
|
|||||||
.It Fl fc1 , nfc1
|
.It Fl fc1 , nfc1
|
||||||
Enables (disables) the formatting of comments that start in column 1.
|
Enables (disables) the formatting of comments that start in column 1.
|
||||||
Often, comments whose leading `/' is in column 1 have been carefully
|
Often, comments whose leading `/' is in column 1 have been carefully
|
||||||
hand formatted by the programmer. In such cases,
|
hand formatted by the programmer.
|
||||||
|
In such cases,
|
||||||
.Fl nfc1
|
.Fl nfc1
|
||||||
should be
|
should be
|
||||||
used. The default is
|
used.
|
||||||
|
The default is
|
||||||
.Fl fc1 .
|
.Fl fc1 .
|
||||||
.It Fl fcb , nfcb
|
.It Fl fcb , nfcb
|
||||||
Enables (disables) the formatting of block comments (ones that begin
|
Enables (disables) the formatting of block comments (ones that begin
|
||||||
@ -271,13 +294,16 @@ Block comments are then handled like box comments.
|
|||||||
The default is
|
The default is
|
||||||
.Fl fcb .
|
.Fl fcb .
|
||||||
.It Fl i Ns Ar n
|
.It Fl i Ns Ar n
|
||||||
The number of spaces for one indentation level. The default is 8.
|
The number of spaces for one indentation level.
|
||||||
|
The default is 8.
|
||||||
.It Fl \&ip , nip
|
.It Fl \&ip , nip
|
||||||
Enables (disables) the indentation of parameter declarations from the left
|
Enables (disables) the indentation of parameter declarations from the left
|
||||||
margin. The default is
|
margin.
|
||||||
|
The default is
|
||||||
.Fl \&ip .
|
.Fl \&ip .
|
||||||
.It Fl l Ns Ar n
|
.It Fl l Ns Ar n
|
||||||
Maximum length of an output line. The default is 78.
|
Maximum length of an output line.
|
||||||
|
The default is 78.
|
||||||
.It Fl \&ldi Ns Ar n
|
.It Fl \&ldi Ns Ar n
|
||||||
Specifies the indentation, in character positions,
|
Specifies the indentation, in character positions,
|
||||||
of local variable names
|
of local variable names
|
||||||
@ -285,10 +311,12 @@ relative to the beginning of their type declaration.
|
|||||||
The default is for local variable names to be indented
|
The default is for local variable names to be indented
|
||||||
by the same amount as global ones.
|
by the same amount as global ones.
|
||||||
.It Fl \&lp , nlp
|
.It Fl \&lp , nlp
|
||||||
Lines-up code surrounded by parenthesis in continuation lines. If a line
|
Lines-up code surrounded by parenthesis in continuation lines.
|
||||||
|
If a line
|
||||||
has a left paren which is not closed on that line, then continuation lines
|
has a left paren which is not closed on that line, then continuation lines
|
||||||
will be lined up to start at the character position just after the left
|
will be lined up to start at the character position just after the left
|
||||||
paren. For example, here is how a piece of continued code looks with
|
paren.
|
||||||
|
For example, here is how a piece of continued code looks with
|
||||||
.Fl nlp
|
.Fl nlp
|
||||||
in effect:
|
in effect:
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
@ -321,24 +349,29 @@ to be ignored.
|
|||||||
If true
|
If true
|
||||||
.Pq Fl pcs
|
.Pq Fl pcs
|
||||||
all procedure calls will have a space inserted between
|
all procedure calls will have a space inserted between
|
||||||
the name and the `('. The default is
|
the name and the `('.
|
||||||
|
The default is
|
||||||
.Fl npcs .
|
.Fl npcs .
|
||||||
.It Fl psl , npsl
|
.It Fl psl , npsl
|
||||||
If true
|
If true
|
||||||
.Pq Fl psl
|
.Pq Fl psl
|
||||||
the names of procedures being defined are placed in
|
the names of procedures being defined are placed in
|
||||||
column 1 \- their types, if any, will be left on the previous lines. The
|
column 1 \- their types, if any, will be left on the previous lines.
|
||||||
|
The
|
||||||
default is
|
default is
|
||||||
.Fl psl .
|
.Fl psl .
|
||||||
.It Fl \&sc , nsc
|
.It Fl \&sc , nsc
|
||||||
Enables (disables) the placement of asterisks (`*'s) at the left edge of all
|
Enables (disables) the placement of asterisks (`*'s) at the left edge of all
|
||||||
comments. The default is
|
comments.
|
||||||
|
The default is
|
||||||
.Fl sc .
|
.Fl sc .
|
||||||
.It Fl sob , nsob
|
.It Fl sob , nsob
|
||||||
If
|
If
|
||||||
.Fl sob
|
.Fl sob
|
||||||
is specified, indent will swallow optional blank lines. You can use this to
|
is specified, indent will swallow optional blank lines.
|
||||||
get rid of blank lines after declarations. Default:
|
You can use this to
|
||||||
|
get rid of blank lines after declarations.
|
||||||
|
Default:
|
||||||
.Fl nsob .
|
.Fl nsob .
|
||||||
.It Fl \&st
|
.It Fl \&st
|
||||||
Causes
|
Causes
|
||||||
@ -347,14 +380,17 @@ to take its input from stdin and put its output to stdout.
|
|||||||
.It Fl T Ns Ar typename
|
.It Fl T Ns Ar typename
|
||||||
Adds
|
Adds
|
||||||
.Ar typename
|
.Ar typename
|
||||||
to the list of type keywords. Names accumulate:
|
to the list of type keywords.
|
||||||
|
Names accumulate:
|
||||||
.Fl T
|
.Fl T
|
||||||
can be specified more than once. You need to specify all the typenames that
|
can be specified more than once.
|
||||||
|
You need to specify all the typenames that
|
||||||
appear in your program that are defined by
|
appear in your program that are defined by
|
||||||
.Ic typedef
|
.Ic typedef
|
||||||
\- nothing will be
|
\- nothing will be
|
||||||
harmed if you miss a few, but the program won't be formatted as nicely as
|
harmed if you miss a few, but the program won't be formatted as nicely as
|
||||||
it should. This sounds like a painful thing to have to do, but it's really
|
it should.
|
||||||
|
This sounds like a painful thing to have to do, but it's really
|
||||||
a symptom of a problem in C:
|
a symptom of a problem in C:
|
||||||
.Ic typedef
|
.Ic typedef
|
||||||
causes a syntactic change in the
|
causes a syntactic change in the
|
||||||
@ -382,10 +418,12 @@ The default is
|
|||||||
.Fl v
|
.Fl v
|
||||||
turns on `verbose' mode;
|
turns on `verbose' mode;
|
||||||
.Fl \&nv
|
.Fl \&nv
|
||||||
turns it off. When in verbose mode,
|
turns it off.
|
||||||
|
When in verbose mode,
|
||||||
.Nm
|
.Nm
|
||||||
reports when it splits one line of input into two or more lines of output,
|
reports when it splits one line of input into two or more lines of output,
|
||||||
and gives some size statistics at completion. The default is
|
and gives some size statistics at completion.
|
||||||
|
The default is
|
||||||
.Fl \&nv .
|
.Fl \&nv .
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
@ -394,12 +432,16 @@ You may set up your own `profile' of defaults to
|
|||||||
by creating a file called
|
by creating a file called
|
||||||
.Pa .indent.pro
|
.Pa .indent.pro
|
||||||
in your login directory and/or the current directory and including
|
in your login directory and/or the current directory and including
|
||||||
whatever switches you like. A `.indent.pro' in the current directory takes
|
whatever switches you like.
|
||||||
precedence over the one in your login directory. If
|
A `.indent.pro' in the current directory takes
|
||||||
|
precedence over the one in your login directory.
|
||||||
|
If
|
||||||
.Nm
|
.Nm
|
||||||
is run and a profile file exists, then it is read to set up the program's
|
is run and a profile file exists, then it is read to set up the program's
|
||||||
defaults. Switches on the command line, though, always override profile
|
defaults.
|
||||||
switches. The switches should be separated by spaces, tabs or newlines.
|
Switches on the command line, though, always override profile
|
||||||
|
switches.
|
||||||
|
The switches should be separated by spaces, tabs or newlines.
|
||||||
.Pp
|
.Pp
|
||||||
.Ss Comments
|
.Ss Comments
|
||||||
.Sq Em Box
|
.Sq Em Box
|
||||||
@ -418,28 +460,34 @@ All other comments are treated as straight text.
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility fits as many words (separated by blanks, tabs, or newlines) on a
|
utility fits as many words (separated by blanks, tabs, or newlines) on a
|
||||||
line as possible. Blank lines break paragraphs.
|
line as possible.
|
||||||
|
Blank lines break paragraphs.
|
||||||
.Pp
|
.Pp
|
||||||
.Ss Comment indentation
|
.Ss Comment indentation
|
||||||
If a comment is on a line with code it is started in the `comment column',
|
If a comment is on a line with code it is started in the `comment column',
|
||||||
which is set by the
|
which is set by the
|
||||||
.Fl c Ns Ns Ar n
|
.Fl c Ns Ns Ar n
|
||||||
command line parameter. Otherwise, the comment is started at
|
command line parameter.
|
||||||
|
Otherwise, the comment is started at
|
||||||
.Ar n
|
.Ar n
|
||||||
indentation levels less than where code is currently being placed, where
|
indentation levels less than where code is currently being placed, where
|
||||||
.Ar n
|
.Ar n
|
||||||
is specified by the
|
is specified by the
|
||||||
.Fl d Ns Ns Ar n
|
.Fl d Ns Ns Ar n
|
||||||
command line parameter. If the code on a line extends past the comment
|
command line parameter.
|
||||||
|
If the code on a line extends past the comment
|
||||||
column, the comment starts further to the right, and the right margin may be
|
column, the comment starts further to the right, and the right margin may be
|
||||||
automatically extended in extreme cases.
|
automatically extended in extreme cases.
|
||||||
.Pp
|
.Pp
|
||||||
.Ss Preprocessor lines
|
.Ss Preprocessor lines
|
||||||
In general,
|
In general,
|
||||||
.Nm
|
.Nm
|
||||||
leaves preprocessor lines alone. The only
|
leaves preprocessor lines alone.
|
||||||
reformatting that it will do is to straighten up trailing comments. It
|
The only
|
||||||
leaves embedded comments alone. Conditional compilation
|
reformatting that it will do is to straighten up trailing comments.
|
||||||
|
It
|
||||||
|
leaves embedded comments alone.
|
||||||
|
Conditional compilation
|
||||||
.Pq Ic #ifdef...#endif
|
.Pq Ic #ifdef...#endif
|
||||||
is recognized and
|
is recognized and
|
||||||
.Nm
|
.Nm
|
||||||
@ -450,8 +498,10 @@ compensate for the syntactic peculiarities introduced.
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility understands a substantial amount about the syntax of C, but it
|
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
|
has a `forgiving' parser.
|
||||||
incomplete and misformed syntax. In particular, the use of macros like:
|
It attempts to cope with the usual sorts of
|
||||||
|
incomplete and misformed syntax.
|
||||||
|
In particular, the use of macros like:
|
||||||
.Pp
|
.Pp
|
||||||
.Dl #define forever for(;;)
|
.Dl #define forever for(;;)
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -42,7 +42,8 @@
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility removes the specified message queues, semaphores and shared memory
|
utility removes the specified message queues, semaphores and shared memory
|
||||||
segments. These System V IPC objects can be specified by their
|
segments.
|
||||||
|
These System V IPC objects can be specified by their
|
||||||
creation id or any associated key.
|
creation id or any associated key.
|
||||||
.Pp
|
.Pp
|
||||||
The following options are used to specify which IPC objects will be removed.
|
The following options are used to specify which IPC objects will be removed.
|
||||||
|
@ -63,7 +63,8 @@ and
|
|||||||
options.)
|
options.)
|
||||||
.It Fl b
|
.It Fl b
|
||||||
Show the maximum allowed sizes for active semaphores, message queues,
|
Show the maximum allowed sizes for active semaphores, message queues,
|
||||||
and shared memory segments. The
|
and shared memory segments.
|
||||||
|
The
|
||||||
.Dq maximum allowed size
|
.Dq maximum allowed size
|
||||||
is the maximum number of bytes in a message on a message queue,
|
is the maximum number of bytes in a message on a message queue,
|
||||||
the size of a shared memory segment,
|
the size of a shared memory segment,
|
||||||
@ -75,13 +76,15 @@ and shared memory segments.
|
|||||||
Display information about active shared memory segments.
|
Display information about active shared memory segments.
|
||||||
.It Fl o
|
.It Fl o
|
||||||
Show outstanding usage for active message queues,
|
Show outstanding usage for active message queues,
|
||||||
and shared memory segments. The
|
and shared memory segments.
|
||||||
|
The
|
||||||
.Dq outstanding usage
|
.Dq outstanding usage
|
||||||
is the number of messages in a message queue, or the number
|
is the number of messages in a message queue, or the number
|
||||||
of processes attached to a shared memory segment.
|
of processes attached to a shared memory segment.
|
||||||
.It Fl p
|
.It Fl p
|
||||||
Show the process ID information for active semaphores, message queues,
|
Show the process ID information for active semaphores, message queues,
|
||||||
and shared memory segments. The
|
and shared memory segments.
|
||||||
|
The
|
||||||
.Dq process ID information
|
.Dq process ID information
|
||||||
is the last process to send a message to or receive a message from
|
is the last process to send a message to or receive a message from
|
||||||
a message queue,
|
a message queue,
|
||||||
@ -93,7 +96,8 @@ Display information about active message queues.
|
|||||||
Display information about active semaphores.
|
Display information about active semaphores.
|
||||||
.It Fl t
|
.It Fl t
|
||||||
Show access times for active semaphores, message queues,
|
Show access times for active semaphores, message queues,
|
||||||
and shared memory segments. The access times is the time
|
and shared memory segments.
|
||||||
|
The access times is the time
|
||||||
of the last control operation on an IPC object,
|
of the last control operation on an IPC object,
|
||||||
the last send or receive of a message,
|
the last send or receive of a message,
|
||||||
the last attach or detach of a shared memory segment,
|
the last attach or detach of a shared memory segment,
|
||||||
|
@ -82,7 +82,7 @@ and leading tabs and spaces are ignored.
|
|||||||
The default output field separator is a single space character.
|
The default output field separator is a single space character.
|
||||||
.Pp
|
.Pp
|
||||||
Many of the options use file and field numbers.
|
Many of the options use file and field numbers.
|
||||||
Both file numbers and field numbers are 1 based, i.e. the first file on
|
Both file numbers and field numbers are 1 based, i.e., the first file on
|
||||||
the command line is file number 1 and the first field is field number 1.
|
the command line is file number 1 and the first field is field number 1.
|
||||||
The following options are available:
|
The following options are available:
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
@ -218,7 +218,6 @@ command conforms to
|
|||||||
.Xr sort 1 ,
|
.Xr sort 1 ,
|
||||||
.Xr uniq 1
|
.Xr uniq 1
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
.Pp
|
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility does not recognize multibyte characters.
|
utility does not recognize multibyte characters.
|
||||||
|
@ -168,11 +168,11 @@ may be obtained through
|
|||||||
.Pp
|
.Pp
|
||||||
and thirty
|
and thirty
|
||||||
.Xr ed 1
|
.Xr ed 1
|
||||||
substitution commands applying to lines 2, 7, 12, etc. is
|
substitution commands applying to lines 2, 7, 12, etc.\& is
|
||||||
the result of
|
the result of
|
||||||
.Dl jot -w %ds/old/new/ 30 2 - 5
|
.Dl jot -w %ds/old/new/ 30 2 - 5
|
||||||
.Pp
|
.Pp
|
||||||
The stuttering sequence 9, 9, 8, 8, 7, etc. can be
|
The stuttering sequence 9, 9, 8, 8, 7, etc.\& can be
|
||||||
produced by suitable choice of step size,
|
produced by suitable choice of step size,
|
||||||
as in
|
as in
|
||||||
.Dl jot - 9 0 -.5
|
.Dl jot - 9 0 -.5
|
||||||
|
@ -58,7 +58,8 @@ The super-user is allowed to kill any process.
|
|||||||
The options are as follows:
|
The options are as follows:
|
||||||
.Bl -tag -width 10n -offset indent
|
.Bl -tag -width 10n -offset indent
|
||||||
.It Fl d | v
|
.It Fl d | v
|
||||||
Be more verbose about what will be done. For a single
|
Be more verbose about what will be done.
|
||||||
|
For a single
|
||||||
.Fl d
|
.Fl d
|
||||||
option, a list of the processes that will be sent the signal will be
|
option, a list of the processes that will be sent the signal will be
|
||||||
printed, or a message indicating that no matching processes have been
|
printed, or a message indicating that no matching processes have been
|
||||||
@ -78,7 +79,8 @@ Match the argument
|
|||||||
.Ar procname
|
.Ar procname
|
||||||
as a (case sensitive) regular expression against the names
|
as a (case sensitive) regular expression against the names
|
||||||
of processes found.
|
of processes found.
|
||||||
CAUTION! This is dangerous, a single dot will match any process
|
CAUTION!
|
||||||
|
This is dangerous, a single dot will match any process
|
||||||
running under the real UID of the caller.
|
running under the real UID of the caller.
|
||||||
.It Fl s
|
.It Fl s
|
||||||
Show only what would be done, but do not send any signal.
|
Show only what would be done, but do not send any signal.
|
||||||
@ -120,15 +122,17 @@ is already supported by
|
|||||||
.Xr kill 1 .
|
.Xr kill 1 .
|
||||||
So use
|
So use
|
||||||
.Xr kill 1
|
.Xr kill 1
|
||||||
for this job (e.g. $ kill -TERM -1 or
|
for this job (e.g.\& $ kill -TERM -1 or
|
||||||
as root $ echo kill -TERM -1 | su -m <user>)
|
as root $ echo kill -TERM -1 | su -m <user>)
|
||||||
.Sh DIAGNOSTICS
|
.Sh DIAGNOSTICS
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
command will respond with a short usage message and exit with a status
|
command will respond with a short usage message and exit with a status
|
||||||
of 2 in case of a command error. A status of 1 will be returned if
|
of 2 in case of a command error.
|
||||||
|
A status of 1 will be returned if
|
||||||
either no matching process has been found or not all processes have
|
either no matching process has been found or not all processes have
|
||||||
been signalled successfully. Otherwise, a status of 0 will be
|
been signalled successfully.
|
||||||
|
Otherwise, a status of 0 will be
|
||||||
returned.
|
returned.
|
||||||
.Pp
|
.Pp
|
||||||
Diagnostic messages will only be printed if requested by
|
Diagnostic messages will only be printed if requested by
|
||||||
|
@ -90,7 +90,7 @@ format, suitable for the calling shell.
|
|||||||
The calling shell is determined by examining the entries in the
|
The calling shell is determined by examining the entries in the
|
||||||
.Pa /proc
|
.Pa /proc
|
||||||
file system for the parent process.
|
file system for the parent process.
|
||||||
If the shell is known (i.e. it is one of
|
If the shell is known (i.e., it is one of
|
||||||
.Nm sh , csh , bash , tcsh , ksh , pdksh
|
.Nm sh , csh , bash , tcsh , ksh , pdksh
|
||||||
or
|
or
|
||||||
.Nm rc ) ,
|
.Nm rc ) ,
|
||||||
@ -346,7 +346,7 @@ The
|
|||||||
utility
|
utility
|
||||||
exits with
|
exits with
|
||||||
.Dv EXIT_FAILURE
|
.Dv EXIT_FAILURE
|
||||||
if usage is incorrect in any way; i.e. an invalid
|
if usage is incorrect in any way; i.e., an invalid
|
||||||
option, or set/display options are selected in the same invocation,
|
option, or set/display options are selected in the same invocation,
|
||||||
.Fl e
|
.Fl e
|
||||||
is used when running a program, etc.
|
is used when running a program, etc.
|
||||||
|
@ -77,7 +77,8 @@ As a special case, a pattern containing no globbing characters
|
|||||||
is matched as though it were
|
is matched as though it were
|
||||||
.Dq *foo* .
|
.Dq *foo* .
|
||||||
.Pp
|
.Pp
|
||||||
Historically, locate only stored characters between 32 and 127. The
|
Historically, locate only stored characters between 32 and 127.
|
||||||
|
The
|
||||||
current implementation store any character except newline
|
current implementation store any character except newline
|
||||||
.Pq Sq \en
|
.Pq Sq \en
|
||||||
and NUL
|
and NUL
|
||||||
@ -99,7 +100,8 @@ Search in
|
|||||||
instead the default file name database.
|
instead the default file name database.
|
||||||
Multiple
|
Multiple
|
||||||
.Fl d
|
.Fl d
|
||||||
options are allowed. Each additional
|
options are allowed.
|
||||||
|
Each additional
|
||||||
.Fl d
|
.Fl d
|
||||||
option adds the specified database to the list
|
option adds the specified database to the list
|
||||||
of databases to be searched.
|
of databases to be searched.
|
||||||
@ -155,7 +157,8 @@ $ zcat database.gz | locate -d - pattern
|
|||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
This might be useful on machines with a fast CPU and little RAM and slow
|
This might be useful on machines with a fast CPU and little RAM and slow
|
||||||
I/O. Note: you can only use
|
I/O.
|
||||||
|
Note: you can only use
|
||||||
.Ar one
|
.Ar one
|
||||||
pattern for stdin.
|
pattern for stdin.
|
||||||
.It Fl i
|
.It Fl i
|
||||||
@ -212,11 +215,13 @@ option was specified.
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
program may fail to list some files that are present, or may
|
program may fail to list some files that are present, or may
|
||||||
list files that have been removed from the system. This is because
|
list files that have been removed from the system.
|
||||||
|
This is because
|
||||||
locate only reports files that are present in the database, which is
|
locate only reports files that are present in the database, which is
|
||||||
typically only regenerated once a week by the
|
typically only regenerated once a week by the
|
||||||
.Pa /etc/periodic/weekly/310.locate
|
.Pa /etc/periodic/weekly/310.locate
|
||||||
script. Use
|
script.
|
||||||
|
Use
|
||||||
.Xr find 1
|
.Xr find 1
|
||||||
to locate files that are of a more transitory nature.
|
to locate files that are of a more transitory nature.
|
||||||
.Pp
|
.Pp
|
||||||
@ -233,7 +238,7 @@ group
|
|||||||
.Dq nobody ,
|
.Dq nobody ,
|
||||||
or
|
or
|
||||||
world.
|
world.
|
||||||
E.g. if your HOME directory is not world-readable, all your
|
E.g.\& if your HOME directory is not world-readable, all your
|
||||||
files are
|
files are
|
||||||
.Ar not
|
.Ar not
|
||||||
in the database.
|
in the database.
|
||||||
|
@ -55,7 +55,8 @@ with the appropriate permission.
|
|||||||
The following options are available:
|
The following options are available:
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It Fl n
|
.It Fl n
|
||||||
Don't use a timeout value. Terminal will be locked forever.
|
Don't use a timeout value.
|
||||||
|
Terminal will be locked forever.
|
||||||
.It Fl p
|
.It Fl p
|
||||||
A password is not requested, instead the user's current login password
|
A password is not requested, instead the user's current login password
|
||||||
is used.
|
is used.
|
||||||
|
@ -74,14 +74,16 @@ Causes
|
|||||||
to operate silently.
|
to operate silently.
|
||||||
Failure to acquire the lock is indicated only in the exit status.
|
Failure to acquire the lock is indicated only in the exit status.
|
||||||
.It Fl t Ar seconds
|
.It Fl t Ar seconds
|
||||||
Specifies a timeout for waiting for the lock. By default,
|
Specifies a timeout for waiting for the lock.
|
||||||
|
By default,
|
||||||
.Nm
|
.Nm
|
||||||
waits indefinitely to acquire the lock.
|
waits indefinitely to acquire the lock.
|
||||||
If a timeout is specified with this option,
|
If a timeout is specified with this option,
|
||||||
.Nm
|
.Nm
|
||||||
will wait at most the given number of
|
will wait at most the given number of
|
||||||
.Ar seconds
|
.Ar seconds
|
||||||
before giving up. A timeout of 0 may be given, in which case
|
before giving up.
|
||||||
|
A timeout of 0 may be given, in which case
|
||||||
.Nm
|
.Nm
|
||||||
will fail unless it can acquire the lock immediately.
|
will fail unless it can acquire the lock immediately.
|
||||||
.El
|
.El
|
||||||
|
@ -17,7 +17,8 @@ When someone logs in, the
|
|||||||
.Nm
|
.Nm
|
||||||
is scanned for the first entry that
|
is scanned for the first entry that
|
||||||
matches the (user, host) combination, or, in case of non-networked
|
matches the (user, host) combination, or, in case of non-networked
|
||||||
logins, the first entry that matches the (user, tty) combination. The
|
logins, the first entry that matches the (user, tty) combination.
|
||||||
|
The
|
||||||
permissions field of that table entry determines whether the login will
|
permissions field of that table entry determines whether the login will
|
||||||
be accepted or refused.
|
be accepted or refused.
|
||||||
.Pp
|
.Pp
|
||||||
@ -29,11 +30,13 @@ character:
|
|||||||
The first field should be a "+" (access granted) or "-" (access denied)
|
The first field should be a "+" (access granted) or "-" (access denied)
|
||||||
character.
|
character.
|
||||||
The second field should be a list of one or more login names,
|
The second field should be a list of one or more login names,
|
||||||
group names, or ALL (always matches). The third field should be a list
|
group names, or ALL (always matches).
|
||||||
|
The third field should be a list
|
||||||
of one or more tty names (for non-networked logins), host names, domain
|
of one or more tty names (for non-networked logins), host names, domain
|
||||||
names (begin with "."), host addresses, internet network numbers (end
|
names (begin with "."), host addresses, internet network numbers (end
|
||||||
with "."), ALL (always matches) or LOCAL (matches any string that does
|
with "."), ALL (always matches) or LOCAL (matches any string that does
|
||||||
not contain a "." character). If you run NIS you can use @netgroupname
|
not contain a "." character).
|
||||||
|
If you run NIS you can use @netgroupname
|
||||||
in host or user patterns.
|
in host or user patterns.
|
||||||
.Pp
|
.Pp
|
||||||
The EXCEPT operator makes it possible to write very compact rules.
|
The EXCEPT operator makes it possible to write very compact rules.
|
||||||
|
@ -68,12 +68,12 @@ alphabetic characters is ignored.
|
|||||||
The following options are available:
|
The following options are available:
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It Fl d
|
.It Fl d
|
||||||
Dictionary character set and order, i.e. only alphanumeric characters
|
Dictionary character set and order, i.e., only alphanumeric characters
|
||||||
are compared.
|
are compared.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Ignore the case of alphabetic characters.
|
Ignore the case of alphabetic characters.
|
||||||
.It Fl t
|
.It Fl t
|
||||||
Specify a string termination character, i.e. only the characters
|
Specify a string termination character, i.e., only the characters
|
||||||
in
|
in
|
||||||
.Ar string
|
.Ar string
|
||||||
up to and including the first occurrence of
|
up to and including the first occurrence of
|
||||||
|
@ -15,11 +15,13 @@
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
command lists information about the currently loaded virtual file system
|
command lists information about the currently loaded virtual file system
|
||||||
modules. When
|
modules.
|
||||||
|
When
|
||||||
.Ar vfsname
|
.Ar vfsname
|
||||||
arguments are given,
|
arguments are given,
|
||||||
.Nm
|
.Nm
|
||||||
lists information about the specified VFS modules. Otherwise,
|
lists information about the specified VFS modules.
|
||||||
|
Otherwise,
|
||||||
.Nm
|
.Nm
|
||||||
lists all currently loaded modules.
|
lists all currently loaded modules.
|
||||||
The information is as follows:
|
The information is as follows:
|
||||||
|
@ -248,7 +248,7 @@ argument is not found,
|
|||||||
returns \-1.
|
returns \-1.
|
||||||
.It Ic indir
|
.It Ic indir
|
||||||
Indirectly calls the macro whose name is passed as the first arguments,
|
Indirectly calls the macro whose name is passed as the first arguments,
|
||||||
with the remaining arguments passed as first, etc. arguments.
|
with the remaining arguments passed as first, etc.\& arguments.
|
||||||
.It Ic len
|
.It Ic len
|
||||||
Returns the number of characters in the first argument.
|
Returns the number of characters in the first argument.
|
||||||
Extra arguments
|
Extra arguments
|
||||||
|
@ -347,7 +347,7 @@ Append the value to the current value of the variable.
|
|||||||
.It Ic \&?=
|
.It Ic \&?=
|
||||||
Assign the value to the variable if it is not already defined.
|
Assign the value to the variable if it is not already defined.
|
||||||
.It Ic \&:=
|
.It Ic \&:=
|
||||||
Assign with expansion, i.e. expand the value before assigning it
|
Assign with expansion, i.e., expand the value before assigning it
|
||||||
to the variable.
|
to the variable.
|
||||||
Normally, expansion is not done until the variable is referenced.
|
Normally, expansion is not done until the variable is referenced.
|
||||||
.It Ic \&!=
|
.It Ic \&!=
|
||||||
@ -1058,7 +1058,7 @@ Loops are not being
|
|||||||
detected and targets that form loops will be silently ignored.
|
detected and targets that form loops will be silently ignored.
|
||||||
.El
|
.El
|
||||||
.Sh "SPECIAL TARGETS"
|
.Sh "SPECIAL TARGETS"
|
||||||
Special targets may not be included with other targets, i.e. they must be
|
Special targets may not be included with other targets, i.e., they must be
|
||||||
the only target specified.
|
the only target specified.
|
||||||
.Bl -tag -width Ic
|
.Bl -tag -width Ic
|
||||||
.It Ic .BEGIN
|
.It Ic .BEGIN
|
||||||
|
@ -44,7 +44,8 @@ utility starts
|
|||||||
only for file systems physically mounted on the system
|
only for file systems physically mounted on the system
|
||||||
where the
|
where the
|
||||||
.Nm
|
.Nm
|
||||||
is being executed. Running makewhatis
|
is being executed.
|
||||||
|
Running makewhatis
|
||||||
by
|
by
|
||||||
.Pa periodic weekly
|
.Pa periodic weekly
|
||||||
for rw nfs-mounted /usr may kill
|
for rw nfs-mounted /usr may kill
|
||||||
|
@ -39,7 +39,8 @@ The
|
|||||||
.Nm
|
.Nm
|
||||||
utility is a minimal implementation of the
|
utility is a minimal implementation of the
|
||||||
.Xr gzip 1
|
.Xr gzip 1
|
||||||
utility. It supports
|
utility.
|
||||||
|
It supports
|
||||||
compression and decompression of individual files, as well as
|
compression and decompression of individual files, as well as
|
||||||
streaming compression and decompression via standard input and
|
streaming compression and decompression via standard input and
|
||||||
output.
|
output.
|
||||||
@ -52,9 +53,11 @@ flag on the commandline.
|
|||||||
If any
|
If any
|
||||||
.Ar file
|
.Ar file
|
||||||
arguments are supplied, the operation is performed on each file
|
arguments are supplied, the operation is performed on each file
|
||||||
separately. Compression replaces the original file with one having a
|
separately.
|
||||||
|
Compression replaces the original file with one having a
|
||||||
.Pa .gz
|
.Pa .gz
|
||||||
suffix. Decompression will remove a
|
suffix.
|
||||||
|
Decompression will remove a
|
||||||
.Pa .gz
|
.Pa .gz
|
||||||
suffix if one is present.
|
suffix if one is present.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -63,7 +63,8 @@ where the macro SRCS is the list of C source files and the macro
|
|||||||
CFLAGS is the list of flags for the C compiler.
|
CFLAGS is the list of flags for the C compiler.
|
||||||
.Pp
|
.Pp
|
||||||
The user has the ability to change the preprocessor and preprocessor options
|
The user has the ability to change the preprocessor and preprocessor options
|
||||||
used. For instance, to use gcc as the preprocessor and to ignore system
|
used.
|
||||||
|
For instance, to use gcc as the preprocessor and to ignore system
|
||||||
headers, one would use
|
headers, one would use
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
depend:
|
depend:
|
||||||
@ -101,12 +102,15 @@ module.
|
|||||||
.Sh ENVIRONMENT
|
.Sh ENVIRONMENT
|
||||||
.Bl -tag -width MKDEP_CPP_OPTS
|
.Bl -tag -width MKDEP_CPP_OPTS
|
||||||
.It Ev CC
|
.It Ev CC
|
||||||
Specifies the C compiler to use. The specified compiler is expected to have
|
Specifies the C compiler to use.
|
||||||
|
The specified compiler is expected to have
|
||||||
options consistent with the GNU C compiler.
|
options consistent with the GNU C compiler.
|
||||||
.It Ev MKDEP_CPP
|
.It Ev MKDEP_CPP
|
||||||
Specifies the preprocessor to use. The default is "${CC} -E".
|
Specifies the preprocessor to use.
|
||||||
|
The default is "${CC} -E".
|
||||||
.It Ev MKDEP_CPP_OPTS
|
.It Ev MKDEP_CPP_OPTS
|
||||||
Specifies the non-CFLAGS options for the preprocessor. The default is
|
Specifies the non-CFLAGS options for the preprocessor.
|
||||||
|
The default is
|
||||||
"-M".
|
"-M".
|
||||||
.El
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
|
@ -65,7 +65,8 @@ The format of
|
|||||||
.Ar src-file
|
.Ar src-file
|
||||||
is quite simple.
|
is quite simple.
|
||||||
It consists of a series of lines which start with a keyword and have
|
It consists of a series of lines which start with a keyword and have
|
||||||
associated data following. C style comments are used
|
associated data following.
|
||||||
|
C style comments are used
|
||||||
to place comments in the file.
|
to place comments in the file.
|
||||||
.Pp
|
.Pp
|
||||||
Following options are available:
|
Following options are available:
|
||||||
@ -121,9 +122,11 @@ Used to indicate ranges.
|
|||||||
The follow characters are taken literally:
|
The follow characters are taken literally:
|
||||||
.Bl -tag -width ".Dv <\|\|(\|\|["
|
.Bl -tag -width ".Dv <\|\|(\|\|["
|
||||||
.It Dv "<\|(\|["
|
.It Dv "<\|(\|["
|
||||||
Used to start a mapping. All are equivalent.
|
Used to start a mapping.
|
||||||
|
All are equivalent.
|
||||||
.It Dv ">\|\^)\|]"
|
.It Dv ">\|\^)\|]"
|
||||||
Used to end a mapping. All are equivalent.
|
Used to end a mapping.
|
||||||
|
All are equivalent.
|
||||||
.It Dv :
|
.It Dv :
|
||||||
Used as a delimiter in mappings.
|
Used as a delimiter in mappings.
|
||||||
.El
|
.El
|
||||||
|
@ -54,8 +54,10 @@
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility takes each of the given file name templates and overwrites a
|
utility takes each of the given file name templates and overwrites a
|
||||||
portion of it to create a file name. This file name is unique
|
portion of it to create a file name.
|
||||||
and suitable for use by the application. The template may be
|
This file name is unique
|
||||||
|
and suitable for use by the application.
|
||||||
|
The template may be
|
||||||
any file name with some number of
|
any file name with some number of
|
||||||
.Ql X Ns s
|
.Ql X Ns s
|
||||||
appended
|
appended
|
||||||
@ -110,12 +112,16 @@ The
|
|||||||
.Nm
|
.Nm
|
||||||
utility is provided to allow shell scripts to safely use temporary files.
|
utility is provided to allow shell scripts to safely use temporary files.
|
||||||
Traditionally, many shell scripts take the name of the program with
|
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
|
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
|
kind of naming scheme is predictable and the race condition it creates
|
||||||
is easy for an attacker to win. A safer, though still inferior, approach
|
is easy for an attacker to win.
|
||||||
is to make a temporary directory using the same naming scheme. While
|
A safer, though still inferior, approach
|
||||||
|
is to make a temporary directory using the same naming scheme.
|
||||||
|
While
|
||||||
this does allow one to guarantee that a temporary file will not be
|
this does allow one to guarantee that a temporary file will not be
|
||||||
subverted, it still allows a simple denial of service attack. For these
|
subverted, it still allows a simple denial of service attack.
|
||||||
|
For these
|
||||||
reasons it is suggested that
|
reasons it is suggested that
|
||||||
.Nm
|
.Nm
|
||||||
be used instead.
|
be used instead.
|
||||||
@ -125,7 +131,8 @@ The available options are as follows:
|
|||||||
.It Fl d
|
.It Fl d
|
||||||
Make a directory instead of a file.
|
Make a directory instead of a file.
|
||||||
.It Fl q
|
.It Fl q
|
||||||
Fail silently if an error occurs. This is useful if
|
Fail silently if an error occurs.
|
||||||
|
This is useful if
|
||||||
a script does not want error output to go to standard error.
|
a script does not want error output to go to standard error.
|
||||||
.It Fl t Ar prefix
|
.It Fl t Ar prefix
|
||||||
Generate a template (using the supplied
|
Generate a template (using the supplied
|
||||||
@ -136,11 +143,14 @@ if set) to create a filename template.
|
|||||||
.It Fl u
|
.It Fl u
|
||||||
Operate in
|
Operate in
|
||||||
.Dq unsafe
|
.Dq unsafe
|
||||||
mode. The temp file will be unlinked before
|
mode.
|
||||||
|
The temp file will be unlinked before
|
||||||
.Nm
|
.Nm
|
||||||
exits. This is slightly better than
|
exits.
|
||||||
|
This is slightly better than
|
||||||
.Xr mktemp 3
|
.Xr mktemp 3
|
||||||
but still introduces a race condition. Use of this
|
but still introduces a race condition.
|
||||||
|
Use of this
|
||||||
option is not encouraged.
|
option is not encouraged.
|
||||||
.El
|
.El
|
||||||
.Sh DIAGNOSTICS
|
.Sh DIAGNOSTICS
|
||||||
|
@ -50,7 +50,8 @@ The
|
|||||||
utility is used to give commands to a magnetic tape drive.
|
utility is used to give commands to a magnetic tape drive.
|
||||||
By default
|
By default
|
||||||
.Nm
|
.Nm
|
||||||
performs the requested operation once. Operations
|
performs the requested operation once.
|
||||||
|
Operations
|
||||||
may be performed multiple times by specifying
|
may be performed multiple times by specifying
|
||||||
.Ar count .
|
.Ar count .
|
||||||
Note
|
Note
|
||||||
@ -58,7 +59,8 @@ that
|
|||||||
.Ar tapename
|
.Ar tapename
|
||||||
must reference a raw (not block) tape device.
|
must reference a raw (not block) tape device.
|
||||||
.Pp
|
.Pp
|
||||||
The available commands are listed below. Only as many
|
The available commands are listed below.
|
||||||
|
Only as many
|
||||||
characters as are required to uniquely identify a command
|
characters as are required to uniquely identify a command
|
||||||
need be specified.
|
need be specified.
|
||||||
.Bl -tag -width "eof, weof"
|
.Bl -tag -width "eof, weof"
|
||||||
@ -146,19 +148,24 @@ Print (and clear) error status information about this device.
|
|||||||
For every normal
|
For every normal
|
||||||
operation (e.g., a read or a write) and every control operation (e.g,, a
|
operation (e.g., a read or a write) and every control operation (e.g,, a
|
||||||
rewind), the driver stores up the last command executed and it's associated
|
rewind), the driver stores up the last command executed and it's associated
|
||||||
status and any residual counts (if any). This command retrieves and prints this
|
status and any residual counts (if any).
|
||||||
|
This command retrieves and prints this
|
||||||
information.
|
information.
|
||||||
If possible, this also clears any latched error information.
|
If possible, this also clears any latched error information.
|
||||||
.It Cm blocksize
|
.It Cm blocksize
|
||||||
Set the block size for the tape unit. Zero means variable-length
|
Set the block size for the tape unit.
|
||||||
|
Zero means variable-length
|
||||||
blocks.
|
blocks.
|
||||||
.It Cm density
|
.It Cm density
|
||||||
Set the density for the tape unit. For the density codes, see below.
|
Set the density for the tape unit.
|
||||||
|
For the density codes, see below.
|
||||||
The density value could be given either numerically, or as a string,
|
The density value could be given either numerically, or as a string,
|
||||||
corresponding to the
|
corresponding to the
|
||||||
.Dq Reference
|
.Dq Reference
|
||||||
field. If the string is abbreviated, it will be resolved in the order
|
field.
|
||||||
shown in the table, and the first matching entry will be used. If the
|
If the string is abbreviated, it will be resolved in the order
|
||||||
|
shown in the table, and the first matching entry will be used.
|
||||||
|
If the
|
||||||
given string and the resulting canonical density name do not match
|
given string and the resulting canonical density name do not match
|
||||||
exactly, an informational message is printed about what the given
|
exactly, an informational message is printed about what the given
|
||||||
string has been taken for.
|
string has been taken for.
|
||||||
@ -209,11 +216,13 @@ DCLZ compression algorithm (0x20).
|
|||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
In addition to the above recognized compression keywords, the user can
|
In addition to the above recognized compression keywords, the user can
|
||||||
supply a numeric compression algorithm for the tape drive to use. In most
|
supply a numeric compression algorithm for the tape drive to use.
|
||||||
|
In most
|
||||||
cases, simply turning the compression
|
cases, simply turning the compression
|
||||||
.Sq on
|
.Sq on
|
||||||
will have the desired effect of enabling the default compression algorithm
|
will have the desired effect of enabling the default compression algorithm
|
||||||
supported by the drive. If this is not the case (see the
|
supported by the drive.
|
||||||
|
If this is not the case (see the
|
||||||
.Cm status
|
.Cm status
|
||||||
display to see which compression algorithm is currently in use), the user
|
display to see which compression algorithm is currently in use), the user
|
||||||
can manually specify one of the supported compression keywords (above), or
|
can manually specify one of the supported compression keywords (above), or
|
||||||
|
@ -85,7 +85,8 @@ associated with the
|
|||||||
If not specified,
|
If not specified,
|
||||||
.Nm ncal
|
.Nm ncal
|
||||||
tries to guess the switch date from the local environment or
|
tries to guess the switch date from the local environment or
|
||||||
falls back to September 2, 1752. This was when Great
|
falls back to September 2, 1752.
|
||||||
|
This was when Great
|
||||||
Britain and her colonies switched to the Gregorian Calendar.
|
Britain and her colonies switched to the Gregorian Calendar.
|
||||||
.It Fl w
|
.It Fl w
|
||||||
Print the number of the week below each week column.
|
Print the number of the week below each week column.
|
||||||
|
@ -19,7 +19,7 @@ The
|
|||||||
utility will schedule a connection created by
|
utility will schedule a connection created by
|
||||||
.Xr ncplogin 1
|
.Xr ncplogin 1
|
||||||
command to be closed.
|
command to be closed.
|
||||||
If the connection is busy (i.e. used by other processes) it will
|
If the connection is busy (i.e., used by other processes) it will
|
||||||
be closed when the last process using it is terminated.
|
be closed when the last process using it is terminated.
|
||||||
This command is similar to the
|
This command is similar to the
|
||||||
.Tn DOS
|
.Tn DOS
|
||||||
|
@ -67,7 +67,8 @@ Extract the name list from the specified system instead of the default
|
|||||||
.It Fl s
|
.It Fl s
|
||||||
Only display server side statistics
|
Only display server side statistics
|
||||||
.It Fl W
|
.It Fl W
|
||||||
Use wide format with interval short summary. This option is especially
|
Use wide format with interval short summary.
|
||||||
|
This option is especially
|
||||||
useful when combined with -c or -s and a time delay.
|
useful when combined with -c or -s and a time delay.
|
||||||
.It Fl w
|
.It Fl w
|
||||||
Display a shorter summary of
|
Display a shorter summary of
|
||||||
|
@ -89,8 +89,10 @@ The
|
|||||||
.Nm
|
.Nm
|
||||||
utility treats the text it reads in terms of logical pages.
|
utility treats the text it reads in terms of logical pages.
|
||||||
Unless specified otherwise, line numbering is reset at the start of each
|
Unless specified otherwise, line numbering is reset at the start of each
|
||||||
logical page. A logical page consists of a header, a body and a footer
|
logical page.
|
||||||
section; empty sections are valid. Different line numbering options are
|
A logical page consists of a header, a body and a footer
|
||||||
|
section; empty sections are valid.
|
||||||
|
Different line numbering options are
|
||||||
independently available for header, body and footer sections.
|
independently available for header, body and footer sections.
|
||||||
.Pp
|
.Pp
|
||||||
The starts of logical page sections are signalled by input lines containing
|
The starts of logical page sections are signalled by input lines containing
|
||||||
@ -132,7 +134,8 @@ for logical page body lines is
|
|||||||
.Cm t .
|
.Cm t .
|
||||||
.It Fl d Ar delim
|
.It Fl d Ar delim
|
||||||
Specify the delimiter characters used to indicate the start of a logical
|
Specify the delimiter characters used to indicate the start of a logical
|
||||||
page section in the input file. At most two characters may be specified;
|
page section in the input file.
|
||||||
|
At most two characters may be specified;
|
||||||
if only one character is specified, the first character is replaced and the
|
if only one character is specified, the first character is replaced and the
|
||||||
second character remains unchanged.
|
second character remains unchanged.
|
||||||
The default
|
The default
|
||||||
|
@ -76,10 +76,12 @@ The new password should contain a mixture of upper and lower case
|
|||||||
characters (which may be overridden using the
|
characters (which may be overridden using the
|
||||||
.Xr login.conf 5
|
.Xr login.conf 5
|
||||||
.Dq mixpasswordcase
|
.Dq mixpasswordcase
|
||||||
setting for a user's login class). Allowing lower case passwords may
|
setting for a user's login class).
|
||||||
|
Allowing lower case passwords may
|
||||||
be useful where the password file will be used in situations where only
|
be useful where the password file will be used in situations where only
|
||||||
lower case passwords are permissible, such as when using Samba to
|
lower case passwords are permissible, such as when using Samba to
|
||||||
authenticate Windows clients. In all other situations, numbers, upper
|
authenticate Windows clients.
|
||||||
|
In all other situations, numbers, upper
|
||||||
case letters and meta characters are encouraged.
|
case letters and meta characters are encouraged.
|
||||||
.Pp
|
.Pp
|
||||||
Once the password has been verified,
|
Once the password has been verified,
|
||||||
|
@ -131,22 +131,26 @@ For
|
|||||||
.Cm c , d ,
|
.Cm c , d ,
|
||||||
and
|
and
|
||||||
.Cm s ,
|
.Cm s ,
|
||||||
formats, this option has no effect. For the
|
formats, this option has no effect.
|
||||||
|
For the
|
||||||
.Cm o
|
.Cm o
|
||||||
formats the precision of the number is increased to force the first
|
formats 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
|
.Cm x
|
||||||
.Pq Cm X
|
.Pq Cm X
|
||||||
format, a non-zero result has the string
|
format, a non-zero result has the string
|
||||||
.Li 0x
|
.Li 0x
|
||||||
.Pq Li 0X
|
.Pq Li 0X
|
||||||
prepended to it. For
|
prepended to it.
|
||||||
|
For
|
||||||
.Cm e , E , f , g ,
|
.Cm e , E , f , g ,
|
||||||
and
|
and
|
||||||
.Cm G ,
|
.Cm G ,
|
||||||
formats, the result will always contain a decimal point, even if no
|
formats, the result will always contain a decimal point, even if no
|
||||||
digits follow the point (normally, a decimal point only appears in the
|
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
|
.Cm g
|
||||||
and
|
and
|
||||||
.Cm G
|
.Cm G
|
||||||
@ -161,10 +165,12 @@ A `+' character specifying that there should always be
|
|||||||
a sign placed before the number when using signed formats.
|
a sign placed before the number when using signed formats.
|
||||||
.It Sq \&\ \&
|
.It Sq \&\ \&
|
||||||
A space specifying that a blank should be left before a positive number
|
A space specifying that a blank should be left before a positive number
|
||||||
for a signed format. A `+' overrides a space if both are used;
|
for a signed format.
|
||||||
|
A `+' overrides a space if both are used;
|
||||||
.It Cm \&0
|
.It Cm \&0
|
||||||
A zero `0' character indicating that zero-padding should be used
|
A zero `0' character indicating that zero-padding should be used
|
||||||
rather than blank-padding. A `\-' overrides a `0' if both are used;
|
rather than blank-padding.
|
||||||
|
A `\-' overrides a `0' if both are used;
|
||||||
.El
|
.El
|
||||||
.It "Field Width:"
|
.It "Field Width:"
|
||||||
An optional digit string specifying a
|
An optional digit string specifying a
|
||||||
@ -324,7 +330,8 @@ then back again, floating-point precision may be lost.
|
|||||||
.Tn ANSI
|
.Tn ANSI
|
||||||
hexadecimal character constants were deliberately not provided.
|
hexadecimal character constants were deliberately not provided.
|
||||||
.Pp
|
.Pp
|
||||||
The escape sequence \e000 is the string terminator. When present in the
|
The escape sequence \e000 is the string terminator.
|
||||||
|
When present in the
|
||||||
.Ar format ,
|
.Ar format ,
|
||||||
the
|
the
|
||||||
.Ar format
|
.Ar format
|
||||||
|
@ -90,7 +90,8 @@ This specification may be as a literal character, or as an octal
|
|||||||
value in the form \ennn.
|
value in the form \ennn.
|
||||||
.It Fl i
|
.It Fl i
|
||||||
Allow the caller to specify a different local name to be used
|
Allow the caller to specify a different local name to be used
|
||||||
for authentication. This option is restricted to processes with uid 0.
|
for authentication.
|
||||||
|
This option is restricted to processes with uid 0.
|
||||||
.It Fl l
|
.It Fl l
|
||||||
Specify a different
|
Specify a different
|
||||||
.Ar username
|
.Ar username
|
||||||
|
@ -260,7 +260,8 @@ routines.
|
|||||||
.It Fl C
|
.It Fl C
|
||||||
Generate header and stub files which can be used with
|
Generate header and stub files which can be used with
|
||||||
.Tn ANSI
|
.Tn ANSI
|
||||||
C compilers. Headers generated with this flag can also be
|
C compilers.
|
||||||
|
Headers generated with this flag can also be
|
||||||
used with C++ programs.
|
used with C++ programs.
|
||||||
.It Fl D Ns Ar name
|
.It Fl D Ns Ar name
|
||||||
.It Fl D Ns Ar name=value
|
.It Fl D Ns Ar name=value
|
||||||
@ -294,7 +295,8 @@ Note: in order to provide backwards compatibility with the older
|
|||||||
on the
|
on the
|
||||||
.Fx
|
.Fx
|
||||||
platform, the default is actually 0 (which means
|
platform, the default is actually 0 (which means
|
||||||
that inline code generation is disabled by default). You must specify
|
that inline code generation is disabled by default).
|
||||||
|
You must specify
|
||||||
a non-zero value explicitly to override this default.
|
a non-zero value explicitly to override this default.
|
||||||
.It Fl I
|
.It Fl I
|
||||||
Compile support for
|
Compile support for
|
||||||
|
@ -106,7 +106,8 @@ This may introduce a significant delay in response time.
|
|||||||
.It Fl t Ar timeout
|
.It Fl t Ar timeout
|
||||||
Allow a
|
Allow a
|
||||||
.Ar timeout
|
.Ar timeout
|
||||||
to be specified (in seconds). If no
|
to be specified (in seconds).
|
||||||
|
If no
|
||||||
data is sent or received in this time,
|
data is sent or received in this time,
|
||||||
.Nm
|
.Nm
|
||||||
will exit.
|
will exit.
|
||||||
|
@ -75,14 +75,16 @@ The
|
|||||||
.Xr rpc.rstatd 8
|
.Xr rpc.rstatd 8
|
||||||
daemon has not been started on the remote host.
|
daemon has not been started on the remote host.
|
||||||
.It rup: RPC: Timed out
|
.It rup: RPC: Timed out
|
||||||
A communication error occurred. Either the network is
|
A communication error occurred.
|
||||||
|
Either the network is
|
||||||
excessively congested, or the
|
excessively congested, or the
|
||||||
.Xr rpc.rstatd 8
|
.Xr rpc.rstatd 8
|
||||||
daemon has terminated on the remote host.
|
daemon has terminated on the remote host.
|
||||||
.It rup: RPC: Port mapper failure - RPC: Timed out
|
.It rup: RPC: Port mapper failure - RPC: Timed out
|
||||||
The remote host is not running the portmapper (see
|
The remote host is not running the portmapper (see
|
||||||
.Xr rpcbind 8 ) ,
|
.Xr rpcbind 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
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr rpc.rstatd 8 ,
|
.Xr rpc.rstatd 8 ,
|
||||||
|
@ -64,7 +64,8 @@ report has been received for 4 days are not shown in the list at all.
|
|||||||
The options are as follows:
|
The options are as follows:
|
||||||
.Bl -tag -width Ds
|
.Bl -tag -width Ds
|
||||||
.It Fl a
|
.It Fl a
|
||||||
Include all users. By default, if a user hasn't typed to the system for
|
Include all users.
|
||||||
|
By default, if a user hasn't typed to the system for
|
||||||
an hour or more, then the user will be omitted from the output.
|
an hour or more, then the user will be omitted from the output.
|
||||||
.It Fl l
|
.It Fl l
|
||||||
Sort by load average.
|
Sort by load average.
|
||||||
|
@ -81,14 +81,16 @@ The
|
|||||||
.Xr rpc.rusersd 8
|
.Xr rpc.rusersd 8
|
||||||
daemon has not been started on the remote host.
|
daemon has not been started on the remote host.
|
||||||
.It rusers: RPC: Timed out
|
.It rusers: RPC: Timed out
|
||||||
A communication error occurred. Either the network is
|
A communication error occurred.
|
||||||
|
Either the network is
|
||||||
excessively congested, or the
|
excessively congested, or the
|
||||||
.Xr rpc.rusersd 8
|
.Xr rpc.rusersd 8
|
||||||
daemon has terminated on the remote host.
|
daemon has terminated on the remote host.
|
||||||
.It rusers: "RPC: Port mapper failure - RPC: Timed out"
|
.It rusers: "RPC: Port mapper failure - RPC: Timed out"
|
||||||
The remote host is not running the portmapper (see
|
The remote host is not running the portmapper (see
|
||||||
.Xr rpcbind 8 ) ,
|
.Xr rpcbind 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
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr rwho 1 ,
|
.Xr rwho 1 ,
|
||||||
|
@ -58,14 +58,16 @@ The
|
|||||||
.Xr rpc.rwalld 8
|
.Xr rpc.rwalld 8
|
||||||
daemon has not been started on the remote host.
|
daemon has not been started on the remote host.
|
||||||
.It rwall: RPC: Timed out
|
.It rwall: RPC: Timed out
|
||||||
A communication error occurred. Either the network is
|
A communication error occurred.
|
||||||
|
Either the network is
|
||||||
excessively congested, or the
|
excessively congested, or the
|
||||||
.Xr rpc.rwalld 8
|
.Xr rpc.rwalld 8
|
||||||
daemon has terminated on the remote host.
|
daemon has terminated on the remote host.
|
||||||
.It rwall: RPC: Port mapper failure - RPC: Timed out
|
.It rwall: RPC: Port mapper failure - RPC: Timed out
|
||||||
The remote host is not running the portmapper (see
|
The remote host is not running the portmapper (see
|
||||||
.Xr rpcbind 8 ) ,
|
.Xr rpcbind 8 ) ,
|
||||||
and cannot accomodate any RPC-based services. The host may be down.
|
and cannot accomodate any RPC-based services.
|
||||||
|
The host may be down.
|
||||||
.El
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr who 1 ,
|
.Xr who 1 ,
|
||||||
|
@ -81,10 +81,12 @@ Log keys sent to program as well as output.
|
|||||||
.It Fl q
|
.It Fl q
|
||||||
Run in quiet mode, omit the start and stop status messages.
|
Run in quiet mode, omit the start and stop status messages.
|
||||||
.It Fl t Ar time
|
.It Fl t Ar time
|
||||||
Specify time interval between flushing script output file. A value of 0
|
Specify time interval between flushing script output file.
|
||||||
|
A value of 0
|
||||||
causes
|
causes
|
||||||
.Nm
|
.Nm
|
||||||
to flush for every character I/O event. The default interval is
|
to flush for every character I/O event.
|
||||||
|
The default interval is
|
||||||
30 seconds.
|
30 seconds.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
@ -150,6 +152,8 @@ because of argument parsing compatibility issues.
|
|||||||
.Pp
|
.Pp
|
||||||
When running in
|
When running in
|
||||||
.Fl k
|
.Fl k
|
||||||
mode, echo cancelling is far from ideal. The slave terminal mode is checked
|
mode, echo cancelling is far from ideal.
|
||||||
for ECHO mode to check when to avoid manual echo logging. This does not
|
The slave terminal mode is checked
|
||||||
|
for ECHO mode to check when to avoid manual echo logging.
|
||||||
|
This does not
|
||||||
work when in a raw mode where the program being run is doing manual echo.
|
work when in a raw mode where the program being run is doing manual echo.
|
||||||
|
@ -155,16 +155,21 @@ A command line with no addresses selects every pattern space.
|
|||||||
A command line with one address selects all of the pattern spaces
|
A command line with one address selects all of the pattern spaces
|
||||||
that match the address.
|
that match the address.
|
||||||
.Pp
|
.Pp
|
||||||
A command line with two addresses selects an inclusive range. This
|
A command line with two addresses selects an inclusive range.
|
||||||
|
This
|
||||||
range starts with the first pattern space that matches the first
|
range starts with the first pattern space that matches the first
|
||||||
address. The end of the range is the next following pattern space
|
address.
|
||||||
that matches the second address. If the second address is a number
|
The end of the range is the next following pattern space
|
||||||
|
that matches the second address.
|
||||||
|
If the second address is a number
|
||||||
less than or equal to the line number first selected, only that
|
less than or equal to the line number first selected, only that
|
||||||
line is selected. In the case when the second address is a context
|
line is selected.
|
||||||
|
In the case when the second address is a context
|
||||||
address,
|
address,
|
||||||
.Nm
|
.Nm
|
||||||
does not re-match the second address against the
|
does not re-match the second address against the
|
||||||
pattern space that matched the first address. Starting at the
|
pattern space that matched the first address.
|
||||||
|
Starting at the
|
||||||
first line following the selected range,
|
first line following the selected range,
|
||||||
.Nm
|
.Nm
|
||||||
starts looking again for the first address.
|
starts looking again for the first address.
|
||||||
@ -212,7 +217,7 @@ One special feature of
|
|||||||
.Nm
|
.Nm
|
||||||
regular expressions is that they can default to the last regular
|
regular expressions is that they can default to the last regular
|
||||||
expression used.
|
expression used.
|
||||||
If a regular expression is empty, i.e. just the delimiter characters
|
If a regular expression is empty, i.e., just the delimiter characters
|
||||||
are specified, the last regular expression encountered is used instead.
|
are specified, the last regular expression encountered is used instead.
|
||||||
The last regular expression is defined as the last regular expression
|
The last regular expression is defined as the last regular expression
|
||||||
used as part of an address or substitute command, and at run-time, not
|
used as part of an address or substitute command, and at run-time, not
|
||||||
@ -537,7 +542,9 @@ extension and may not be available on other operating systems.
|
|||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
A
|
A
|
||||||
.Nm
|
.Nm
|
||||||
command, written by L. E. McMahon, appeared in
|
command, written by
|
||||||
|
.An L. E. McMahon ,
|
||||||
|
appeared in
|
||||||
.At v7 .
|
.At v7 .
|
||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
.An "Diomidis D. Spinellis" Aq dds@FreeBSD.org
|
.An "Diomidis D. Spinellis" Aq dds@FreeBSD.org
|
||||||
|
@ -204,7 +204,8 @@ You will be asked for man's password unless your real UID is 0.
|
|||||||
Same as above, but the target command consists of more than a
|
Same as above, but the target command consists of more than a
|
||||||
single word and hence is quoted for use with the
|
single word and hence is quoted for use with the
|
||||||
.Fl c
|
.Fl c
|
||||||
option being passed to the shell. (Most shells expect the argument to
|
option being passed to the shell.
|
||||||
|
(Most shells expect the argument to
|
||||||
.Fl c
|
.Fl c
|
||||||
to be a single word).
|
to be a single word).
|
||||||
.It Li "su -c staff man -c 'catman /usr/share/man /usr/local/man /usr/X11R6/man'"
|
.It Li "su -c staff man -c 'catman /usr/share/man /usr/local/man /usr/X11R6/man'"
|
||||||
|
@ -52,16 +52,20 @@ using the curses screen display library,
|
|||||||
While
|
While
|
||||||
.Nm
|
.Nm
|
||||||
is running the screen is usually divided into two windows (an exception
|
is running the screen is usually divided into two windows (an exception
|
||||||
is the vmstat display which uses the entire screen). The
|
is the vmstat display which uses the entire screen).
|
||||||
upper window depicts the current system load average. The
|
The
|
||||||
|
upper window depicts the current system load average.
|
||||||
|
The
|
||||||
information displayed in the lower window may vary, depending on
|
information displayed in the lower window may vary, depending on
|
||||||
user commands. The last line on the screen is reserved for user
|
user commands.
|
||||||
|
The last line on the screen is reserved for user
|
||||||
input and error messages.
|
input and error messages.
|
||||||
.Pp
|
.Pp
|
||||||
By default
|
By default
|
||||||
.Nm
|
.Nm
|
||||||
displays the processes getting the largest percentage of the processor
|
displays the processes getting the largest percentage of the processor
|
||||||
in the lower window. Other displays show swap space usage, disk
|
in the lower window.
|
||||||
|
Other displays show swap space usage, disk
|
||||||
.Tn I/O
|
.Tn I/O
|
||||||
statistics (a la
|
statistics (a la
|
||||||
.Xr iostat 8 ) ,
|
.Xr iostat 8 ) ,
|
||||||
@ -76,7 +80,8 @@ and network connections (a la
|
|||||||
Input is interpreted at two different levels.
|
Input is interpreted at two different levels.
|
||||||
A ``global'' command interpreter processes all keyboard input.
|
A ``global'' command interpreter processes all keyboard input.
|
||||||
If this command interpreter fails to recognize a command, the
|
If this command interpreter fails to recognize a command, the
|
||||||
input line is passed to a per-display command interpreter. This
|
input line is passed to a per-display command interpreter.
|
||||||
|
This
|
||||||
allows each display to have certain display-specific commands.
|
allows each display to have certain display-specific commands.
|
||||||
.Pp
|
.Pp
|
||||||
Command line options:
|
Command line options:
|
||||||
@ -121,7 +126,8 @@ Print the name of the current ``display'' being shown in
|
|||||||
the lower window and the refresh interval.
|
the lower window and the refresh interval.
|
||||||
.It Ic \&:
|
.It Ic \&:
|
||||||
Move the cursor to the command line and interpret the input
|
Move the cursor to the command line and interpret the input
|
||||||
line typed as a command. While entering a command the
|
line typed as a command.
|
||||||
|
While entering a command the
|
||||||
current character erase, word erase, and line kill characters
|
current character erase, word erase, and line kill characters
|
||||||
may be used.
|
may be used.
|
||||||
.El
|
.El
|
||||||
@ -140,7 +146,8 @@ Stop refreshing the screen.
|
|||||||
.Op Ic start
|
.Op Ic start
|
||||||
.Op Ar number
|
.Op Ar number
|
||||||
.Xc
|
.Xc
|
||||||
Start (continue) refreshing the screen. If a second, numeric,
|
Start (continue) refreshing the screen.
|
||||||
|
If a second, numeric,
|
||||||
argument is provided it is interpreted as a refresh interval
|
argument is provided it is interpreted as a refresh interval
|
||||||
(in seconds).
|
(in seconds).
|
||||||
Supplying only a number will set the refresh interval to this
|
Supplying only a number will set the refresh interval to this
|
||||||
@ -194,7 +201,8 @@ The
|
|||||||
.Ic reset
|
.Ic reset
|
||||||
command resets the baseline for
|
command resets the baseline for
|
||||||
.Ic since
|
.Ic since
|
||||||
mode. The
|
mode.
|
||||||
|
The
|
||||||
.Ic mode
|
.Ic mode
|
||||||
command with no argument will display the current mode in the command
|
command with no argument will display the current mode in the command
|
||||||
line.
|
line.
|
||||||
@ -228,15 +236,19 @@ but with
|
|||||||
statistics.
|
statistics.
|
||||||
.It Ic iostat
|
.It Ic iostat
|
||||||
Display, in the lower window, statistics about processor use
|
Display, in the lower window, statistics about processor use
|
||||||
and disk throughput. Statistics on processor use appear as
|
and disk throughput.
|
||||||
|
Statistics on processor use appear as
|
||||||
bar graphs of the amount of time executing in user mode (``user''),
|
bar graphs of the amount of time executing in user mode (``user''),
|
||||||
in user mode running low priority processes (``nice''), in
|
in user mode running low priority processes (``nice''), in
|
||||||
system mode (``system''), in interrupt mode (``interrupt''),
|
system mode (``system''), in interrupt mode (``interrupt''),
|
||||||
and idle (``idle''). Statistics
|
and idle (``idle'').
|
||||||
|
Statistics
|
||||||
on disk throughput show, for each drive, megabytes per second,
|
on disk throughput show, for each drive, megabytes per second,
|
||||||
average number of disk transactions per second, and
|
average number of disk transactions per second, and
|
||||||
average kilobytes of data per transaction. This information may be
|
average kilobytes of data per transaction.
|
||||||
displayed as bar graphs or as rows of numbers which scroll downward. Bar
|
This information may be
|
||||||
|
displayed as bar graphs or as rows of numbers which scroll downward.
|
||||||
|
Bar
|
||||||
graphs are shown by default.
|
graphs are shown by default.
|
||||||
.Pp
|
.Pp
|
||||||
The following commands are specific to the
|
The following commands are specific to the
|
||||||
@ -247,7 +259,8 @@ display; the minimum unambiguous prefix may be supplied.
|
|||||||
.It Cm numbers
|
.It Cm numbers
|
||||||
Show the disk
|
Show the disk
|
||||||
.Tn I/O
|
.Tn I/O
|
||||||
statistics in numeric form. Values are
|
statistics in numeric form.
|
||||||
|
Values are
|
||||||
displayed in numeric columns which scroll downward.
|
displayed in numeric columns which scroll downward.
|
||||||
.It Cm bars
|
.It Cm bars
|
||||||
Show the disk
|
Show the disk
|
||||||
@ -272,7 +285,7 @@ a total line is also shown.
|
|||||||
Areas known to the kernel, but not in use are shown as not available.
|
Areas known to the kernel, but not in use are shown as not available.
|
||||||
.It Ic mbufs
|
.It Ic mbufs
|
||||||
Display, in the lower window, the number of mbufs allocated
|
Display, in the lower window, the number of mbufs allocated
|
||||||
for particular uses, i.e. data, socket structures, etc.
|
for particular uses, i.e., data, socket structures, etc.
|
||||||
.It Ic vmstat
|
.It Ic vmstat
|
||||||
Take over the entire display and show a (rather crowded) compendium
|
Take over the entire display and show a (rather crowded) compendium
|
||||||
of statistics related to virtual memory usage, process scheduling,
|
of statistics related to virtual memory usage, process scheduling,
|
||||||
@ -325,9 +338,12 @@ It reports the number of
|
|||||||
kilobytes per transaction, transactions per second, megabytes
|
kilobytes per transaction, transactions per second, megabytes
|
||||||
per second and the percentage of the time the disk was busy averaged
|
per second and the percentage of the time the disk was busy averaged
|
||||||
over the refresh period of the display (by default, five seconds).
|
over the refresh period of the display (by default, five seconds).
|
||||||
The system keeps statistics on most every storage device. In general, up
|
The system keeps statistics on most every storage device.
|
||||||
to seven devices are displayed. The devices displayed by default are the
|
In general, up
|
||||||
first devices in the kernel's device list. See
|
to seven devices are displayed.
|
||||||
|
The devices displayed by default are the
|
||||||
|
first devices in the kernel's device list.
|
||||||
|
See
|
||||||
.Xr devstat 3
|
.Xr devstat 3
|
||||||
and
|
and
|
||||||
.Xr devstat 9
|
.Xr devstat 9
|
||||||
@ -400,10 +416,13 @@ Toggle the display of fd devices in the disk usage display.
|
|||||||
Reset running statistics to zero.
|
Reset running statistics to zero.
|
||||||
.El
|
.El
|
||||||
.It Ic netstat
|
.It Ic netstat
|
||||||
Display, in the lower window, network connections. By default,
|
Display, in the lower window, network connections.
|
||||||
network servers awaiting requests are not displayed. Each address
|
By default,
|
||||||
|
network servers awaiting requests are not displayed.
|
||||||
|
Each address
|
||||||
is displayed in the format ``host.port'', with each shown symbolically,
|
is displayed in the format ``host.port'', with each shown symbolically,
|
||||||
when possible. It is possible to have addresses displayed numerically,
|
when possible.
|
||||||
|
It is possible to have addresses displayed numerically,
|
||||||
limit the display to a set of ports, hosts, and/or protocols
|
limit the display to a set of ports, hosts, and/or protocols
|
||||||
(the minimum unambiguous prefix may be supplied):
|
(the minimum unambiguous prefix may be supplied):
|
||||||
.Pp
|
.Pp
|
||||||
@ -424,21 +443,27 @@ Display only network connections using the indicated
|
|||||||
Supported protocols are ``tcp'', ``udp'', and ``all''.
|
Supported protocols are ``tcp'', ``udp'', and ``all''.
|
||||||
.It Cm ignore Op Ar items
|
.It Cm ignore Op Ar items
|
||||||
Do not display information about connections associated with
|
Do not display information about connections associated with
|
||||||
the specified hosts or ports. Hosts and ports may be specified
|
the specified hosts or ports.
|
||||||
by name (``vangogh'', ``ftp''), or numerically. Host addresses
|
Hosts and ports may be specified
|
||||||
use the Internet dot notation (``128.32.0.9''). Multiple items
|
by name (``vangogh'', ``ftp''), or numerically.
|
||||||
|
Host addresses
|
||||||
|
use the Internet dot notation (``128.32.0.9'').
|
||||||
|
Multiple items
|
||||||
may be specified with a single command by separating them with
|
may be specified with a single command by separating them with
|
||||||
spaces.
|
spaces.
|
||||||
.It Cm display Op Ar items
|
.It Cm display Op Ar items
|
||||||
Display information about the connections associated with the
|
Display information about the connections associated with the
|
||||||
specified hosts or ports. As for
|
specified hosts or ports.
|
||||||
|
As for
|
||||||
.Ar ignore ,
|
.Ar ignore ,
|
||||||
.Op Ar items
|
.Op Ar items
|
||||||
may be names or numbers.
|
may be names or numbers.
|
||||||
.It Cm show Op Ar ports\&|hosts
|
.It Cm show Op Ar ports\&|hosts
|
||||||
Show, on the command line, the currently selected protocols,
|
Show, on the command line, the currently selected protocols,
|
||||||
hosts, and ports. Hosts and ports which are being ignored
|
hosts, and ports.
|
||||||
are prefixed with a `!'. If
|
Hosts and ports which are being ignored
|
||||||
|
are prefixed with a `!'.
|
||||||
|
If
|
||||||
.Ar ports
|
.Ar ports
|
||||||
or
|
or
|
||||||
.Ar hosts
|
.Ar hosts
|
||||||
@ -451,15 +476,18 @@ Reset the port, host, and protocol matching mechanisms to the default
|
|||||||
.El
|
.El
|
||||||
.It Ic ifstat
|
.It Ic ifstat
|
||||||
Display the network traffic going through active interfaces on the
|
Display the network traffic going through active interfaces on the
|
||||||
system. Idle interfaces will not be displayed until they receive some
|
system.
|
||||||
|
Idle interfaces will not be displayed until they receive some
|
||||||
traffic.
|
traffic.
|
||||||
.Pp
|
.Pp
|
||||||
For each interface being displayed, the current, peak and total
|
For each interface being displayed, the current, peak and total
|
||||||
statistics are displayed for incoming and outgoing traffic. By default,
|
statistics are displayed for incoming and outgoing traffic.
|
||||||
|
By default,
|
||||||
the
|
the
|
||||||
.Ic ifstat
|
.Ic ifstat
|
||||||
display will automatically scale the units being used so that they are
|
display will automatically scale the units being used so that they are
|
||||||
in a human-readable format. The scaling units used for the current and
|
in a human-readable format.
|
||||||
|
The scaling units used for the current and
|
||||||
peak
|
peak
|
||||||
traffic columns can be altered by the
|
traffic columns can be altered by the
|
||||||
.Ic scale
|
.Ic scale
|
||||||
@ -467,7 +495,8 @@ command.
|
|||||||
.Bl -tag -width ".Cm scale Op Ar units"
|
.Bl -tag -width ".Cm scale Op Ar units"
|
||||||
.It Cm scale Op Ar units
|
.It Cm scale Op Ar units
|
||||||
Modify the scale used to display the current and peak traffic over all
|
Modify the scale used to display the current and peak traffic over all
|
||||||
interfaces. The following units are recognised: kbit, kbyte, mbit,
|
interfaces.
|
||||||
|
The following units are recognised: kbit, kbyte, mbit,
|
||||||
mbyte, gbit, gbyte and auto.
|
mbyte, gbit, gbyte and auto.
|
||||||
.El
|
.El
|
||||||
.El
|
.El
|
||||||
@ -475,28 +504,34 @@ mbyte, gbit, gbyte and auto.
|
|||||||
Commands to switch between displays may be abbreviated to the
|
Commands to switch between displays may be abbreviated to the
|
||||||
minimum unambiguous prefix; for example, ``io'' for ``iostat''.
|
minimum unambiguous prefix; for example, ``io'' for ``iostat''.
|
||||||
Certain information may be discarded when the screen size is
|
Certain information may be discarded when the screen size is
|
||||||
insufficient for display. For example, on a machine with 10
|
insufficient for display.
|
||||||
|
For example, on a machine with 10
|
||||||
drives the
|
drives the
|
||||||
.Ic iostat
|
.Ic iostat
|
||||||
bar graph displays only 3 drives on a 24 line terminal. When
|
bar graph displays only 3 drives on a 24 line terminal.
|
||||||
|
When
|
||||||
a bar graph would overflow the allotted screen space it is
|
a bar graph would overflow the allotted screen space it is
|
||||||
truncated and the actual value is printed ``over top'' of the bar.
|
truncated and the actual value is printed ``over top'' of the bar.
|
||||||
.Pp
|
.Pp
|
||||||
The following commands are common to each display which shows
|
The following commands are common to each display which shows
|
||||||
information about disk drives. These commands are used to
|
information about disk drives.
|
||||||
|
These commands are used to
|
||||||
select a set of drives to report on, should your system have
|
select a set of drives to report on, should your system have
|
||||||
more drives configured than can normally be displayed on the
|
more drives configured than can normally be displayed on the
|
||||||
screen.
|
screen.
|
||||||
.Pp
|
.Pp
|
||||||
.Bl -tag -width Ar -compact
|
.Bl -tag -width Ar -compact
|
||||||
.It Cm ignore Op Ar drives
|
.It Cm ignore Op Ar drives
|
||||||
Do not display information about the drives indicated. Multiple
|
Do not display information about the drives indicated.
|
||||||
|
Multiple
|
||||||
drives may be specified, separated by spaces.
|
drives may be specified, separated by spaces.
|
||||||
.It Cm display Op Ar drives
|
.It Cm display Op Ar drives
|
||||||
Display information about the drives indicated. Multiple drives
|
Display information about the drives indicated.
|
||||||
|
Multiple drives
|
||||||
may be specified, separated by spaces.
|
may be specified, separated by spaces.
|
||||||
.It Cm only Op Ar drives
|
.It Cm only Op Ar drives
|
||||||
Display only the specified drives. Multiple drives may be specified,
|
Display only the specified drives.
|
||||||
|
Multiple drives may be specified,
|
||||||
separated by spaces.
|
separated by spaces.
|
||||||
.It Cm drives
|
.It Cm drives
|
||||||
Display a list of available devices.
|
Display a list of available devices.
|
||||||
@ -504,10 +539,12 @@ Display a list of available devices.
|
|||||||
.Ar type , Ns Ar if , Ns Ar pass
|
.Ar type , Ns Ar if , Ns Ar pass
|
||||||
.Op | Ar ...
|
.Op | Ar ...
|
||||||
.Xc
|
.Xc
|
||||||
Display devices matching the given pattern. The basic matching
|
Display devices matching the given pattern.
|
||||||
|
The basic matching
|
||||||
expressions are the same as those used in
|
expressions are the same as those used in
|
||||||
.Xr iostat 8
|
.Xr iostat 8
|
||||||
with one difference. Instead of specifying multiple
|
with one difference.
|
||||||
|
Instead of specifying multiple
|
||||||
.Fl t
|
.Fl t
|
||||||
arguments which are then ORed together, the user instead specifies multiple
|
arguments which are then ORed together, the user instead specifies multiple
|
||||||
matching expressions joined by the pipe
|
matching expressions joined by the pipe
|
||||||
@ -515,9 +552,11 @@ matching expressions joined by the pipe
|
|||||||
character.
|
character.
|
||||||
The comma
|
The comma
|
||||||
separated arguments within each matching expression are ANDed together, and
|
separated arguments within each matching expression are ANDed together, and
|
||||||
then the pipe separated matching expressions are ORed together. Any
|
then the pipe separated matching expressions are ORed together.
|
||||||
|
Any
|
||||||
device matching the combined expression will be displayed, if there is room
|
device matching the combined expression will be displayed, if there is room
|
||||||
to display it. For example:
|
to display it.
|
||||||
|
For example:
|
||||||
.Pp
|
.Pp
|
||||||
.Dl match da,scsi | cd,ide
|
.Dl match da,scsi | cd,ide
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -172,7 +172,7 @@ and
|
|||||||
.Fl n
|
.Fl n
|
||||||
options modify the
|
options modify the
|
||||||
.Fl r
|
.Fl r
|
||||||
option, i.e. ``-r -c 4'' displays the last 4 characters of the last line
|
option, i.e., ``-r -c 4'' displays the last 4 characters of the last line
|
||||||
of the input, while the historic tail (using the historic syntax ``-4cr'')
|
of the input, while the historic tail (using the historic syntax ``-4cr'')
|
||||||
would ignore the
|
would ignore the
|
||||||
.Fl c
|
.Fl c
|
||||||
|
@ -412,7 +412,8 @@ and
|
|||||||
.Cm f
|
.Cm f
|
||||||
flags both require arguments,
|
flags both require arguments,
|
||||||
so there must be two additional items
|
so there must be two additional items
|
||||||
on the command line. The
|
on the command line.
|
||||||
|
The
|
||||||
.Ar 32
|
.Ar 32
|
||||||
is the argument to the
|
is the argument to the
|
||||||
.Cm b
|
.Cm b
|
||||||
|
@ -47,16 +47,20 @@
|
|||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility is designed to copy magnetic tapes. The only assumption made
|
utility is designed to copy magnetic tapes.
|
||||||
|
The only assumption made
|
||||||
about the tape is that there are two tape marks at the end.
|
about the tape is that there are two tape marks at the end.
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility with only a source tape
|
utility with only a source tape
|
||||||
.Pf ( Ar /dev/sa0
|
.Pf ( Ar /dev/sa0
|
||||||
by default) specified will print
|
by default) specified will print
|
||||||
information about the sizes of records and tape files. If a destination
|
information about the sizes of records and tape files.
|
||||||
is specified a copy will be made of the source tape. The blocking on the
|
If a destination
|
||||||
destination tape will be identical to that used on the source tape. Copying
|
is specified a copy will be made of the source tape.
|
||||||
|
The blocking on the
|
||||||
|
destination tape will be identical to that used on the source tape.
|
||||||
|
Copying
|
||||||
a tape will yield the same output as if just printing the sizes.
|
a tape will yield the same output as if just printing the sizes.
|
||||||
.Pp
|
.Pp
|
||||||
Options:
|
Options:
|
||||||
|
@ -178,7 +178,8 @@ Because there is no user-login or validation within
|
|||||||
the
|
the
|
||||||
.Tn TFTP
|
.Tn TFTP
|
||||||
protocol, the remote site will probably have some
|
protocol, the remote site will probably have some
|
||||||
sort of file-access restrictions in place. The
|
sort of file-access restrictions in place.
|
||||||
|
The
|
||||||
exact methods are specific to each site and therefore
|
exact methods are specific to each site and therefore
|
||||||
difficult to document here.
|
difficult to document here.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -71,8 +71,9 @@ flag is used, append to the specified file rather than overwriting
|
|||||||
it.
|
it.
|
||||||
Otherwise, this option has no effect.
|
Otherwise, this option has no effect.
|
||||||
.It Fl h
|
.It Fl h
|
||||||
Print times in a human friendly format. Times are printed in minutes, hours,
|
Print times in a human friendly format.
|
||||||
etc. as appropriate.
|
Times are printed in minutes, hours,
|
||||||
|
etc.\& as appropriate.
|
||||||
.It Fl l
|
.It Fl l
|
||||||
The contents of the
|
The contents of the
|
||||||
.Em rusage
|
.Em rusage
|
||||||
@ -80,7 +81,8 @@ structure are printed as well.
|
|||||||
.It Fl o Ar file
|
.It Fl o Ar file
|
||||||
Write the output to
|
Write the output to
|
||||||
.Ar file
|
.Ar file
|
||||||
instead of stderr. If
|
instead of stderr.
|
||||||
|
If
|
||||||
.Ar file
|
.Ar file
|
||||||
exists and the
|
exists and the
|
||||||
.Fl a
|
.Fl a
|
||||||
|
@ -48,7 +48,8 @@
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility makes terminal-dependent information available to users or shell
|
utility makes terminal-dependent information available to users or shell
|
||||||
applications. When invoked as the
|
applications.
|
||||||
|
When invoked as the
|
||||||
.Nm clear
|
.Nm clear
|
||||||
utility, the screen will be cleared as if
|
utility, the screen will be cleared as if
|
||||||
.Dl tput clear
|
.Dl tput clear
|
||||||
@ -83,7 +84,7 @@ without further action.
|
|||||||
.Pp
|
.Pp
|
||||||
If an
|
If an
|
||||||
.Ar attribute
|
.Ar attribute
|
||||||
is of type string, and takes arguments (e.g. cursor movement,
|
is of type string, and takes arguments (e.g.\& cursor movement,
|
||||||
the termcap
|
the termcap
|
||||||
.Dq cm
|
.Dq cm
|
||||||
sequence) the arguments are taken from the command line immediately
|
sequence) the arguments are taken from the command line immediately
|
||||||
@ -150,6 +151,8 @@ Some termcap entries depend upon having a
|
|||||||
.Sq %
|
.Sq %
|
||||||
in them that is just a
|
in them that is just a
|
||||||
.Sq %
|
.Sq %
|
||||||
and nothing more. Right now we just warn about them if they don't
|
and nothing more.
|
||||||
have a valid type declaration. These warnings are sent to
|
Right now we just warn about them if they don't
|
||||||
|
have a valid type declaration.
|
||||||
|
These warnings are sent to
|
||||||
stderr.
|
stderr.
|
||||||
|
@ -291,7 +291,7 @@ System V has historically implemented character ranges using the syntax
|
|||||||
implementations and
|
implementations and
|
||||||
standardized by POSIX.
|
standardized by POSIX.
|
||||||
System V shell scripts should work under this implementation as long as
|
System V shell scripts should work under this implementation as long as
|
||||||
the range is intended to map in another range, i.e. the command
|
the range is intended to map in another range, i.e., the command
|
||||||
``tr [a-z] [A-Z]'' will work as it will map the ``['' character in
|
``tr [a-z] [A-Z]'' will work as it will map the ``['' character in
|
||||||
.Ar string1
|
.Ar string1
|
||||||
to the ``['' character in
|
to the ``['' character in
|
||||||
|
@ -154,7 +154,7 @@ and
|
|||||||
.Fl k
|
.Fl k
|
||||||
options may either be entered as actual characters or by using the
|
options may either be entered as actual characters or by using the
|
||||||
.Dq hat
|
.Dq hat
|
||||||
notation, i.e. control-h may be specified as
|
notation, i.e., control-h may be specified as
|
||||||
.Dq Li ^H
|
.Dq Li ^H
|
||||||
or
|
or
|
||||||
.Dq Li ^h .
|
.Dq Li ^h .
|
||||||
|
@ -74,7 +74,8 @@ Turn on debugging.
|
|||||||
Search for and display the longest cycle.
|
Search for and display the longest cycle.
|
||||||
Can take a very long time.
|
Can take a very long time.
|
||||||
.It Fl q
|
.It Fl q
|
||||||
Do not display informational messages about cycles. This is primarily
|
Do not display informational messages about cycles.
|
||||||
|
This is primarily
|
||||||
intended for building libraries, where optimal ordering is not critical,
|
intended for building libraries, where optimal ordering is not critical,
|
||||||
and cycles occur often.
|
and cycles occur often.
|
||||||
.El
|
.El
|
||||||
|
@ -101,7 +101,8 @@ file (see
|
|||||||
The
|
The
|
||||||
.Xr nroff 1
|
.Xr nroff 1
|
||||||
command usually outputs a series of backspaces and underlines intermixed
|
command usually outputs a series of backspaces and underlines intermixed
|
||||||
with the text to indicate underlining. No attempt is made to optimize
|
with the text to indicate underlining.
|
||||||
|
No attempt is made to optimize
|
||||||
the backward motion.
|
the backward motion.
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
The
|
The
|
||||||
|
@ -85,7 +85,7 @@ Ignore the first
|
|||||||
fields in each input line when doing comparisons.
|
fields in each input line when doing comparisons.
|
||||||
A field is a string of non-blank characters separated from adjacent fields
|
A field is a string of non-blank characters separated from adjacent fields
|
||||||
by blanks.
|
by blanks.
|
||||||
Field numbers are one based, i.e. the first field is field one.
|
Field numbers are one based, i.e., the first field is field one.
|
||||||
.It Fl s Ar chars
|
.It Fl s Ar chars
|
||||||
Ignore the first
|
Ignore the first
|
||||||
.Ar chars
|
.Ar chars
|
||||||
@ -97,7 +97,7 @@ option, the first
|
|||||||
characters after the first
|
characters after the first
|
||||||
.Ar num
|
.Ar num
|
||||||
fields will be ignored.
|
fields will be ignored.
|
||||||
Character numbers are one based, i.e. the first character is character one.
|
Character numbers are one based, i.e., the first character is character one.
|
||||||
.It Fl u
|
.It Fl u
|
||||||
Only output lines that are not repeated in the input.
|
Only output lines that are not repeated in the input.
|
||||||
.It Fl i
|
.It Fl i
|
||||||
@ -147,7 +147,7 @@ The
|
|||||||
.Nm
|
.Nm
|
||||||
utility conforms to
|
utility conforms to
|
||||||
.St -p1003.1-2001
|
.St -p1003.1-2001
|
||||||
as amended by Cor. 1-2002.
|
as amended by Cor.\& 1-2002.
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
A
|
A
|
||||||
.Nm
|
.Nm
|
||||||
|
@ -22,18 +22,23 @@ about the number of units loaded.
|
|||||||
Print the version number.
|
Print the version number.
|
||||||
.It Ar from-unit to-unit
|
.It Ar from-unit to-unit
|
||||||
Allow a single unit conversion to be done directly from the command
|
Allow a single unit conversion to be done directly from the command
|
||||||
line. The program will not print prompts. It will print out the
|
line.
|
||||||
|
The program will not print prompts.
|
||||||
|
It will print out the
|
||||||
result of the single specified conversion.
|
result of the single specified conversion.
|
||||||
.El
|
.El
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
program converts quantities expressed in various scales to
|
program converts quantities expressed in various scales to
|
||||||
their equivalents in other scales. The
|
their equivalents in other scales.
|
||||||
|
The
|
||||||
.Nm
|
.Nm
|
||||||
program can only
|
program can only
|
||||||
handle multiplicative scale changes. It cannot convert Celsius
|
handle multiplicative scale changes.
|
||||||
to Fahrenheit, for example. It works interactively by prompting
|
It cannot convert Celsius
|
||||||
|
to Fahrenheit, for example.
|
||||||
|
It works interactively by prompting
|
||||||
the user for input:
|
the user for input:
|
||||||
.Bd -literal
|
.Bd -literal
|
||||||
You have: meters
|
You have: meters
|
||||||
@ -60,11 +65,15 @@ the user for input:
|
|||||||
Powers of units can be specified using the '^' character as shown in
|
Powers of units can be specified using the '^' character as shown in
|
||||||
the example, or by simple concatenation: 'cm3' is equivalent to 'cm^3'.
|
the example, or by simple concatenation: 'cm3' is equivalent to 'cm^3'.
|
||||||
Multiplication of units can be specified by using spaces, a dash or
|
Multiplication of units can be specified by using spaces, a dash or
|
||||||
an asterisk. Division of units is indicated by the slash ('/').
|
an asterisk.
|
||||||
|
Division of units is indicated by the slash ('/').
|
||||||
Note that multiplication has a higher precedence than division,
|
Note that multiplication has a higher precedence than division,
|
||||||
so 'm/s/s' is the same as 'm/s^2' or 'm/s s'. Division of numbers
|
so 'm/s/s' is the same as 'm/s^2' or 'm/s s'.
|
||||||
must be indicated using the vertical bar ('|'). To convert half a
|
Division of numbers
|
||||||
meter, you would write '1|2 meter'. If you write '1/2 meter' then the
|
must be indicated using the vertical bar ('|').
|
||||||
|
To convert half a
|
||||||
|
meter, you would write '1|2 meter'.
|
||||||
|
If you write '1/2 meter' then the
|
||||||
units program would interpret that as equivalent to '0.5/meter'.
|
units program would interpret that as equivalent to '0.5/meter'.
|
||||||
If you enter incompatible unit types, the units program will
|
If you enter incompatible unit types, the units program will
|
||||||
print a message indicating that the units are not conformable and
|
print a message indicating that the units are not conformable and
|
||||||
@ -77,9 +86,11 @@ it will display the reduced form for each unit:
|
|||||||
2.1166667e-05 kg^2 m / sec
|
2.1166667e-05 kg^2 m / sec
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The conversion information is read from a units data file. The default
|
The conversion information is read from a units data file.
|
||||||
|
The default
|
||||||
file includes definitions for most familiar units, abbreviations and
|
file includes definitions for most familiar units, abbreviations and
|
||||||
metric prefixes. Some constants of nature included are:
|
metric prefixes.
|
||||||
|
Some constants of nature included are:
|
||||||
.Pp
|
.Pp
|
||||||
.Bl -column -offset indent -compact "mercury"
|
.Bl -column -offset indent -compact "mercury"
|
||||||
.It "pi ratio of circumference to diameter
|
.It "pi ratio of circumference to diameter
|
||||||
@ -93,11 +104,16 @@ metric prefixes. Some constants of nature included are:
|
|||||||
.It "au astronomical unit
|
.It "au astronomical unit
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
The unit 'pound' is a unit of mass. Compound names are run together
|
The unit 'pound' is a unit of mass.
|
||||||
so 'pound force' is a unit of force. The unit 'ounce' is also a unit
|
Compound names are run together
|
||||||
of mass. The fluid ounce is 'floz'. British units that differ from
|
so 'pound force' is a unit of force.
|
||||||
|
The unit 'ounce' is also a unit
|
||||||
|
of mass.
|
||||||
|
The fluid ounce is 'floz'.
|
||||||
|
British units that differ from
|
||||||
their US counterparts are prefixed with 'br', and currency is prefixed
|
their US counterparts are prefixed with 'br', and currency is prefixed
|
||||||
with its country name: 'belgiumfranc', 'britainpound'. When searching
|
with its country name: 'belgiumfranc', 'britainpound'.
|
||||||
|
When searching
|
||||||
for a unit, if the specified string does not appear exactly as a unit
|
for a unit, if the specified string does not appear exactly as a unit
|
||||||
name, then
|
name, then
|
||||||
.Nm
|
.Nm
|
||||||
@ -107,19 +123,23 @@ trailing 'es' and check again for a match.
|
|||||||
To find out what units are available read the standard units file.
|
To find out what units are available read the standard units file.
|
||||||
If you want to add your own units you can supply your own file.
|
If you want to add your own units you can supply your own file.
|
||||||
A unit is specified on a single line by
|
A unit is specified on a single line by
|
||||||
giving its name and an equivalence. Be careful to define
|
giving its name and an equivalence.
|
||||||
|
Be careful to define
|
||||||
new units in terms of old ones so that a reduction leads to the
|
new units in terms of old ones so that a reduction leads to the
|
||||||
primitive units which are marked with '!' characters.
|
primitive units which are marked with '!' characters.
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
program will not detect infinite loops that could be caused
|
program will not detect infinite loops that could be caused
|
||||||
by careless unit definitions. Comments in the unit definition file
|
by careless unit definitions.
|
||||||
|
Comments in the unit definition file
|
||||||
begin with a '/' character at the beginning of a line.
|
begin with a '/' character at the beginning of a line.
|
||||||
.Pp
|
.Pp
|
||||||
Prefixes are defined in the same was as standard units, but with
|
Prefixes are defined in the same was as standard units, but with
|
||||||
a trailing dash at the end of the prefix name. If a unit is not found
|
a trailing dash at the end of the prefix name.
|
||||||
|
If a unit is not found
|
||||||
even after removing trailing 's' or 'es', then it will be checked
|
even after removing trailing 's' or 'es', then it will be checked
|
||||||
against the list of prefixes. Prefixes will be removed until a legal
|
against the list of prefixes.
|
||||||
|
Prefixes will be removed until a legal
|
||||||
base unit is identified.
|
base unit is identified.
|
||||||
.Pp
|
.Pp
|
||||||
Here is an example of a short units file that defines some basic
|
Here is an example of a short units file that defines some basic
|
||||||
@ -142,7 +162,8 @@ Exponents entered by the user can be only one digit.
|
|||||||
You can work around this by multiplying several terms.
|
You can work around this by multiplying several terms.
|
||||||
.Pp
|
.Pp
|
||||||
The user must use | to indicate division of numbers and / to
|
The user must use | to indicate division of numbers and / to
|
||||||
indicate division of symbols. This distinction should not
|
indicate division of symbols.
|
||||||
|
This distinction should not
|
||||||
be necessary.
|
be necessary.
|
||||||
.Pp
|
.Pp
|
||||||
The program contains various arbitrary limits on the length
|
The program contains various arbitrary limits on the length
|
||||||
|
@ -66,7 +66,8 @@ The
|
|||||||
.Nm
|
.Nm
|
||||||
utility runs in two basic modes, filter mode (see the
|
utility runs in two basic modes, filter mode (see the
|
||||||
.Fl f
|
.Fl f
|
||||||
option) or regular mode. In filter mode
|
option) or regular mode.
|
||||||
|
In filter mode
|
||||||
.Nm
|
.Nm
|
||||||
acts as a filter in a manner similar to
|
acts as a filter in a manner similar to
|
||||||
.Xr tbl 1 .
|
.Xr tbl 1 .
|
||||||
@ -81,10 +82,12 @@ starts processing
|
|||||||
ends processing
|
ends processing
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
These lines are formatted as described above. The output from this
|
These lines are formatted as described above.
|
||||||
|
The output from this
|
||||||
filter can be passed to
|
filter can be passed to
|
||||||
.Xr troff 1
|
.Xr troff 1
|
||||||
for output. There need be no particular ordering with
|
for output.
|
||||||
|
There need be no particular ordering with
|
||||||
.Xr eqn 1
|
.Xr eqn 1
|
||||||
or
|
or
|
||||||
.Xr tbl 1 .
|
.Xr tbl 1 .
|
||||||
@ -119,7 +122,8 @@ forces filter mode
|
|||||||
specifies a particular header to put on every output page (default is
|
specifies a particular header to put on every output page (default is
|
||||||
the file name)
|
the file name)
|
||||||
.It Fl l
|
.It Fl l
|
||||||
specifies the language to use. Currently known are
|
specifies the language to use.
|
||||||
|
Currently known are
|
||||||
.Tn PASCAL
|
.Tn PASCAL
|
||||||
.Pq Fl l Ns Ar p ,
|
.Pq Fl l Ns Ar p ,
|
||||||
.Tn MODEL
|
.Tn MODEL
|
||||||
@ -198,7 +202,8 @@ followed:
|
|||||||
For
|
For
|
||||||
.Tn C
|
.Tn C
|
||||||
\- function names can be preceded on a line only by spaces, tabs, or an
|
\- function names can be preceded on a line only by spaces, tabs, or an
|
||||||
asterisk. The parenthesized arguments must also be on the same line.
|
asterisk.
|
||||||
|
The parenthesized arguments must also be on the same line.
|
||||||
.Pp
|
.Pp
|
||||||
For
|
For
|
||||||
.Tn PASCAL
|
.Tn PASCAL
|
||||||
@ -218,7 +223,8 @@ name comment mechanisms will fail.
|
|||||||
More generally, arbitrary formatting styles for programs mostly look bad.
|
More generally, arbitrary formatting styles for programs mostly look bad.
|
||||||
The use of spaces to align source code fails miserably; if you plan to
|
The use of spaces to align source code fails miserably; if you plan to
|
||||||
.Nm
|
.Nm
|
||||||
your program you should use tabs. This is somewhat inevitable since the
|
your program you should use tabs.
|
||||||
|
This is somewhat inevitable since the
|
||||||
font used by
|
font used by
|
||||||
.Nm
|
.Nm
|
||||||
is variable width.
|
is variable width.
|
||||||
|
@ -74,7 +74,8 @@ The following table names and describes each field.
|
|||||||
.Pp
|
.Pp
|
||||||
Non-comments are required to describe a certain context where a
|
Non-comments are required to describe a certain context where a
|
||||||
sequence that would normally start a comment loses its special
|
sequence that would normally start a comment loses its special
|
||||||
meaning. A typical example for this can be found in Perl, where
|
meaning.
|
||||||
|
A typical example for this can be found in Perl, where
|
||||||
comments are normally starting with
|
comments are normally starting with
|
||||||
.Ql # ,
|
.Ql # ,
|
||||||
while the string
|
while the string
|
||||||
@ -95,7 +96,8 @@ if ifdef ifndef include undef:
|
|||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
Note that the first field is just the language name (and any variants
|
Note that the first field is just the language name (and any variants
|
||||||
of it). Thus the C language could be specified to
|
of it).
|
||||||
|
Thus the C language could be specified to
|
||||||
.Xr vgrind 1
|
.Xr vgrind 1
|
||||||
as "c" or "C".
|
as "c" or "C".
|
||||||
.Pp
|
.Pp
|
||||||
@ -132,7 +134,8 @@ a delimiter (space, tab, newline, start of line)
|
|||||||
.It \ea
|
.It \ea
|
||||||
matches any string of symbols (like .* in lex)
|
matches any string of symbols (like .* in lex)
|
||||||
.It \ep
|
.It \ep
|
||||||
matches any alphanumeric name. In a procedure definition (pb) the string
|
matches any alphanumeric name.
|
||||||
|
In a procedure definition (pb) the string
|
||||||
that matches this symbol is used as the procedure name.
|
that matches this symbol is used as the procedure name.
|
||||||
.It ()
|
.It ()
|
||||||
grouping
|
grouping
|
||||||
@ -148,11 +151,13 @@ string delimiter in a string by escaping it.
|
|||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
Unlike other regular expressions in the system, these match words
|
Unlike other regular expressions in the system, these match words
|
||||||
and not characters. Hence something like "(tramp|steamer)flies?"
|
and not characters.
|
||||||
|
Hence something like "(tramp|steamer)flies?"
|
||||||
would match "tramp", "steamer", "trampflies", or "steamerflies".
|
would match "tramp", "steamer", "trampflies", or "steamerflies".
|
||||||
.Sh KEYWORD LIST
|
.Sh KEYWORD LIST
|
||||||
The keyword list is just a list of keywords in the language separated
|
The keyword list is just a list of keywords in the language separated
|
||||||
by spaces. If the "oc" boolean is specified, indicating that upper
|
by spaces.
|
||||||
|
If the "oc" boolean is specified, indicating that upper
|
||||||
and lower case are equivalent, then all the keywords should be
|
and lower case are equivalent, then all the keywords should be
|
||||||
specified in lower case.
|
specified in lower case.
|
||||||
.Sh FILES
|
.Sh FILES
|
||||||
|
@ -47,10 +47,12 @@
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility is a filter for converting non-printable characters
|
utility is a filter for converting non-printable characters
|
||||||
into a visual representation. It differs from
|
into a visual representation.
|
||||||
|
It differs from
|
||||||
.Ql cat -v
|
.Ql cat -v
|
||||||
in that
|
in that
|
||||||
the form is unique and invertible. By default, all non-graphic
|
the form is unique and invertible.
|
||||||
|
By default, all non-graphic
|
||||||
characters except space, tab, and newline are encoded.
|
characters except space, tab, and newline are encoded.
|
||||||
A detailed description of the
|
A detailed description of the
|
||||||
various visual formats is given in
|
various visual formats is given in
|
||||||
@ -60,9 +62,11 @@ The options are as follows:
|
|||||||
.Bl -tag -width Ds
|
.Bl -tag -width Ds
|
||||||
.It Fl b
|
.It Fl b
|
||||||
Turns off prepending of backslash before up-arrow control sequences
|
Turns off prepending of backslash before up-arrow control sequences
|
||||||
and meta characters, and disables the doubling of backslashes. This
|
and meta characters, and disables the doubling of backslashes.
|
||||||
|
This
|
||||||
produces output which is neither invertible or precise, but does
|
produces output which is neither invertible or precise, but does
|
||||||
represent a minimum of change to the input. It is similar to
|
represent a minimum of change to the input.
|
||||||
|
It is similar to
|
||||||
.Dq Li cat -v .
|
.Dq Li cat -v .
|
||||||
.It Fl c
|
.It Fl c
|
||||||
Request a format which displays a small subset of the
|
Request a format which displays a small subset of the
|
||||||
@ -94,14 +98,16 @@ still doubled and hidden newline sequences inserted if
|
|||||||
.Fl f
|
.Fl f
|
||||||
or
|
or
|
||||||
.Fl F
|
.Fl F
|
||||||
is selected. When combined with the
|
is selected.
|
||||||
|
When combined with the
|
||||||
.Fl f
|
.Fl f
|
||||||
flag,
|
flag,
|
||||||
.Nm
|
.Nm
|
||||||
becomes like
|
becomes like
|
||||||
an invertible version of the
|
an invertible version of the
|
||||||
.Xr fold 1
|
.Xr fold 1
|
||||||
utility. That is, the output
|
utility.
|
||||||
|
That is, the output
|
||||||
can be unfolded by running the output through
|
can be unfolded by running the output through
|
||||||
.Xr unvis 1 .
|
.Xr unvis 1 .
|
||||||
.It Fl o
|
.It Fl o
|
||||||
|
@ -114,7 +114,8 @@ allocation and then by type of usage.
|
|||||||
.It Fl n
|
.It Fl n
|
||||||
Change the maximum number of disks to display from the default of 2.
|
Change the maximum number of disks to display from the default of 2.
|
||||||
.It Fl p
|
.It Fl p
|
||||||
Specify which types of devices to display. There are three different
|
Specify which types of devices to display.
|
||||||
|
There are three different
|
||||||
categories of devices:
|
categories of devices:
|
||||||
.Pp
|
.Pp
|
||||||
.Bl -tag -width indent -compact
|
.Bl -tag -width indent -compact
|
||||||
@ -166,15 +167,18 @@ Passthrough devices
|
|||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
The user must specify at least one device type, and may specify at most
|
The user must specify at least one device type, and may specify at most
|
||||||
one device type from each category. Multiple device types in a single
|
one device type from each category.
|
||||||
|
Multiple device types in a single
|
||||||
device type statement must be separated by commas.
|
device type statement must be separated by commas.
|
||||||
.Pp
|
.Pp
|
||||||
Any number of
|
Any number of
|
||||||
.Fl p
|
.Fl p
|
||||||
arguments may be specified on the command line. All
|
arguments may be specified on the command line.
|
||||||
|
All
|
||||||
.Fl p
|
.Fl p
|
||||||
arguments are ORed together to form a matching expression against which
|
arguments are ORed together to form a matching expression against which
|
||||||
all devices in the system are compared. Any device that fully matches
|
all devices in the system are compared.
|
||||||
|
Any device that fully matches
|
||||||
any
|
any
|
||||||
.Fl p
|
.Fl p
|
||||||
argument will be included in the
|
argument will be included in the
|
||||||
@ -262,7 +266,8 @@ If more than three disk drives are configured in the system,
|
|||||||
.Nm
|
.Nm
|
||||||
displays only the first three drives, unless the user specifies the
|
displays only the first three drives, unless the user specifies the
|
||||||
.Fl n
|
.Fl n
|
||||||
argument to increase the number of drives displayed. This will probably
|
argument to increase the number of drives displayed.
|
||||||
|
This will probably
|
||||||
cause the display to exceed 80 columns, however.
|
cause the display to exceed 80 columns, however.
|
||||||
To force
|
To force
|
||||||
.Nm
|
.Nm
|
||||||
@ -272,7 +277,8 @@ The
|
|||||||
utility
|
utility
|
||||||
defaults to show disks first, and then various other random devices in the
|
defaults to show disks first, and then various other random devices in the
|
||||||
system to add up to three devices, if there are that many devices in the
|
system to add up to three devices, if there are that many devices in the
|
||||||
system. If devices are specified on the command line, or if a device type
|
system.
|
||||||
|
If devices are specified on the command line, or if a device type
|
||||||
matching pattern is specified (see above),
|
matching pattern is specified (see above),
|
||||||
.Nm
|
.Nm
|
||||||
will only display the given devices or the devices matching the pattern,
|
will only display the given devices or the devices matching the pattern,
|
||||||
|
@ -56,7 +56,8 @@ to deny messages or are using a program which
|
|||||||
automatically denies messages.
|
automatically denies messages.
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It Fl g
|
.It Fl g
|
||||||
Send messages to users in this group. This option may be specified
|
Send messages to users in this group.
|
||||||
|
This option may be specified
|
||||||
multiple times, and any user in any of the specified groups will
|
multiple times, and any user in any of the specified groups will
|
||||||
receive the message.
|
receive the message.
|
||||||
.El
|
.El
|
||||||
|
@ -50,7 +50,8 @@ utility searches each specified
|
|||||||
.Ar file
|
.Ar file
|
||||||
for sequences of the form
|
for sequences of the form
|
||||||
.Dq \&@(#)
|
.Dq \&@(#)
|
||||||
as inserted by the source code control system. It prints the remainder
|
as inserted by the source code control system.
|
||||||
|
It prints the remainder
|
||||||
of the string following this marker, up to a NUL character, newline, double
|
of the string following this marker, up to a NUL character, newline, double
|
||||||
quote,
|
quote,
|
||||||
.Dq \&>
|
.Dq \&>
|
||||||
|
@ -51,7 +51,8 @@ The
|
|||||||
.Nm
|
.Nm
|
||||||
utility checks the standard binary, manual page, and source
|
utility checks the standard binary, manual page, and source
|
||||||
directories for the specified programs, printing out the paths of any
|
directories for the specified programs, printing out the paths of any
|
||||||
it finds. The supplied program names are first stripped of leading
|
it finds.
|
||||||
|
The supplied program names are first stripped of leading
|
||||||
path name components, any single trailing extension added by
|
path name components, any single trailing extension added by
|
||||||
.Xr gzip 1 ,
|
.Xr gzip 1 ,
|
||||||
.Xr compress 1 ,
|
.Xr compress 1 ,
|
||||||
@ -72,7 +73,8 @@ string, with
|
|||||||
.Pa /usr/games
|
.Pa /usr/games
|
||||||
and the current user's
|
and the current user's
|
||||||
.Ev $PATH
|
.Ev $PATH
|
||||||
appended. Manual pages are searched by default along the
|
appended.
|
||||||
|
Manual pages are searched by default along the
|
||||||
.Ev $MANPATH .
|
.Ev $MANPATH .
|
||||||
Program sources are located in a list of known standard places,
|
Program sources are located in a list of known standard places,
|
||||||
including all the subdirectories of
|
including all the subdirectories of
|
||||||
@ -83,15 +85,18 @@ and
|
|||||||
The following options are available:
|
The following options are available:
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It Fl B
|
.It Fl B
|
||||||
Specify directories to search for binaries. Requires the
|
Specify directories to search for binaries.
|
||||||
|
Requires the
|
||||||
.Fl f
|
.Fl f
|
||||||
option.
|
option.
|
||||||
.It Fl M
|
.It Fl M
|
||||||
Specify directories to search for manual pages. Requires the
|
Specify directories to search for manual pages.
|
||||||
|
Requires the
|
||||||
.Fl f
|
.Fl f
|
||||||
option.
|
option.
|
||||||
.It Fl S
|
.It Fl S
|
||||||
Specify directories to search for program sources. Requires the
|
Specify directories to search for program sources.
|
||||||
|
Requires the
|
||||||
.Fl f
|
.Fl f
|
||||||
option.
|
option.
|
||||||
.It Fl a
|
.It Fl a
|
||||||
@ -121,7 +126,8 @@ Search for source directories.
|
|||||||
.It Fl u
|
.It Fl u
|
||||||
Search for
|
Search for
|
||||||
.Dq unusual
|
.Dq unusual
|
||||||
entries. A file is said to be unusual if it does not have at least
|
entries.
|
||||||
|
A file is said to be unusual if it does not have at least
|
||||||
one entry of each requested type.
|
one entry of each requested type.
|
||||||
Only the name of the unusual entry is printed.
|
Only the name of the unusual entry is printed.
|
||||||
.It Fl x
|
.It Fl x
|
||||||
|
@ -114,8 +114,10 @@ created.
|
|||||||
If
|
If
|
||||||
.Pa /var/log/wtmp
|
.Pa /var/log/wtmp
|
||||||
is being used as the file, the user name may be empty
|
is being used as the file, the user name may be empty
|
||||||
or one of the special characters '|', '}' and '~'. Logouts produce
|
or one of the special characters '|', '}' and '~'.
|
||||||
an output line without any user name. For more information on the
|
Logouts produce
|
||||||
|
an output line without any user name.
|
||||||
|
For more information on the
|
||||||
special characters, see
|
special characters, see
|
||||||
.Xr utmp 5 .
|
.Xr utmp 5 .
|
||||||
.Sh ENVIRONMENT
|
.Sh ENVIRONMENT
|
||||||
|
@ -56,13 +56,17 @@ utility implements a window environment on
|
|||||||
terminals.
|
terminals.
|
||||||
.Pp
|
.Pp
|
||||||
A window is a rectangular portion of the physical terminal
|
A window is a rectangular portion of the physical terminal
|
||||||
screen associated with a set of processes. Its size and
|
screen associated with a set of processes.
|
||||||
position can be changed by the user at any time. Processes
|
Its size and
|
||||||
|
position can be changed by the user at any time.
|
||||||
|
Processes
|
||||||
communicate with their window in the same way they normally
|
communicate with their window in the same way they normally
|
||||||
interact with a terminal\-through their standard input, output,
|
interact with a terminal\-through their standard input, output,
|
||||||
and diagnostic file descriptors. The window program handles the
|
and diagnostic file descriptors.
|
||||||
|
The window program handles the
|
||||||
details of redirecting input and output to and from the
|
details of redirecting input and output to and from the
|
||||||
windows. At any one time, only one window can receive
|
windows.
|
||||||
|
At any one time, only one window can receive
|
||||||
input from the keyboard, but all windows can simultaneously send output
|
input from the keyboard, but all windows can simultaneously send output
|
||||||
to the display.
|
to the display.
|
||||||
.Pp
|
.Pp
|
||||||
@ -72,7 +76,8 @@ starts up, the commands (see long commands below)
|
|||||||
contained in the file
|
contained in the file
|
||||||
.Pa .windowrc
|
.Pa .windowrc
|
||||||
in the user's home directory are
|
in the user's home directory are
|
||||||
executed. If it does not exist, two equal sized windows spanning
|
executed.
|
||||||
|
If it does not exist, two equal sized windows spanning
|
||||||
the terminal screen are created by default.
|
the terminal screen are created by default.
|
||||||
.Pp
|
.Pp
|
||||||
The command line options are
|
The command line options are
|
||||||
@ -82,7 +87,8 @@ Turn on terse mode (see
|
|||||||
.Ic terse
|
.Ic terse
|
||||||
command below).
|
command below).
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Fast. Don't perform any startup action.
|
Fast.
|
||||||
|
Don't perform any startup action.
|
||||||
.It Fl d
|
.It Fl d
|
||||||
Ignore
|
Ignore
|
||||||
.Pa .windowrc
|
.Pa .windowrc
|
||||||
@ -105,30 +111,39 @@ as a long command (see below)
|
|||||||
before doing anything else.
|
before doing anything else.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
Windows can overlap and are framed as necessary. Each window
|
Windows can overlap and are framed as necessary.
|
||||||
is named by one of the digits ``1'' to ``9''. This one-character
|
Each window
|
||||||
|
is named by one of the digits ``1'' to ``9''.
|
||||||
|
This one-character
|
||||||
identifier, as well as a user definable label string, are displayed
|
identifier, as well as a user definable label string, are displayed
|
||||||
with the window on the top edge of its frame. A window can be
|
with the window on the top edge of its frame.
|
||||||
|
A window can be
|
||||||
designated to be in the
|
designated to be in the
|
||||||
.Ar foreground ,
|
.Ar foreground ,
|
||||||
in which case it will always be
|
in which case it will always be
|
||||||
on top of all normal, non-foreground windows, and can be covered
|
on top of all normal, non-foreground windows, and can be covered
|
||||||
only by other foreground windows. A window need not be completely
|
only by other foreground windows.
|
||||||
within the edges of the terminal screen. Thus a large window
|
A window need not be completely
|
||||||
|
within the edges of the terminal screen.
|
||||||
|
Thus a large window
|
||||||
(possibly larger than the screen) may be positioned to show only
|
(possibly larger than the screen) may be positioned to show only
|
||||||
a portion of its full size.
|
a portion of its full size.
|
||||||
.Pp
|
.Pp
|
||||||
Each window has a cursor and a set of control functions. Most intelligent
|
Each window has a cursor and a set of control functions.
|
||||||
|
Most intelligent
|
||||||
terminal operations such as line and
|
terminal operations such as line and
|
||||||
character deletion and insertion are supported. Display modes
|
character deletion and insertion are supported.
|
||||||
|
Display modes
|
||||||
such as underlining and reverse video are available if they are
|
such as underlining and reverse video are available if they are
|
||||||
supported by the terminal. In addition,
|
supported by the terminal.
|
||||||
|
In addition,
|
||||||
similar to terminals with multiple pages of memory,
|
similar to terminals with multiple pages of memory,
|
||||||
each window has a text buffer which can have more lines than the window
|
each window has a text buffer which can have more lines than the window
|
||||||
itself.
|
itself.
|
||||||
.Ss Process Environment
|
.Ss Process Environment
|
||||||
With each newly created window, a shell program is spawned with its
|
With each newly created window, a shell program is spawned with its
|
||||||
process environment tailored to that window. Its standard input,
|
process environment tailored to that window.
|
||||||
|
Its standard input,
|
||||||
output, and diagnostic file descriptors are bound to one end of either
|
output, and diagnostic file descriptors are bound to one end of either
|
||||||
a pseudo-terminal (see
|
a pseudo-terminal (see
|
||||||
.Xr pty 4 )
|
.Xr pty 4 )
|
||||||
@ -140,7 +155,8 @@ If a pseudo-terminal is used, then its special
|
|||||||
characters and modes (see
|
characters and modes (see
|
||||||
.Xr stty 1 )
|
.Xr stty 1 )
|
||||||
are copied from the physical
|
are copied from the physical
|
||||||
terminal. A
|
terminal.
|
||||||
|
A
|
||||||
.Xr termcap 5
|
.Xr termcap 5
|
||||||
entry tailored to this window is created
|
entry tailored to this window is created
|
||||||
and passed as environment (see
|
and passed as environment (see
|
||||||
@ -151,9 +167,11 @@ The termcap entry contains the window's size and
|
|||||||
characteristics as well as information from the physical terminal,
|
characteristics as well as information from the physical terminal,
|
||||||
such as the existence of underline, reverse video, and other display
|
such as the existence of underline, reverse video, and other display
|
||||||
modes, and the codes produced by the terminal's function keys,
|
modes, and the codes produced by the terminal's function keys,
|
||||||
if any. In addition, the window size attributes of the pseudo-terminal
|
if any.
|
||||||
|
In addition, the window size attributes of the pseudo-terminal
|
||||||
are set to reflect the size of this window, and updated whenever
|
are set to reflect the size of this window, and updated whenever
|
||||||
it is changed by the user. In particular, the editor
|
it is changed by the user.
|
||||||
|
In particular, the editor
|
||||||
.Xr vi 1
|
.Xr vi 1
|
||||||
uses
|
uses
|
||||||
this information to redraw its display.
|
this information to redraw its display.
|
||||||
@ -161,11 +179,14 @@ this information to redraw its display.
|
|||||||
During normal execution,
|
During normal execution,
|
||||||
.Nm
|
.Nm
|
||||||
can be in one of two states:
|
can be in one of two states:
|
||||||
conversation mode and command mode. In conversation mode, the
|
conversation mode and command mode.
|
||||||
|
In conversation mode, the
|
||||||
terminal's real cursor is placed at the cursor position of a particular
|
terminal's real cursor is placed at the cursor position of a particular
|
||||||
window--called the current window--and input from the keyboard is sent
|
window--called the current window--and input from the keyboard is sent
|
||||||
to the process in that window. The current window is always
|
to the process in that window.
|
||||||
on top of all other windows, except those in foreground. In addition,
|
The current window is always
|
||||||
|
on top of all other windows, except those in foreground.
|
||||||
|
In addition,
|
||||||
it is set apart by highlighting its identifier and label in reverse video.
|
it is set apart by highlighting its identifier and label in reverse video.
|
||||||
.Pp
|
.Pp
|
||||||
Typing
|
Typing
|
||||||
@ -173,7 +194,8 @@ Typing
|
|||||||
escape character (normally
|
escape character (normally
|
||||||
.Ic ^P )
|
.Ic ^P )
|
||||||
in conversation
|
in conversation
|
||||||
mode switches it into command mode. In command mode, the top line of
|
mode switches it into command mode.
|
||||||
|
In command mode, the top line of
|
||||||
the terminal screen becomes the command prompt window, and
|
the terminal screen becomes the command prompt window, and
|
||||||
.Nm
|
.Nm
|
||||||
interprets input from the keyboard as commands to manipulate windows.
|
interprets input from the keyboard as commands to manipulate windows.
|
||||||
@ -195,7 +217,8 @@ means
|
|||||||
.No control\- Ns Ar X ,
|
.No control\- Ns Ar X ,
|
||||||
where
|
where
|
||||||
.Ar X
|
.Ar X
|
||||||
is any character. In particular,
|
is any character.
|
||||||
|
In particular,
|
||||||
.Ic ^^
|
.Ic ^^
|
||||||
is
|
is
|
||||||
.Li control\-^ .
|
.Li control\-^ .
|
||||||
@ -214,17 +237,20 @@ Select window
|
|||||||
but stay in command mode.
|
but stay in command mode.
|
||||||
.It Ic ^^
|
.It Ic ^^
|
||||||
Select the previous window and return to conversation
|
Select the previous window and return to conversation
|
||||||
mode. This is useful for toggling between two windows.
|
mode.
|
||||||
|
This is useful for toggling between two windows.
|
||||||
.It Ic escape
|
.It Ic escape
|
||||||
Return to conversation mode.
|
Return to conversation mode.
|
||||||
.It Ic ^P
|
.It Ic ^P
|
||||||
Return to conversation mode and write
|
Return to conversation mode and write
|
||||||
.Ic ^P
|
.Ic ^P
|
||||||
to the
|
to the
|
||||||
current window. Thus, typing two
|
current window.
|
||||||
|
Thus, typing two
|
||||||
.Ic ^P Ns 's
|
.Ic ^P Ns 's
|
||||||
in conversation
|
in conversation
|
||||||
mode sends one to the current window. If the
|
mode sends one to the current window.
|
||||||
|
If the
|
||||||
.Nm
|
.Nm
|
||||||
escape is changed to some other character, that
|
escape is changed to some other character, that
|
||||||
character takes the place of
|
character takes the place of
|
||||||
@ -242,23 +268,30 @@ Confirmation is requested.
|
|||||||
Suspend
|
Suspend
|
||||||
.Nm .
|
.Nm .
|
||||||
.It Ic w
|
.It Ic w
|
||||||
Create a new window. The user is prompted for the positions
|
Create a new window.
|
||||||
|
The user is prompted for the positions
|
||||||
of the upper left and lower right corners of the window.
|
of the upper left and lower right corners of the window.
|
||||||
The cursor is placed on the screen and the keys ``h'', ``j'',
|
The cursor is placed on the screen and the keys ``h'', ``j'',
|
||||||
``k'', and ``l''
|
``k'', and ``l''
|
||||||
move the cursor left, down, up, and right, respectively.
|
move the cursor left, down, up, and right, respectively.
|
||||||
The keys ``H'', ``J'', ``K'', and ``L'' move the cursor to the respective
|
The keys ``H'', ``J'', ``K'', and ``L'' move the cursor to the respective
|
||||||
limits of the screen. Typing a number before the movement keys
|
limits of the screen.
|
||||||
repeats the movement that number of times. Return enters the cursor position
|
Typing a number before the movement keys
|
||||||
as the upper left corner of the window. The lower right corner
|
repeats the movement that number of times.
|
||||||
is entered in the same manner. During this process,
|
Return enters the cursor position
|
||||||
|
as the upper left corner of the window.
|
||||||
|
The lower right corner
|
||||||
|
is entered in the same manner.
|
||||||
|
During this process,
|
||||||
the placement of the new window is indicated by a rectangular
|
the placement of the new window is indicated by a rectangular
|
||||||
box drawn on the screen, corresponding to where the new window
|
box drawn on the screen, corresponding to where the new window
|
||||||
will be framed. Typing escape at any point
|
will be framed.
|
||||||
|
Typing escape at any point
|
||||||
cancels this command.
|
cancels this command.
|
||||||
.Pp
|
.Pp
|
||||||
This window becomes the current window,
|
This window becomes the current window,
|
||||||
and is given the first available ID. The default buffer size
|
and is given the first available ID.
|
||||||
|
The default buffer size
|
||||||
is used (see
|
is used (see
|
||||||
.Ar default_nline
|
.Ar default_nline
|
||||||
command below).
|
command below).
|
||||||
@ -277,12 +310,14 @@ handle this signal correctly and cause no problems.
|
|||||||
.It Ic m Ns Ar #
|
.It Ic m Ns Ar #
|
||||||
Move window
|
Move window
|
||||||
.Ar #
|
.Ar #
|
||||||
to another location. A box in the shape
|
to another location.
|
||||||
|
A box in the shape
|
||||||
of the window is drawn on
|
of the window is drawn on
|
||||||
the screen to indicate the new position of the window, and the same keys as
|
the screen to indicate the new position of the window, and the same keys as
|
||||||
those for the
|
those for the
|
||||||
.Ic w
|
.Ic w
|
||||||
command are used to position the box. The
|
command are used to position the box.
|
||||||
|
The
|
||||||
window can be moved partially off-screen.
|
window can be moved partially off-screen.
|
||||||
.It Ic M Ns Ar #
|
.It Ic M Ns Ar #
|
||||||
Move window
|
Move window
|
||||||
@ -292,8 +327,10 @@ to its previous position.
|
|||||||
Change the size of window
|
Change the size of window
|
||||||
.Ar # .
|
.Ar # .
|
||||||
The user is prompted
|
The user is prompted
|
||||||
to enter the new lower right corner of the window. A box
|
to enter the new lower right corner of the window.
|
||||||
is drawn to indicate the new window size. The same
|
A box
|
||||||
|
is drawn to indicate the new window size.
|
||||||
|
The same
|
||||||
keys used in
|
keys used in
|
||||||
.Ic w
|
.Ic w
|
||||||
and
|
and
|
||||||
@ -324,11 +361,14 @@ Move the cursor of the current window up by one line.
|
|||||||
.It Ic l
|
.It Ic l
|
||||||
Move the cursor of the current window right by one column.
|
Move the cursor of the current window right by one column.
|
||||||
.It Ic y
|
.It Ic y
|
||||||
Yank. The user is prompted to enter two points within the current
|
Yank.
|
||||||
window. Then the content of the current window between those two points
|
The user is prompted to enter two points within the current
|
||||||
|
window.
|
||||||
|
Then the content of the current window between those two points
|
||||||
is saved in the yank buffer.
|
is saved in the yank buffer.
|
||||||
.It Ic p
|
.It Ic p
|
||||||
Put. The content of the yank buffer is written to the current
|
Put.
|
||||||
|
The content of the yank buffer is written to the current
|
||||||
window as input.
|
window as input.
|
||||||
.It Ic ^S
|
.It Ic ^S
|
||||||
Stop output in the current window.
|
Stop output in the current window.
|
||||||
@ -343,30 +383,40 @@ are supported.
|
|||||||
.Ss Long Commands
|
.Ss Long Commands
|
||||||
Long commands are a sequence of statements
|
Long commands are a sequence of statements
|
||||||
parsed much like a programming language, with a syntax
|
parsed much like a programming language, with a syntax
|
||||||
similar to that of C. Numeric and string expressions and variables
|
similar to that of C.
|
||||||
|
Numeric and string expressions and variables
|
||||||
are supported, as well as conditional statements.
|
are supported, as well as conditional statements.
|
||||||
.Pp
|
.Pp
|
||||||
There are two data types: string and number. A string is a sequence
|
There are two data types: string and number.
|
||||||
of letters or digits beginning with a letter. ``_'' and ``.'' are
|
A string is a sequence
|
||||||
considered letters. Alternately, non-alphanumeric characters can
|
of letters or digits beginning with a letter.
|
||||||
|
``_'' and ``.'' are
|
||||||
|
considered letters.
|
||||||
|
Alternately, non-alphanumeric characters can
|
||||||
be included in strings by quoting them in ``"'' or escaping them
|
be included in strings by quoting them in ``"'' or escaping them
|
||||||
with ``\\''. In addition, the ``\\'' sequences of C are supported,
|
with ``\\''.
|
||||||
|
In addition, the ``\\'' sequences of C are supported,
|
||||||
both inside and outside quotes (e.g., ``\\n'' is a new line,
|
both inside and outside quotes (e.g., ``\\n'' is a new line,
|
||||||
``\\r'' a carriage return). For example, these are legal strings:
|
``\\r'' a carriage return).
|
||||||
|
For example, these are legal strings:
|
||||||
abcde01234, "&#$^*&#", ab"$#"cd, ab\\$\\#cd, "/usr/ucb/window".
|
abcde01234, "&#$^*&#", ab"$#"cd, ab\\$\\#cd, "/usr/ucb/window".
|
||||||
.Pp
|
.Pp
|
||||||
A number is an integer value in one of three forms:
|
A number is an integer value in one of three forms:
|
||||||
a decimal number, an octal number preceded by ``0'',
|
a decimal number, an octal number preceded by ``0'',
|
||||||
or a hexadecimal number preceded by ``0x'' or ``0X''. The natural
|
or a hexadecimal number preceded by ``0x'' or ``0X''.
|
||||||
|
The natural
|
||||||
machine integer size is used (i.e., the signed integer type
|
machine integer size is used (i.e., the signed integer type
|
||||||
of the C compiler). As in C, a non-zero number represents
|
of the C compiler).
|
||||||
|
As in C, a non-zero number represents
|
||||||
a boolean true.
|
a boolean true.
|
||||||
.Pp
|
.Pp
|
||||||
The character ``#'' begins a comment which terminates at the
|
The character ``#'' begins a comment which terminates at the
|
||||||
end of the line.
|
end of the line.
|
||||||
.Pp
|
.Pp
|
||||||
A statement is either a conditional or an expression. Expression
|
A statement is either a conditional or an expression.
|
||||||
statements are terminated with a new line or ``;''. To continue
|
Expression
|
||||||
|
statements are terminated with a new line or ``;''.
|
||||||
|
To continue
|
||||||
an expression on the next line, terminate the first line with ``\\''.
|
an expression on the next line, terminate the first line with ``\\''.
|
||||||
.Ss Conditional Statement
|
.Ss Conditional Statement
|
||||||
The
|
The
|
||||||
@ -400,14 +450,18 @@ Expressions in
|
|||||||
.Nm
|
.Nm
|
||||||
are similar to those in the
|
are similar to those in the
|
||||||
C language, with most C operators supported on numeric
|
C language, with most C operators supported on numeric
|
||||||
operands. In addition, some are overloaded to operate on strings.
|
operands.
|
||||||
|
In addition, some are overloaded to operate on strings.
|
||||||
.Pp
|
.Pp
|
||||||
When an expression is used as a statement, its value is discarded
|
When an expression is used as a statement, its value is discarded
|
||||||
after evaluation. Therefore, only expressions with side
|
after evaluation.
|
||||||
|
Therefore, only expressions with side
|
||||||
effects (assignments and function calls) are useful as statements.
|
effects (assignments and function calls) are useful as statements.
|
||||||
.Pp
|
.Pp
|
||||||
Single valued (no arrays) variables are supported, of both
|
Single valued (no arrays) variables are supported, of both
|
||||||
numeric and string values. Some variables are predefined. They
|
numeric and string values.
|
||||||
|
Some variables are predefined.
|
||||||
|
They
|
||||||
are listed below.
|
are listed below.
|
||||||
.Pp
|
.Pp
|
||||||
The operators in order of increasing precedence:
|
The operators in order of increasing precedence:
|
||||||
@ -417,7 +471,8 @@ The operators in order of increasing precedence:
|
|||||||
.Ic =
|
.Ic =
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
.Xc
|
.Xc
|
||||||
Assignment. The variable of name
|
Assignment.
|
||||||
|
The variable of name
|
||||||
.Aq Va expr1 ,
|
.Aq Va expr1 ,
|
||||||
which must be string valued,
|
which must be string valued,
|
||||||
is assigned the result of
|
is assigned the result of
|
||||||
@ -438,7 +493,8 @@ if
|
|||||||
evaluates true
|
evaluates true
|
||||||
(non-zero numeric value); returns the value of
|
(non-zero numeric value); returns the value of
|
||||||
.Aq Va expr3
|
.Aq Va expr3
|
||||||
otherwise. Only
|
otherwise.
|
||||||
|
Only
|
||||||
one of
|
one of
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
and
|
and
|
||||||
@ -452,7 +508,9 @@ be numeric.
|
|||||||
.Ic \&|\&|
|
.Ic \&|\&|
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
.Xc
|
.Xc
|
||||||
Logical or. Numeric values only. Short circuit evaluation is supported
|
Logical or.
|
||||||
|
Numeric values only.
|
||||||
|
Short circuit evaluation is supported
|
||||||
(i.e., if
|
(i.e., if
|
||||||
.Aq Va expr1
|
.Aq Va expr1
|
||||||
evaluates true, then
|
evaluates true, then
|
||||||
@ -463,25 +521,29 @@ is not evaluated).
|
|||||||
.Ic \&&\&&
|
.Ic \&&\&&
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
.Xc
|
.Xc
|
||||||
Logical and with short circuit evaluation. Numeric values only.
|
Logical and with short circuit evaluation.
|
||||||
|
Numeric values only.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Aq Va expr1
|
.Aq Va expr1
|
||||||
.Ic \&|
|
.Ic \&|
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
.Xc
|
.Xc
|
||||||
Bitwise or. Numeric values only.
|
Bitwise or.
|
||||||
|
Numeric values only.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Aq Va expr1
|
.Aq Va expr1
|
||||||
.Ic ^
|
.Ic ^
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
.Xc
|
.Xc
|
||||||
Bitwise exclusive or. Numeric values only.
|
Bitwise exclusive or.
|
||||||
|
Numeric values only.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Aq Va expr1
|
.Aq Va expr1
|
||||||
.Ic \&&
|
.Ic \&&
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
.Xc
|
.Xc
|
||||||
Bitwise and. Numeric values only.
|
Bitwise and.
|
||||||
|
Numeric values only.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Aq Va expr1
|
.Aq Va expr1
|
||||||
.Ic ==
|
.Ic ==
|
||||||
@ -490,9 +552,12 @@ Bitwise and. Numeric values only.
|
|||||||
.Ic !=
|
.Ic !=
|
||||||
.Aq expr2
|
.Aq expr2
|
||||||
.Xc
|
.Xc
|
||||||
Comparison (equal and not equal, respectively). The boolean
|
Comparison (equal and not equal, respectively).
|
||||||
result (either 1 or 0) of the comparison is returned. The
|
The boolean
|
||||||
operands can be numeric or string valued. One string operand
|
result (either 1 or 0) of the comparison is returned.
|
||||||
|
The
|
||||||
|
operands can be numeric or string valued.
|
||||||
|
One string operand
|
||||||
forces the other to be converted to a string in necessary.
|
forces the other to be converted to a string in necessary.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Aq Va expr1
|
.Aq Va expr1
|
||||||
@ -506,7 +571,8 @@ forces the other to be converted to a string in necessary.
|
|||||||
.Aq Va expr2 ,
|
.Aq Va expr2 ,
|
||||||
.Xc
|
.Xc
|
||||||
Less than, greater than, less than or equal to,
|
Less than, greater than, less than or equal to,
|
||||||
greater than or equal to. Both numeric and string values, with
|
greater than or equal to.
|
||||||
|
Both numeric and string values, with
|
||||||
automatic conversion as above.
|
automatic conversion as above.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Aq Va expr1
|
.Aq Va expr1
|
||||||
@ -521,7 +587,8 @@ If both operands are numbers,
|
|||||||
is bit
|
is bit
|
||||||
shifted left (or right) by
|
shifted left (or right) by
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
bits. If
|
bits.
|
||||||
|
If
|
||||||
.Aq Va expr1
|
.Aq Va expr1
|
||||||
is
|
is
|
||||||
a string, then its first (or last)
|
a string, then its first (or last)
|
||||||
@ -539,7 +606,8 @@ in place of its value).
|
|||||||
.Ic -
|
.Ic -
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
.Xc
|
.Xc
|
||||||
Addition and subtraction on numbers. For ``+'', if one
|
Addition and subtraction on numbers.
|
||||||
|
For ``+'', if one
|
||||||
argument is a string, then the other is converted to a string,
|
argument is a string, then the other is converted to a string,
|
||||||
and the result is the concatenation of the two strings.
|
and the result is the concatenation of the two strings.
|
||||||
.It Xo
|
.It Xo
|
||||||
@ -553,7 +621,8 @@ and the result is the concatenation of the two strings.
|
|||||||
.Ic \&%
|
.Ic \&%
|
||||||
.Aq Va expr2
|
.Aq Va expr2
|
||||||
.Xc
|
.Xc
|
||||||
Multiplication, division, modulo. Numbers only.
|
Multiplication, division, modulo.
|
||||||
|
Numbers only.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Ic \- Ns Aq Va expr ,
|
.Ic \- Ns Aq Va expr ,
|
||||||
.Ic ~ Ns Aq Va expr ,
|
.Ic ~ Ns Aq Va expr ,
|
||||||
@ -562,16 +631,19 @@ Multiplication, division, modulo. Numbers only.
|
|||||||
.Ic \&$? Ns Aq Va expr
|
.Ic \&$? Ns Aq Va expr
|
||||||
.Xc
|
.Xc
|
||||||
The first three are unary minus, bitwise complement and logical complement
|
The first three are unary minus, bitwise complement and logical complement
|
||||||
on numbers only. The operator, ``$'', takes
|
on numbers only.
|
||||||
|
The operator, ``$'', takes
|
||||||
.Aq Va expr
|
.Aq Va expr
|
||||||
and returns
|
and returns
|
||||||
the value of the variable of that name. If
|
the value of the variable of that name.
|
||||||
|
If
|
||||||
.Aq Va expr
|
.Aq Va expr
|
||||||
is numeric
|
is numeric
|
||||||
with value
|
with value
|
||||||
.Ar n
|
.Ar n
|
||||||
and it appears within an alias macro (see below),
|
and it appears within an alias macro (see below),
|
||||||
then it refers to the nth argument of the alias invocation. ``$?''
|
then it refers to the nth argument of the alias invocation.
|
||||||
|
``$?''
|
||||||
tests for the existence of the variable
|
tests for the existence of the variable
|
||||||
.Aq Va expr ,
|
.Aq Va expr ,
|
||||||
and returns 1
|
and returns 1
|
||||||
@ -585,7 +657,8 @@ must be a string that is the unique
|
|||||||
prefix of the name of a builtin
|
prefix of the name of a builtin
|
||||||
.Nm
|
.Nm
|
||||||
function
|
function
|
||||||
or the full name of a user defined alias macro. In the case of a builtin
|
or the full name of a user defined alias macro.
|
||||||
|
In the case of a builtin
|
||||||
function,
|
function,
|
||||||
.Aq Ar arglist
|
.Aq Ar arglist
|
||||||
can be in one of two forms:
|
can be in one of two forms:
|
||||||
@ -595,28 +668,36 @@ argname1 = <expr1>, argname2 = <expr2>, ...
|
|||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The two forms can in fact be intermixed, but the result is
|
The two forms can in fact be intermixed, but the result is
|
||||||
unpredictable. Most arguments can be omitted; default values will
|
unpredictable.
|
||||||
be supplied for them. The
|
Most arguments can be omitted; default values will
|
||||||
|
be supplied for them.
|
||||||
|
The
|
||||||
.Ar argnames
|
.Ar argnames
|
||||||
can be unique prefixes
|
can be unique prefixes
|
||||||
of the argument names. The commas separating
|
of the argument names.
|
||||||
|
The commas separating
|
||||||
arguments are used only to disambiguate, and can usually be omitted.
|
arguments are used only to disambiguate, and can usually be omitted.
|
||||||
.Pp
|
.Pp
|
||||||
Only the first argument form is valid for user defined aliases. Aliases
|
Only the first argument form is valid for user defined aliases.
|
||||||
|
Aliases
|
||||||
are defined using the
|
are defined using the
|
||||||
.Ic alias
|
.Ic alias
|
||||||
builtin function (see below). Arguments
|
builtin function (see below).
|
||||||
|
Arguments
|
||||||
are accessed via a variant of the variable mechanism (see ``$'' operator
|
are accessed via a variant of the variable mechanism (see ``$'' operator
|
||||||
above).
|
above).
|
||||||
.Pp
|
.Pp
|
||||||
Most functions return value, but some are used for side effect
|
Most functions return value, but some are used for side effect
|
||||||
only and so must be used as statements. When a function or an alias is used
|
only and so must be used as statements.
|
||||||
|
When a function or an alias is used
|
||||||
as a statement, the parentheses surrounding
|
as a statement, the parentheses surrounding
|
||||||
the argument list may be omitted. Aliases return no value.
|
the argument list may be omitted.
|
||||||
|
Aliases return no value.
|
||||||
.El
|
.El
|
||||||
.Ss Builtin Functions
|
.Ss Builtin Functions
|
||||||
The arguments are listed by name in their natural
|
The arguments are listed by name in their natural
|
||||||
order. Optional arguments are in square brackets
|
order.
|
||||||
|
Optional arguments are in square brackets
|
||||||
.Sq Op .
|
.Sq Op .
|
||||||
Arguments
|
Arguments
|
||||||
that have no names are in angle brackets
|
that have no names are in angle brackets
|
||||||
@ -640,14 +721,16 @@ in which case a non-zero value is true.
|
|||||||
.Bq Aq Ar string\-list
|
.Bq Aq Ar string\-list
|
||||||
.Pc
|
.Pc
|
||||||
If no argument is given, all currently defined alias macros are
|
If no argument is given, all currently defined alias macros are
|
||||||
listed. Otherwise,
|
listed.
|
||||||
|
Otherwise,
|
||||||
.Aq Ar string
|
.Aq Ar string
|
||||||
is defined as an alias,
|
is defined as an alias,
|
||||||
with expansion
|
with expansion
|
||||||
.Aq Ar string\-list > .
|
.Aq Ar string\-list > .
|
||||||
The previous definition of
|
The previous definition of
|
||||||
.Aq Ar string ,
|
.Aq Ar string ,
|
||||||
if any, is returned. Default for
|
if any, is returned.
|
||||||
|
Default for
|
||||||
.Aq Ar string\-list
|
.Aq Ar string\-list
|
||||||
is no change.
|
is no change.
|
||||||
.It Ic close Ns Pq Aq Ar window\-list
|
.It Ic close Ns Pq Aq Ar window\-list
|
||||||
@ -657,7 +740,8 @@ If
|
|||||||
.Aq Ar window\-list
|
.Aq Ar window\-list
|
||||||
is the word
|
is the word
|
||||||
.Ar all ,
|
.Ar all ,
|
||||||
than all windows are closed. No value is returned.
|
than all windows are closed.
|
||||||
|
No value is returned.
|
||||||
.It Ic cursormodes Ns Pq Bq Ar modes
|
.It Ic cursormodes Ns Pq Bq Ar modes
|
||||||
Set the window cursor to
|
Set the window cursor to
|
||||||
.Ar modes .
|
.Ar modes .
|
||||||
@ -672,8 +756,10 @@ or of the mode bits defined as the variables
|
|||||||
(blinking),
|
(blinking),
|
||||||
and
|
and
|
||||||
.Ar m_grp
|
.Ar m_grp
|
||||||
(graphics, terminal dependent). Return
|
(graphics, terminal dependent).
|
||||||
value is the previous modes. Default is no change.
|
Return
|
||||||
|
value is the previous modes.
|
||||||
|
Default is no change.
|
||||||
For example,
|
For example,
|
||||||
.Li cursor($m_rev$m_blk)
|
.Li cursor($m_rev$m_blk)
|
||||||
sets the window cursors to blinking
|
sets the window cursors to blinking
|
||||||
@ -682,14 +768,19 @@ reverse video.
|
|||||||
Set the default buffer size to
|
Set the default buffer size to
|
||||||
.Ar nline .
|
.Ar nline .
|
||||||
Initially, it is
|
Initially, it is
|
||||||
48 lines. Returns the old default buffer size. Default is
|
48 lines.
|
||||||
no change. Using a very large buffer can slow the program down
|
Returns the old default buffer size.
|
||||||
|
Default is
|
||||||
|
no change.
|
||||||
|
Using a very large buffer can slow the program down
|
||||||
considerably.
|
considerably.
|
||||||
.It Ic default_shell Ns Pq Bq Aq Ar string\-list
|
.It Ic default_shell Ns Pq Bq Aq Ar string\-list
|
||||||
Set the default window shell program to
|
Set the default window shell program to
|
||||||
.Aq Ar string\-list .
|
.Aq Ar string\-list .
|
||||||
Returns
|
Returns
|
||||||
the first string in the old shell setting. Default is no change. Initially,
|
the first string in the old shell setting.
|
||||||
|
Default is no change.
|
||||||
|
Initially,
|
||||||
the default shell is taken from the environment variable
|
the default shell is taken from the environment variable
|
||||||
.Ev SHELL .
|
.Ev SHELL .
|
||||||
.It Ic default_smooth Ns Pq Bq Ar flag
|
.It Ic default_smooth Ns Pq Bq Ar flag
|
||||||
@ -698,7 +789,8 @@ Set the default value of the
|
|||||||
argument
|
argument
|
||||||
to the command
|
to the command
|
||||||
.Nm
|
.Nm
|
||||||
(see below). The argument
|
(see below).
|
||||||
|
The argument
|
||||||
is a boolean flag (one of
|
is a boolean flag (one of
|
||||||
.Ar on ,
|
.Ar on ,
|
||||||
.Ar off ,
|
.Ar off ,
|
||||||
@ -707,7 +799,8 @@ is a boolean flag (one of
|
|||||||
.Ar true ,
|
.Ar true ,
|
||||||
.Ar false ,
|
.Ar false ,
|
||||||
or a number,
|
or a number,
|
||||||
as described above). Default is no change.
|
as described above).
|
||||||
|
Default is no change.
|
||||||
The old value (as a number) is returned.
|
The old value (as a number) is returned.
|
||||||
The initial value is 1 (true).
|
The initial value is 1 (true).
|
||||||
.It Xo
|
.It Xo
|
||||||
@ -719,17 +812,21 @@ Write the list of strings,
|
|||||||
to
|
to
|
||||||
.Nm ,
|
.Nm ,
|
||||||
separated
|
separated
|
||||||
by spaces and terminated with a new line. The strings are only
|
by spaces and terminated with a new line.
|
||||||
|
The strings are only
|
||||||
displayed in the window, the processes in the window are not
|
displayed in the window, the processes in the window are not
|
||||||
involved (see
|
involved (see
|
||||||
.Ic write
|
.Ic write
|
||||||
below). No value is returned. Default
|
below).
|
||||||
|
No value is returned.
|
||||||
|
Default
|
||||||
is the current window.
|
is the current window.
|
||||||
.It Ic escape Ns Pq Bq Ar escapec
|
.It Ic escape Ns Pq Bq Ar escapec
|
||||||
Set the escape character to
|
Set the escape character to
|
||||||
.Ar escape-char .
|
.Ar escape-char .
|
||||||
Returns the old
|
Returns the old
|
||||||
escape character as a one-character string. Default is no
|
escape character as a one-character string.
|
||||||
|
Default is no
|
||||||
change.
|
change.
|
||||||
.Ar Escapec
|
.Ar Escapec
|
||||||
can be a string of a single character, or
|
can be a string of a single character, or
|
||||||
@ -745,8 +842,10 @@ Move
|
|||||||
.Nm
|
.Nm
|
||||||
in or out of foreground.
|
in or out of foreground.
|
||||||
.Ar Flag
|
.Ar Flag
|
||||||
is a boolean value. The old foreground flag
|
is a boolean value.
|
||||||
is returned. Default for
|
The old foreground flag
|
||||||
|
is returned.
|
||||||
|
Default for
|
||||||
.Nm
|
.Nm
|
||||||
is the current window,
|
is the current window,
|
||||||
default for
|
default for
|
||||||
@ -761,21 +860,27 @@ Set the label of
|
|||||||
to
|
to
|
||||||
.Ar label .
|
.Ar label .
|
||||||
Returns the old
|
Returns the old
|
||||||
label as a string. Default for
|
label as a string.
|
||||||
|
Default for
|
||||||
.Nm
|
.Nm
|
||||||
is the current
|
is the current
|
||||||
window, default for
|
window, default for
|
||||||
.Ar label
|
.Ar label
|
||||||
is no change. To turn
|
is no change.
|
||||||
|
To turn
|
||||||
off a label, set it to an empty string ("").
|
off a label, set it to an empty string ("").
|
||||||
.It Ic list Ns Pq
|
.It Ic list Ns Pq
|
||||||
No arguments. List the identifiers and labels of all windows. No
|
No arguments.
|
||||||
|
List the identifiers and labels of all windows.
|
||||||
|
No
|
||||||
value is returned.
|
value is returned.
|
||||||
.It Ic select Ns Pq Bq Ar window
|
.It Ic select Ns Pq Bq Ar window
|
||||||
Make
|
Make
|
||||||
.Nm
|
.Nm
|
||||||
the current window. The previous current window
|
the current window.
|
||||||
is returned. Default is no change.
|
The previous current window
|
||||||
|
is returned.
|
||||||
|
Default is no change.
|
||||||
.It Ic source Ns Pq Ar filename
|
.It Ic source Ns Pq Ar filename
|
||||||
Read and execute the long commands in
|
Read and execute the long commands in
|
||||||
.Ar filename .
|
.Ar filename .
|
||||||
@ -790,7 +895,8 @@ sounding the terminal's bell.
|
|||||||
can take on the same
|
can take on the same
|
||||||
values as in
|
values as in
|
||||||
.Ar foreground
|
.Ar foreground
|
||||||
above. Returns the old terse flag.
|
above.
|
||||||
|
Returns the old terse flag.
|
||||||
Default is no change.
|
Default is no change.
|
||||||
.It Ic unalias Ns Pq Ar alias
|
.It Ic unalias Ns Pq Ar alias
|
||||||
Undefine
|
Undefine
|
||||||
@ -807,7 +913,9 @@ Returns -1 if
|
|||||||
does not exist,
|
does not exist,
|
||||||
0 otherwise.
|
0 otherwise.
|
||||||
.It Ic variables Ns Pq
|
.It Ic variables Ns Pq
|
||||||
No arguments. List all variables. No value is returned.
|
No arguments.
|
||||||
|
List all variables.
|
||||||
|
No value is returned.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Ic window Ns ( Bq Ar row ,
|
.Ic window Ns ( Bq Ar row ,
|
||||||
.Bq Ar column ,
|
.Bq Ar column ,
|
||||||
@ -831,8 +939,10 @@ and size
|
|||||||
If
|
If
|
||||||
.Ar nline
|
.Ar nline
|
||||||
is specified,
|
is specified,
|
||||||
then that many lines are allocated for the text buffer. Otherwise,
|
then that many lines are allocated for the text buffer.
|
||||||
the default buffer size is used. Default values for
|
Otherwise,
|
||||||
|
the default buffer size is used.
|
||||||
|
Default values for
|
||||||
.Ar row ,
|
.Ar row ,
|
||||||
.Ar column ,
|
.Ar column ,
|
||||||
.Ar nrow ,
|
.Ar nrow ,
|
||||||
@ -856,10 +966,12 @@ allocate pseudo-terminal for this window rather than socketpair (default
|
|||||||
true), and map new line characters in this window to carriage return
|
true), and map new line characters in this window to carriage return
|
||||||
and line feed (default true if socketpair is used, false otherwise).
|
and line feed (default true if socketpair is used, false otherwise).
|
||||||
Normally, a window is automatically closed when its process
|
Normally, a window is automatically closed when its process
|
||||||
exits. Setting
|
exits.
|
||||||
|
Setting
|
||||||
.Ar keepopen
|
.Ar keepopen
|
||||||
to true (default false) prevents this
|
to true (default false) prevents this
|
||||||
action. When
|
action.
|
||||||
|
When
|
||||||
.Ar smooth
|
.Ar smooth
|
||||||
is true, the screen is updated more frequently
|
is true, the screen is updated more frequently
|
||||||
(for this window) to produce a more terminal-like behavior.
|
(for this window) to produce a more terminal-like behavior.
|
||||||
@ -873,7 +985,8 @@ is a list of strings that will be used as the shell
|
|||||||
program to place in the window (default is the program specified
|
program to place in the window (default is the program specified
|
||||||
by
|
by
|
||||||
.Ar default_shell ,
|
.Ar default_shell ,
|
||||||
see above). The created window's identifier
|
see above).
|
||||||
|
The created window's identifier
|
||||||
is returned as a number.
|
is returned as a number.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Ic write Ns ( Bq Ar window ,
|
.Ic write Ns ( Bq Ar window ,
|
||||||
@ -884,12 +997,16 @@ Send the list of strings,
|
|||||||
to
|
to
|
||||||
.Nm ,
|
.Nm ,
|
||||||
separated
|
separated
|
||||||
by spaces but not terminated with a new line. The strings are actually
|
by spaces but not terminated with a new line.
|
||||||
given to the window as input. No value is returned. Default
|
The strings are actually
|
||||||
|
given to the window as input.
|
||||||
|
No value is returned.
|
||||||
|
Default
|
||||||
is the current window.
|
is the current window.
|
||||||
.El
|
.El
|
||||||
.Ss Predefined Variables
|
.Ss Predefined Variables
|
||||||
These variables are for information only. Redefining them does
|
These variables are for information only.
|
||||||
|
Redefining them does
|
||||||
not affect the internal operation of
|
not affect the internal operation of
|
||||||
.Nm .
|
.Nm .
|
||||||
.Bl -tag -width modes
|
.Bl -tag -width modes
|
||||||
@ -897,7 +1014,8 @@ not affect the internal operation of
|
|||||||
The baud rate as a number between 50 and 38400.
|
The baud rate as a number between 50 and 38400.
|
||||||
.It Ar modes
|
.It Ar modes
|
||||||
The display modes (reverse video, underline, blinking, graphics)
|
The display modes (reverse video, underline, blinking, graphics)
|
||||||
supported by the physical terminal. The value of
|
supported by the physical terminal.
|
||||||
|
The value of
|
||||||
.Ar modes
|
.Ar modes
|
||||||
is the bitwise or of some of the one bit values,
|
is the bitwise or of some of the one bit values,
|
||||||
.Ar m_blk ,
|
.Ar m_blk ,
|
||||||
@ -923,7 +1041,8 @@ The number of columns on the physical screen.
|
|||||||
.It Ar nrow
|
.It Ar nrow
|
||||||
The number of rows on the physical screen.
|
The number of rows on the physical screen.
|
||||||
.It Ar term
|
.It Ar term
|
||||||
The terminal type. The standard name, found in the second name
|
The terminal type.
|
||||||
|
The standard name, found in the second name
|
||||||
field of the terminal's
|
field of the terminal's
|
||||||
.Ev TERMCAP
|
.Ev TERMCAP
|
||||||
entry, is used.
|
entry, is used.
|
||||||
|
@ -237,7 +237,8 @@ exits abnormally.
|
|||||||
.Pp
|
.Pp
|
||||||
File flags cannot be set by
|
File flags cannot be set by
|
||||||
.Xr fchflags 2
|
.Xr fchflags 2
|
||||||
over a NFS file system. Other file systems do not have a concept of flags.
|
over a NFS file system.
|
||||||
|
Other file systems do not have a concept of flags.
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility 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
|
||||||
|
@ -104,7 +104,8 @@ The default prefix is the string
|
|||||||
.It Fl r
|
.It Fl r
|
||||||
Cause
|
Cause
|
||||||
.Nm
|
.Nm
|
||||||
to produce separate files for code and tables. The code file
|
to produce separate files for code and tables.
|
||||||
|
The code file
|
||||||
is named
|
is named
|
||||||
.Pa y.code.c ,
|
.Pa y.code.c ,
|
||||||
and the tables file is named
|
and the tables file is named
|
||||||
|
@ -73,13 +73,15 @@ to their corresponding map names.
|
|||||||
.It Fl m Op Ar mname
|
.It Fl m Op Ar mname
|
||||||
Find the master
|
Find the master
|
||||||
.Tn YP
|
.Tn YP
|
||||||
server for the named map. No
|
server for the named map.
|
||||||
|
No
|
||||||
.Ar host
|
.Ar host
|
||||||
may be specified with the
|
may be specified with the
|
||||||
.Fl m
|
.Fl m
|
||||||
option.
|
option.
|
||||||
.Ar Mname
|
.Ar Mname
|
||||||
can be a map name or nickname. If
|
can be a map name or nickname.
|
||||||
|
If
|
||||||
.Ar mname
|
.Ar mname
|
||||||
is omitted,
|
is omitted,
|
||||||
.Nm
|
.Nm
|
||||||
|
Loading…
Reference in New Issue
Block a user