Commit Graph

4428 Commits

Author SHA1 Message Date
Michael Kerrisk e15dc33869 getrlimit.2: Since Linux 3.5, the accounting formula for RLIMIT_MSGQUEUE has changed
Reported-by: Doug Ledford <dledford@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-01 11:56:47 +02:00
Michael Kerrisk 1aa06521e9 pread.2: tfix
Reported-by: Lanchon <lanchon@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-01 11:56:47 +02:00
Michael Kerrisk 4e1a4d72f0 open.2: Fix number and formula in description of EOVERFLOW error
Reported-by: Shriramana Sharma <samjnaa@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-26 07:30:02 +02:00
Michael Kerrisk 1d94912fb7 syscalls.2: Add 3 new system calls added in Linux 3.17
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-25 12:25:05 +02:00
Carlos O'Donell 3252fa3f03 wait.2: ffix: add paragraph break before errno note in RETURN VALUE section
The text "Each of these calls sets errno to an appropriate
value in the case of an error." is not only for waitid.

This patch adds a paragraph break to move the errno note
to a new paragraph where it makes sense, as it applies to
all the wait* functions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-25 12:19:37 +02:00
Davidlohr Bueso 9a413675b1 shmget.2: Note some details on defaults for SHMALL and SHMMAX
Based on a very heavily edited patch from Davidlohr Bueso.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-23 07:18:25 +02:00
Michael Kerrisk 562ac2f24e shmget.2: srcfix: Note commits for 3.16 SHMALL + SHMMAX changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-23 06:52:19 +02:00
Michael Kerrisk f037b098c2 shmget.2: Tweak kernel version numbers for SHMALL and SHMMAX changes
It's quite probably that these changes will go infot 3.16,
rather than 3.17

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-23 06:46:46 +02:00
Michael Kerrisk d4bf702fac shmget.2: Rework the SHMALL description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-23 06:46:46 +02:00
Michael Kerrisk 1fabbf12f6 shmget.2: Minor tweaks to Manfred's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-23 06:39:49 +02:00
Manfred Spraul e5cceccf91 shmget.2: Update for increase of SHMALL and SHMMAX
The default values of SHMALL and SHMMAX have been increased.

Signed-off-by: Manfred Spraul <manfred@colorfullife.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-23 06:39:49 +02:00
Michael Kerrisk 1a212a018f execve.2: Remove unneeded ".sh" extension in interpreter script example
See https://bugzilla.kernel.org/show_bug.cgi?id=84701

As noted by C. Alex North-Keys:

1) Command name extensions considered harmful: Adding ".sh", or
any other unneeded extension, unnecessarily duplicates meta
information already present in the interpreter directive,
exposing an implementation detail that then ends up explicitly
part of other programs running this one.  Later, when such a
script is replaced with a new version in Python, C, etc., the
useless ".sh" has to be retained to avoid breaking those other
programs' calls to this one, and now has a stark antifunction
of lying about the script's content and occasionally causing
admins to run undefined experiments as root (like
"bash -x ./reallyperlscript.sh"). Such extensions, while fine
in DOS which ignores extensions explicitly, is a serious flaw
in Unix-targeted script writing.  Canonical documentation
from the Linux manual should not support such a flawed idiom -
recommending against it would be preferred.

A more extensive rant against them can be found at:
http://www.talisman.org/~erlkonig/documents/commandname-extensions-considered-harmful

2) The space after "#!" in the interpreter directive is minor -
and the kernel's fs/binfmt_script.c specifically allows for it -
but versions of unix have length limits from ~30 characters to
Linux's 127 or so (if that number's correct) so the space does
have a cost.  Most scripts I've seen lack that space, and
there's no real reason to encourage it.

