Commit Graph

17473 Commits

Author SHA1 Message Date
Michael Kerrisk 70a95af3a6 signal.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 11:58:03 +01:00
Mike Frysinger 026958bb6e syscall.2: Note parisc handling of aligned register pairs
While parisc would normally have the same behavior as ARM/PowerPC,
they decide to write shim syscall stubs to unpack/realign rather
than expose the padding to userspace.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 11:25:20 +01:00
Michael Kerrisk 89e284a26e proc.5: Mention other system calls that create 'anon_inode' file descriptors
Mention a few other system calls that create file descriptors
that display an 'anon_inode' symlink in /proc/PID/fd

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 11:17:15 +01:00
Michael Kerrisk e2a5929d2d proc.5: Minor improvement to description of /proc/PID/fd symlinks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 11:11:19 +01:00
Michael Kerrisk 82ec64e473 proc.5: Remove duplicate /proc/[pid]/seccomp entry
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 10:30:50 +01:00
Michael Kerrisk 934018606b proc.5: Minor: fix alphabetical order of some /proc/PID entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 10:28:32 +01:00
Michael Kerrisk df2a857637 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 10:25:27 +01:00
Michael Kerrisk 20c1a631cd proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 10:23:58 +01:00
Michael Kerrisk 9ad8555cd0 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 10:18:04 +01:00
Michael Kerrisk b6f10ec5fe mbind.2: Restore description of MPOL_BIND behavior before Linux 2.6.265
Krzysztof Kulakowski's patch updated the MPOL_BIND description
to describe current behavior, but the page should retain a
description of the older behavior as well.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 10:09:55 +01:00
Michael Kerrisk 009fe7d6fd mbind.2: Restore a sentence that should not have been removed by preceding patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 10:06:37 +01:00
Krzysztof Kulakowski 348f78ab2f mbind.2: Update MPOL_BIND section
Behavior of MPOL_BIND has been changed in kernel commit
19770b32609b6bf97a3dece2529089494cbfc549 (Linux 2.6.26). This
patch updates section describing MPOL_BIND to be in sync with
current state of Documentation/vm/numa_memory_policy.txt.

Signed-off-by: Krzysztof Kulakowski <krzysztof.kulakowski@intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 09:56:00 +01:00
Jakub Wilk 17efe87f49 open.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 09:11:37 +01:00
Mike Frysinger efa75963cc syscall.2: Add endian details with 64-bit splitting
Architectures that split 64-bit values across register pairs
usually do so according to their C ABI calling convention (which
means endianness).  Add some notes to that effect, and change the
readahead example to show a little endian example (since that is
way more common than big endian).

