(split) LDP: Update original to LDP v3.38.

[linuxjm/LDP_man-pages.git] / original / man2 / syscalls.2

diff --git a/original/man2/syscalls.2 b/original/man2/syscalls.2
index 1368297..b7aa6d4 100644 (file)
--- a/original/man2/syscalls.2
+++ b/original/man2/syscalls.2
@@ -26,7 +26,7 @@
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"

-.TH SYSCALLS 2 2012-03-05 "Linux" "Linux Programmer's Manual"
+.TH SYSCALLS 2 2012-03-23 "Linux" "Linux Programmer's Manual"

 .SH NAME
 syscalls \- Linux system calls
 .SH SYNOPSIS
 .SH NAME
 syscalls \- Linux system calls
 .SH SYNOPSIS


@@ -162,13 +162,11 @@ l l l.
 \fBacct\fP(2)
 \fBadd_key\fP(2)       2.6.11
 \fBadjtimex\fP(2)
 \fBacct\fP(2)
 \fBadd_key\fP(2)       2.6.11
 \fBadjtimex\fP(2)

-\fBafs_syscall\fP(2)           Not implemented

 \fBalarm\fP(2)
 \fBalloc_hugepages\fP(2)       2.5.36  Removed in 2.5.44
 \fBbdflush\fP(2)               Deprecated (does nothing)
                since 2.6
 \fBbind\fP(2)
 \fBalarm\fP(2)
 \fBalloc_hugepages\fP(2)       2.5.36  Removed in 2.5.44
 \fBbdflush\fP(2)               Deprecated (does nothing)
                since 2.6
 \fBbind\fP(2)

-\fBbreak\fP(2)         Not implemented

 \fBbrk\fP(2)
 \fBcacheflush\fP(2)    1.2     Not on i386
 \fBcapget\fP(2)        2.2
 \fBbrk\fP(2)
 \fBcacheflush\fP(2)    1.2     Not on i386
 \fBcapget\fP(2)        2.2


@@ -187,7 +185,7 @@ l l l.
 \fBclose\fP(2)
 \fBconnect\fP(2)
 \fBcreat\fP(2)
 \fBclose\fP(2)
 \fBconnect\fP(2)
 \fBcreat\fP(2)

-\fBcreate_module\fP(2)
+\fBcreate_module\fP(2) Removed in 2.6

 \fBdelete_module\fP(2)
 \fBdup\fP(2)
 \fBdup2\fP(2)
 \fBdelete_module\fP(2)
 \fBdup\fP(2)
 \fBdup2\fP(2)


@@ -233,13 +231,11 @@ l l l.
 \fBfstatfs\fP(2)
 \fBfstatfs64\fP(2)     2.6
 \fBfsync\fP(2)
 \fBfstatfs\fP(2)
 \fBfstatfs64\fP(2)     2.6
 \fBfsync\fP(2)

-\fBftime\fP(2)         Not implemented
-.\" Implemented in glibc; see \fBftime\fP(3)

 \fBftruncate\fP(2)
 \fBftruncate64\fP(2)   2.4
 \fBfutex\fP(2) 2.6
 \fBfutimesat\fP(2)     2.6.16
 \fBftruncate\fP(2)
 \fBftruncate64\fP(2)   2.4
 \fBfutex\fP(2) 2.6
 \fBfutimesat\fP(2)     2.6.16

-\fBget_kernel_syms\fP(2)
+\fBget_kernel_syms\fP(2)       Removed in 2.6

 \fBget_mempolicy\fP(2) 2.6.6
 \fBget_robust_list\fP(2)       2.6.17
 \fBget_thread_area\fP(2)       2.6
 \fBget_mempolicy\fP(2) 2.6.6
 \fBget_robust_list\fP(2)       2.6.17
 \fBget_thread_area\fP(2)       2.6


@@ -261,8 +257,6 @@ l l l.
 \fBgetpgid\fP(2)
 \fBgetpgrp\fP(2)
 \fBgetpid\fP(2)
 \fBgetpgid\fP(2)
 \fBgetpgrp\fP(2)
 \fBgetpid\fP(2)

-\fBgetpmsg\fP(2)               Not implemented
-.\" Reserved for STREAMS support

 \fBgetppid\fP(2)
 \fBgetpriority\fP(2)
 \fBgetresgid\fP(2)     2.2
 \fBgetppid\fP(2)
 \fBgetpriority\fP(2)
 \fBgetresgid\fP(2)     2.2


@@ -280,8 +274,6 @@ l l l.
 \fBgetuid32\fP(2)      2.4
 .\" \fBgetunwind\fP(2) 2.4.8   ia64; DEPRECATED
 \fBgetxattr\fP(2)      2.6; 2.4.18
 \fBgetuid32\fP(2)      2.4
 .\" \fBgetunwind\fP(2) 2.4.8   ia64; DEPRECATED
 \fBgetxattr\fP(2)      2.6; 2.4.18

