summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-12-18 10:13:54 +0000
committerru <ru@FreeBSD.org>2002-12-18 10:13:54 +0000
commitd0db69d964a72128c1dcb81af009e3bd728c7876 (patch)
treed7fc87dbba410fea9fb526ffb94f2409d3c5f8cc
parentaf6f15fd347359b35b89710f15c02dffacf8d980 (diff)
downloadFreeBSD-src-d0db69d964a72128c1dcb81af009e3bd728c7876.zip
FreeBSD-src-d0db69d964a72128c1dcb81af009e3bd728c7876.tar.gz
mdoc(7) police: "The .Fn function".
-rw-r--r--lib/libc/gen/basename.32
-rw-r--r--lib/libc/gen/ctermid.32
-rw-r--r--lib/libc/gen/devname.32
-rw-r--r--lib/libc/gen/directory.34
-rw-r--r--lib/libc/gen/dirname.32
-rw-r--r--lib/libc/gen/dladdr.312
-rw-r--r--lib/libc/gen/dllockinit.312
-rw-r--r--lib/libc/gen/dlopen.320
-rw-r--r--lib/libc/gen/exec.312
-rw-r--r--lib/libc/gen/fnmatch.32
-rw-r--r--lib/libc/gen/getbootfile.32
-rw-r--r--lib/libc/gen/getdomainname.310
-rw-r--r--lib/libc/gen/getgrent.32
-rw-r--r--lib/libc/gen/gethostname.310
-rw-r--r--lib/libc/gen/getnetgrent.34
-rw-r--r--lib/libc/gen/getobjformat.32
-rw-r--r--lib/libc/gen/getpagesize.36
-rw-r--r--lib/libc/gen/getpeereid.32
-rw-r--r--lib/libc/gen/getpwent.32
-rw-r--r--lib/libc/gen/getvfsent.34
-rw-r--r--lib/libc/gen/lockf.33
-rw-r--r--lib/libc/gen/makecontext.36
-rw-r--r--lib/libc/gen/msgctl.32
-rw-r--r--lib/libc/gen/msgget.32
-rw-r--r--lib/libc/gen/msgrcv.32
-rw-r--r--lib/libc/gen/msgsnd.32
-rw-r--r--lib/libc/gen/pselect.34
-rw-r--r--lib/libc/gen/rand48.314
-rw-r--r--lib/libc/gen/readpassphrase.34
-rw-r--r--lib/libc/gen/rfork_thread.34
-rw-r--r--lib/libc/gen/setproctitle.34
-rw-r--r--lib/libc/gen/signal.36
-rw-r--r--lib/libc/gen/sysctl.39
33 files changed, 141 insertions, 35 deletions
diff --git a/lib/libc/gen/basename.3 b/lib/libc/gen/basename.3
index a6cd7b5..85c65f6 100644
--- a/lib/libc/gen/basename.3
+++ b/lib/libc/gen/basename.3
@@ -78,7 +78,9 @@ The path component to be returned was larger than
.Dv MAXPATHLEN .
.El
.Sh WARNINGS
+The
.Fn basename
+function
returns a pointer to internal static storage space that will be overwritten
by subsequent calls.
.Sh SEE ALSO
diff --git a/lib/libc/gen/ctermid.3 b/lib/libc/gen/ctermid.3
index 1ed1062..e0fc487 100644
--- a/lib/libc/gen/ctermid.3
+++ b/lib/libc/gen/ctermid.3
@@ -68,7 +68,9 @@ file
.Aq Pa stdio.h )
bytes long.
.Pp
+The
.Fn ctermid_r
+function
provides the same functionality as
.Fn ctermid
except that if
diff --git a/lib/libc/gen/devname.3 b/lib/libc/gen/devname.3
index fef7674..f3c6988 100644
--- a/lib/libc/gen/devname.3
+++ b/lib/libc/gen/devname.3
@@ -78,7 +78,7 @@ in a human-readable format.
.Sh HISTORY
The
.Fn devname
-function call appeared in
+function appeared in
.Bx 4.4 .
.Sh BUGS
The
diff --git a/lib/libc/gen/directory.3 b/lib/libc/gen/directory.3
index cfe1439..ce1ead7 100644
--- a/lib/libc/gen/directory.3
+++ b/lib/libc/gen/directory.3
@@ -95,7 +95,9 @@ upon reaching the end of the directory or detecting an invalid
.Fn seekdir
operation.
.Pp
+The
.Fn readdir_r
+function
provides the same functionality as
.Fn readdir ,
but the caller must provide a directory
@@ -108,7 +110,9 @@ upon reaching the end of the directory
.Fa result
is set to
.Dv NULL .
+The
.Fn readdir_r
+function
returns 0 on success or an error number to indicate failure.
.Pp
The
diff --git a/lib/libc/gen/dirname.3 b/lib/libc/gen/dirname.3
index 624cf72..30d0be7 100644
--- a/lib/libc/gen/dirname.3
+++ b/lib/libc/gen/dirname.3
@@ -78,7 +78,9 @@ The path component to be returned was larger than
.Dv MAXPATHLEN .
.El
.Sh WARNINGS
+The
.Fn dirname
+function
returns a pointer to internal static storage space that will be overwritten
by subsequent calls (each function has its own separate storage).
.Pp
diff --git a/lib/libc/gen/dladdr.3 b/lib/libc/gen/dladdr.3
index 0e1ca5c..84ea1b5 100644
--- a/lib/libc/gen/dladdr.3
+++ b/lib/libc/gen/dladdr.3
@@ -38,7 +38,9 @@
.Ft int
.Fn dladdr "const void *addr" "Dl_info *info"
.Sh DESCRIPTION
-.Nm
+The
+.Fn dladdr
+function
queries the dynamic linker for information about the shared object
containing the address
.Fa addr .
@@ -67,13 +69,15 @@ The value of the symbol returned in
.Li dli_sname .
.El
.Pp
-.Nm
+The
+.Fn dladdr
+function
is available only in dynamically linked programs.
.Sh ERRORS
If a mapped shared object containing
.Fa addr
cannot be found,
-.Nm
+.Fn dladdr
returns 0.
In that case, a message detailing the failure can be retrieved by
calling
@@ -85,7 +89,7 @@ On success, a non-zero value is returned.
.Xr dlopen 3
.Sh HISTORY
The
-.Nm
+.Fn dladdr
function first appeared in the Solaris operating system.
.Sh BUGS
This implementation is bug-compatible with the Solaris
diff --git a/lib/libc/gen/dllockinit.3 b/lib/libc/gen/dllockinit.3
index 73cd38c..f117728 100644
--- a/lib/libc/gen/dllockinit.3
+++ b/lib/libc/gen/dllockinit.3
@@ -45,7 +45,7 @@ In current releases it still exists, but only as a stub which does nothing.
.Ef
.Pp
Threads packages can call
-.Nm
+.Fn dllockinit
at initialization time to register locking functions for the dynamic
linker to use. This enables the dynamic linker to prevent multiple
threads from entering its critical sections simultaneously.
@@ -58,7 +58,7 @@ dynamic linker will pass it to the
function when creating the locks it needs. When the dynamic linker
is permanently finished using the locking functions (e.g., if the
program makes a subsequent call to
-.Nm
+.Fn dllockinit
to register new locking functions) it will call
.Fa context_destroy
to destroy the context.
@@ -89,7 +89,7 @@ parameter specifies a function to destroy the context. It may be
if the context does not need to be destroyed.
.Pp
Until
-.Nm
+.Fn dllockinit
is called, the dynamic linker protects its critical sections using
a default locking mechanism which works by blocking the
.Dv SIGVTALRM ,
@@ -100,9 +100,9 @@ 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
-.Nm
+.Fn dllockinit
can restore the default locking by calling
-.Nm
+.Fn dllockinit
with all arguments
.Dv NULL .
.Sh SEE ALSO
@@ -110,6 +110,6 @@ with all arguments
.Xr signal 3
.Sh HISTORY
The
-.Nm
+.Fn dllockinit
function first appeared in
.Fx 4.0 .
diff --git a/lib/libc/gen/dlopen.3 b/lib/libc/gen/dlopen.3
index c1c09e4..ba37c6f 100644
--- a/lib/libc/gen/dlopen.3
+++ b/lib/libc/gen/dlopen.3
@@ -60,7 +60,9 @@ program's address space, to obtain the address bindings of symbols
defined by such
objects, and to remove such objects when their use is no longer required.
.Pp
+The
.Fn dlopen
+function
provides access to the shared object in
.Fa path ,
returning a descriptor that can be used for later
@@ -141,7 +143,9 @@ fails, it returns a null pointer, and sets an error condition which may
be interrogated with
.Fn dlerror .
.Pp
+The
.Fn dlsym
+function
returns the address binding of the symbol described in the null-terminated
character string
.Fa symbol ,
@@ -225,17 +229,23 @@ interface, below, should be used, since
.Fn getpid
is a function and not a data object.)
.Pp
+The
.Fn dlsym
+function
returns a null pointer if the symbol cannot be found, and sets an error
condition which may be queried with
.Fn dlerror .
.Pp
+The
.Fn dlfunc
+function
implements all of the behavior of
.Fn dlsym ,
but has a return type which can be cast to a function pointer without
triggering compiler diagnostics.
-.Fn ( dlsym
+(The
+.Fn dlsym
+function
returns a data pointer; in the C standard, conversions between
data and function pointer types are undefined.
Some compilers and
@@ -246,7 +256,9 @@ The precise return type of
is unspecified; applications must cast it to an appropriate function pointer
type.
.Pp
+The
.Fn dlerror
+function
returns a null-terminated character string describing the last error that
occurred during a call to
.Fn dlopen ,
@@ -266,7 +278,9 @@ to
where the second call follows the first immediately, the second call
will always return a null pointer.
.Pp
+The
.Fn dlclose
+function
deletes a reference to the shared object referenced by
.Fa handle .
If the reference count drops to 0, the object is removed from the
@@ -306,12 +320,16 @@ still the case when using the (obsolete)
.Fl aout
option to the C language compiler.
.Sh ERRORS
+The
.Fn dlopen ,
.Fn dlsym ,
and
.Fn dlfunc
+functions
return a null pointer in the event of errors.
+The
.Fn dlclose
+function
returns 0 on success, or -1 if an error occurred.
Whenever an error has been detected, a message detailing it can be
retrieved via a call to
diff --git a/lib/libc/gen/exec.3 b/lib/libc/gen/exec.3
index a3ef143..a17a7de 100644
--- a/lib/libc/gen/exec.3
+++ b/lib/libc/gen/exec.3
@@ -203,11 +203,13 @@ will be set to indicate the error.
The shell.
.El
.Sh ERRORS
-.Fn Execl ,
+The
+.Fn execl ,
.Fn execle ,
.Fn execlp
and
.Fn execvp
+functions
may fail and set
.Va errno
for any of the errors specified for the library functions
@@ -215,9 +217,11 @@ for any of the errors specified for the library functions
and
.Xr malloc 3 .
.Pp
-.Fn Exect
+The
+.Fn exect
and
.Fn execv
+functions
may fail and set
.Va errno
for any of the errors specified for the library function
@@ -286,11 +290,13 @@ and the unusual error
The behaviour was changed to match the behaviour of
.Xr sh 1 .
.Sh STANDARDS
-.Fn Execl ,
+The
+.Fn execl ,
.Fn execv ,
.Fn execle ,
.Fn execlp
and
.Fn execvp
+functions
conform to
.St -p1003.1-88 .
diff --git a/lib/libc/gen/fnmatch.3 b/lib/libc/gen/fnmatch.3
index a6a8b02..004b31f 100644
--- a/lib/libc/gen/fnmatch.3
+++ b/lib/libc/gen/fnmatch.3
@@ -110,7 +110,7 @@ leading
if it immediately follows a slash.
.It Dv FNM_LEADING_DIR
Ignore
-.Nm /*
+.Dq Li /*
rest after successful
.Fa pattern
matching.
diff --git a/lib/libc/gen/getbootfile.3 b/lib/libc/gen/getbootfile.3
index 6cde6ad..4ceaf66 100644
--- a/lib/libc/gen/getbootfile.3
+++ b/lib/libc/gen/getbootfile.3
@@ -68,5 +68,5 @@ is returned instead of the real boot file.
.Sh HISTORY
The
.Fn getbootfile
-function call appeared in
+function appeared in
.Fx 2.0 .
diff --git a/lib/libc/gen/getdomainname.3 b/lib/libc/gen/getdomainname.3
index 0c3bee4..7fd3d48 100644
--- a/lib/libc/gen/getdomainname.3
+++ b/lib/libc/gen/getdomainname.3
@@ -48,7 +48,9 @@
.Ft int
.Fn setdomainname "const char *name" "int namelen"
.Sh DESCRIPTION
-.Fn Getdomainname
+The
+.Fn getdomainname
+function
returns the standard domain name for the current processor, as
previously set by
.Fn setdomainname .
@@ -59,7 +61,9 @@ specifies the size of the
array. The returned name is null-terminated unless insufficient
space is provided.
.Pp
-.Fn Setdomainname
+The
+.Fn setdomainname
+function
sets the domain name of the host machine to be
.Fa name ,
which has length
@@ -94,5 +98,5 @@ characters, currently 256.
.Sh HISTORY
The
.Fn getdomainname
-function call appeared in
+function appeared in
.Bx 4.2 .
diff --git a/lib/libc/gen/getgrent.3 b/lib/libc/gen/getgrent.3
index b42f68e..56ef46a 100644
--- a/lib/libc/gen/getgrent.3
+++ b/lib/libc/gen/getgrent.3
@@ -196,7 +196,9 @@ and
.Fn setgrent
are fairly useless in a networked environment and should be
avoided, if possible.
+The
.Fn getgrent
+function
makes no attempt to suppress duplicate information if multiple
sources are specified in
.Xr nsswitch.conf 5 .
diff --git a/lib/libc/gen/gethostname.3 b/lib/libc/gen/gethostname.3
index 7c0275d..c8cd1cb 100644
--- a/lib/libc/gen/gethostname.3
+++ b/lib/libc/gen/gethostname.3
@@ -48,7 +48,9 @@
.Ft int
.Fn sethostname "const char *name" "int namelen"
.Sh DESCRIPTION
-.Fn Gethostname
+The
+.Fn gethostname
+function
returns the standard host name for the current processor, as
previously set by
.Fn sethostname .
@@ -59,7 +61,9 @@ specifies the size of the
array. The returned name is null-terminated unless insufficient
space is provided.
.Pp
-.Fn Sethostname
+The
+.Fn sethostname
+function
sets the name of the host machine to be
.Fa name ,
which has length
@@ -95,5 +99,5 @@ This includes the trailing
.Sh HISTORY
The
.Fn gethostname
-function call appeared in
+function appeared in
.Bx 4.2 .
diff --git a/lib/libc/gen/getnetgrent.3 b/lib/libc/gen/getnetgrent.3
index 689aeb7..91d0dd3 100644
--- a/lib/libc/gen/getnetgrent.3
+++ b/lib/libc/gen/getnetgrent.3
@@ -85,7 +85,9 @@ If
is called with a different netgroup than the previous call, an implicit
.Fn endnetgrent
is implied.
-.Fn Setnetgrent
+The
+.Fn setnetgrent
+function
also sets the offset to the first member of the netgroup.
.Pp
The function
diff --git a/lib/libc/gen/getobjformat.3 b/lib/libc/gen/getobjformat.3
index c9fd9b0..f3c1573 100644
--- a/lib/libc/gen/getobjformat.3
+++ b/lib/libc/gen/getobjformat.3
@@ -37,7 +37,9 @@
.Ft int
.Fn getobjformat "char *buf" "size_t bufsize" "int *argcp" "char **argv"
.Sh DESCRIPTION
+The
.Fn getobjformat
+function
queries several sources to determine the preferred object file
format, and copies its name into a buffer provided by the caller.
.Pp
diff --git a/lib/libc/gen/getpagesize.3 b/lib/libc/gen/getpagesize.3
index cc2fbf0..5848e89 100644
--- a/lib/libc/gen/getpagesize.3
+++ b/lib/libc/gen/getpagesize.3
@@ -45,7 +45,9 @@
.Ft int
.Fn getpagesize void
.Sh DESCRIPTION
-.Fn Getpagesize
+The
+.Fn getpagesize
+function
returns the number of bytes in a page.
Page granularity is the granularity of many of the memory
management calls.
@@ -59,5 +61,5 @@ hardware page size.
.Sh HISTORY
The
.Fn getpagesze
-function call appeared in
+function appeared in
.Bx 4.2 .
diff --git a/lib/libc/gen/getpeereid.3 b/lib/libc/gen/getpeereid.3
index 7b20e55..12999e5 100644
--- a/lib/libc/gen/getpeereid.3
+++ b/lib/libc/gen/getpeereid.3
@@ -95,7 +95,9 @@ socket option.
.Sh RETURN VALUES
.Rv -std getpeereid
.Sh ERRORS
+The
.Fn getpeereid
+function
fails if:
.Bl -tag -width Er
.It Bq Er EBADF
diff --git a/lib/libc/gen/getpwent.3 b/lib/libc/gen/getpwent.3
index 8d8fd6e..ec0e2b7 100644
--- a/lib/libc/gen/getpwent.3
+++ b/lib/libc/gen/getpwent.3
@@ -212,7 +212,9 @@ and
.Fn setpwent
are fairly useless in a networked environment and should be
avoided, if possible.
+The
.Fn getpwent
+function
makes no attempt to suppress duplicate information if multiple
sources are specified in
.Xr nsswitch.conf 5 .
diff --git a/lib/libc/gen/getvfsent.3 b/lib/libc/gen/getvfsent.3
index 0fa9bd1..89d52e7 100644
--- a/lib/libc/gen/getvfsent.3
+++ b/lib/libc/gen/getvfsent.3
@@ -114,10 +114,14 @@ loaded, or non-zero otherwise. It should only be called in the
following circumstances:
.Bl -enum
.It
+The
.Fn getvfsbyname
+function
has been called and returned a non-zero value.
.It
+The
.Fn vfsisloadable
+function
has been called and returned a non-zero value.
.El
.Pp
diff --git a/lib/libc/gen/lockf.3 b/lib/libc/gen/lockf.3
index c728320..abb00ac 100644
--- a/lib/libc/gen/lockf.3
+++ b/lib/libc/gen/lockf.3
@@ -171,6 +171,7 @@ locked region is unlocked would cause a deadlock and fails with an
.Er EDEADLK
error.
.Pp
+The
.Fn lockf ,
.Xr fcntl 2
and
@@ -182,7 +183,9 @@ Blocking on a section is interrupted by any signal.
.Rv -std lockf
In the case of a failure, existing locks are not changed.
.Sh ERRORS
+The
.Fn lockf
+function
will fail if:
.Bl -tag -width Er
.It Bq Er EAGAIN
diff --git a/lib/libc/gen/makecontext.3 b/lib/libc/gen/makecontext.3
index ff56cbb..0419853 100644
--- a/lib/libc/gen/makecontext.3
+++ b/lib/libc/gen/makecontext.3
@@ -54,7 +54,9 @@
.Ft int
.Fn swapcontext "ucontext_t *oucp" "const ucontext_t *ucp"
.Sh DESCRIPTION
+The
.Fn makecontext
+function
modifies the user thread context pointed to by
.Fa ucp ,
which must have previously been initialized by a call to
@@ -83,7 +85,9 @@ otherwise,
.Fn setcontext "ucp->uc_link"
is implicitly invoked.
.Pp
+The
.Fn swapcontext
+function
saves the current thread context in
.Fa "*oucp"
and makes
@@ -97,7 +101,9 @@ otherwise \-1 is returned and the global variable
.Va errno
is set appropriately.
.Sh ERRORS
+The
.Fn swapcontext
+function
will fail if:
.Bl -tag -width Er
.It Bq Er ENOMEM
diff --git a/lib/libc/gen/msgctl.3 b/lib/libc/gen/msgctl.3
index cde3234..45db2b9 100644
--- a/lib/libc/gen/msgctl.3
+++ b/lib/libc/gen/msgctl.3
@@ -168,7 +168,9 @@ or
.Sh RETURN VALUES
.Rv -std msgctl
.Sh ERRORS
+The
.Fn msgctl
+function
will fail if:
.Bl -tag -width Er
.It Bq Er EPERM
diff --git a/lib/libc/gen/msgget.3 b/lib/libc/gen/msgget.3
index 80f8da6..e257c60 100644
--- a/lib/libc/gen/msgget.3
+++ b/lib/libc/gen/msgget.3
@@ -46,7 +46,9 @@
.Ft int
.Fn msgget "key_t key" "int msgflg"
.Sh DESCRIPTION
+The
.Fn msgget
+function
returns the message queue identifier associated with
.Fa key .
A message queue identifier is a unique integer greater than zero.
diff --git a/lib/libc/gen/msgrcv.3 b/lib/libc/gen/msgrcv.3
index 76feaf0..2985761 100644
--- a/lib/libc/gen/msgrcv.3
+++ b/lib/libc/gen/msgrcv.3
@@ -159,7 +159,9 @@ Otherwise, -1 is returned, and
.Va errno
set to indicate the error.
.Sh ERRORS
+The
.Fn msgrcv
+function
will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
diff --git a/lib/libc/gen/msgsnd.3 b/lib/libc/gen/msgsnd.3
index aa25319..70ed45a 100644
--- a/lib/libc/gen/msgsnd.3
+++ b/lib/libc/gen/msgsnd.3
@@ -123,7 +123,9 @@ is set to the current time.
.Sh RETURN VALUES
.Rv -std msgsnd
.Sh ERRORS
+The
.Fn msgsnd
+function
will fail if:
.Bl -tag -width Er
.It Bq Er EINVAL
diff --git a/lib/libc/gen/pselect.3 b/lib/libc/gen/pselect.3
index 27c0b02..a56a0a8 100644
--- a/lib/libc/gen/pselect.3
+++ b/lib/libc/gen/pselect.3
@@ -117,11 +117,11 @@ function conforms to
.St -p1003.1-2001 .
.Sh HISTORY
The
-.Nm
+.Fn pselect
function first appeared in
.Fx 5.0 .
.Sh AUTHORS
The
-.Nm
+.Fn pselect
function and this manual page were written by
.An Garrett Wollman Aq wollman@FreeBSD.org .
diff --git a/lib/libc/gen/rand48.3 b/lib/libc/gen/rand48.3
index 1e16cbc..0fe766a 100644
--- a/lib/libc/gen/rand48.3
+++ b/lib/libc/gen/rand48.3
@@ -65,33 +65,41 @@ r(n) is called the seed of the random number generator.
For all the six generator routines described next, the first
computational step is to perform a single iteration of the algorithm.
.Pp
+The
.Fn drand48
and
.Fn erand48
+functions
return values of type double.
The full 48 bits of r(n+1) are
loaded into the mantissa of the returned value, with the exponent set
such that the values produced lie in the interval [0.0, 1.0).
.Pp
+The
.Fn lrand48
and
.Fn nrand48
+functions
return values of type long in the range
[0, 2**31-1]. The high-order (31) bits of
r(n+1) are loaded into the lower bits of the returned value, with
the topmost (sign) bit set to zero.
.Pp
+The
.Fn mrand48
and
.Fn jrand48
+functions
return values of type long in the range
[-2**31, 2**31-1]. The high-order (32) bits of
r(n+1) are loaded into the returned value.
.Pp
+The
.Fn drand48 ,
.Fn lrand48 ,
and
.Fn mrand48
+functions
use an internal buffer to store r(n). For these functions
the initial value of r(0) = 0x1234abcd330e = 20017429951246.
.Pp
@@ -106,7 +114,9 @@ holds the least significant bits.
.Pp
All functions share the same multiplicand and addend.
.Pp
+The
.Fn srand48
+function
is used to initialize the internal buffer r(n) of
.Fn drand48 ,
.Fn lrand48 ,
@@ -117,7 +127,9 @@ of r(n), with the lower 16 bits of r(n) arbitrarily being set to 0x330e.
Additionally, the constant multiplicand and addend of the algorithm are
reset to the default values given above.
.Pp
+The
.Fn seed48
+function
also initializes the internal buffer r(n) of
.Fn drand48 ,
.Fn lrand48 ,
@@ -128,7 +140,9 @@ where the zeroth member specifies the lowest bits.
Again,
the constant multiplicand and addend of the algorithm are
reset to the default values given above.
+The
.Fn seed48
+function
returns a pointer to an array of 3 shorts which contains the old seed.
This array is statically allocated, thus its contents are lost after
each new call to
diff --git a/lib/libc/gen/readpassphrase.3 b/lib/libc/gen/readpassphrase.3
index cfa6cf0..699c1a7 100644
--- a/lib/libc/gen/readpassphrase.3
+++ b/lib/libc/gen/readpassphrase.3
@@ -60,7 +60,9 @@ are read into the provided buffer
Any additional
characters and the terminating newline (or return) character are discarded.
.Pp
+The
.Fn readpassphrase
+function
takes the following optional
.Fa flags :
.Pp
@@ -137,7 +139,9 @@ if (compare(transform(passbuf), epass) != 0)
memset(passbuf, 0, sizeof(passbuf));
.Ed
.Sh SIGNALS
+The
.Fn readpassphrase
+function
will catch the following signals:
.Pp
.Bl -tag -compact
diff --git a/lib/libc/gen/rfork_thread.3 b/lib/libc/gen/rfork_thread.3
index 73a35c2..56e01a0 100644
--- a/lib/libc/gen/rfork_thread.3
+++ b/lib/libc/gen/rfork_thread.3
@@ -38,7 +38,9 @@
.Ft int
.Fn rfork_thread "int flags" "void *stack" "int (*func)(void *arg)" "void *arg"
.Sh DESCRIPTION
+The
.Fn rfork_thread
+function
is a helper function for
.Xr rfork 2 .
It arranges for a new process to be created and the child process will
@@ -73,5 +75,5 @@ for error return codes.
.Sh HISTORY
The
.Fn rfork_thread
-function call first appeared in
+function first appeared in
.Fx 4.3 .
diff --git a/lib/libc/gen/setproctitle.3 b/lib/libc/gen/setproctitle.3
index 6789a26..a508441 100644
--- a/lib/libc/gen/setproctitle.3
+++ b/lib/libc/gen/setproctitle.3
@@ -65,7 +65,9 @@ setproctitle("talking to %s", inet_ntoa(addr));
.Xr kvm_getargv 3 ,
.Xr printf 3
.Sh STANDARDS
+The
.Fn setproctitle
+function
is implicitly non-standard. Other methods of causing the
.Xr ps 1
command line to change, including copying over the argv[0] string are
@@ -86,7 +88,9 @@ including
and
.Bsx .
.Sh HISTORY
+The
.Fn setproctitle
+function
first appeared in
.Fx 2.2 .
Other operating systems have
diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3
index 24b1c6b..393be6d 100644
--- a/lib/libc/gen/signal.3
+++ b/lib/libc/gen/signal.3
@@ -50,7 +50,7 @@
or in
.Fx Ns 's
equivalent but easier to read typedef'd version:
-.Ft typedef "void \*(lp*sig_t\*(rp \*(lpint\*(rp"
+.Ft typedef "void \*(lp*sig_t\*(rp \*(lpint\*(rp" ;
.Ft sig_t
.Fn signal "int sig" "sig_t func"
.Sh DESCRIPTION
@@ -211,7 +211,9 @@ Otherwise, SIG_ERR is returned and the global variable
.Va errno
is set to indicate the error.
.Sh ERRORS
-.Fn Signal
+The
+.Fn signal
+function
will fail and no action will take place if one of the
following occur:
.Bl -tag -width Er
diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3
index 69e611c..6ea38c3 100644
--- a/lib/libc/gen/sysctl.3
+++ b/lib/libc/gen/sysctl.3
@@ -233,18 +233,19 @@ Each time it runs,
gets the list of debugging variables from the kernel and
displays their current values.
The system defines twenty
-.Ns ( Va struct ctldebug )
+.Pq Vt "struct ctldebug"
variables named
-.Nm debug0
+.Va debug0
through
-.Nm debug19 .
+.Va debug19 .
They are declared as separate variables so that they can be
individually initialized at the location of their associated variable.
The loader prevents multiple use of the same variable by issuing errors
if a variable is initialized in more than one place.
For example, to export the variable
-.Nm dospecialcheck
+.Va dospecialcheck
as a debugging variable, the following declaration would be used:
+.Pp
.Bd -literal -offset indent -compact
int dospecialcheck = 1;
struct ctldebug debug5 = { "dospecialcheck", &dospecialcheck };
OpenPOWER on IntegriCloud