Commit Graph

3764 Commits

Author SHA1 Message Date
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
Michael Kerrisk 4d66746f31 sched_setscheduler.2: srcfix: note commit for SCHED_BATCH
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-23 07:26:40 +02:00
Michael Kerrisk 4f56bc07cd sched_get_priority_max.2: Add SCHED_IDLE to discussion
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-23 07:22:58 +02:00
Michael Kerrisk 11256884de Removed trailing white space at end of lines 2013-09-17 08:27:46 +02:00
Michael Kerrisk 48b6f08669 ioctl_list.2, kill.2, nfsservctl.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, syscall.2, fma.3, fmax.3, fmin.3, ip.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-17 08:27:30 +02:00
Michael Kerrisk 4047bc6cfb perf_event_open.2: Reorder text describing fields of 'perf_event_header' structure
Place the fields with the shorter descriptions first, to make the
information easier to read.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-13 09:02:20 +02:00
Michael Kerrisk 2b538c3e53 perf_event_open.2: Minor formatting fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-13 09:01:14 +02:00
Michael Kerrisk 33d6e2c74a perf_event_open.2: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-13 06:39:45 +02:00
Vince Weaver e3c9782b1a perf_event_open.2: PERF_SAMPLE_BRANCH_STACK updates
This started out as just adding the new perf_event_open features
from Linux 3.11 (which was the addition of transactional memory
defines for PERF_SAMPLE_BRANCH_STACK samples) but turned into a
general cleanup of the PERF_SAMPLE_BRANCH_STACK documentation.

The main clarification is that at least one of the non-privilege values
must be set or else perf_event_open will return an EINVAL error.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-13 06:33:02 +02:00
Simon Paillard 50b25c38db clock_getres.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-13 06:32:08 +02:00
Simon Paillard 28955f1570 cpuset.7, initrd.7, pipe.7, symlink.2: wfix: make "filesystem" one word
More s/file system/filesystem/ but multiline (see 9ee4a2b6)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-13 06:31:29 +02:00
J. Bruce Fields 1a7d4eb74c access.2: Fix outdated NFS information
Note that NFS versions since version 3 support an "access" call
so that the client doesn't have to guess permissions or ID
mapping on its own.

(See RFC 1813 sections 1.7 and 3.3.4.)

Signed-off-by: J. Bruce Fields <bfields@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-13 06:29:06 +02:00
Zsbán Ambrus 237565c981 ioctl_list.2: Document FAT_IOCTL_GET_ATTRIBUTES
The attached patch adds four ioctls from linux/msdos_fs.h to the
ioctl_list(2) manpage.

The ioctl FAT_IOCTL_GET_ATTRIBUTES reads FAT attributes of a
file a mounted vfat file system.  I tested this on Linux
2.6.33, an example script can be found at
http://www.perlmonks.com/?node_id=832623

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-08 07:57:45 +02:00
Simon Paillard 5c977011c1 ptrace.2, setns.2, glob.7, ld.so.8: ffix: hyphen-used-as-minus-sign
See http://lintian.debian.org/tags/hyphen-used-as-minus-sign.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-05 13:09:41 +02:00
Michael Kerrisk 78638aae30 clock_getres.2: Note circumstances in which "SMP" note applies.
Reported-by: Rodrigo Campos <rodrigo@sdfg.com.ar>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-05 12:55:47 +02:00
Michael Kerrisk 783d6cb454 clock_getres.2: Add kernel version for CLOCK_*_CPUTIME_ID
CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID
appeared in 2.6.12.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 16:45:44 +02:00
Michael Kerrisk d8b13fb4d9 wait.2: Add details on the fifth argument provided by raw waitid() system call
See https://bugzilla.kernel.org/show_bug.cgi?id=60744

Reported-by: Hannes Landeholm <hannes@jumpstarter.io>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 15:06:22 +02:00
Michael Kerrisk e272bb60c6 clock_getres.2: Add VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 14:27:59 +02:00
Michael Kerrisk 072c0d379e sigwaitinfo.2: Clarify wording of 'timeout' as a "minimum" interval
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 10:39:34 +02:00
Michael Kerrisk 0d9101c438 poll.2: Clarify wording of 'timeout' as a "minimum" interval
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 10:39:34 +02:00
Michael Kerrisk 82a6092b03 futex.2: The 'timeout' can be rounded upwards by clock granularity and also overrun
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 10:39:34 +02:00
Michael Kerrisk 2785cd6cee epoll_wait.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 10:39:34 +02:00
Michael Kerrisk 073f0240a4 select.2: Clarify wording of 'timeout' as a "minimum" interval
Reported-by: G.raud <graud@gmx.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 10:39:34 +02:00
David Prévot 7290621523 ptrace.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 08:18:07 +02:00
David Prévot c576d0b3f2 ptrace.2: pfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 08:17:56 +02:00
Michael Kerrisk e49b8d6737 mmap2.2: wfix
Reported-by: Magnus Reftel <magnus.reftel@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 08:16:24 +02:00
David Prévot 699893d8f9 perf_event_open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-04 08:12:56 +02:00
D. Barbier 61a9bcb381 linkat.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-02 07:50:45 +02:00
Doug Goldstein ef4901931a open.2: Add EINVAL to errors list
EINVAL can be returned by open(2) when the underlying filesystem
doesn't support O_DIRECT. It is documented in the NOTES section
but this patch adds it to the list of possible errors.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-02 07:49:45 +02:00
Zdenek Pavlas 7d082baba6 sigaction.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-09-02 07:40:27 +02:00
Simon Paillard 40f7562094 fstatat.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-22 09:06:31 +02:00
Johan Erlandsson aa60c0d2b2 syscall.2: Correct registers for arm/EABI
Registers was off by one.

Reference:
http://www.arm.linux.org.uk/developer/patches/viewpatch.php?id=3105/4

See also:
http://peterdn.com/post/e28098Hello-World!e28099-in-ARM-assembly.aspx
https://wiki.debian.org/ArmEabiPort
http://en.wikipedia.org/wiki/Calling_convention#ARM

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 10:13:22 +02:00
Robert Harris 2510e4e5a1 open.2: Add mmap(2) to list of calls that fail when given an O_PATH descriptor
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:49:22 +02:00
Johan Erlandsson 415f7e6317 syscall.2: Add missing argument in example
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:33:51 +02:00
Michael Kerrisk 6ace3248f2 setfsgid.2: Refer to setfsuid(2) for an explanation of why setfsgid() is obsolete
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:28:35 +02:00
Michael Kerrisk 4069bc44a6 setfsgid.2: Wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:28:35 +02:00
Michael Kerrisk 2ec26c2b30 setfsuid.2: Wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:28:35 +02:00
Michael Kerrisk 68f2e81eda setfsuid.2: Correct header file in SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-09 09:28:35 +02:00