libc: Fix most issues reported by mandoc
- varios "new sentence, new line" warnings - varios "sections out of conventional order" warnings - varios "unusual Xr order" warnings - varios "missing section argument" warnings - varios "no blank before trailing delimiter" warnings - varios "normalizing date format" warnings MFC after: 1 month
This commit is contained in:
parent
a652079615
commit
f6d234d870
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=368817
@ -157,6 +157,15 @@ if the given combination of
|
|||||||
and
|
and
|
||||||
.Fa locale
|
.Fa locale
|
||||||
makes no sense.
|
makes no sense.
|
||||||
|
.Sh FILES
|
||||||
|
.Bl -tag -width /usr/share/locale/locale/category -compact
|
||||||
|
.It Pa $PATH_LOCALE/ Ns Em locale/category
|
||||||
|
.It Pa /usr/share/locale/ Ns Em locale/category
|
||||||
|
locale file for the locale
|
||||||
|
.Em locale
|
||||||
|
and the category
|
||||||
|
.Em category .
|
||||||
|
.El
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
The following code illustrates how a program can initialize the
|
The following code illustrates how a program can initialize the
|
||||||
international environment for one language, while selectively
|
international environment for one language, while selectively
|
||||||
@ -176,15 +185,6 @@ following manner before using any of the locale-specific information:
|
|||||||
.Bd -literal
|
.Bd -literal
|
||||||
setlocale(LC_ALL, "");
|
setlocale(LC_ALL, "");
|
||||||
.Ed
|
.Ed
|
||||||
.Sh FILES
|
|
||||||
.Bl -tag -width /usr/share/locale/locale/category -compact
|
|
||||||
.It Pa $PATH_LOCALE/ Ns Em locale/category
|
|
||||||
.It Pa /usr/share/locale/ Ns Em locale/category
|
|
||||||
locale file for the locale
|
|
||||||
.Em locale
|
|
||||||
and the category
|
|
||||||
.Em category .
|
|
||||||
.El
|
|
||||||
.Sh ERRORS
|
.Sh ERRORS
|
||||||
No errors are defined.
|
No errors are defined.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
|
@ -303,7 +303,26 @@ for example, a mail-forwarder may be registered for this domain.
|
|||||||
.Xr hosts 5 ,
|
.Xr hosts 5 ,
|
||||||
.Xr hostname 7 ,
|
.Xr hostname 7 ,
|
||||||
.Xr named 8
|
.Xr named 8
|
||||||
.Sh CAVEAT
|
.Sh HISTORY
|
||||||
|
The
|
||||||
|
.Fn herror
|
||||||
|
function appeared in
|
||||||
|
.Bx 4.3 .
|
||||||
|
The
|
||||||
|
.Fn endhostent ,
|
||||||
|
.Fn gethostbyaddr ,
|
||||||
|
.Fn gethostbyname ,
|
||||||
|
.Fn gethostent ,
|
||||||
|
and
|
||||||
|
.Fn sethostent
|
||||||
|
functions appeared in
|
||||||
|
.Bx 4.2 .
|
||||||
|
The
|
||||||
|
.Fn gethostbyname2
|
||||||
|
function first appeared in
|
||||||
|
.Tn BIND
|
||||||
|
version 4.9.4.
|
||||||
|
.Sh CAVEATS
|
||||||
The
|
The
|
||||||
.Fn gethostent
|
.Fn gethostent
|
||||||
function
|
function
|
||||||
@ -343,25 +362,6 @@ The
|
|||||||
.Fn endhostent
|
.Fn endhostent
|
||||||
function
|
function
|
||||||
closes the file.
|
closes the file.
|
||||||
.Sh HISTORY
|
|
||||||
The
|
|
||||||
.Fn herror
|
|
||||||
function appeared in
|
|
||||||
.Bx 4.3 .
|
|
||||||
The
|
|
||||||
.Fn endhostent ,
|
|
||||||
.Fn gethostbyaddr ,
|
|
||||||
.Fn gethostbyname ,
|
|
||||||
.Fn gethostent ,
|
|
||||||
and
|
|
||||||
.Fn sethostent
|
|
||||||
functions appeared in
|
|
||||||
.Bx 4.2 .
|
|
||||||
The
|
|
||||||
.Fn gethostbyname2
|
|
||||||
function first appeared in
|
|
||||||
.Tn BIND
|
|
||||||
version 4.9.4.
|
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
These functions use a thread-specific data storage;
|
These functions use a thread-specific data storage;
|
||||||
if the data is needed for future use, it should be
|
if the data is needed for future use, it should be
|
||||||
|
@ -108,4 +108,4 @@ because all meta-characters supported by
|
|||||||
would be honored.
|
would be honored.
|
||||||
User supplied parameters should always be carefully santized
|
User supplied parameters should always be carefully santized
|
||||||
before they appear in
|
before they appear in
|
||||||
.Fa string.
|
.Fa string .
|
||||||
|
@ -1180,7 +1180,7 @@ request:
|
|||||||
.It Dv UMTX_SHM_CREAT
|
.It Dv UMTX_SHM_CREAT
|
||||||
Creates the anonymous shared memory object, which can be looked up
|
Creates the anonymous shared memory object, which can be looked up
|
||||||
with the specified key
|
with the specified key
|
||||||
.Fa uaddr.
|
.Fa uaddr .
|
||||||
If the object associated with the
|
If the object associated with the
|
||||||
.Fa uaddr
|
.Fa uaddr
|
||||||
key already exists, it is returned instead of creating a new object.
|
key already exists, it is returned instead of creating a new object.
|
||||||
@ -1198,7 +1198,7 @@ the specified key
|
|||||||
an error is returned, and no new object is created.
|
an error is returned, and no new object is created.
|
||||||
.It Dv UMTX_SHM_DESTROY
|
.It Dv UMTX_SHM_DESTROY
|
||||||
De-associate the shared object with the specified key
|
De-associate the shared object with the specified key
|
||||||
.Fa uaddr.
|
.Fa uaddr .
|
||||||
The object is destroyed after the last open file descriptor is closed
|
The object is destroyed after the last open file descriptor is closed
|
||||||
and the last mapping for it is destroyed.
|
and the last mapping for it is destroyed.
|
||||||
.It Dv UMTX_SHM_ALIVE
|
.It Dv UMTX_SHM_ALIVE
|
||||||
|
@ -117,7 +117,6 @@ with
|
|||||||
.Dv SEEK_DATA
|
.Dv SEEK_DATA
|
||||||
arguments and this system call for the
|
arguments and this system call for the
|
||||||
data ranges found.
|
data ranges found.
|
||||||
.Pp
|
|
||||||
.Sh RETURN VALUES
|
.Sh RETURN VALUES
|
||||||
If it succeeds, the call returns the number of bytes copied, which can be fewer
|
If it succeeds, the call returns the number of bytes copied, which can be fewer
|
||||||
than
|
than
|
||||||
@ -144,11 +143,9 @@ will fail if:
|
|||||||
.Bl -tag -width Er
|
.Bl -tag -width Er
|
||||||
.It Bq Er EBADF
|
.It Bq Er EBADF
|
||||||
If
|
If
|
||||||
.Fa
|
.Fa infd
|
||||||
infd
|
|
||||||
is not open for reading or
|
is not open for reading or
|
||||||
.Fa
|
.Fa outfd
|
||||||
outfd
|
|
||||||
is not open for writing, or opened for writing with
|
is not open for writing, or opened for writing with
|
||||||
.Dv O_APPEND ,
|
.Dv O_APPEND ,
|
||||||
or if
|
or if
|
||||||
@ -175,8 +172,7 @@ are reset to the initial values for the system call.
|
|||||||
and
|
and
|
||||||
.Fa outfd
|
.Fa outfd
|
||||||
refer to the same file and the byte ranges overlap or
|
refer to the same file and the byte ranges overlap or
|
||||||
.Fa
|
.Fa flags
|
||||||
flags
|
|
||||||
is not zero.
|
is not zero.
|
||||||
.It Bq Er EIO
|
.It Bq Er EIO
|
||||||
An I/O error occurred while reading/writing the files.
|
An I/O error occurred while reading/writing the files.
|
||||||
|
@ -348,7 +348,7 @@ system call conforms to The Open Group Extended API Set 2 specification.
|
|||||||
The
|
The
|
||||||
.Fn execve
|
.Fn execve
|
||||||
system call appeared in
|
system call appeared in
|
||||||
.At V7 .
|
.At v7 .
|
||||||
The
|
The
|
||||||
.Fn fexecve
|
.Fn fexecve
|
||||||
system call appeared in
|
system call appeared in
|
||||||
|
@ -272,6 +272,6 @@ is not
|
|||||||
nor a file descriptor associated with a directory.
|
nor a file descriptor associated with a directory.
|
||||||
.El
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr fhstat 2 ,
|
|
||||||
.Xr fhreadlink 2 ,
|
|
||||||
.Xr fhopen 2 ,
|
.Xr fhopen 2 ,
|
||||||
|
.Xr fhreadlink 2 ,
|
||||||
|
.Xr fhstat 2
|
||||||
|
@ -339,7 +339,7 @@ returns
|
|||||||
if any intermediate component of the specified relative path does not
|
if any intermediate component of the specified relative path does not
|
||||||
reside in the directory hierarchy beneath the topping directory.
|
reside in the directory hierarchy beneath the topping directory.
|
||||||
Comparing to
|
Comparing to
|
||||||
.Dv O_BENEATH,
|
.Dv O_BENEATH ,
|
||||||
absolute paths or even the temporal escape from beneath of the topping
|
absolute paths or even the temporal escape from beneath of the topping
|
||||||
directory is not allowed.
|
directory is not allowed.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -161,8 +161,8 @@ for
|
|||||||
.Xr fork 2 ,
|
.Xr fork 2 ,
|
||||||
.Xr fstat 2 ,
|
.Xr fstat 2 ,
|
||||||
.Xr kill 2 ,
|
.Xr kill 2 ,
|
||||||
.Xr poll 2 ,
|
|
||||||
.Xr kqueue 2 ,
|
.Xr kqueue 2 ,
|
||||||
|
.Xr poll 2 ,
|
||||||
.Xr wait4 2 ,
|
.Xr wait4 2 ,
|
||||||
.Xr capsicum 4 ,
|
.Xr capsicum 4 ,
|
||||||
.Xr procdesc 4
|
.Xr procdesc 4
|
||||||
|
@ -577,7 +577,7 @@ Only valid when
|
|||||||
or
|
or
|
||||||
.Dv PL_FLAG_SCX
|
.Dv PL_FLAG_SCX
|
||||||
is set in
|
is set in
|
||||||
.Va pl_flags.
|
.Va pl_flags .
|
||||||
.It Va pl_syscall_narg
|
.It Va pl_syscall_narg
|
||||||
The number of arguments passed to the current system call not counting
|
The number of arguments passed to the current system call not counting
|
||||||
the system call identifier.
|
the system call identifier.
|
||||||
@ -588,7 +588,7 @@ Only valid when
|
|||||||
or
|
or
|
||||||
.Dv PL_FLAG_SCX
|
.Dv PL_FLAG_SCX
|
||||||
is set in
|
is set in
|
||||||
.Va pl_flags.
|
.Va pl_flags .
|
||||||
.El
|
.El
|
||||||
.It Dv PT_GETNUMLWPS
|
.It Dv PT_GETNUMLWPS
|
||||||
This request returns the number of kernel threads associated with the
|
This request returns the number of kernel threads associated with the
|
||||||
@ -622,7 +622,7 @@ The
|
|||||||
and
|
and
|
||||||
.Fa data
|
.Fa data
|
||||||
arguments are used the same as for
|
arguments are used the same as for
|
||||||
.Dv PT_CONTINUE.
|
.Dv PT_CONTINUE .
|
||||||
.It Dv PT_TO_SCX
|
.It Dv PT_TO_SCX
|
||||||
This request will set the
|
This request will set the
|
||||||
.Dv PTRACE_SCX
|
.Dv PTRACE_SCX
|
||||||
@ -632,7 +632,7 @@ The
|
|||||||
and
|
and
|
||||||
.Fa data
|
.Fa data
|
||||||
arguments are used the same as for
|
arguments are used the same as for
|
||||||
.Dv PT_CONTINUE.
|
.Dv PT_CONTINUE .
|
||||||
.It Dv PT_SYSCALL
|
.It Dv PT_SYSCALL
|
||||||
This request will set the
|
This request will set the
|
||||||
.Dv PTRACE_SYSCALL
|
.Dv PTRACE_SYSCALL
|
||||||
@ -643,7 +643,7 @@ The
|
|||||||
and
|
and
|
||||||
.Fa data
|
.Fa data
|
||||||
arguments are used the same as for
|
arguments are used the same as for
|
||||||
.Dv PT_CONTINUE.
|
.Dv PT_CONTINUE .
|
||||||
.It Dv PT_GET_SC_ARGS
|
.It Dv PT_GET_SC_ARGS
|
||||||
For the thread which is stopped in either
|
For the thread which is stopped in either
|
||||||
.Dv PL_FLAG_SCE
|
.Dv PL_FLAG_SCE
|
||||||
@ -698,7 +698,6 @@ value.
|
|||||||
If the system call completed in an unusual fashion,
|
If the system call completed in an unusual fashion,
|
||||||
.Va sr_error
|
.Va sr_error
|
||||||
is set to a negative value:
|
is set to a negative value:
|
||||||
.Pp
|
|
||||||
.Bl -tag -width Dv EJUSTRETURN -compact
|
.Bl -tag -width Dv EJUSTRETURN -compact
|
||||||
.It Dv ERESTART
|
.It Dv ERESTART
|
||||||
System call will be restarted.
|
System call will be restarted.
|
||||||
@ -830,7 +829,6 @@ The
|
|||||||
.Fa data
|
.Fa data
|
||||||
argument is ignored.
|
argument is ignored.
|
||||||
.El
|
.El
|
||||||
.Pp
|
|
||||||
.Sh x86 MACHINE-SPECIFIC REQUESTS
|
.Sh x86 MACHINE-SPECIFIC REQUESTS
|
||||||
.Bl -tag -width "Dv PT_GETXSTATE_INFO"
|
.Bl -tag -width "Dv PT_GETXSTATE_INFO"
|
||||||
.It Dv PT_GETXMMREGS
|
.It Dv PT_GETXMMREGS
|
||||||
@ -860,7 +858,7 @@ machine instruction
|
|||||||
.Dv FXRSTOR .
|
.Dv FXRSTOR .
|
||||||
.Pp
|
.Pp
|
||||||
As with
|
As with
|
||||||
.Dv PT_GETXMMREGS,
|
.Dv PT_GETXMMREGS ,
|
||||||
this request is only valid for i386 programs.
|
this request is only valid for i386 programs.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
|
@ -31,7 +31,7 @@
|
|||||||
.\" @(#)revoke.2 8.1 (Berkeley) 6/4/93
|
.\" @(#)revoke.2 8.1 (Berkeley) 6/4/93
|
||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd Jan 25, 2016
|
.Dd January 25, 2016
|
||||||
.Dt REVOKE 2
|
.Dt REVOKE 2
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
|
@ -135,7 +135,10 @@ field ranges between 0 and
|
|||||||
.Pq usually 31 .
|
.Pq usually 31 .
|
||||||
0 is the highest possible priority.
|
0 is the highest possible priority.
|
||||||
.Pp
|
.Pp
|
||||||
Realtime and idle priority is inherited through fork() and exec().
|
Realtime and idle priority is inherited through
|
||||||
|
.Fn fork
|
||||||
|
and
|
||||||
|
.Fn exec .
|
||||||
.Pp
|
.Pp
|
||||||
A realtime thread can only be preempted by a thread of equal or
|
A realtime thread can only be preempted by a thread of equal or
|
||||||
higher priority, or by an interrupt; idle priority threads will run only
|
higher priority, or by an interrupt; idle priority threads will run only
|
||||||
|
@ -381,14 +381,14 @@ does not support
|
|||||||
The socket peer has closed the connection.
|
The socket peer has closed the connection.
|
||||||
.El
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr loader.conf 5 ,
|
|
||||||
.Xr netstat 1 ,
|
.Xr netstat 1 ,
|
||||||
.Xr open 2 ,
|
.Xr open 2 ,
|
||||||
.Xr send 2 ,
|
.Xr send 2 ,
|
||||||
.Xr socket 2 ,
|
.Xr socket 2 ,
|
||||||
.Xr writev 2 ,
|
.Xr writev 2 ,
|
||||||
.Xr sysctl 8 ,
|
.Xr loader.conf 5 ,
|
||||||
.Xr tuning 7
|
.Xr tuning 7 ,
|
||||||
|
.Xr sysctl 8
|
||||||
.Rs
|
.Rs
|
||||||
.%A K. Elmeleegy
|
.%A K. Elmeleegy
|
||||||
.%A A. Chanda
|
.%A A. Chanda
|
||||||
@ -442,4 +442,4 @@ it will return
|
|||||||
and set
|
and set
|
||||||
.Va errno
|
.Va errno
|
||||||
to
|
to
|
||||||
.Er EINVAL.
|
.Er EINVAL .
|
||||||
|
@ -72,12 +72,12 @@ A return from the function indicates that the calling thread was the
|
|||||||
last one in the process.
|
last one in the process.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr _exit 2 ,
|
.Xr _exit 2 ,
|
||||||
|
.Xr _umtx_op 2 ,
|
||||||
.Xr thr_kill 2 ,
|
.Xr thr_kill 2 ,
|
||||||
.Xr thr_kill2 2 ,
|
.Xr thr_kill2 2 ,
|
||||||
.Xr thr_new 2 ,
|
.Xr thr_new 2 ,
|
||||||
.Xr thr_self 2 ,
|
.Xr thr_self 2 ,
|
||||||
.Xr thr_set_name 2 ,
|
.Xr thr_set_name 2 ,
|
||||||
.Xr _umtx_op 2 ,
|
|
||||||
.Xr pthread_exit 3
|
.Xr pthread_exit 3
|
||||||
.Sh STANDARDS
|
.Sh STANDARDS
|
||||||
The
|
The
|
||||||
|
@ -225,6 +225,7 @@ There was not enough kernel memory to allocate the new thread structures.
|
|||||||
.El
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr ps 1 ,
|
.Xr ps 1 ,
|
||||||
|
.Xr _umtx_op 2 ,
|
||||||
.Xr execve 2 ,
|
.Xr execve 2 ,
|
||||||
.Xr racct 2 ,
|
.Xr racct 2 ,
|
||||||
.Xr thr_exit 2 ,
|
.Xr thr_exit 2 ,
|
||||||
@ -232,7 +233,6 @@ There was not enough kernel memory to allocate the new thread structures.
|
|||||||
.Xr thr_kill2 2 ,
|
.Xr thr_kill2 2 ,
|
||||||
.Xr thr_self 2 ,
|
.Xr thr_self 2 ,
|
||||||
.Xr thr_set_name 2 ,
|
.Xr thr_set_name 2 ,
|
||||||
.Xr _umtx_op 2 ,
|
|
||||||
.Xr pthread_create 3
|
.Xr pthread_create 3
|
||||||
.Sh STANDARDS
|
.Sh STANDARDS
|
||||||
The
|
The
|
||||||
|
@ -71,12 +71,12 @@ The memory pointed to by the
|
|||||||
argument is not valid.
|
argument is not valid.
|
||||||
.El
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
|
.Xr _umtx_op 2 ,
|
||||||
.Xr thr_exit 2 ,
|
.Xr thr_exit 2 ,
|
||||||
.Xr thr_kill 2 ,
|
.Xr thr_kill 2 ,
|
||||||
.Xr thr_kill2 2 ,
|
.Xr thr_kill2 2 ,
|
||||||
.Xr thr_new 2 ,
|
.Xr thr_new 2 ,
|
||||||
.Xr thr_set_name 2 ,
|
.Xr thr_set_name 2 ,
|
||||||
.Xr _umtx_op 2 ,
|
|
||||||
.Xr pthread_getthreadid_np 3 ,
|
.Xr pthread_getthreadid_np 3 ,
|
||||||
.Xr pthread_self 3
|
.Xr pthread_self 3
|
||||||
.Sh STANDARDS
|
.Sh STANDARDS
|
||||||
|
@ -78,12 +78,12 @@ does not exist in the current process.
|
|||||||
.El
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr ps 1 ,
|
.Xr ps 1 ,
|
||||||
|
.Xr _umtx_op 2 ,
|
||||||
.Xr thr_exit 2 ,
|
.Xr thr_exit 2 ,
|
||||||
.Xr thr_kill 2 ,
|
.Xr thr_kill 2 ,
|
||||||
.Xr thr_kill2 2 ,
|
.Xr thr_kill2 2 ,
|
||||||
.Xr thr_new 2 ,
|
.Xr thr_new 2 ,
|
||||||
.Xr thr_self 2 ,
|
.Xr thr_self 2 ,
|
||||||
.Xr _umtx_op 2 ,
|
|
||||||
.Xr pthread_set_name_np 3 ,
|
.Xr pthread_set_name_np 3 ,
|
||||||
.Xr ddb 4 ,
|
.Xr ddb 4 ,
|
||||||
.Xr ktr 9
|
.Xr ktr 9
|
||||||
|
@ -98,7 +98,6 @@ As with
|
|||||||
called from another thread, the next
|
called from another thread, the next
|
||||||
.Nm
|
.Nm
|
||||||
call does not result in suspension.
|
call does not result in suspension.
|
||||||
.Pp
|
|
||||||
.Sh RETURN VALUES
|
.Sh RETURN VALUES
|
||||||
.Rv -std thr_suspend
|
.Rv -std thr_suspend
|
||||||
.Sh ERRORS
|
.Sh ERRORS
|
||||||
|
@ -74,7 +74,7 @@ If
|
|||||||
.Fa id
|
.Fa id
|
||||||
is not equal to the current thread identifier, the specified thread is
|
is not equal to the current thread identifier, the specified thread is
|
||||||
woken up if suspended by the
|
woken up if suspended by the
|
||||||
.Xr thr_suspend
|
.Xr thr_suspend 2
|
||||||
system call.
|
system call.
|
||||||
If the thread is not suspended at the time of the
|
If the thread is not suspended at the time of the
|
||||||
.Nm
|
.Nm
|
||||||
|
@ -95,7 +95,7 @@ syscall.
|
|||||||
Per-key permissions are managed using the user-mode instructions
|
Per-key permissions are managed using the user-mode instructions
|
||||||
.Em RDPKRU
|
.Em RDPKRU
|
||||||
and
|
and
|
||||||
.Em WRPKRU.
|
.Em WRPKRU .
|
||||||
The system provides convenient library helpers for both the syscall and
|
The system provides convenient library helpers for both the syscall and
|
||||||
the instructions, described below.
|
the instructions, described below.
|
||||||
.Pp
|
.Pp
|
||||||
|
Loading…
Reference in New Issue
Block a user