Also start a new list of syscalls that this issue does not apply
to.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 09:05:41 +01:00
Michael Kerrisk 4f9d01a93e backtrace.3: SEE ALSO: add addr2line(1) and gdb(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-07 09:26:56 +01:00
Michael Kerrisk cf3ecd874c posix_spawn.3: tfix
Reported-by: Paul Fee <paul.f.fee@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-03 15:43:05 +01:00
Michael Kerrisk de340b15cf namespaces.7: SEE ALSO: add ip-netns(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-02 14:40:30 +01:00
Michael Kerrisk b480342040 ip.7: SEE ALSO: add ip(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-02 14:39:37 +01:00
Michael Kerrisk 1186d4c363 nanosleep.2: Describe "creeping sleep" problem
nanosleep() has a problem if used in a program that catches
signals and those signals are delivered at a very high rate.
Describe the problem, and note that clock_nanosleep(2)
provides a solution.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-27 17:10:48 +01:00
Michael Kerrisk 91bf33ff1f nanosleep.2: BUGS: explicitly note that the Linux 2.4 bug was fixed in Linux 2.6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-27 17:02:52 +01:00
Michael Kerrisk 68807b135e ioctl_ns.2: Minor reworking of text
In preparation for material on new Linux 4.11 namespace
ioctl() operations.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-27 12:52:55 +01:00
Michael Kerrisk 9719dd1c10 listxattr.2: Eliminate extra E2BIG error text
Andreas' patch added a second description of E2BIG that
was (mostly) more detailed than the existing text. Combine
the two texts.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:24:28 +01:00
Michael Kerrisk efb3a65a9b getxattr.2, listxattr.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:23:37 +01:00
Michael Kerrisk f124c13603 getxattr.2, listxattr.2: Minor: fix alphabetic order of errors
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:22:51 +01:00
Andreas Gruenbacher b0a9e01500 getxattr.2, listxattr.2: Document E2BIG errors
Signed-off-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:18:57 +01:00
Michael Kerrisk 88f78c4aa7 ftw.3: Correctly handle use of stat info for FTW_NS in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:17:40 +01:00
Michael Kerrisk d252ac9d8b ftw.3: Clarify that stat buffer is undefined for FTW_NS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:15:07 +01:00
Michael Kerrisk fb257aa8bc link.2: Note limits where EMLINK is encountered on ext4 and Btrfs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-23 06:21:50 +01:00
Michael Kerrisk c56a0185fc proc.5: Add reference to vdso(7) in discussion of /proc/PID/maps
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-21 21:53:42 +01:00
Michael Kerrisk 20b8f0e2a5 open.2: Make it clear that O_APPEND implies atomicity
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-21 08:42:43 +01:00
Michael Kerrisk f225d14b1b lseek.2: Remove slightly bogus advice about race conditions
The page already (by now) contains a reference to open(2)
for a discussion of open file descriptions. Leave it at that,
since the reader can then deduce how things work.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-20 23:23:16 +01:00
Michael Kerrisk c257d35f5b readv.2: Remove generic advice about mixing stdio and syscalls on same file
There is nothing specific to readv()/writev() about this advice.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-20 22:36:36 +01:00
Michael Kerrisk 6b74f6c767 lseek.2: O_APPEND overrides the effect of lseek() when doing file writes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-20 22:33:49 +01:00
Michael Kerrisk 4296478383 lseek.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-20 22:29:10 +01:00
Michael Kerrisk d8c51e9bd5 lseek.2: Remove ancient info about whence values and return values on old systems
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-20 22:27:50 +01:00
Michael Kerrisk 4dbcdd1532 environ.7: Mention prctl(2) PR_SET_MM_ENV_START and PR_SET_MM_ENV_END operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-20 22:01:15 +01:00
Michael Kerrisk c187d2a16c proc.5: Tweaks to Mike's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-20 22:01:15 +01:00
Michael Kerrisk 09651080d1 proc.5: Clarify that /proc/PID/environ is set at time of execve(2)
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-20 21:57:08 +01:00
Mike Frysinger 387e243882 proc(5): Clarify /proc/pid/environ behavior
/proc/pid/environ reflects process environment at
*start* of program execution.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-20 08:07:54 +01:00
Michael Kerrisk c58a465366 environ.7: tfix/ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:50:19 +01:00
Michael Kerrisk 09a7d9a39b environ.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:50:19 +01:00
Michael Kerrisk bf54cc8653 fork.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk 91551f1099 fork.2: cgroup PIDs controller may also be trigger for EAGAIN error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk e186d0ca34 mq_receive.3, mq_send.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk 1ce0421b98 mq_open.3: Include definition of the 'mq_attr' structure in this man page
Make the reader's life a little easier by saving them from
having to refer to mq_getattr(3).

Reported-by: Adam Martindale <adam.john.martindale@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk c1b9bce2ed mq_send.3: Refer to mq_overview(7) for details on range of message priority
Reported-by: Adam Martindale <adam.john.martindale@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk 82918334f1 request_key.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Jann Horn f5a0865dc3 tkill.2: Document EAGAIN error for real-time signals
See __send_signal() in kernel/signal.c:

if (sig >= SIGRTMIN && info->si_code != SI_USER) {
  /*
   * Queue overflow, abort.  We may abort if the
   * signal was rt and sent by user using something
   * other than kill().
   */
  result = TRACE_SIGNAL_OVERFLOW_FAIL;
  ret = -EAGAIN;
  goto ret;
}

(kill() uses SI_USER, but tkill() and tgkill() use SI_TKILL.)

Signed-off-by: Jann Horn <jannh@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00
Brian Masney 9aa10c77bf ioctl_fat.2: Correctly reference volume ID instead of volume label
The description of FAT_IOCTL_GET_VOLUME_ID references volume name,
when it really should be volume ID since the volume label is
different in the FAT filesystem. This patch renames the incorrect
volume name references to volume id.

This man page supplies an example display_fat_volume_id.c program
that can be used to read the volume ID (serial number) from a
filesystem.  Here is an additional test showing that the volume ID
and volume name are two different entities:

$ dd if=/dev/zero of=fat_volume bs=1M count=1
$ mkfs.fat -v -n MASNEYB fat_volume
[snip]
Volume ID is da8cecf2, volume label MASNEYB    .
$ sudo mount -o loop fat_volume /mnt
$ ./display_fat_volume_id /mnt/
Volume ID da8c-ecf2

Signed-off-by: Brian Masney <masneyb@onstation.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00
Michael Kerrisk 3d8988755f pipe.7: Since Linux 4.9, pipe-max-size is ceiling for the default pipe capacity
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00