-\fBgtty\fP(2)          Not implemented
-\fBidle\fP(2)          Not implemented

 \fBinit_module\fP(2)
 \fBinotify_add_watch\fP(2)     2.6.13
 \fBinotify_init\fP(2)  2.6.13
 \fBinit_module\fP(2)
 \fBinotify_add_watch\fP(2)     2.6.13
 \fBinotify_init\fP(2)  2.6.13


@@ -312,7 +304,6 @@ l l l.
 \fBlisten\fP(2)
 \fBlistxattr\fP(2)     2.6; 2.4.18
 \fBllistxattr\fP(2)    2.6; 2.4.18
 \fBlisten\fP(2)
 \fBlistxattr\fP(2)     2.6; 2.4.18
 \fBllistxattr\fP(2)    2.6; 2.4.18

-\fBlock\fP(2)          Not implemented

 \fBlookup_dcookie\fP(2)        2.6
 \fBlremovexattr\fP(2)  2.6; 2.4.18
 \fBlseek\fP(2)
 \fBlookup_dcookie\fP(2)        2.6
 \fBlremovexattr\fP(2)  2.6; 2.4.18
 \fBlseek\fP(2)


@@ -337,7 +328,6 @@ l l l.
 \fBmount\fP(2)
 \fBmove_pages\fP(2)    2.6.18
 \fBmprotect\fP(2)
 \fBmount\fP(2)
 \fBmove_pages\fP(2)    2.6.18
 \fBmprotect\fP(2)

-\fBmpx\fP(2)           Not implemented

 \fBmq_getsetattr\fP(2) 2.6.6
 .\" Implements \fBmq_getattr\fP(3) and \fBmq_setattr\fP(3)
 \fBmq_notify\fP(2)     2.6.6
 \fBmq_getsetattr\fP(2) 2.6.6
 .\" Implements \fBmq_getattr\fP(3) and \fBmq_setattr\fP(3)
 \fBmq_notify\fP(2)     2.6.6


@@ -380,8 +370,6 @@ l l l.
 \fBpersonality\fP(2)   1.2
 .\" \fBperfctr\fP(2)   ???     Sparc32, Sparc64
 .\" \fBperfmonctl\fP(2)        ???     ia64
 \fBpersonality\fP(2)   1.2
 .\" \fBperfctr\fP(2)   ???     Sparc32, Sparc64
 .\" \fBperfmonctl\fP(2)        ???     ia64

-\fBphys\fP(2)          Not implemented
-.\" Unimplemented (no slot since 2.1.116)

 \fBpipe\fP(2)
 \fBpipe2\fP(2) 2.6.27
 \fBpivot_root\fP(2)    2.4
 \fBpipe\fP(2)
 \fBpipe2\fP(2) 2.6.27
 \fBpivot_root\fP(2)    2.4


@@ -392,18 +380,15 @@ l l l.
                renamed "pread64" in 2.6
 \fBpreadv\fP(2)        2.6.30
 \fBprlimit\fP(2)       2.6.36
                renamed "pread64" in 2.6
 \fBpreadv\fP(2)        2.6.30
 \fBprlimit\fP(2)       2.6.36

-\fBprof\fP(2)          Not implemented
-\fBprofil\fP(2)                Not implemented
-.\" Implemented in glibc; see \fBprofil\fP(3)
+\fBprocess_vm_readv(2)\fP      3.2
+\fBprocess_vm_writev(2)\fP     3.2

 \fBpselect6\fP(2)      2.6.16
 .\" Implements \fBpselect\fP(2)
 \fBptrace\fP(2)
 \fBpselect6\fP(2)      2.6.16
 .\" Implements \fBpselect\fP(2)
 \fBptrace\fP(2)

-\fBputpmsg\fP(2)               Not implemented
-.\" Reserved for STREAMS support

 \fBpwrite64\fP(2)              Added as "pwrite" in 2.2;
                renamed "pwrite64" in 2.6
 \fBpwritev\fP(2)       2.6.30
 \fBpwrite64\fP(2)              Added as "pwrite" in 2.2;
                renamed "pwrite64" in 2.6
 \fBpwritev\fP(2)       2.6.30

-\fBquery_module\fP(2)  2.2
+\fBquery_module\fP(2)  2.2     Removed in 2.6

 \fBquotactl\fP(2)
 \fBread\fP(2)
 \fBreadahead\fP(2)     2.4.13
 \fBquotactl\fP(2)
 \fBread\fP(2)
 \fBreadahead\fP(2)     2.4.13


@@ -442,7 +427,6 @@ l l l.
 \fBsched_setparam\fP(2)        2.0
 \fBsched_setscheduler\fP(2)    2.0
 \fBsched_yield\fP(2)   2.0
 \fBsched_setparam\fP(2)        2.0
 \fBsched_setscheduler\fP(2)    2.0
 \fBsched_yield\fP(2)   2.0

-\fBsecurity\fP(2)              Not implemented

 \fBselect\fP(2)
 \fBsemctl\fP(2)
 \fBsemget\fP(2)
 \fBselect\fP(2)
 \fBsemctl\fP(2)
 \fBsemget\fP(2)


