mirror of https://github.com/mkerrisk/man-pages
localedef.1, access.2, ioctl_console.2, ioctl_fslabel.2, openat2.2, write.2, dlsym.3, getopt.3, nl_langinfo.3, termios.3, xcrypt.3, hosts.equiv.5, nsswitch.conf.5, cgroups.7, man-pages.7, netlink.7, system_data_types.7: srcfix: semantic newlines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
e6b7a7b823
commit
5e833e276d
|
@ -245,7 +245,8 @@ and
|
||||||
.IR intcurrsym .
|
.IR intcurrsym .
|
||||||
.TP
|
.TP
|
||||||
.B \-\-posix
|
.B \-\-posix
|
||||||
Conform strictly to POSIX. Implies
|
Conform strictly to POSIX.
|
||||||
|
Implies
|
||||||
.BR \-\-verbose .
|
.BR \-\-verbose .
|
||||||
This option currently has no other effect.
|
This option currently has no other effect.
|
||||||
POSIX conformance is assumed if the environment variable
|
POSIX conformance is assumed if the environment variable
|
||||||
|
|
|
@ -358,8 +358,8 @@ call will still fail.
|
||||||
These calls
|
These calls
|
||||||
may not work correctly on NFSv2 filesystems with UID mapping enabled,
|
may not work correctly on NFSv2 filesystems with UID mapping enabled,
|
||||||
because UID mapping is done on the server and hidden from the client,
|
because UID mapping is done on the server and hidden from the client,
|
||||||
which checks permissions. (NFS versions 3 and higher perform the check on
|
which checks permissions.
|
||||||
the server.)
|
(NFS versions 3 and higher perform the check on the server.)
|
||||||
Similar problems can occur to FUSE mounts.
|
Similar problems can occur to FUSE mounts.
|
||||||
.\"
|
.\"
|
||||||
.\"
|
.\"
|
||||||
|
|
|
@ -685,7 +685,8 @@ These are legal only for the superuser or the owner of the current terminal.
|
||||||
.TP
|
.TP
|
||||||
.B "TIOCLINUX, subcode=0"
|
.B "TIOCLINUX, subcode=0"
|
||||||
Dump the screen.
|
Dump the screen.
|
||||||
Disappeared in Linux 1.1.92. (With kernel 1.1.92 or later, read from
|
Disappeared in Linux 1.1.92.
|
||||||
|
(With kernel 1.1.92 or later, read from
|
||||||
.I /dev/vcsN
|
.I /dev/vcsN
|
||||||
or
|
or
|
||||||
.I /dev/vcsaN
|
.I /dev/vcsaN
|
||||||
|
|
|
@ -43,7 +43,8 @@ The
|
||||||
operation requires privilege
|
operation requires privilege
|
||||||
.RB ( CAP_SYS_ADMIN ).
|
.RB ( CAP_SYS_ADMIN ).
|
||||||
.SH RETURN VALUE
|
.SH RETURN VALUE
|
||||||
On success zero is returned. On error, \-1 is returned, and
|
On success zero is returned.
|
||||||
|
On error, \-1 is returned, and
|
||||||
.I errno
|
.I errno
|
||||||
is set to indicate the error.
|
is set to indicate the error.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
|
@ -77,7 +78,8 @@ The maximum string length for this interface is
|
||||||
.BR FSLABEL_MAX ,
|
.BR FSLABEL_MAX ,
|
||||||
including the terminating null byte (\(aq\\0\(aq).
|
including the terminating null byte (\(aq\\0\(aq).
|
||||||
Filesystems have differing maximum label lengths, which may or
|
Filesystems have differing maximum label lengths, which may or
|
||||||
may not include the terminating null. The string provided to
|
may not include the terminating null.
|
||||||
|
The string provided to
|
||||||
.B FS_IOC_SETFSLABEL
|
.B FS_IOC_SETFSLABEL
|
||||||
must always be null-terminated, and the string returned by
|
must always be null-terminated, and the string returned by
|
||||||
.B FS_IOC_GETFSLABEL
|
.B FS_IOC_GETFSLABEL
|
||||||
|
|
|
@ -439,7 +439,8 @@ call.
|
||||||
.B EAGAIN
|
.B EAGAIN
|
||||||
.BR RESOLVE_CACHED
|
.BR RESOLVE_CACHED
|
||||||
was set, and the open operation cannot be performed using only cached
|
was set, and the open operation cannot be performed using only cached
|
||||||
information. The caller should retry without
|
information.
|
||||||
|
The caller should retry without
|
||||||
.B RESOLVE_CACHED
|
.B RESOLVE_CACHED
|
||||||
set in
|
set in
|
||||||
.I how.resolve .
|
.I how.resolve .
|
||||||
|
|
|
@ -293,7 +293,8 @@ returning the number of bytes actually transferred.
|
||||||
An error return value while performing
|
An error return value while performing
|
||||||
.BR write ()
|
.BR write ()
|
||||||
using direct I/O does not mean the
|
using direct I/O does not mean the
|
||||||
entire write has failed. Partial data may be written
|
entire write has failed.
|
||||||
|
Partial data may be written
|
||||||
and the data at the file offset on which the
|
and the data at the file offset on which the
|
||||||
.BR write ()
|
.BR write ()
|
||||||
was attempted should be considered inconsistent.
|
was attempted should be considered inconsistent.
|
||||||
|
|
|
@ -153,12 +153,15 @@ There are several scenarios when the address of a global symbol is NULL.
|
||||||
For example, a symbol can be placed at zero address by the linker, via
|
For example, a symbol can be placed at zero address by the linker, via
|
||||||
a linker script or with
|
a linker script or with
|
||||||
.I \-\-defsym
|
.I \-\-defsym
|
||||||
command-line option. Undefined weak symbols also have NULL value.
|
command-line option.
|
||||||
|
Undefined weak symbols also have NULL value.
|
||||||
Finally, the symbol value may be the result of
|
Finally, the symbol value may be the result of
|
||||||
a GNU indirect function (IFUNC) resolver function that returns
|
a GNU indirect function (IFUNC) resolver function that returns
|
||||||
NULL as the resolved value. In the latter case,
|
NULL as the resolved value.
|
||||||
|
In the latter case,
|
||||||
.BR dlsym ()
|
.BR dlsym ()
|
||||||
also returns NULL without error. However, in the former two cases, the
|
also returns NULL without error.
|
||||||
|
However, in the former two cases, the
|
||||||
behavior of GNU dynamic linker is inconsistent: relocation processing
|
behavior of GNU dynamic linker is inconsistent: relocation processing
|
||||||
succeeds and the symbol can be observed to have NULL value, but
|
succeeds and the symbol can be observed to have NULL value, but
|
||||||
.BR dlsym ()
|
.BR dlsym ()
|
||||||
|
|
|
@ -176,7 +176,8 @@ behaviour is required in this case
|
||||||
will contain two \(aq+\(aq symbols.
|
will contain two \(aq+\(aq symbols.
|
||||||
If the first character of \fIoptstring\fP is \(aq\-\(aq, then
|
If the first character of \fIoptstring\fP is \(aq\-\(aq, then
|
||||||
each nonoption \fIargv\fP-element is handled as if it were the argument of
|
each nonoption \fIargv\fP-element is handled as if it were the argument of
|
||||||
an option with character code 1. (This is used by programs that were
|
an option with character code 1.
|
||||||
|
(This is used by programs that were
|
||||||
written to expect options and other \fIargv\fP-elements in any order
|
written to expect options and other \fIargv\fP-elements in any order
|
||||||
and that care about the ordering of the two.)
|
and that care about the ordering of the two.)
|
||||||
The special argument "\-\-" forces an end of option-scanning regardless
|
The special argument "\-\-" forces an end of option-scanning regardless
|
||||||
|
|
|
@ -200,7 +200,8 @@ for alternative representation of a time in a locale-specific way
|
||||||
conversion specification).
|
conversion specification).
|
||||||
.TP
|
.TP
|
||||||
.BR DAY_ "{1\(en7} (LC_TIME)"
|
.BR DAY_ "{1\(en7} (LC_TIME)"
|
||||||
Return name of the \fIn\fP-th day of the week. [Warning: this follows
|
Return name of the \fIn\fP-th day of the week.
|
||||||
|
[Warning: this follows
|
||||||
the US convention DAY_1 = Sunday, not the international convention
|
the US convention DAY_1 = Sunday, not the international convention
|
||||||
(ISO 8601) that Monday is the first day of the week.]
|
(ISO 8601) that Monday is the first day of the week.]
|
||||||
(Used in
|
(Used in
|
||||||
|
|
|
@ -331,7 +331,8 @@ Ignore modem control lines.
|
||||||
.TP
|
.TP
|
||||||
.B LOBLK
|
.B LOBLK
|
||||||
(not in POSIX) Block output from a noncurrent shell layer.
|
(not in POSIX) Block output from a noncurrent shell layer.
|
||||||
For use by \fBshl\fP (shell layers). (Not implemented on Linux.)
|
For use by \fBshl\fP (shell layers).
|
||||||
|
(Not implemented on Linux.)
|
||||||
.TP
|
.TP
|
||||||
.B CIBAUD
|
.B CIBAUD
|
||||||
(not in POSIX) Mask for input speeds.
|
(not in POSIX) Mask for input speeds.
|
||||||
|
|
|
@ -24,8 +24,8 @@ xencrypt, xdecrypt, passwd2des \- RFS password encryption
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.BR WARNING :
|
.BR WARNING :
|
||||||
Do not use these functions in new code. They do not achieve
|
Do not use these functions in new code.
|
||||||
any type of acceptable cryptographic security guarantees.
|
They do not achieve any type of acceptable cryptographic security guarantees.
|
||||||
.PP
|
.PP
|
||||||
The function
|
The function
|
||||||
.BR passwd2des ()
|
.BR passwd2des ()
|
||||||
|
|
|
@ -38,7 +38,8 @@ You can explicitly deny access to a host by preceding the
|
||||||
.I hostname
|
.I hostname
|
||||||
by a minus (\-) sign.
|
by a minus (\-) sign.
|
||||||
Users from that host must always supply additional credentials,
|
Users from that host must always supply additional credentials,
|
||||||
including possibly a password. For security reasons you should always
|
including possibly a password.
|
||||||
|
For security reasons you should always
|
||||||
use the FQDN of the hostname and not the short hostname.
|
use the FQDN of the hostname and not the short hostname.
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
|
|
|
@ -102,9 +102,10 @@ Shadow user passwords, used by
|
||||||
.BR getspnam (3)
|
.BR getspnam (3)
|
||||||
and related functions.
|
and related functions.
|
||||||
.PP
|
.PP
|
||||||
The GNU C Library ignores databases with unknown names. Some
|
The GNU C Library ignores databases with unknown names.
|
||||||
applications use this to implement special handling for their own
|
Some applications use this to implement special handling for their own
|
||||||
databases. For example,
|
databases.
|
||||||
|
For example,
|
||||||
.BR sudo (8)
|
.BR sudo (8)
|
||||||
consults the
|
consults the
|
||||||
.B sudoers
|
.B sudoers
|
||||||
|
|
|
@ -92,8 +92,8 @@ was eventually made official with the release of Linux 4.5.
|
||||||
Differences between the two versions are described in the text below.
|
Differences between the two versions are described in the text below.
|
||||||
The file
|
The file
|
||||||
.IR cgroup.sane_behavior ,
|
.IR cgroup.sane_behavior ,
|
||||||
present in cgroups v1, is a relic of this mount option. The file
|
present in cgroups v1, is a relic of this mount option.
|
||||||
always reports "0" and is only retained for backward compatibility.
|
The file always reports "0" and is only retained for backward compatibility.
|
||||||
.PP
|
.PP
|
||||||
Although cgroups v2 is intended as a replacement for cgroups v1,
|
Although cgroups v2 is intended as a replacement for cgroups v1,
|
||||||
the older system continues to exist
|
the older system continues to exist
|
||||||
|
|
|
@ -525,7 +525,8 @@ If there is a single such prototype that needs to be continued,
|
||||||
then align the continuation line so that when the page is
|
then align the continuation line so that when the page is
|
||||||
rendered on a fixed-width font device (e.g., on an xterm) the
|
rendered on a fixed-width font device (e.g., on an xterm) the
|
||||||
continuation line starts just below the start of the argument
|
continuation line starts just below the start of the argument
|
||||||
list in the line above. (Exception: the indentation may be
|
list in the line above.
|
||||||
|
(Exception: the indentation may be
|
||||||
adjusted if necessary to prevent a very long continuation line
|
adjusted if necessary to prevent a very long continuation line
|
||||||
or a further continuation line where the function prototype is
|
or a further continuation line where the function prototype is
|
||||||
very long.)
|
very long.)
|
||||||
|
@ -541,7 +542,8 @@ As an example:
|
||||||
But, where multiple functions in the SYNOPSIS require
|
But, where multiple functions in the SYNOPSIS require
|
||||||
continuation lines, and the function names have different
|
continuation lines, and the function names have different
|
||||||
lengths, then align all continuation lines to start in the
|
lengths, then align all continuation lines to start in the
|
||||||
same column. This provides a nicer rendering in PDF output
|
same column.
|
||||||
|
This provides a nicer rendering in PDF output
|
||||||
(because the SYNOPSIS uses a variable width font where
|
(because the SYNOPSIS uses a variable width font where
|
||||||
spaces render narrower than most characters).
|
spaces render narrower than most characters).
|
||||||
As an example:
|
As an example:
|
||||||
|
|
|
@ -189,7 +189,8 @@ message signals an error and the payload contains an
|
||||||
.I nlmsgerr
|
.I nlmsgerr
|
||||||
structure,
|
structure,
|
||||||
.B NLMSG_DONE
|
.B NLMSG_DONE
|
||||||
message terminates a multipart message. Error messages get the
|
message terminates a multipart message.
|
||||||
|
Error messages get the
|
||||||
original request appened, unless the user requests to cap the
|
original request appened, unless the user requests to cap the
|
||||||
error message, and get extra error data if requested.
|
error message, and get extra error data if requested.
|
||||||
.PP
|
.PP
|
||||||
|
|
|
@ -1247,7 +1247,8 @@ Alternatively,
|
||||||
or
|
or
|
||||||
.IR <wordexp.h> .
|
.IR <wordexp.h> .
|
||||||
.PP
|
.PP
|
||||||
Used for a count of bytes. It is the result of the
|
Used for a count of bytes.
|
||||||
|
It is the result of the
|
||||||
.I sizeof
|
.I sizeof
|
||||||
operator.
|
operator.
|
||||||
According to the C language standard,
|
According to the C language standard,
|
||||||
|
|
Loading…
Reference in New Issue