LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
10,244 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

3801 Commits

Author SHA1 Message Date
Michael Kerrisk c7680dfb5d fstatat.2: AT_EMPTY_PATH and AT_NO_AUTOMOUNT are Linux-specific 
These flags require _GNU_SOURCE.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-20 11:08:59 +01:00
Michael Kerrisk 81906d23dd linkat.2: AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-20 11:08:59 +01:00
Michael Kerrisk fc3df5accd fchownat.2: AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-20 11:08:59 +01:00
Michael Kerrisk eceaee4705 fcntl.2: Warn that F_GETLK info may already be out of date when the call returns 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-20 08:34:28 +01:00
Michael Kerrisk dc45cae328 fcntl.2: Minor fix: reorder constants to match order of accompanying text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-20 08:32:14 +01:00
Michael Kerrisk b73bf0aed0 syscalls.2: SEE ALSO: add intro(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-19 12:42:03 +01:00
Michael Kerrisk 49bd7f5828 intro.2: Describe policy on documenting differences between syscall and glibc API 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-19 12:28:12 +01:00
Michael Kerrisk 051ec121f0 ptrace.2: Make it clearer that glibc and syscall APIs differ for PTRACE_PEEK* 
Thanks to Denys Vlasenko's additions in 78686915ae
this page does note that the glibc API for PTRACE_PEEK*
differs from the raw syscall interface. But, as the report
at https://bugzilla.kernel.org/show_bug.cgi?id=70801 shows,
this information could be more obvious. This patch makes its so.

Reported-by: Andrew Hunter <ahh@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-19 11:41:33 +01:00
Michael Kerrisk 36f5dd10ba ptrace.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-19 10:34:42 +01:00
Michael Kerrisk a71b27f8bb ptrace.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-19 09:24:51 +01:00
Michael Kerrisk e00c3a0754 close.2, getdomainname.2, getrlimit.2, madvise.2, sysinfo.2, umask.2, encrypt.3, fclose.3, fflush.3, lockf.3, rand.3, strtok.3, toupper.3, updwtmp.3, utmp.5, environ.7, hier.7, suffixes.7: Convert pages contain non-ASCII in source code comments to use UTF-8 
Done using a slightly modified version of Peter Schiffer's
convert_to_utf_8.sh script. The script was modified so as *not*
a "coding:" marker to the groff source. For now, we'll only put
that marker on pages that contain non-ASCII characters in the
rendered text.

See https://bugzilla.kernel.org/show_bug.cgi?id=60807

Reported-by: Weizhou Pan <cs.wzpan@gmail.com>
Co-written-by: Peter Schiffer <pschiffe@redhat.com
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-16 08:21:18 +01:00
Michael Kerrisk 7a9d6ddece Removed trailing white space at end of lines 2014-02-11 12:17:35 +01:00
Michael Kerrisk 3bab9a5117 gettid.2, restart_syscall.2, lockf.3, passwd.5, socket.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 11:43:48 +01:00
Michael Kerrisk 9798ddfd58 recv.2: Describe the various cases where the return value can be 0 
Reported-by: 未卷起的浪 <ayjj_8109@qq.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 11:13:36 +01:00
Michael Kerrisk ea62994487 recv.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:59:41 +01:00
Michael Kerrisk bba8774703 recv.2: Improve text describing recvfrom() call that is equivalent to recv() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:57:41 +01:00
Michael Kerrisk 00b5fccba3 recv.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:55:32 +01:00
Michael Kerrisk 9c3b78a358 recv.2: Add description of 'buf' and 'len' in recvfrom() section 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:50:22 +01:00
Michael Kerrisk 0ec495cbfb recv.2: Rework discussion of 'src_addr' and 'addrlen' for recvfrom() 
The existing text was a bit opaque.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:44:38 +01:00
Michael Kerrisk a08d6a0720 recv.2: 'addrlen' should be 0 (*not* NULL) when 'src_addr' is NULL 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:32:16 +01:00
Michael Kerrisk 5f09a92997 recv.2: Add an .SS head for discussion of 'flags' 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:29:58 +01:00
Michael Kerrisk 183ec51374 recv.2: Isolate details specific to recv() vs recvfrom() vs recvmsg() 
Place details specific to each system call under a
a separate subheading.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:27:19 +01:00
Michael Kerrisk 7cb04a61d3 recv.2: Minor reworking of text on poll() and select() 
And add mention of epoll(7).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:22:25 +01:00
Michael Kerrisk 4dad515699 recv.2: Rework sentence introducing 'flags' 
The 'flags' argument is common to all three system calls,
not specific to recv().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:20:16 +01:00
Michael Kerrisk e39a21b58b recv.2: Rework opening paragraph to mention recv() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 10:19:43 +01:00
Michael Kerrisk 757610599a pipe.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 09:55:41 +01:00
Michael Kerrisk aeabba5095 pipe.2: Document the pipe2() O_DIRECT added in Linux 3.4 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 09:54:44 +01:00
Michael Kerrisk 781c32a311 pipe.2: Reorder pipe2() flags alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-11 09:18:02 +01:00
Michael Kerrisk 0d55b37f8c open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 22:01:28 +01:00
Michael Kerrisk 92cfcaf7e5 prctl.2: PR_SET_PDEATHSIG value is preserved across execve(2) 
Reported-by: Марк Коренберг <socketpair@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 11:09:38 +01:00
Michael Kerrisk ffd4dec0f7 perf_event_open.2, endian.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 11:03:45 +01:00
Michael Kerrisk 0ec954eeef gettid.2, restart_syscall.2, passwd.5, socket.7: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 10:26:57 +01:00
Michael Kerrisk 5ebe61d65c perf_event_open.2: srcfix: remove redundant .RE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 10:12:29 +01:00
Michael Kerrisk fecd584f0c perf_event_open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 09:52:05 +01:00
Michael Kerrisk 0ae31c567c init_module.2, kcmp.2, getutent.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 09:34:32 +01:00
Michael Kerrisk c5ae6d5a2a nanosleep.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 09:17:04 +01:00
Michael Kerrisk 42069c2bd7 clone.2, pthread_attr_setstack.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 09:13:21 +01:00
Michael Kerrisk 0fe9e4b13a perf_event_open.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 08:40:15 +01:00
Simon Paillard c367cd59b1 ffix: add space between word and punctuation if BR or IR 
Detected through the regex:
	git grep -P '^\.(BR|IR) [^ ]*[,\.]$'

Could probably be extended to match more cases and fix in perl.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 08:00:35 +01:00
Simon Paillard bcc7c6dc34 set_mempolicy.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-10 07:55:17 +01:00
Michael Kerrisk 0a10242a35 shmctl.2: Note that 'buf' is ignored for IPC_RMID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-07 14:29:36 +01:00
Michael Kerrisk d91f6d6f19 shmctl.2: Minor wording improvement 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-07 14:23:14 +01:00
Michael Kerrisk b355b7bd8b msgctl.2: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-07 14:21:50 +01:00
Michael Kerrisk 313dfec558 msgctl.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-07 13:12:59 +01:00
Cyril Hrubis 19402081af msgctl.2: Add note about ignored arg to IPC_RMID 
Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-07 13:10:04 +01:00
Michael Kerrisk 4f72d935e5 getxattr.2, listxattr.2, removexattr.2, setxattr.2: Correct header file is <sys/xattr.h> (not <xattr/xattr.h>) 
See https://bugzilla.kernel.org/show_bug.cgi?id=70141

Reported-by: Fabrice Bauzac <libnoon@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-06 15:24:36 +01:00
Michael Kerrisk ba96eb7d89 mknod.2: Add Oxford comma 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-05 16:28:58 +01:00
Michael Kerrisk b29ac8d2fd symlinkat.2: Make argument names consistent with symlink(2) page 
See commit bcd49f31a8
and commit f2ae6dde0c

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-05 16:26:44 +01:00
Michael Kerrisk a797afac4e fcntl.2, msgget.2, ptrace.2, request_key.2, shmget.2, sigaction.2, syscalls.2, dbopen.3, euidaccess.3, getgrnam.3, getpwnam.3, strfmon.3, strtol.3, strtoul.3, cciss.4, hpsa.4, mouse.4, termcap.5, charsets.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, unicode.7, utf-8.7: Use Oxford comma 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-05 16:09:11 +01:00
Michael Kerrisk 12ccb8fc15 mbind.2, set_mempolicy.2, sigaction.2, elf.5, hosts.equiv.5, nscd.conf.5: Add Oxford comma 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-05 15:55:41 +01:00
Michael Kerrisk 43ff9b28b8 mknod.2: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-05 15:23:41 +01:00
Michael Kerrisk dec985f92c create_module.2, inotify_add_watch.2, mmap2.2, spu_run.2, aio_fsync.3, aio_read.3, aio_write.3, getnameinfo.3, getutent.3, tty_ioctl.4: grfix (Add a comma) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-04 14:42:17 +01:00
Michael Kerrisk afb3d50c50 rename.2: grfix: add some commas 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-04 11:42:24 +01:00
David Prévot 8abd92fca7 ptrace.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-04 10:02:50 +01:00
David Prévot 053a3e08ad perf_event_open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-04 10:02:32 +01:00
Michael Kerrisk ddacd02601 fallocate.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-04 09:08:43 +01:00
Yuri Kozlov a36b732ee0 fallocate.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-02-04 09:07:59 +01:00
Michael Kerrisk 40df3d0039 epoll_wait.2, poll.2, select.2: Go into more detail on timeout and when call will cease blocking 
Reported-by: Network Nut <sillystack@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-31 07:47:22 +01:00
Michael Kerrisk 3c9b77d571 epoll_wait.2: Remove word "minimum" from the description of 'timeout' 
Reported-by: Network Nut <sillystack@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-29 13:51:22 +01:00
Michael Kerrisk edcf162e3f perf_event_open.2, printf.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-29 13:51:21 +01:00
Michael Kerrisk 49f4f33c2b utimensat.2: Minor wording fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-29 13:51:21 +01:00
Michael Kerrisk 84fc2a6e35 Removed trailing white space at end of lines 2014-01-24 12:06:21 +01:00
Michael Kerrisk add5f3b10b epoll_wait.2, fallocate.2, gets.3, core.5, man-pages.7, netdevice.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 12:05:49 +01:00
Michael Kerrisk 9535c592e6 msgop.2: Document MSG_COPY 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:45:24 +01:00
Michael Kerrisk 9e9f8a2d4f msgop.2: Note that MSG_EXCEPT is Linux-specific 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:45:24 +01:00
Michael Kerrisk ed4c2b6937 msgop.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:45:24 +01:00
Michael Kerrisk 8b04592d3a open.2: spfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:57 +01:00
Michael Kerrisk 0d730fcc90 open.2: BUGS: Verifying O_TMPFILE support requires checking for *two* errors 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:57 +01:00
Michael Kerrisk fd185f5819 open.2: srcfix: Update copyright to add mtk 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:57 +01:00
Michael Kerrisk aa56704a72 linkat.2: Add ENOENT for O_TMPFILE created with O_EXCL 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:57 +01:00
Michael Kerrisk 0115aaedca open.2: Add text on meaning of O_EXCL + O_TMPFILE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:57 +01:00
Michael Kerrisk e1252130e0 open.2: Adjust O_TMPFILE code sample 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:57 +01:00
Michael Kerrisk 4d61d36a8e open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:57 +01:00
Michael Kerrisk 0fb83d0052 open.2: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:57 +01:00
Michael Kerrisk f869dc0479 open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk 566b427d82 open.2: Minor reworking of text referring to fcntl(2) and file status flags 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk fb0840efdd open.2: Remove crufty duplicate text on modifying file status flags 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk 9bde49089c open.2: Add pointer in description to BUGS, for O_ASYNC limitation 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk 40398c1ac7 open.2: Place O_TMPFILE in alphabetical order 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk 72ac726808 open.2: Update CONFORMING TO 
Add POSIX.1-2008.  Add mention of O_TMPFILE.
Update text on various flags that were added in POSIX.1-2008, and
whose definitions can, since glibc 2.12, be obtained by suitably
defining _POSIX_C_SOURCE or _XOPEN_SOURCE

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk 843068bde5 open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk 31c1f2b09e getrlimit.2, madvise.2, mount.2, open.2, perf_event_open.2, send.2: tfix: Consistent capitalization for "(since Linux...)" 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk bbe02b45fb open.2: Note that O_TMPFILE requires per-filesystem support 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk ba03011f40 open.2: Add ENOENT error for O_TMPFILE 
On older kernels that don't support O_TMPFILE, O_TMPFILE +
[O_RDWR or O_WRONLY] will produce the error ENOENT if
the directory specified in 'pathname' does not exist.

Reported-by: Andy Lutomirski <luto@amacapital.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk 8e3353915c open.2: Significant enhancements to O_TMPFILE discussion 
Describe use of linkat() with O_TMPFILE.
Note main use cases for O_TMPFILE.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk e6f89ed221 open.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk f76679cacb open.2: Fixes to Andy Lutomirski's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Andy Lutomirski f2698a42d4 open.2: Document O_TMPFILE 
O_TMPFILE is new in Linux 3.11

Signed-off-by: Andy Lutomirski <luto@amacapital.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:44:56 +01:00
Michael Kerrisk 1d3050c0dd getrlimit.2: Note that rlim_cur can be set lower than current resource consumption 
Reported-by: Марк Коренберг <socketpair@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:39:11 +01:00
Michael Kerrisk 8dc3367531 select.2: RETURN VALUE: Fix discussion of treatment of file descriptor sets 
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=574370

Reported-by: Marc Lehmann <debian-reportbug@plan9.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:13:48 +01:00
Michael Kerrisk 423bd34478 getsockopt.2: SEE ALSO: add ip(7) and udp(7) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-24 11:13:48 +01:00
Michael Kerrisk 7de4a1e357 perf_event_open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-23 15:36:04 +01:00
Michael Kerrisk b3f39642ec perf_event_open.2: Minor fixes to Vince Weaver's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-23 15:36:04 +01:00
Vince Weaver 1e04395903 perf_event_open.2 : PERF_SAMPLE_TRANSACTION support in Linux 3.13 (fwd) 
The following patch adds descriptions of the new perf_event_open.2
PERF_SAMPLE_TRANSACTION sample type as added in Linux 3.13.

The descriptions are based on information provided by Andi Kleen,
both in the e-mail

    [PATCH 1/6] perf, core: Add generic transaction flags v5

sent to the linux-kernel list as well as an e-mail

    [PATCH] Document transaction flags in perf_event_open manpage

sent to the linux-man list.

The implementation is based heavily on the Intel Haswell
processor.  Documentation can be found at this page:
http://software.intel.com/en-us/blogs/2013/05/03/intelr-transactional-synchronization-extensions-intelr-tsx-profiling-with-linux-0
as well as in section 18.11.5.1 of volume 3 of the
Intel 64 and IA-32 Architecture Software Developer's Manual.

Also, someone with better manpage formatting skills than I have
should probably investigate why I can't get the last line of
the change to properly tab-align with the .I transaction
heading.

Cowritten-by: Andi Kleen <andi@firstfloor.org>
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-23 15:36:04 +01:00
Michael Kerrisk 222475b004 ptrace.2: Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-23 15:36:04 +01:00
Michael Kerrisk db6f9ec807 epoll_wait.2: Clarify wording of EINTR error 
See https://bugzilla.kernel.org/show_bug.cgi?id=66571

Reported-by: Jonas Jonsson <jonas@websystem.se>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 14:13:08 +01:00
Michael Kerrisk 2b0b798877 unlinkat.2: ERRORS: Add EISDIR 
See https://bugzilla.kernel.org/show_bug.cgi?id=29702

Reported-by: Mike Frysinger: <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 13:56:46 +01:00
Michael Kerrisk 4999554322 fallocate.2: Note filesystems that support FALLOC_FL_PUNCH_HOLE operation 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 12:45:26 +01:00
Michael Kerrisk b146ac839f lseek.2: Note which filesystems support SEEK_HOLE/SEEK_DATA 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 12:30:49 +01:00
Michael Kerrisk 7e7454efaa keyctl.2: SEE ALSO: mention Documentation/security/keys.txt 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 10:55:00 +01:00
Michael Kerrisk 1c27d5d827 keyctl.2: srcfix: Add FIXME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 10:54:09 +01:00
Michael Kerrisk d6cfaf138d syscalls.2: Remove madvise1() from main list 
madvise1() is one of the system calls that was never
implemented, and listed toward the bottom of the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 04:46:55 +01:00
Michael Kerrisk 1c40a3ed1a faccessat.2: Note that the system call takes only three arguments 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 04:46:55 +01:00
Michael Kerrisk 93265f420c fcntl.2: POSIX.1 specifies F_SETOWN and F_GETOWN for sockets/SIGURG 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 04:46:48 +01:00
Michael Kerrisk 639b33d7b8 fcntl.2: BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-22 04:28:21 +01:00
Michael Kerrisk 7168d2f88b fcntl.2: Add susbsections under BUGS 
There's several bugs listed. It's helpful to mark
them separately.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-21 08:44:44 +01:00
Michael Kerrisk 83894d15e2 ptrace.2: Reworking of Andrey's patches 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-20 13:20:56 +01:00
Andrey Vagin 9a36b8fca0 ptrace.2: Add description for PTRACE_GETSIGMASK and PTRACE_SETSIGMASK 
These two commands allow to examine and change mask of blocked signals.

Signed-off-by: Andrey Vagin <avagin@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-20 10:43:11 +01:00
Andrey Vagin 7a535f54fb ptrace.2: Add description for PTRACE_PEEKSIGINFO 
Retrieve signals without removing them from a queue.

Signed-off-by: Andrey Vagin <avagin@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-20 10:42:13 +01:00
Michael Kerrisk e66b193dd1 timer_create.2: Add pointer to proc(5) for info on /proc/[pid]/timers 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-20 09:09:05 +01:00
Michael Kerrisk f78ed33a65 madvise.2, perf_event_open.2, query_module.2, stat.2, sem_init.3, hpsa.4, rtc.4, st.4, elf.5, filesystems.5, proc.5, environ.7, man-pages.7, regex.7, units.7: Reword to avoid use of "etc." 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-18 23:58:39 +13:00
Michael Kerrisk 5a6194a405 execve.2, get_robust_list.2, getunwind.2, pipe.2, quotactl.2, clock_getcpuclockid.3, endian.3, fmemopen.3, getgrouplist.3, getservent_r.3, mq_notify.3, qsort.3, rtime.3, mailaddr.7: ffix: replace tabs with white space in code examples 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-18 20:47:47 +13:00
Michael Kerrisk 5ecff2297f linkat.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-17 23:46:38 +13:00
Michael Kerrisk c6ba8faeb5 linkat.2: ERRORS: Add EINVAL 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-17 23:46:17 +13:00
Michael Kerrisk 78685d04ec io_getevents.2: spfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-15 17:44:34 +13:00
Michael Kerrisk 158688e55e close.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-15 17:32:58 +13:00
Michael Kerrisk 86f1f045b1 setfsuid.2: spfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-15 17:32:21 +13:00
Michael Kerrisk 9fa65a2e6e mount.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-15 17:30:57 +13:00
Michael Kerrisk 48b58f28a3 sigsuspend.2: spfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-15 17:29:44 +13:00
Michael Kerrisk ab7b0a82df seteuid.2: spfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-15 17:28:56 +13:00
Michael Kerrisk 5116355cda mount.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-15 17:28:06 +13:00
Michael Kerrisk d35326474f Removed trailing white space at end of lines 2014-01-11 08:04:54 +13:00
Michael Kerrisk babc6dd47b syscall.2, syscalls.2, ftw.3, getauxval.3, mcheck.3, puts.3, scanf.3, strftime.3, libc.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-11 06:44:42 +13:00
Michael Kerrisk f14ae16e57 accept.2, clock_getres.2, mkdir.2, request_key.2, wait.2, printf.3, bootparam.7: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-11 06:25:02 +13:00
Michael Kerrisk 76c637e18c getcpu.2, getunwind.2, kcmp.2, mmap.2, perf_event_open.2, perfmonctl.2, quotactl.2, restart_syscall.2, btree.3, dbopen.3, hash.3, recno.3, sched_getcpu.3, elf.5, bootparam.7, hier.7, netdevice.7, rtnetlink.7: wfix: "xxxx specific" ==> "xxxx-specific" 2014-01-11 06:16:28 +13:00
Simon Paillard fd00f12ce5 reboot.2: tfix (double word) and minor format issue 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-11 05:47:54 +13:00
Michael Kerrisk ded44f9b7d setpgid.2: BSD getpgrp() and setpgrp() go away in glibc 2.19 
Reviewed-by: Joseph S. Myers <joseph@codesourcery.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-08 12:14:13 +13:00
Michael Kerrisk 30410190a2 execve.2: Add further cases to EFAULT error 
See https://sourceware.org/bugzilla/show_bug.cgi?id=16402

Reported-by: Marco Dione <mdione@grulic.org.ar>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-08 07:52:49 +13:00
Michael Kerrisk f30b741526 chown.2, clone.2, mmap.2, pipe.2, ftw.3, mq_notify.3: Add "Program source" subheading under EXAMPLE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-05 13:30:41 +13:00
Michael Kerrisk 22617a74a7 mprotect.2: Add "static" to global variable in example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-05 13:30:35 +13:00
Michael Kerrisk 571767ca38 perf_event_open.2: Add "static" qualifier to function in example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-05 13:12:32 +13:00
Michael Kerrisk 9a141bfb1f get_mempolicy.2, mbind.2, mlock.2, set_mempolicy.2, bootparam.7, packet.7: grfix: s/memory mapped/memory-mapped/ when used attributively 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-05 11:00:31 +13:00
Michael Kerrisk b437fdd90a epoll_ctl.2, execve.2, recv.2, timer_create.2, wait.2, argz_add.3, basename.3, dlopen.3, exec.3, fopencookie.3, fts.3, getaddrinfo.3, getcwd.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getlogin.3, getnetent.3, getprotoent.3, getrpcent.3, getservent.3, getusershell.3, glob.3, if_nameindex.3, inet_ntop.3, lio_listio.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mq_notify.3, ptsname.3, realpath.3, setnetgrent.3, sigvec.3, strsignal.3, strtok.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, xdr.3: Global fix of "NULL pointer" 
Change "NULL pointer: to "NUL " or null pointer".
POSIX uses the term "null pointer", not "NULL pointer".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-03 15:47:06 +13:00
Michael Kerrisk 7d182bb660 perf_event_open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-03 15:47:05 +13:00
Michael Kerrisk 314ef95df4 prctl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-03 10:26:45 +13:00
Michael Kerrisk 4651e41294 perf_event_open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-03 10:19:25 +13:00
Michael Kerrisk 850905cf88 clone.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-03 10:13:23 +13:00
Michael Kerrisk 9e802a1f57 spu_create.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-03 10:08:16 +13:00
Mike Frysinger a9deb5e056 ptrace.2: tfix userspace->user space 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:16 +13:00
Mike Frysinger 951ae9c063 syscall.2, syscalls.2, getauxval.3: Add references to new vdso(7) page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:16 +13:00
Michael Kerrisk 10850212d0 uselib.2, getfsent.3, regex.3, nsswitch.conf.5, inotify.7, man-pages.7, symlink.7: Replace uses of "e.g." in main text with "for example" or similar 
Usual man-pages style is to use "e.g." only within
    parenthetical expressions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:16 +13:00
Michael Kerrisk 88879aebdd eventfd.2, set_mempolicy.2, timerfd_create.2, fwide.3, resolver.3, spufs.7, symlink.7, udplite.7, unicode.7: Replace uses of "i.e.," in main text with "that is" or similar 
Usual man-pages style is to use "i.e." only within
parenthetical expressions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:16 +13:00
Michael Kerrisk d332f86f5a socket.2: Remove crufty statement that AF_INET does not support SOCK_SEQPACKET 
Linux AF_INET supports SOCK_SEQPACKET via SCTP.

Reported-by: Dongsheng Song <dongsheng.song@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:16 +13:00
Michael Kerrisk 445319fd4a close.2: Note that errors from close() should be used only for diagnosis 
In particular, retrying after EINTR is a bad idea.

See http://austingroupbugs.net/view.php?id=529

See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37702
Subject: [RFC][BZ #14627] Make linux close errno to EINPROGRESS
         when interrupted in signal.

Reported-by: P?draig Brady <P@draigBrady.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Michael Kerrisk aefd6f899d select_tut.2, dlopen.3, err.3, printf.3: Stylistic changes to code example 
For ease of reading, don't embed assignments inside if().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Michael Kerrisk 17068fad8c utimensat.2: Small wording improvement for times!=NULL case 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Michael Kerrisk 79e20ac183 utimensat.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Mike Frysinger 5e16419235 syscall.2: Fix ia64 registers 
The original list of registers was created by confusing strace
source code--this is for parsing legacy 32-bit code (which is
dead and no one cares). Update the list to reflect native ia64
syscall interface.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Michael Kerrisk 4cead6db49 reboot.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Michael Kerrisk 3b95429be2 reboot.2: Add RB_SW_SUSPEND synonym 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Michael Kerrisk d1d5d51c06 reboot.2: Add RB_KEXEC synonym 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Elie De Brauwer 2d37a9603b reboot.2: Document LINUX_REBOOT_SW_SUSPEND 
Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Elie De Brauwer 0b23bb07a3 reboot.2: Add "Linux" to kernel version numbers 
Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Elie De Brauwer c2e32bfe27 reboot.2: Mention RB_POWER_OFF 
The manpage did not mention RB_POWER_OFF which is the glibc
symbolic name for LINUX_REBOOT_CMD_POWER_OFF.

$ cd /usr/include
$ cat x86_64-linux-gnu/sys/reboot.h | grep POWER_OFF
 define RB_POWER_OFF	0x4321fedc

Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
Michael Kerrisk 2fd2c35cc6 clock_getres.2: Improve description of CLOCK_PROCESS_CPUTIME_ID 
See https://bugzilla.kernel.org/show_bug.cgi?id=67291

Reported-by:  Nadav Har'El <nyh@math.technion.ac.il>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:15 +13:00
David Prévot cd7c700a16 perf_event_open.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:14 +13:00
Michael Kerrisk 7607f23546 perf_event_open.2: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:14 +13:00
Vince Weaver 406650db6b perf_event_open.2: Clarify issues with the disabled bit 
Clarify the perf_event_open behavior with respect to the disabled
bit and creating event groups.

Reported-by: Sudhanshu Goswami <Sudhanshu.Goswami@emc.com>
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-01-02 11:49:08 +13:00
Vince Weaver bea10c8c40 perf_event_open.2. Clarify issues with the exclusive bit 
Warn that using the perf_event_open "exclusive" bit, while it might seem
like a good idea, might lead to all 0 results in some common usage cases.

Reported-by: Sudhanshu Goswami <Sudhanshu.Goswami@emc.com>
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-27 07:31:46 +13:00
Michael Kerrisk b8efc3ed61 Removed trailing white space at end of lines 2013-12-12 20:42:43 +13:00
Michael Kerrisk 42f05d6438 futex.2, send.2, setreuid.2, malloc.3, tcp.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 20:40:15 +13:00
Michael Kerrisk f2d15dc910 perf_event_open.2: ffix + tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:45:03 +13:00
Vince Weaver 75ee11e514 perf_event_open.2: Update description for mmap_data bit 
Here's an updated version of [David Ahern's] patch that
expands the "mmap" definition as well as that of "mmap_data".
Also some manpage related formatting improvements from the
original patch.

Link: https://lkml.org/lkml/2013/11/11/505

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Acked-by: David Ahern <dsahern@gmail.com>
Cc: Arnaldo Carvalho de Melo <acme@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:42:03 +13:00
Vince Weaver a02a1737af perf_event_open.2: cpu/pid argument cleanup 
This patch attempts to clarify the pid and cpu options to
perf_event_open().

It does two things:
  1.  Tries to make clear that the "pid" argument can mean
      process *or* thread.  This is made confusing by
      how Linux uses the terms mostly interchangeably.
  2.  The cpu/pid documentation was confusing because of
      how the parameters are interdependent.  Since there
      are only 6 possible combinations I broke out the
      possibilities into a table.

Reported-by: Manuel Selva <selva.manuel@gmail.com>
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:41:47 +13:00
Michael Kerrisk 7af75ade78 sigpending.2: Note treatment of signals that are blocked *and* ignored 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:16:08 +13:00
Michael Kerrisk 827edbd201 stat.2: wspfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:16:08 +13:00
Trevor Bramwell 25505615fe pipe.2: Fix error in example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:16:08 +13:00
David Prévot 7205b8dfd8 perf_event_open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:16:08 +13:00
David Prévot 8859d3a9e2 perf_event_open.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:16:08 +13:00
David Prévot 27f52b5209 perf_event_open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:16:08 +13:00
Michael Kerrisk 6add864cd4 kcmp.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:16:08 +13:00
Shawn Landden df2f284e48 kcmp.3: Reword slightly awkward section 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:16:08 +13:00
Peng Haitao 6ab6b8e2f9 capget.2: wfix 
Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-12-12 16:16:07 +13:00
Michael Kerrisk 210cded680 poll.2: Clarify meaning of events==0 
events==0 does not mean that revents is always returned as
zero. The "output only" events (POLLHUP, POLLERR, POLLNVAL)
can still be returned.

See https://bugzilla.kernel.org/show_bug.cgi?id=61911

Reported-by: Paolo Bonzini <bonzini@gnu.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-08 07:13:19 +13:00
Michael Kerrisk 82f955d28a ioctl.2: 'request' argument is typed as 'unsigned long' in glibc 
See https://bugzilla.kernel.org/show_bug.cgi?id=42705

Reported-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Reported-by: David Gibson <david@gibson.dropbear.id.au>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-08 06:43:47 +13:00
Michael Kerrisk e9bd9b2ca9 perf_event_open.2: tstamp + white space fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-08 06:43:46 +13:00
Vince Weaver 135cba8b70 perf_event_open.2: Linux 3.12 rdpmc/mmap 
It turns out that the perf_event mmap page rdpmc/time setting was
broken, dating back to the introduction of the feature.  Due
to a mistake with a bitfield, two different values mapped to
the same feature bit.

A new somewhat backwards compatible interface was introduced
in Linux 3.12.  A much longer report on the issue can be found
here:
   https://lwn.net/Articles/567894/

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-08 06:43:46 +13:00
Vince Weaver a0dcc8dd16 perf_event_open.2: Linux 3.12 adds PERF_EVENT_IOC_ID 
A new perf_event related ioctl, PERF_EVENT_IOC_ID, was added
in Linux 3.12.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-08 06:43:46 +13:00
Vince Weaver 7480dabbeb perf_event_open.2: Linux 3.12 adds PERF_SAMPLE_IDENTIFIER 
A new PERF_SAMPLE_IDENTIFIER sample type was added in Linux 3.12.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-08 06:43:46 +13:00
Vince Weaver dab3845542 perf_event_open.2: PERF_COUNT_SW_DUMMY support 
Support for the PERF_COUNT_SW_DUMMY event type was added in
Linux 3.12.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-08 06:43:46 +13:00
Michael Kerrisk 4d4cecd6fa fallocate.2: tfix + tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-08 06:43:46 +13:00
Christoph Hellwig c166fac5cb fallocate.2: Clarify the zeroing behavior 
fallocate() zeroes only space that did not previously contain
data, but leaves existing data untouched.

Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-08 06:43:39 +13:00
Michael Kerrisk 4eec160988 send.2: RETURN VALUE: these calls return number of bytes (not characters) sent 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-04 18:58:07 +13:00
Michael Kerrisk 4256bf84e5 recv.2: Remove out-of-date statement that UNIX domain does not support MSG_TRUNC 
Should have removed that sentence as part of
commit a25601b48b

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-11-04 17:14:07 +13:00
Michael Kerrisk bcd49f31a8 symlink.2: Further fine tuning of argument names 
Follow-up to f2ae6dde0c
See https://sourceware.org/bugzilla/show_bug.cgi?id=16073

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-30 14:53:01 +13:00
David Prévot d6af98f849 perf_event_open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-30 14:46:19 +13:00
Vince Weaver e6cf569408 perf_event_open.2: PERF_EVENT_IOC_PERIOD update 
The PERF_EVENT_IOC_PERIOD ioctl was broken until 2.6.36,
and it turns out that the ARM architecture has some
differing behavior too.

Reported-by: Andreas Sandberg <andreas.sandberg@it.uu.se>
Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-30 14:45:11 +13:00
Michael Kerrisk 297c144f01 setreuid.2: Small clarification to description of when saved set-user-ID is set 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-29 00:25:41 +13:00
Vince Weaver 82b09254af perf_event_open.2: E2BIG documentation 
The following documents the E2BIG error return for
perf_event_open().

I actually ran into this error the hard way and it took me
half a day to figure out why my ->size value was changing.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-26 11:21:38 +13:00
Maxin B. John fa9efa8632 flock.2: tfix 
Signed-off-by: Maxin B. John <maxin.john@enea.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-26 11:04:52 +13:00
Michael Kerrisk 3468b312bc readlink.2: Fix typo in eror message in example program 
Reported-by: Yuanhang Zheng <zhengyhn@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-26 11:00:05 +13:00
Michael Kerrisk f2ae6dde0c symlink.2: Give arguments of symlink() more meaningful names 
Reported-by:  Fabrice Bauzac <libnoon@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-26 10:53:02 +13:00
Rodrigo Campos a605264d16 futex.2: Fix link to Rusty's futex example library 
When I asked to webmaster@kernel.org, Konstantin Ryabitsev
answered that the ".nl." is "an obsolete scheme and really
should be changed to just ftp.kernel.org".

Signed-off-by: Rodrigo Campos <rodrigo@sdfg.com.ar>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-26 10:41:37 +13:00
Michael Kerrisk a2954fe6ed execve.2: 'arg...' for interpreter scripts starts with argv[1] 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-26 06:45:46 +13:00
Michael Kerrisk 1ef5b28054 stat.2: Cosmetic reworking of timestamp discussion in NOTES 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-25 15:42:26 +13:00
Michael Kerrisk 96f92a7cb6 stat.2: Not filesystem support for nanosecond timestamps 
Add some detail on which native filesystems do and don't
support nanosecond timestamps.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-25 15:39:02 +13:00
Michael Kerrisk e9e9e87ecf stat.2: Update discussion of nanosecond timestamps 
The existing text describes the timestamp fields as 'time_t'
and delegates discussion of nanosecond timestamps under NOTES.
Nanosecond timestamps have been around for a while now,
and are in POSIX.1-2008, so reverse the orientation of the
discussion, putting the nanosecond fields into DESCRIPTION
and detailing the historical situation under NOTES.

Reported-by: Yang Yang <yangyang.gnu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-25 15:39:02 +13:00
Michael Kerrisk d2fc9a713e getgroups.2: Document /proc/sys/kernel/ngroups_max 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-18 11:40:30 +13:00
Michael Kerrisk b146454a96 getgroups.2: Clarify that sysconf(_SC_NGROUPS_MAX) is a run-time technique 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-18 11:40:29 +13:00
Michael Kerrisk 1f9e80f0e9 getgroups.2: Note that NGROUPS_MAX is defined in <limits.h> 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2013-10-18 11:35:21 +13:00