Reported-by: C. Alex North-Keys <erlkonig@talisman.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-23 06:21:51 +02:00
Michael Kerrisk 2333bf67ab readlink.2: SEE ALSO: add realpath(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-21 19:51:48 +02:00
Michael Kerrisk ac30de076a sched_setattr.2, sched_setscheduler.2: SEE ALSO: add chrt(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-21 19:51:48 +02:00
Michael Kerrisk f5d401ddda Removed trailing white space at end of lines 2014-09-21 11:24:24 +02:00
Michael Kerrisk daf084cc33 clone.2, flock.2, getpid.2, getunwind.2, mount.2, reboot.2, semop.2, seteuid.2, setgid.2, setns.2, setresuid.2, setreuid.2, setuid.2, uname.2, unshare.2, clock.3, drand48.3, proc.5, capabilities.7, credentials.7, mq_overview.7, namespaces.7, pid_namespaces.7, svipc.7, user_namespaces.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-21 11:23:07 +02:00
Michael Kerrisk 9219d20802 clone.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-16 10:05:11 +02:00
David Prévot b7a3dc84e7 fcntl.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-15 11:10:26 +02:00
Michael Kerrisk 53d084e81a setns.2: Add pointer to user_namespaces(7)
Add pointer to user_namespaces(7) for details on interactions
of user and mount namespaces

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-15 10:59:30 +02:00
Michael Kerrisk d0c5d17b30 setns.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-15 10:56:31 +02:00
Michael Kerrisk 9f4bb2a6c2 setns.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-15 10:53:18 +02:00
Michael Kerrisk 6edfe90905 setns.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-15 10:52:17 +02:00
Michael Kerrisk 130fbed6c8 unshare.2: Note flags implied by CLONE_THREAD and CLONE_VM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-14 21:29:47 -07:00
Eric W. Biederman 69b6b231d7 mount.2: Clarify use of 'mountflags' and 'data' for MS_REMOUNT
Quoting Eric Biederman:

One thing that has come up recently (in 3 separate
implementations) is that mount(MS_REMOUNT|...,...) must include
all of the mount flags that need to be preserved.   People
creating read-only bind mounts tend to miss that and the locked
flags in mount namespaces.  That issue was flushed out now that
the kernel is now not allowing most mount flags to be cleared in
mount namespaces.  The interface is non-intuitive and we should
at least document the weirdness.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-14 21:29:47 -07:00
Michael Kerrisk e63259f20e setns.2: ERRORS: Add EINVAL for two cases of joining a new user namespace
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:03 -07:00
Michael Kerrisk 6bab36f87c unshare.2: Add kernel version number for text on CLONE_NEWUSER implying CLONE_FS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:03 -07:00
Michael Kerrisk ac0079383d clone.2: Document EPERM error when using CLONE_NEWUSER from chrooted caller
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:03 -07:00
Michael Kerrisk 40a47a161b unshare.2: Document EPERM error when using CLONE_NEWUSER from chrooted caller
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:03 -07:00
Michael Kerrisk cdd25f2e76 unshare.2: Document EUSERS error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:03 -07:00
Michael Kerrisk 6fd119e727 clone.2: Document EUSERS error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:03 -07:00
Michael Kerrisk 8db3776096 setns.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:03 -07:00
Michael Kerrisk ab3311aa06 clone.2, namespaces.7, pid_namespaces.7, user_namespaces.7: wfix "file system" ==> "filesystem"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 85e34225be setns.2: A process can't join a new userns if it shares CLONE_FS attributes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 08e54e516c unshare.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 6f6808f9fd unshare.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 4c3d7431b4 unshare.2: CLONE_NEWUSER implies CLONE_FS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk f647dc5e28 unshare.2: Remove obsolete reference to "Restrictions" text in user_namespaces(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 5e72cf7d10 clone.2: Improve discussion of flags that can't be specified with CLONE_NEWUSER
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 9d64e39ec8 semop.2: Refer to clone(2) for semantics of CLONE_SYSVSEM and semadj lists
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 5ada4b9491 clone.2: Add more detail on the meaning of CLONE_SYVSEM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 0d829b7610 unshare.2: Clarify semantics of CLONE_SYSVSEM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk ea2d20ebcc unshare.2: CLONE_SYSVSEM does not require CAP_SYS_ADMIN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 3c881e7c07 unshare.2: CLONE_NEWPID automatically implies CLONE_THREAD
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 88f487166c unshare.2: CLONE_NEWUSER implies CLONE_THREAD
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 5afd65d175 unshare.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk f231195fce unshare.2: srcfix: update FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk d34e564554 clone.2: Note restrictions on CLONE_NEWUSER with other CLONE_* flags
Refer to user_namespaces(7) for restrictions on CLONE_NEWUSER
with other CLONE_* flags.

Also: document EINVAL error for CLONE_NEWUSER|CLONE_FS.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 333446b9a6 unshare.2: Note restrictions on CLONE_NEWUSER with other CLONE_* flags
Refer to user_namespaces(7) for restrictions on CLONE_NEWUSER
with other CLONE_* flags.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 29368ba01f reboot.2: Tweak text on reboot in PID namesapces
Reviewed-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmai>
2014-09-13 20:16:02 -07:00
Michael Kerrisk 50f31881ac reboot.2: Document effect of reboot() inside PID namespaces
Reported-by: Justin Cormack <justin@street-vision.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:16:02 -07:00