mirror of
https://git.FreeBSD.org/src.git
synced 2024-11-28 08:02:54 +00:00
Whitespace only change: trim trailing whitespace.
This commit is contained in:
Jeroen Ruigrok van der Werven
parent
03453c5e87
commit
5714e85318
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=67967
@ -52,11 +52,11 @@ This interface is made obsolete by setitimer(2).
|
||||
The
|
||||
.Fn alarm
|
||||
function sets a timer to deliver the signal
|
||||
.Dv SIGALRM
|
||||
.Dv SIGALRM
|
||||
to the calling process after the specified number of
|
||||
.Fa seconds .
|
||||
If an alarm has already been set with
|
||||
.Fn alarm
|
||||
.Fn alarm
|
||||
but has not been delivered, another call to
|
||||
.Fn alarm
|
||||
will supersede the prior call.
|
||||
@ -72,7 +72,7 @@ restriction the maximum number of
|
||||
allowed is 100000000.
|
||||
.Sh RETURN VALUES
|
||||
.Pp
|
||||
The return value of
|
||||
The return value of
|
||||
.Fn alarm
|
||||
is the amount of time left on the timer from a previous call to
|
||||
.Fn alarm .
|
||||
@ -89,10 +89,10 @@ If no alarm is currently set, the return value is 0.
|
||||
.\" .Sh STANDARDS
|
||||
.\" The
|
||||
.\" .Fn alarm
|
||||
.\" function conforms to
|
||||
.\" function conforms to
|
||||
.\" .St -p1003.1-90 .
|
||||
.Sh HISTORY
|
||||
An
|
||||
.Fn alarm
|
||||
function appeared in
|
||||
function appeared in
|
||||
.At v7 .
|
||||
|
||||
@ -50,23 +50,23 @@
|
||||
.Fn arc4random_addrandom "unsigned char *dat" "int datlen"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Fn arc4random
|
||||
.Fn arc4random
|
||||
function uses the key stream generator employed by the
|
||||
arc4 cipher, which uses 8*8 8 bit S-Boxes.
|
||||
The S-Boxes
|
||||
can be in about
|
||||
can be in about
|
||||
.if t 2\u\s71700\s10\d
|
||||
.if n (2**1700)
|
||||
states.
|
||||
.Pp
|
||||
The
|
||||
.Fn arc4random_stir
|
||||
function reads data from
|
||||
function reads data from
|
||||
.Pa /dev/urandom
|
||||
and uses it to permute the S-Boxes via
|
||||
.Fn arc4random_addrandom .
|
||||
.Pp
|
||||
There is no need to call
|
||||
There is no need to call
|
||||
.Fn arc4random_stir
|
||||
before using
|
||||
.Fn arc4random ,
|
||||
@ -78,12 +78,12 @@ automatically initializes itself.
|
||||
.Xr random 3 ,
|
||||
.Xr srandomdev 3
|
||||
.Sh HISTORY
|
||||
.Pa RC4
|
||||
.Pa RC4
|
||||
has been designed by RSA Data Security, Inc.
|
||||
It was posted anonymously
|
||||
to the USENET and was confirmed to be equivalent by several sources who
|
||||
had access to the original cipher.
|
||||
Since
|
||||
Since
|
||||
.Pa RC4
|
||||
used to be a trade secret, the cipher is now referred to as
|
||||
used to be a trade secret, the cipher is now referred to as
|
||||
.Pa ARC4 .
|
||||
|
||||
@ -73,7 +73,7 @@ is a non-null pointer, and
|
||||
.Fa name
|
||||
has a value, up to
|
||||
.Fa len
|
||||
\- 1 bytes of the value are copied into the buffer
|
||||
\- 1 bytes of the value are copied into the buffer
|
||||
.Fa buf .
|
||||
The copied value is always null terminated.
|
||||
.Pp
|
||||
|
||||
@ -73,9 +73,9 @@ provides the same functionality as
|
||||
.Fn ctermid
|
||||
except that if
|
||||
.Ar buf
|
||||
is a
|
||||
is a
|
||||
.Dv NULL
|
||||
pointer,
|
||||
pointer,
|
||||
.Dv NULL
|
||||
is returned.
|
||||
.Pp
|
||||
|
||||
@ -70,7 +70,7 @@ returns -1 and sets the global variable
|
||||
.Va errno
|
||||
to any of the errors specified for the library functions
|
||||
.Xr fork 2
|
||||
and
|
||||
and
|
||||
.Xr setsid 2 .
|
||||
.Sh SEE ALSO
|
||||
.Xr fork 2 ,
|
||||
|
||||
@ -100,7 +100,7 @@ provides the same functionality as
|
||||
.Fn readdir ,
|
||||
but the caller must provide a directory
|
||||
.Fa entry
|
||||
buffer to store the results in. If the read succeeds,
|
||||
buffer to store the results in. If the read succeeds,
|
||||
.Fa result
|
||||
is pointed at the
|
||||
.Fa entry ;
|
||||
@ -122,7 +122,7 @@ are good only for the lifetime of the
|
||||
.Dv DIR
|
||||
pointer,
|
||||
.Fa dirp ,
|
||||
from which they are derived. If the directory is closed and then
|
||||
from which they are derived. If the directory is closed and then
|
||||
reopened, prior values returned by
|
||||
.Fn telldir
|
||||
will no longer be valid.
|
||||
@ -138,7 +138,7 @@ The new position reverts to the one associated with the
|
||||
.Em directory stream
|
||||
when the
|
||||
.Fn telldir
|
||||
operation was performed.
|
||||
operation was performed.
|
||||
.Pp
|
||||
The
|
||||
.Fn rewinddir
|
||||
|
||||
@ -99,7 +99,7 @@ and
|
||||
signals. This is sufficient for many application level threads
|
||||
packages, which typically use one of these signals to implement
|
||||
preemption. An application which has registered its own locking
|
||||
methods with
|
||||
methods with
|
||||
.Nm
|
||||
can restore the default locking by calling
|
||||
.Nm
|
||||
|
||||
@ -14,9 +14,9 @@
|
||||
.\" NO EVENT SHALL SUN MICROSYSTEMS, INC. BE LIABLE FOR ANY SPECIAL, INDIRECT,
|
||||
.\" INCIDENTAL, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
|
||||
.\" FROM USE OF SUCH SOURCE CODE, REGARDLESS OF THE THEORY OF LIABILITY.
|
||||
.\"
|
||||
.\"
|
||||
.\" This source code is provided with no support and without any obligation on
|
||||
.\" the part of Sun Microsystems, Inc. to assist in its use, correction,
|
||||
.\" the part of Sun Microsystems, Inc. to assist in its use, correction,
|
||||
.\" modification or enhancement.
|
||||
.\"
|
||||
.\" SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
|
||||
@ -59,10 +59,10 @@ defined by such
|
||||
objects, and to remove such objects when their use is no longer required.
|
||||
.Pp
|
||||
.Fn dlopen
|
||||
provides access to the shared object in
|
||||
provides access to the shared object in
|
||||
.Fa path ,
|
||||
returning a descriptor that can be used for later
|
||||
references to the object in calls to
|
||||
references to the object in calls to
|
||||
.Fn dlsym
|
||||
and
|
||||
.Fn dlclose .
|
||||
@ -78,13 +78,13 @@ if any, is called by the dynamic linker.
|
||||
If
|
||||
.Fa path
|
||||
has already been placed in the address space in a previous call to
|
||||
.Fn dlopen ,
|
||||
it is not added a second time, although a reference count of
|
||||
.Fn dlopen ,
|
||||
it is not added a second time, although a reference count of
|
||||
.Fn dlopen
|
||||
operations on
|
||||
.Fa path
|
||||
is maintained.
|
||||
A null pointer supplied for
|
||||
A null pointer supplied for
|
||||
.Fa path
|
||||
is interpreted as a reference to the main
|
||||
executable of the process.
|
||||
@ -125,7 +125,7 @@ in the same DAG. This is the default, but it may be specified
|
||||
explicitly with this flag.
|
||||
.El
|
||||
.Pp
|
||||
If
|
||||
If
|
||||
.Fn dlopen
|
||||
fails, it returns a null pointer, and sets an error condition which may
|
||||
be interrogated with
|
||||
@ -137,7 +137,7 @@ character string
|
||||
.Fa symbol ,
|
||||
as it occurs in the shared object identified by
|
||||
.Fa handle .
|
||||
The symbols exported by objects added to the address space by
|
||||
The symbols exported by objects added to the address space by
|
||||
.Fn dlopen
|
||||
can be accessed only through calls to
|
||||
.Fn dlsym .
|
||||
@ -242,14 +242,14 @@ Just before removing a shared object in this way, the dynamic linker
|
||||
calls the object's
|
||||
.Fn _fini
|
||||
function, if such a function is defined by the object.
|
||||
If
|
||||
If
|
||||
.Fn dlclose
|
||||
is successful, it returns a value of 0.
|
||||
Otherwise it returns -1, and sets an error condition that can be
|
||||
interrogated with
|
||||
.Fn dlerror .
|
||||
.Pp
|
||||
The object-intrinsic functions
|
||||
The object-intrinsic functions
|
||||
.Fn _init
|
||||
and
|
||||
.Fn _fini
|
||||
@ -260,7 +260,7 @@ using the
|
||||
.Fl export-dynamic
|
||||
option to
|
||||
.Xr ld 1
|
||||
for symbols defined in the executable to become visible to
|
||||
for symbols defined in the executable to become visible to
|
||||
.Fn dlsym .
|
||||
.Pp
|
||||
In previous implementations, it was necessary to prepend an underscore
|
||||
|
||||
@ -155,7 +155,7 @@ errors except
|
||||
.Er ENOEXEC
|
||||
as being ambiguous here, although only the critical error
|
||||
.Er EACCES
|
||||
is really ambiguous),
|
||||
is really ambiguous),
|
||||
then these functions will act as if they stat the file to determine
|
||||
whether the file exists and has suitable execute permissions.
|
||||
If it does, they will return immediately with the global variable
|
||||
@ -260,7 +260,7 @@ upon which they returned.
|
||||
They now return for
|
||||
.Er ETXTBSY ,
|
||||
and determine existence and executability more carefully.
|
||||
In particular,
|
||||
In particular,
|
||||
.Er EACCES
|
||||
for inaccessible directories in the path prefix is no longer
|
||||
confused with
|
||||
|
||||
@ -112,12 +112,12 @@ if it immediately follows a slash.
|
||||
Ignore
|
||||
.Nm /*
|
||||
rest after successful
|
||||
.Fa pattern
|
||||
.Fa pattern
|
||||
matching.
|
||||
.It Dv FNM_CASEFOLD
|
||||
Ignore case distinctions in both the
|
||||
.Fa pattern
|
||||
and the
|
||||
Ignore case distinctions in both the
|
||||
.Fa pattern
|
||||
and the
|
||||
.Fa string .
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
@ -141,7 +141,7 @@ function conforms to
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn fnmatch
|
||||
function first appeared in
|
||||
function first appeared in
|
||||
.Bx 4.4 .
|
||||
.Sh BUGS
|
||||
The pattern
|
||||
|
||||
@ -64,7 +64,7 @@ function returns the value
|
||||
.Em x ,
|
||||
such that
|
||||
.Em x
|
||||
is a
|
||||
is a
|
||||
.Em double
|
||||
with magnitude in the interval
|
||||
.Bq 1/2 , 1
|
||||
@ -76,7 +76,7 @@ times 2 raised to the power
|
||||
.Fa *exp .
|
||||
If
|
||||
.Fa value
|
||||
is zero, both parts of the result are zero.
|
||||
is zero, both parts of the result are zero.
|
||||
.Sh SEE ALSO
|
||||
.Xr ldexp 3 ,
|
||||
.Xr math 3 ,
|
||||
|
||||
@ -246,7 +246,7 @@ or
|
||||
.Fn fts_read
|
||||
functions, with its
|
||||
.Fa fts_info
|
||||
field set to
|
||||
field set to
|
||||
.Dv FTS_DNR ,
|
||||
.Dv FTS_ERR
|
||||
or
|
||||
@ -478,7 +478,7 @@ fields of the
|
||||
structures may
|
||||
.Em never
|
||||
be used in this comparison.
|
||||
If the
|
||||
If the
|
||||
.Fa fts_info
|
||||
field is set to
|
||||
.Dv FTS_NS
|
||||
|
||||
@ -36,7 +36,7 @@
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd May 13, 1994
|
||||
.Dt GETCAP 3
|
||||
.Dt GETCAP 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm cgetent ,
|
||||
@ -86,13 +86,13 @@ terminated file array
|
||||
and returns a pointer to a
|
||||
.Xr malloc Ns \&'d
|
||||
copy of it in
|
||||
.Fa buf .
|
||||
.Fa buf .
|
||||
The
|
||||
.Fn cgetent
|
||||
function will first look for files ending in
|
||||
.Nm .db
|
||||
function will first look for files ending in
|
||||
.Nm .db
|
||||
(see
|
||||
.Xr cap_mkdb 1 )
|
||||
.Xr cap_mkdb 1 )
|
||||
before accessing the ASCII file.
|
||||
.Fa Buf
|
||||
must be retained through all subsequent calls to
|
||||
@ -105,42 +105,42 @@ and
|
||||
but may then be
|
||||
.Xr free 3 Ns \&'d.
|
||||
On success 0 is returned, 1 if the returned
|
||||
record contains an unresolved
|
||||
.Nm tc
|
||||
record contains an unresolved
|
||||
.Nm tc
|
||||
expansion,
|
||||
\-1 if the requested record couldn't be found,
|
||||
\-2 if a system error was encountered (couldn't open/read a file, etc.) also
|
||||
setting
|
||||
.Va errno ,
|
||||
.Va errno ,
|
||||
and \-3 if a potential reference loop is detected (see
|
||||
.Ic tc=
|
||||
comments below).
|
||||
.Pp
|
||||
The
|
||||
.Fn cgetset
|
||||
.Fn cgetset
|
||||
function enables the addition of a character buffer containing a single capability
|
||||
record entry
|
||||
to the capability database.
|
||||
to the capability database.
|
||||
Conceptually, the entry is added as the first ``file'' in the database, and
|
||||
is therefore searched first on the call to
|
||||
is therefore searched first on the call to
|
||||
.Fn cgetent .
|
||||
The entry is passed in
|
||||
The entry is passed in
|
||||
.Fa ent .
|
||||
If
|
||||
.Fa ent
|
||||
If
|
||||
.Fa ent
|
||||
is
|
||||
.Dv NULL ,
|
||||
the current entry is removed from the database.
|
||||
the current entry is removed from the database.
|
||||
A call to
|
||||
.Fn cgetset
|
||||
must precede the database traversal. It must be called before the
|
||||
.Fn cgetent
|
||||
.Fn cgetset
|
||||
must precede the database traversal. It must be called before the
|
||||
.Fn cgetent
|
||||
call. If a sequential access is being performed (see below), it must be called
|
||||
before the first sequential access call (
|
||||
.Fn cgetfirst
|
||||
or
|
||||
.Fn cgetnext
|
||||
), or be directly preceded by a
|
||||
), or be directly preceded by a
|
||||
.Fn cgetclose
|
||||
call.
|
||||
On success 0 is returned and \-1 on failure.
|
||||
@ -213,55 +213,55 @@ failure).
|
||||
.Pp
|
||||
The
|
||||
.Fn cgetustr
|
||||
function is identical to
|
||||
.Fn cgetstr
|
||||
function is identical to
|
||||
.Fn cgetstr
|
||||
except that it does not expand special characters, but rather returns each
|
||||
character of the capability string literally.
|
||||
.Pp
|
||||
The
|
||||
.Fn cgetfirst
|
||||
and
|
||||
.Fn cgetnext
|
||||
.Fn cgetnext
|
||||
functions comprise a function group that provides for sequential
|
||||
access of the
|
||||
.Dv NULL
|
||||
pointer terminated array of file names,
|
||||
.Fa db_array .
|
||||
The
|
||||
.Fn cgetfirst
|
||||
.Fn cgetfirst
|
||||
function returns the first record in the database and resets the access
|
||||
to the first record.
|
||||
The
|
||||
.Fn cgetnext
|
||||
.Fn cgetnext
|
||||
function returns the next record in the database with respect to the
|
||||
record returned by the previous
|
||||
.Fn cgetfirst
|
||||
or
|
||||
.Fn cgetnext
|
||||
.Fn cgetnext
|
||||
call. If there is no such previous call, the first record in the database is
|
||||
returned.
|
||||
Each record is returned in a
|
||||
.Xr malloc Ns \&'d
|
||||
copy pointed to by
|
||||
.Fa buf .
|
||||
.Xr malloc Ns \&'d
|
||||
copy pointed to by
|
||||
.Fa buf .
|
||||
.Ic Tc
|
||||
expansion is done (see
|
||||
.Ic tc=
|
||||
.Ic tc=
|
||||
comments below).
|
||||
Upon completion of the database 0 is returned, 1 is returned upon successful
|
||||
return of record with possibly more remaining (we haven't reached the end of
|
||||
return of record with possibly more remaining (we haven't reached the end of
|
||||
the database yet), 2 is returned if the record contains an unresolved
|
||||
.Nm tc
|
||||
.Nm tc
|
||||
expansion, \-1 is returned if an system error occurred, and \-2
|
||||
is returned if a potential reference loop is detected (see
|
||||
is returned if a potential reference loop is detected (see
|
||||
.Ic tc=
|
||||
comments below).
|
||||
Upon completion of database (0 return) the database is closed.
|
||||
.Pp
|
||||
The
|
||||
.Fn cgetclose
|
||||
function closes the sequential access and frees any memory and file descriptors
|
||||
being used. Note that it does not erase the buffer pushed by a call to
|
||||
.Fn cgetclose
|
||||
function closes the sequential access and frees any memory and file descriptors
|
||||
being used. Note that it does not erase the buffer pushed by a call to
|
||||
.Fn cgetset .
|
||||
.Sh CAPABILITY DATABASE SYNTAX
|
||||
Capability databases are normally
|
||||
@ -320,7 +320,7 @@ distinguished by their
|
||||
.Fa types .
|
||||
The
|
||||
.Fn cgetcap
|
||||
function will return a pointer to a value of a name given the capability
|
||||
function will return a pointer to a value of a name given the capability
|
||||
name and the type of the value.
|
||||
.Pp
|
||||
The types `#' and `=' are conventionally used to denote numeric and
|
||||
@ -422,7 +422,7 @@ has value
|
||||
.Em number
|
||||
.It Em name No = Em string Ta "string capability"
|
||||
.Em name
|
||||
has value
|
||||
has value
|
||||
.Em string
|
||||
.It Em name No \&#@ Ta "the numeric capability"
|
||||
.Em name
|
||||
@ -494,15 +494,15 @@ on failure.
|
||||
.Pp
|
||||
The
|
||||
.Fn cgetent ,
|
||||
and
|
||||
and
|
||||
.Fn cgetseq
|
||||
functions may fail and set
|
||||
functions may fail and set
|
||||
.Va errno
|
||||
for any of the errors specified for the library functions:
|
||||
.Xr fopen 3 ,
|
||||
.Xr fopen 3 ,
|
||||
.Xr fclose 3 ,
|
||||
.Xr open 2 ,
|
||||
and
|
||||
and
|
||||
.Xr close 2 .
|
||||
.Pp
|
||||
The
|
||||
@ -510,10 +510,10 @@ The
|
||||
.Fn cgetset ,
|
||||
.Fn cgetstr ,
|
||||
and
|
||||
.Fn cgetustr
|
||||
.Fn cgetustr
|
||||
functions
|
||||
may fail and set
|
||||
.Va errno
|
||||
may fail and set
|
||||
.Va errno
|
||||
as follows:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er ENOMEM
|
||||
@ -530,6 +530,6 @@ There are no checks for
|
||||
loops in
|
||||
.Fn cgetent .
|
||||
.Pp
|
||||
The buffer added to the database by a call to
|
||||
.Fn cgetset
|
||||
The buffer added to the database by a call to
|
||||
.Fn cgetset
|
||||
is not unique to the database but is rather prepended to any database used.
|
||||
|
||||
@ -147,7 +147,7 @@ allocate memory as necessary is an extension.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn getwd
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 4.0 .
|
||||
.Sh BUGS
|
||||
The
|
||||
|
||||
@ -53,7 +53,7 @@ takes a disk name (e.g.
|
||||
and returns a prototype disk label
|
||||
describing its geometry information and the standard
|
||||
disk partition tables. All information is obtained from
|
||||
the
|
||||
the
|
||||
.Xr disktab 5
|
||||
file.
|
||||
.Sh SEE ALSO
|
||||
@ -63,5 +63,5 @@ file.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn getdiskbyname
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 4.3 .
|
||||
|
||||
@ -54,7 +54,7 @@ previously set by
|
||||
.Fn setdomainname .
|
||||
The parameter
|
||||
.Fa namelen
|
||||
specifies the size of the
|
||||
specifies the size of the
|
||||
.Fa name
|
||||
array. The returned name is null-terminated unless insufficient
|
||||
space is provided.
|
||||
|
||||
@ -137,13 +137,13 @@ returns nothing.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn getfsent
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 4.0 ;
|
||||
the
|
||||
.Fn endfsent ,
|
||||
.Fn getfsfile ,
|
||||
.Fn getfsspec ,
|
||||
and
|
||||
and
|
||||
.Fn setfsent
|
||||
functions appeared in
|
||||
.Bx 4.3 .
|
||||
|
||||
@ -58,7 +58,7 @@ the group number from the password file.
|
||||
.Pp
|
||||
The resulting group list is returned in the integer array pointed to by
|
||||
.Fa groups .
|
||||
The caller specifies the size of the
|
||||
The caller specifies the size of the
|
||||
.Fa groups
|
||||
array in the integer pointed to by
|
||||
.Fa ngroups ;
|
||||
|
||||
@ -54,7 +54,7 @@ previously set by
|
||||
.Fn sethostname .
|
||||
The parameter
|
||||
.Fa namelen
|
||||
specifies the size of the
|
||||
specifies the size of the
|
||||
.Fa name
|
||||
array. The returned name is null-terminated unless insufficient
|
||||
space is provided.
|
||||
|
||||
@ -72,19 +72,19 @@ The pointer to the array is stored into
|
||||
If an error occurs, zero is returned and the external variable
|
||||
.Va errno
|
||||
is set to indicate the error.
|
||||
Although the pointer
|
||||
Although the pointer
|
||||
.Fa mntbufp
|
||||
will be unmodified, any information previously returned by
|
||||
will be unmodified, any information previously returned by
|
||||
.Fn getmntinfo
|
||||
will be lost.
|
||||
.Sh ERRORS
|
||||
The
|
||||
.Fn getmntinfo
|
||||
function
|
||||
may fail and set errno for any of the errors specified for the library
|
||||
may fail and set errno for any of the errors specified for the library
|
||||
routines
|
||||
.Xr getfsstat 2
|
||||
or
|
||||
or
|
||||
.Xr malloc 3 .
|
||||
.Sh SEE ALSO
|
||||
.Xr getfsstat 2 ,
|
||||
|
||||
@ -122,5 +122,5 @@ If present, specifies the object file format to use. Syntax is
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn getobjformat
|
||||
function first appeared in
|
||||
function first appeared in
|
||||
.Fx 3.0 .
|
||||
|
||||
@ -53,7 +53,7 @@
|
||||
.Ft struct passwd *
|
||||
.Fn getpwnam "const char *login"
|
||||
.Ft struct passwd *
|
||||
.Fn getpwuid "uid_t uid"
|
||||
.Fn getpwuid "uid_t uid"
|
||||
.Ft int
|
||||
.Fn setpassent "int stayopen"
|
||||
.Ft void
|
||||
|
||||
@ -91,7 +91,7 @@ returns a null pointer (0) on
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn getusershell
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 4.3 .
|
||||
.Sh BUGS
|
||||
The
|
||||
|
||||
@ -80,7 +80,7 @@ The
|
||||
.Fn vfsisloadable
|
||||
function returns a non-zero value if a later call to
|
||||
.Fn vfsload name
|
||||
is likely to succeed. We say
|
||||
is likely to succeed. We say
|
||||
.Dq likely
|
||||
because
|
||||
.Fn vfsisloadable
|
||||
|
||||
@ -47,7 +47,7 @@
|
||||
.Fd #include <glob.h>
|
||||
.Ft int
|
||||
.Fn glob "const char *pattern" "int flags" "int (*errfunc)(const char *, int)" "glob_t *pglob"
|
||||
.Ft void
|
||||
.Ft void
|
||||
.Fn globfree "glob_t *pglob"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
@ -99,7 +99,7 @@ field, and a pointer to a list of pointers to pathnames into the
|
||||
.Fa gl_pathv
|
||||
field.
|
||||
The first pointer after the last pathname is
|
||||
.Dv NULL .
|
||||
.Dv NULL .
|
||||
If the pattern does not match any pathnames, the returned number of
|
||||
matched paths is set to zero.
|
||||
.Pp
|
||||
@ -220,33 +220,33 @@ This extension is provided to allow programs such as
|
||||
.Xr restore 8
|
||||
to provide globbing from directories stored on tape.
|
||||
.It Dv GLOB_BRACE
|
||||
Pre-process the pattern string to expand
|
||||
.Ql {pat,pat,...}
|
||||
strings like
|
||||
Pre-process the pattern string to expand
|
||||
.Ql {pat,pat,...}
|
||||
strings like
|
||||
.Xr csh 1 .
|
||||
The pattern
|
||||
The pattern
|
||||
.Ql {}
|
||||
is left unexpanded for historical reasons (and
|
||||
.Xr csh 1
|
||||
does the same thing to
|
||||
.Xr csh 1
|
||||
does the same thing to
|
||||
ease typing
|
||||
of
|
||||
.Xr find 1
|
||||
of
|
||||
.Xr find 1
|
||||
patterns).
|
||||
.It Dv GLOB_MAGCHAR
|
||||
Set by the
|
||||
.Fn glob
|
||||
function if the pattern included globbing characters.
|
||||
See the description of the usage of the
|
||||
See the description of the usage of the
|
||||
.Fa gl_matchc
|
||||
structure member for more details.
|
||||
.It Dv GLOB_NOMAGIC
|
||||
Is the same as
|
||||
.Dv GLOB_NOCHECK
|
||||
Is the same as
|
||||
.Dv GLOB_NOCHECK
|
||||
but it only appends the
|
||||
.Fa pattern
|
||||
if it does not contain any of the special characters ``*'', ``?'' or ``[''.
|
||||
.Dv GLOB_NOMAGIC
|
||||
.Dv GLOB_NOMAGIC
|
||||
is provided to simplify implementing the historic
|
||||
.Xr csh 1
|
||||
globbing behavior and should probably not be used anywhere else.
|
||||
@ -266,7 +266,7 @@ If, during the search, a directory is encountered that cannot be opened
|
||||
or read and
|
||||
.Fa errfunc
|
||||
is
|
||||
.Pf non- Dv NULL ,
|
||||
.Pf non- Dv NULL ,
|
||||
.Fn glob
|
||||
calls
|
||||
.Fa (*errfunc)(path, errno) .
|
||||
@ -283,7 +283,7 @@ call to
|
||||
The error routine can suppress this action by testing for
|
||||
.Dv ENOENT
|
||||
and
|
||||
.Dv ENOTDIR ;
|
||||
.Dv ENOTDIR ;
|
||||
however, the
|
||||
.Dv GLOB_ERR
|
||||
flag will still cause an immediate
|
||||
@ -333,16 +333,16 @@ contain the values described below:
|
||||
.Bl -tag -width GLOB_NOCHECK
|
||||
.It Fa gl_pathc
|
||||
contains the total number of matched pathnames so far.
|
||||
This includes other matches from previous invocations of
|
||||
This includes other matches from previous invocations of
|
||||
.Fn glob
|
||||
if
|
||||
if
|
||||
.Dv GLOB_APPEND
|
||||
was specified.
|
||||
.It Fa gl_matchc
|
||||
contains the number of matched pathnames in the current invocation of
|
||||
.Fn glob .
|
||||
.It Fa gl_flags
|
||||
contains a copy of the
|
||||
contains a copy of the
|
||||
.Fa flags
|
||||
parameter with the bit
|
||||
.Dv GLOB_MAGCHAR
|
||||
@ -352,7 +352,7 @@ contained any of the special characters ``*'', ``?'' or ``['', cleared
|
||||
if not.
|
||||
.It Fa gl_pathv
|
||||
contains a pointer to a
|
||||
.Dv NULL Ns -terminated
|
||||
.Dv NULL Ns -terminated
|
||||
list of matched pathnames.
|
||||
However, if
|
||||
.Fa gl_pathc
|
||||
@ -416,9 +416,9 @@ that the flags
|
||||
.Dv GLOB_QUOTE,
|
||||
and
|
||||
.Dv GLOB_TILDE,
|
||||
and the fields
|
||||
and the fields
|
||||
.Fa gl_matchc
|
||||
and
|
||||
and
|
||||
.Fa gl_flags
|
||||
should not be used by applications striving for strict
|
||||
.Tn POSIX
|
||||
|
||||
@ -71,7 +71,7 @@ returns \-1 if it was not invoked by the super-user.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn initgroups
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 4.2 .
|
||||
.Sh BUGS
|
||||
The
|
||||
|
||||
@ -43,9 +43,9 @@
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.Ft int
|
||||
.Ft int
|
||||
.Fn isinf double
|
||||
.Ft int
|
||||
.Ft int
|
||||
.Fn isnan double
|
||||
.Ft int
|
||||
.Fn isnanf float
|
||||
|
||||
@ -55,7 +55,7 @@ function breaks the argument
|
||||
.Fa value
|
||||
into integral and fractional parts, each of which has the
|
||||
same sign as the argument.
|
||||
It stores the integral part as a
|
||||
It stores the integral part as a
|
||||
.Em double
|
||||
in the object pointed to by
|
||||
.Fa iptr .
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: msgctl.2,v 1.1 1995/10/16 23:49:15 jtc Exp $
|
||||
.\" $NetBSD: msgctl.2,v 1.1 1995/10/16 23:49:15 jtc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1995 Frank van der Linden
|
||||
.\" All rights reserved.
|
||||
@ -126,7 +126,7 @@ The values are taken from the corresponding fields in the structure
|
||||
pointed to by
|
||||
.Fa buf .
|
||||
This operation can only be executed by the super-user, or a process that
|
||||
has an effective user id equal to either
|
||||
has an effective user id equal to either
|
||||
.Va msg_perm.cuid
|
||||
or
|
||||
.Va msg_perm.uid
|
||||
@ -145,7 +145,7 @@ Remove the message queue specified by
|
||||
.Fa msqid
|
||||
and destroy the data associated with it.
|
||||
Only the super-user or a process
|
||||
with an effective uid equal to the
|
||||
with an effective uid equal to the
|
||||
.Va msg_perm.cuid
|
||||
or
|
||||
.Va msg_perm.uid
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: msgget.2,v 1.1 1995/10/16 23:49:19 jtc Exp $
|
||||
.\" $NetBSD: msgget.2,v 1.1 1995/10/16 23:49:19 jtc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1995 Frank van der Linden
|
||||
.\" All rights reserved.
|
||||
@ -68,7 +68,7 @@ structure, see
|
||||
.Xr msgctl 3 )
|
||||
is initialized as follows:
|
||||
.Bl -bullet
|
||||
.It
|
||||
.It
|
||||
.Va msg_perm.cuid
|
||||
and
|
||||
.Va msg_perm.uid
|
||||
@ -88,7 +88,7 @@ is set to the lower 9 bits of
|
||||
.Va msg_lspid ,
|
||||
.Va msg_lrpid ,
|
||||
.Va msg_rtime ,
|
||||
and
|
||||
and
|
||||
.Va msg_stime
|
||||
are set to 0.
|
||||
.It
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: msgrcv.2,v 1.1 1995/10/16 23:49:20 jtc Exp $
|
||||
.\" $NetBSD: msgrcv.2,v 1.1 1995/10/16 23:49:20 jtc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1995 Frank van der Linden
|
||||
.\" All rights reserved.
|
||||
@ -46,7 +46,7 @@
|
||||
.Ft int
|
||||
.Fn msgrcv "int msqid" "void *msgp" "size_t msgsz" "long msgtyp" "int msgflg"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
The
|
||||
.Fn msgrcv
|
||||
function receives a message from the message queue specified in
|
||||
.Fa msqid ,
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
.\" $NetBSD: msgsnd.2,v 1.1 1995/10/16 23:49:24 jtc Exp $
|
||||
.\" $NetBSD: msgsnd.2,v 1.1 1995/10/16 23:49:24 jtc Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1995 Frank van der Linden
|
||||
.\" All rights reserved.
|
||||
@ -46,7 +46,7 @@
|
||||
.Ft int
|
||||
.Fn msgsnd "int msqid" "void *msgp" "size_t msgsz" "int msgflg"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
The
|
||||
.Fn msgsnd
|
||||
function sends a message to the message queue specified in
|
||||
.Fa msqid .
|
||||
@ -62,7 +62,7 @@ consist of the following members:
|
||||
.Va mtype
|
||||
is an integer greater than 0 that can be used for selecting messages (see
|
||||
.Xr msgrcv 3 ) ,
|
||||
.Va mtext
|
||||
.Va mtext
|
||||
is an array of bytes, with a size up to that of the system limit
|
||||
.Pf ( Dv MSGMAX ) .
|
||||
.Pp
|
||||
|
||||
@ -68,5 +68,5 @@ Children inherit the priority of their parent processes via
|
||||
.Sh HISTORY
|
||||
A
|
||||
.Fn nice
|
||||
syscall appeared in
|
||||
syscall appeared in
|
||||
.At v6 .
|
||||
|
||||
@ -82,5 +82,5 @@ The call was interrupted.
|
||||
A
|
||||
.Fn pause
|
||||
syscall
|
||||
appeared in
|
||||
appeared in
|
||||
.At v6 .
|
||||
|
||||
@ -109,5 +109,5 @@ and
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn psignal
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 4.2 .
|
||||
|
||||
@ -53,7 +53,7 @@ The
|
||||
function returns the user name associated with the argument
|
||||
.Fa uid .
|
||||
The user name is cached so that multiple calls with the same
|
||||
.Fa uid
|
||||
.Fa uid
|
||||
do not require additional calls to
|
||||
.Xr getpwuid 3 .
|
||||
If there is no user associated with the
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <stdlib.h>
|
||||
.Ft double
|
||||
.Ft double
|
||||
.Fn drand48 void
|
||||
.Ft double
|
||||
.Fn erand48 "unsigned short xseed[3]"
|
||||
|
||||
@ -105,5 +105,5 @@ The
|
||||
.Fn scandir
|
||||
and
|
||||
.Fn alphasort
|
||||
functions appeared in
|
||||
functions appeared in
|
||||
.Bx 4.2 .
|
||||
|
||||
@ -87,16 +87,16 @@ If the mode passed to
|
||||
is invalid or if memory cannot be allocated for the return value,
|
||||
.Fn setmode
|
||||
returns
|
||||
.Dv NULL .
|
||||
.Dv NULL .
|
||||
.Pp
|
||||
The value returned from
|
||||
.Fn setmode
|
||||
is obtained from
|
||||
.Fn malloc
|
||||
The value returned from
|
||||
.Fn setmode
|
||||
is obtained from
|
||||
.Fn malloc
|
||||
and should be returned to the system with
|
||||
.Fn free
|
||||
when the program is done with it, generally after a call to
|
||||
.Fn getmode .
|
||||
.Fn free
|
||||
when the program is done with it, generally after a call to
|
||||
.Fn getmode .
|
||||
.Sh ERRORS
|
||||
The
|
||||
.Fn setmode
|
||||
|
||||
@ -130,7 +130,7 @@ or
|
||||
on a shared memory object, or on the descriptor returned by
|
||||
.Fn shm_open ,
|
||||
is undefined.
|
||||
It is also undefined whether the shared memory object itself, or its
|
||||
It is also undefined whether the shared memory object itself, or its
|
||||
contents, persist across reboots.
|
||||
.Sh RETURN VALUES
|
||||
If successful,
|
||||
|
||||
@ -67,7 +67,7 @@ and no data has been transferred,
|
||||
the system call will return \-1 with the global variable
|
||||
.Va errno
|
||||
set to
|
||||
.Dv EINTR .
|
||||
.Dv EINTR .
|
||||
Interrupted system calls that have started transferring
|
||||
data will return the amount of data actually transferred.
|
||||
System call interrupt is the signal behavior found on
|
||||
@ -110,5 +110,5 @@ A \-1 value indicates that an invalid signal number has been supplied.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn siginterrupt
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 4.3 .
|
||||
|
||||
@ -49,7 +49,7 @@
|
||||
|
||||
or in FreeBSD's equivalent but easier to read typedef'd version:
|
||||
.Ft typedef "void \*(lp*sig_t\*(rp \*(lpint\*(rp"
|
||||
.Ft sig_t
|
||||
.Ft sig_t
|
||||
.Fn signal "int sig" "sig_t func"
|
||||
.Sh DESCRIPTION
|
||||
This
|
||||
@ -231,5 +231,5 @@ or
|
||||
.Sh HISTORY
|
||||
This
|
||||
.Nm signal
|
||||
facility appeared in
|
||||
facility appeared in
|
||||
.Bx 4.0 .
|
||||
|
||||
@ -95,7 +95,7 @@ Returns a pointer to a
|
||||
.It Fn sl_free
|
||||
Releases memory occupied by
|
||||
.Ar sl
|
||||
and the
|
||||
and the
|
||||
.Ar sl->sl_str
|
||||
array.
|
||||
If
|
||||
|
||||
@ -57,14 +57,14 @@ If no flags are set a zero length string is returned.
|
||||
If memory cannot be allocated for the return value,
|
||||
.Fn fflagstostr
|
||||
returns
|
||||
.Dv NULL .
|
||||
.Dv NULL .
|
||||
.Pp
|
||||
The value returned from
|
||||
The value returned from
|
||||
.Fn fflagstostr
|
||||
is obtained from
|
||||
.Fn malloc
|
||||
is obtained from
|
||||
.Fn malloc
|
||||
and should be returned to the system with
|
||||
.Fn free
|
||||
.Fn free
|
||||
when the program is done with it.
|
||||
.Pp
|
||||
The
|
||||
|
||||
@ -122,7 +122,7 @@ The maximum number of repeated occurrences of a regular expression
|
||||
permitted when using interval notation.
|
||||
.It Li _SC_2_VERSION
|
||||
The version of POSIX 1003.2 with which the system attempts to comply.
|
||||
.It Li _SC_2_C_BIND
|
||||
.It Li _SC_2_C_BIND
|
||||
Return 1 if the system's C-language development facilities support the
|
||||
C-Language Bindings Option, otherwise \-1.
|
||||
.It Li _SC_2_C_DEV
|
||||
|
||||
@ -57,7 +57,7 @@ The information available from
|
||||
.Fn sysctl
|
||||
consists of integers, strings, and tables.
|
||||
Information may be retrieved and set from the command interface
|
||||
using the
|
||||
using the
|
||||
.Xr sysctl 8
|
||||
utility.
|
||||
.Pp
|
||||
@ -102,7 +102,7 @@ and
|
||||
.Fa oldlenp
|
||||
should be set to NULL.
|
||||
.Pp
|
||||
The size of the available data can be determined by calling
|
||||
The size of the available data can be determined by calling
|
||||
.Fn sysctl
|
||||
with a NULL parameter for
|
||||
.Fa oldp .
|
||||
@ -177,9 +177,9 @@ Each time it runs,
|
||||
.Fn sysctl
|
||||
gets the list of debugging variables from the kernel and
|
||||
displays their current values.
|
||||
The system defines twenty
|
||||
The system defines twenty
|
||||
.Ns ( Va struct ctldebug )
|
||||
variables named
|
||||
variables named
|
||||
.Nm debug0
|
||||
through
|
||||
.Nm debug19 .
|
||||
@ -382,7 +382,7 @@ Return profiling information about the kernel.
|
||||
If the kernel is not compiled for profiling,
|
||||
attempts to retrieve any of the KERN_PROF values will
|
||||
fail with EOPNOTSUPP.
|
||||
The third level names for the string and integer profiling information
|
||||
The third level names for the string and integer profiling information
|
||||
is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
@ -495,7 +495,7 @@ The currently defined protocols and names are:
|
||||
The variables are as follows:
|
||||
.Bl -tag -width "123456"
|
||||
.It Li icmp.bmcastecho
|
||||
Returns 1 if an ICMP echo request to a broadcast or multicast address is
|
||||
Returns 1 if an ICMP echo request to a broadcast or multicast address is
|
||||
to be answered.
|
||||
.It Li icmp.maskrepl
|
||||
Returns 1 if ICMP network mask requests are to be answered.
|
||||
@ -642,7 +642,7 @@ privilege may change the value.
|
||||
.It VM\_V\_FREE\_RESERVED integer yes
|
||||
.It VM\_V\_FREE\_TARGET integer yes
|
||||
.It VM\_V\_INACTIVE\_TARGET integer yes
|
||||
.It VM\_V\_PAGEOUT\_FREE\_MIN integer yes
|
||||
.It VM\_V\_PAGEOUT\_FREE\_MIN integer yes
|
||||
.El
|
||||
.Pp
|
||||
.Bl -tag -width "123456"
|
||||
|
||||
@ -147,7 +147,7 @@ cannot pass the message to
|
||||
.Xr syslogd 8
|
||||
it will attempt to write the message to the console
|
||||
.Pq Dq Pa /dev/console.
|
||||
.It Dv LOG_NDELAY
|
||||
.It Dv LOG_NDELAY
|
||||
Open the connection to
|
||||
.Xr syslogd 8
|
||||
immediately.
|
||||
@ -218,7 +218,7 @@ Similarly for
|
||||
.Dv LOG_LOCAL1
|
||||
through
|
||||
.Dv LOG_LOCAL7 .
|
||||
.El
|
||||
.El
|
||||
.Pp
|
||||
The
|
||||
.Fn closelog
|
||||
@ -274,5 +274,5 @@ syslog(LOG_INFO|LOG_LOCAL2, "foobar error: %m");
|
||||
.Xr syslogd 8
|
||||
.Sh HISTORY
|
||||
These
|
||||
functions appeared in
|
||||
functions appeared in
|
||||
.Bx 4.2 .
|
||||
|
||||
@ -42,7 +42,7 @@
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <sys/times.h>
|
||||
.Ft clock_t
|
||||
.Ft clock_t
|
||||
.Fn times "struct tms *tp"
|
||||
.Sh DESCRIPTION
|
||||
.Bf -symbolic
|
||||
|
||||
@ -94,7 +94,7 @@ The
|
||||
function
|
||||
returns the null terminated name if the device is found and
|
||||
.Fn isatty
|
||||
is true; otherwise
|
||||
is true; otherwise
|
||||
a
|
||||
.Dv NULL
|
||||
pointer is returned.
|
||||
|
||||
@ -42,7 +42,7 @@
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <unistd.h>
|
||||
.Ft u_int
|
||||
.Ft u_int
|
||||
.Fn ualarm "u_int microseconds" "u_int interval"
|
||||
.Sh DESCRIPTION
|
||||
.Bf -symbolic
|
||||
@ -97,5 +97,5 @@ A microsecond is 0.000001 seconds.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn ualarm
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 4.3 .
|
||||
|
||||
@ -79,5 +79,5 @@ action was to invoke a signal-catching function.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn usleep
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 4.3 .
|
||||
|
||||
@ -81,7 +81,7 @@ for any of the errors specified for the library function
|
||||
.Sh HISTORY
|
||||
A
|
||||
.Fn utime
|
||||
function appeared in
|
||||
function appeared in
|
||||
.At v7 .
|
||||
.Sh STANDARDS
|
||||
The
|
||||
|
||||
@ -69,7 +69,7 @@ a null pointer is returned
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn valloc
|
||||
function appeared in
|
||||
function appeared in
|
||||
.Bx 3.0 .
|
||||
.Sh BUGS
|
||||
A
|
||||
|
||||
@ -130,7 +130,7 @@ or
|
||||
on a shared memory object, or on the descriptor returned by
|
||||
.Fn shm_open ,
|
||||
is undefined.
|
||||
It is also undefined whether the shared memory object itself, or its
|
||||
It is also undefined whether the shared memory object itself, or its
|
||||
contents, persist across reboots.
|
||||
.Sh RETURN VALUES
|
||||
If successful,
|
||||
|
||||
Loading…
Reference in New Issue
Block a user