LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

delete_module.2, epoll_create.2, getpeername.2, getpriority.2, getrlimit.2, getunwind.2, init_module.2, kcmp.2, mmap.2, perf_event_open.2, perfmonctl.2, prctl.2, s390_runtime_instr.2, timerfd_create.2, vfork.2, getaddrinfo_a.3, getenv.3, if_nameindex.3, if_nametoindex.3, mcheck.3, pthread_setname_np.3, scanf.3, cciss.4, hpsa.4, core.5, gai.conf.5, networks.5, nscd.conf.5, nss.5, aio.7, arp.7, numa.7, socket.7, udplite.7: srcfix 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2013-02-18 18:45:32 +01:00
parent 7aa48d58c5
commit 6b4dbb25e9
34 changed files with 0 additions and 102 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
man2/delete_module.2
View File

@ -138,7 +138,6 @@ function, and
.B O_TRUNC
was not specified in
.IR flags .
.TP
.B EFAULT
.I name

1
man2/epoll_create.2
View File

@ -53,7 +53,6 @@ should be closed by using
When all file descriptors referring to an epoll instance have been closed,
the kernel destroys the instance
and releases the associated resources for reuse.
.SS epoll_create1()
If
.I flags

1
man2/getpeername.2
View File

@ -138,7 +138,6 @@ call was also executed on the peer).
Note also that the receiver of a datagram can obtain
the address of the sender when using
.BR recvfrom (2).
.SH "SEE ALSO"
.BR accept (2),
.BR bind (2),

1
man2/getpriority.2
View File

@ -227,7 +227,6 @@ the nice value is a per-thread attribute:
different threads in the same process can have different nice values.
Portable applications should avoid relying on the Linux behavior,
which may be made standards conformant in the future.
.SH "SEE ALSO"
.BR nice (1),
.BR renice (1),

2
man2/getrlimit.2
View File

@ -522,7 +522,6 @@ For backward compatibility, glibc also provides
.BR vlimit ().
All new applications should be written using
.BR setrlimit ().
.SH BUGS
.\" FIXME prlimit() does not suffer
.\" https://bugzilla.kernel.org/show_bug.cgi?id=5042
@ -595,7 +594,6 @@ when
.I rlim\->rlim_cur
was greater than
.IR rlim\->rlim_max .
.SH EXAMPLE
The program below demonstrates the use of
.BR prlimit ().

7
man2/getunwind.2
View File

@ -26,7 +26,6 @@
.TH GETUNWIND 2 2013-02-13" Linux "Linux Programmer's Manual"
.SH NAME
getunwind \- copy the unwind data to caller's buffer
.SH SYNOPSIS
.nf
.B #include <syscall.h>
@ -78,7 +77,6 @@ value is zero indicates the end of the table.
For more information about the format, see the
.I IA-64 Software Conventions and Runtime Architecture
manual.
.SH "RETURN VALUE"
On success,
.BR getunwind ()
@ -86,21 +84,17 @@ returns the size of unwind table.
On error, \-1 is returned and
.I errno
is set to indicate the error.
.SH ERRORS
.BR getunwind ()
fails with the error
.B EFAULT
if the unwind info can't be stored in the space specified by
.IR buf .
.SH VERSIONS
This system call is available since Linux 2.4.
.SH CONFORMING TO
This system call is Linux specific,
and is available only on the IA-64 architecture.
.SH NOTES
This system call has been deprecated.
The modern way to obtain the kernel's unwind data is via the gate DSO.
@ -113,6 +107,5 @@ is passed to user level via
Glibc does not provide a wrapper for this system call;
in the unlikely event that you want to call it, use
.BR syscall (2).
.SH "SEE ALSO"
.BR getauxval (3)

3
man2/init_module.2
View File

@ -84,7 +84,6 @@ and
.I invbool
parameters.
Values for array parameters are specified as a comma-separated list.
.SS finit_module()
The
.BR finit_module ()
@ -151,7 +150,6 @@ On success, these system calls return 0.
On error, \-1 is returned and
.I errno
is set appropriately.
.SH ERRORS
.TP
.BR EBADMSG " (since Linux 3.7)"
@ -252,7 +250,6 @@ function.
.SH VERSIONS
.B finit_module ()
is available since Linux 3.8.
.SH "CONFORMING TO"
.BR init_module ()
and

23
man2/kcmp.2
View File

