Commit Graph

511 Commits

Author SHA1 Message Date
Michael Kerrisk 73b9cbe1ca proc.5: Improve description of /proc/PID/status
Reported-by: Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 18:35:54 +02:00
Michael Kerrisk fee59977e0 proc.5: Document /proc mount options
Document the 'hidepid' and 'gid' mount options that were added in
Linux 3.3.  See https://bugzilla.kernel.org/show_bug.cgi?id=90641
Based on text by Vasiliy Kulikov in
Documentation/filesystems/proc.txt.

Reported-by: Cameron Norman <camerontnorman@gmail.com>
Cowritten-by: Vasiliy Kulikov <segooon@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 18:00:26 +02:00
Guillem Jover 7e3c767ad6 proc.5: Document /proc/PID/exe behaviour on unlinked pathnames
Signed-off-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 11:11:39 +02:00
Michael Kerrisk 06dd061c07 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 11:10:22 +02:00
Michael Kerrisk 64fcb6e1ce proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-30 22:04:33 +02:00
Michael Kerrisk e28af9cd1c proc.5: Document /proc/PID/status VmPMD
Reported-by: Weijie Yang <weijie.yang@samsung.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-30 11:16:16 +02:00
Michael Kerrisk 1dea597b7a proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 12:04:26 +02:00
Michael Kerrisk f2d607ee95 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 12:04:26 +02:00
Michael Kerrisk ed948c28b3 chown.2, execve.2, prctl.2, truncate.2, proc.5, capabilities.7, ld.so.8: Tighter wording: 'mode bit' rather than 'permission bit'
For sticky, set-UID, and set-GID mode bits (as used in POSIX).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:36:59 +02:00
Michael Kerrisk fce2114916 proc.5: Enhance discussion of /proc/PID/status 'VmSwap' field
Based on https://lwn.net/Articles/634978/

Cowritten-by: Vlastimil Babka <vbabka@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:51:49 +02:00
Michael Kerrisk 5fec7fe59a proc.5: Document /proc/sys/kernel/randomize_va_space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:51:49 +02:00
Michael Kerrisk 58d375dd8a proc.5: Document /proc/PID/fdinfo epoll format
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 6e7622ee53 proc.5: Describe /proc/PID/fdinfo eventfd format
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk f8a14cac3c proc.5: Document /proc/PID/fdinfo signalfd format
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 0275956d88 proc.5: Describe "mnt_id" field of /proc/PID/fdinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk a405066e3d proc.5: Update description /proc/sys/unix 'Type' field
The existing text was very crufty. UNIX domain sockets
support more than SOCK_STREAM for a _very_ long time now.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 8f8a46fbcb proc.5: Note that abstract sockets are included in /proc/net/unix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 756f55f601 proc.5: Reformat /proc/net/unix information as a list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk dbe6f88bf8 proc.5: Add some detail to /proc/PID/timers
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 7f1ea8fbde proc.5: /proc/PID/timers fix
Minor fix to description.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 93691c1ef8 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 5734da6d61 proc.5: Note that /proc/PID/timers requires CONFIG_CHECKPOINT_RESTORE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 1e64c86bbf intro.1, ldd.1, clone.2, getgroups.2, getpid.2, getsockopt.2, ioctl_list.2, msgop.2, open.2, seccomp.2, setgid.2, setresuid.2, setreuid.2, setuid.2, sigaction.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, syscall.2, syscalls.2, umount.2, clock.3, dlopen.3, fmemopen.3, fpathconf.3, fputwc.3, fputws.3, fseek.3, fseeko.3, gcvt.3, getline.3, getwchar.3, hypot.3, if_nameindex.3, initgroups.3, popen.3, resolver.3, strcoll.3, strdup.3, tzset.3, ulimit.3, wcstombs.3, wctob.3, xdr.3, console_codes.4, random.4, filesystems.5, host.conf.5, hosts.5, proc.5, resolv.conf.5, securetty.5, credentials.7, feature_test_macros.7, hier.7, ipv6.7, packet.7, pthreads.7, raw.7, signal.7, tcp.7, user_namespaces.7, ld.so.8, ldconfig.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-29 22:30:09 +02:00
Michael Kerrisk 51dea63adf proc.5: Document (the obsolete) /proc/PID/seccomp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-09 16:15:02 +01:00
Michael Kerrisk d06a6170dd proc.5: Replace description of 'uid_map' with a reference to user_namespaces(7)
All of the information in proc(5) was also present in
user_namespaces(7), but the latter was more detailed
and up to date.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-04 15:11:02 +01:00
Michael Kerrisk ab28dba9a0 proc.5, user_namespaces.7: Migrate description of /proc/PID/setgroups to user_namespaces(7)
It makes sense to have the description of this file
in the general discussion of user namespaces.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-04 15:11:02 +01:00
Michael Kerrisk a0726dbfdd proc.5: Tweaks to /proc/PID/setgroups text
After comments from Eric Biederman

Cowritten-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-04 15:11:02 +01:00
Michael Kerrisk 6bb49a3266 proc.5: Tweak's to Eric Biederman's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Michael Kerrisk de04dd4df3 proc.5: Add some details on /proc/PID/setgroups
And generally rework the text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Michael Kerrisk 5c92b1b761 proc.5: Tweaks to Eric Biederman's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Eric W. Biederman d520465b99 proc.5: Document /proc/[pid]/setgroups
Signed-off-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Michael Kerrisk 1622fc979b proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Taisuke Yamada 157890398b proc.5: Document /proc/PID/status VmPin field
See https://bugs.launchpad.net/bugs/1071746

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-02 17:22:26 +01:00
Michael Kerrisk b6620a255b proc.5: tfix + srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-02 17:22:26 +01:00
Taisuke Yamada fd44bdc797 proc.5: Fix SELinux /proc/pid/attr/current example
Since the /proc/pid/attr API was added to the kernel, there
have been a couple of changes to the SELinux handling of
/proc/pid/attr/current.  Fix the SELinux /proc/pid/attr/current
example text to reflect these changes and note which kernel
versions first included the changes.

Signed-off-by: Stephen Smalley <sds@tycho.nsa.gov>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-02 17:22:26 +01:00
Michael Kerrisk 6d322d5fc7 time.1, access.2, arch_prctl.2, cacheflush.2, capget.2, clone.2, execve.2, fcntl.2, fork.2, getpid.2, getxattr.2, ioctl.2, ioctl_fat.2, killpg.2, listxattr.2, madvise.2, migrate_pages.2, modify_ldt.2, mprotect.2, msgget.2, msgop.2, perf_event_open.2, ptrace.2, sched_setattr.2, semget.2, semop.2, sendfile.2, set_thread_area.2, setxattr.2, stat.2, statfs.2, wait.2, wait4.2, encrypt.3, mktemp.3, pthread_attr_setschedparam.3, resolver.3, statvfs.3, syslog.3, tzset.3, core.5, host.conf.5, intro.5, proc.5, resolv.conf.5, pthreads.7, socket.7, unix.7, ld.so.8, ldconfig.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 09:26:52 +01:00
Michael Kerrisk 7672e08e00 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 08:32:12 +01:00
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