mdoc(7) police: split punctuation characters + misc fixes.
This commit is contained in:
parent
1f56a9494c
commit
d0353b836e
@ -46,7 +46,7 @@
|
||||
.Oc
|
||||
.Op Fl ain
|
||||
.Op Fl t Ar type
|
||||
.Op Ar file | Ar filesystem ...
|
||||
.Op Ar file | filesystem ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Df
|
||||
displays statistics about the amount of free disk space on the specified
|
||||
|
@ -44,19 +44,24 @@
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Op Fl n
|
||||
.Op "string ..."
|
||||
.Op Ar string ...
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
utility writes any specified operands, separated by single blank (`` '')
|
||||
characters and followed by a newline (``\en'') character, to the standard
|
||||
utility writes any specified operands, separated by single blank
|
||||
.Pq Ql "\ "
|
||||
characters and followed by a newline
|
||||
.Pq Ql \en
|
||||
character, to the standard
|
||||
output.
|
||||
.Pp
|
||||
The following option is available:
|
||||
.Bl -tag -width flag
|
||||
.It Fl n
|
||||
Do not print the trailing newline character. This may also be
|
||||
achieved by appending `\ec' to the end of the string, as is done
|
||||
achieved by appending
|
||||
.Ql \ec
|
||||
to the end of the string, as is done
|
||||
by iBCS2 compatible systems.
|
||||
.El
|
||||
.Pp
|
||||
|
@ -104,8 +104,9 @@ character command and possibly additional parameters; i.e.,
|
||||
commands have the structure:
|
||||
.Pp
|
||||
.Sm off
|
||||
.Xo Op "address\ " Op ,address
|
||||
.No command Op parameters
|
||||
.Xo
|
||||
.Op Ar address Op , Ar address
|
||||
.Ar command Op Ar parameters
|
||||
.Xc
|
||||
.Sm on
|
||||
.Pp
|
||||
@ -185,7 +186,7 @@ of addresses is given where
|
||||
.Em "n\ >\ 2" ,
|
||||
then the corresponding range is determined by the last two addresses in
|
||||
the
|
||||
.Em n Ns -tuple.
|
||||
.Em n Ns -tuple .
|
||||
If only one address is expected, then the last address is used.
|
||||
.Pp
|
||||
Each address in a comma-delimited range is interpreted relative to the
|
||||
|
@ -217,7 +217,7 @@ options all override each other; the last one specified determines
|
||||
the format used for non-printable characters.
|
||||
.Pp
|
||||
The
|
||||
.Fl H,
|
||||
.Fl H ,
|
||||
.Fl L
|
||||
and
|
||||
.Fl P
|
||||
@ -431,7 +431,7 @@ for more information.
|
||||
.It Ev LSCOLORS
|
||||
The value of this variable describes what color to use for which
|
||||
attribute when colors are enabled with
|
||||
.Ev CLICOLOR.
|
||||
.Ev CLICOLOR .
|
||||
This string is a concatenation of pairs of the format
|
||||
.Sy fb ,
|
||||
where
|
||||
|
@ -198,7 +198,7 @@ options specifies which of the following functional modes
|
||||
will operate under:
|
||||
.Em list , read , write ,
|
||||
and
|
||||
.Em copy.
|
||||
.Em copy .
|
||||
.Bl -tag -width 6n
|
||||
.It <none>
|
||||
.Em List .
|
||||
@ -208,7 +208,7 @@ will write to
|
||||
a table of contents of the members of the archive file read from
|
||||
.Dv standard input ,
|
||||
whose pathnames match the specified
|
||||
.Ar patterns.
|
||||
.Ar patterns .
|
||||
The table of contents contains one filename per line
|
||||
and is written using single line buffering.
|
||||
.It Fl r
|
||||
@ -217,7 +217,7 @@ and is written using single line buffering.
|
||||
extracts the members of the archive file read from the
|
||||
.Dv standard input ,
|
||||
with pathnames matching the specified
|
||||
.Ar patterns.
|
||||
.Ar patterns .
|
||||
The archive format and blocking is automatically determined on input.
|
||||
When an extracted file is a directory, the entire file hierarchy
|
||||
rooted at that directory is extracted.
|
||||
@ -811,7 +811,7 @@ The default
|
||||
.Ar limit
|
||||
is a small positive number of retries.
|
||||
.Pp
|
||||
.Em Warning:
|
||||
.Em Warning :
|
||||
Using this option with
|
||||
.Li NONE
|
||||
should be used with extreme caution as
|
||||
@ -1045,7 +1045,7 @@ option, a file is not considered selected unless it is newer
|
||||
than the file to which it is compared.
|
||||
.Sh EXAMPLES
|
||||
The command:
|
||||
.Dl pax -w -f /dev/rst0 .\
|
||||
.Dl "pax -w -f /dev/rst0 ."
|
||||
copies the contents of the current directory to the device
|
||||
.Pa /dev/rst0 .
|
||||
.Pp
|
||||
|
@ -148,7 +148,7 @@ Display information about processes attached to the specified terminal
|
||||
device.
|
||||
.It Fl U
|
||||
Display the processes belonging to the specified
|
||||
.Tn username Ns No (s).
|
||||
.Ar username Ns (s) .
|
||||
.It Fl u
|
||||
Display information associated with the following keywords:
|
||||
user, pid, %cpu, %mem, vsz, rss, tt, state, start, time and command.
|
||||
|
13
bin/sh/sh.1
13
bin/sh/sh.1
@ -1276,9 +1276,9 @@ these, a builtin version of the
|
||||
.Xr printf 1
|
||||
command is provided for efficiency.
|
||||
.Bl -tag -width Ds
|
||||
.It Ic :
|
||||
.It Ic \&:
|
||||
A null command that returns a 0 (true) exit value.
|
||||
.It Ic . Ar file
|
||||
.It Ic \&. Ar file
|
||||
The commands in the specified file are read and executed by the shell.
|
||||
If
|
||||
.Ar file
|
||||
@ -1290,9 +1290,11 @@ for the file. If it is not found in the
|
||||
.Ev PATH ,
|
||||
it is sought in the current working directory.
|
||||
.It Ic alias Op Ar name ...
|
||||
.It Ic alias Op Ar name=string ...
|
||||
.It Ic alias Xo
|
||||
.Op Ar name Ns = Ns Ar string ...
|
||||
.Xc
|
||||
If
|
||||
.Ar name=string
|
||||
.Ar name Ns = Ns Ar string
|
||||
is specified, the shell defines the alias
|
||||
.Ar name
|
||||
with value
|
||||
@ -1515,7 +1517,8 @@ Re-execute the command without invoking an editor.
|
||||
Select the commands to list or edit.
|
||||
The number of previous commands that can be accessed
|
||||
are determined by the value of the
|
||||
.Ev HISTSIZE variable.
|
||||
.Ev HISTSIZE
|
||||
variable.
|
||||
The value of
|
||||
.Ar first
|
||||
or
|
||||
|
@ -448,7 +448,7 @@ The terminal size is recorded as having
|
||||
columns.
|
||||
.It Cm cols Ar number
|
||||
is an alias for
|
||||
.Cm columns.
|
||||
.Cm columns .
|
||||
.It Cm rows Ar number
|
||||
The terminal size is recorded as having
|
||||
.Ar number
|
||||
|
@ -78,7 +78,18 @@
|
||||
.Ft "int"
|
||||
.Fn dialog_textbox "unsigned char *title" "unsigned char *prompt" "int height" "int width"
|
||||
.Ft "int"
|
||||
.Fn dialog_menu "unsigned char *title" "unsigned char *prompt" "int height" "int width" "int menu_height" "int item_no" "void *itptr" "unsigned char *result, int *ch, int *sc"
|
||||
.Fo dialog_menu
|
||||
.Fa "unsigned char *title"
|
||||
.Fa "unsigned char *prompt"
|
||||
.Fa "int height"
|
||||
.Fa "int width"
|
||||
.Fa "int menu_height"
|
||||
.Fa "int item_no"
|
||||
.Fa "void *itptr"
|
||||
.Fa "unsigned char *result"
|
||||
.Fa "int *ch"
|
||||
.Fa "int *sc"
|
||||
.Fc
|
||||
.Ft "int"
|
||||
.Fn dialog_checklist "unsigned char *title" "unsigned char *prompt" "int height" "int width" "int m_height" "int item_no" "void *itptr" "unsigned char *result"
|
||||
.Ft "int"
|
||||
@ -341,7 +352,7 @@ integer representing the number of
|
||||
structures pointed to by
|
||||
.Va itptr
|
||||
(which should be of type
|
||||
.Va dialogMenuItem "*" ),
|
||||
.Vt dialogMenuItem "*" ) ,
|
||||
one structure per item. In the new interface, the
|
||||
.Va result
|
||||
variable is used as a simple boolean (not a pointer) and should be NULL if
|
||||
|
@ -90,15 +90,14 @@ Specifies that linking against dynamic libraries can take place. If a library
|
||||
specifier of the form -lx appears on the command line,
|
||||
.Nm
|
||||
searches for a library of the from libx.so.n.m
|
||||
.Po see the \&
|
||||
(see the
|
||||
.Fl l
|
||||
option
|
||||
.Pc
|
||||
option)
|
||||
according to the search rules in effect. If such a file can not be
|
||||
found a traditional archive is looked for.
|
||||
This options can appear anywhere on the command line and is complementary
|
||||
to
|
||||
.Fl B Ns Ar static.
|
||||
.Fl B Ns Ar static .
|
||||
.It Fl B Ns Ar forcedynamic
|
||||
This is similar to
|
||||
.Fl B Ns Ar dynamic
|
||||
@ -143,7 +142,7 @@ Force allocation of commons even producing relocatable output.
|
||||
Force alias definitions of procedure calls in non-PIC code. Useful to
|
||||
obtain shareable code in the presence of run-time relocations as such
|
||||
calls will be re-directed through the Procedure Linkage Table (see
|
||||
.Xr link 5)
|
||||
.Xr link 5 )
|
||||
.It Fl e Ar entry-symbol
|
||||
Specifies the entry symbol for an executable.
|
||||
.It Fl f
|
||||
@ -161,12 +160,12 @@ output. If the
|
||||
.Fl B Ns Ar dynamic
|
||||
option is in effect, a shared library of the
|
||||
form lib<spec>.so.m.n
|
||||
.Po where \&
|
||||
(where
|
||||
.Em m
|
||||
is the major, and
|
||||
.Em n
|
||||
is the minor version number, respectively
|
||||
.Pc is searched for first. The
|
||||
is the minor version number, respectively)
|
||||
is searched for first. The
|
||||
library with the highest version found in the search path is selected.
|
||||
If no shared library is found or the
|
||||
.Fl B Ns Ar static
|
||||
@ -187,22 +186,20 @@ Produce a
|
||||
output file.
|
||||
.It Fl nostdlib
|
||||
Do not search the built-in path
|
||||
.Po
|
||||
usually
|
||||
.Dq /usr/lib
|
||||
.Pc
|
||||
(usually
|
||||
.Dq /usr/lib )
|
||||
for
|
||||
.Fl l
|
||||
specified libraries.
|
||||
.It Fl O Ar filename
|
||||
Specifies the name of the output file.
|
||||
The file is created as
|
||||
.Ar filename .tmp
|
||||
.Ar filename Ns Pa .tmp
|
||||
and when output is complete renamed to
|
||||
.Ar filename .
|
||||
.It Fl o Ar filename
|
||||
Specifies the name of the output file. Defaults to
|
||||
.Dq a.out.
|
||||
.Dq Pa a.out .
|
||||
.It Fl Q
|
||||
Produce a
|
||||
.Dv QMAGIC
|
||||
|
@ -63,7 +63,7 @@ combines the object and archive files given on the command line into a new
|
||||
object file. The output object file is either an executable program, a
|
||||
shared object suitable for loading at run-time, or an object file that can
|
||||
once again be processed by
|
||||
.Nm ld.
|
||||
.Nm .
|
||||
Object files and archives are processed in the order given on the command line.
|
||||
.Pp
|
||||
The options are as follows:
|
||||
@ -74,12 +74,12 @@ The the symbol-file is taken as a base for link-editing the object files
|
||||
on the command line.
|
||||
.It Fl assert Ar keyword
|
||||
This option is here mainly for compatibility with SunOS
|
||||
.Nm ld .
|
||||
.Nm .
|
||||
Most conditions which would cause a Sun assertion to fail will
|
||||
currently always cause error or warning messages from
|
||||
.Nm ld .
|
||||
.Nm .
|
||||
The only keyword implemented by
|
||||
.Nm ld
|
||||
.Nm
|
||||
is
|
||||
.Nm pure-text ,
|
||||
which generates a warning if a position independent object is being
|
||||
@ -88,22 +88,21 @@ independent.
|
||||
.It Fl B Ns Ar dynamic
|
||||
Specifies that linking against dynamic libraries can take place. If a library
|
||||
specifier of the form -lx appears on the command line,
|
||||
.Nm ld
|
||||
.Nm
|
||||
searches for a library of the from libx.so.n.m
|
||||
.Po see the \&
|
||||
(see the
|
||||
.Fl l
|
||||
option
|
||||
.Pc
|
||||
option)
|
||||
according to the search rules in effect. If such a file can not be
|
||||
found a traditional archive is looked for.
|
||||
This options can appear anywhere on the command line and is complementary
|
||||
to
|
||||
.Fl B Ns Ar static.
|
||||
.Fl B Ns Ar static .
|
||||
.It Fl B Ns Ar forcedynamic
|
||||
This is similar to
|
||||
.Fl B Ns Ar dynamic
|
||||
except that if no dynamic libraries are linked against,
|
||||
.Nm ld
|
||||
.Nm
|
||||
will still produce a dynamic executable. This is useful for programs
|
||||
which are static but still need to load dynamic objects at runtime.
|
||||
.It Fl B Ns Ar static
|
||||
@ -143,7 +142,7 @@ Force allocation of commons even producing relocatable output.
|
||||
Force alias definitions of procedure calls in non-PIC code. Useful to
|
||||
obtain shareable code in the presence of run-time relocations as such
|
||||
calls will be re-directed through the Procedure Linkage Table (see
|
||||
.Xr link 5)
|
||||
.Xr link 5 )
|
||||
.It Fl e Ar entry-symbol
|
||||
Specifies the entry symbol for an executable.
|
||||
.It Fl f
|
||||
@ -161,12 +160,12 @@ output. If the
|
||||
.Fl B Ns Ar dynamic
|
||||
option is in effect, a shared library of the
|
||||
form lib<spec>.so.m.n
|
||||
.Po where \&
|
||||
(where
|
||||
.Em m
|
||||
is the major, and
|
||||
.Em n
|
||||
is the minor version number, respectively
|
||||
.Pc is searched for first. The
|
||||
is the minor version number, respectively)
|
||||
is searched for first. The
|
||||
library with the highest version found in the search path is selected.
|
||||
If no shared library is found or the
|
||||
.Fl B Ns Ar static
|
||||
@ -187,29 +186,27 @@ Produce a
|
||||
output file.
|
||||
.It Fl nostdlib
|
||||
Do not search the built-in path
|
||||
.Po
|
||||
usually
|
||||
.Dq /usr/lib
|
||||
.Pc
|
||||
(usually
|
||||
.Dq /usr/lib )
|
||||
for
|
||||
.Fl l
|
||||
specified libraries.
|
||||
.It Fl O Ar filename
|
||||
Specifies the name of the output file.
|
||||
The file is created as
|
||||
.Ar filename .tmp
|
||||
.Ar filename Ns Pa .tmp
|
||||
and when output is complete renamed to
|
||||
.Ar filename .
|
||||
.It Fl o Ar filename
|
||||
Specifies the name of the output file. Defaults to
|
||||
.Dq a.out.
|
||||
.Dq Pa a.out .
|
||||
.It Fl Q
|
||||
Produce a
|
||||
.Dv QMAGIC
|
||||
(FreeBSD/BSDi-i386) output file. This is the default.
|
||||
.It Fl r
|
||||
Produce relocatable object file, suitable for another pass through
|
||||
.Nm ld.
|
||||
.Nm .
|
||||
.It Fl R
|
||||
Record the given path within the executable for run-time library search.
|
||||
This only applies to dynamically linked executables.
|
||||
@ -273,7 +270,7 @@ options and preceding the built-in path.
|
||||
.Sh CAVEATS
|
||||
An entry point must now explicitly be given if the output is intended to be
|
||||
a normal executable program. This was not the case for the previous version of
|
||||
.Nm ld .
|
||||
.Nm .
|
||||
.Sh BUGS
|
||||
Shared objects are not properly checked for undefined symbols.
|
||||
.Pp
|
||||
@ -282,7 +279,7 @@ Cascading of shared object defeats the
|
||||
option.
|
||||
.Pp
|
||||
All shared objects presented to
|
||||
.Nm ld
|
||||
.Nm
|
||||
are marked for run-time loading in the output file, even if no symbols
|
||||
are needed from them.
|
||||
.Sh HISTORY
|
||||
|
@ -39,7 +39,7 @@
|
||||
.Op Fl p | Fl print
|
||||
.Op Fl r | Fl remove
|
||||
.Op Fl v | Fl verbose
|
||||
.Op Ar directories...
|
||||
.Op Ar directories ...
|
||||
.Sh DESCRIPTION
|
||||
.Nm Catman
|
||||
format man pages to ASCII. It's like typing
|
||||
|
@ -80,7 +80,7 @@ Write all output to
|
||||
.Ar file
|
||||
instead of
|
||||
.Pa dirname/whatis Ns .
|
||||
.It Fl v, Fl verbose
|
||||
.It Fl v , Fl verbose
|
||||
Issue more warnings
|
||||
.Pq to stderr .
|
||||
For every parsed man page write a single char:
|
||||
|
@ -14,7 +14,7 @@
|
||||
.Nd "tape archiver; manipulate ""tar"" archive files"
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Op [-] Ns Ar bundled-options Ar Args
|
||||
.Op Oo Fl Oc Ns Ar bundled-options Ar Args
|
||||
.Op Ar gnu-style-flags
|
||||
.Op Ar filenames | Fl C Ar directory-name
|
||||
.Ar ...
|
||||
@ -312,7 +312,7 @@ Unlink files before creating them.
|
||||
Lists files written to archive with
|
||||
.Fl -create
|
||||
or extracted with
|
||||
.Fl -extract;
|
||||
.Fl -extract ;
|
||||
lists file protection information along with file names with
|
||||
.Fl -list .
|
||||
.It Fl V Ar volume-name
|
||||
|
@ -36,7 +36,7 @@
|
||||
.Os FreeBSD
|
||||
.Dt DLOPEN 3
|
||||
.Sh NAME
|
||||
.Nm dlopen, dlsym, dlerror, dlclose
|
||||
.Nm dlopen , dlsym , dlerror , dlclose
|
||||
.Nd programmatic interface to the dynamic linker
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
|
@ -341,7 +341,7 @@ are attempted.
|
||||
The
|
||||
.Fa fts_name
|
||||
field is always
|
||||
.Dv NUL Ns -terminated.
|
||||
.Dv NUL Ns -terminated .
|
||||
.Sh FTS_OPEN
|
||||
The
|
||||
.Fn fts_open
|
||||
|
@ -84,13 +84,13 @@ from the database specified by the
|
||||
terminated file array
|
||||
.Fa db_array
|
||||
and returns a pointer to a
|
||||
.Xr malloc Ns \&'d
|
||||
.Xr malloc 3 Ns \&'d
|
||||
copy of it in
|
||||
.Fa buf .
|
||||
The
|
||||
.Fn cgetent
|
||||
function will first look for files ending in
|
||||
.Nm .db
|
||||
.Pa .db
|
||||
(see
|
||||
.Xr cap_mkdb 1 )
|
||||
before accessing the ASCII file.
|
||||
@ -103,7 +103,7 @@ must be retained through all subsequent calls to
|
||||
and
|
||||
.Fn cgetustr ,
|
||||
but may then be
|
||||
.Xr free 3 Ns \&'d.
|
||||
.Xr free 3 Ns \&'d .
|
||||
On success 0 is returned, 1 if the returned
|
||||
record contains an unresolved
|
||||
.Nm tc
|
||||
@ -200,7 +200,7 @@ from the capability record pointed to by
|
||||
A pointer to a decoded,
|
||||
.Dv NUL
|
||||
terminated,
|
||||
.Xr malloc Ns \&'d
|
||||
.Xr malloc 3 Ns \&'d
|
||||
copy of the string is returned in the
|
||||
.Ft char *
|
||||
pointed to by
|
||||
@ -241,7 +241,7 @@ or
|
||||
call. If there is no such previous call, the first record in the database is
|
||||
returned.
|
||||
Each record is returned in a
|
||||
.Xr malloc Ns \&'d
|
||||
.Xr malloc 3 Ns \&'d
|
||||
copy pointed to by
|
||||
.Fa buf .
|
||||
.Ic Tc
|
||||
@ -416,21 +416,27 @@ and
|
||||
.Bl -column "nameXnumber"
|
||||
.Sm off
|
||||
.It Em name No \&# Em number Ta numeric
|
||||
.Sm on
|
||||
capability
|
||||
.Em name
|
||||
has value
|
||||
.Em number
|
||||
.Sm off
|
||||
.It Em name No = Em string Ta "string capability"
|
||||
.Sm on
|
||||
.Em name
|
||||
has value
|
||||
.Em string
|
||||
.Sm off
|
||||
.It Em name No \&#@ Ta "the numeric capability"
|
||||
.Em name
|
||||
does not exist
|
||||
.It Em name No \&=@ Ta "the string capability"
|
||||
.Em name
|
||||
does not exist
|
||||
.Sm on
|
||||
.Em name
|
||||
does not exist
|
||||
.Sm off
|
||||
.It Em name No \&=@ Ta "the string capability"
|
||||
.Sm on
|
||||
.Em name
|
||||
does not exist
|
||||
.El
|
||||
.Pp
|
||||
Numeric capability values may be given in one of three numeric bases.
|
||||
|
@ -66,7 +66,7 @@ is
|
||||
.Dv NULL ,
|
||||
space is allocated as necessary to store the pathname.
|
||||
This space may later be
|
||||
.Xr free 3 Ns 'd.
|
||||
.Xr free 3 Ns 'd .
|
||||
.Pp
|
||||
The function
|
||||
.Fn getwd
|
||||
@ -89,7 +89,7 @@ These routines have traditionally been used by programs to save the
|
||||
name of a working directory for the purpose of returning to it.
|
||||
A much faster and less error-prone method of accomplishing this is to
|
||||
open the current directory
|
||||
.Pq Ql \&.
|
||||
.Pq Ql .\&
|
||||
and use the
|
||||
.Xr fchdir 2
|
||||
function to return.
|
||||
|
@ -178,7 +178,7 @@ The
|
||||
.Fn getpwent ,
|
||||
.Fn getpwnam ,
|
||||
.Fn getpwuid ,
|
||||
.Fn setpwent,
|
||||
.Fn setpwent ,
|
||||
and
|
||||
.Fn endpwent
|
||||
functions appeared in
|
||||
|
@ -269,7 +269,7 @@ is
|
||||
.Pf non- Dv NULL ,
|
||||
.Fn glob
|
||||
calls
|
||||
.Fa (*errfunc)(path, errno) .
|
||||
.Fa \*(lp*errfunc\*(rp Ns ( Fa path , errno ) .
|
||||
This may be unintuitive: a pattern like
|
||||
.Ql */Makefile
|
||||
will try to
|
||||
@ -374,7 +374,7 @@ An attempt to allocate memory failed.
|
||||
The scan was stopped because an error was encountered and either
|
||||
.Dv GLOB_ERR
|
||||
was set or
|
||||
.Fa (*errfunc)()
|
||||
.Fa \*(lp*errfunc\*(rp\*(lp\*(rp
|
||||
returned non-zero.
|
||||
.El
|
||||
.Pp
|
||||
@ -409,13 +409,13 @@ function is expected to be
|
||||
.St -p1003.2
|
||||
compatible with the exception
|
||||
that the flags
|
||||
.Dv GLOB_ALTDIRFUNC,
|
||||
.Dv GLOB_BRACE
|
||||
.Dv GLOB_MAGCHAR,
|
||||
.Dv GLOB_NOMAGIC,
|
||||
.Dv GLOB_QUOTE,
|
||||
.Dv GLOB_ALTDIRFUNC ,
|
||||
.Dv GLOB_BRACE ,
|
||||
.Dv GLOB_MAGCHAR ,
|
||||
.Dv GLOB_NOMAGIC ,
|
||||
.Dv GLOB_QUOTE ,
|
||||
and
|
||||
.Dv GLOB_TILDE,
|
||||
.Dv GLOB_TILDE ,
|
||||
and the fields
|
||||
.Fa gl_matchc
|
||||
and
|
||||
|
@ -60,7 +60,7 @@ or
|
||||
does not have a message queue identifier associated with it, and the
|
||||
.Dv IPC_CREAT
|
||||
bit is set in
|
||||
.Fa msgflg.
|
||||
.Fa msgflg .
|
||||
.Pp
|
||||
If a new message queue is created, the data structure associated with it (the
|
||||
.Va msqid_ds
|
||||
|
@ -186,7 +186,7 @@ The next and subsequent levels down are found in the include files
|
||||
listed here, and described in separate sections below.
|
||||
.Pp
|
||||
.Bl -column CTLXMACHDEPXXX "Next level namesXXXXXX" -offset indent
|
||||
.It Sy Pa "Name Next level names Description"
|
||||
.It Sy "Name Next level names Description"
|
||||
.It "CTL\_DEBUG sys/sysctl.h Debugging"
|
||||
.It "CTL\_VFS sys/mount.h Filesystem"
|
||||
.It "CTL\_HW sys/sysctl.h Generic CPU, I/O"
|
||||
@ -272,7 +272,7 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "Second level nameXXXXXX" integerXXX -offset indent
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It Sy "Second level name Type Changeable"
|
||||
.It "HW\_MACHINE string no"
|
||||
.It "HW\_MODEL string no"
|
||||
.It "HW\_NCPU integer no"
|
||||
@ -318,7 +318,7 @@ system vnodes, the open file entries, routing table entries,
|
||||
virtual memory statistics, load average history, and clock rate
|
||||
information.
|
||||
.Bl -column "KERNXMAXFILESPERPROCXXX" "struct clockrateXXX" -offset indent
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It Sy "Second level name Type Changeable"
|
||||
.It "KERN\_ARGMAX integer no"
|
||||
.It "KERN\_BOOTFILE string yes"
|
||||
.It "KERN\_BOOTTIME struct timeval no"
|
||||
@ -424,7 +424,7 @@ structures is returned,
|
||||
whose size depends on the current number of such objects in the system.
|
||||
The third and fourth level names are as follows:
|
||||
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
|
||||
.It Pa "Third level name Fourth level is:"
|
||||
.It "Third level name Fourth level is:"
|
||||
.It "KERN\_PROC\_ALL None"
|
||||
.It "KERN\_PROC\_PID A process ID"
|
||||
.It "KERN\_PROC\_PGRP A process group"
|
||||
@ -439,7 +439,7 @@ follow each other.
|
||||
The total size of array is returned.
|
||||
It is also possible for a process to set its own process title this way.
|
||||
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
|
||||
.It Pa "Third level name Fourth level is:"
|
||||
.It Sy "Third level name Fourth level is:"
|
||||
.It "KERN\_PROC\_ARGS A process ID"
|
||||
.El
|
||||
.It Li KERN_PROF
|
||||
@ -453,7 +453,7 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "GPROFXGMONPARAMXXX" "struct gmonparamXXX" -offset indent
|
||||
.It Sy Pa "Third level name Type Changeable"
|
||||
.It Sy "Third level name Type Changeable"
|
||||
.It "GPROF\_STATE integer yes"
|
||||
.It "GPROF\_COUNT u_short[\|] yes"
|
||||
.It "GPROF\_FROMS u_short[\|] yes"
|
||||
@ -503,7 +503,7 @@ followed by the vnode itself
|
||||
The set of variables defined is architecture dependent.
|
||||
The following variables are defined for the i386 architecture.
|
||||
.Bl -column "CONSOLE_DEVICEXXX" "struct bootinfoXXX" -offset indent
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It Sy "Second level name Type Changeable"
|
||||
.It Li "CPU_CONSDEV dev_t no"
|
||||
.It Li "CPU_ADJKERNTZ int yes"
|
||||
.It Li "CPU_DISRTCSET int yes"
|
||||
@ -516,7 +516,7 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "Second level nameXXXXXX" "routing messagesXXX" -offset indent
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It Sy "Second level name Type Changeable"
|
||||
.It "PF\_ROUTE routing messages no"
|
||||
.It "PF\_INET IPv4 values yes"
|
||||
.It "PF\_INET6 IPv6 values yes"
|
||||
@ -535,7 +535,7 @@ The fourth level name is an address family, which may be set to 0 to
|
||||
select all address families.
|
||||
The fifth and sixth level names are as follows:
|
||||
.Bl -column "Fifth level nameXXXXXX" "Sixth level is:XXX" -offset indent
|
||||
.It Pa "Fifth level name Sixth level is:"
|
||||
.It Sy "Fifth level name Sixth level is:"
|
||||
.It "NET\_RT\_FLAGS rtflags"
|
||||
.It "NET\_RT\_DUMP None"
|
||||
.It "NET\_RT\_IFLIST None"
|
||||
@ -547,7 +547,7 @@ The third level name is the protocol.
|
||||
The fourth level name is the variable name.
|
||||
The currently defined protocols and names are:
|
||||
.Bl -column ProtocolXX VariableXX TypeXX ChangeableXX
|
||||
.It Pa "Protocol Variable Type Changeable"
|
||||
.It Sy "Protocol Variable Type Changeable"
|
||||
.It "icmp bmcastecho integer yes"
|
||||
.It "icmp maskrepl integer yes"
|
||||
.It "ip forwarding integer yes"
|
||||
@ -598,7 +598,7 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "USER_COLL_WEIGHTS_MAXXXX" "integerXXX" -offset indent
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It Sy "Second level name Type Changeable"
|
||||
.It "USER\_BC\_BASE\_MAX integer no"
|
||||
.It "USER\_BC\_DIM\_MAX integer no"
|
||||
.It "USER\_BC\_SCALE\_MAX integer no"
|
||||
@ -694,7 +694,7 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "Second level nameXXXXXX" "struct loadavgXXX" -offset indent
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It Sy "Second level name Type Changeable"
|
||||
.It "VM\_LOADAVG struct loadavg no"
|
||||
.It "VM\_METER struct vmtotal no"
|
||||
.It "VM\_PAGEOUT\_ALGORITHM integer yes"
|
||||
|
@ -146,7 +146,7 @@ If
|
||||
cannot pass the message to
|
||||
.Xr syslogd 8
|
||||
it will attempt to write the message to the console
|
||||
.Pq Dq Pa /dev/console.
|
||||
.Pq Dq Pa /dev/console .
|
||||
.It Dv LOG_NDELAY
|
||||
Open the connection to
|
||||
.Xr syslogd 8
|
||||
|
@ -184,7 +184,7 @@ The
|
||||
.Fn cfmakeraw
|
||||
function sets the flags stored in the termios structure to a state disabling
|
||||
all input and output processing, giving a
|
||||
.Dq raw I/O path.
|
||||
.Dq raw I/O path .
|
||||
It should be noted that there is no function to reverse this effect.
|
||||
This is because there are a variety of processing options that could be
|
||||
re-enabled and the correct method is for an application to snapshot the
|
||||
|
@ -62,7 +62,7 @@ and named
|
||||
.Pa /dev/tty Ns Em xx
|
||||
and for which an entry exists
|
||||
in the initialization file
|
||||
.Pa /etc/ttys.
|
||||
.Pa /etc/ttys .
|
||||
(See
|
||||
.Xr ttys 5 . )
|
||||
.Pp
|
||||
|
@ -116,13 +116,11 @@ When
|
||||
is used directly as a specification of the time conversion information,
|
||||
it must have the following syntax (spaces inserted for clarity):
|
||||
.Bd -filled -offset indent
|
||||
.Em std offset Bo
|
||||
.Em dst Bo
|
||||
.Em offset
|
||||
.Bc
|
||||
.Em std offset
|
||||
.Bo
|
||||
.No , Em rule
|
||||
.Bc
|
||||
.Em dst
|
||||
.Bq Em offset
|
||||
.Bq , Em rule
|
||||
.Bc
|
||||
.Ed
|
||||
.Pp
|
||||
@ -156,13 +154,13 @@ Indicates the value one must add to the local time to arrive at
|
||||
Coordinated Universal Time. The
|
||||
.Em offset
|
||||
has the form:
|
||||
.Bd -unfilled -offset indent
|
||||
.Bd -ragged -offset indent
|
||||
.Sm off
|
||||
.Em hh Bo
|
||||
.Pf \&: Em mm
|
||||
.Bo
|
||||
.Pf \&: Em ss
|
||||
.Bc
|
||||
.Em : mm
|
||||
.Bq Em : ss
|
||||
.Bc
|
||||
.Sm on
|
||||
.Ed
|
||||
.Pp
|
||||
The minutes
|
||||
|
@ -52,9 +52,9 @@ the current system into the structure referenced by
|
||||
.Fa name .
|
||||
.Pp
|
||||
The
|
||||
.Li utsname
|
||||
.Vt utsname
|
||||
structure is defined in the
|
||||
.Li <sys/utsname.h>
|
||||
.Aq Pa sys/utsname.h
|
||||
header file, and contains the following members:
|
||||
.Bl -tag -width nodenameXXXX -offset indent
|
||||
.It sysname
|
||||
|
@ -100,7 +100,7 @@ characters from
|
||||
.Fa src
|
||||
(this
|
||||
is useful for encoding a block of data that may contain
|
||||
.Dv NUL Ns 's).
|
||||
.Dv NUL Ns 's ) .
|
||||
Both forms
|
||||
.Dv NUL
|
||||
terminate
|
||||
|
@ -98,7 +98,7 @@ The
|
||||
function locates the first occurrence of the null-terminated string
|
||||
.Fa pattern
|
||||
in the null-terminated string
|
||||
.Fa string.
|
||||
.Fa string .
|
||||
If
|
||||
.Fa pattern
|
||||
is the empty string,
|
||||
|
@ -150,7 +150,7 @@ function converts a multibyte character
|
||||
.Fa mbchar
|
||||
into a wide character and stores the result
|
||||
in the object pointed to by
|
||||
.Fa wcharp.
|
||||
.Fa wcharp .
|
||||
Up to
|
||||
.Fa nbytes
|
||||
bytes are examined.
|
||||
|
@ -159,7 +159,7 @@ is not
|
||||
.Dv NULL ,
|
||||
.Fa *result
|
||||
will be set to
|
||||
.Dv NULL.
|
||||
.Dv NULL .
|
||||
In all cases,
|
||||
.Fn sputrune
|
||||
will return the number of bytes which would be needed to store
|
||||
@ -266,7 +266,7 @@ These functions first appeared in
|
||||
The
|
||||
.Fn setrunelocale
|
||||
function and the other non-ANSI rune functions were inspired by
|
||||
.Nm Plan 9 from Bell Labs
|
||||
.Sy "Plan 9 from Bell Labs"
|
||||
as a much more sane alternative to the ANSI multibyte and
|
||||
wide character support.
|
||||
.\"They were conceived at the San Diego 1993 Summer USENIX conference by
|
||||
|
@ -49,7 +49,7 @@ The
|
||||
.Nm UTF2
|
||||
encoding is based on a proposed X-Open multibyte
|
||||
\s-1FSS-UCS-TF\s+1 (File System Safe Universal Character Set Transformation Format) encoding as used in
|
||||
.Nm Plan 9 from Bell Labs.
|
||||
.Sy "Plan 9 from Bell Labs" .
|
||||
Although it is capable of representing more than 16 bits,
|
||||
the current implementation is limited to 16 bits as defined by the
|
||||
Unicode Standard.
|
||||
|
@ -49,7 +49,7 @@ The
|
||||
.Nm UTF2
|
||||
encoding is based on a proposed X-Open multibyte
|
||||
\s-1FSS-UCS-TF\s+1 (File System Safe Universal Character Set Transformation Format) encoding as used in
|
||||
.Nm Plan 9 from Bell Labs.
|
||||
.Sy "Plan 9 from Bell Labs" .
|
||||
Although it is capable of representing more than 16 bits,
|
||||
the current implementation is limited to 16 bits as defined by the
|
||||
Unicode Standard.
|
||||
|
@ -57,11 +57,9 @@
|
||||
.Fn if_freenameindex "struct if_nameindex *ptr"
|
||||
.Sh DESCRIPTION
|
||||
The functions map interface index to readable interface name
|
||||
.Po
|
||||
such as
|
||||
.Li ``lo0''
|
||||
.Pc
|
||||
, and vice versa.
|
||||
(such as
|
||||
.Dq Li lo0 ) ,
|
||||
and vice versa.
|
||||
.Pp
|
||||
.Fn if_nametoindex
|
||||
converts readable interface name to interface index
|
||||
@ -76,13 +74,11 @@ argument must point to a buffer of at least
|
||||
.Dv IF_NAMESIZE
|
||||
bytes into which the interface name corresponding to the specified index is
|
||||
returned.
|
||||
.Po
|
||||
.Dv IF_NAMESIZE
|
||||
.Dv ( IF_NAMESIZE
|
||||
is also defined in
|
||||
.Li <net/if.h>
|
||||
.Aq Pa net/if.h
|
||||
and its value includes a terminating null byte at the end of the
|
||||
interface name.
|
||||
.Pc
|
||||
interface name.)
|
||||
This pointer is also the return value of the function.
|
||||
If there is no interface corresponding to the specified index,
|
||||
.Dv NULL
|
||||
@ -94,7 +90,7 @@ returns an array of
|
||||
structures.
|
||||
.Fa if_nametoindex
|
||||
is also defined in
|
||||
.Li <net/if.h> ,
|
||||
.Aq Pa net/if.h ,
|
||||
and is as follows:
|
||||
.Bd -literal -offset
|
||||
struct if_nameindex {
|
||||
|
@ -81,17 +81,13 @@ ancillary data, including the
|
||||
.Li cmsghdr
|
||||
structure at the beginning,
|
||||
and any padding at the end
|
||||
.Po
|
||||
to make its size a multiple of 8 bytes
|
||||
.Pc .
|
||||
(to make its size a multiple of 8 bytes).
|
||||
The argument is the size of the structure defining the option,
|
||||
which must include any pad bytes at the beginning
|
||||
.Po
|
||||
the value
|
||||
(the value
|
||||
.Li y
|
||||
in the alignment term
|
||||
.Dq Li xn + y
|
||||
.Pc ,
|
||||
.Dq Li "xn + y" ) ,
|
||||
the type byte, the length byte, and the option data.
|
||||
.Pp
|
||||
Note: If multiple options are stored in a single ancillary data
|
||||
@ -181,17 +177,16 @@ before calling this function.
|
||||
The option type must have a value from
|
||||
.Li 2
|
||||
to
|
||||
.Li 255 , inclusive.
|
||||
.Po
|
||||
.Li 0
|
||||
.Li 255 ,
|
||||
inclusive.
|
||||
.Li ( 0
|
||||
and
|
||||
.Li 1
|
||||
are reserved for the
|
||||
.Li Pad1
|
||||
and
|
||||
.Li PadN
|
||||
options, respectively.
|
||||
.Pc
|
||||
options, respectively.)
|
||||
.Pp
|
||||
The option data length must have a value between
|
||||
.Li 0
|
||||
@ -249,12 +244,10 @@ initialized by
|
||||
is the value of the option data length byte for this option.
|
||||
This value is required as an argument to allow the function to
|
||||
determine if padding must be appended at the end of the option.
|
||||
.Po
|
||||
The
|
||||
(The
|
||||
.Fn inet6_option_append
|
||||
function does not need a data length argument
|
||||
since the option data length must already be stored by the caller.
|
||||
.Pc
|
||||
since the option data length must already be stored by the caller.)
|
||||
.Pp
|
||||
.Fa multx
|
||||
is the value
|
||||
@ -289,10 +282,8 @@ and
|
||||
.Fa *tptrp
|
||||
points to
|
||||
the 8-bit option type field
|
||||
.Po
|
||||
which is followed by the 8-bit option
|
||||
data length, followed by the option data
|
||||
.Pc .
|
||||
(which is followed by the 8-bit option
|
||||
data length, followed by the option data).
|
||||
If no more options remain
|
||||
to be processed, the return value is
|
||||
.Li -1
|
||||
@ -407,7 +398,8 @@ on an error.
|
||||
.Pp
|
||||
.Fn inet6_option_alloc
|
||||
returns
|
||||
.Dv NULL on an error.
|
||||
.Dv NULL
|
||||
on an error.
|
||||
.Pp
|
||||
On errors,
|
||||
.Fn inet6_option_next
|
||||
|
@ -212,10 +212,8 @@ When implemented, this should behave as follows.
|
||||
.Pp
|
||||
This function takes a Routing header that was received as ancillary
|
||||
data
|
||||
.Po
|
||||
pointed to by the first argument,
|
||||
.Fa in
|
||||
.Pc
|
||||
(pointed to by the first argument,
|
||||
.Fa in )
|
||||
and writes a new Routing
|
||||
header that sends datagrams along the reverse of that route.
|
||||
Both
|
||||
@ -238,10 +236,8 @@ The return value of the function is -1 upon an error.
|
||||
.Ss inet6_rthdr_getaddr
|
||||
This function returns a pointer to the IPv6 address specified by
|
||||
.Fa index
|
||||
.Po
|
||||
which must have a value between 1 and the value returned by
|
||||
.Fn inet6_rthdr_segments
|
||||
.Pc
|
||||
(which must have a value between 1 and the value returned by
|
||||
.Fn inet6_rthdr_segments )
|
||||
in the Routing header described by
|
||||
.Fa cmsg .
|
||||
An
|
||||
@ -255,11 +251,9 @@ Upon an error the return value of the function is
|
||||
.Ss inet6_rthdr_getflags
|
||||
This function returns the flags value specified by
|
||||
.Fa index
|
||||
.Po
|
||||
which must
|
||||
(which must
|
||||
have a value between 0 and the value returned by
|
||||
.Fn inet6_rthdr_segments
|
||||
.Pc
|
||||
.Fn inet6_rthdr_segments )
|
||||
in the Routing header described by
|
||||
.Fa cmsg .
|
||||
For an IPv6 Type 0 Routing header the return value will be either
|
||||
|
@ -305,7 +305,8 @@ as the name is compressed.
|
||||
If
|
||||
.Em dnptr
|
||||
is
|
||||
.Dv NULL, names are not compressed.
|
||||
.Dv NULL ,
|
||||
names are not compressed.
|
||||
If
|
||||
.Fa lastdnptr
|
||||
is
|
||||
|
@ -86,7 +86,7 @@ as described below.
|
||||
and
|
||||
.Fn vprintf
|
||||
write output to
|
||||
.Em stdout,
|
||||
.Em stdout ,
|
||||
the standard output stream;
|
||||
.Fn fprintf
|
||||
and
|
||||
|
@ -42,9 +42,9 @@
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <stdio.h>
|
||||
.Fd FILE *stdin;
|
||||
.Fd FILE *stdout;
|
||||
.Fd FILE *stderr;
|
||||
.Vt FILE *stdin ;
|
||||
.Vt FILE *stdout ;
|
||||
.Vt FILE *stderr ;
|
||||
.Sh DESCRIPTION
|
||||
The standard
|
||||
.Tn I/O
|
||||
@ -179,9 +179,9 @@ without first removing their current definitions with
|
||||
.Dv FOPEN_MAX ,
|
||||
.Dv L_cuserid ,
|
||||
.Dv L_ctermid ,
|
||||
.Dv L_tmpnam,
|
||||
.Dv L_tmpnam ,
|
||||
.Dv NULL ,
|
||||
.Dv P_tmpdir,
|
||||
.Dv P_tmpdir ,
|
||||
.Dv SEEK_CUR ,
|
||||
.Dv SEEK_END ,
|
||||
.Dv SEEK_SET ,
|
||||
|
@ -89,7 +89,7 @@ If the variable
|
||||
.Ar name
|
||||
does not exist in the list,
|
||||
it is inserted with the given
|
||||
.Ar value.
|
||||
.Ar value .
|
||||
If the variable does exist, the argument
|
||||
.Ar overwrite
|
||||
is tested; if
|
||||
|
@ -40,7 +40,7 @@
|
||||
.Dt MALLOC 3
|
||||
.Os FreeBSD
|
||||
.Sh NAME
|
||||
.Nm malloc, calloc, realloc, free, reallocf
|
||||
.Nm malloc , calloc , realloc , free , reallocf
|
||||
.Nd general purpose memory allocation functions
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
@ -59,7 +59,7 @@
|
||||
.Ft char *
|
||||
.Va _malloc_options
|
||||
.Ft void
|
||||
.Va (*_malloc_message)(char *p1, char *p2, char *p3, char *p4)
|
||||
.Fn \*(lp*_malloc_message\*(rp "char *p1" "char *p2" "char *p3" "char *p4"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Fn malloc
|
||||
|
@ -40,7 +40,7 @@
|
||||
.Dt QSORT 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm qsort, heapsort, mergesort
|
||||
.Nm qsort , heapsort , mergesort
|
||||
.Nd sort functions
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
|
@ -40,7 +40,7 @@
|
||||
.Dt STRTOL 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm strtol, strtoq
|
||||
.Nm strtol , strtoq
|
||||
.Nd convert string value to a long or quad_t integer
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
|
@ -40,7 +40,7 @@
|
||||
.Dt STRTOUL 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm strtoul, strtouq
|
||||
.Nm strtoul , strtouq
|
||||
.Nd "convert a string to an unsigned long or uquad_t integer"
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
|
@ -31,7 +31,7 @@
|
||||
.Dt TSEARCH 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm tsearch, tfind, tdelete, twalk
|
||||
.Nm tsearch , tfind , tdelete , twalk
|
||||
.Nd manipulate binary search trees
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <search.h>
|
||||
|
@ -45,7 +45,7 @@
|
||||
.Nm memchr ,
|
||||
.Nm memcmp ,
|
||||
.Nm memcpy ,
|
||||
.Nm memmove,
|
||||
.Nm memmove ,
|
||||
.Nm memset
|
||||
.Nd byte string operations
|
||||
.Sh LIBRARY
|
||||
|
@ -74,7 +74,7 @@ appends not more than
|
||||
characters from
|
||||
.Fa append ,
|
||||
and then adds a terminating
|
||||
.Ql \e0.
|
||||
.Ql \e0 .
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
.Fn strcat
|
||||
|
@ -95,7 +95,7 @@ If
|
||||
.Fa errnum
|
||||
is not a recognized error number,
|
||||
the error message string will contain
|
||||
.Dq Li "Unknown error:\0
|
||||
.Dq Li "Unknown error:\ "
|
||||
followed by the error number in decimal.
|
||||
.Pp
|
||||
The message strings can be accessed directly using the external
|
||||
|
@ -44,14 +44,14 @@
|
||||
.Nm strrchr ,
|
||||
.Nm strcmp ,
|
||||
.Nm strncmp ,
|
||||
.Nm strcasecmp,
|
||||
.Nm strcasecmp ,
|
||||
.Nm strncasecmp ,
|
||||
.Nm strcpy ,
|
||||
.Nm strncpy ,
|
||||
.Nm strerror ,
|
||||
.Nm strlen ,
|
||||
.Nm strpbrk ,
|
||||
.Nm strsep,
|
||||
.Nm strsep ,
|
||||
.Nm strspn ,
|
||||
.Nm strcspn ,
|
||||
.Nm strstr ,
|
||||
|
@ -54,7 +54,7 @@
|
||||
.Dt STRTOK 3
|
||||
.Os FreeBSD
|
||||
.Sh NAME
|
||||
.Nm strtok, strtok_r
|
||||
.Nm strtok , strtok_r
|
||||
.Nd string tokens
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
@ -165,7 +165,9 @@ Since this implementation always alters the next starting point,
|
||||
such a sequence of calls would always return
|
||||
.Dv NULL .
|
||||
.Sh AUTHORS
|
||||
.An Wes Peters, Softweyr LLC: Aq wes@softweyr.com
|
||||
.An Wes Peters ,
|
||||
Softweyr LLC:
|
||||
.Aq wes@softweyr.com
|
||||
.Pp
|
||||
Based on the
|
||||
.Fx 3.0
|
||||
|
@ -35,7 +35,7 @@
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <aio.h>
|
||||
.Ft int
|
||||
.Fn aio_waitcomplete "struct aiocb **iocbp, struct timespec *timeout"
|
||||
.Fn aio_waitcomplete "struct aiocb **iocbp" "struct timespec *timeout"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Fn aio_waitcomplete
|
||||
|
@ -99,11 +99,11 @@ beyond the
|
||||
value returned from a call to
|
||||
.Xr getrlimit 2 ,
|
||||
e.g.\&
|
||||
.Dq etext + rlp\(->rlim_max.
|
||||
.Dq Va etext No + Va rlp\->rlim_max .
|
||||
(See
|
||||
.Xr end 3
|
||||
for the definition of
|
||||
.Em etext ) .
|
||||
.Va etext ) .
|
||||
.Sh RETURN VALUES
|
||||
.Fn Brk
|
||||
returns 0 if successful;
|
||||
|
@ -105,7 +105,7 @@ The argument
|
||||
is also a pointer to a null-terminated array of
|
||||
character pointers to null-terminated strings.
|
||||
A pointer to this array is normally stored in the global variable
|
||||
.Va environ.
|
||||
.Va environ .
|
||||
These strings pass information to the
|
||||
new process that is not directly an argument to the command (see
|
||||
.Xr environ 7 ) .
|
||||
|
@ -193,11 +193,11 @@ taken as a pointer to a
|
||||
(see above).
|
||||
.Dv F_SETLK
|
||||
is used to establish shared (or read) locks
|
||||
.Dv (F_RDLCK)
|
||||
.Pq Dv F_RDLCK
|
||||
or exclusive (or write) locks,
|
||||
.Dv (F_WRLCK) ,
|
||||
.Pq Dv F_WRLCK ,
|
||||
as well as remove either type of lock
|
||||
.Dv (F_UNLCK) .
|
||||
.Pq Dv F_UNLCK .
|
||||
If a shared or exclusive lock cannot be set,
|
||||
.Fn fcntl
|
||||
returns immediately with
|
||||
@ -392,11 +392,11 @@ The argument
|
||||
is
|
||||
.Dv F_SETLK ,
|
||||
the type of lock
|
||||
.Fa (l_type)
|
||||
.Pq Fa l_type
|
||||
is a shared lock
|
||||
.Dv (F_RDLCK)
|
||||
.Pq Dv F_RDLCK
|
||||
or exclusive lock
|
||||
.Dv (F_WRLCK) ,
|
||||
.Pq Dv F_WRLCK ,
|
||||
and the segment of a file to be locked is already
|
||||
exclusive-locked by another process;
|
||||
or the type is an exclusive lock and some portion of the
|
||||
@ -413,9 +413,9 @@ is
|
||||
or
|
||||
.Dv F_SETLKW ,
|
||||
the type of lock
|
||||
.Fa (l_type)
|
||||
.Pq Fa l_type
|
||||
is a shared lock
|
||||
.Dv (F_RDLCK) ,
|
||||
.Pq Dv F_RDLCK ,
|
||||
and
|
||||
.Fa fildes
|
||||
is not a valid file descriptor open for reading.
|
||||
@ -427,9 +427,9 @@ is
|
||||
or
|
||||
.Dv F_SETLKW ,
|
||||
the type of lock
|
||||
.Fa (l_type)
|
||||
.Pq Fa l_type
|
||||
is an exclusive lock
|
||||
.Dv (F_WRLCK) ,
|
||||
.Pq Dv F_WRLCK ,
|
||||
and
|
||||
.Fa fildes
|
||||
is not a valid file descriptor open for writing.
|
||||
|
@ -54,7 +54,7 @@
|
||||
.Fn fhstatfs "const fhandle_t *fhp" "struct statfs *buf"
|
||||
.Sh DESCRIPTION
|
||||
These functions provide a means to access a file given the file handle
|
||||
.Fa fhp.
|
||||
.Fa fhp .
|
||||
As this method bypasses directory access restrictions, these calls are
|
||||
restricted to the superuser.
|
||||
.Pp
|
||||
|
@ -137,7 +137,8 @@ Alternatively, the current position pointer may be set and retrieved by
|
||||
The current position pointer should only be set to a value returned by
|
||||
.Xr lseek 2 ,
|
||||
a value returned in the location pointed to by
|
||||
.Fa basep ( Ns Fn getdirentries
|
||||
.Fa basep
|
||||
.Pf ( Fn getdirentries
|
||||
only)
|
||||
or zero.
|
||||
.Sh IMPLEMENTATION NOTES
|
||||
|
@ -86,8 +86,8 @@ is normally used only when a new session is being created on behalf
|
||||
of the named user
|
||||
(for example, at login time, or when a remote shell is invoked).
|
||||
.Pp
|
||||
.Em NOTE:
|
||||
There is only one `login name' per `session .
|
||||
.Em NOTE :
|
||||
There is only one login name per session.
|
||||
.Pp
|
||||
It is
|
||||
.Em CRITICALLY
|
||||
@ -107,9 +107,9 @@ which is an ideal way of detaching from a controlling terminal and
|
||||
forking into the background.
|
||||
.Pp
|
||||
In particular, doing a
|
||||
.Fn ioctl ttyfd TIOCNOTTY ...
|
||||
.Fn ioctl ttyfd TIOCNOTTY ...\&
|
||||
or
|
||||
.Fn setpgrp ...
|
||||
.Fn setpgrp ...\&
|
||||
is
|
||||
.Em NOT
|
||||
sufficient.
|
||||
|
@ -191,7 +191,8 @@ are queued on socket and a
|
||||
.Xr close 2
|
||||
is performed.
|
||||
If the socket promises reliable delivery of data and
|
||||
.Dv SO_LINGER is set,
|
||||
.Dv SO_LINGER
|
||||
is set,
|
||||
the system will block the process on the
|
||||
.Xr close 2
|
||||
attempt until it is able to transmit the data or until it decides it
|
||||
|
@ -75,7 +75,7 @@ to any descendant of the current process.
|
||||
.It \&If Fa pid No \&is greater than zero :
|
||||
.Fa Sig
|
||||
is sent to the process whose ID is equal to
|
||||
.Fa pid.
|
||||
.Fa pid .
|
||||
.It \&If Fa pid No \&is zero :
|
||||
.Fa Sig
|
||||
is sent to all processes whose group ID is equal
|
||||
|
@ -60,7 +60,7 @@ The
|
||||
call applies only to sockets of type
|
||||
.Dv SOCK_STREAM
|
||||
or
|
||||
.Dv SOCK_SEQPACKET.
|
||||
.Dv SOCK_SEQPACKET .
|
||||
.Pp
|
||||
The
|
||||
.Fa backlog
|
||||
@ -76,15 +76,15 @@ the request may be ignored so that retries may succeed.
|
||||
The
|
||||
.Xr sysctl 3
|
||||
MIB variable
|
||||
.Dq Li kern.ipc.somaxconn
|
||||
.Dq Va kern.ipc.somaxconn
|
||||
specifies a hard limit on
|
||||
.Fa backlog ;
|
||||
if a value greater than
|
||||
.Li kern.ipc.somaxconn
|
||||
if a value greater than
|
||||
.Va kern.ipc.somaxconn
|
||||
or less than zero is specified,
|
||||
.Fa backlog
|
||||
is silently forced to
|
||||
.Li kern.ipc.somaxconn .
|
||||
.Va kern.ipc.somaxconn .
|
||||
.Sh IMPLEMENTATION NOTES
|
||||
.Pp
|
||||
In the non-threaded library
|
||||
|
@ -53,7 +53,7 @@ to the
|
||||
argument
|
||||
.Fa offset
|
||||
according to the directive
|
||||
.Fa whence.
|
||||
.Fa whence .
|
||||
The argument
|
||||
.Fa fildes
|
||||
must be an open
|
||||
|
@ -54,9 +54,7 @@ that the process expects to be traced by its parent. All the other
|
||||
arguments are ignored. (If the parent process does not expect to trace
|
||||
the child, it will probably be rather confused by the results; once the
|
||||
traced process stops, it cannot be made to continue except via
|
||||
.Eo \&
|
||||
.Fn ptrace
|
||||
.Ec \&.)
|
||||
.Fn ptrace . )
|
||||
When a process has used this request and calls
|
||||
.Xr execve 2
|
||||
or any of the routines built on it
|
||||
@ -69,7 +67,7 @@ Also, any setuid or setgid bits on the executable being executed will
|
||||
be ignored.
|
||||
.It Dv PT_READ_I , Dv PT_READ_D
|
||||
These requests read a single
|
||||
.Li int
|
||||
.Vt int
|
||||
of data from the traced process' address space. Traditionally,
|
||||
.Fn ptrace
|
||||
has allowed for machines with distinct address spaces for instruction
|
||||
@ -99,12 +97,12 @@ except that they write rather than read. The
|
||||
argument supplies the value to be written.
|
||||
.It Dv PT_READ_U
|
||||
This request reads an
|
||||
.Li int
|
||||
.Vt int
|
||||
from the traced process' user structure. The
|
||||
.Fa addr
|
||||
argument specifies the location of the int relative to the base of the
|
||||
user structure; it will usually be an integer value cast to
|
||||
.Li caddr_t
|
||||
.Vt caddr_t
|
||||
either explicitly or via the presence of a prototype for
|
||||
.Eo \&
|
||||
.Fn ptrace
|
||||
@ -115,14 +113,14 @@ and
|
||||
.Dv PT_READ_D ,
|
||||
.Fa addr
|
||||
must be aligned on an
|
||||
.Li int
|
||||
.Vt int
|
||||
boundary. The value read is returned as the return value from
|
||||
.Eo \&
|
||||
.Fn ptrace
|
||||
.Ec .
|
||||
.It Dv PT_WRITE_U
|
||||
This request writes an
|
||||
.Li int
|
||||
.Vt int
|
||||
into the traced process' user structure.
|
||||
.Fa addr
|
||||
specifies the offset, just as for
|
||||
@ -138,7 +136,9 @@ The traced process continues execution.
|
||||
.Fa addr
|
||||
is an address specifying the place where execution is to be resumed (a
|
||||
new value for the program counter), or
|
||||
.Li (caddr_t)1
|
||||
.Po
|
||||
.Vt caddr_t
|
||||
.Pc Ns 1
|
||||
to indicate that execution is to pick up where it left off.
|
||||
.Fa data
|
||||
provides a signal number to be delivered to the traced process as it
|
||||
@ -180,7 +180,9 @@ are:
|
||||
.Bl -tag -width 12n
|
||||
.It Dv PT_GETREGS
|
||||
This request reads the traced process' machine registers into the
|
||||
.Dq Li "struct reg"
|
||||
.Do
|
||||
.Vt "struct reg"
|
||||
.Dc
|
||||
(defined in
|
||||
.Aq Pa machine/reg.h )
|
||||
pointed to by
|
||||
@ -189,7 +191,9 @@ pointed to by
|
||||
This request is the converse of
|
||||
.Dv PT_GETREGS ;
|
||||
it loads the traced process' machine registers from the
|
||||
.Dq Li "struct reg"
|
||||
.Do
|
||||
.Vt "struct reg"
|
||||
.Dc
|
||||
(defined in
|
||||
.Aq Pa machine/reg.h )
|
||||
pointed to by
|
||||
@ -197,7 +201,9 @@ pointed to by
|
||||
.It Dv PT_GETFPREGS
|
||||
This request reads the traced process' floating-point registers into
|
||||
the
|
||||
.Dq Li "struct fpreg"
|
||||
.Do
|
||||
.Vt "struct fpreg"
|
||||
.Dc
|
||||
(defined in
|
||||
.Aq Pa machine/reg.h )
|
||||
pointed to by
|
||||
@ -206,7 +212,9 @@ pointed to by
|
||||
This request is the converse of
|
||||
.Dv PT_GETFPREGS ;
|
||||
it loads the traced process' floating-point registers from the
|
||||
.Dq Li "struct fpreg"
|
||||
.Do
|
||||
.Vt "struct fpreg"
|
||||
.Dc
|
||||
(defined in
|
||||
.Aq Pa machine/reg.h )
|
||||
pointed to by
|
||||
@ -214,7 +222,9 @@ pointed to by
|
||||
.It Dv PT_GETDBREGS
|
||||
This request reads the traced process' debug registers into
|
||||
the
|
||||
.Dq Li "struct dbreg"
|
||||
.Do
|
||||
.Vt "struct dbreg"
|
||||
.Dc
|
||||
(defined in
|
||||
.Aq Pa machine/reg.h )
|
||||
pointed to by
|
||||
@ -223,7 +233,9 @@ pointed to by
|
||||
This request is the converse of
|
||||
.Dv PT_GETDBREGS ;
|
||||
it loads the traced process' debug registers from the
|
||||
.Dq Li "struct dbreg"
|
||||
.Do
|
||||
.Vt "struct dbreg"
|
||||
.Dc
|
||||
(defined in
|
||||
.Aq Pa machine/reg.h )
|
||||
pointed to by
|
||||
@ -265,7 +277,7 @@ to
|
||||
or
|
||||
.Dv PT_WRITE_U
|
||||
was not
|
||||
.Li int Ns \&-aligned.
|
||||
.Vt int Ns \-aligned .
|
||||
.It
|
||||
The signal number (in
|
||||
.Fa data )
|
||||
|
@ -210,7 +210,7 @@ Process credentials can also be passed as ancillary data for
|
||||
domain sockets using a
|
||||
.Fa cmsg_type
|
||||
of
|
||||
.Dv SCM_CREDS.
|
||||
.Dv SCM_CREDS .
|
||||
In this case,
|
||||
.Fa cmsg_data
|
||||
should be a structure of type
|
||||
|
@ -84,13 +84,13 @@ parameter:
|
||||
Read access for user.
|
||||
.It Dv SEM_A
|
||||
Alter access for user.
|
||||
.It Dv (SEM_R>>3)
|
||||
.It Dv ( SEM_R>>3 )
|
||||
Read access for group.
|
||||
.It Dv (SEM_A>>3)
|
||||
.It Dv ( SEM_A>>3 )
|
||||
Alter access for group.
|
||||
.It Dv (SEM_R>>6)
|
||||
.It Dv ( SEM_R>>6 )
|
||||
Read access for other.
|
||||
.It Dv (SEM_A>>6)
|
||||
.It Dv ( SEM_A>>6 )
|
||||
Alter access for other.
|
||||
.El
|
||||
.Pp
|
||||
|
@ -82,13 +82,13 @@ parameter:
|
||||
Read access for user.
|
||||
.It Dv SHM_W
|
||||
Write access for user.
|
||||
.It Dv (SHM_R>>3)
|
||||
.It Dv ( SHM_R>>3 )
|
||||
Read access for group.
|
||||
.It Dv (SHM_W>>3)
|
||||
.It Dv ( SHM_W>>3 )
|
||||
Write access for group.
|
||||
.It Dv (SHM_R>>6)
|
||||
.It Dv ( SHM_R>>6 )
|
||||
Read access for other.
|
||||
.It Dv (SHM_W>>6)
|
||||
.It Dv ( SHM_W>>6 )
|
||||
Write access for other.
|
||||
.El
|
||||
.\"
|
||||
|
@ -168,7 +168,7 @@ and
|
||||
calls.
|
||||
(Some protocol families, such as the Internet family,
|
||||
support the notion of an
|
||||
.Dq implied connect,
|
||||
.Dq implied connect ,
|
||||
which permits data to be sent piggybacked onto a connect operation by
|
||||
using the
|
||||
.Xr sendto 2
|
||||
|
@ -48,7 +48,8 @@ variable specified by
|
||||
and unblocks the mutex specified by
|
||||
.Fa mutex .
|
||||
The waiting thread unblocks only after another thread calls
|
||||
.Xr pthread_cond_signal 3 , or
|
||||
.Xr pthread_cond_signal 3 ,
|
||||
or
|
||||
.Xr pthread_cond_broadcast 3
|
||||
with the same condition variable, and the current thread requires the lock
|
||||
on
|
||||
|
@ -195,5 +195,5 @@ conforms to ISO/IEC 9945-1 ANSI/IEEE
|
||||
Std 1003.1 Second Edition 1996-07-12.
|
||||
.Sh AUTHORS
|
||||
This man page was written by
|
||||
.An David Leonard <d@openbsd.org>
|
||||
.An David Leonard Aq d@openbsd.org
|
||||
for the OpenBSD implementation of pthread_cancel.
|
||||
|
@ -37,7 +37,7 @@
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm lsearch ,
|
||||
.Nm lfind,
|
||||
.Nm lfind
|
||||
.Nd linear searching routines
|
||||
.Sh LIBRARY
|
||||
.Lb libcompat
|
||||
|
@ -91,7 +91,7 @@ and
|
||||
.Fn re_exec
|
||||
may have trailing or embedded newline characters;
|
||||
they are terminated by
|
||||
.Dv NUL Ns s.
|
||||
.Dv NUL Ns s .
|
||||
The regular expressions recognized are described in the manual entry for
|
||||
.Xr ed 1 ,
|
||||
given the above difference.
|
||||
|
@ -74,7 +74,7 @@ specifies which well-known
|
||||
.Tn DARPA
|
||||
Internet port to use for
|
||||
the connection; the call
|
||||
.Ql getservbyname(\\*qexec\\*q, \\*qtcp\\*q)
|
||||
.Fn getservbyname \*qexec\*q \*qtcp\*q
|
||||
(see
|
||||
.Xr getservent 3 )
|
||||
will return a pointer to a structure, which contains the
|
||||
|
@ -518,7 +518,7 @@ The
|
||||
statistics system first appeared in
|
||||
.Fx 3.0 .
|
||||
.Sh AUTHORS
|
||||
.An Kenneth Merry Aq ken@FreeBSD.ORG
|
||||
.An Kenneth Merry Aq ken@FreeBSD.org
|
||||
.Sh BUGS
|
||||
There should probably be an interface to de-allocate memory allocated by
|
||||
.Fn getdevs ,
|
||||
|
@ -66,7 +66,7 @@
|
||||
.Fd #include <sys/types.h>
|
||||
.Fd #include <libdisk.h>
|
||||
.Pp
|
||||
.Dv extern const char *chunk_n[];
|
||||
.Vt extern const char *chunk_n[] ;
|
||||
.Ft const char *
|
||||
.Fn slice_type_name "int type" "int subtype"
|
||||
.Ft struct disk *
|
||||
|
@ -198,7 +198,7 @@ Refer to
|
||||
.Xr editrc 5
|
||||
for more information.
|
||||
.Pp
|
||||
.Em NOTE:
|
||||
.Em NOTE :
|
||||
.Va argv[0]
|
||||
may be modified by
|
||||
.Fn el_parse .
|
||||
@ -348,7 +348,7 @@ Expecting further command input as arguments, do nothing visually.
|
||||
Refresh display.
|
||||
.It Dv CC_CURSOR
|
||||
Cursor moved, so update and perform
|
||||
.Dv CC_REFRESH.
|
||||
.Dv CC_REFRESH .
|
||||
.It Dv CC_REDISPLAY
|
||||
Redisplay entire input line.
|
||||
This is useful if a key binding outputs extra information.
|
||||
@ -420,8 +420,7 @@ Delete
|
||||
characters before the cursor.
|
||||
.It Fn el_data_set
|
||||
Set the user data to
|
||||
.Fa data
|
||||
.
|
||||
.Fa data .
|
||||
.It Fn el_data_get
|
||||
Get the user data.
|
||||
.El
|
||||
|
@ -49,31 +49,31 @@
|
||||
.Ft FILE *
|
||||
.Fn ftpLogin "char *host" "char *user" "char *passwd" "int ftp_port" "int verbose" "int *retcode"
|
||||
.Ft int
|
||||
.Fn ftpChdir "FILE *stream, char *dirname"
|
||||
.Fn ftpChdir "FILE *stream" "char *dirname"
|
||||
.Ft int
|
||||
.Fn ftpErrno "FILE *stream"
|
||||
.Ft const char *
|
||||
.Fn ftpErrString "int errno"
|
||||
.Ft time_t
|
||||
.Fn ftpGetModtime "FILE *stream, char *file"
|
||||
.Fn ftpGetModtime "FILE *stream" "char *file"
|
||||
.Ft off_t
|
||||
.Fn ftpGetSize "FILE *stream, char *file"
|
||||
.Fn ftpGetSize "FILE *stream" "char *file"
|
||||
.Ft FILE *
|
||||
.Fn ftpGet "FILE *stream, char *file, off_t *seekto"
|
||||
.Fn ftpGet "FILE *stream" "char *file" "off_t *seekto"
|
||||
.Ft FILE *
|
||||
.Fn ftpPut "FILE *stream, char *file"
|
||||
.Fn ftpPut "FILE *stream" "char *file"
|
||||
.Ft int
|
||||
.Fn ftpAscii "FILE *stream"
|
||||
.Ft int
|
||||
.Fn ftpBinary "FILE *stream"
|
||||
.Ft int
|
||||
.Fn ftpPassive "FILE *stream, int status"
|
||||
.Fn ftpPassive "FILE *stream" "int status"
|
||||
.Ft void
|
||||
.Fn ftpVerbose "FILE *stream, int status"
|
||||
.Fn ftpVerbose "FILE *stream" "int status"
|
||||
.Ft FILE *
|
||||
.Fn ftpGetURL "char *url, char *user, char *passwd, int *retcode"
|
||||
.Fn ftpGetURL "char *url" "char *user" "char *passwd" "int *retcode"
|
||||
.Ft FILE *
|
||||
.Fn ftpPutURL "char *url, char *user, char *passwd, int *retcode"
|
||||
.Fn ftpPutURL "char *url" "char *user" "char *passwd" "int *retcode"
|
||||
.Ft int
|
||||
.Fn ftpLoginAf "char *host" "int af" "char *user" "char *passwd" "int ftp_port" "int verbose" "int *retcode"
|
||||
.Ft FILE *
|
||||
@ -86,7 +86,7 @@ These functions implement a high-level library for managing FTP connections.
|
||||
.Fn ftpLogin
|
||||
attempts to log in using the supplied
|
||||
.Fa user ,
|
||||
.Fa passwd,
|
||||
.Fa passwd ,
|
||||
.Fa ftp_port
|
||||
(if passed as 0,
|
||||
.Fa ftp_port
|
||||
@ -101,7 +101,7 @@ will have the error code returned by the foreign server.
|
||||
.Pp
|
||||
.Fn ftpChdir
|
||||
attempts to issue a server CD command to the directory named in
|
||||
.Fa dir.
|
||||
.Fa dir .
|
||||
On success, zero is returned. On failure, the error code from the server.
|
||||
.Pp
|
||||
.Fn ftpErrno
|
||||
|
@ -44,8 +44,9 @@
|
||||
.Sh DESCRIPTION
|
||||
.Pa netinet6/ipsec.h
|
||||
declares
|
||||
.Pp
|
||||
.Dl extern int ipsec_errcode;
|
||||
.Bd -ragged -offset indent
|
||||
.Vt extern int ipsec_errcode ;
|
||||
.Ed
|
||||
.Pp
|
||||
which is used to pass error code from IPsec policy manipulation library
|
||||
to user program.
|
||||
|
@ -56,7 +56,7 @@
|
||||
.Sh DESCRIPTION
|
||||
.Fn kvm_getfiles
|
||||
returns a (sub-)set of the open files in the kernel indicated by
|
||||
.Fa kd.
|
||||
.Fa kd .
|
||||
The
|
||||
.Fa op
|
||||
and
|
||||
|
@ -60,7 +60,7 @@
|
||||
.Sh DESCRIPTION
|
||||
.Fn kvm_getprocs
|
||||
returns a (sub-)set of active processes in the kernel indicated by
|
||||
.Fa kd.
|
||||
.Fa kd .
|
||||
The
|
||||
.Fa op
|
||||
and
|
||||
|
@ -21,14 +21,25 @@
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Fn kvm_getswapinfo
|
||||
function fills an array of kvm_swap structures with swap summary
|
||||
information for each swap device, for up to maxswap - 1 devices.
|
||||
The number of devices, up to maxswap - 1, is returned. A grand
|
||||
total of all swap devices ( including any devices that go beyond
|
||||
maxswap - 1 ) is returned in one additional array entry. This
|
||||
entry is not counted in the return value. Thus, if you specify
|
||||
a maxswap value of 1, the function will typically return the
|
||||
value 0 and the single kvm_swap structure will be filled with
|
||||
function fills an array of
|
||||
.Vt kvm_swap
|
||||
structures with swap summary
|
||||
information for each swap device, for up to
|
||||
.Fa maxswap
|
||||
\- 1 devices.
|
||||
The number of devices, up to
|
||||
.Fa maxswap
|
||||
\- 1, is returned. A grand
|
||||
total of all swap devices (including any devices that go beyond
|
||||
.Fa maxswap
|
||||
\- 1) is returned in one additional array entry. This
|
||||
entry is not counted in the return value.
|
||||
Thus, if you specify a
|
||||
.Fa maxswap
|
||||
value of 1, the function will typically return the
|
||||
value 0 and the single
|
||||
.Vt kvm_swap
|
||||
structure will be filled with
|
||||
the grand total over all swap devices. The grand total is calculated
|
||||
from all available swap devices whether or not you made room
|
||||
for them all in the array.
|
||||
@ -38,21 +49,36 @@ The flags argument is currently unused and must be passed as 0.
|
||||
.Pp
|
||||
If an error occurs, -1 is returned.
|
||||
.Pp
|
||||
Each swap partition and the grand total is summarized in the kvm_swap
|
||||
Each swap partition and the grand total is summarized in the
|
||||
.Vt kvm_swap
|
||||
structure. This structure contains the following fields:
|
||||
.Bl -inset -width indent
|
||||
.It char ksw_devname[];
|
||||
.It int ksw_total;
|
||||
.It int ksw_used;
|
||||
.It int ksw_flags;
|
||||
.Pp
|
||||
.Bl -item -offset indent -compact
|
||||
.It
|
||||
.Va char ksw_devname[] ;
|
||||
.It
|
||||
.Va int ksw_total ;
|
||||
.It
|
||||
.Va int ksw_used ;
|
||||
.It
|
||||
.Va int ksw_flags ;
|
||||
.El
|
||||
.Pp
|
||||
Values are in PAGE_SIZE'd chunks ( see getpagesize() ). ksw_flags contains
|
||||
Values are in
|
||||
.Dv PAGE_SIZE Ns 'd
|
||||
chunks (see
|
||||
.Xr getpagesize 3 ) .
|
||||
.Va ksw_flags
|
||||
contains
|
||||
a copy of the swap device flags.
|
||||
.Pp
|
||||
.Sh CACHING
|
||||
This function caches the nlist values for various kernel variables which
|
||||
it reuses in successive calls. You may call the function with kd == NULL
|
||||
it reuses in successive calls.
|
||||
You may call the function with
|
||||
.Fa kd
|
||||
==
|
||||
.Dv NULL
|
||||
to clear the cache.
|
||||
.Sh DIAGNOSTICS
|
||||
If the load average was unobtainable, \-1 is returned; otherwise,
|
||||
|
@ -57,7 +57,7 @@ The
|
||||
.Fn asin
|
||||
function returns the arc sine in the range
|
||||
.Bk -words
|
||||
.Bq -\*(Pi/2, +\*(Pi/2
|
||||
.Bq -\*(Pi/2 , +\*(Pi/2
|
||||
.Ek
|
||||
radians.
|
||||
On the
|
||||
|
@ -220,7 +220,8 @@ and
|
||||
.Em NaN
|
||||
(the reserved
|
||||
operand on a
|
||||
.Tn VAX ) . Previous implementations of pow may
|
||||
.Tn VAX ) .
|
||||
Previous implementations of pow may
|
||||
have defined x**0 to be undefined in some or all of these
|
||||
cases. Here are reasons for returning x**0 = 1 always:
|
||||
.Bl -enum -width indent
|
||||
|
@ -45,7 +45,7 @@
|
||||
.Fd #include <math.h>
|
||||
.Ft double
|
||||
.Fn hypot "double x" "double y"
|
||||
.Fd struct {double x, y;} z;
|
||||
.Vt struct {double x, y;} z ;
|
||||
.Ft double
|
||||
.Fn cabs z
|
||||
.Sh DESCRIPTION
|
||||
|
@ -68,7 +68,7 @@ function
|
||||
returns
|
||||
.Fa x
|
||||
with its sign changed to
|
||||
.Fa y Ns 's.
|
||||
.Fa y Ns 's .
|
||||
.Pp
|
||||
The
|
||||
.Fn drem
|
||||
@ -102,7 +102,7 @@ the remainder is computed exactly and
|
||||
.Sm on
|
||||
\*(Le
|
||||
.Sm off
|
||||
.Pf \\*(Ba Fa y No \\*(Ba/2.
|
||||
.Pf \\*(Ba Fa y No \\*(Ba/2 .
|
||||
.Sm on
|
||||
But
|
||||
.Fn drem x 0
|
||||
@ -218,7 +218,7 @@ return \-1.7e38?
|
||||
.Pp
|
||||
.Tn IEEE
|
||||
754 currently specifies that
|
||||
.Fn logb "denormalized no."
|
||||
.Fn logb "denormalized no.\&"
|
||||
=
|
||||
.Fn logb "tiniest normalized no. > 0"
|
||||
but the consensus has changed to the specification in the new
|
||||
|
@ -98,7 +98,7 @@ return appropriate values unless an argument is out of range.
|
||||
Overflow will occur for sufficiently large positive values, and
|
||||
non-positive integers.
|
||||
On the
|
||||
.Tn VAX,
|
||||
.Tn VAX ,
|
||||
the reserved operator is returned,
|
||||
and
|
||||
.Va errno
|
||||
|
@ -48,7 +48,8 @@ variable specified by
|
||||
and unblocks the mutex specified by
|
||||
.Fa mutex .
|
||||
The waiting thread unblocks only after another thread calls
|
||||
.Xr pthread_cond_signal 3 , or
|
||||
.Xr pthread_cond_signal 3 ,
|
||||
or
|
||||
.Xr pthread_cond_broadcast 3
|
||||
with the same condition variable, and the current thread requires the lock
|
||||
on
|
||||
|
@ -195,5 +195,5 @@ conforms to ISO/IEC 9945-1 ANSI/IEEE
|
||||
Std 1003.1 Second Edition 1996-07-12.
|
||||
.Sh AUTHORS
|
||||
This man page was written by
|
||||
.An David Leonard <d@openbsd.org>
|
||||
.An David Leonard Aq d@openbsd.org
|
||||
for the OpenBSD implementation of pthread_cancel.
|
||||
|
@ -46,16 +46,25 @@ and
|
||||
.Xr bstring 3 .
|
||||
.Sh MEMORY ALLOCATION
|
||||
.Bl -hang -width 10n
|
||||
.It Fn "void *malloc" "size_t size"
|
||||
.It Xo
|
||||
.Ft "void *"
|
||||
.Fn malloc "size_t size"
|
||||
.Xc
|
||||
.Pp
|
||||
Allocate
|
||||
.Fa size
|
||||
bytes of memory from the heap using a best-fit algorithm.
|
||||
.It Fn "void free" "void *ptr"
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn free "void *ptr"
|
||||
.Xc
|
||||
.Pp
|
||||
Free the allocated object at
|
||||
.Fa ptr .
|
||||
.It Fn "void setheap" "void *start" "void *limit"
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn setheap "void *start" "void *limit"
|
||||
.Xc
|
||||
.Pp
|
||||
Initialise the heap. This function must be called before calling
|
||||
.Fn alloc
|
||||
@ -65,7 +74,10 @@ and
|
||||
.Fa limit
|
||||
will be used for the heap; attempting to allocate beyond this will result
|
||||
in a panic.
|
||||
.It Fn "char *sbrk" "int junk"
|
||||
.It Xo
|
||||
.Ft "char *"
|
||||
.Fn sbrk "int junk"
|
||||
.Xc
|
||||
.Pp
|
||||
Provides the behaviour of
|
||||
.Fn sbrk 0 ,
|
||||
@ -79,17 +91,35 @@ A set of functions are provided for manipulating a flat variable space similar
|
||||
to the traditional shell-supported evironment. Major enhancements are support
|
||||
for set/unset hook functions.
|
||||
.Bl -hang -width 10n
|
||||
.It Fn "char *getenv" "const char *name"
|
||||
.It Fn "int setenv" "const char *name" "char *value" "int overwrite"
|
||||
.It Fn "int putenv" "const char *string"
|
||||
.It Fn "int unsetenv" "const char *name"
|
||||
.It Xo
|
||||
.Ft "char *"
|
||||
.Fn getenv "const char *name"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn setenv "const char *name" "char *value" "int overwrite"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn putenv "const char *string"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn unsetenv "const char *name"
|
||||
.Xc
|
||||
.Pp
|
||||
These functions behave similarly to their standard library counterparts.
|
||||
.It Fn "struct env_var *env_getenv" "const char *name"
|
||||
.It Xo
|
||||
.Ft "struct env_var *"
|
||||
.Fn env_getenv "const char *name"
|
||||
.Xc
|
||||
.Pp
|
||||
Looks up a variable in the environment and returns its entire
|
||||
data structure.
|
||||
.It Fn "int env_setenv" "const char *name" "int flags" "char *value" "ev_sethook_t sethook" "ev_unsethook_t unsethook"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn env_setenv "const char *name" "int flags" "char *value" "ev_sethook_t sethook" "ev_unsethook_t unsethook"
|
||||
.Xc
|
||||
.Pp
|
||||
Creates a new or sets an existing environment variable called
|
||||
.Fa name .
|
||||
@ -117,20 +147,41 @@ may be used to prevent a variable being unset.
|
||||
.El
|
||||
.Sh STANDARD LIBRARY SUPPORT
|
||||
.Bl -hang -width 10n
|
||||
.It Fn "int getopt" "int argc" "char * const *argv" "cont char *optstring"
|
||||
.It Fn "long strtol" "const char *nptr" "char **endptr" "int base"
|
||||
.It Fn "void srandom" "unsigned long seed"
|
||||
.It Fn "unsigned long random" "void"
|
||||
.It Fn "char *strerror" "int error"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn getopt "int argc" "char * const *argv" "cont char *optstring"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft long
|
||||
.Fn strtol "const char *nptr" "char **endptr" "int base"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn srandom "unsigned long seed"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft "unsigned long"
|
||||
.Fn random void
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft "char *"
|
||||
.Fn strerror "int error"
|
||||
.Xc
|
||||
.Pp
|
||||
Returns error messages for the subset of errno values supported by
|
||||
.Nm No .
|
||||
.It Fn "assert" "expression"
|
||||
.It Fn assert expression
|
||||
.Pp
|
||||
Requires
|
||||
.Fd #include <assert.h>
|
||||
.It Fn "int setjmp" "jmp_buf env"
|
||||
.It Fn "void longjmp" "jmp_buf env" "int val"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn setjmp "jmp_buf env"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn longjmp "jmp_buf env" "int val"
|
||||
.Xc
|
||||
.Pp
|
||||
Defined as
|
||||
.Fn _setjmp
|
||||
@ -141,12 +192,18 @@ respectively as there is no signal state to manipulate. Requires
|
||||
.El
|
||||
.Sh CHARACTER I/O
|
||||
.Bl -hang -width 10n
|
||||
.It Fn "void gets" "char *buf"
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn gets "char *buf"
|
||||
.Xc
|
||||
.Pp
|
||||
Read characters from the console into
|
||||
.Fa buf .
|
||||
All of the standard cautions apply to this function.
|
||||
.It Fn "void ngets" "char *buf" "size_t size"
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn ngets "char *buf" "size_t size"
|
||||
.Xc
|
||||
.Pp
|
||||
Read at most
|
||||
.Fa size
|
||||
@ -156,7 +213,10 @@ If
|
||||
.Fa size
|
||||
is less than 1, the function's behaviour is as for
|
||||
.Fn gets .
|
||||
.It Fn "int fgetstr" "char *buf" "int size" "int fd"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn fgetstr "char *buf" "int size" "int fd"
|
||||
.Xc
|
||||
.Pp
|
||||
Read a line of at most
|
||||
.Fa size
|
||||
@ -166,10 +226,22 @@ Line terminating characters are stripped, and the buffer is always nul
|
||||
terminated. Returns the number of characters in
|
||||
.Fa buf
|
||||
if successful, or -1 if a read error occurs.
|
||||
.It Fn "int printf" "const char *fmt" "..."
|
||||
.It Fn "void vprintf" "const char *fmt" "va_list ap"
|
||||
.It Fn "int sprintf" "char *buf" "const char *fmt" "..."
|
||||
.It Fn "void vsprintf" "char *buf" "const char *fmt" "va_list ap"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn printf "const char *fmt" "..."
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn vprintf "const char *fmt" "va_list ap"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn sprintf "char *buf" "const char *fmt" "..."
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn vsprintf "char *buf" "const char *fmt" "va_list ap"
|
||||
.Xc
|
||||
.Pp
|
||||
The *printf functions implement a subset of the standard
|
||||
.Fn printf
|
||||
@ -233,19 +305,49 @@ ptr,
|
||||
.El
|
||||
.Sh CHARACTER TESTS AND CONVERSIONS
|
||||
.Bl -hang -width 10n
|
||||
.It Fn "int isupper" "int c"
|
||||
.It Fn "int islower" "int c"
|
||||
.It Fn "int isspace" "int c"
|
||||
.It Fn "int isdigit" "int c"
|
||||
.It Fn "int isxdigit" "int c"
|
||||
.It Fn "int isascii" "int c"
|
||||
.It Fn "int isalpha" "int c"
|
||||
.It Fn "int toupper" "int c"
|
||||
.It Fn "int tolower" "int c"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn isupper "int c"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn islower "int c"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn isspace "int c"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn isdigit "int c"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn isxdigit "int c"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn isascii "int c"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn isalpha "int c"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn toupper "int c"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn tolower "int c"
|
||||
.Xc
|
||||
.El
|
||||
.Sh FILE I/O
|
||||
.Bl -hang -width 10n
|
||||
.It Fn "int open" "const char *path" "int flags"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn open "const char *path" "int flags"
|
||||
.Xc
|
||||
.Pp
|
||||
Similar to the behaviour as specified in
|
||||
.Xr open 2 ,
|
||||
@ -254,20 +356,41 @@ required. The
|
||||
.Fa flags
|
||||
argument may be one of O_RDONLY, O_WRONLY and O_RDWR (although no filesystems
|
||||
currently support writing).
|
||||
.It Fn "int close" "int fd"
|
||||
.It Fn "void closeall" "void"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn close "int fd"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn closeall void
|
||||
.Xc
|
||||
.Pp
|
||||
Close all open files.
|
||||
.It Fn "ssize_t read" "int fd" "void *buf" "size_t len"
|
||||
.It Fn "ssize_t write" "int fd" "void *buf" "size_t len"
|
||||
.It Xo
|
||||
.Ft ssize_t
|
||||
.Fn read "int fd" "void *buf" "size_t len"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft ssize_t
|
||||
.Fn write "int fd" "void *buf" "size_t len"
|
||||
.Xc
|
||||
.Pp
|
||||
(No filesystems currently support writing.)
|
||||
.It Fn "off_t lseek" "int fd" "off_t offset" "int whence"
|
||||
.It Xo
|
||||
.Ft off_t
|
||||
.Fn lseek "int fd" "off_t offset" "int whence"
|
||||
.Xc
|
||||
.Pp
|
||||
Files being automatically uncompressed during reading cannot seek backwards
|
||||
from the current point.
|
||||
.It Fn "int stat" "const char *path" "struct stat *sb"
|
||||
.It Fn "int fstat" "int fd" "struct stat *sb"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn stat "const char *path" "struct stat *sb"
|
||||
.Xc
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn fstat "int fd" "struct stat *sb"
|
||||
.Xc
|
||||
.Pp
|
||||
The
|
||||
.Fn stat
|
||||
@ -285,15 +408,24 @@ filesystem always reports files having uid/gid of zero.
|
||||
.Nm
|
||||
supplies a simple internal pager to ease reading the output of large commands.
|
||||
.Bl -hang -width 10n
|
||||
.It Fn "void pager_open"
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn pager_open
|
||||
.Xc
|
||||
.Pp
|
||||
Initialises the pager and tells it that the next line output will be the top of the
|
||||
display. The environment variable LINES is consulted to determine the number of
|
||||
lines to be displayed before pausing.
|
||||
.It Fn "void pager_close" "void"
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn pager_close void
|
||||
.Xc
|
||||
.Pp
|
||||
Closes the pager.
|
||||
.It Fn "void pager_output" "char *lines"
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn pager_output "char *lines"
|
||||
.Xc
|
||||
.Pp
|
||||
Sends the lines in the nul-terminated buffer at
|
||||
.Fa lines
|
||||
@ -302,7 +434,10 @@ of lines being output (wrapped lines are not accounted for).
|
||||
.Fn pager_output
|
||||
will return zero when all of the lines have been output, or nonzero if the
|
||||
display was paused and the user elected to quit.
|
||||
.It Fn "int pager_file" "char *fname"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn pager_file "char *fname"
|
||||
.Xc
|
||||
.Pp
|
||||
Attempts to open and display the file
|
||||
.Fa fname .
|
||||
@ -310,7 +445,10 @@ Returns -1 on error, 0 at EOF, or 1 if the user elects to quit while reading.
|
||||
.El
|
||||
.Sh MISC
|
||||
.Bl -hang -width 10n
|
||||
.It Fn "void twiddle" "void"
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn twiddle void
|
||||
.Xc
|
||||
.Pp
|
||||
Successive calls emit the characters in the sequence |,/,-,\\ followed by a
|
||||
backspace in order to provide reassurance to the user.
|
||||
@ -356,16 +494,25 @@ returns.
|
||||
.Pp
|
||||
The consumer must provide the following support functions:
|
||||
.Bl -hang -width 10n
|
||||
.It Fn "int getchar" "void"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn getchar void
|
||||
.Xc
|
||||
.Pp
|
||||
Return a character from the console, used by
|
||||
.Fn gets ,
|
||||
.Fn ngets
|
||||
and pager functions.
|
||||
.It Fn "int ischar" "void"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn ischar void
|
||||
.Xc
|
||||
.Pp
|
||||
Returns nonzero if a character is waiting from the console.
|
||||
.It Fn "void putchar" "int"
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn putchar int
|
||||
.Xc
|
||||
.Pp
|
||||
Write a character to the console, used by
|
||||
.Fn gets ,
|
||||
@ -375,7 +522,10 @@ Write a character to the console, used by
|
||||
and
|
||||
.Fn twiddle
|
||||
and thus by many other functions for debugging and informational output.
|
||||
.It Fn "int devopen" "struct open_file *of" "const char *name" "char **file"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn devopen "struct open_file *of" "const char *name" "char **file"
|
||||
.Xc
|
||||
.Pp
|
||||
Open the appropriate device for the file named in
|
||||
.Fa name ,
|
||||
@ -388,18 +538,24 @@ which does not refer to the device. The
|
||||
field in
|
||||
.Fa of
|
||||
will be set to point to the
|
||||
.Dv devsw
|
||||
.Vt devsw
|
||||
structure for the opened device if successful. Device identifiers must
|
||||
always precede the path component, but may otherwise be arbitrarily formatted.
|
||||
Used by
|
||||
.Fn open
|
||||
and thus for all device-related I/O.
|
||||
.It Fn "int devclose" "struct open_file *of"
|
||||
.It Xo
|
||||
.Ft int
|
||||
.Fn devclose "struct open_file *of"
|
||||
.Xc
|
||||
Close the device allocated for
|
||||
.Fa of .
|
||||
The device driver itself will already have been called for the close; this call
|
||||
should clean up any allocation made by devopen only.
|
||||
.It Fn "void panic" "const char *msg" "..."
|
||||
.It Xo
|
||||
.Ft void
|
||||
.Fn panic "const char *msg" "..."
|
||||
.Xc
|
||||
.Pp
|
||||
Signal a fatal and unrecoverable error condition. The
|
||||
.Fa msg ...
|
||||
@ -408,9 +564,10 @@ arguments are as for
|
||||
.El
|
||||
.Sh INTERNAL FILESYSTEMS
|
||||
Internal filesystems are enabled by the consumer exporting the array
|
||||
.Dv struct fs_ops *file_system[], which should be initialised with pointers
|
||||
.Vt struct fs_ops *file_system[] ,
|
||||
which should be initialised with pointers
|
||||
to
|
||||
.Dv struct fs_ops
|
||||
.Vt struct fs_ops
|
||||
structures. The following filesystem handlers are supplied by
|
||||
.Nm No ,
|
||||
the consumer may supply other filesystems of their own:
|
||||
@ -433,7 +590,7 @@ appends
|
||||
.Li .gz
|
||||
to the end of the filename, and then tries to locate the file using the other
|
||||
filesystems. Placement of this filesystem in the
|
||||
.Dv file_system[]
|
||||
.Va file_system[]
|
||||
array determines whether gzipped files will be opened in preference to non-gzipped
|
||||
files. It is only possible to seek a gzipped file forwards, and
|
||||
.Fn stat
|
||||
@ -443,11 +600,11 @@ on gzipped files will report an invalid length.
|
||||
.El
|
||||
.Pp
|
||||
The array of
|
||||
.Dv struct fs_ops
|
||||
.Vt struct fs_ops
|
||||
pointers should be terminated with a NULL.
|
||||
.Sh DEVICES
|
||||
Devices are exported by the supporting code via the array
|
||||
.Dv struct devsw *devsw[]
|
||||
.Vt struct devsw *devsw[]
|
||||
which is a NULL terminated array of pointers to device switch structures.
|
||||
.Sh BUGS
|
||||
.Pp
|
||||
|
@ -133,7 +133,7 @@ of login_time_t objects, which is up to LC_MAXTIMES (64)
|
||||
elements in length, and terminated by an element with its
|
||||
.Ar lt_dow
|
||||
field set to
|
||||
.Em LTM_NONE.
|
||||
.Em LTM_NONE .
|
||||
.Sh RETURN VALUES
|
||||
.Fn parse_lt
|
||||
returns a filled in structure of type login_time_t containing the
|
||||
|
@ -88,33 +88,33 @@ returns 0 on success and -1 on failure.
|
||||
.Fn uu_lock
|
||||
may return any of the following values:
|
||||
.Pp
|
||||
.Dv UU_LOCK_INUSE:
|
||||
.Dv UU_LOCK_INUSE :
|
||||
The lock is in use by another process.
|
||||
.Pp
|
||||
.Dv UU_LOCK_OK:
|
||||
.Dv UU_LOCK_OK :
|
||||
The lock was successfully created.
|
||||
.Pp
|
||||
.Dv UU_LOCK_OPEN_ERR:
|
||||
.Dv UU_LOCK_OPEN_ERR :
|
||||
The lock file could not be opened via
|
||||
.Xr open 2 .
|
||||
.Pp
|
||||
.Dv UU_LOCK_READ_ERR:
|
||||
.Dv UU_LOCK_READ_ERR :
|
||||
The lock file could not be read via
|
||||
.Xr read 2 .
|
||||
.Pp
|
||||
.Dv UU_LOCK_CREAT_ERR:
|
||||
.Dv UU_LOCK_CREAT_ERR :
|
||||
Can't create temporary lock file via
|
||||
.Xr creat 2 .
|
||||
.Pp
|
||||
.Dv UU_LOCK_WRITE_ERR:
|
||||
.Dv UU_LOCK_WRITE_ERR :
|
||||
The current process id could not be written to the lock file via a call to
|
||||
.Xr write 2 .
|
||||
.Pp
|
||||
.Dv UU_LOCK_LINK_ERR:
|
||||
.Dv UU_LOCK_LINK_ERR :
|
||||
Can't link temporary lock file via
|
||||
.Xr link 2 .
|
||||
.Pp
|
||||
.Dv UU_LOCK_TRY_ERR:
|
||||
.Dv UU_LOCK_TRY_ERR :
|
||||
Locking attempts are failed after 5 tries.
|
||||
.Pp
|
||||
If a value of
|
||||
@ -137,14 +137,14 @@ and
|
||||
.Fn uu_lock_txfr
|
||||
may return any of the following values:
|
||||
.Pp
|
||||
.Dv UU_LOCK_OK:
|
||||
.Dv UU_LOCK_OK :
|
||||
The transfer was successful. The specified process now holds the device
|
||||
lock.
|
||||
.Pp
|
||||
.Dv UU_LOCK_OWNER_ERR:
|
||||
.Dv UU_LOCK_OWNER_ERR :
|
||||
The current process does not already own a lock on the specified device.
|
||||
.Pp
|
||||
.Dv UU_LOCK_WRITE_ERR:
|
||||
.Dv UU_LOCK_WRITE_ERR :
|
||||
The new process id could not be written to the lock file via a call to
|
||||
.Xr write 2 .
|
||||
.Sh ERRORS
|
||||
|
@ -62,7 +62,7 @@ and the
|
||||
.Fn asinf
|
||||
functions return the arc sine in the range
|
||||
.Bk -words
|
||||
.Bq -\*(Pi/2, +\*(Pi/2
|
||||
.Bq -\*(Pi/2 , +\*(Pi/2
|
||||
.Ek
|
||||
radians.
|
||||
On the
|
||||
|
@ -99,7 +99,7 @@ The
|
||||
and the
|
||||
.Fn logf
|
||||
functions compute the value of the natural logarithm of argument
|
||||
.Fa x.
|
||||
.Fa x .
|
||||
.Pp
|
||||
The
|
||||
.Fn log10
|
||||
@ -257,7 +257,8 @@ and
|
||||
.Em NaN
|
||||
(the reserved
|
||||
operand on a
|
||||
.Tn VAX ) . Previous implementations of pow may
|
||||
.Tn VAX ) .
|
||||
Previous implementations of pow may
|
||||
have defined x**0 to be undefined in some or all of these
|
||||
cases. Here are reasons for returning x**0 = 1 always:
|
||||
.Bl -enum -width indent
|
||||
|
@ -47,10 +47,10 @@
|
||||
.Fn hypot "double x" "double y"
|
||||
.Ft float
|
||||
.Fn hypotf "float x" "float y"
|
||||
.Fd struct {double x, y;} z;
|
||||
.Vt struct {double x, y;} z ;
|
||||
.Ft double
|
||||
.Fn cabs z
|
||||
.Fd struct {float x, y;} z;
|
||||
.Vt struct {float x, y;} z ;
|
||||
.Ft float
|
||||
.Fn cabsf z
|
||||
.Sh DESCRIPTION
|
||||
|
@ -85,7 +85,7 @@ and
|
||||
return
|
||||
.Fa x
|
||||
with its sign changed to
|
||||
.Fa y Ns 's.
|
||||
.Fa y Ns 's .
|
||||
.Pp
|
||||
.Fn finite
|
||||
and
|
||||
@ -157,7 +157,7 @@ the remainder is computed exactly and
|
||||
.Sm on
|
||||
\*(Le
|
||||
.Sm off
|
||||
.Pf \\*(Ba Fa y No \\*(Ba/2.
|
||||
.Pf \\*(Ba Fa y No \\*(Ba/2 .
|
||||
.Sm on
|
||||
But
|
||||
.Fn remainder x 0
|
||||
|
@ -112,7 +112,7 @@ return appropriate values unless an argument is out of range.
|
||||
Overflow will occur for sufficiently large positive values, and
|
||||
non-positive integers.
|
||||
On the
|
||||
.Tn VAX,
|
||||
.Tn VAX ,
|
||||
the reserved operator is returned,
|
||||
and
|
||||
.Va errno
|
||||
|
@ -19,9 +19,10 @@ Root's
|
||||
file
|
||||
.Pa /etc/crontab
|
||||
has to contain the line
|
||||
.nf
|
||||
.Bd -literal
|
||||
*/5 * * * * root /usr/libexec/atrun
|
||||
.fi
|
||||
.Ed
|
||||
.Pp
|
||||
so that
|
||||
.Xr atrun 8
|
||||
gets invoked every five minutes.
|
||||
|
@ -32,7 +32,7 @@ RFC951, RFC1532, and RFC1533.
|
||||
.Nm Bootpgw
|
||||
implements a simple BOOTP gateway which can be used to forward
|
||||
requests and responses between clients on one subnet and a
|
||||
BOOTP server (i.e.
|
||||
BOOTP server (i.e.\&
|
||||
.Nm )
|
||||
on another subnet. While either
|
||||
.Nm
|
||||
@ -132,7 +132,7 @@ useful when client boot files are specified as relative pathnames, and
|
||||
.Nm
|
||||
needs to use the same current directory as the TFTP server
|
||||
(typically
|
||||
.Pa /tftpboot Ns ).
|
||||
.Pa /tftpboot ) .
|
||||
This option is not recognized by
|
||||
.Nm bootpgw .
|
||||
.It Fl i
|
||||
@ -189,7 +189,7 @@ the client has been waiting for at least three seconds.
|
||||
When
|
||||
.Nm
|
||||
is started it reads a configuration file, (normally
|
||||
.Pa /etc/bootptab Ns )
|
||||
.Pa /etc/bootptab )
|
||||
that initializes the internal database of known clients and client
|
||||
options. This internal database is reloaded
|
||||
from the configuration file when
|
||||
@ -221,7 +221,7 @@ During initialization, both programs
|
||||
determine the UDP port numbers to be used by calling
|
||||
.Xr getservbyname 3
|
||||
(which normally uses
|
||||
.Pa /etc/services Ns ).
|
||||
.Pa /etc/services ) .
|
||||
Two service names (and port numbers) are used:
|
||||
.Pp
|
||||
.Dl bootps BOOTP Server listening port
|
||||
|
@ -33,7 +33,7 @@ default values used by other entries via the
|
||||
mechanism. Most tags must be followed by an equals-sign
|
||||
and a value as above. Some may also appear in a boolean form with no
|
||||
value (i.e.
|
||||
.Em :tg: Ns ).
|
||||
.Em :tg: ) .
|
||||
The currently recognized tags are:
|
||||
.Pp
|
||||
.Bl -tag -width xxx -compact
|
||||
|
@ -412,7 +412,7 @@ formfeed.
|
||||
half-second pause.
|
||||
.It \er
|
||||
carriage return.
|
||||
.It \eS, \es
|
||||
.It \eS , \es
|
||||
space character.
|
||||
.It \et
|
||||
tab.
|
||||
|
@ -135,15 +135,15 @@ Turn off debugging, do nothing if already off.
|
||||
.El
|
||||
.Sh "FILES"
|
||||
.Bl -tag -width /usr/libexec/rbootd -compact
|
||||
.It /dev/bpf#
|
||||
.It Pa /dev/bpf#
|
||||
packet-filter device
|
||||
.It /etc/rbootd.conf
|
||||
.It Pa /etc/rbootd.conf
|
||||
configuration file
|
||||
.It /tmp/rbootd.dbg
|
||||
.It Pa /tmp/rbootd.dbg
|
||||
debug output
|
||||
.It /usr/mdec/rbootd
|
||||
.It Pa /usr/mdec/rbootd
|
||||
directory containing boot files
|
||||
.It /var/run/rbootd.pid
|
||||
.It Pa /var/run/rbootd.pid
|
||||
process id
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
|
@ -183,9 +183,7 @@ by the server failed.
|
||||
.Bl -tag -width /etc/hostsxxxxxxxx -compact
|
||||
.It Pa /etc/hosts
|
||||
.It Pa /etc/hosts.equiv
|
||||
.Sm off
|
||||
.It Pa Ev $HOME /.rhosts
|
||||
.Sm on
|
||||
.It Ev $HOME Ns Pa /.rhosts
|
||||
.It Pa /var/run/nologin
|
||||
.El
|
||||
.Sh BUGS
|
||||
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user