@ -24,10 +24,8 @@
.\" Kernel commit d97b46a64674a267bc41c9e16132ee2a98c3347d
.\"
.TH KCMP 2 2013-01-27 "Linux" "Linux Programmer's Manual"
.SH NAME
kcmp \- compare two processes to determine if they share a kernel resource
.SH SYNOPSIS
.nf
.B #include <linux/kcmp.h>
@ -39,7 +37,6 @@ kcmp \- compare two processes to determine if they share a kernel resource
.IR Note :
There is no glibc wrapper for this system call; see NOTES.
.SH DESCRIPTION
The
.BR kcmp ()
@ -54,7 +51,6 @@ The
.I type
argument specifies which resource is to be compared in the two processes.
It has one of the following values:
.TP
.BR KCMP_FILE
Check whether a file descriptor
@ -67,7 +63,6 @@ as file descriptor
.I idx2
in the process
.IR pid2 .
.TP
.BR KCMP_FILES
Check whether the process share the same set of open file descriptors.
@ -76,7 +71,6 @@ The arguments
and
.I idx2
are ignored.
.TP
.BR KCMP_FS
Check whether the processes share the same file system information
@ -86,7 +80,6 @@ The arguments
and
.I idx2
are ignored.
.TP
.BR KCMP_IO
Check whether the processes share I/O context.
@ -95,7 +88,6 @@ The arguments
and
.I idx2
are ignored.
.TP
.BR KCMP_SIGHAND
Check whether the processes share the same table of signal dispositions.
@ -104,7 +96,6 @@ The arguments
and
.I idx2
are ignored.
.TP
.BR KCMP_SYSVSEM
Check whether the processes share the same
@ -114,7 +105,6 @@ The arguments
and
.I idx2
are ignored.
.TP
.BR KCMP_VM
Check whether the processes share the same address space.
@ -123,7 +113,6 @@ The arguments
and
.I idx2
are ignored.
.PP
Note the
.BR kcmp ()
@ -131,7 +120,6 @@ is not protected against false positives which may have place if tasks are
running.
Which means one should stop tasks being inspected with this syscall to obtain
meaningful results.
.SH "RETURN VALUE"
The return value of a successful call to
.BR kcmp ()
@ -146,31 +134,26 @@ and
.I v2
are the addresses of appropriate resources, then the return value
is one of the following:
.RS 4
.IP 0 4
.I v1
is equal to
.IR v2 ;
in other words, the two processes share the resource.
.IP 1
.I v1
is less than
.IR v2 .
.IP 2
.I v1
is greater than
.IR v2 .
.IP 3
.I v1
is not equal to
.IR v2 ,
but ordering information is unavailable.
.RE
.PP
On error, \-1 is returned, and
.I errno
@ -180,9 +163,7 @@ is set appropriately.
was designed to return values suitable for sorting.
This is particularly handy if one needs to compare
a large number of file descriptors.
.SH ERRORS
.TP
.B EBADF
.I type
@ -210,16 +191,13 @@ Process
or
.I pid2
does not exist.
.SH VERSIONS
The
.BR kcmp ()
system call first appeared in Linux 3.5.
.SH "CONFORMING TO"
.BR kcmp ()
is Linux specific and should not be used in programs intended to be portable.
.SH NOTES
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
@ -237,7 +215,6 @@ See
.BR clone (2)
for some background information on the shared resources
referred to on this page.
.SH "SEE ALSO"
.BR clone (2),
.BR unshare (2)

1
man2/mmap.2
View File

@ -572,7 +572,6 @@ The relevant flags are:
.BR MAP_POPULATE ,
and
.BR MAP_STACK .
.SH BUGS
On Linux there are no guarantees like those suggested above under
.BR MAP_NORESERVE .

3
man2/perf_event_open.2
View File

