Commit Graph

474 Commits

Author SHA1 Message Date
Michael Kerrisk c3b494c295 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 08:32:12 +01:00
Michael Kerrisk 2702dc2175 proc.5: (Briefly) document /proc/PID/attr/socketcreate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:28 +01:00
Michael Kerrisk 666db07e1a proc.5: (Briefly) document /proc/PID/attr/keycreate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:28 +01:00
Michael Kerrisk b7a425679b proc.5: Document /proc/PID/attr/{current,exec,fscreate,prev}
Heavily based on Stephen Smalley's text in
    https://lwn.net/Articles/28222/
    From:    Stephen Smalley <sds@epoch.ncsc.mil>
    To:      LKML and others
    Subject: [RFC][PATCH] Process Attribute API for Security Modules
    Date:    08 Apr 2003 16:17:52 -0400

Cowritten-by: Stephen Smalley <sds@tycho.nsa.gov>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:28 +01:00
Michael Kerrisk c261b0e5a5 proc.5: Document /proc/sys/kernel/auto_msgmni
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:28 +01:00
Michael Kerrisk f2aa4dcc8e proc.5: Note that CAP_SYS_ADMIN is required to list /proc/PID/map_files
This might however change in the future; see the Jan 2015 LKML thread:

        Re: [RFC][PATCH v2] procfs: Always expose /proc/<pid>/map_files/
                            and make it readable

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:27 +01:00
Michael Kerrisk e81e6a4721 proc.5: Add reference to prctl(2) in discussion of /proc/sys/fs/suid_dumpable
And note that /proc/sys/fs/suid_dumpable defines the
value assigned to the process "dumpable" flag in certain
circumstances.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:27 +01:00
Michael Kerrisk f33774c483 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-28 10:33:22 +01:00
Michael Kerrisk 8392a3b33f _exit.2, dup.2, execve.2, execveat.2, fallocate.2, fcntl.2, get_robust_list.2, getrlimit.2, mbind.2, memfd_create.2, mmap.2, open.2, ptrace.2, readv.2, select.2, sigaction.2, syscall.2, syscalls.2, truncate.2, utimensat.2, write.2, errno.3, exec.3, fclose.3, fexecve.3, fmemopen.3, fopencookie.3, getgrent_r.3, getline.3, getmntent.3, getpw.3, getpwent_r.3, getspnam.3, malloc_info.3, posix_fallocate.3, putgrent.3, shm_open.3, locale.5, proc.5: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-22 23:29:25 +01:00
Elie De Brauwer 73ba31a9ca proc.5: tfix
Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-22 21:55:26 +01:00
Elie De Brauwer 4f747ba0b2 proc.5: Document /proc/sys/vm/compact_memory
Since 2.6.36 [1] CONFIG_COMPACTION is supported in Linux (for a
detailed explanation see [2]). But in essence the contents of
/proc/buddyinfo shows how much contiguous areas of a certain
size are available. These numbers are not actually up to date
as the Linux kernel will implicitly trigger compaction
(+- defragmentation) when an allocation is done.  This makes it
difficult since you can't predict upfront whether or not a large
allocation will succeed or not.  By using
/proc/sys/vm/compact_memory you can explicitly trigger compaction
to occur and /proc/buddyinfo will give a more realistic view on
the available memory in contiguous areas.

This patch updates proc.5 to explain the usage of this file and is
inspired by Documentation/systcl/vm.txt [3]

[1] http://kernelnewbies.org/Linux_2_6_35#head-9cb0a1275559d40296da42efb7977896ac9edab7
[2] http://lwn.net/Articles/368869/
[3] http://lxr.free-electrons.com/source/Documentation/sysctl/vm.txt#L100

Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-22 21:54:02 +01:00
Michael Kerrisk 4e1438e3cb proc.5: Remove bogus statement about NR_OPEN being a ceiling for file-max
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-13 11:26:44 +01:00
Michael Kerrisk c290e5637b proc.5: Document /proc/sys/fs/nr_open
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-13 11:15:05 +01:00
Michael Kerrisk 1fb61947c2 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-10 09:38:10 +01:00
Michael Kerrisk 039b6546fd proc.5: Document "Seccomp" field of /proc/PID/status
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-10 09:38:10 +01:00
Michael Kerrisk 0649afd45a localedef.1, adjtimex.2, clock_nanosleep.2, epoll_ctl.2, ioctl.2, madvise.2, open.2, posix_fadvise.2, prctl.2, restart_syscall.2, sched_setaffinity.2, select.2, semop.2, setsid.2, sgetmask.2, sigaction.2, sigreturn.2, splice.2, syscall.2, syscalls.2, tee.2, tkill.2, abort.3, cmsg.3, exp10.3, ftw.3, getopt.3, ilogb.3, memcmp.3, mq_open.3, pow.3, pthread_setschedparam.3, sigvec.3, sysconf.3, termios.3, tgamma.3, wordexp.3, locale.5, proc.5, resolv.conf.5, cp1251.7, credentials.7, fanotify.7, inotify.7, locale.7, man-pages.7, signal.7, unix.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-31 07:01:38 +01:00
Sven Hoexter ac4b0eb36e proc.5: Cosmetic changes for VmSwap to keep the layout consistent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-30 21:29:11 +01:00
Michael Kerrisk 4158771432 proc.5: Revise description of /proc/PID/status 'VmSwap' entry
Reported-by: Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-26 07:35:25 +01:00
Michael Kerrisk 1ddc16655d proc.5: Note kernel version that added "VmSwap" to /proc/PID/status
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-26 07:35:25 +01:00
Sven Hoexter 49f6dda794 proc.5: Add "VmSwap" to /proc/[pid]/status
Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.

