]>
git.ipfire.org Git - thirdparty/man-pages.git/log
Michael Kerrisk [Fri, 16 Sep 2016 15:23:09 +0000 (17:23 +0200)]
clone.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 16 Sep 2016 10:42:20 +0000 (12:42 +0200)]
lirc.4, proc.5, netlink.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 16 Sep 2016 10:40:55 +0000 (12:40 +0200)]
proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 16 Sep 2016 10:38:57 +0000 (12:38 +0200)]
proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 16 Sep 2016 10:38:18 +0000 (12:38 +0200)]
execve.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 16 Sep 2016 10:35:45 +0000 (12:35 +0200)]
prctl.2: ERRORS: Add EACCES error for PR_SET_SECCOMP-SECCOMP_MODE_FILTER
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Thu, 15 Sep 2016 16:39:57 +0000 (18:39 +0200)]
clone.2: EINVAL is generated by glibc wrapper for NULL 'fn' or 'child_stack'
Clarify that this error is produced by the wrapper function, not
the underlying system call. In particular, the point is that the
raw system call can accommodate a NULL pointer for 'child_stack'.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Thu, 15 Sep 2016 06:18:21 +0000 (08:18 +0200)]
ld.so.8: Clarify text describing whether secure-mode programs preload libraries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 19:41:08 +0000 (20:41 +0100)]
proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 19:40:39 +0000 (20:40 +0100)]
proc.5: Minor tweaks to Namhyung Kim's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Namhyung Kim [Sat, 10 Sep 2016 02:19:06 +0000 (11:19 +0900)]
proc.5: Add description of CLEAR_REFS_MM_HIWATER_RSS
The Linux kernel commit
695f05593693 ("fs/proc/task_mmu.c: add
user-space support for resetting mm->hiwater_rss (peak RSS)") added a
way to reset peak RSS of a process but missed to update manpage.
Cc: Petr Cermak <petrcermak@chromium.org>
Acked-by: Petr Cermak <petrcermak@chromium.org>
Signed-off-by: Namhyung Kim <namhyung@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 18:25:44 +0000 (19:25 +0100)]
raw.7: Clarify user namespace requirements for CAP_NET_RAW
Also remove mention of UID 0 as a method or creating
a raw socket. As far as I can tell from reading the
kernel source (net/ipv4/af_inet.c), this is not true.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 18:19:14 +0000 (19:19 +0100)]
packet.7: Clarify user namespace requirements for CAP_NET_RAW
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 18:10:28 +0000 (19:10 +0100)]
open.2: Clarify user namespace capability requirements for O_NOATIME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 18:00:04 +0000 (19:00 +0100)]
proc.5: Clarify user namespace requirements for /proc/sys/fs/protected_hardlinks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 17:51:48 +0000 (18:51 +0100)]
bindresvport.3, rcmd.3, ip.7: Note user namespace requirements for CAP_NET_BIND_SERVICE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 17:49:36 +0000 (18:49 +0100)]
ip.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 15:49:35 +0000 (16:49 +0100)]
msgctl.2, msgget.2, msgop.2, semctl.2, semget.2, semop.2, shmctl.2, shmget.2, shmop.2: Note the user namespace requirements for CAP_IPC_OWNER
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 15:30:16 +0000 (16:30 +0100)]
chroot.2: Note user namespace requirements for CAP_SYS_CHROOT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 14:22:09 +0000 (15:22 +0100)]
setuid.2: Note user namespace requirements for CAP_SETUID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 14:20:31 +0000 (15:20 +0100)]
setreuid.2: Note user namespace requirements for CAP_SETUID and CAP_SETGID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 14:12:16 +0000 (15:12 +0100)]
setresuid.2: Note user namespace requirements for CAP_SETUID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 14:11:29 +0000 (15:11 +0100)]
setgid.2: Note user namespace requirements for CAP_SETGID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 14:11:06 +0000 (15:11 +0100)]
setgid.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 14:10:06 +0000 (15:10 +0100)]
seteuid.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 14:09:27 +0000 (15:09 +0100)]
seteuid.2: Note user namespace requirements for CAP_SETUID and CAP_SETGID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 13:27:46 +0000 (14:27 +0100)]
setuid.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 13:23:02 +0000 (14:23 +0100)]
setresuid.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 13:21:59 +0000 (14:21 +0100)]
setgid.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 13:12:05 +0000 (14:12 +0100)]
kill.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 13:10:16 +0000 (14:10 +0100)]
kill.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 29 Jun 2016 15:44:55 +0000 (17:44 +0200)]
seccomp.2: CAP_SYS_ADMIN is required only in caller's user namespace
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 18:36:33 +0000 (20:36 +0200)]
getrlimit.2: Note user namespace semantics for CAP_SYS_RESOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 18:31:46 +0000 (20:31 +0200)]
getgroups.2: Note user namespace requirements for CAP_SETGID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 14:24:37 +0000 (16:24 +0200)]
getdomainname.2: Note user namespace requirements for CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 14:24:16 +0000 (16:24 +0200)]
gethostname.2: Note user namespace requirements for CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 14:13:51 +0000 (16:13 +0200)]
prctl.2: Note user namespace requirements for PR_CAPBSET_DROP CAP_SETPCAP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 13:31:05 +0000 (15:31 +0200)]
reboot.2: Note user namespace requirements around CAP_SYS_BOOT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 13:27:13 +0000 (15:27 +0200)]
sched_setaffinity.2: Note user namespace requirements for CAP_SYS_NICE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 13:21:57 +0000 (15:21 +0200)]
kill.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 13:21:29 +0000 (15:21 +0200)]
kill.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 13:21:14 +0000 (15:21 +0200)]
kill.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 13:20:40 +0000 (15:20 +0200)]
kill.2: Note the user namespace requirement for CAP_KILL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 13:16:32 +0000 (15:16 +0200)]
killpg.2: Refer reader to kill(2) for signal permission rules
Rather than repeating details here, refer the reader to kill(2)
(so that the rules are in a canonical location, and need only
be edited in one place for future changes--see next commit).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 13:06:07 +0000 (15:06 +0200)]
fcntl.2: Note an important detail of F_SETOWN permission rules for signals
F_SETOWN records the caller's credentials at the time of
the fcntl() call, and it is these saved credentials that
are used for subsequent permission checks.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 26 Jun 2016 12:59:33 +0000 (14:59 +0200)]
socket.7: SIOCSPGRP: refer to fcntl(2) F_SETOWN for correct permission rules
The permission rules described for SIOCCPGRP are wrong. Rather
than repeat the rules here, just refer the reader to fcntl(2),
where the rules are described for F_SETOWN.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 12:54:38 +0000 (13:54 +0100)]
close.2: Add mention of the close-on-exec flag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 06:37:45 +0000 (07:37 +0100)]
umask.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 06:29:15 +0000 (07:29 +0100)]
open.2: Clarify the rules about how the group ID of a new file is determined
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 06:20:45 +0000 (07:20 +0100)]
open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 06:19:47 +0000 (07:19 +0100)]
open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 06:09:29 +0000 (07:09 +0100)]
getsid.2: Rework description to be somewhat clearer
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 06:05:13 +0000 (07:05 +0100)]
setsid.2: Refer to credentials(7) for details for details on controlling terminal
Refer to credentials(7) for details of how a session obtains
a controlling terminal.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:57:44 +0000 (06:57 +0100)]
getsid.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:56:45 +0000 (06:56 +0100)]
getsid.2: Correct the definition of "session ID"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:50:16 +0000 (06:50 +0100)]
setpgid.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:49:14 +0000 (06:49 +0100)]
setsid.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:46:50 +0000 (06:46 +0100)]
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>
Michael Kerrisk [Mon, 12 Sep 2016 05:41:59 +0000 (06:41 +0100)]
setpgid.2: Add a reference to credentials(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:34:34 +0000 (06:34 +0100)]
credentials.7: SEE ALSO: add setsid(2) and setpgid(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:16:38 +0000 (06:16 +0100)]
execve.2: Mention use of 'environ' to access environment list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:13:05 +0000 (06:13 +0100)]
execve.2: Minor clarification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:11:10 +0000 (06:11 +0100)]
execve.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:10:48 +0000 (06:10 +0100)]
execve.2: Minor clarification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:08:13 +0000 (06:08 +0100)]
execve.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:07:32 +0000 (06:07 +0100)]
execve.2: Minor clarification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 05:00:04 +0000 (06:00 +0100)]
fcntl.2: Make the description of the effect of close-on-exec a little clearer
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 04:53:36 +0000 (05:53 +0100)]
close.2: Clarify discussion noting that close() does not flush buffer cache
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 12 Sep 2016 04:48:47 +0000 (05:48 +0100)]
fcntl.2: Clarify that F_GETFD and F_GETFL return flags via the function result
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 10:28:24 +0000 (11:28 +0100)]
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>
Michael Kerrisk [Sun, 11 Sep 2016 10:27:03 +0000 (11:27 +0100)]
ld.so.8: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 10:22:08 +0000 (11:22 +0100)]
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>
Michael Kerrisk [Sun, 11 Sep 2016 10:19:47 +0000 (11:19 +0100)]
ld.so.8: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 10:13:33 +0000 (11:13 +0100)]
ld.so.8: Remove text with ancient libc4 and Linux libc details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 10:11:12 +0000 (11:11 +0100)]
ld.so.8: Add glibc version for LD_USE_LOAD_BIAS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 10:08:05 +0000 (11:08 +0100)]
ld.so.8: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Sep 2016 16:36:07 +0000 (17:36 +0100)]
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>
Michael Kerrisk [Sat, 10 Sep 2016 16:19:04 +0000 (17:19 +0100)]
ld.so.8: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 09:12:20 +0000 (10:12 +0100)]
initrd.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 09:12:08 +0000 (10:12 +0100)]
initrd.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 06:45:17 +0000 (07:45 +0100)]
mouse.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 06:43:48 +0000 (07:43 +0100)]
mouse.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 11 Sep 2016 06:41:35 +0000 (07:41 +0100)]
lp.4: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Sep 2016 09:20:25 +0000 (10:20 +0100)]
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>
Michael Kerrisk [Sat, 10 Sep 2016 09:14:10 +0000 (10:14 +0100)]
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>
Michael Kerrisk [Sat, 10 Sep 2016 09:08:57 +0000 (10:08 +0100)]
proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Sep 2016 09:07:36 +0000 (10:07 +0100)]
proc.5: Document /proc/PID/status 'RssAnon', 'RssFile', and 'RssShmem' fields
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Sep 2016 09:07:04 +0000 (10:07 +0100)]
proc.5: Document /proc/PID/status 'HugetlbPages' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Sep 2016 08:54:00 +0000 (09:54 +0100)]
proc.5: Update example VM values in /proc/PID/status
In preparation for following patches.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Sep 2016 03:23:38 +0000 (15:23 +1200)]
clone.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
HuKeping [Mon, 5 Sep 2016 06:54:59 +0000 (14:54 +0800)]
rtnetlink.3: tfix
Signed-off-by: Hu Keping <hukeping@huawei.com>
Michael Kerrisk [Sun, 4 Sep 2016 04:52:08 +0000 (16:52 +1200)]
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>
Michael Kerrisk [Sat, 6 Aug 2016 21:50:20 +0000 (07:50 +1000)]
readv.2: Document the pwritev2() RWF_SYNC and RWF_DSYNC flags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 4 Sep 2016 04:44:47 +0000 (16:44 +1200)]
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>
Michael Kerrisk [Sat, 3 Sep 2016 16:10:09 +0000 (04:10 +1200)]
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>
Michael Kerrisk [Sat, 3 Sep 2016 15:53:28 +0000 (03:53 +1200)]
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>
Michael Kerrisk [Tue, 30 Aug 2016 19:18:09 +0000 (07:18 +1200)]
mlock.2: Minor tweaks to Sebastian Andrzej Siewior's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Sebastian Andrzej Siewior [Tue, 30 Aug 2016 08:59:11 +0000 (10:59 +0200)]
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>
Michael Kerrisk [Mon, 29 Aug 2016 21:22:46 +0000 (09:22 +1200)]
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>
Michael Kerrisk [Mon, 29 Aug 2016 21:22:27 +0000 (09:22 +1200)]
strverscmp.3: Add an example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>