Commit Graph

17559 Commits

Author SHA1 Message Date
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
Michael Kerrisk de694c9840 pipe.7: Clarify that default pipe capacity is 16 pages
The statement that the default pipe capacity is 65536 bytes
is accurate only on systems where the page size is 4096B.
See the use of PIPE_DEF_BUFFERS in the kernel source.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00
Michael Kerrisk 015c503468 vfork.2: Explain why the child should not call exit(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00
Michael Kerrisk f3d0d38ecc vfork.2: SEE ALSO: add _exit(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00
Michael Kerrisk c76ea16ab4 fts.3: Clarify meaning of zero as 'instr' value for fts_set()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00
Michael Kerrisk 71ddeb19dc fts.3: Improve explanation of 'fts_errno'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 90882d77f2 fts.3: Give a hint that there are further fields in the FTSENT structure
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 6110d89af1 fts.3: Fix minor error in FTSENT structure definition
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 17b0c3ad68 fts.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 822ffd7cb6 fts.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 1fcf641193 fts.3: Use better argument name for fts_children() and fts_set()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:07 +01:00
Michael Kerrisk 8b65f73d05 fts.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 20:03:47 +01:00
Michael Kerrisk 5c71ea83df fts.3: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk c9e5b0e128 fts.3: Minor fix: make the meaning of "stream" a little more obvious
"Stream" was used lower in the page, without first
being defined.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk f6c7968375 fts.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00