mirror of https://github.com/mkerrisk/man-pages
membarrier.2, crypt.3, dladdr.3, duplocale.3, fmemopen.3, gethostbyname.3, mallopt.3, newlocale.3, resolver.3, sigsetops.3, strfmon.3, tzset.3, console_ioctl.4, lirc.4, loop.4, vcs.4, dir_colors.5, locale.5, proc.5, tzfile.5, attributes.7, bootparam.7, capabilities.7, feature_test_macros.7, icmp.7, man-pages.7, netlink.7, path_resolution.7, pipe.7, socket.7, unix.7, vdso.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk
parent
b353ceb4a0
commit
787dd4ad3a
|
|
@ -150,7 +150,7 @@ system call is not implemented by this kernel.
|
|||
The
|
||||
.BR membarrier ()
|
||||
system call was added in Linux 4.3.
|
||||
|
||||
.\"
|
||||
.SH CONFORMING TO
|
||||
.BR membarrier ()
|
||||
is Linux-specific.
|
||||
|
|
|
|||
|
|
@ -126,8 +126,6 @@ On error, NULL is returned.
|
|||
.I salt
|
||||
has the wrong format.
|
||||
.TP
|
||||
.B
|
||||
.TP
|
||||
.B ENOSYS
|
||||
The
|
||||
.BR crypt ()
|
||||
|
|
|
|||
|
|
@ -183,7 +183,6 @@ field using the macro
|
|||
(or
|
||||
.BR ELF32_ST_BIND()
|
||||
on 32-bit platforms), which yields one of the following values:
|
||||
|
||||
.in +4n
|
||||
.TS
|
||||
lb lb
|
||||
|
|
@ -225,7 +224,6 @@ and
|
|||
.I info->dli_saddr
|
||||
fields are set to NULL.
|
||||
|
||||
|
||||
If the address specified in
|
||||
.I addr
|
||||
could not be matched to a shared object, then these functions return 0.
|
||||
|
|
|
|||
|
|
@ -97,7 +97,6 @@ This is done by applying
|
|||
to the value returned by the following call:
|
||||
|
||||
loc = uselocale((locale_t) 0);
|
||||
|
||||
.IP
|
||||
This technique is necessary, because the above
|
||||
.BR uselocale (3)
|
||||
|
|
|
|||
|
|
@ -104,7 +104,7 @@ as the stdio stream buffer, at the same time informing stdio
|
|||
of the buffer's size, using:
|
||||
|
||||
setbuffer(stream, buf, size);
|
||||
|
||||
.\"
|
||||
.\" See http://sourceware.org/bugzilla/show_bug.cgi?id=1995
|
||||
.\" and
|
||||
.\" http://sources.redhat.com/ml/libc-alpha/2006-04/msg00064.html
|
||||
|
|
|
|||
|
|
@ -230,7 +230,7 @@ The default action is to query the Name Service Switch
|
|||
.RB ( nsswitch.conf(5))
|
||||
configured sources, failing that, a local name server
|
||||
.RB ( named (8)).
|
||||
|
||||
.\"
|
||||
.SS Historical
|
||||
The
|
||||
.BR nsswitch.conf (5)
|
||||
|
|
|
|||
|
|
@ -330,7 +330,7 @@ is a trade-off between increasing the number of system calls
|
|||
(when the parameter is set low)
|
||||
and wasting unused memory at the top of the heap
|
||||
(when the parameter is set high).
|
||||
|
||||
.\"
|
||||
.SS Environment variables
|
||||
A number of environment variables can be defined
|
||||
to modify some of the same parameters as are controlled by
|
||||
|
|
|
|||
|
|
@ -247,7 +247,6 @@ Displaying the date.
|
|||
The format and language of the output will be affected by the
|
||||
.B LC_TIME
|
||||
setting.
|
||||
|
||||
.PP
|
||||
The following shell sessions show some example runs of this program.
|
||||
|
||||
|
|
|
|||
|
|
@ -78,9 +78,8 @@ dn_comp, dn_expand \- resolver routines
|
|||
.BI " const unsigned char *" comp_dn ", char *" exp_dn ,
|
||||
.BI " int " length );
|
||||
.fi
|
||||
|
||||
.\"
|
||||
.SS Deprecated
|
||||
|
||||
.nf
|
||||
.B extern struct __res_state _res;
|
||||
|
||||
|
|
@ -396,7 +395,7 @@ Default option which implies:
|
|||
.BR RES_DNSRCH
|
||||
and
|
||||
.BR RES_NOIP6DOTINT .
|
||||
|
||||
.\"
|
||||
.SH RETURN VALUE
|
||||
The
|
||||
.BR res_ninit ()
|
||||
|
|
|
|||
|
|
@ -161,7 +161,7 @@ by the NPTL threading implementation.
|
|||
See
|
||||
.BR nptl (7)
|
||||
for details.
|
||||
|
||||
.\"
|
||||
.SS Glibc extensions
|
||||
If the
|
||||
.B _GNU_SOURCE
|
||||
|
|
|
|||
|
|
@ -62,7 +62,6 @@ is the special locale object
|
|||
(see
|
||||
.BR duplocale (3))
|
||||
or is not a valid locale object handle.
|
||||
|
||||
.PP
|
||||
Ordinary characters in
|
||||
.I format
|
||||
|
|
|
|||
|
|
@ -115,7 +115,6 @@ The hour must be between 0 and 24, and the minutes and seconds 00 and 59:
|
|||
.RS
|
||||
.RI [ + | - ] hh [ :mm [ :ss ]]
|
||||
.RE
|
||||
.sp
|
||||
.PP
|
||||
The \fIdst\fP string and \fIoffset\fP specify the name and offset for the
|
||||
corresponding daylight saving timezone.
|
||||
|
|
|
|||
|
|
@ -124,7 +124,6 @@ Equivalent to
|
|||
Set text/graphics mode.
|
||||
.I argp
|
||||
is one of these:
|
||||
|
||||
.TS
|
||||
l l.
|
||||
KD_TEXT 0x00
|
||||
|
|
@ -366,7 +365,6 @@ points to a
|
|||
.I long
|
||||
which is set to one
|
||||
of these:
|
||||
|
||||
.TS
|
||||
l l.
|
||||
K_RAW 0x00
|
||||
|
|
@ -389,7 +387,6 @@ points to a
|
|||
.I long
|
||||
which is
|
||||
set to one of these:
|
||||
|
||||
.TS
|
||||
l l l.
|
||||
K_METABIT 0x03 set high order bit
|
||||
|
|
@ -571,7 +568,6 @@ struct vt_mode {
|
|||
which is set to the mode of the active vt.
|
||||
.I mode
|
||||
is set to one of these values:
|
||||
|
||||
.TS
|
||||
l l.
|
||||
VT_AUTO auto vt switching
|
||||
|
|
|
|||
20
man4/lirc.4
20
man4/lirc.4
|
|
@ -53,7 +53,7 @@ Such hardware can be used with (almost) any kind of remote.
|
|||
.P
|
||||
The \fBLIRC_GET_REC_MODE\fR ioctl (see below) allows probing for the
|
||||
mode.
|
||||
|
||||
.\"
|
||||
.SS Reading input with the LIRC_MODE_MODE2 drivers
|
||||
.P
|
||||
In the \fBLIRC_MODE_MODE2 mode\fR, the data returned by
|
||||
|
|
@ -79,7 +79,7 @@ ioctl.
|
|||
The package reflects a timeout; see the
|
||||
.B LIRC_SET_REC_TIMEOUT_REPORTS
|
||||
ioctl.
|
||||
|
||||
.\"
|
||||
.SS Reading input with the
|
||||
.B LIRC_MODE_LIRCCODE
|
||||
drivers
|
||||
|
|
@ -93,7 +93,7 @@ the \fBLIRC_GET_LENGTH\fR ioctl.
|
|||
Reads must be done in blocks matching
|
||||
the bit count returned by the \fBLIRC_GET_LENGTH\fR ioctl, rounded
|
||||
up so it matches full bytes.
|
||||
|
||||
.\"
|
||||
.SS Sending data
|
||||
.P
|
||||
When sending data, only the \fBLIRC_MODE_PULSE\fR
|
||||
|
|
@ -112,7 +112,7 @@ If more data is provided than the hardware can send, the
|
|||
.BR write (2)
|
||||
call fails with the error
|
||||
.BR EINVAL
|
||||
|
||||
.\"
|
||||
.SH SUPPORTED IOCTL COMMANDS
|
||||
.P
|
||||
.nf
|
||||
|
|
@ -132,8 +132,7 @@ The driver implementation is expected to re-apply the default settings
|
|||
when the device is closed by userspace, so that every application
|
||||
opening the device can rely on working with the default settings
|
||||
initially.
|
||||
|
||||
.BR
|
||||
.\"
|
||||
.SS Always Supported Commands
|
||||
.P
|
||||
\fI/dev/lirc*\fR devices always support the following commands:
|
||||
|
|
@ -159,7 +158,7 @@ button press.
|
|||
If a device returns an error code for
|
||||
.BR LIRC_GET_REC_MODE ,
|
||||
it is safe to assume it is not a lirc device.
|
||||
|
||||
.\"
|
||||
.SS Optional Commands
|
||||
.P
|
||||
Some lirc devices support commands listed below.
|
||||
|
|
@ -175,7 +174,6 @@ is either
|
|||
.BR LIRC_MODE_LIRCCODE
|
||||
or
|
||||
.BR LIRC_MODE_MODE2 .
|
||||
|
||||
.TP
|
||||
.BR LIRC_GET_LENGTH " (\fIvoid\fP)"
|
||||
Return the length of the returned codes for
|
||||
|
|
@ -353,7 +351,7 @@ This ioctl is called by
|
|||
whenever a successful decoding of an incoming IR signal is possible.
|
||||
This can be used by supporting hardware to give visual user
|
||||
feedback, for example by flashing an LED.
|
||||
|
||||
.\"
|
||||
.SH FEATURES
|
||||
.P
|
||||
The features returned by
|
||||
|
|
@ -444,7 +442,7 @@ The driver supports sending.
|
|||
.BR LIRCCODE
|
||||
drivers reflect hardware like TV-cards which usually dos not support
|
||||
sending.)
|
||||
|
||||
.\"
|
||||
.SH BUGS
|
||||
Using these devices requires the kernel source header file
|
||||
.IR lirc.h .
|
||||
|
|
@ -453,7 +451,7 @@ This file is not (yet) publicly exported by kernel headers.
|
|||
For the time being, the file is bundled in the lirc package; see
|
||||
.UR http://www.lirc.org
|
||||
.UE .
|
||||
|
||||
.\"
|
||||
.SH SEE ALSO
|
||||
.BR lircd (8)
|
||||
.P
|
||||
|
|
|
|||
|
|
@ -238,7 +238,6 @@ loopname = /dev/loop5
|
|||
.SS Program source
|
||||
\&
|
||||
.nf
|
||||
|
||||
#include <fcntl.h>
|
||||
#include <linux/loop.h>
|
||||
#include <sys/ioctl.h>
|
||||
|
|
|
|||
|
|
@ -113,7 +113,6 @@ or (horrors)
|
|||
|
||||
xetterm \-dump 3 \-file /proc/self/fd/1
|
||||
|
||||
.LP
|
||||
The
|
||||
.I /dev/vcsa0
|
||||
device is used for Braille support.
|
||||
|
|
|
|||
|
|
@ -243,7 +243,6 @@ uses ISO 6429 codes by default, assuming colorization is enabled.
|
|||
ISO 6429 color sequences are composed of sequences of numbers
|
||||
separated by semicolons.
|
||||
The most common codes are:
|
||||
.sp
|
||||
.RS
|
||||
.TS
|
||||
l l.
|
||||
|
|
@ -274,7 +273,6 @@ Not all commands will work on all systems or display devices.
|
|||
.PP
|
||||
.B ls
|
||||
uses the following defaults:
|
||||
.sp
|
||||
.TS
|
||||
lb l l.
|
||||
NORMAL 0 Normal (nonfilename) text
|
||||
|
|
@ -352,7 +350,6 @@ filename extensions, either C-style \e-escaped notation or
|
|||
^-notation can be used.
|
||||
The C-style notation
|
||||
includes the following characters:
|
||||
.sp
|
||||
.RS
|
||||
.TS
|
||||
lb l.
|
||||
|
|
@ -395,7 +392,6 @@ The default
|
|||
and
|
||||
.B RIGHTCODE
|
||||
definitions, which are used by ISO 6429 terminals are:
|
||||
.sp
|
||||
.RS
|
||||
.TS
|
||||
lb l.
|
||||
|
|
|
|||
|
|
@ -114,7 +114,7 @@ the GNU C library supports the following nonstandard categories:
|
|||
See
|
||||
.BR locale (7)
|
||||
for a more detailed description of each category.
|
||||
|
||||
.\"
|
||||
.SS LC_ADDRESS
|
||||
The definition starts with the string
|
||||
.I LC_ADDRESS
|
||||
|
|
@ -199,7 +199,6 @@ the \(aq%\(aq to specify that the
|
|||
information is taken from a Romanized version string of the
|
||||
entity.
|
||||
.RE
|
||||
|
||||
.TP
|
||||
.I country_name
|
||||
followed by the country name in the language of the current document
|
||||
|
|
|
|||
|
|
@ -859,7 +859,6 @@ one:
|
|||
.in +4n
|
||||
.nf
|
||||
|
||||
.RB
|
||||
lrw\-\-\-\-\-\-\-. 1 root root 64 Apr 16 21:33
|
||||
7fc075d2f000\-7fc075e6f000 \-> /dev/zero (deleted)
|
||||
.fi
|
||||
|
|
@ -1134,7 +1133,6 @@ supports being manipulated by
|
|||
.BR setns (2).
|
||||
For more information, see
|
||||
.BR namespaces (7).
|
||||
|
||||
.TP
|
||||
.IR /proc/[pid]/numa_maps " (since Linux 2.6.14)"
|
||||
See
|
||||
|
|
@ -4742,7 +4740,6 @@ Collection: active
|
|||
1, 4911 kworker/u16:0 mod_delayed_work_on (delayed_work_timer_fn)
|
||||
1D, 2522 kworker/0:0 queue_delayed_work_on (delayed_work_timer_fn)
|
||||
1029 total events, 583.333 events/sec
|
||||
|
||||
.fi
|
||||
.RE
|
||||
.IP
|
||||
|
|
|
|||
|
|
@ -193,7 +193,6 @@ that follow the last transition time explicitly specified in the timezone
|
|||
information file.
|
||||
.SS Summary of the timezone information file format
|
||||
\&
|
||||
.sp 2
|
||||
.RS
|
||||
.nf
|
||||
Four-byte value section
|
||||
|
|
@ -226,7 +225,7 @@ Third section
|
|||
Newline character
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.\"
|
||||
.SH SEE ALSO
|
||||
.BR ctime (3),
|
||||
.BR tzset (3),
|
||||
|
|
|
|||
|
|
@ -98,7 +98,7 @@ safe for inlining.
|
|||
.\" but does document which functions are presently AC-Safe.
|
||||
.\" This documentation is provided for use
|
||||
.\" by the GNU C Library developers.
|
||||
|
||||
.\"
|
||||
.\" Just like signal handlers, cancellation cleanup routines must configure
|
||||
.\" the floating point environment they require.
|
||||
.\" The routines cannot assume a floating point environment,
|
||||
|
|
@ -345,7 +345,7 @@ Calling such a function at least once in single-threaded mode removes
|
|||
this specific cause for the function to be regarded as MT-Unsafe.
|
||||
If no other cause for that remains,
|
||||
the function can then be safely called after other threads are started.
|
||||
|
||||
.\"
|
||||
.\" Functions marked with
|
||||
.\" .I init
|
||||
.\" as an AS-Unsafe or AC-Unsafe feature use the GNU C Library internal
|
||||
|
|
@ -386,7 +386,7 @@ In some cases,
|
|||
the objects are passed to the functions by users;
|
||||
in others, they are used by the functions to return values to users;
|
||||
in others, they are not even exposed to users.
|
||||
|
||||
.\"
|
||||
.\" We consider access to objects passed as (indirect) arguments to
|
||||
.\" functions to be data race free.
|
||||
.\" The assurance of data race free objects
|
||||
|
|
@ -563,7 +563,7 @@ Holding a non-recursive mutex while calling all functions that use the same
|
|||
temporary signal;
|
||||
blocking that signal before the call and resetting its
|
||||
handler afterwards is recommended.
|
||||
|
||||
.\"
|
||||
.\" There is no safe way to guarantee the original signal handler is
|
||||
.\" restored in case of asynchronous cancellation,
|
||||
.\" therefore so-marked functions are also AC-Unsafe.
|
||||
|
|
@ -609,7 +609,7 @@ is a file descriptor for the controlling terminal.
|
|||
The caller may use a single mutex for simplicity,
|
||||
or use one mutex per terminal,
|
||||
even if referenced by different file descriptors.
|
||||
|
||||
.\"
|
||||
.\" Functions marked with
|
||||
.\" .I term
|
||||
.\" as an AC-Safety issue are supposed to
|
||||
|
|
@ -656,7 +656,6 @@ are running or asynchronous signals are enabled,
|
|||
and so the locale can be considered effectively constant
|
||||
in these contexts,
|
||||
which makes the former safe.
|
||||
|
||||
.\" Should the locking strategy suggested under @code{const} be used,
|
||||
.\" failure to guard locale uses is not as fatal as data races in
|
||||
.\" general: unguarded uses will @emph{not} follow dangling pointers or
|
||||
|
|
|
|||
|
|
@ -182,7 +182,6 @@ as read/write capable, for example, by 'mount \-w \-n \-o remount /'.
|
|||
|
||||
The 'rw' option tells the kernel to mount the root filesystem read/write.
|
||||
This is the default.
|
||||
|
||||
.TP
|
||||
.B "'resume=...'"
|
||||
This tells the kernel the location of the suspend-to-disk data that you want the machine to resume from after hibernation.
|
||||
|
|
|
|||
|
|
@ -108,7 +108,6 @@ Invoke
|
|||
.BR open_by_handle_at (2).
|
||||
.RE
|
||||
.PD
|
||||
|
||||
.TP
|
||||
.B CAP_FOWNER
|
||||
.PD 0
|
||||
|
|
|
|||
|
|
@ -387,7 +387,6 @@ On glibc 2.19 and earlier, these defaults were approximately equivalent
|
|||
to explicitly defining the following:
|
||||
|
||||
cc \-D_BSD_SOURCE \-D_SVID_SOURCE \-D_POSIX_C_SOURCE=200809
|
||||
|
||||
.TP
|
||||
.BR _ATFILE_SOURCE " (since glibc 2.4)"
|
||||
Defining this macro with any value causes header files to expose
|
||||
|
|
|
|||
|
|
@ -129,7 +129,6 @@ Default mask: 0000001100000011000 (0x1818)
|
|||
|
||||
Bit definitions (see the Linux kernel source file
|
||||
.IR include/linux/icmp.h ):
|
||||
|
||||
.RS 12
|
||||
.TS
|
||||
l l.
|
||||
|
|
|
|||
|
|
@ -601,7 +601,7 @@ language requirements (e.g., identifier names) dictate otherwise.
|
|||
For example:
|
||||
|
||||
.SS Unicode under Linux
|
||||
|
||||
.\"
|
||||
.SS Indentation of structure definitions, shell session logs, and so on
|
||||
When structure definitions, shell session logs, and so on are included
|
||||
in running text, indent them by 4 spaces (i.e., a block enclosed by
|
||||
|
|
|
|||
|
|
@ -194,7 +194,6 @@ T}
|
|||
NLM_F_ACK:Request for an acknowledgment on success.
|
||||
NLM_F_ECHO:Echo this request.
|
||||
.TE
|
||||
.sp 1
|
||||
.\" No right adjustment for text blocks in tables
|
||||
.TS
|
||||
tab(:);
|
||||
|
|
|
|||
|
|
@ -124,7 +124,6 @@ the kernel's pathname-resolution code
|
|||
was reworked to eliminate the use of recursion,
|
||||
so that the only limit that remains is the maximum of 40
|
||||
resolutions for the entire pathname.
|
||||
|
||||
.SS Step 3: find the final entry
|
||||
The lookup of the final component of the pathname goes just like
|
||||
that of all other components, as described in the previous step,
|
||||
|
|
|
|||
|
|
@ -143,7 +143,7 @@ operations.
|
|||
See
|
||||
.BR fcntl (2)
|
||||
for more information.
|
||||
|
||||
.\"
|
||||
.SS PIPE_BUF
|
||||
POSIX.1 says that
|
||||
.BR write (2)s
|
||||
|
|
|
|||
|
|
@ -500,7 +500,6 @@ The following example serves to illustrate the use of
|
|||
Suppose a stream socket has the following queued input data:
|
||||
|
||||
aabbccddeeff
|
||||
|
||||
.IP
|
||||
The following sequence of
|
||||
.BR recv (2)
|
||||
|
|
|
|||
|
|
@ -732,7 +732,6 @@ main(int argc, char *argv[])
|
|||
|
||||
for (;;) {
|
||||
|
||||
|
||||
/* Wait for incoming connection. */
|
||||
|
||||
data_socket = accept(connection_socket, NULL, NULL);
|
||||
|
|
@ -871,7 +870,6 @@ main(int argc, char *argv[])
|
|||
exit(EXIT_FAILURE);
|
||||
}
|
||||
|
||||
|
||||
/* Receive result. */
|
||||
|
||||
ret = read(data_socket, buffer, BUFFER_SIZE);
|
||||
|
|
@ -892,7 +890,6 @@ main(int argc, char *argv[])
|
|||
|
||||
exit(EXIT_SUCCESS);
|
||||
}
|
||||
|
||||
.fi
|
||||
.PP
|
||||
For an example of the use of
|
||||
|
|
|
|||
|
|
@ -133,7 +133,7 @@ it will automatically compile and link the vDSO code for you.
|
|||
You will frequently find it under the architecture-specific directory:
|
||||
|
||||
find arch/$ARCH/ -name '*vdso*.so*' -o -name '*gate*.so*'
|
||||
|
||||
.\"
|
||||
.SS vDSO names
|
||||
The name of the vDSO varies across architectures.
|
||||
It will often show up in things like glibc's
|
||||
|
|
|
|||
Loading…
Reference in New Issue