Commit Graph

1444 Commits

Author SHA1 Message Date
Michael Kerrisk 9d9f49e38a nologin.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:58:57 +01:00
Michael Kerrisk e810de90a6 motd.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:58:42 +01:00
Michael Kerrisk 6998e202c0 issue.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:58:25 +01:00
Michael Kerrisk 275723f9d9 group.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:58:04 +01:00
Michael Kerrisk 5d9b8ae9b9 sysfs.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-12-10 23:19:17 +01:00
Michael Kerrisk 1c6f59c276 getpid.2, pipe.2, abort.3, daemon.3, pthread_yield.3, stdio.3, sysconf.3, tty.4, shells.5, sysfs.5, fifo.7, hier.7, icmp.7, path_resolution.7, pid_namespaces.7, standards.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-26 12:38:46 +01:00
Jakub Wilk 1dbe854bc5 proc.5: tfix
Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-22 17:40:58 +01:00
Michael Kerrisk 979a439b41 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 14:37:12 +01:00
Michael Kerrisk 2927055043 proc.5: Rework the description of /proc/PID/mountinfo parent-ID field
After comments from Miklos, and further digging in the kernel
source that showed that chroot() can also result in "hidden"
parent-IDs in mountinfo, I've revised the description of
mountinfo.

In fs/proc_namespace.cs::how_mountinfo() there is:

        /* mountpoints outside of chroot jail will give SEQ_SKIP on this */
        err = seq_path_root(m, &mnt_path, &p->root, " \t\n\\");
        if (err)
                goto out;

I instrumented the 'if (err)' code path with printk()
to show that there is indeed a record corresponding to the
parent-ID for the process root that is being skipped.

Reported-by: Miklos Szeredi <mszeredi@redhat.com>
Reviewed-by: Miklos Szeredi <mszeredi@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 10:37:33 +01:00
Michael Kerrisk 35cf1b9397 proc.5: Correct the description of the parent mount ID for /proc/PID/mountinfo
I do not have an exact handle on the details, but I can see
roughly what is going on.  Internally, there seems to be one
("hidden") mount ID reserved to each mount namespace, and that ID
is the parent of the root mount point.

Looking through the (4.14) kernel source, mount IDs are allocated
by a kernel function called mnt_alloc_id() (in fs/namespace.c),
which is in turn called by alloc_vfsmnt() which is in turn called
by clone_mnt().

A new mount namespace is created by the kernel function
copy_mnt_ns() (in fs/namespace.c, called by
create_new_namespaces() in kernel/nsproxy.c). The copy_mnt_ns()
function calls copy_tree() (in fs/namespace.c), and copy_tree()
calls clone_mnt() in *two* places.  The first of these is the call
that creates the "hidden" mount ID that becomes the parent of the
root mount point. (I verified this by instrumenting the kernel
with a few printk() calls to display the IDs.)  The second place
where copy_tree() calls clone_mnt() is in a loop that replicates
each of the mount points (including the root mount point) in the
source mount namespace.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 10:13:00 +01:00
Michael Kerrisk 9b0e3937a9 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-19 20:27:37 +01:00
Marcus Folkesson 5753354a3a proc.5: Update description of /proc/<pid>/oom_score
After Linux 2.6.36, the heuristic calculation of oom_score
has changed to only consider used memory and CAP_SYS_ADMIN.

See kernel commit a63d83f427fbce97a6cea0db2e64b0eb8435cd10.

Signed-off-by: Marcus Folkesson <marcus.folkesson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-19 19:52:55 +01:00
Michael Kerrisk 52f842a571 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-15 08:22:43 +01:00
Michael Kerrisk 8fb9b45adc proc.5: Since Linux 4.9, /proc/locks is filtered according to the PID namespace
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-15 08:10:53 +01:00
Michael Kerrisk f352b560f8 proc.5: Document /proc/locks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-14 23:22:33 +01:00
Michael Kerrisk b0bd99827c proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 15:22:07 +01:00
Tyler Hicks 2577dbba2b proc.5, seccomp.2: Document the seccomp /proc interfaces added in Linux 4.14
Document the seccomp /proc interfaces in Linux 4.14:
/proc/sys/kernel/seccomp/actions_avail and
/proc/sys/kernel/seccomp/actions_logged.