@ -258,7 +258,6 @@ struct perf_event_attr {
The fields of the
.I perf_event_attr
structure are described in more detail below:
.TP
.I type
This field specifies the overall event type.
@ -314,7 +313,6 @@ For instance,
.I /sys/bus/event_source/devices/cpu/type
contains the value for the core CPU PMU, which is usually 4.
.RE
.TP
.I "size"
The size of the
@ -470,7 +468,6 @@ This can negatively impact performance.
.RE
.RE
.RS
If
.I type

6
man2/perfmonctl.2
View File

@ -57,7 +57,6 @@ argument specifies the perfmon context to operate on.
Supported values for
.I cmd
are:
.TP
.B PFM_CREATE_CONTEXT
.nf
@ -187,26 +186,21 @@ Reset PMC registers to default values.
.\" .nf
.\" .BI "perfmonctl(int " fd ", PFM_GETINFO_EVTSETS, pfarg_setinfo_t *info, n);
.\" .fi
.SH "RETURN VALUE"
.BR performctl ()
returns zero when the operation is successful.
On error, \-1 is returned and
.I errno
is set to indicate the cause of the error.
.SH VERSIONS
.BR perfmonctl ()
is available since Linux 2.4.
.SH CONFORMING TO
.BR perfmonctl ()
is Linux specific and is available only on the IA-64 architecture.
.SH NOTES
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.SH "SEE ALSO"
.BR gprof(1),
.I The perfmon2 interface specification

3
man2/prctl.2
View File

@ -103,7 +103,6 @@ does not represent a valid capability; or
.BR EINVAL
if file capabilities are not enabled in the kernel,
in which case bounding sets are not supported.
.TP
.BR PR_SET_CHILD_SUBREAPER " (since Linux 3.4)"
.\" commit ebec18a6d3aa1e7d84aab16225e87fd25170ec2b
@ -129,13 +128,11 @@ will receive a
signal and be able to
.BR wait (2)
on the process to discover its termination status.
.TP
.BR PR_GET_CHILD_SUBREAPER " (since Linux 3.4)"
Return the "child subreaper" setting of the caller,
in the location pointed to by
.IR "(int\ *) arg2" .
.TP
.BR PR_SET_DUMPABLE " (since Linux 2.3.20)"
Set the state of the flag determining whether core dumps are produced

7
man2/s390_runtime_instr.2
View File

@ -30,7 +30,6 @@ s390_runtime_instr \- enable/disable s390 CPU run-time instrumentation
.BI "int s390_runtime_instr(int " command ", int " signum ");
.fi
.SH DESCRIPTION
The
.BR s390_runtime_instr ()
@ -51,7 +50,6 @@ argument specifies the number of a real-time signal.
The real-time signal is sent to the thread if the run-time instrumentation
buffer is full or if the run-time-instrumentation-halted interrupt
occurred.
.SH RETURN VALUE
On success,
.BR s390_runtime_instr ()
@ -63,7 +61,6 @@ instrumentation.
On error, \-1 is returned and
.IR errno
is set to one of the error codes listed below.
.SH ERRORS
.TP
.B EINVAL
@ -78,19 +75,15 @@ Allocating memory for the run-time instrumentation control block failed.
.TP
.B EOPNOTSUPP
The run-time instrumentation facility is not available.
.SH VERSIONS
This system call is available since Linux 3.7.
.SH CONFORMING TO
This Linux-specific system call is only available on the s390 architecture.
The run-time instrumentation facility is available beginning with System z EC12.
.SH NOTES
Glibc does not provide a wrapper for this system call, use
.BR syscall (2)
to call it.
.SH SEE ALSO
.BR syscall (2),
.BR signal (7)

3
man2/timerfd_create.2
View File

@ -369,14 +369,12 @@ These system calls are available on Linux since kernel 2.6.25.
Library support is provided by glibc since version 2.8.
.SH CONFORMING TO
These system calls are Linux-specific.
.SH BUGS
Currently,
.\" 2.6.29
.BR timerfd_create ()
supports fewer types of clock IDs than
.BR timer_create (2).
.SH EXAMPLE
The following program creates a timer and then monitors its progress.
The program accepts up to three command-line arguments.
@ -539,7 +537,6 @@ main(int argc, char *argv[])
exit(EXIT_SUCCESS);
}
.fi
.SH "SEE ALSO"
.BR eventfd (2),
.BR poll (2),

1
man2/vfork.2
View File

@ -229,7 +229,6 @@ with
specified as:
CLONE_VM | CLONE_VFORK | SIGCHLD
.SS History
The
.BR vfork ()

1
man3/getaddrinfo_a.3
View File

@ -390,7 +390,6 @@ main(int argc, char *argv[])
exit(EXIT_SUCCESS);
}
.fi
.SS Asynchronous Example
This example shows a simple interactive
.BR getaddrinfo_a ()

3
man3/getenv.3
View File

