Replace various uses of "subsystem" with "controller". The
former too was originally used in describing cgroups, but it
is vague to the point of ambiguity. The latter term is a
little less ambiguous.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Users-space programmers generally consider things in terms of
"processes" and threads". Update the text to remove most uses
of the term "tasks".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
ADJ_SETOFFSET mode was added in 2.6.39:
$ git tag --contains 094aa1881fdc1b8889b442eb3511b31f3ec2b762 | head -n 1
v2.6.39
ADJ_MICRO and ADJ_NANO modes were added in 2.6.26:
$ git tag --contains eea83d896e318bda54be2d2770d2c5d6668d11db | head -n 1
v2.6.26
Signed-off-by: Nikola Forró <nforro@redhat.com>
People sometimes assume that the crash handler runs in the same context
as the crashing process. They would be incorrect :).
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Add a shell example showing that /proc/[pid]/root is more
than a symlink. Based on an example provided by Mike Frysinger
in an earlier commit message.
Cowritten-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
If the target process is in a different mount namespace, the root
symlink actually shows that view of the filesystem. As an example:
/* Terminal 1 */
$ unshare -Urnm
# mount -t tmpfs tmpfs /etc
# mount --bind /bin /dev
# echo $$
17168
/* Terminal 2 */
# ls /etc # Normal view of /etc files.
# ls /proc/17168/root/etc # Empty view of the tmpfs.
# ls /dev # Normal view of /dev files.
# ls /proc/17168/root/dev # Contents of /bin files.
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
As noted in the Debian bug:
In "man wcstombs" the words
The function wcsrtombs(3) provides a thread safe interface to
the same functionality.
should be changed to
The function wcsrtombs(3) provides a better interface to
the same functionality.
Because
1) wcsrtombs is not thread safe if "ps" is NULL (see "ATTRIBUTES"
in "man wcsrtombs")
2) wcstombs *is* thread safe (see "ATTRIBUTES" in "man wcstombs")
3) "man mbstowcs" says "The function mbsrtowcs(3) provides a
better interface to the same functionality." in the same
NOTES section.
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360
Reported-by: Igor Liferenko <igor.liferenko@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Hello.
I've drafted some updates to the keyctl.2 man page while preparing test
for strace syscall decoder. It is focused mostly on description of argument
format used in various commands and return values/error codes.
Information is based on Documentation/security/keys.txt,
include/uapi/linux/keyctl.h, and source code and comments in
security/keys/ (mostly comments from security/keys/keyctl.c).
Hope you find it useful.
These types changed from 'void *' to 'int *' back in Linux 3.8.
The new types are closer to reality, so just update the page
without discussing the history.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
The prototype for the system call was added in kernel commit
81f10dad, but looking at the kernel's fork.c, I believe the
relevant definition is
SYSCALL_DEFINE5(clone, unsigned long, clone_flags,
unsigned long, newsp,
int __user *, parent_tidptr,
int __user *, child_tidptr,
unsigned long, tls)
so the last argument is the tls argument, not a pt_regs argument.
I stumbled upon this while trying to understand CLONE_SETTLS, so
I expanded that description a little to cover other architectures.
Reviewed-by: Josh Triplett <josh@joshtriplett.org>
Michael Kerrisk