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