Commit Graph

623 Commits

Author SHA1 Message Date
Michael Kerrisk eb775c04e7 proc.5: Describe Shmem field of /proc/meinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-07 16:21:37 +01:00
Michael Kerrisk 63e56c4b77 proc.5: Add /proc/sys/fs/pipe-user-pages-{hard,soft} entries
The entries defer to pipe(7).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-06 13:14:07 -07:00
Michael Kerrisk 33dc4b59be proc.5, pipe.7: Move /proc/sys/fs/pipe-max-size content from proc(5) to pipe(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-06 13:14:07 -07:00
Michael Kerrisk 43d42cc0a0 proc.5: srcfix: FIXME tidy-up
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-29 13:43:30 +02:00
Michael Kerrisk 2f05728103 proc.5: Add example ProtectionKey output for 'smaps' file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-17 14:04:06 +02:00
Dave Hansen be729d667d proc.5: Describe new ProtectionKey 'smaps' field
Signed-off-by: Dave Hansen <dave.hansen@linux.intel.com>
2016-10-17 14:03:28 +02:00
Michael Kerrisk c3d59262f3 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-13 12:57:06 +02:00
Michael Kerrisk 6861f8f0c7 proc.5: Improve description of the KernelPageSize and MMUPageSize 'smaps' fields
Rework the text, make it clearer that MMUPageSize is a separate
line, add kernel version numbers, and example output.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-13 12:57:00 +02:00
Michael Kerrisk eb8487082c proc.5: Rework 'smaps' VmFlags text, and add kernel version and example output
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-13 11:32:13 +02:00
Michael Kerrisk 9b780b0654 proc.5: Rework 'smaps' ProtectionKey text and add some details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-13 11:32:08 +02:00
Mike Frysinger 89f929055e proc(5): ffix 2016-10-07 22:49:38 +02:00
Michael Kerrisk 4c58028a28 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 14:30:54 +02:00
Michael Kerrisk 15869389bf proc.5: Document /proc/PID/seccomp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
Michael Kerrisk 3ed7270ea2 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
Michael Kerrisk a77efd582f proc.5: Expand discussion of /proc/[pid]/root
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>
2016-10-07 11:17:01 +02:00
Michael Kerrisk 948f0ff4fe proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
Mike Frysinger 2b3122418d proc(5): Clarify the root symlink and mount namespaces
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>
2016-10-07 11:17:01 +02:00
Michael Kerrisk f1a5d77ac3 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 12:46:09 +02:00
Michael Kerrisk 5681553cb8 proc.5: Note that 'suid_dumpable' mode 1 is insecure
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk c3c64ee6e3 proc.5: Add reference to core(5) in discussion of 'suid_dumpable'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk 8a71b4bb86 proc.5: Refer to ptrace(2) for info on effect of suid_dumpable on ptraceability
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk 3bdb8ec5e8 proc.5: Explain rules determining ownership of /proc/PID/* files
Describe the effect of the "dumpable" attribute on ownership
of /proc/PID files.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk 1e6a8e2f4f proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk 748f7283bf proc.5: Note effect of 'suid_dumpable' on ownership of /proc/PID files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk 6f858d5ccc lirc.4, proc.5, netlink.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-16 12:42:20 +02:00
Michael Kerrisk 956e74b43f proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-16 12:40:55 +02:00
Michael Kerrisk 78230722aa proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-16 12:38:57 +02:00
Michael Kerrisk a5a3e91bf9 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 20:41:08 +01:00
Michael Kerrisk 0989246ebd proc.5: Minor tweaks to Namhyung Kim's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 20:40:39 +01:00
Namhyung Kim dfdf642ebb 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>
2016-09-12 20:38:44 +01:00
Michael Kerrisk 58afe6afe1 proc.5: Clarify user namespace requirements for /proc/sys/fs/protected_hardlinks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 20:34:22 +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
Jakub Wilk ae34c5215d proc.5: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
2016-08-08 05:54:16 +10:00
Michael Kerrisk ecc9535d8e proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:16 +10:00
Michael Kerrisk 4ad958e183 proc.5: Document /proc/meminfo '+ShmemHugePages' and 'ShmemPmdMapped' fields
New in Linux 4.8

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:16 +10:00
Michael Kerrisk 5bb0a75e34 proc.5: Fix order of SEE ALSO entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:14 +10:00
Michael Kerrisk 7ded2db482 proc.5: Note changes to config option governing /proc/[pid]/task/[tid]/children
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-04 08:43:29 +10:00
Michael Kerrisk 45dd509268 proc.5: Minor reworking to Jann's /proc/[pid]/task/[tid]/children patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-04 08:43:08 +10:00
Jann Horn 4a40c703ee proc.5: Document /proc/[pid]/task/[tid]/children
Document the /proc/[pid]/task/[tid]/children interface from
CRIU, and more importantly, document why it's usually not
a good interface.
2016-08-04 08:34:23 +10:00
Michael Kerrisk 5347399609 proc.5: Add reference to umask(2) in discussion of /proc/PID/status 'Umask'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-07-18 17:11:55 +02:00
Michael Kerrisk 3df541c0e6 ldd.1, localedef.1, add_key.2, chroot.2, clone.2, fork.2, futex.2, get_mempolicy.2, get_robust_list.2, getitimer.2, getpriority.2, ioctl.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kcmp.2, kill.2, lookup_dcookie.2, mmap.2, mount.2, open.2, pciconfig_read.2, perf_event_open.2, prctl.2, process_vm_readv.2, ptrace.2, quotactl.2, recv.2, setfsgid.2, setfsuid.2, sysinfo.2, umask.2, umount.2, unshare.2, utimensat.2, wait.2, assert.3, fmax.3, fmin.3, getauxval.3, inet_pton.3, malloc_hook.3, memmem.3, mkdtemp.3, mktemp.3, printf.3, strcasecmp.3, strcat.3, strtoul.3, strxfrm.3, console_codes.4, console_ioctl.4, lirc.4, tty.4, vcs.4, charmap.5, elf.5, locale.5, proc.5, repertoiremap.5, utmp.5, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, credentials.7, feature_test_macros.7, iso_8859-1.7, iso_8859-15.7, iso_8859-5.7, koi8-r.7, koi8-u.7, man-pages.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, unix.7, user_namespaces.7, utf-8.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-07-17 18:10:19 +02:00
Michael Kerrisk 9fb88bc878 proc.5: Note that /proc/net is now virtualized per network namespace
Reported-by: "Yuming Ma(马玉明)" <mayuming@le.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-07-07 11:12:30 +02:00
Michael Kerrisk ccb4bcdc13 proc.5: Minor rewording of intro sentence on /proc/net
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-07-07 11:12:26 +02:00
Michael Kerrisk 966b583993 proc.5: Move shared subtree /proc/PID/mountinfo fields to mount_namespaces(7)
Move information on shared subtree fields in /proc/PID/mountinfo
to mount_namespaces(7).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-30 06:08:31 +02:00
Michael Kerrisk 211f4a1468 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-06-30 06:08:31 +02:00