Signed-off-by: Tyler Hicks <tyhicks@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 15:22:07 +01:00
Seonghun Lim 89211bfd3a acct.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:24:50 +01:00
Michael Kerrisk 39352d918f filesystems.5: Refer to VFAT as an extended FAT (not DOS) filesystem
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 23:23:09 +01:00
Michael Kerrisk 23014116a5 filesystems.5: Replace crufty URL reference for 'smb' with up-to-date URL
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 23:19:42 +01:00
Lucas Werkmeister 81c8aeb649 proc.5: Clarify permissions in /proc/[pid]/fd/
Since the symbolic links for pipes and sockets do not refer to real
files in the file system tree, it can be hard to discover that they
still have mode and ownership information (revealed e.g. by `stat -L`),
so let's point this out in the manpage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 22:25:13 +01:00
Lucas Werkmeister d6bd89f3e5 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 22:23:01 +01:00
Michael Kerrisk dc4674ac40 core.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 21:20:20 +02:00
Michael Kerrisk 8eb13afb83 proc.5: Add reference to pid_namespaces(7) for /proc/sys/kernel/ns_last_pid
Add reference to pid_namespaces(7) for the description of
/proc/sys/kernel/ns_last_pid.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 17:30:12 +02:00
G. Branden Robinson 9b13f7700e connect.2, ioprio_set.2, dbopen.3, group.5, fifo.7: tfix
Fix nonstandard usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:41:59 +02:00
Michael Kerrisk a23d8efafc capget.2, fanotify_init.2, fcntl.2, ioctl_tty.2, madvise.2, mbind.2, prctl.2, sched_setaffinity.2, hash.3, isgreater.3, posix_fallocate.3, sigvec.3, full.4, sd.4, wavelan.4, core.5, host.conf.5, epoll.7, signal.7, unix.7, user_namespaces.7: wfix (will fail --> fail/fails)
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:36:57 +02:00
Michael Kerrisk b5b0d21ef5 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:26:12 +02:00
Michael Kerrisk 9ea5bc667b clone.2, getcpu.2, shmget.2, syscall.2, dladdr.3, proc.5, vdso.7: Consistently use "x86-64", not "x86_64"
When referring to the architecture, consistently use "x86-64",
not "x86_64". Hitherto, there was a mixture of usages, with
"x86-64" predominant.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:26:12 +02:00
Michael Kerrisk 6e3b05feb5 core.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-12 21:08:37 +02:00
Michael Kerrisk 7629685cc3 core.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-12 21:08:37 +02:00
Michael Kerrisk 03c871367c core.5: Adds some notes on systemd and core dumps
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-12 21:08:37 +02:00
Michael Kerrisk 6c3d8859e6 core.5: Dumps are not produced if core_pattern is empty and core_uses_pid is 0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-11 22:00:09 +02:00
Michael Kerrisk cb1b16309e core.5: SEE ALSO: add coredumpctl(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-11 18:04:42 +02:00
Michael Kerrisk 97839a765d core.5: RLIMIT_CORE is not enforced when piping core dump to a program
Reported-by: Per Böhlin <Per.Bohlin@zenterio.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 22:25:05 +02:00
Jakub Wilk 86be2c9292 proc.5: tfix
Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 15:24:20 +02:00
Jakub Wilk e8b9e9a236 sysfs.5: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-05 20:37:09 +02:00
Michael Kerrisk d8a21977bf sysfs.5: Add brief description of /sys/kernel/debug/tracing
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
Michael Kerrisk bbd6443407 shells.5: SEE ALSO: add pam_shells(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 13:55:53 +02:00
Michael Kerrisk a971f65268 core.5: SEE ALO: add systemd-coredump(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 13:51:12 +02:00
Michael Kerrisk 0e462d71de proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Oliver Ebert 55d68a947b proc.5: Document /proc/kpagecgroup
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Michael Kerrisk abfbcb56d8 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Oliver Ebert 2e84528d50 proc.5: Add mmap-exclusive bit for /proc/[pid]/pagemap
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Michael Kerrisk c6f182bc5e proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Michael Kerrisk 5487da4c66 proc.5: Fix kernel version for KPF_BALLOON (amendment to Oliver Ebert's patch)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:17 +02:00
Oliver Ebert f38dfdf16a proc.5: Add KPF_BALLOON, KPF_ZERO_PAGE, and KPF_IDLE for /proc/kpageflags
See Linux commit 56873f43abdcd574b25105867a990f067747b2f4
and Linux commit f074a8f49eb87cde95ac9d040ad5e7ea4f029738

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:12 +02:00
Oliver Ebert d0ffc687c4 proc.5: tfix
See Linux commit 63f8e8d2a575ef62e5b705516b491a98a60517ff.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 08:17:56 +02:00
Michael Kerrisk 85f0310cb8 sysfs.5: Add a brief description of /sys/class/net
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 10:09:30 +02:00
Michael Kerrisk db419c969a sysfs.5: Add a description of /sys/kernel/mm/hugepages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk cf4a2cfb02 sysfs.5: Add a brief description of /sys/kernel/mm
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00