Commit Graph

468 Commits

Author SHA1 Message Date
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
Michael Kerrisk 149eeb7b5e proc.5: Rework Eric's text on uid_map and gid_map
Consolidate the similar uid_map and gidmap text into one
piece.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 7e07d9504e proc.5: wfix: s/since kernel/since Linux/ 2014-09-13 20:15:55 -07:00
Eric W. Biederman f6e171212e proc.5: Document /proc/[pid]/uid_map and /proc/[pid]/gid_map
Document the user namespace files that report the mapping of UIDs
and GIDs between user namespaces.

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 f082ada466 proc.5: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk bea08fec7e adjtimex.2, bind.2, cacheflush.2, clone.2, fallocate.2, fanotify_init.2, fanotify_mark.2, flock.2, futex.2, getdents.2, getpriority.2, getrlimit.2, gettid.2, gettimeofday.2, ioprio_set.2, kexec_load.2, migrate_pages.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, msgop.2, nfsservctl.2, perf_event_open.2, pread.2, ptrace.2, recvmmsg.2, rename.2, restart_syscall.2, sched_setattr.2, send.2, shmop.2, shutdown.2, sigaction.2, signalfd.2, syscalls.2, timer_create.2, timerfd_create.2, tkill.2, vmsplice.2, wait.2, aio_init.3, confstr.3, exit.3, fmemopen.3, fopen.3, getaddrinfo.3, getauxval.3, getspnam.3, isalpha.3, isatty.3, mallinfo.3, malloc.3, mallopt.3, psignal.3, pthread_attr_setinheritsched.3, qecvt.3, queue.3, rtnetlink.3, strerror.3, strftime.3, toupper.3, towlower.3, towupper.3, initrd.4, locale.5, proc.5, bootparam.7, capabilities.7, ddp.7, fanotify.7, icmp.7, inotify.7, ip.7, ipv6.7, netdevice.7, netlink.7, path_resolution.7, rtld-audit.7, rtnetlink.7, sched.7, signal.7, socket.7, svipc.7, tcp.7, unix.7, ld.so.8: srcfix: Update FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-21 16:47:44 -05:00
Michael Kerrisk ef4f4031ca Removed trailing white space at end of lines 2014-08-19 12:01:21 -05:00