@ -88,18 +88,15 @@ The
.BR getenv ()
function returns a pointer to the value in the
environment, or NULL if there is no match.
.SH VERSIONS
.BR secure_getenv ()
first appeared in glibc 2.17.
.SH "CONFORMING TO"
.BR getenv ():
SVr4, POSIX.1-2001, 4.3BSD, C89, C99.
.BR secure_getenv ()
is a GNU extension.
.SH NOTES
The strings in the environment list are of the form \fIname=value\fP.

3
man3/if_nameindex.3
View File

@ -99,12 +99,10 @@ function first appeared in glibc 2.1, but before glibc 2.3.4,
the implementation only supported interfaces with IPv4 addresses.
Support of interfaces that don't have IPv4 addresses is only available
on kernels that support netlink.
.SH CONFORMING TO
RFC\ 3493, POSIX.1-2001.
This function first appeared in BSDi.
.SH EXAMPLE
The program below demonstrates the use of the functions described
on this page.
@ -143,7 +141,6 @@ main(int argc, char *argv[])
exit(EXIT_SUCCESS);
}
.fi
.SH SEE ALSO
.BR getsockopt (2),
.BR setsockopt (2),

1
man3/if_nametoindex.3
View File

@ -49,7 +49,6 @@ The name is placed in the buffer pointed to by
The buffer must allow for the storage of at least
.B IF_NAMESIZE
bytes.
.SH RETURN VALUE
On success,
.BR if_nametoindex ()

1
man3/mcheck.3
View File

@ -155,7 +155,6 @@ But, using
.B MALLOC_CHECK_
does not require the application to be relinked.
.\" But is MALLOC_CHECK_ slower?
.SH EXAMPLE
The program below calls
.BR mcheck ()

1
man3/pthread_setname_np.3
View File

@ -107,7 +107,6 @@ filesystem:
.IR /proc/self/task/[tid]/comm .
.BR pthread_getname_np ()
retreives it from the same location.
.SH EXAMPLE
.PP
The program below demonstrates the use of

2
man3/scanf.3
View File

@ -678,7 +678,6 @@ The usage of
is not the same as on 4.4BSD,
as it may be used in float conversions equivalently to
.BR L .
.SH EXAMPLE
To use the dynamic allocation conversion specifier, specify
.B m
@ -713,7 +712,6 @@ As shown in the above example, it is only necessary to call
if the
.BR scanf ()
call successfully read a string.
.SH "SEE ALSO"
.BR getc (3),
.BR printf (3),

2
man4/cciss.4
View File

@ -253,9 +253,7 @@ Once the SCSI core is engaged by the driver, it cannot be disengaged
Note also that if no sequential access devices or medium changers are
detected, the SCSI core will not be engaged by the action of the above
script.
.SS Hot plug support for SCSI tape drives
Hot plugging of SCSI tape drives is supported, with some caveats.
The
.B cciss

1
man4/hpsa.4
View File

@ -99,7 +99,6 @@ For example:
# \fBcat firmware_revision\fP
7.14
.fi
.SS HPSA-Specific Disk Attribute Files in /sys
.TP
.I /sys/class/scsi_disk/c:b:t:l/device/unique_id

1
man5/core.5
View File

