Commit Graph

4080 Commits

Author SHA1 Message Date
Michael Kerrisk 3d565ddf9f msgget.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:32:19 +02:00
Michael Kerrisk 7906e74333 msgget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:32:19 +02:00
Michael Kerrisk 143f4ec383 semget.2: Consolidate discussion on noninitialization of semaphores
The fact that semget() does not initialize the semaphores
in a new set was covered in two places (in DESCRIPTION
and BUGS). Consolidate these into one place (in NOTES)
and also point out that POSIX.1-2008 says that a future
version of the standard may require an implementation to
initialize the semaphores to 0.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:52 +02:00
Michael Kerrisk fc06f38c3b semget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:26 +02:00
Michael Kerrisk 96c1bf310b semget.2: Clarify SEMMNS versus SEMMSL*SEMMNI
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:26 +02:00
Michael Kerrisk 80816b0bc4 semget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:26 +02:00
Michael Kerrisk fdc9823c7e semget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:26 +02:00
Michael Kerrisk a6cad8ffbe semget.2: Rework EINVAL text a little
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:22 +02:00
Michael Kerrisk 90db854a0a semget.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:18 +02:00
Michael Kerrisk 32cdf39cfc semget.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:18 +02:00
Michael Kerrisk e9001b5616 semget.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:18 +02:00
Michael Kerrisk 41651a359e shmget.2: Clarify one of the EINVAL cases
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 08:31:18 +02:00
Michael Kerrisk ec64ab7fe3 shmget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 07:28:50 +02:00
Michael Kerrisk 53b81588a7 shmget.2: Note that SHM_NORESERVE is a Linux extension
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 07:28:50 +02:00
Michael Kerrisk a350124d86 shmget.2: Rework EINVAL text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 07:28:46 +02:00
Michael Kerrisk 2ddef2078c shmget.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 07:28:42 +02:00
Michael Kerrisk e1d802d526 shmget.2: Move and rework discussion of mode bits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 07:28:42 +02:00
Michael Kerrisk fbaf6d6e17 shmget.2: Reword description of O_EXCL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 06:49:47 +02:00
Michael Kerrisk 130a878dee shmget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 06:47:19 +02:00
Michael Kerrisk ab99b2544f shmget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 06:44:36 +02:00
Michael Kerrisk b6bf92f60e shmget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 06:44:01 +02:00
Michael Kerrisk 96ad3d6569 shmget.2: Fix kernel version numbers in discussion of SHMALL
Reported-by: Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 06:39:42 +02:00
Simon Paillard 718778adf8 fallocate.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-28 05:03:52 +02:00
Michael Kerrisk a534c01d35 adjtimex.2: srcfix: added FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-27 20:35:22 +02:00
Michael Kerrisk f812eb45e2 adjtimex.2: srcfix: update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-27 20:24:48 +02:00
Michael Kerrisk 432c7b6ab3 adjtimex.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-27 20:21:56 +02:00
Michael Kerrisk 2b37574409 adjtimex.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-27 20:20:30 +02:00
Alan Curry 7dd874efc6 sigaction.2: Fix bad cross reference (times(2) not time(2))
The system call that reports child CPU usage is times(2),
not time(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-27 12:05:43 +02:00
Michael Kerrisk 38291c52e5 syscalls.2: srcfix: add FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-26 05:15:03 +02:00
Heinrich Schuchardt a5669b55a0 fanotify_mark.2: tfix
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 19:54:29 +02:00
Michael Kerrisk 5ff1ff149a fanotify_mark.2: ffix: compress prototype a little
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:42:20 +02:00
Michael Kerrisk b3470de1e2 fanotify_mark.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:27:41 +02:00
Michael Kerrisk 3b32c70be9 fanotify_mark.2: Reword FAN_MARK_FLUSH bug
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:27:09 +02:00
Michael Kerrisk 57f87a2c67 fanotify_mark.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:27:09 +02:00
Michael Kerrisk c82b4ae43a fanotify_mark.2: Minor improvement to FAN_MARK_MOUNT text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:27:09 +02:00
Michael Kerrisk 95f6869e5d fanotify_mark.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:27:09 +02:00
Michael Kerrisk 963a156819 fanotify_mark.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:27:08 +02:00
Michael Kerrisk b6551738ec fanotify_mark.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:27:05 +02:00
Michael Kerrisk ddfa9db7c2 fanotify_init.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:11:08 +02:00
Michael Kerrisk 122dd1667c fanotify_init.2: Minor wording improvement
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:07:10 +02:00
Michael Kerrisk f199b3082f fanotify_init.2: Minor wording improvement for O_NONBLOCK
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:05:48 +02:00
Michael Kerrisk cd505a8a22 fanotify_init.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:04:49 +02:00
Michael Kerrisk d58f41903f fanotify_init.2: Minor clarification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:03:11 +02:00
Michael Kerrisk f1282fd068 fanotify_init.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:02:32 +02:00
Michael Kerrisk 72b14a93a1 fanotify_init.2: Minor wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 12:01:06 +02:00
Heinrich Schuchardt c200b422df fanotify_mark.2: New page documenting fanotify_mark(2)
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 07:56:49 +02:00
Heinrich Schuchardt 3e6ebb33e5 fanotify_init.2: New page documenting fanotify_init(2)
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-25 07:56:02 +02:00
Michael Kerrisk 84f573db60 rename.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:55:44 +02:00
Michael Kerrisk 8f60952e38 rename.2: Improve wording of renameat2() ENOENT error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:55:38 +02:00
Michael Kerrisk 5c1517fa0a rename.2: Improve description or renameat2() EINVAL 'flags' error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:45 +02:00
Michael Kerrisk 4e6c4ab2ff rename.2: Add CONFORMING TO and VERSIONS for renameat2()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:45 +02:00
Miklos Szeredi ab99efddee rename.2: Document renameat2()
Some light edits to this patch by mtk.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:45 +02:00
Michael Kerrisk bf253d9b61 syscalls.2: Add renameat2()
And bump kernel version.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:45 +02:00
Michael Kerrisk 11b520ed8f alloc_hugepages.2, futex.2, vm86.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:01 +02:00
Michael Kerrisk 82e683e6bd msync.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:01 +02:00
Peter Schiffer f6374cc2cd set_mempolicy.2: wfix
Hi Michael,

sending minor wording fix for set_mempolicy(2) man page.

peter

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 7fdec06564 open.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 21557928fa open.2: Minor tweaks to Peter Schiffer's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Peter Schiffer e6042e4ad2 open.2: Update note on alignment of user buffer and file offset for O_DIRECT
The sentence in open(2) man page in notes for O_DIRECT flag:

    "Under Linux 2.6, alignment to 512-byte boundaries suffices."

is not universally correct. The alignment is a property of the
storage, for example, 4k-sector drives with no 512 byte sector
emulation will be unable to perform 512-byte direct I/O.

The patch clarifies this sentence.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 20ee63c18c open.2: Remove repetitious text on use of fcntl() to change file status flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 61b12e2b63 open.2: Note some of the various synonyms for "open file description"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 61a37c81ef flock.2: Employ term "open file description" in DESCRIPTION
And include reference to open(2) for an explanation of the term.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 04346be5bb clone.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-23 20:40:00 +02:00
Michael Kerrisk 840324c0d5 msync.2: s/flushes... back to disk/flushes... back to filesystem/
As noted by Heinrich:

    The manpage of msync(2) says:
        "msync() flushes changes made to the in-core copy of a file
        that was mapped into memory using mmap(2) back to disk."
    ...
    "back to disk" implies that the file system is forced to
    actually write to the hard disk, somewhat equivalent to
    invoking sync(1).  Is that guaranteed for all file systems?

    Not all file systems are necessarily disk based
    (e.g. davfs, tmpfs).

    So shouldn't we write:
        "... back to the file system."

    http://pubs.opengroup.org/onlinepubs/007904875/functions/msync.html
    says "... to permanent storage locations, if any,"

Reported-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-21 11:35:20 +02:00
Michael Kerrisk fe8b1358a6 Removed trailing white space at end of lines 2014-04-20 11:06:01 +02:00
Michael Kerrisk 84b349919b madvise.2, msync.2, libc.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 11:05:32 +02:00
Yuri Kozlov a675383214 timer_getoverrun.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 10:46:41 +02:00
Michael Kerrisk 2f4772d2d2 fcntl.2: Note the race when O_CLOEXEC is used at same time as fork()+execve()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 10:46:40 +02:00
Michael Kerrisk 7756d15761 open.2: Add more detail on the race that O_CLOEXEC is designed to avoid
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 10:46:40 +02:00
Michael Kerrisk 5f8ddde3b7 execve.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-20 07:48:15 +02:00
Michael Kerrisk 2af4d967af fallocate.2: Document EINVAL for FALLOC_FL_COLLAPSE_RANGE on non-regular file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-19 10:44:22 +02:00
Simon Paillard 85ad779b17 open_by_handle_at.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-19 10:44:15 +02:00
Michael Kerrisk 1ecfa5b30e fallocate.2: Greatly expanded description of FALLOC_FL_COLLAPSE_RANGE
Reviewed-by: Christoph Hellwig <hch@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-18 17:38:41 +02:00
Michael Kerrisk f78da076c9 fallocate.2: Minor fixes to Namjae Jeon's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:51 +02:00
Namjae Jeon ea56dddf25 fallocate.2: Document FALLOC_FL_COLLAPSE_RANGE
Signed-off-by: Namjae Jeon <namjae.jeon@samsung.com>
Signed-off-by: Ashish Sangwan <a.sangwan@samsung.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:51 +02:00
Michael Kerrisk 098c699809 shmget.2: Rewrite description of SHMMNI default value
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:50 +02:00
Michael Kerrisk c00811f345 shmget.2: Note default value of SHMMAX
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:44 +02:00
Michael Kerrisk e6a38ea607 shmget.2: Note default value for SHMALL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 15:38:37 +02:00
Michael Kerrisk 8ab18f6ce0 shmget.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 13:28:07 +02:00
Michael Kerrisk 2b23ecbdea perf_event_open.2: Explain the EACCES "monitoring all processes" case more precisely
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 09:44:58 +02:00
Michael Kerrisk bec6277efa perf_event_open.2: Change "fd" to "file descriptor"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 09:22:06 +02:00
Michael Kerrisk ee7b0cbfc9 perf_event_open.2: Change "current process" to "calling process" in various places
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 09:22:06 +02:00
Michael Kerrisk ce88f77b91 perf_event_open.2: Minor grammar, formatting, wording, and typo fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-17 09:22:06 +02:00
Vince Weaver 27f0af8e92 perf_event_open.2: clarify EACCES and EPERM errors
Clarify the reasons for EACCES and EPERM errors.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-16 07:50:48 +02:00
Michael Kerrisk 394a1f2787 personality.2: Available execution domains are listed in <sys/personality.h>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:45:17 +02:00
Michael Kerrisk 7bd265778a personality.2: Fix discussion of return value
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:41:07 +02:00
Michael Kerrisk d4421e7cd7 personality.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:41:07 +02:00
Michael Kerrisk b1c5c4ec32 msync.2: Strengthen warning that one of MS_SYNC or MS_ASYNC is required
Reported-by: Greg Troxel <gdt@ir.bbn.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk b60d985933 msync.2: wfix
Reported-by: Christopher Covington <cov@codeaurora.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk 433e3408cb msync.2: Note that one of MS_SYNC or MS_ASYNC should be specified
Reported-by: Richard Hansen <rhansen@bbn.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk 5745985f4e prctl.2: Document PR_SET_THP_DISABLE and PR_GET_THP_DISABLE
Reviewed-by: Alex Thorlton <athorlton@sgi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk 86aa5a2d8c prctl.2: ERRORS: document EINVAL for PR_GET_NO_NEW_PRIVS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk f7a65fc294 prctl.2: ERRORS: document EINVAL for PR_SET_NO_NEW_PRIVS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk 93f15c9153 prctl.2: ERRORS: document EINVAL for PR_SET_TIMING
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk f41882f0d8 prctl.2: ERRORS: document EINVAL for PR_SET_DUMPABLE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk 8a77c41352 prctl.2: ERRORS: document EINVAL for PR_SET_PDEATHSIG
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk 48cb32cdb0 madvise.2: SEE ALSO: see prctl(2)
Because of PR_SET_THP_DISABLE.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk ec3b7804b3 mlock.2: Describe treatment of MCL_FUTURE during fork(2) and execve(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-15 22:18:00 +02:00
Michael Kerrisk 079928f31c perf_event_open.2: Minor wording fixes for EACCES error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-14 12:38:34 +02:00
Michael Kerrisk a61dba3485 perf_event_open.2: Minor clarification to close-on-exec text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 21:54:25 +02:00
Michael Kerrisk accec05152 perf_event_open.2: Minor clean-ups after Vince Weaver's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 21:50:15 +02:00
Vince Weaver d8b7d950dd perf_event_open.2 -- expand ERRORS section
Expand the perf_event_open.2 ERRORS section to be more comprehensive.

These were determined both by code inspection and by writing a large
number of test programs.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 21:24:25 +02:00
Simon Paillard a03c016c7d isalpha.3, stat.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 21:15:37 +02:00
Michael Kerrisk 6549664445 open.2: Remove crufty text stating that O_DIRECTORY is Linux-specific
Reported-by: Matthew Dempsky <mdempsky@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 21:11:50 +02:00
Michael Kerrisk cde2074a45 open.2: Note which filesystems support O_TMPFILE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 06:30:24 +02:00
Michael Kerrisk b8dbf73de8 bdflush.2, fsync.2, mmap.2, open.2, perf_event_open.2, sync.2, syscall.2, fmemopen.3, getaddrinfo.3, getline.3, mq_notify.3, offsetof.3, aio.7, symlink.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:47:35 +02:00
Michael Kerrisk 08107714a5 open_by_handle_at.2: Remove FIXMEs after review by Aneesh Kumar
Reviewed-by: Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:13:47 +02:00
Michael Kerrisk 39c98c7d50 open_by_handle_at.2: Note when glibc support was added
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 3ad5d1b9f6 open_by_handle_at.2: Rework example programs
Rework example programs so that they use a text file (rather
than a binary file) to exchange mount ID and file handle.
Various clean-ups and bug fixes after review by Mike Frysinger.

Reviewed-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 886f35af61 open_by_handle_at.2: ffix 2014-04-06 08:12:26 +02:00
Michael Kerrisk b2fe7451ce open_by_handle_at.2: Fixes after review comments by Mike Frysinger
Reviewed-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk e2199ccbc0 open_by_handle_at.2: Further edits after comments by Neil Brown
Reviewed-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 97236faef5 open_by_handle_at.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 269ad84333 open_by_handle_at.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 74a769f92d open_by_handle_at.2: ERRORS: Remove bogus ENOTDIR error for open_by_handle_at()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:26 +02:00
Michael Kerrisk 3be5b709ad open_by_handle_at.2: ERRORS: change reference from open(2) to openat(2)
Christoph noted that if ERRORS defers to openat(2) rather than
open(2), then a couple of errors can be eliminated from the list
on this page.

Reviewed-by: Christoph Hellwig <hch@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk fb968310b1 open_by_handle_at.2: Various fixes after review by Neil Brown
Reviewed-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk b088c3ca52 open.2: SEE ALSO: add open_by_name_at(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk 55ac9696ec name_to_handle_at.2: New link to new open_by_name_at(2) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Michael Kerrisk a827d5c648 open_by_handle_at.2: New page describing name_to_handle_at(2) and open_by_handle_at(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:12:25 +02:00
Abhay Sachan 25cb5f9b8b getxattr.2: Fix REURN VALUE description
A EA can have length zero.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-06 08:10:59 +02:00
Andrey Vagin 5e7c71f6ac mmap.2: The file descriptor for a file mapping must be readable
There is no difference between MAP_SHARED and MAP_PRIVATE.

do_mmap_pgoff()
	switch (flags & MAP_TYPE) {
	case MAP_SHARED:
	...
	/* fall through */
	case MAP_PRIVATE:
		if (!(file->f_mode & FMODE_READ))
			return -EACCES;

Signed-off-by: Andrey Vagin <avagin@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-04 13:25:08 +02:00
David Prévot 5201bb40a7 stat.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-03 13:41:19 +02:00
Michael Kerrisk 8bad22e53b perf_event_open.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-02 09:41:11 +02:00
Michael Kerrisk e9b1ab7892 perf_event_open.2: Minor fix: place PERF_FLAG_FD_CLOEXEC in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-02 09:37:26 +02:00
Michael Kerrisk 4f4f57abc2 perf_event_open.2: Rework Vince Weaver's discussion of PERF_FLAG_FD_CLOEXEC
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-02 09:37:26 +02:00
Vince Weaver 9cb36a115d perf_event_open.2: Document the PERF_FLAG_FD_CLOEXEC flag
The Linux 3.14 release adds support for the PERF_FLAG_FD_CLOEXEC
flag.

The wording is based on the description in kernel commit
a21b0b354d4ac39be691f51c53562e2c24443d9e
by Yann Droneaud.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-02 09:27:54 +02:00
Michael Kerrisk ed81fdd98d perf_event_open.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-01 21:40:15 +02:00
Vince Weaver 3f118a2944 perf_event_open.2: Document PERF_EVENT_IOC_PERIOD behavior change
Linux 3.14 (in commit bad7192b842c83e580747ca57104dd51fe08c223)
changes the perf_event PERF_EVENT_IOC_PERIOD ioctl() behavior
on all architectures to update immediately, to match the behavior
found on ARM.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-01 21:01:42 +02:00
Michael Kerrisk 7041581818 syscalls.2: Add sched_getattr() and sched_setattr()
And update kernel version to 3.14

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-31 20:59:35 +02:00
Michael Kerrisk d54837e835 inotify_add_watch.2: ERRORS: add ENAMETOOLONG
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-28 13:09:49 +01:00
Michael Kerrisk e5c756952d inotify_init.2: srcfix: Add copyright for 2008 changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-28 07:59:00 +01:00
Michael Kerrisk 41d9a4af48 inotify_init.2: Add pointer to inotify(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-28 07:57:23 +01:00
Michael Kerrisk b680b4c390 inotify_rm_watch.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-28 07:54:06 +01:00
Michael Kerrisk 544ae901f3 capget.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 14:02:26 +01:00
Michael Kerrisk bfc0e342a0 close.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 14:00:23 +01:00
Michael Kerrisk 4cae11db8c add_key.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:56:26 +01:00
Michael Kerrisk 142a205236 timer_settime.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:48:58 +01:00
Michael Kerrisk 45d522a8dc connect.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:47:19 +01:00
Michael Kerrisk 4b4a853a53 clone.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 13:46:48 +01:00
Michael Kerrisk 0bcb60ff6c pause.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:18 +01:00
Michael Kerrisk 1e9b8f7f7d send.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk ab30eafa61 read.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 15d33661c7 ptrace.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk 31020de90c perf_event_open.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk c0f5164fa9 msgop.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:17 +01:00
Michael Kerrisk ae7319ae99 recvmmsg.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk dbea37c3fd unlink.2: grfix + wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk ff68e7e29a symlink.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk 41ce23814b semop.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk 7e54637266 sigaltstack.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk c1400d9055 recvmmsg.2: ffix + grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk 37bee118ad perf_event_open.2: wfix + grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk f1ad56a654 open.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:16 +01:00
Michael Kerrisk df53e85b3c mknod.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:15 +01:00
Michael Kerrisk 587ca6cfba link.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:15 +01:00
Michael Kerrisk 11c7671510 getitimer.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:15 +01:00
Michael Kerrisk 621ab85e80 fcntl.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:15 +01:00
Michael Kerrisk 8ba7c301ef close.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:15 +01:00
Kir Kolyshkin 3cd16795c2 bdflush.2, fsync.2, sync.2: SEE ALSO: remove update(8) reference
Remove reference to update(8) man page, since there is no such
page. This is an ancient BSD leftover I believe.

Signed-off-by: Kir Kolyshkin <kir@openvz.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-26 07:33:15 +01:00
Michael Kerrisk 19a225b02f syscall.2: Rework text to prevent groff warnings about wide tables
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 17:03:44 +01:00
Michael Kerrisk a211773aea stat.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 16:55:46 +01:00
Michael Kerrisk a6fcbdf87b stat.2: Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 16:52:09 +01:00
Michael Kerrisk 481142b9e2 chown.2: Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 16:51:19 +01:00
Michael Kerrisk d81d850651 link.2: When AT_EMPTY_PATH is specified, 'olddirfd' must not refer to a directory
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 16:29:56 +01:00
Michael Kerrisk 14e9f7cf4b fcntl.2, strtol.3, strtoul.3, socket.7: ffix in feature test macro names
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 20:17:50 +01:00
Michael Kerrisk 89851a0054 Removed trailing white space at end of lines 2014-03-18 16:29:34 +01:00
Michael Kerrisk 289f790700 open.2: Clarify ELOOP error interaction with O_PATH
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:40:56 +01:00
Michael Kerrisk d30344ab97 open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:40:56 +01:00
Michael Kerrisk d26f8a31f1 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:40:56 +01:00
Michael Kerrisk 80d250b469 open.2: Add other system calls and functions that are like openat()
fanotify_mark(2), name_to_handle_at(2), and scandirat(3) have a
directory file descriptor argument for the same reason as openat().
Also: reword the rationale for the *at() functions somewhat.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:39:49 +01:00
Michael Kerrisk d41c1140ea stat.2: SEE ALSO: add ls(1) and stat(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:37:18 +01:00
Michael Kerrisk fbc6aee251 msgop.2: Document two MSG_COPY failure modes
Since Linux 3.14, the kernel now diagnoses two errors
when using msgrcv() MSG_COPY:
* MSG_COPY must be specified with IPC_NOWAIT
* MSG_COPY can't be specified with MSG_EXCEPT

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 10:32:15 +01:00
Michael Kerrisk 5904142b57 msgop.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 10:13:37 +01:00
Michael Kerrisk 71af773f9c mount.2: SEE ALSO: add blkid(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 08:46:40 +01:00
Michael Kerrisk 6cf19e6234 open.2: Document O_DSYNC and rewrite discussion of O_SYNC
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 08:46:40 +01:00
Michael Kerrisk 5dc8986d0d open.2: Organize some material under additional subheadings in NOTES
There's an amorphous mass of material under NOTES.  Structure
it with some subheadings, and do a little reorganizing.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-17 08:46:40 +01:00
Michael Kerrisk 7e2cb38315 fcntl.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-16 11:36:57 +01:00
Michael Kerrisk 71e7d7f1a3 select.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-16 11:36:57 +01:00
Michael Kerrisk 216b9e6182 poll.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-16 11:36:57 +01:00
Michael Kerrisk 9f001135d9 perfmonctl.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-16 11:36:57 +01:00
Michael Kerrisk 0bca57f378 shmget.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-16 11:36:57 +01:00
Michael Kerrisk b3a695fcd8 readahead.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-16 11:36:57 +01:00
Michael Kerrisk 0226bea188 readahead.2: tfix
Reported-by: Phillip Susi <psusi@ubuntu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-15 17:24:34 +01:00
Michael Kerrisk c41881de19 readahead.2: Place note about blocking behavior of readahead() under BUGS
Reported-by: Christoph Hellwig <hch@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-15 13:30:17 +01:00
Michael Kerrisk 6a7c9c0a7f readahead.2: Tweaks to Phillip Susi;s patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-15 10:04:57 +01:00
Phillip Susi afc9c3a076 readahead.2: Don't claim the call blocks until all data has been read
The readahead(2) man page was claiming that the call blocks until
all data has been read into the cache.  This is incorrect.

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

Corrado Zoccolo noted:
        it simply calls force_page_cache_readahead (the same called
        by fadvise/madvise), that just post a prefetch, and it may
        block only when the I/O queue is full.

Reported-by: Corrado Zoccolo <czoccolo@gmail.com>
Reported-by: Gregory P. Smith <gps@google.com>
Reported-by: Zhu Yanhai <zhu.yanhai@gmail.com>
Signed-off-by: Phillip Susi <psusi@ubuntu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-15 09:38:10 +01:00
Simon Paillard 7af4d3183e mount.2: srcfix: remove non-ascii trailing space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 22:32:05 +01:00
Michael Kerrisk bd297db00b clone.2: srcfix: Remove FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:45 +01:00
Michael Kerrisk cba9638bfb unshare.2: srcfix: remove FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-11 11:41:45 +01:00
Michael Kerrisk 496bdb5642 stat.2: Warn the reader that the 'stat' structure definition is not precise
Padding fields aren't shown, and the order of fields varies
somewhat across architectures.

Reported-by: Marius Gaubas <marius@livejournalinc.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk 1fef0fa346 stat.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk e096bd701a stat.2: Minor rewording: eliminate clumsy use of "stat" as a verb
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Cyril Hrubis c98da6cf73 link.2: tfix
protected_hardlink -> protected_hardlinks

Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Simon Paillard 843edb785f alarm.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-03 05:50:40 +01:00
Simon Paillard 98d3114d7e access.2n chmod.2, chown.2: ffix regression
Introduced in my previous commit 9d3ea7a299

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-03 05:50:06 +01:00
Michael Kerrisk 3c9bfcab48 recv.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-27 22:37:27 +01:00
Michael Kerrisk 6fd69f33d7 clone.2: Note that CLONE_THREAD also in effect required CLONE_VM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-27 09:47:27 +01:00
Michael Kerrisk 92692952b1 Removed trailing white space at end of lines 2014-02-26 18:29:50 +01:00
Simon Paillard 9d3ea7a299 access.2, chmod.2, chown.2, unlink.2: ffix
Fix format issue introduced in cadd38ba

Can be detected with:
	git grep -P '.BR [a-z]+\(\)'

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-26 17:43:00 +01:00