Commit Graph

16345 Commits

Author SHA1 Message Date
Michael Kerrisk 343313da58 setpgid.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:50:16 +01:00
Michael Kerrisk b40e567a40 setsid.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:49:14 +01:00
Michael Kerrisk 7903f95f0a setpgid.2, setsid.2: Relocate some text on sessions and sessions leaders
Some text that was in setpgid(2) is better placed in setsid(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:46:50 +01:00
Michael Kerrisk 1a7655042a setpgid.2: Add a reference to credentials(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:41:59 +01:00
Michael Kerrisk 9d604ae9a7 credentials.7: SEE ALSO: add setsid(2) and setpgid(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:34:34 +01:00
Michael Kerrisk 318519daa3 execve.2: Mention use of 'environ' to access environment list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:16:38 +01:00
Michael Kerrisk f9429ced31 execve.2: Minor clarification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:13:05 +01:00
Michael Kerrisk af5b74504f execve.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:11:10 +01:00
Michael Kerrisk 0f37a0627f execve.2: Minor clarification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:10:48 +01:00
Michael Kerrisk fc9db90e81 execve.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:08:13 +01:00
Michael Kerrisk ce2ca8cc4f execve.2: Minor clarification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:07:32 +01:00
Michael Kerrisk 8b4be846c7 fcntl.2: Make the description of the effect of close-on-exec a little clearer
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 06:00:04 +01:00
Michael Kerrisk fa1aa3502a close.2: Clarify discussion noting that close() does not flush buffer cache
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 05:53:36 +01:00
Michael Kerrisk f157f403de fcntl.2: Clarify that F_GETFD and F_GETFL return flags via the function result
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 05:48:47 +01:00
Michael Kerrisk dc4b358fe0 ld.so.8: Remove mention of "ELF only"
Drawing a distinction between ELF-only features versus a,out
ceased to be relevant long ago, so cluttering the page
with "ELF-only" serves no purpose.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 11:28:24 +01:00
Michael Kerrisk 9a741b5b7c ld.so.8: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 11:27:03 +01:00
Michael Kerrisk 5a7b21d60d ld.so.8: Remove discussion of environment variables understood by libc5
libc5 disappeared long ago, so cease cluttering up this page
with those ancient details. Thus, remove discussion of the
following environment variables: LD_AOUT_LIBRARY_PATH,
LD_AOUT_PRELOAD, LD_KEEPDIR, LD_NOWARN, and LDD_ARGV0.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 11:22:08 +01:00
Michael Kerrisk d8d00ab7c8 ld.so.8: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 11:19:47 +01:00
Michael Kerrisk c7cee03767 ld.so.8: Remove text with ancient libc4 and Linux libc details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 11:13:33 +01:00
Michael Kerrisk 6c0a8674be ld.so.8: Add glibc version for LD_USE_LOAD_BIAS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 11:11:12 +01:00
Michael Kerrisk bdf75f3e20 ld.so.8: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 11:08:05 +01:00
Michael Kerrisk d81099fbbd ld.so.8: Expand description of LD_DEBUG
Provide a list of the categories, and note that multiple
categories can be specified.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 10:58:42 +01:00
Michael Kerrisk a3fb56962c ld.so.8: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 10:56:42 +01:00
Michael Kerrisk 82bf58ade7 initrd.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 10:56:42 +01:00
Michael Kerrisk 5e19dee2b7 initrd.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 10:56:42 +01:00
Michael Kerrisk e722b67cbe mouse.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 08:12:09 +01:00
Michael Kerrisk f7e09ea961 mouse.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 08:12:09 +01:00
Michael Kerrisk 02f47ea7ca lp.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-11 08:12:09 +01:00
Michael Kerrisk d133b9b3d8 proc.5: Clarify description of /proc/PID/statm 'lib' and 'dt' fields
These fields are always zero since Linux 2.6.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 10:20:25 +01:00
Michael Kerrisk 4e6fa35246 proc.5: Clarify that /proc/PID/statm 'shared' field counts *resident* pages
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360

Reported-by: Zefram <zefram@fysh.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 10:19:22 +01:00
Michael Kerrisk c364070664 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 10:08:57 +01:00
Michael Kerrisk e546617e9c proc.5: Document /proc/PID/status 'RssAnon', 'RssFile', and 'RssShmem' fields
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 10:07:36 +01:00
Michael Kerrisk 4084d612be proc.5: Document /proc/PID/status 'HugetlbPages' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 10:07:04 +01:00
Michael Kerrisk 06b7cee06a proc.5: Update example VM values in /proc/PID/status
In preparation for following patches.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 09:54:00 +01:00
Michael Kerrisk 984baa3fb3 clone.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-09 07:23:21 +01:00
HuKeping 794d8db3ab rtnetlink.3: tfix
Signed-off-by: Hu Keping <hukeping@huawei.com>
2016-09-09 07:23:18 +01:00
Michael Kerrisk 5e43063bdd readv.2: Clarify that RWF_DSYNC and RWF_SYNC apply only to data being written
Reported-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-04 16:52:08 +12:00
Michael Kerrisk dae86017d7 readv.2: Document the pwritev2() RWF_SYNC and RWF_DSYNC flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-04 16:46:49 +12:00
Michael Kerrisk 5c3bbffbb0 rename.2: Minor wording fix
The meaning of "when overwriting" is not clear. I believe what is
meant is that when an existing 'newpath' is replaced. However, we
can convey that meaning by eliding this text with the preceding
paragraph, so this patch does that.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-04 16:44:47 +12:00
Michael Kerrisk 84a3d76675 rename.2: Relocate some text text
Relocate text noting that there may be a window when 'oldpath' and
'newpath' refer to the same file. Logically, this text appears to
belong near the text noting that an existing 'newpath' will be
atomically replaced.  (In ancient versions of the page, these two
pieces of text were closer together.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-04 16:43:02 +12:00
Michael Kerrisk ae01f2b58b rename.2: Clarify that ERRORS may cause rename to fail (not to be nonatomic)
The existing wording suggests that there are ERRORS that may cause
the operation to be nonatomic. The point is of course that there
are various restrictions on rename operations that may cause the
operation to fail.

Reported-by: Tim Savannah <kata198@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-04 16:43:02 +12:00
Michael Kerrisk cbac502be2 mlock.2: Minor tweaks to Sebastian Andrzej Siewior's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-31 07:23:08 +12:00
Sebastian Andrzej Siewior fb08a0954e mlock.2: Document that fork() after mlock() may be a bad idea in a RT process
fork() will remove the write PTE bit from the page table on each
VMA which will be copied via COW. As such, the memory is available
but marked read only in the page table and will fault on write
access.  This renders the previous mlock() operation almost
useless because in a multithreaded application a realtime thread
may block on mmap_sem while a thread with low priority is holding
the mmap_sem (for instance because it is allocating memory which
needs to be mapped in).

There is actually nothing we can do to mitigate the outcome. We could
add a warning to the kernel for people that are not yet aware of the
updated documentation.

Signed-off-by: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
2016-08-31 07:23:08 +12:00
Michael Kerrisk 46305699f7 pthread_join.3: Note that the caller might do clean up after joining with a thread
Reported-by: Mats Wichmann <mats@wichmann.us>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-31 07:23:08 +12:00
Michael Kerrisk 1f73bfaf6e strverscmp.3: Add an example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-31 07:23:03 +12:00
Michael Kerrisk d695a48cdf stat.2: Tweak discussion of 'st_size' for /proc and /sys files
As Mats points out, there appear to be no (or almost no) files
under /proc and /sys for which 'st_size' is meaningful.
(mtk: verified via some scripting over these directories.)

Reported-by: Mats Wichmann <mats@wichmann.us>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-31 07:19:00 +12:00
Michael Kerrisk 919b0ce050 pthread_join.3: Clarify use of 'retval' pointer
Reported-by: 王守堰 <wangshouyan@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-29 09:56:47 +12:00
Michael Kerrisk 9dbc4adbce stat.2: Improve discussion of 'st_size' for /proc and /sys files
Reported-by: Ursache Vladimir <f35f22fan@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-29 08:47:39 +12:00
Ruben Kerkhof 370f8e34c4 epoll_ctl.2: tfix 2016-08-29 07:26:46 +12:00
Ruben Kerkhof 7bf58d66ac epoll_ctl.2: tfix 2016-08-29 07:25:55 +12:00