@@ -520,7 +504,6 @@ l l l.
 \fBstatfs\fP(2)
 \fBstatfs64\fP(2)      2.6
 \fBstime\fP(2)
 \fBstatfs\fP(2)
 \fBstatfs64\fP(2)      2.6
 \fBstime\fP(2)

-\fBstty\fP(2)          Not implemented

 \fBsubpage_prot\fP(2)  2.6.25  PowerPC if CONFIG_PPC_64K_PAGES
 \fBswapoff\fP(2)
 \fBswapon\fP(2)
 \fBsubpage_prot\fP(2)  2.6.25  PowerPC if CONFIG_PPC_64K_PAGES
 \fBswapoff\fP(2)
 \fBswapon\fP(2)


@@ -553,12 +536,7 @@ l l l.
 \fBtkill\fP(2) 2.6; 2.4.22
 \fBtruncate\fP(2)
 \fBtruncate64\fP(2)    2.4
 \fBtkill\fP(2) 2.6; 2.4.22
 \fBtruncate\fP(2)
 \fBtruncate64\fP(2)    2.4

-\fBtuxcall\fP(2)               Not implemented
-.\" Unimplemented; no slot on i386
-.\" As at 2.6.22, tuxcall has a slot on PowerPC, x86_64, and alpha

 \fBugetrlimit\fP(2)    2.4
 \fBugetrlimit\fP(2)    2.4

-\fBulimit\fP(2)                Not implemented
-.\" Implemented in glibc; see \fBulimit\fP(3)

 \fBumask\fP(2)
 \fBumount\fP(2)
 .\" sys_oldumount() -- __NR_umount
 \fBumask\fP(2)
 \fBumount\fP(2)
 .\" sys_oldumount() -- __NR_umount


@@ -578,7 +556,6 @@ l l l.
 \fBvm86old\fP(2)
 .\" Superseded by \fBvm86\fP(2)
 \fBvmsplice\fP(2)      2.6.17
 \fBvm86old\fP(2)
 .\" Superseded by \fBvm86\fP(2)
 \fBvmsplice\fP(2)      2.6.17

-\fBvserver\fP(2)               Not implemented

 \fBwait4\fP(2)
 \fBwaitid\fP(2)        2.6.10
 \fBwaitpid\fP(2)
 \fBwait4\fP(2)
 \fBwaitid\fP(2)        2.6.10
 \fBwaitpid\fP(2)


@@ -591,9 +568,7 @@ On many platforms, including i386, socket calls are all multiplexed
 .BR socketcall (2)
 and similarly System V IPC calls are multiplexed through
 .BR ipc (2).
 .BR socketcall (2)
 and similarly System V IPC calls are multiplexed through
 .BR ipc (2).

-.SH NOTES
-Note the following points:
-.IP * 3
+

 Although slots are reserved for them in the system call table,
 the following system calls are not implemented in the standard kernel:
 .BR afs_syscall (2), \" __NR_afs_syscall is 53 on Linux 2.6.22/i386
 Although slots are reserved for them in the system call table,
 the following system calls are not implemented in the standard kernel:
 .BR afs_syscall (2), \" __NR_afs_syscall is 53 on Linux 2.6.22/i386


@@ -612,6 +587,7 @@ the following system calls are not implemented in the standard kernel:
 .\" __NR_security is 223 on Linux 2.4/i386; absent on 2.6/i386, present
 .\" on a couple of 2.6 architectures
 .BR security (2),    \" __NR_security is 223 on Linux 2.4/i386
 .\" __NR_security is 223 on Linux 2.4/i386; absent on 2.6/i386, present
 .\" on a couple of 2.6 architectures
 .BR security (2),    \" __NR_security is 223 on Linux 2.4/i386

+.\" The security call is for future use.

 .BR stty (2),        \" __NR_stty is 31 on Linux 2.6.22/i386
 .BR tuxcall (2),     \" __NR_tuxcall is 184 on x86_64, also on PPC and alpha
 .BR ulimit (2),      \" __NR_ulimit is 58 on Linux 2.6.22/i386
 .BR stty (2),        \" __NR_stty is 31 on Linux 2.6.22/i386
 .BR tuxcall (2),     \" __NR_tuxcall is 184 on x86_64, also on PPC and alpha
 .BR ulimit (2),      \" __NR_ulimit is 58 on Linux 2.6.22/i386


@@ -631,14 +607,13 @@ is in use since kernel 2.1.116 for
 .BR umount (2);
 .BR phys (2)
 will never be implemented.
 .BR umount (2);
 .BR phys (2)
 will never be implemented.

-.IP *

 The
 .BR getpmsg (2)
 and
 .BR putpmsg (2)
 calls are for kernels patched to support STREAMS,
 and may never be in the standard kernel.
 The
 .BR getpmsg (2)
 and
 .BR putpmsg (2)
 calls are for kernels patched to support STREAMS,
 and may never be in the standard kernel.

-.\" The security call is for future use.
+.SH NOTES

 .PP
 Roughly speaking, the code belonging to the system call
 with number __NR_xxx defined in
 .PP
 Roughly speaking, the code belonging to the system call
 with number __NR_xxx defined in