summaryrefslogtreecommitdiff
path: root/man2
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2013-02-18 18:45:32 +0100
committerMichael Kerrisk <mtk.manpages@gmail.com>2013-02-18 18:45:32 +0100
commit6b4dbb25e92bfb95b58f98f229c23480e8271191 (patch)
tree0a2fad79e22490398fc5b6d447c5b765343d8488 /man2
parent7aa48d58c5899289673e8303b22da77868eb5005 (diff)
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>
Diffstat (limited to 'man2')
-rw-r--r--man2/delete_module.21
-rw-r--r--man2/epoll_create.21
-rw-r--r--man2/getpeername.21
-rw-r--r--man2/getpriority.21
-rw-r--r--man2/getrlimit.22
-rw-r--r--man2/getunwind.27
-rw-r--r--man2/init_module.23
-rw-r--r--man2/kcmp.223
-rw-r--r--man2/mmap.21
-rw-r--r--man2/perf_event_open.23
-rw-r--r--man2/perfmonctl.26
-rw-r--r--man2/prctl.23
-rw-r--r--man2/s390_runtime_instr.27
-rw-r--r--man2/timerfd_create.23
-rw-r--r--man2/vfork.21
15 files changed, 0 insertions, 63 deletions
diff --git a/man2/delete_module.2 b/man2/delete_module.2
index 98f91a16..3c129494 100644
--- a/man2/delete_module.2
+++ b/man2/delete_module.2
@@ -138,7 +138,6 @@ function, and
.B O_TRUNC
was not specified in
.IR flags .
-
.TP
.B EFAULT
.I name
diff --git a/man2/epoll_create.2 b/man2/epoll_create.2
index 4055fd02..344d648f 100644
--- a/man2/epoll_create.2
+++ b/man2/epoll_create.2
@@ -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
diff --git a/man2/getpeername.2 b/man2/getpeername.2
index b08ac892..61d0f7f0 100644
--- a/man2/getpeername.2
+++ b/man2/getpeername.2
@@ -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),
diff --git a/man2/getpriority.2 b/man2/getpriority.2
index 79ba23cb..1b761120 100644
--- a/man2/getpriority.2
+++ b/man2/getpriority.2
@@ -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),
diff --git a/man2/getrlimit.2 b/man2/getrlimit.2
index 7ec1c9f5..ad4a4768 100644
--- a/man2/getrlimit.2
+++ b/man2/getrlimit.2
@@ -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 ().
diff --git a/man2/getunwind.2 b/man2/getunwind.2
index 560d517f..108202d4 100644
--- a/man2/getunwind.2
+++ b/man2/getunwind.2
@@ -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)
diff --git a/man2/init_module.2 b/man2/init_module.2
index 2215aac1..be7dfd9d 100644
--- a/man2/init_module.2
+++ b/man2/init_module.2
@@ -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
diff --git a/man2/kcmp.2 b/man2/kcmp.2
index a57bcc61..49bb03ee 100644
--- a/man2/kcmp.2
+++ b/man2/kcmp.2
@@ -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)
diff --git a/man2/mmap.2 b/man2/mmap.2
index f7a1607e..6441f6b4 100644
--- a/man2/mmap.2
+++ b/man2/mmap.2
@@ -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 .
diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index ed468f26..dd12d34d 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -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
diff --git a/man2/perfmonctl.2 b/man2/perfmonctl.2
index 957fb147..c7484422 100644
--- a/man2/perfmonctl.2
+++ b/man2/perfmonctl.2
@@ -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
diff --git a/man2/prctl.2 b/man2/prctl.2
index 012af4d5..0e930b3d 100644
--- a/man2/prctl.2
+++ b/man2/prctl.2
@@ -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
diff --git a/man2/s390_runtime_instr.2 b/man2/s390_runtime_instr.2
index 0b60faa7..b76e49a0 100644
--- a/man2/s390_runtime_instr.2
+++ b/man2/s390_runtime_instr.2
@@ -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)
diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2
index 3bba13b4..2e0e285b 100644
--- a/man2/timerfd_create.2
+++ b/man2/timerfd_create.2
@@ -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),
diff --git a/man2/vfork.2 b/man2/vfork.2
index e4856451..39fba89c 100644
--- a/man2/vfork.2
+++ b/man2/vfork.2
@@ -229,7 +229,6 @@ with
specified as:
CLONE_VM | CLONE_VFORK | SIGCHLD
-
.SS History
The
.BR vfork ()