Signed-off-by: Sven Hoexter <sven@stormbind.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-26 07:35:25 +01:00
Michael Kerrisk c7383f92d4 proc.5: srcfix: Note commit that introduced /proc/thread-self
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 20:29:43 +01:00
Bernhard Walle 0ad6ad9c0c proc.5: Document /proc/thread-self
/proc/thread-self has been introduced in Linux 3.17 with
commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.

Signed-off-by: Bernhard Walle <bernhard@bwalle.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 20:25:39 +01:00
Michael Kerrisk ee56674428 proc.5: tfix
Reported-by: Huxiaoxiang <huxiaoxiang@huawei.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-08 13:24:10 +01:00
Florian Westphal ed8de0e44e proc.5: Document /proc/net/netfilter/nfnetlink_queue
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 14:55:29 +01:00
Michael Kerrisk e890609356 capget.2, ptrace.2, vhangup.2, wait.2, ttyslot.3, console.4, proc.5, utmp.5, boot.7: tfix: page xrefs for init 2014-10-03 08:47:03 +02:00
Michael Kerrisk 859503c33e proc.5: Mention pmap(1) in discussion of /proc/PID/smaps
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-02 23:10:41 +02:00
Michael Kerrisk b96ddae00e proc.5: Minor tweaks to Elie De Brauwer's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-01 11:56:47 +02:00
Elie De Brauwer eb7097c2c4 proc.5: Document /proc/buddyinfo
This patch adds a short description about the contents of
/proc/buddyinfo and how this file can be used to assist
in checking for memory fragmentation issues.

Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-01 11:56:47 +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 4effb5bec3 getpid.2, mount.2, uname.2, proc.5, credentials.7, mq_overview.7, svipc.7: SEE ALSO: add namespaces(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk b81acb1504 proc.5, namespaces.7: Move /proc/[pid]/{gid_map,uid_map} text from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk cf8bfe6d2a proc.5, namespaces.7: Move /proc/[pid]/mountstat text from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 4716a1dd65 proc.5, namespaces.7: Move /proc/[pid]/mountstats from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 357002ecdf proc.5, namespaces.7: Move /proc/[pid]/mounts from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 0bafc69241 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk fbb59ce750 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk 84d22d07fc proc.5: Document change of /proc/PID/ns/* files to symlinks in Linux 3.8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk d41f83cce4 proc.5: Add detail on /proc/PID/ns bind mounted files
Opening a file bind mounted to a /proc/PID/ns/xxx file
also yields a descriptor that can be passed to setns().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 91935e7807 proc.5: Rework discussion of /proc/PIC/ns/* files
Rather than repeat the same text six times,
refactor it to occur in just one place.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk f34f018219 proc.5: srcfix: Added FIXME (/proc/PID/projid_map)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 6b1eaf53bc proc.5: Further improvements to /proc/PID/{uid_map,gid_map} text
After review by Eric Biederman.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk a2f479dee9 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 98ea417334 proc.5: Clarify details of nonoverlapping ranges for /proc/PID/{uid_map,gid_map}
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 3d33f6ceb7 proc.5: Note capability requirements for writing to /proc/PID/{uid_map,gid_map}
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk d0ebf39885 proc.5: Rework text describing line limit in /proc/PID/{uid_map,gid_map}
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 23be33af33 proc.5: Clarify mapping provided by uid_map and gid_map
Add a sentence to emphasize that these files provide a mapping
based on the user namespace of the file opener.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Eric W. Biederman ec1dd85da2 proc.5: Document /proc/PID/ns/{user,pid,mnt}
Signed-off-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk ccdc8958ae proc.5: Correct kernel version number for /proc/PID/{uid_map,gid_map}
These files were introduced in 3.5, not 3.6.

Reported-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 8b69f9c729 proc.5: Describe format for lines in /proc/PID/uid_map file 2014-09-13 20:15:55 -07:00