summaryrefslogtreecommitdiffstats
path: root/lib/libc/gen
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/gen')
-rw-r--r--lib/libc/gen/dlopen.32
-rw-r--r--lib/libc/gen/fts.32
-rw-r--r--lib/libc/gen/getcap.318
-rw-r--r--lib/libc/gen/getcwd.34
-rw-r--r--lib/libc/gen/getpwent.32
-rw-r--r--lib/libc/gen/glob.316
-rw-r--r--lib/libc/gen/msgget.32
-rw-r--r--lib/libc/gen/sysctl.324
-rw-r--r--lib/libc/gen/syslog.32
-rw-r--r--lib/libc/gen/tcsetattr.32
-rw-r--r--lib/libc/gen/ttyname.32
-rw-r--r--lib/libc/gen/tzset.320
-rw-r--r--lib/libc/gen/uname.34
-rw-r--r--lib/libc/gen/vis.32
14 files changed, 53 insertions, 49 deletions
diff --git a/lib/libc/gen/dlopen.3 b/lib/libc/gen/dlopen.3
index 634f160..f9c1084 100644
--- a/lib/libc/gen/dlopen.3
+++ b/lib/libc/gen/dlopen.3
@@ -36,7 +36,7 @@
.Os FreeBSD
.Dt DLOPEN 3
.Sh NAME
-.Nm dlopen, dlsym, dlerror, dlclose
+.Nm dlopen , dlsym , dlerror , dlclose
.Nd programmatic interface to the dynamic linker
.Sh LIBRARY
.Lb libc
diff --git a/lib/libc/gen/fts.3 b/lib/libc/gen/fts.3
index ccab5b6..b453ef0 100644
--- a/lib/libc/gen/fts.3
+++ b/lib/libc/gen/fts.3
@@ -341,7 +341,7 @@ are attempted.
The
.Fa fts_name
field is always
-.Dv NUL Ns -terminated.
+.Dv NUL Ns -terminated .
.Sh FTS_OPEN
The
.Fn fts_open
diff --git a/lib/libc/gen/getcap.3 b/lib/libc/gen/getcap.3
index 974cf7f..2d86caf 100644
--- a/lib/libc/gen/getcap.3
+++ b/lib/libc/gen/getcap.3
@@ -84,13 +84,13 @@ from the database specified by the
terminated file array
.Fa db_array
and returns a pointer to a
-.Xr malloc Ns \&'d
+.Xr malloc 3 Ns \&'d
copy of it in
.Fa buf .
The
.Fn cgetent
function will first look for files ending in
-.Nm .db
+.Pa .db
(see
.Xr cap_mkdb 1 )
before accessing the ASCII file.
@@ -103,7 +103,7 @@ must be retained through all subsequent calls to
and
.Fn cgetustr ,
but may then be
-.Xr free 3 Ns \&'d.
+.Xr free 3 Ns \&'d .
On success 0 is returned, 1 if the returned
record contains an unresolved
.Nm tc
@@ -200,7 +200,7 @@ from the capability record pointed to by
A pointer to a decoded,
.Dv NUL
terminated,
-.Xr malloc Ns \&'d
+.Xr malloc 3 Ns \&'d
copy of the string is returned in the
.Ft char *
pointed to by
@@ -241,7 +241,7 @@ or
call. If there is no such previous call, the first record in the database is
returned.
Each record is returned in a
-.Xr malloc Ns \&'d
+.Xr malloc 3 Ns \&'d
copy pointed to by
.Fa buf .
.Ic Tc
@@ -416,21 +416,27 @@ and
.Bl -column "nameXnumber"
.Sm off
.It Em name No \&# Em number Ta numeric
+.Sm on
capability
.Em name
has value
.Em number
+.Sm off
.It Em name No = Em string Ta "string capability"
+.Sm on
.Em name
has value
.Em string
+.Sm off
.It Em name No \&#@ Ta "the numeric capability"
+.Sm on
.Em name
does not exist
+.Sm off
.It Em name No \&=@ Ta "the string capability"
+.Sm on
.Em name
does not exist
-.Sm on
.El
.Pp
Numeric capability values may be given in one of three numeric bases.
diff --git a/lib/libc/gen/getcwd.3 b/lib/libc/gen/getcwd.3
index 27d37e6..4e08fab 100644
--- a/lib/libc/gen/getcwd.3
+++ b/lib/libc/gen/getcwd.3
@@ -66,7 +66,7 @@ is
.Dv NULL ,
space is allocated as necessary to store the pathname.
This space may later be
-.Xr free 3 Ns 'd.
+.Xr free 3 Ns 'd .
.Pp
The function
.Fn getwd
@@ -89,7 +89,7 @@ These routines have traditionally been used by programs to save the
name of a working directory for the purpose of returning to it.
A much faster and less error-prone method of accomplishing this is to
open the current directory
-.Pq Ql \&.
+.Pq Ql .\&
and use the
.Xr fchdir 2
function to return.
diff --git a/lib/libc/gen/getpwent.3 b/lib/libc/gen/getpwent.3
index 1e66b69..e41054c 100644
--- a/lib/libc/gen/getpwent.3
+++ b/lib/libc/gen/getpwent.3
@@ -178,7 +178,7 @@ The
.Fn getpwent ,
.Fn getpwnam ,
.Fn getpwuid ,
-.Fn setpwent,
+.Fn setpwent ,
and
.Fn endpwent
functions appeared in
diff --git a/lib/libc/gen/glob.3 b/lib/libc/gen/glob.3
index 4383994..760103b 100644
--- a/lib/libc/gen/glob.3
+++ b/lib/libc/gen/glob.3
@@ -269,7 +269,7 @@ is
.Pf non- Dv NULL ,
.Fn glob
calls
-.Fa (*errfunc)(path, errno) .
+.Fa \*(lp*errfunc\*(rp Ns ( Fa path , errno ) .
This may be unintuitive: a pattern like
.Ql */Makefile
will try to
@@ -374,7 +374,7 @@ An attempt to allocate memory failed.
The scan was stopped because an error was encountered and either
.Dv GLOB_ERR
was set or
-.Fa (*errfunc)()
+.Fa \*(lp*errfunc\*(rp\*(lp\*(rp
returned non-zero.
.El
.Pp
@@ -409,13 +409,13 @@ function is expected to be
.St -p1003.2
compatible with the exception
that the flags
-.Dv GLOB_ALTDIRFUNC,
-.Dv GLOB_BRACE
-.Dv GLOB_MAGCHAR,
-.Dv GLOB_NOMAGIC,
-.Dv GLOB_QUOTE,
+.Dv GLOB_ALTDIRFUNC ,
+.Dv GLOB_BRACE ,
+.Dv GLOB_MAGCHAR ,
+.Dv GLOB_NOMAGIC ,
+.Dv GLOB_QUOTE ,
and
-.Dv GLOB_TILDE,
+.Dv GLOB_TILDE ,
and the fields
.Fa gl_matchc
and
diff --git a/lib/libc/gen/msgget.3 b/lib/libc/gen/msgget.3
index 91a61e0..6d22141 100644
--- a/lib/libc/gen/msgget.3
+++ b/lib/libc/gen/msgget.3
@@ -60,7 +60,7 @@ or
does not have a message queue identifier associated with it, and the
.Dv IPC_CREAT
bit is set in
-.Fa msgflg.
+.Fa msgflg .
.Pp
If a new message queue is created, the data structure associated with it (the
.Va msqid_ds
diff --git a/lib/libc/gen/sysctl.3 b/lib/libc/gen/sysctl.3
index c4c39fd..82f1b74 100644
--- a/lib/libc/gen/sysctl.3
+++ b/lib/libc/gen/sysctl.3
@@ -186,7 +186,7 @@ The next and subsequent levels down are found in the include files
listed here, and described in separate sections below.
.Pp
.Bl -column CTLXMACHDEPXXX "Next level namesXXXXXX" -offset indent
-.It Sy Pa "Name Next level names Description"
+.It Sy "Name Next level names Description"
.It "CTL\_DEBUG sys/sysctl.h Debugging"
.It "CTL\_VFS sys/mount.h Filesystem"
.It "CTL\_HW sys/sysctl.h Generic CPU, I/O"
@@ -272,7 +272,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "Second level nameXXXXXX" integerXXX -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "HW\_MACHINE string no"
.It "HW\_MODEL string no"
.It "HW\_NCPU integer no"
@@ -318,7 +318,7 @@ system vnodes, the open file entries, routing table entries,
virtual memory statistics, load average history, and clock rate
information.
.Bl -column "KERNXMAXFILESPERPROCXXX" "struct clockrateXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "KERN\_ARGMAX integer no"
.It "KERN\_BOOTFILE string yes"
.It "KERN\_BOOTTIME struct timeval no"
@@ -424,7 +424,7 @@ structures is returned,
whose size depends on the current number of such objects in the system.
The third and fourth level names are as follows:
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
-.It Pa "Third level name Fourth level is:"
+.It "Third level name Fourth level is:"
.It "KERN\_PROC\_ALL None"
.It "KERN\_PROC\_PID A process ID"
.It "KERN\_PROC\_PGRP A process group"
@@ -439,7 +439,7 @@ follow each other.
The total size of array is returned.
It is also possible for a process to set its own process title this way.
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
-.It Pa "Third level name Fourth level is:"
+.It Sy "Third level name Fourth level is:"
.It "KERN\_PROC\_ARGS A process ID"
.El
.It Li KERN_PROF
@@ -453,7 +453,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "GPROFXGMONPARAMXXX" "struct gmonparamXXX" -offset indent
-.It Sy Pa "Third level name Type Changeable"
+.It Sy "Third level name Type Changeable"
.It "GPROF\_STATE integer yes"
.It "GPROF\_COUNT u_short[\|] yes"
.It "GPROF\_FROMS u_short[\|] yes"
@@ -503,7 +503,7 @@ followed by the vnode itself
The set of variables defined is architecture dependent.
The following variables are defined for the i386 architecture.
.Bl -column "CONSOLE_DEVICEXXX" "struct bootinfoXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It Li "CPU_CONSDEV dev_t no"
.It Li "CPU_ADJKERNTZ int yes"
.It Li "CPU_DISRTCSET int yes"
@@ -516,7 +516,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "Second level nameXXXXXX" "routing messagesXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "PF\_ROUTE routing messages no"
.It "PF\_INET IPv4 values yes"
.It "PF\_INET6 IPv6 values yes"
@@ -535,7 +535,7 @@ The fourth level name is an address family, which may be set to 0 to
select all address families.
The fifth and sixth level names are as follows:
.Bl -column "Fifth level nameXXXXXX" "Sixth level is:XXX" -offset indent
-.It Pa "Fifth level name Sixth level is:"
+.It Sy "Fifth level name Sixth level is:"
.It "NET\_RT\_FLAGS rtflags"
.It "NET\_RT\_DUMP None"
.It "NET\_RT\_IFLIST None"
@@ -547,7 +547,7 @@ The third level name is the protocol.
The fourth level name is the variable name.
The currently defined protocols and names are:
.Bl -column ProtocolXX VariableXX TypeXX ChangeableXX
-.It Pa "Protocol Variable Type Changeable"
+.It Sy "Protocol Variable Type Changeable"
.It "icmp bmcastecho integer yes"
.It "icmp maskrepl integer yes"
.It "ip forwarding integer yes"
@@ -598,7 +598,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "USER_COLL_WEIGHTS_MAXXXX" "integerXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "USER\_BC\_BASE\_MAX integer no"
.It "USER\_BC\_DIM\_MAX integer no"
.It "USER\_BC\_SCALE\_MAX integer no"
@@ -694,7 +694,7 @@ is detailed below.
The changeable column shows whether a process with appropriate
privilege may change the value.
.Bl -column "Second level nameXXXXXX" "struct loadavgXXX" -offset indent
-.It Sy Pa "Second level name Type Changeable"
+.It Sy "Second level name Type Changeable"
.It "VM\_LOADAVG struct loadavg no"
.It "VM\_METER struct vmtotal no"
.It "VM\_PAGEOUT\_ALGORITHM integer yes"
diff --git a/lib/libc/gen/syslog.3 b/lib/libc/gen/syslog.3
index 7ee51bb..e392a87 100644
--- a/lib/libc/gen/syslog.3
+++ b/lib/libc/gen/syslog.3
@@ -146,7 +146,7 @@ If
cannot pass the message to
.Xr syslogd 8
it will attempt to write the message to the console
-.Pq Dq Pa /dev/console.
+.Pq Dq Pa /dev/console .
.It Dv LOG_NDELAY
Open the connection to
.Xr syslogd 8
diff --git a/lib/libc/gen/tcsetattr.3 b/lib/libc/gen/tcsetattr.3
index d2bf500..58de728 100644
--- a/lib/libc/gen/tcsetattr.3
+++ b/lib/libc/gen/tcsetattr.3
@@ -184,7 +184,7 @@ The
.Fn cfmakeraw
function sets the flags stored in the termios structure to a state disabling
all input and output processing, giving a
-.Dq raw I/O path.
+.Dq raw I/O path .
It should be noted that there is no function to reverse this effect.
This is because there are a variety of processing options that could be
re-enabled and the correct method is for an application to snapshot the
diff --git a/lib/libc/gen/ttyname.3 b/lib/libc/gen/ttyname.3
index 5648c30..9141dfc 100644
--- a/lib/libc/gen/ttyname.3
+++ b/lib/libc/gen/ttyname.3
@@ -62,7 +62,7 @@ and named
.Pa /dev/tty Ns Em xx
and for which an entry exists
in the initialization file
-.Pa /etc/ttys.
+.Pa /etc/ttys .
(See
.Xr ttys 5 . )
.Pp
diff --git a/lib/libc/gen/tzset.3 b/lib/libc/gen/tzset.3
index d763e07..5ae5ec0 100644
--- a/lib/libc/gen/tzset.3
+++ b/lib/libc/gen/tzset.3
@@ -116,13 +116,11 @@ When
is used directly as a specification of the time conversion information,
it must have the following syntax (spaces inserted for clarity):
.Bd -filled -offset indent
-.Em std offset Bo
-.Em dst Bo
-.Em offset
-.Bc
+.Em std offset
.Bo
-.No , Em rule
-.Bc
+.Em dst
+.Bq Em offset
+.Bq , Em rule
.Bc
.Ed
.Pp
@@ -156,13 +154,13 @@ Indicates the value one must add to the local time to arrive at
Coordinated Universal Time. The
.Em offset
has the form:
-.Bd -unfilled -offset indent
+.Bd -ragged -offset indent
+.Sm off
.Em hh Bo
-.Pf \&: Em mm
-.Bo
-.Pf \&: Em ss
-.Bc
+.Em : mm
+.Bq Em : ss
.Bc
+.Sm on
.Ed
.Pp
The minutes
diff --git a/lib/libc/gen/uname.3 b/lib/libc/gen/uname.3
index 2c72472..0ad18d8 100644
--- a/lib/libc/gen/uname.3
+++ b/lib/libc/gen/uname.3
@@ -52,9 +52,9 @@ the current system into the structure referenced by
.Fa name .
.Pp
The
-.Li utsname
+.Vt utsname
structure is defined in the
-.Li <sys/utsname.h>
+.Aq Pa sys/utsname.h
header file, and contains the following members:
.Bl -tag -width nodenameXXXX -offset indent
.It sysname
diff --git a/lib/libc/gen/vis.3 b/lib/libc/gen/vis.3
index 118941b..105e1f9 100644
--- a/lib/libc/gen/vis.3
+++ b/lib/libc/gen/vis.3
@@ -100,7 +100,7 @@ characters from
.Fa src
(this
is useful for encoding a block of data that may contain
-.Dv NUL Ns 's).
+.Dv NUL Ns 's ) .
Both forms
.Dv NUL
terminate
OpenPOWER on IntegriCloud