aboutsummaryrefslogtreecommitdiff
path: root/lib/libc/sys
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/sys')
-rw-r--r--lib/libc/sys/aio_waitcomplete.22
-rw-r--r--lib/libc/sys/brk.24
-rw-r--r--lib/libc/sys/execve.22
-rw-r--r--lib/libc/sys/fcntl.220
-rw-r--r--lib/libc/sys/fhopen.22
-rw-r--r--lib/libc/sys/getdirentries.23
-rw-r--r--lib/libc/sys/getlogin.28
-rw-r--r--lib/libc/sys/getsockopt.23
-rw-r--r--lib/libc/sys/kill.22
-rw-r--r--lib/libc/sys/listen.210
-rw-r--r--lib/libc/sys/lseek.22
-rw-r--r--lib/libc/sys/ptrace.244
-rw-r--r--lib/libc/sys/recv.22
-rw-r--r--lib/libc/sys/semget.28
-rw-r--r--lib/libc/sys/shmget.28
-rw-r--r--lib/libc/sys/socket.22
16 files changed, 68 insertions, 54 deletions
diff --git a/lib/libc/sys/aio_waitcomplete.2 b/lib/libc/sys/aio_waitcomplete.2
index 0e586d547676..c554673a3e2c 100644
--- a/lib/libc/sys/aio_waitcomplete.2
+++ b/lib/libc/sys/aio_waitcomplete.2
@@ -35,7 +35,7 @@
.Sh SYNOPSIS
.Fd #include <aio.h>
.Ft int
-.Fn aio_waitcomplete "struct aiocb **iocbp, struct timespec *timeout"
+.Fn aio_waitcomplete "struct aiocb **iocbp" "struct timespec *timeout"
.Sh DESCRIPTION
The
.Fn aio_waitcomplete
diff --git a/lib/libc/sys/brk.2 b/lib/libc/sys/brk.2
index 09072a4e1565..7f40e3417a27 100644
--- a/lib/libc/sys/brk.2
+++ b/lib/libc/sys/brk.2
@@ -99,11 +99,11 @@ beyond the
value returned from a call to
.Xr getrlimit 2 ,
e.g.\&
-.Dq etext + rlp\(->rlim_max.
+.Dq Va etext No + Va rlp\->rlim_max .
(See
.Xr end 3
for the definition of
-.Em etext ) .
+.Va etext ) .
.Sh RETURN VALUES
.Fn Brk
returns 0 if successful;
diff --git a/lib/libc/sys/execve.2 b/lib/libc/sys/execve.2
index 04671181580d..32dd4d81ae75 100644
--- a/lib/libc/sys/execve.2
+++ b/lib/libc/sys/execve.2
@@ -105,7 +105,7 @@ The argument
is also a pointer to a null-terminated array of
character pointers to null-terminated strings.
A pointer to this array is normally stored in the global variable
-.Va environ.
+.Va environ .
These strings pass information to the
new process that is not directly an argument to the command (see
.Xr environ 7 ) .
diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2
index 49522c77c414..0b2ec8924d02 100644
--- a/lib/libc/sys/fcntl.2
+++ b/lib/libc/sys/fcntl.2
@@ -193,11 +193,11 @@ taken as a pointer to a
(see above).
.Dv F_SETLK
is used to establish shared (or read) locks
-.Dv (F_RDLCK)
+.Pq Dv F_RDLCK
or exclusive (or write) locks,
-.Dv (F_WRLCK) ,
+.Pq Dv F_WRLCK ,
as well as remove either type of lock
-.Dv (F_UNLCK) .
+.Pq Dv F_UNLCK .
If a shared or exclusive lock cannot be set,
.Fn fcntl
returns immediately with
@@ -392,11 +392,11 @@ The argument
is
.Dv F_SETLK ,
the type of lock
-.Fa (l_type)
+.Pq Fa l_type
is a shared lock
-.Dv (F_RDLCK)
+.Pq Dv F_RDLCK
or exclusive lock
-.Dv (F_WRLCK) ,
+.Pq Dv F_WRLCK ,
and the segment of a file to be locked is already
exclusive-locked by another process;
or the type is an exclusive lock and some portion of the
@@ -413,9 +413,9 @@ is
or
.Dv F_SETLKW ,
the type of lock
-.Fa (l_type)
+.Pq Fa l_type
is a shared lock
-.Dv (F_RDLCK) ,
+.Pq Dv F_RDLCK ,
and
.Fa fildes
is not a valid file descriptor open for reading.
@@ -427,9 +427,9 @@ is
or
.Dv F_SETLKW ,
the type of lock
-.Fa (l_type)
+.Pq Fa l_type
is an exclusive lock
-.Dv (F_WRLCK) ,
+.Pq Dv F_WRLCK ,
and
.Fa fildes
is not a valid file descriptor open for writing.
diff --git a/lib/libc/sys/fhopen.2 b/lib/libc/sys/fhopen.2
index 75af67f32357..dbe10a79275a 100644
--- a/lib/libc/sys/fhopen.2
+++ b/lib/libc/sys/fhopen.2
@@ -54,7 +54,7 @@
.Fn fhstatfs "const fhandle_t *fhp" "struct statfs *buf"
.Sh DESCRIPTION
These functions provide a means to access a file given the file handle
-.Fa fhp.
+.Fa fhp .
As this method bypasses directory access restrictions, these calls are
restricted to the superuser.
.Pp
diff --git a/lib/libc/sys/getdirentries.2 b/lib/libc/sys/getdirentries.2
index 4dab8a65f871..f883fec4cfe1 100644
--- a/lib/libc/sys/getdirentries.2
+++ b/lib/libc/sys/getdirentries.2
@@ -137,7 +137,8 @@ Alternatively, the current position pointer may be set and retrieved by
The current position pointer should only be set to a value returned by
.Xr lseek 2 ,
a value returned in the location pointed to by
-.Fa basep ( Ns Fn getdirentries
+.Fa basep
+.Pf ( Fn getdirentries
only)
or zero.
.Sh IMPLEMENTATION NOTES
diff --git a/lib/libc/sys/getlogin.2 b/lib/libc/sys/getlogin.2
index a631bfb3347b..4015da5b70d2 100644
--- a/lib/libc/sys/getlogin.2
+++ b/lib/libc/sys/getlogin.2
@@ -86,8 +86,8 @@ is normally used only when a new session is being created on behalf
of the named user
(for example, at login time, or when a remote shell is invoked).
.Pp
-.Em NOTE:
-There is only one `login name' per `session .
+.Em NOTE :
+There is only one login name per session.
.Pp
It is
.Em CRITICALLY
@@ -107,9 +107,9 @@ which is an ideal way of detaching from a controlling terminal and
forking into the background.
.Pp
In particular, doing a
-.Fn ioctl ttyfd TIOCNOTTY ...
+.Fn ioctl ttyfd TIOCNOTTY ...\&
or
-.Fn setpgrp ...
+.Fn setpgrp ...\&
is
.Em NOT
sufficient.
diff --git a/lib/libc/sys/getsockopt.2 b/lib/libc/sys/getsockopt.2
index dd6ae3a4a763..deb70b96d93c 100644
--- a/lib/libc/sys/getsockopt.2
+++ b/lib/libc/sys/getsockopt.2
@@ -191,7 +191,8 @@ are queued on socket and a
.Xr close 2
is performed.
If the socket promises reliable delivery of data and
-.Dv SO_LINGER is set,
+.Dv SO_LINGER
+is set,
the system will block the process on the
.Xr close 2
attempt until it is able to transmit the data or until it decides it
diff --git a/lib/libc/sys/kill.2 b/lib/libc/sys/kill.2
index 8ce5c71949d3..5a7c05cb355e 100644
--- a/lib/libc/sys/kill.2
+++ b/lib/libc/sys/kill.2
@@ -75,7 +75,7 @@ to any descendant of the current process.
.It \&If Fa pid No \&is greater than zero :
.Fa Sig
is sent to the process whose ID is equal to
-.Fa pid.
+.Fa pid .
.It \&If Fa pid No \&is zero :
.Fa Sig
is sent to all processes whose group ID is equal
diff --git a/lib/libc/sys/listen.2 b/lib/libc/sys/listen.2
index 11f8fd2db65d..3a98629bf13a 100644
--- a/lib/libc/sys/listen.2
+++ b/lib/libc/sys/listen.2
@@ -60,7 +60,7 @@ The
call applies only to sockets of type
.Dv SOCK_STREAM
or
-.Dv SOCK_SEQPACKET.
+.Dv SOCK_SEQPACKET .
.Pp
The
.Fa backlog
@@ -76,15 +76,15 @@ the request may be ignored so that retries may succeed.
The
.Xr sysctl 3
MIB variable
-.Dq Li kern.ipc.somaxconn
+.Dq Va kern.ipc.somaxconn
specifies a hard limit on
.Fa backlog ;
-if a value greater than
-.Li kern.ipc.somaxconn
+if a value greater than
+.Va kern.ipc.somaxconn
or less than zero is specified,
.Fa backlog
is silently forced to
-.Li kern.ipc.somaxconn .
+.Va kern.ipc.somaxconn .
.Sh IMPLEMENTATION NOTES
.Pp
In the non-threaded library
diff --git a/lib/libc/sys/lseek.2 b/lib/libc/sys/lseek.2
index 5ca26cbb135c..5cc0f222240b 100644
--- a/lib/libc/sys/lseek.2
+++ b/lib/libc/sys/lseek.2
@@ -53,7 +53,7 @@ to the
argument
.Fa offset
according to the directive
-.Fa whence.
+.Fa whence .
The argument
.Fa fildes
must be an open
diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2
index 708f9ac44058..c91b2d1a5cee 100644
--- a/lib/libc/sys/ptrace.2
+++ b/lib/libc/sys/ptrace.2
@@ -54,9 +54,7 @@ that the process expects to be traced by its parent. All the other
arguments are ignored. (If the parent process does not expect to trace
the child, it will probably be rather confused by the results; once the
traced process stops, it cannot be made to continue except via
-.Eo \&
-.Fn ptrace
-.Ec \&.)
+.Fn ptrace . )
When a process has used this request and calls
.Xr execve 2
or any of the routines built on it
@@ -69,7 +67,7 @@ Also, any setuid or setgid bits on the executable being executed will
be ignored.
.It Dv PT_READ_I , Dv PT_READ_D
These requests read a single
-.Li int
+.Vt int
of data from the traced process' address space. Traditionally,
.Fn ptrace
has allowed for machines with distinct address spaces for instruction
@@ -99,12 +97,12 @@ except that they write rather than read. The
argument supplies the value to be written.
.It Dv PT_READ_U
This request reads an
-.Li int
+.Vt int
from the traced process' user structure. The
.Fa addr
argument specifies the location of the int relative to the base of the
user structure; it will usually be an integer value cast to
-.Li caddr_t
+.Vt caddr_t
either explicitly or via the presence of a prototype for
.Eo \&
.Fn ptrace
@@ -115,14 +113,14 @@ and
.Dv PT_READ_D ,
.Fa addr
must be aligned on an
-.Li int
+.Vt int
boundary. The value read is returned as the return value from
.Eo \&
.Fn ptrace
.Ec .
.It Dv PT_WRITE_U
This request writes an
-.Li int
+.Vt int
into the traced process' user structure.
.Fa addr
specifies the offset, just as for
@@ -138,7 +136,9 @@ The traced process continues execution.
.Fa addr
is an address specifying the place where execution is to be resumed (a
new value for the program counter), or
-.Li (caddr_t)1
+.Po
+.Vt caddr_t
+.Pc Ns 1
to indicate that execution is to pick up where it left off.
.Fa data
provides a signal number to be delivered to the traced process as it
@@ -180,7 +180,9 @@ are:
.Bl -tag -width 12n
.It Dv PT_GETREGS
This request reads the traced process' machine registers into the
-.Dq Li "struct reg"
+.Do
+.Vt "struct reg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -189,7 +191,9 @@ pointed to by
This request is the converse of
.Dv PT_GETREGS ;
it loads the traced process' machine registers from the
-.Dq Li "struct reg"
+.Do
+.Vt "struct reg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -197,7 +201,9 @@ pointed to by
.It Dv PT_GETFPREGS
This request reads the traced process' floating-point registers into
the
-.Dq Li "struct fpreg"
+.Do
+.Vt "struct fpreg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -206,7 +212,9 @@ pointed to by
This request is the converse of
.Dv PT_GETFPREGS ;
it loads the traced process' floating-point registers from the
-.Dq Li "struct fpreg"
+.Do
+.Vt "struct fpreg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -214,7 +222,9 @@ pointed to by
.It Dv PT_GETDBREGS
This request reads the traced process' debug registers into
the
-.Dq Li "struct dbreg"
+.Do
+.Vt "struct dbreg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -223,7 +233,9 @@ pointed to by
This request is the converse of
.Dv PT_GETDBREGS ;
it loads the traced process' debug registers from the
-.Dq Li "struct dbreg"
+.Do
+.Vt "struct dbreg"
+.Dc
(defined in
.Aq Pa machine/reg.h )
pointed to by
@@ -265,7 +277,7 @@ to
or
.Dv PT_WRITE_U
was not
-.Li int Ns \&-aligned.
+.Vt int Ns \-aligned .
.It
The signal number (in
.Fa data )
diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2
index 88d7a4a3e2de..1c543fd9475f 100644
--- a/lib/libc/sys/recv.2
+++ b/lib/libc/sys/recv.2
@@ -210,7 +210,7 @@ Process credentials can also be passed as ancillary data for
domain sockets using a
.Fa cmsg_type
of
-.Dv SCM_CREDS.
+.Dv SCM_CREDS .
In this case,
.Fa cmsg_data
should be a structure of type
diff --git a/lib/libc/sys/semget.2 b/lib/libc/sys/semget.2
index cdcd9644801a..dc22c0ac272f 100644
--- a/lib/libc/sys/semget.2
+++ b/lib/libc/sys/semget.2
@@ -84,13 +84,13 @@ parameter:
Read access for user.
.It Dv SEM_A
Alter access for user.
-.It Dv (SEM_R>>3)
+.It Dv ( SEM_R>>3 )
Read access for group.
-.It Dv (SEM_A>>3)
+.It Dv ( SEM_A>>3 )
Alter access for group.
-.It Dv (SEM_R>>6)
+.It Dv ( SEM_R>>6 )
Read access for other.
-.It Dv (SEM_A>>6)
+.It Dv ( SEM_A>>6 )
Alter access for other.
.El
.Pp
diff --git a/lib/libc/sys/shmget.2 b/lib/libc/sys/shmget.2
index 88d3b4a4f582..05bc68cf66fe 100644
--- a/lib/libc/sys/shmget.2
+++ b/lib/libc/sys/shmget.2
@@ -82,13 +82,13 @@ parameter:
Read access for user.
.It Dv SHM_W
Write access for user.
-.It Dv (SHM_R>>3)
+.It Dv ( SHM_R>>3 )
Read access for group.
-.It Dv (SHM_W>>3)
+.It Dv ( SHM_W>>3 )
Write access for group.
-.It Dv (SHM_R>>6)
+.It Dv ( SHM_R>>6 )
Read access for other.
-.It Dv (SHM_W>>6)
+.It Dv ( SHM_W>>6 )
Write access for other.
.El
.\"
diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2
index 1cf4616b627e..7049bc102a7c 100644
--- a/lib/libc/sys/socket.2
+++ b/lib/libc/sys/socket.2
@@ -168,7 +168,7 @@ and
calls.
(Some protocol families, such as the Internet family,
support the notion of an
-.Dq implied connect,
+.Dq implied connect ,
which permits data to be sent piggybacked onto a connect operation by
using the
.Xr sendto 2
generated by cgit v1.2.3 (git 2.25.1) at 2025-03-15 09:00:50 +0000