@ -183,7 +183,6 @@ if
.I /proc/sys/fs/suid_dumpable
is set to 2 ("suidsafe"), the pattern must be either an absolute pathname
(starting with a leading \(aq/\(aq character) or a pipe, as defined below.
.SS Piping core dumps to a program
Since kernel 2.6.19, Linux supports an alternate syntax for the
.I /proc/sys/kernel/core_pattern

8
man5/gai.conf.5
View File

@ -17,10 +17,8 @@
.\"
.\" Author: Ulrich Drepper <drepper@redhat.com>
.TH GAI.CONF 5 2013-02-13 ""Linux" "Linux Programmer's Manual"
.SH NAME
gai.conf \- getaddrinfo(3) configuration file
.SH DESCRIPTION
A call to
.BR getaddrinfo (3)
@ -50,7 +48,6 @@ All the label definitions
of the default table which are to be maintained have to be duplicated.
Following the keyword,
the line has to contain a network mask and a label value.
.TP
\fBprecedence\fR \fInetmask\fR \fIprecedence\fR
This keyword is similar to \fBlabel\fR, but instead the value is added
@ -58,7 +55,6 @@ to the precedence table as specified in RFC\ 3484.
Once again, the
presence of a single \fBprecedence\fR line in the configuration file
causes the default table to not be used.
.TP
\fBreload\fR <\fByes\fR|\fBno\fR>
This keyword controls whether a process checks whether the configuration
@ -68,18 +64,14 @@ If the value is
This might cause problems in multi-threaded
applications and is generally a bad idea.
The default is "\fBno\fR".
.TP
\fBscopev4\fR \fImask\fR \fIvalue\fR
Add another rule to the RFC\ 3484 scope table for IPv4 address.
By default, the scope IDs described in section 3.2 in RFC\ 3438 are used.
Changing these defaults should hardly ever be necessary.
.SH FILES
\fI/etc/gai.conf\fR
.SH EXAMPLE
The default table according to RFC\ 3484 would be specified with the
following configuration file:

1
man5/networks.5
View File

@ -43,7 +43,6 @@ the end of the current line,
are ignored by library functions that process the file.
The field descriptions are:
.TP
.I name
The symbolic name for the network.

1
man5/nscd.conf.5
View File

@ -230,7 +230,6 @@ This option is valid only for services
and
.IR group .
.RE
.SH "SEE ALSO"
.BR nscd (8)
.\" .SH AUTHOR

5
man5/nss.5
View File

@ -67,7 +67,6 @@ The content of the
.I netid.byname
map is used \fBas is\fR.
The system administrator has to make sure it is correctly generated.
.TP
\fBSERVICES_AUTHORITATIVE =\fR \fITRUE\fR|\fIFALSE\fR
If set to TRUE, the NIS backend for the
@ -80,7 +79,6 @@ NIS map exists and is authoritative, particularly
that it contains both keys with /proto and without /proto for both
primary service names and service aliases.
The system administrator has to make sure it is correctly generated.
.TP
\fBSETENT_BATCH_READ =\fR \fITRUE\fR|\fIFALSE\fR
If set to TRUE, the NIS backend for the
@ -99,12 +97,9 @@ or
.BR getgrent (3)
call might result in a network communication with the server to get
the next entry.
.SH FILES
\fI/etc/default/nss\fR
.SH EXAMPLE
The default configuration corresponds to the following configuration file:
.nf

2
man7/aio.7
View File

@ -163,7 +163,6 @@ or was greater than the limit returned by the call
The POSIX AIO interfaces are provided by glibc since version 2.1.
.SH CONFORMING TO
POSIX.1-2001, POSIX.1-2008.
.SH NOTES
It is a good idea to zero out the control block buffer before use (see
.BR memset (3)).
@ -193,7 +192,6 @@ reimplemented using the kernel system calls.
.\" http://lse.sourceforge.net/io/aio.html
.\" http://lse.sourceforge.net/io/aionotes.txt
.\" http://lwn.net/Articles/148755/
.SH EXAMPLE
The program below opens each of the files named in its command-line
arguments and queues a request on the resulting file descriptor using

1
man7/arp.7
View File

@ -121,7 +121,6 @@ ATF_NETMASK:Use a netmask
ATF_DONTPUB:Don't answer
.TE
.RE
.PP
If the
.B ATF_NETMASK

1
man7/numa.7
View File

@ -180,7 +180,6 @@ Some distributions include the development library and header
in the separate
.I numactl-devel
package.
.SH "SEE ALSO"
.BR get_mempolicy (2),
.BR mbind (2),

1
man7/socket.7
View File

@ -198,7 +198,6 @@ T}
.\" or
.\" .BR close (2).
.TE
.PP
An alternative to
.BR poll (2)

3
man7/udplite.7
View File

@ -121,7 +121,6 @@ All errors documented for
.BR udp (7)
may be returned.
UDP-Lite does not add further errors.
.SH FILES
.I /proc/net/snmp
\- basic UDP-Litev4 statistics counters.
@ -131,7 +130,6 @@ UDP-Lite does not add further errors.
.SH VERSIONS
UDP-Litev4/v6 first appeared in Linux 2.6.20.
.SH BUGS
.\" FIXME . remove this section once glibc supports UDP-Lite
Where glibc support is missing, the following definitions are needed:
@ -144,7 +142,6 @@ Where glibc support is missing, the following definitions are needed:
#define UDPLITE_RECV_CSCOV 11
.fi
.in
.SH "SEE ALSO"
.BR ip (7),
.BR ipv6 (7),