Commit Graph

3080 Commits

Author SHA1 Message Date
Michael Kerrisk 69287cb678 prctl.2: Fixes to PR_SET_MM after comments from Cyrill
Remove some FIXMEs and comment out pieces of text that describe
features not yet merged mainline kernel.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 3612be0418 prctl.2: Various edits and improvements to Cyrill's patch
* Wording improvements

* Addition of some FIXMEs for suspicious points

* Addition of various EINVAL cases

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Cyrill Gorcunov 3a620d0b7b prctl.2: Document PR_SET_MM (new in Linux 3.3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 3062824dae mmap.2: Clarify NOTES discussion of mmap() versus mmap2()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 02ddee60aa mmap2.2: Clarify that this system call should not be invoked directly
See https://bugzilla.kernel.org/show_bug.cgi?id=42892

Reported-by: Kevin O'Gorman <kevinogorman4@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 962232bffc times.2: ERRORS: Add EFAULT
As Simone notes, RETURN VALUE says:

On error, (clock_t) -1 is returned, and errno is set appropriately

but no value for errno is specified.  The only error case is
EFAULT, so let's add that.

Reported-by: Simone Piccardi <piccardi@truelite.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:08:58 +12:00
Michael Kerrisk 20d58e69bd times.2: tfix: BUGS: clockid_t ==> clock_t
Reported-by: Simone Piccardi <piccardi@truelite.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:27:09 +12:00
Michael Kerrisk b857fda584 poll.2: Document semantics of passing zero in 'events' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:27:09 +12:00
Michael Kerrisk 096ca08af4 poll.2: Document negative value in 'fd' field
Reported-by: Michael Welsh Duggan <mwd@cert.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:27:09 +12:00
Mike Frysinger ef30129360 sigprocmask.2: ERRORS: add EFAULT
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:27:09 +12:00
Michael Kerrisk 2d350ede02 fchmodat.2: Note difference between glibc wrapper and underlying system call
The wrapper function has a 'flags' argument (which currently
serves no purpose), while the underlying system call does not.

Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:26:36 +12:00
Michael Kerrisk d660ffd524 fchmodat.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:18:29 +12:00
Abhijith Das a8ceabbc8c fcntl.2: Explain behaviour of F_GETLEASE during lease break
Here's a patch to the fcntl.2 manpage that explains
the working of F_GETLEASE in a bit more detail during
lease breaks. Basically, what happens is this: When a
lease break is initiated by a lease breaker, subsequent
F_GETLEASE calls return the target lease type after
the lease break and not the existing lease type. This
behavior persists until the lease holder downgrades/unlocks
the lease or the kernel forcibly does it after the lease
break timeout expires.

The implicit assumption is that F_GETLEASE should
return the existing lock type until the downgrade/unlock
has actually taken place, which is not true. I've verified
that the kernel indeed returns the target lease type. It
is also simple enough to verify this behavior in a small
program, where you can observe that the lease type
returned by F_GETLEASE in the signal handler for a
lease break is different from the existing lease type.

Signed-off-by: Abhijith Das <adas@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 10:43:00 +12:00
Michael Kerrisk 7396b79c68 epoll_wait.2: Another thread can add to epoll instance while epoll_wait is blocked
See https://bugzilla.kernel.org/show_bug.cgi?id=43072

Reported-by: Armin Rigo <arigo@tunes.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 70a6338b76 epoll_wait.2: A few wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 72bbde85be epoll_wait.2: Clarify that epoll_pwait() blocks calling *thread*
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 284976f891 epoll_wait.2: Minor change: add explicit reference to epoll(7) at start of DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk fde633deb6 epoll_create.2: Rework discussion of 'size' argument
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 6b6f540407 epoll_create.2: Add .SS for description of epoll_create1()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 5f4e9d5acd epoll_create.2: Minor change: add explicit reference to epoll(7) at start of DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 78d1cbdec8 epoll_ctl.2: Minor change: add explicit reference to epoll(7) at start of DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk f1e90ec441 gettimeofday.2: Note that compiler issues warnings if 'tv' is NULL
Reported-by: Felix <fkater@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 13:16:49 +12:00
Michael Kerrisk d5c4e19747 gettimeofday.2: Reorganize content
The main change is to move the historical information about
the 'tz_dsttime' to NOTES.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 13:10:57 +12:00
Michael Kerrisk dff6bb1919 sigaction.2: Clarify that the use of SI_SIGIO is for Linux 2.2 only
See also http://sourceware.org/bugzilla/show_bug.cgi?id=6745

Reported-by: Andreas Jaeger <aj@suse.com>
Reported-by: <who@connect.carleton.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 11:47:43 +12:00
Michael Kerrisk d53de2a707 select.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 05:44:52 +12:00
Michael Kerrisk ed9821bba0 fcntl.2: Change type of arg from "long" to "int"
Various fcntl(2) commands require an integral 'arg'.
The man page said it must be "long" in all such cases.
However, for the cases covered by POSIX, there is an
explicit requirement that these arguments be "int".
Update the man page to reflect. Probably, all of the
other "long" cases (not specified in POSIX) should
be "int", and this patch makes them so. Based on a
note fromEric Blake, relating to F_DUPFD_CLOEXEC.

Reported-by: Eric Blake <ebb9@byu.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-30 07:36:20 +13:00
Michael Kerrisk d39a9b9833 ptrace.2: Minor edits to Denys Vlasenko's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-30 06:59:50 +13:00
Denys Vlasenko b16ecdae13 ptrace.2: Various fixes
For some reason, the PTRACE_TRACEME paragraph talks about some
general aspects of ptraced process behavior. It repeats the
"tracee stops on every signal" information even though that was
already explained just a few paragraphs before. Then it describes
legacy SIGTRAP on execve().

This patch deletes the first part, and moves the second part up,
into the general ptrace description. It also adds
"If PTRACE_O_TRACEEXEC option is not in effect" to the description
of the legacy SIGTRAP on execve().

The patch also amends the part which says "For requests other
than PTRACE_KILL, the tracee must be stopped." - PTRACE_ATTACH
also doesn't require that.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-30 06:59:50 +13:00
Michael Kerrisk d2470c5d28 gettid.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-29 12:43:47 +13:00
Michael Kerrisk a4405ff934 clone.2, unshare.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-29 12:43:30 +13:00
Michael Kerrisk c86365595d symlinkat.2: PROTOTYPE: Correct header file
Reported-by: Eric Blake <ebb9@byu.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-25 07:20:14 +13:00
Michael Kerrisk 3045389f28 utimensat.2: PROTOTYPE: Add <fcntl.h> for AT_* constants
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-25 07:20:14 +13:00
Michael Kerrisk 4075a06302 unlinkat.2: PROTOTYPE: Add <fcntl.h> for AT_* constants
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-25 07:20:14 +13:00
Michael Kerrisk a917d281e5 unlinkat.2: PROTOTYPE: Correct header file
Reported-by: Eric Blake <ebb9@byu.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-25 07:20:14 +13:00
Michael Kerrisk 959c1dc498 symlinkat.2: PROTOTYPE: Correct header file
Reported-by: Eric Blake <ebb9@byu.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-25 07:20:14 +13:00
Michael Kerrisk ba78c947f0 futimesat.2: PROTOTYPE: Correct header file and feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-25 07:19:45 +13:00
Michael Kerrisk ea4282fa86 fcntl.2: wfix: /proc/sys/fs/pipe-size-max ==> /proc/sys/fs/pipe-max-size
Reported-by: Matthew Gregan <kinetik@flim.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-25 06:51:50 +13:00
Michael Kerrisk be02e49f7c open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-24 13:05:14 +13:00
David Prévot a5c725cfd3 ptrace.2: ffix and tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-24 13:05:14 +13:00
Michael Kerrisk 8f318249c6 ptrace.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-24 11:59:07 +13:00
Denys Vlasenko b16d33ef72 ptrace.2: Document PTRACE_GETEVENTMSG for PTRACE_EVENT_EXEC
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-24 11:59:07 +13:00
Michael Kerrisk 0597933fb0 syscalls.2: Remove unimplemented system calls from main syscall list
The unimplemented system calls are in any case noted lower down
in the page. Also: rearrange the text describing the unimplemented
system calls.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

syscalls.2: fix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-24 11:58:59 +13:00
Michael Kerrisk 1d3dc33c72 syscalls.2: Add process_vm_readv(2) and process_vm_writev(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-23 14:20:26 +13:00
Michael Kerrisk 13f66890a4 syscalls.2: Note a few system calls that were removed in Linux 2.6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-23 14:09:47 +13:00
Bjarni Ingi Gislason a92d3bb413 keyctl.2: Strip trailing tabs from source line
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=664688

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-21 06:54:30 +13:00
Michael Kerrisk a17e05c5e0 ptrace.2: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-20 07:45:58 +13:00
Denys Vlasenko f098951d39 ptrace.2: Various fixes to recent updates of this page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-20 07:45:53 +13:00
David Prévot 381ee84e1a fallocate.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-20 07:44:29 +13:00
Michael Kerrisk 01b844cc10 rt_sigqueueinfo.2, iswctype.3, longjmp.3: Minor fix: add Section number to page xref
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 04:58:10 +13:00
Michael Kerrisk 02cb2646e0 rt_sigqueueinfo.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 04:46:10 +13:00
Michael Kerrisk c90561d7bb rt_sigqueueinfo.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 04:45:27 +13:00
Michael Kerrisk 3ba9126c04 rt_sigqueueinfo.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 04:44:55 +13:00
Michael Kerrisk 6030f2d859 add_key.2, keyctl.2, request_key.2, offsetof.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_equal.3, pthread_exit.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_testcancel.3: Global formatting fix: balance .nf/.fi pairs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 04:37:22 +13:00
Michael Kerrisk c9f2ff9d7e _exit.2, chmod.2, abs.3, cbrt.3, mkdtemp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 04:22:05 +13:00
Michael Kerrisk 2bfa8272f0 intro.2, btowc.3, intro.3, pthread_sigqueue.3: Correct order of SEE ALSO entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 03:58:56 +13:00
Michael Kerrisk 7a5b06940e vfork.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 03:50:13 +13:00
Michael Kerrisk f23cc1df32 ptrace.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-10 06:30:59 +13:00
Michael Kerrisk 66d90115ca utimensat.2, wait.2, end.3: srcfix: remove duplicate words in comments
Reported-by: Justin T Pryzby <justinp@norchemlab.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-09 04:26:06 +13:00
Michael Kerrisk d6e37473a1 Removed trailing white space at end of lines 2012-03-06 08:54:38 +13:00
Michael Kerrisk b8d02d5633 ptrace.2: Further improvements after review by Denys Vlasenko
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Michael Kerrisk a42c0c5a19 ptrace.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Michael Kerrisk dc85ba7ce5 ptrace.2: Integrated changes after further review from Denys Vlasenko
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Michael Kerrisk 8898a252ad ptrace.2: Integrated changes after review from Denys Vlasenko
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Michael Kerrisk 181f997f23 ptrace.2: Global clean-up of page
* Wording and formatting fixes to existing text and
  Denys Vlasenko's new text.
* Various technical amendments and improvements to
  Denys Vlasenko's new text.
* Added FIXME for various problems with the current text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Michael Kerrisk 8b20acd1aa ptrace.2: srcfix: Wrap lines at sentence boundaries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Denys Vlasenko 4d12a715f2 ptrace.2: add extended description of various ptrace quirks
Changes include:

s/parent/tracer/g, s/child/tracee/g - ptrace interface now
is sufficiently cleaned up to not treat tracing process
as parent.

Deleted several outright false statements:
- pid 1 can be traced
- tracer is not shown as parent in ps output
- PTRACE_ATTACH is not "the same behavior as if tracee had done
  a PTRACE_TRACEME": PTRACE_ATTACH delivers a SIGSTOP.
- SIGSTOP _can_ be injected.
- Removed mentions of SunOS and Solaris as irrelevant.
- Added a few more known bugs.

Added a large block of text in DESCRIPTION which doesn't focus
on mechanical description of each flag and operation, but rather
tries to describe a bigger picture. The targeted audience is
a person which is reasonably knowledgeable in Unix but did not
spend years working with ptrace, and thus may be unaware of its
quirks. This text went through several iterations of review by
Oleg Nesterov and Tejun Heo.
This block of text intentionally uses as little markup as possible,
otherwise future modifications to it will be very hard to make.

Reviewed-by: Oleg Nesterov <oleg@redhat.com>
Reviewed-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Denys Vlasenko <dvlasenk@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-06 08:45:57 +13:00
Michael Kerrisk 18a97acf29 syscalls.2: Note that nfsservctl(2) was removed in Linux 3.1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 13:15:52 +13:00
Michael Kerrisk 70a3e2734f syscalls.2: Note that bdflush(2) is deprecated
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 13:15:25 +13:00
Michael Kerrisk dcee880f07 nfsservctl.2: Note that this system call was removed in Linux 3.1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 13:14:10 +13:00
Michael Kerrisk 966ba49822 bdflush.2: Note that bdflush() is deprecated, and does nothing
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-05 13:14:10 +13:00
Michael Kerrisk b9145b2cab clone.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-03 06:54:00 +13:00
Michael Kerrisk 706b0ab140 Removed trailing white space at end of lines 2012-02-27 14:14:12 +13:00
Michael Kerrisk 1901002c4a fallocate.2, fork.2, open.2, send.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 14:12:16 +13:00
Michael Kerrisk ba9830cfc9 fsync.2: Note that some systems require a writable file descriptor
An edited version of Guillem Jover's comments:
[While the file descriptor does not need to be writable on Linux]
that's not a safe portable assumption to make on POSIX in general
as that behavior is not specified and as such is
implementation-specific. Some Unix systems do actually fail on
read-only file descriptors, for example [HP-UX and AIX].

Reported-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:50:55 +13:00
Michael Kerrisk ad4760331e fsync.2: Minor clean-ups of Christoph's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:50:55 +13:00
Christoph Hellwig 71ae2f4a3f fsync.2: Various improvements
- explain the situation with disk caches better
- remove the duplicate fdatasync() explanation in the NOTES
  section
- remove an incorrect note about fsync() generally requiring two
  writes
- remove an obsolete ext2 example note
- fsync() works on any file descriptor (doesn't need to be
  writable); correct the EBADF error code explanation

Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:49:25 +13:00
Michael Kerrisk c0c3d0195d fallocate.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk 7eb92881ee fallocate.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk 54d25ecaec fallocate.2: ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk f52e0be8bb fallocate.2: Substantial restructuring of DESCRIPTION
The addition of a second class of operation ("hole punching")
to the man page made it clear that some significant restructuring
is required. So I substantially reworked the page, including the
preexisting material on the default "file allocation" operation.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk 96575bbc0e fallocate.2: Add further details for FALLOC_FL_PUNCH_HOLE
Reported-by: Josef Bacik <josef@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Lucian Adrian Grijincu 1c7857e9dd fallocate.2: Document FALLOC_FL_PUNCH_HOLE
FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38,
for punching holes in the allocated space in a file.

Signed-off-by: Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk 74819bb2b8 request_key.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk be464b55a0 add_key.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 13:30:55 +13:00
Michael Kerrisk 174428192d sendmmsg.2: minor changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 11:11:48 +13:00
Michael Kerrisk 969d3d9e76 sendmmsg.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 11:10:11 +13:00
Michael Kerrisk 53aeb9c2da send.2: Add mention of sendmmsg(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 11:10:11 +13:00
Michael Kerrisk 82c182484a sendmmsg.2: New page for sendmmsg(2)
Some pieces inspired by an initial attempt by Stephan Mueller.

Reported-by: Stephan Mueller <stephan.mueller@atsec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-27 11:10:11 +13:00
Michael Kerrisk d5563c9427 dup.2: SYNOPSIS: Add "#include <fntl.h>" for O_* constants
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-14 10:19:54 +13:00
Michael Kerrisk 509b5e8b73 pipe.2: SYNOPSIS: Add "#include <fntl.h>" for O_* constants
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750

Reported-by: Salvo Tomaselli <tiposchi@tiscali.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-14 10:16:21 +13:00
Jessica McKellar 0deb3ce930 open.2: Fix grammar in O_DIRECT description
Some small grammar fixes to the O_DIRECT description.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-13 10:22:05 +13:00
Michael Kerrisk 2b2e0ce503 mremap.2: spfix
Reported-by: Vijay Rao <vijay@portuosus.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-12 22:53:31 +13:00
Michael Kerrisk c799ca6250 sync.2: PROTOTYPE: Fix return type of syncfs()
Reported-by: Simone Piccardi <piccardi@truelite.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-12 06:01:35 +13:00
Michael Kerrisk f49ee36532 vfork.2: CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 12:05:46 +13:00
Michael Kerrisk 619c3d1b2d vfork.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 12:05:46 +13:00
Michael Kerrisk c59392ff61 vfork.2: Add some notes on reasons why vfork() still exists
Reported-by: starlight@binnacle.cx
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 12:05:36 +13:00
Michael Kerrisk ab47b8bc20 vfork.2: Note clone() flags equivalent to vfork()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 10:03:58 +13:00
Michael Kerrisk 60875c0427 vfork.2: Clarify what is duplicated in the child
Add some words to make it clear to the reader that vfork(),
like fork(), creates duplicates of process attributes
in the child.

Reported-by: starlight@binnacle.cx
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 10:00:41 +13:00
Michael Kerrisk 6de06bb89f fork.2: NOTES: Descibe clone() call equivalent to fork()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 09:30:07 +13:00
Michael Kerrisk cf2b18fe6d vfork.2: Clarify that calling *thread* is suspended during vfork()
Reported-by: starlight@binnacle.cx
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 09:28:06 +13:00
Michael Kerrisk 82d0acff52 mount.2: Removed erroneous statement about MS_RDONLY and bind mounts
Reported-by: Junjiro Okajima <jro@mx3.ttcn.ne.jp>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-01-18 23:23:51 +13:00
Clemens Ladisch 45b4eda6e8 sched_rr_get_interval.2: Update notes on modifying quantum
Since Linux 2.6.24, it is no longer possible to
modify the SCHED_RR quantum using setpriority(2).
(Slight edits to Clemens' patch by mtk.)

Signed-off-by: Clemens Ladisch <clemens@ladisch.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-16 07:01:47 +02:00
Michael Kerrisk 585d38140f sched_rr_get_interval.2: Reworded text of ESRCH error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-16 06:54:16 +02:00
Michael Kerrisk ca016ea98b sched_rr_get_interval.2: srcfix: Changed in-line formatting to dot directives
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-16 06:50:04 +02:00
Michael Kerrisk 4e2621b57e sched_rr_get_interval.2: Reordered various pieces of text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-16 06:45:57 +02:00
Michael Kerrisk 7f03801baa recvmmsg.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-05 06:45:34 +02:00
Michael Kerrisk dc43a89191 syscalls.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-05 06:44:40 +02:00
Michael Kerrisk c409c4ffa3 Removed trailing white space at end of lines 2011-10-04 08:34:28 +02:00
Michael Kerrisk 41acdb62c9 Changes, setns.2, stat.2, proc.5, capabilities.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 08:32:21 +02:00
Michael Kerrisk 1eee8505ff recvmmsg.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 07:58:49 +02:00
Michael Kerrisk 6df3494543 recvmmsg.2: SEE ALSO: add sendmmsg(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 07:55:35 +02:00
Michael Kerrisk 946fb6e2ce recvmmsg.2: Added copyright and license notice
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 07:55:35 +02:00
Michael Kerrisk d92f6e8405 recv.2: Add mention of recvmmsg(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 07:55:35 +02:00
Michael Kerrisk 8b0ea18b39 recvmmsg.2: Various improvements and formatting fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 07:55:35 +02:00
Andi Kleen 242966fd5b recvmmsg.2: New man page for recvmmsg(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 07:55:35 +02:00
Michael Kerrisk 9eff286780 mount.2, prctl.2: s/task/thread/ for consistency with other pages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 15:40:42 +02:00
Michael Kerrisk 5503c85ea4 intro.1, fork.2, futex.2, open.2, rename.2, select_tut.2, semop.2, spu_create.2, stat.2, netlink.3, random.3, scanf.3, shm_open.3, strftime.3, console.4, console_codes.4, sk98lin.4, st.4, bootparam.7, cpuset.7, credentials.7, man-pages.7, path_resolution.7, uri.7: Global fix: remove spaces around em-dash
Normal English typographical convention is not to have
spaces around em dashes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:47:35 +02:00
Michael Kerrisk 7aa166c58d setns.2: Edited in review comments from Eric Biederman
Reviewed-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Michael Kerrisk 92dcb22063 setns.2: Various improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Michael Kerrisk b93a34b5a2 setns.2: Minor improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Michael Kerrisk 4e1e208d0f setns.2: srcfix: Added FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Michael Kerrisk 63b6ef4127 setns.2: Note privileges required
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Michael Kerrisk c07ad242fd setns.2: Minor improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Eric W. Biederman dfa22c8b77 setns.2: New manual page for setns(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Michael Kerrisk 9c1e33bc99 sigwaitinfo.2: Note that attempts to wait for SIGKILL and SIGSTOP are silently ignored
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:14:23 +02:00
Kevin Lyda 8be7707745 rt_sigqueueinfo.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 07:43:42 +02:00
Kevin Lyda 59e754b885 mknodat.2: scrfix: spelling fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 07:41:50 +02:00
Michael Kerrisk 295bb82e56 stat.2: Regarding automounter action, add a reference to fstatat(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-01 07:16:10 +02:00
Michael Kerrisk d3e8b1410a stat.2: Note POSIX.1-2001 and POSIX.1-2008 requirements for lstat()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-01 07:16:10 +02:00
Michael Kerrisk beb0ebc887 stat.2: Clean up text describing which POSIX descibes S_IF* constants
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-01 07:16:10 +02:00
Michael Kerrisk e5ded49fc8 send.2: CONFORMING TO: POSIX.1-2008 adds MSG_NOSIGNAL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-01 07:16:10 +02:00
Michael Kerrisk 280ff2097b stat.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 06:27:15 +02:00
Michael Kerrisk ad3fd4c0e3 execve.2, recv.2, getaddrinfo.3, getcwd.3, getipnodebyname.3, getlogin.3, mbsinit.3: Global fix: s/null pointer/NULL pointer/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 06:25:05 +02:00
Michael Kerrisk cebca1bd40 flock.2, recv.2, btree.3, dbopen.3, des_crypt.3, fts.3, mpool.3, recno.3: Global fix: use ORing
Use "ORing", not "OR'ing", nor an italic ".IR OR ing".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 05:06:37 +02:00
Michael Kerrisk 435b60754a capget.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 05:05:10 +02:00
Michael Kerrisk 836830b4c9 readlink.2, getsubopt.3, termcap.5, tzfile.5, unix.7: srcfix: change single quote to "\(aq"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 04:56:17 +02:00
Michael Kerrisk 4e83614439 clock_getres.2, clone.2, mbind.2, set_mempolicy.2, atan2.3, getipnodebyname.3, ilogb.3, lgamma.3, elf.5, capabilities.7, math_error.7: srcfix: Remove double space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-27 05:17:10 +02:00
Guillem Jover 25675bff81 lseek.2: CONFORMING TO: Note other systems that have SEEK_HOLE+SEEK_DATA
Signed-off-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-25 07:09:58 +02:00
Michael Kerrisk f497e4567d readlink.2: Minor fixes (copyright, example program)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-25 06:54:33 +02:00
David Prévot 4ada4f45a4 lseek.2: wfix
Signed-off-by: David Prévot <taffit@debian.org>
2011-09-24 07:54:34 +02:00
Michael Kerrisk 1976f57a63 Removed trailing white space at end of lines 2011-09-23 08:01:18 +02:00
Michael Kerrisk fe48639fc3 set_mempolicy.2, getcwd.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-23 07:17:13 +02:00
David Prévot 8c3fb60451 madvise.2: ffix
Signed-off-by: David Prévot <taffit@debian.org>
2011-09-23 07:13:09 +02:00
Michael Kerrisk b18e759d8c fstatat.2, rt_sigqueueinfo.2, sendfile.2, hsearch.3, matherr.3, rtld-audit.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-23 07:11:27 +02:00
David Prévot 62fc472fa8 posix_fadvise.2: ffix
Signed-off-by: David Prévot <taffit@debian.org>
2011-09-23 07:07:58 +02:00
David Prévot fb30b09644 lseek.2, inet_pton.3, tzfile.5: tfix
Please find attach a consistency fix: there were only five
"zeroes" but twenty four "zeros" in those manual pages.
(Make all instances "zeros".)

Signed-off-by: David Prévot <taffit@debian.org>
2011-09-23 07:02:06 +02:00
Michael Kerrisk f7cac3c341 sigqueue.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-22 16:35:41 +02:00
David Prévot c0e140e64c madvise.2: tfix
Signed-off-by: David Prévot <taffit@debian.org>
2011-09-22 04:58:20 +02:00
Denis Barbier 928b19706f fallocate.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-22 04:54:53 +02:00
Michael Kerrisk 3d4b49b0a1 madvise.2: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-21 06:59:45 +02:00
Doug Goldstein e8dd3ed2f1 madvise.2: Add MADV_HUGEPAGE and MADV_NOHUGEPAGE
Document the MADV_HUGEPAGE and MADV_NOHUGEPAGE flags added to
madvise() in Linux 2.6.38.

Signed-off-by: Doug Goldstein <cardoe@cardoe.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-21 06:59:38 +02:00
Michael Kerrisk 7f98857ab9 sched_setscheduler.2: Document 2.6.39 changes to rules governing changes from SCHED_IDLE policy
Since Linux 2.6.39, unprivileged processes under the
SCHED_IDLE policy can switch to another nonrealtime
policy if their nice value falls within the range
permitted by their RLIMIT_NICE limit.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-20 18:25:40 +02:00
Michael Kerrisk 96f6255496 readlink.2: Added copyright text + changelog note for Guillem Jover's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-20 08:50:20 +02:00
Michael Kerrisk b61acee948 readlink.2: Minor edits to Guillem Jover's previous patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-20 08:39:57 +02:00
Guillem Jover f91c6bd76f readlink.2: Document using st_size to allocate the buffer
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-20 08:19:52 +02:00
Michael Kerrisk 1e0819c860 lseek.2: Document SEEK_HOLE and SEEK_DATA
These flags, designed for discovering holes in a file,
were added in Linux 3.1. Included comments from Eric
Blake and Sunil Mushran.

Reviewed-by: Eric Blake <eblake@redhat.com>
Reviewed-by: Sunil Mushran <sunil.mushran@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-20 08:07:47 +02:00
Michael Kerrisk b9d482436e fstatat.2: AT_NO_AUTOMOUNT has no effect if mount has already occurred
Reported-by: David Howells <dhowells@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-20 07:05:48 +02:00
Michael Kerrisk cdc839c3ee fstatat.2: Document AT_NO_AUTOMOUNT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-20 07:05:48 +02:00
Michael Kerrisk 363f71eb27 sigqueue.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-20 07:05:48 +02:00
Michael Kerrisk 6b6646e855 clone.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-20 07:05:48 +02:00
David Prévot 5243e7b3b8 ptrace.2: tfix
Signed-off-by: David Prévot <taffit@debian.org>
2011-09-19 17:32:54 +02:00
David Prévot 4a7300fe45 mlock.2: tfix
Signed-off-by: David Prévot <taffit@debian.org>
2011-09-19 17:32:54 +02:00
David Prévot 26d5d1fd84 sendfile.2: ffix
Signed-off-by: David Prévot <taffit@debian.org>
2011-09-19 17:32:54 +02:00
Michael Kerrisk 45eb0d22b7 fallocate.2: ERRORS: Add EPERM and ESPIPE errors
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-19 17:32:54 +02:00
Michael Kerrisk 710fdd5d6b lseek.2: Remove suspect note about 'whence' being incorrect English.
As noted by Alan Curry:

According to man2/lseek.2,

 This document's use of whence is incorrect English, but
 maintained for historical reasons.

What is the grammatical objection?

From WordNet (r) 3.0 (2006) [wn]:
 whence
     adv 1: from what place, source, or cause

Wiktionary:
 [edit] Adverb
 whence (not comparable)
  1. From where; from which place or source.

lseek's second parameter is a distance to be traveled, and
the third parameter chooses the starting point from which
that distance is measured.  How is that not a "whence"?

Looking at some man page archives, I found that the accusation
of incorrect English goes back to before 4.4BSD. It survives
not just in the linux-man-pages but also in recent versions
of {Net,Open,Free}BSD. The name "whence" for this parameter
goes back at least to V7.

Of all the people who have read this page over the years,
am I the only one wondering... what's this about? Who decided
that "whence" was incorrect and put that note in the man page?
Was there ever anything wrong, or do we have someone's
20-year-old unresearched pet peeve lingering in the man pages?

Reported-by: Alan Curry <pacman@kosh.dhis.org>
Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-19 17:32:54 +02:00
Michael Kerrisk 4a19d2ace3 tkill.2: SEE ALSO: Add rt_sigqueueinfo (2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-19 17:32:54 +02:00
Michael Kerrisk 485ab7013e getrlimit.2, kill.2, rt_sigqueueinfo.2, sigaction.2, signal.2, signalfd.2, sigprocmask.2, sigwaitinfo.2, psignal.3, pthread_sigqueue.3, credentials.7, signal.7: Change reference to "sigqueue(2)" to "sigqueue(3)"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-19 17:32:53 +02:00
Michael Kerrisk 7767750f4b syscalls.2: srcfix: remove unneeded comments
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-19 17:32:53 +02:00
Michael Kerrisk 27b93dae24 sigqueue.2: Create link to page that was relocated to section 3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-18 06:58:46 +02:00
Michael Kerrisk ae88a0d6b1 sigqueue.3: Move this page to section 3
Now that the underlying system call rt_sigqueueinfo(2) is
properly documented, move sigqueue() to Section 3, since
it is really a library function.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-18 06:58:46 +02:00
Michael Kerrisk b203e4d582 rt_tgsigqueueinfo.2: New link to new rt_sigqueueinfo.2 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-18 06:58:46 +02:00
Michael Kerrisk 23f438b540 rt_sigqueueinfo.2: New page for rt_sigqueueinfo(2) and rt_tgsigqueueinfo(2)
This replaces the previous '.so' man page link file for
rt_sigqueueinfo.2, which linked to ths sigqueue() man page.

Reported-by: Stephan Mueller <stephan.mueller@atsec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-18 06:58:33 +02:00
Michael Kerrisk d0e1cbceeb syscalls.2: Minor: remove duplicated open_by_handle() entry
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 07:11:02 +02:00
Paul Pluzhnikov cadcf1b16b prctl.2: PR_SET_DUMPABLE makes process non-ptrace-attachable
We've recently discovered that GDB will fail to attach to any
process that sets itself non-dumpable. Tested on kernel 2.6.32,
with:

int main(int argc, char *argv[])
{
    if (prctl(PR_SET_DUMPABLE, 0, 0, 0) != 0) {
        perror("prctl");
    }
    printf("Run gdb %s %d\n", argv[0], getpid());
    sleep(20);
    abort();
}

./a.out
Run gdb ./a.out 30476

gdb -q  ./a.out 30476
Reading symbols from /tmp/a.out...done.
Attaching to program: /tmp/a.out, process 30476
ptrace: Operation not permitted.
/tmp/30476: No such file or directory.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 06:10:54 +02:00
Paul Pluzhnikov 2e781e2082 prctl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 06:08:35 +02:00
Michael Kerrisk 1ad008e71e Removed trailing white space at end of lines 2011-09-17 05:45:55 +02:00
Michael Kerrisk 1293f354e2 sendfile.2: wfix
Reported-by: Stefan Puiu <stefan.puiu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-17 05:16:43 +02:00
Michael Kerrisk f81c6cc693 fcntl.2, recv.2, crypt.3, err.3, strtoul.3, proc.5: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:02:06 +02:00
Hendrik Jan Thomassen 3d5be2aa85 unlink.2: Improve EBUSY description
The current version of the page says (under ERRORS):

> EBUSY (not on Linux)
>  The  file pathname cannot be unlinked because it is being
>  used by the system or another process and the
>  implementation considers this an error.

But if you look in the kernel source file fs/namei.c
at routine may_delete() you'll see two occasions where
an EBUSY is generated. So the above "not on Linux" is wrong.

I suggest that this '(not on Linux)' be removed. It may
also improve the page if the commentary is reworded to give a
better description of the two situations. Something along
the lines of:
> The file pathname cannot be unlinked because it is being used
> by the system, e.g. if some (relative) rootdir is mounted upon it,
> or because the NFS client software created it to represent an
> active but otherwise nameless inode ("NFS silly renamed").

Just FYI: the NFS silly rename (you'll find this term mentioned
in the kernel source code) is described at:
       http://nfs.sourceforge.net/#section_d
under section D2. The reason I found this manpage bug is because
I stumbled upon one of these silly renamed files, and an strace
of the rm-command revealed the EBUSY return errno.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 12e263f178 open.2: wfix
Reported-by: Graham Gower <graham.gower@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Tomislav Jonjic 612144c541 timerfd_create.2: Fix small error in description of timerfd_settime()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 963da6c54d mlock.2: Clarify EINVAL error
See http://bugs.debian.org/cgi-bin/bugreport.cgi?625747

Reported-by: Brian M. Carlson <sandals@crustytoothpaste.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Simon Paillard 3cbd3fee32 get_mempolicy.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 1e8a0addef execve.2: Note that the first argv[] value should contain name of executable
Reported-by: Sebastian Geiger <sbastig@gmx.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Tolga Dalman 866ed7369f sendfile.2: Add an explicit reference to splice(2)
Unlike sendfile(), splice() can transfer data
between a pair of sockets.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 009cdc2239 timerfd_create.2: Note behavior when timerdfd_settime() old_value is NULL
See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
timerfd_settime(2) states that "The old_value argument returns a
structure containing the setting of the timer that was current at
the time of the call"; however, it does not mention that the
caller can pass NULL to ignore that value.  Only the example
shows that the caller can pass NULL.

Reported-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk bb0fed2e8a sendfile.2: Shift text on falling back to read()/write() to NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk c8a58c6aa0 sendfile.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Akira Fujita fe0ed23f6f sendfile.2: Since 2.6.33, 'out_fd' can refer to any file type
Linux kernel commit cc56f7de7f00d188c7c4da1e9861581853b9e92f
meant sendfile(2) can work with any output file.
Therefore the 'out_fd' of sendfile(2) can refer to any file
(since Linux 2.6.33).

Signed-off-by: Akira Fujita <a-fujita@rs.jp.nec.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk c39f51b0f2 syscalls.2: Update to mention 3.x kernel series
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 622d2c7229 syscalls.2: Update kernel version at head of syscall list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk a2f4e5a8ba time.2: NOTES: Fix description of "Seconds since the Epoch"
Reported-by: Alexander Schuch <Alex.Schuch@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Simon Paillard c3074d7061 fallocate.2, kexec_load.2, poll.2, spu_run.2, atan2.3, cbrt.3, clock_getcpuclockid.3, end.3, frexp.3, getgrouplist.3, getifaddrs.3, matherr.3, modf.3, pow.3, pthread_getattr_np.3, pthread_getcpuclockid.3, sched_getcpu.3, tgamma.3, mouse.4, proc.5, feature_test_macros.7, spufs.7: Global fix: properly escape minus sign
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk ec3cf7a42e mlock.2: Simplify and correct text for EPERM error
Reported-by: Seonghun Lim <wariua@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:47 +02:00
Michael Kerrisk 74da838c0d getrlimit.2: Fix example program and add _FILE_OFFSET_BITS requirement
Reported-by: Seonghun Lim <wariua@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:47 +02:00
Michael Kerrisk c066b1699c stat.2: Small rewording of ENAMETOOLONG error
Reported-by: Jon Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:47 +02:00
Folkert van Heusden fd3ac44091 open.2: Remove text describing O_CLOEXEC as Linux-specific
O_CLOEXEC is specified in POSIX.1-2008, as noted
elsewhere in the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk c370cc1b56 readlink.2: SEE ALSO: Add readlink(1)
Reported-by: Dan Jacobson <jidanni@jidanni.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk 4f96e450e1 getrlimit.2: Remove mention of kernel versions in discussion RLIMIT_CPU
Reported-by: Ryan Mullen <rmmullen@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk a9ddf39094 fcntl.2: Note that F_GETFL also retrieves file access mode
Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk 7959206648 fcntl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk a60450a926 clone.2: Note that CLONE_STOPPED was removed in 2.6.38
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk 0048657dcc sigaction.2: Add a little info about ucontext_t
Reported-by: Tolga Dalman <tolga.dalman@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk 6cce8340a7 sendfile.2: Remove mention of kernel version for 'in_fd' argument
Reported-by: Tolga Dalman <tolga.dalman@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk 87e5ebf9ff mprotect.2, malloc.3, signal.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Seonghun Lim 8c56fcecab fallocate.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:45 +02:00
Seonghun Lim 7d9da03f0f mprotect.2: Fix small bug in example program
The description of the example program says that it makes the
third page "read-only". Thus use PROT_READ instead of PROT_NONE.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:45 +02:00
Seonghun Lim 53d30e4520 sigaction.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:45 +02:00
Seonghun Lim 7efbd729c4 prctl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:45 +02:00
Seonghun Lim 374ce86756 truncate.2: Remove redundant EINTR description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:45 +02:00
Seonghun Lim da2336b314 mprotect.2: fix off-by-one error in a memory range
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:45 +02:00
Yuri Kozlov 10713b85bd getrlimit.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:45 +02:00
Seonghun Lim 99c1a99998 tee.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:45 +02:00
Seonghun Lim 503979fa5c posix_fadvise.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Yuri Kozlov b265f7bbe2 posix_fadvise.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Yuri Kozlov 46fbc1041e ptrace.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Yuri Kozlov 73e78a8718 recv.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Yuri Kozlov 79fd50e603 poll.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Yuri Kozlov cc12d0c5c8 poll.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Yuri Kozlov 39c05c26b1 poll.2: ffix 2011-09-16 07:00:44 +02:00
Michael Kerrisk dcfe09af98 syslog.2: Update for kernel 2.6.37 changes
Document /proc/sys/kernel/dmesg_restrict.
Document CAP_SYSLOG.

Reported-by: Serge E. Hallyn <serge.hallyn@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Michael Kerrisk 80945477f0 syslog.2: Minor wording and formatting changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Michael Kerrisk ceffa78f9c syncfs.2: New link for sync(2).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Michael Kerrisk 56fe7791c0 sync.2: Added new syncfs() system call
syncfs() was added in Linux 2.6.39.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Michael Kerrisk bedbb5335d sync.2: Some rewrites to description of sync()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Michael Kerrisk e440702e74 timer_create.2: Minor fix to shell session example
Reported-by: Timmy Lee <scuttimmy@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:44 +02:00
Michael Kerrisk 07ee7db9e2 timer_create.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-11 17:02:28 +02:00
Michael Kerrisk 0245dc09f7 clock_getres.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-11 17:02:28 +02:00
Michael Kerrisk b56defd37a ptrace.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-11 17:02:27 +02:00
Michael Kerrisk d09de287ff timerfd_create.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-11 17:02:27 +02:00
Michael Kerrisk 3e55b0bd4e syscalls.2: Updated for Linux 3.0 system calls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-11 17:02:27 +02:00
Michael Kerrisk b9cad55be7 syscalls.2: Added new 2.6.39 system calls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-11 17:02:19 +02:00
Michael Kerrisk 7b9f204cbe sched_setscheduler.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-07 19:25:01 +02:00
Michael Kerrisk 985ce6b87c linkat.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-07 19:24:42 +02:00
Michael Kerrisk 4723a20763 madvise.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-07 19:18:33 +02:00
Michael Kerrisk 54903f5e97 open.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-07 19:17:43 +02:00
Michael Kerrisk 171875791b fallocate.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-07 19:13:38 +02:00
Michael Kerrisk f934a15ff5 fstatat.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-07 19:11:45 +02:00
Michael Kerrisk 279688a57c lseek.2: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-07 19:07:37 +02:00
Michael Kerrisk 3610ae93f1 syscalls.2: Added fanotify_init() and fanotify_mark() to syscall list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-01-06 21:42:41 +01:00
Michael Kerrisk c5662d5de0 Removed trailing white space at end of lines 2010-12-03 08:01:44 +01:00
Michael Kerrisk f8697edd6d getrlimit.2, sendfile.2, stat.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:43:09 +01:00
Michael Kerrisk cb22cfb4c2 epoll_wait.2: Updated VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Michael Kerrisk b58b6ff793 epoll_ctl.2: Added VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Michael Kerrisk 6c3529d8d7 epoll_create.2: Added VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Michael Kerrisk 34936513ff epoll_create.2: Note that 'size' argument must be greater than 0
See https://bugzilla.kernel.org/show_bug.cgi?id=23872

Reported-by: Joern Heissler <kernelbugs@joern.heissler.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Denis Barbier dd7f192841 truncate.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Denis Barbier eb67e713fd swapon.2: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Denis Barbier 9d04fbe5ec readv.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Denis Barbier f407a032bb pread.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Denis Barbier 6303d401a9 open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:18 +01:00
Denis Barbier 76d47700ff getrlimit.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:17 +01:00
Michael Kerrisk 2b1c23bd2d clock_nanosleep.2: Clarify that clock_nanosleep() suspends the calling *thread*
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:17 +01:00
Michael Kerrisk f18f882c85 chdir.2: Remove redundant and incorrect info on FTMs from NOTES
Reported-by: Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:17 +01:00
Michael Kerrisk 4d69ed2e0d stat.2: Fix EOVERFLOW error description
2<<31 should read 1<<31 (which equals 2^31).

Reported-by: Emil Mikulic <emikulic@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:05 +01:00
Michael Kerrisk ea03a3acf0 setresuid.2: Add NOTES explaining 32-bit system calls added in Linux 2.4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-22 08:52:48 +01:00
Michael Kerrisk ae67a2cdf3 setfsuid.2: Add NOTES explaining 32-bit system calls added in Linux 2.4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-22 08:52:47 +01:00
Michael Kerrisk 80978cba04 getuid.2: Add NOTES explaining 32-bit system calls added in Linux 2.4
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-22 08:52:47 +01:00
Michael Kerrisk dd09a14ed5 setuid.2: Add NOTES explaining 32-bit system calls added in Linux 2.4 2010-11-22 08:52:39 +01:00
Michael Kerrisk ee3b2c7697 setreuid.2: Add NOTES explaining 32-bit system calls added in Linux 2.4 2010-11-22 08:52:28 +01:00
Michael Kerrisk 6dc1520bfb setgid.2: Add NOTES explaining 32-bit system calls added in Linux 2.4 2010-11-22 08:52:18 +01:00
Michael Kerrisk 0f0b04f83d setfsgid.2: Add NOTES explaining 32-bit system calls added in Linux 2.4 2010-11-22 08:52:11 +01:00
Michael Kerrisk de1fb253cc getgroups.2: Add NOTES explaining 32-bit system calls added in Linux 2.4 2010-11-22 08:52:05 +01:00
Michael Kerrisk 62eaf126c7 getresuid.2: Add NOTES explaining 32-bit system calls added in Linux 2.4 2010-11-22 08:51:55 +01:00
Michael Kerrisk 7c36affc19 getgid.2: Add NOTES explaining 32-bit system calls added in Linux 2.4 2010-11-22 08:51:46 +01:00
Michael Kerrisk 697fa2a158 chown.2: Add NOTES explaining 32-bit system calls added in Linux 2.4 2010-11-22 08:51:33 +01:00
Michael Kerrisk 489376f89c setuid.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-22 08:44:00 +01:00
Michael Kerrisk 48ef9f70f8 setuid.2: Minor fix: remove redundant subheading in NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-22 08:43:14 +01:00
Michael Kerrisk e6ce241912 setuid.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-22 08:42:43 +01:00
Michael Kerrisk 1e7eb3a765 setresuid.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-22 08:38:12 +01:00
Michael Kerrisk acf73919b3 getdents.2: srcfix: Add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-21 07:26:29 +01:00
Michael Kerrisk 8dc79b9cf9 getdents.2: Added notes on getdents64()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-21 07:25:25 +01:00
Michael Kerrisk 33cf6d369b sendfile.2: Add notes on sendfile64()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-21 07:10:52 +01:00
Michael Kerrisk e283e0067b statfs.2: Add notes on statfs64() and fstatfs64()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-21 07:03:45 +01:00
Michael Kerrisk 950eacdca4 fstatat.2: Add NOTES on fstatat64(), the name of the underlying system call
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-21 06:47:41 +01:00
Michael Kerrisk a4590809bd pread.2: Add notes on pread64() and pwrite64()
See https://bugzilla.kernel.org/show_bug.cgi?id=23072

Reported-by: Eugene Kapun <abacabadabacaba@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-21 06:39:03 +01:00
Michael Kerrisk 0290f43731 truncate.2: Add notes on truncate64() and ftruncate64()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-21 06:25:39 +01:00
Michael Kerrisk c069739940 truncate.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-21 06:23:29 +01:00
Michael Kerrisk 0e8704ae99 fcntl.2: Add notes on fcntl64()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-21 06:13:41 +01:00
Michael Kerrisk 36757dc153 sigqueue.2, pthreads.7, signal.7: SEE ALSO: Add pthread_sigqueue(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-17 06:56:44 +01:00
Michael Kerrisk 5427f5fbfc readv.2: srcfix: Update copyright notice and changelog
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-16 07:52:30 +01:00
Michael Kerrisk e7d8245112 readv.2: Wording fix: readv() and writev() are system calls, not functions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-16 07:14:30 +01:00
Michael Kerrisk 99149d6ee0 pwritev.2: New link to readv.2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-16 07:10:56 +01:00
Michael Kerrisk 269d1dda16 preadv.2: New link to readv.2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-16 07:10:05 +01:00
Michael Kerrisk e0e3a6a351 readv.2: Add documentation of preadv() and pwritev()
The preadv() and pwritev() system calls were added in
Linux 2.6.30.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-16 07:08:37 +01:00
Michael Kerrisk 2f3e829705 pread.2: SEE ALSO: add readv(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-16 06:51:37 +01:00
Denis Barbier bbc6739899 getrlimit.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-16 06:21:01 +01:00
Michael Kerrisk e13cd31cea getpagesize.2: Improve description of getpagesize()
Improve description of getpagesize() and relocate discussion
of sysconf(_SC_PAGESIZE).

In part inspired by
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=537272

Reported-by: Török Edwin <edwintorok@gmail.co
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-16 05:33:59 +01:00
Denis Barbier 010eefd76a getrlimit.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 07:51:55 +01:00
Michael Kerrisk 37e59a61db getrlimit.2: Add example program for prlimit()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 07:48:31 +01:00
Michael Kerrisk 658ea3ee74 getrlimit.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 07:43:18 +01:00
Michael Kerrisk 11532b16db getrlimit.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 07:42:39 +01:00
Hugh Dickins bd5d3c1c68 swapon.2: Document SWAP_FLAG_DISCARD and discarding of swap pages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 07:34:23 +01:00
Ivana Hutarova Varekova 10b7a94568 open.2: O_EXCL can be used without O_CREAT for block devices
Since Linux 2.6 there is a possibility to use O_EXCL without
O_CREAT. See patch: http://lkml.org/lkml/2003/8/10/221.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 06:58:11 +01:00
Michael Kerrisk 2a052964f5 getrlimit.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-12 06:30:42 +01:00
Michael Kerrisk 9a4b3ecd5b getrlimit.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-12 06:27:21 +01:00
Michael Kerrisk 98b43b5737 Removed trailing white space at end of lines 2010-11-12 06:16:40 +01:00
Michael Kerrisk 4af700b726 intro.2: Added various pages to SEE ALSO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-11 06:55:35 +01:00
Michael Kerrisk c805532e4e getrlimit.2: Remove unneeded text in DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-07 16:02:59 +01:00
Michael Kerrisk 1234c39735 prlimit.2: New link to getrlimit.2
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-07 16:02:59 +01:00
Michael Kerrisk 0ef19275c7 getrlimit.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-07 16:02:59 +01:00
Michael Kerrisk 1546fe1968 getrlimit.2: Added documentation of prlimit()
prlimit() is new in kernel 2.6.36.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-07 16:02:59 +01:00
Michael Kerrisk 6b2953e4ea sched_setaffinity.2: Add missing word "real" to "user ID"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-07 15:26:12 +01:00
Michael Kerrisk 940795c09a syscalls.2: Add prlimit() to list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-07 15:26:08 +01:00
Denis Barbier 531bc08876 kexec_load.2: ffix + wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-04 07:40:06 +01:00
Denis Barbier ce06aee210 kexec_load.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-04 07:16:30 +01:00
Michael Kerrisk 3ed3a50747 syscalls.2: Fix kernel version number for kexec_load
kexec_load() was first implemented in 2.6.13, though the entry
in the system call table was reserved starting in 2.6.7.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-04 07:14:31 +01:00
Michael Kerrisk 53bdbeec81 kexec_load.2: VERSIONS: Fix version number
kexec_load() was first implemented in 2.6.13, though the entry
in the system call table was reserved starting in 2.6.7.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-04 07:14:25 +01:00
Michael Kerrisk 3231873968 kexec_load.2: Fix copyright
Make copyright in the name of Intel corporation

Reported-by: Andi Kleen <andi@firstfloor.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-04 07:06:58 +01:00
Michael Kerrisk 036dabf5ff kexec_load.2: Add kernel version where KEXEC_PRESERVE_CONTEXT first appeared
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-04 07:05:12 +01:00
Michael Kerrisk dc3df54890 kexec_load.2: Added kernel version number where KEXEC_ON_CRASH first appeared
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-04 06:47:18 +01:00
Michael Kerrisk 0ef8bebc6a migrate_pages.2: SEE ALSO: Add reference to Documentation/vm/page_migration
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 16:50:30 +01:00
Michael Kerrisk d5e2db539d clone.2, fcntl.2, euidaccess.3, getopt.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 15:53:53 +01:00
Michael Kerrisk 0b80cf56e3 Changes, clone.2, mount.2, nanosleep.2, sigaltstack.2, statfs.2, timer_settime.2, ctime.3, fmemopen.3, nl_langinfo.3, posix_memalign.3, pthread_attr_init.3, pthread_setaffinity_np.3, pthread_setschedprio.3, pthread_testcancel.3, setjmp.3, sigwait.3, tty_ioctl.4, epoll.7, posixoptions.7, unix.7: Add section number to references to functions documented in other pages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 08:07:28 +01:00
Michael Kerrisk a45f957e63 sync_file_range.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:52:28 +01:00
Michael Kerrisk 261de44f04 statfs.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:42:29 +01:00
Michael Kerrisk ee688688e9 getitimer.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:38:59 +01:00
Michael Kerrisk 82b6d79719 timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, dprintf.3, aio.7: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:21:04 +01:00
Michael Kerrisk 27807c324f Changes, keyctl.2, request_key.2, subpage_prot.2, syslog.2, pthread_kill.3: ERRORS: Place errors in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:18:03 +01:00
Michael Kerrisk 27d47e71ef Changes, access.2, clone.2, aio_init.3, atexit.3, makecontext.3, makedev.3, pthread_attr_setdetachstate.3, pthread_exit.3: Remove redundant section number in page references
Remove section number in function references that are for
functions documented on this page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 06:59:37 +01:00
Michael Kerrisk 4105b0b5e4 timer_settime.2: Remove redundant SEE ALSO reference
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 06:52:04 +01:00
Michael Kerrisk 3e5c319e24 clock_nanosleep.2, getpriority.2, kexec_load.2, nanosleep.2, nice.2, sched_setaffinity.2, timer_create.2, timer_delete.2, timer_settime.2, utime.2, btowc.3, futimes.3, log.3, pthread_attr_setguardsize.3, pthread_kill_other_threads_np.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_tryjoin_np.3, strcoll.3, strcpy.3, string.3, strxfrm.3, networks.5, aio.7, sigevent.7, udplite.7: SEE ALSO: Place entries in correct order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 06:35:42 +01:00
Michael Kerrisk 939fd8db06 reboot.2: Place 'cmd' values in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 15:14:13 +01:00
Michael Kerrisk 577dd8b1d0 kexec_load.2: Note that CONFIG_KEXEC is needed
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 07:37:36 +01:00
Andi Kleen fed71ac385 reboot.2: Document LINUX_REBOOT_KEXEC
Some fix-ups by Michael Kerrisk

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 07:35:41 +01:00
Michael Kerrisk 02a4b9e988 kexec_load.2: Incorporate fixes from Eric W. Biederman
Eric noted that a few instances of "virtual" should
be "physical" and noted:

    There is an expectation that at hand off from sys_kexec that
    virtual and physical addresses will be identity mapped. But
    this isn't the old Alpha booting convention where you have
    a virtual address and then you have to parse the page table
    to figure out where your kernel was actually loaded.

Reported-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 07:16:03 +01:00
Michael Kerrisk 2a09a26172 kexec_load.2: Added VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 07:14:08 +01:00
Michael Kerrisk d1e833fef4 kexec_load.2: Resore accidentally deleted CONFORMING TO section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 07:13:11 +01:00
Michael Kerrisk ece948b4a3 kexec_load.2: Additions and edits by mtk
Various wording and layout improvements.
Fixed the name of a constant: s/KEXEC_ARCH_I386/KEXEC_ARCH_386/.
Added RETURN VALUE and ERRORS sections.
Removed details of using syscall; the reader can find them in
syscall(2).
Added some details for KEXEC_PRESERVE_CONTEXT.
Revised the text mentioning the kernel header, since it is
not yet exported, and it's not certain that it will be.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 07:06:49 +01:00
Michael Kerrisk e4f282ab26 kexec_load.2: Add license
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 07:00:21 +01:00
Andi Kleen 0bd8e0bf49 kexec_load.2: New page documenting kexec_load(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 06:59:24 +01:00
Michael Kerrisk 0a4f8b7bb4 getresuid.2, intro.2, mremap.2, open.2, poll.2, posix_fadvise.2, pread.2, remap_file_pages.2, setresuid.2, signal.2, splice.2, sync_file_range.2, tee.2, vmsplice.2, INFINITY.3, asprintf.3, assert_perror.3, basename.3, bsd_signal.3, canonicalize_file_name.3, clog10.3, crypt.3, dl_iterate_phdr.3, dlopen.3, dprintf.3, encrypt.3, exp10.3, fcloseall.3, fenv.3, ffs.3, fmemopen.3, fopencookie.3, ftw.3, getdate.3, getline.3, getloadavg.3, getopt.3, getsubopt.3, getutent.3, grantpt.3, hsearch.3, intro.3, lseek64.3, memmem.3, mempcpy.3, mq_receive.3, mq_send.3, posix_fallocate.3, pow10.3, program_invocation_name.3, ptsname.3, putgrent.3, readdir.3, sigset.3, sincos.3, stpcpy.3, stpncpy.3, strchr.3, strfry.3, strnlen.3, strptime.3, strsignal.3, strstr.3, strverscmp.3, swab.3, sysv_signal.3, tsearch.3, unlocked_stdio.3, unlockpt.3, wcpcpy.3, wcpncpy.3, wcsdup.3, wcwidth.3: SEE ALSO: Remove redundant reference to feature_test_macros(7)
Reported-by: Florian Lehmann <flo.lehmann@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 06:06:58 +01:00
Michael Kerrisk b80f966bb0 getresuid.2, mremap.2, poll.2, remap_file_pages.2, setresuid.2, splice.2, sync_file_range.2, syscall.2, tee.2, vmsplice.2, INFINITY.3, aio_init.3, asprintf.3, assert_perror.3, basename.3, bsd_signal.3, canonicalize_file_name.3, clog10.3, crypt.3, dl_iterate_phdr.3, dlopen.3, encrypt.3, exp10.3, fcloseall.3, fenv.3, fopencookie.3, ftw.3, getaddrinfo_a.3, getloadavg.3, getutent.3, grantpt.3, hsearch.3, lseek64.3, memmem.3, mempcpy.3, pow10.3, program_invocation_name.3, ptsname.3, putgrent.3, sched_getcpu.3, sincos.3, strchr.3, strfry.3, strnlen.3, strptime.3, strstr.3, strverscmp.3, swab.3, sysv_signal.3, tsearch.3, unlockpt.3, wcwidth.3: Add reference to feature_test_macros(7)
Some pages simply list feature test macro requirements in
the form:

    #define #GNU_SOURCE
    #include <someheader.h>

For these pages, add a "See feature_test_macros(7)" comment
on the "#define" line.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-31 05:31:47 +01:00
Michael Kerrisk 9108d86725 clone.2: Clarify when CLONE_NEWNET implementation was completed
Reported-by: Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-30 08:12:03 +02:00
Lucian Adrian Grijincu 61f22790e1 unshare.2: Improve description of CLONE_NEWNET
CLONE_NEWNET creates a new network namespace from scratch.
You don't have anything from the old network namespace in
the new one. Even the loopback device is new.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-30 07:52:36 +02:00
Michael Kerrisk baeb920b34 mlock.2: shmctl() SHM_LOCKed memory is not included in VmLck
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-30 07:32:55 +02:00
Michael Kerrisk e5eb406c9c mlock.2: Improve wording describing /proc/PID/status /VmLck field
Reported-by: Yuri Kozlov <yuray@komyakino.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-30 07:28:31 +02:00
Michael Kerrisk e4b4151a14 fcntl.2: RETURN VALUE: Improve description of F_GETFD and F_GETFL
Reported-by: scarlettsp <scarlettsp@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-30 07:23:10 +02:00
Michael Kerrisk ae416c7e62 subpage_prot.2: fixup
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-30 07:21:24 +02:00
Michael Kerrisk c079ed6486 subpage_prot.2: Improvements after review by Paul Mackerras
Reported-by: Paul Mackerras <paulus@samba.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-30 07:18:30 +02:00
Michael Kerrisk b3bc5386d6 unshare.2: Document CLONE_NEWNET
Reported-by: Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 16:32:50 +02:00
Michael Kerrisk da2e0e532f unshare.2: Document CLONE_NEWUTS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 16:29:20 +02:00
Michael Kerrisk a948ae520e unshare.2: Dcoument CLONE_SYSVSEM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 16:28:36 +02:00
Michael Kerrisk 25539b1b6c unshare.2: Document CLONE_NEWIPC
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 16:19:48 +02:00
Michael Kerrisk 486d4e9b99 unshare.2: Relocate discussion of CAP_SYS_ADMIN to CLONE_NEWNS section
And rewrite the EPERM description to be more general in
preparation for the new flags to be documented.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 16:02:24 +02:00
Michael Kerrisk c8e4c1bdc3 unshare.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 15:59:48 +02:00
Michael Kerrisk 05b9225154 access.2: Note use of faccessat(2) for checking symbolic link permissions
Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 09:41:36 +02:00
Michael Kerrisk 1cdb1ec17c faccessat.2: Note that faccessat() is racy
Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 09:41:36 +02:00
Michael Kerrisk 4713564349 access.2: Give an example of a safer alternative to using access()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 09:19:24 +02:00
Michael Kerrisk 7a35b9818e access.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-24 09:09:48 +02:00