Commit Graph

282 Commits

Author SHA1 Message Date
Michael Kerrisk 4b749a1204 core.5, proc.5: Minor edits to Kees Cook's suid_dumpable patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-01-13 10:07:48 +01:00
Kees Cook 8c897fc6b2 core.5, proc.5: Clarify suid_dumpable versus core_pattern
In Linux 3.6, additional requirements were placed on core_pattern
when suid_dumpable is set to 2. Document this and include commit
references.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-01-12 11:30:24 +01:00
Kees Cook bc88143e1a proc.5: Linux 3.4 changed permissions needed to change kptr_restrict
Signed-off-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-01-11 12:55:49 +01:00
Kees Cook a1da75e7d6 proc.5: Document /proc/sys/kernel/dmesg_restrict
Signed-off-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-01-11 12:52:03 +01:00
Kees Cook 25fc6a84b8 proc.5: Put /proc/sys/kernel/hotplug in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-01-11 12:46:57 +01:00
Michael Kerrisk cb42fb5682 proc.5: Add field numbers for /proc/[pid]/statm
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413

Reported-by: Samuel Thibault <sthibault@debian.org>
Reported-by: Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-26 23:47:50 +01:00
Justin Lebar 04dcb3c8f8 proc.5: statm's "shared" field refers to pages backed by files
I noticed that statm's "shared" field doesn't match the sum of
all the "shared" entries in smaps [1].

The kernel docs explain that statm's "shared" field is "number of
pages that are shared (i.e. backed by a file)" [2].  smaps appears
to call a page shared if it's mapped by at least two processes,
which explains this discrepancy.

I'm not a kernel hacker, but it appears to me they do mean "i.e."
and not "e.g." in the statm description: In
fs/proc/task_mmu.c::task_statm, I see

    *shared = get_mm_counter(mm, MM_FILEPAGES);

Here's a patch which updates the man page to match the (hopefully
correct) kernel docs.

[1] https://bugzilla.mozilla.org/show_bug.cgi?id=807181
[2] http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob;f=Documentation/filesystems/proc.txt;h=a1793d670cd01bd374eddf54ffdfc768504291ff;hb=HEAD

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-26 23:47:50 +01:00
Michael Kerrisk 4cb1deb76f proc.5: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-26 23:47:50 +01:00
Michael Kerrisk e04a1f931d proc.5: srcfix: Update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-26 23:47:50 +01:00
Michael Kerrisk d4fd412082 proc.5: Document /proc/stat "cpu" "nice_guest" field
Info taken from commit ce0e7b28fb75cb003cfc8d0238613aaf1c55e797

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-26 23:47:50 +01:00
Michael Kerrisk ea0841f6c2 proc.5: Add numbering to /proc/stat "cpu" fields
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413

Reported-by: Samuel Thibault <sthibault@debian.org>
Reported-by: Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-26 23:47:43 +01:00
Michael Kerrisk ae3b804737 proc.5: Reorganize text describing /proc/stat "cpu" fields
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-26 20:36:20 +01:00
Michael Kerrisk aa610245c8 proc.5: Add field numbers for /proc/PID/stat
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413

Reported-by: Samuel Thibault <sthibault@debian.org>
Reported-by: Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-26 20:16:08 +01:00
David Prévot 1f6aa3ea7b proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-23 18:51:43 +01:00
Michael Kerrisk f2c8b197ae proc.5: Document /prod/[pid]/oom_score_adj
Text taken directly from Documentation/filesystems/proc.txt,
with some light editing.

See https://bugzilla.kernel.org/show_bug.cgi?id=50421

Reported-by: Peter Lekeynstein <lekensteyn@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-22 02:40:06 +01:00
Michael Kerrisk de8e9cc1a0 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-12-22 02:40:06 +01:00
Michael Kerrisk e1282f176c proc.5: Note change of /proc/[pid]/limits file permissions in 2.6.36
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-24 09:14:31 +01:00
Michael Kerrisk c16d4f25c7 proc.5: Correct description of SwapFree in /proc/meminfo
Reported-by: Jim Paris <jim@jtan.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-16 07:58:27 +01:00
Michael Kerrisk 46fbfc072b proc.5: tfix
Reported-by: Jim Paris <jim@jtan.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-16 07:28:27 +01:00
Michael Kerrisk fa1d274987 Removed trailing white space at end of lines 2012-11-07 14:24:27 +01:00
Simon Paillard aa8a6b4fbf proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-05 17:17:27 +01:00
David Prévot 99e9158609 proc.5: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-05 17:14:57 +01:00
David Prévot 7bccb7d474 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-05 17:02:55 +01:00
Michael Kerrisk f9313d015c proc.5: Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0
The default setting of 1 in/proc/sys/fs/protected_hardlinks
and /proc/sys/fs/protected_symlinks caused one too many
breakages for Linus's taste, so commit 561ec64ae67e changed
the default for both files to 0.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
David Prévot 075963263e proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
Michael Kerrisk 7fac88a949 eventfd.2, futex.2, mmap2.2, open.2, pciconfig_read.2, ptrace.2, reboot.2, request_key.2, sched_rr_get_interval.2, splice.2, stat.2, sync_file_range.2, syscalls.2, timer_create.2, vm86.2, pthread_attr_setscope.3, core.5, proc.5, aio.7, futex.7, netlink.7, time.7: Global fix: "userspace" ==> "user space" or "user-space"
Existing pages variously use "userspace or "user space".
But, "userspace" is not quite an English word.
So change "userspace" to "user space" or, when used
attributively, "user-space".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:33 +02:00
Michael Kerrisk 17b657f4d3 proc.5: Since Linux 2.6.27, /proc/sys/kernel/modprobe depends on CONFIG_MODULES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
Michael Kerrisk 1eeb999522 proc.5: Fix merge conflict
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:04:50 +02:00
Michael Kerrisk 3ba3d5b1b7 proc.5: Document /proc/meminfo
Info mosly taken from Documentation/filesystems/proc.txt
and Documentation/vm/hugetlbpage.txt.

Also added info on the CONFIG_* options that govern various
parameters, and also version information for fields
introduced since 2.6.0. This information is current up to
Linux 3.6.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 14:46:21 +02:00
Michael Kerrisk 8306193887 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 09:22:40 +02:00
Michael Kerrisk 2f249f3bd6 proc.5: Note system call error yeilded by /proc/sys/fs/protected_symlinks
Note that violating 'protected_symlinks' restrictions
causes system calls to fail with the error EACCES.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 13:28:47 +02:00
Michael Kerrisk 2da52bf6b8 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 12:15:13 +02:00
Michael Kerrisk 4eaa04c556 Removed trailing white space at end of lines 2012-10-15 11:13:31 +02:00
Michael Kerrisk 19f9d5935d proc.5: Document /proc/sys/fs/protected_symlinks
Based on text in Documentation/sysctl/fs.txt by Kees Cook

Cowritten-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 11:11:21 +02:00
Michael Kerrisk c2b035115c proc.5: Document /proc/sys/fs/protected_hardlinks
Based on text in Documentation/sysctl/fs.txt by Kees Cook

Cowritten-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Conflicts:
	man5/proc.5
2012-10-15 11:09:02 +02:00
Michael Kerrisk 4129825b52 proc.5: Document /proc/sys/kernel/kptr_restrict
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 08:56:36 +02:00
Michael Kerrisk 31a6818e3c time.1, atexit.3, bsearch.3, dlopen.3, envz_add.3, errno.3, fmtmsg.3, getgrent_r.3, getline.3, getmntent.3, getnameinfo.3, getpass.3, getpwent_r.3, gets.3, isalpha.3, printf.3, puts.3, recno.3, scandir.3, stdarg.3, sysconf.3, termios.3, wordexp.3, null.4, core.5, dir_colors.5, issue.5, proc.5, termcap.5, utmp.5, ascii.7, cpuset.7, glob.7, man-pages.7, man.7, mdoc.7, mdoc.samples.7, regex.7: Revert 9f8e673e62 (whose global s%\\e%\\\\% caused problems)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-26 23:56:54 +02:00
Michael Kerrisk 9f8e673e62 time.1, atexit.3, bsearch.3, dlopen.3, envz_add.3, errno.3, fmtmsg.3, getgrent_r.3, getline.3, getmntent.3, getnameinfo.3, getpass.3, getpwent_r.3, gets.3, isalpha.3, printf.3, puts.3, recno.3, scandir.3, stdarg.3, sysconf.3, termios.3, wordexp.3, null.4, core.5, dir_colors.5, issue.5, proc.5, termcap.5, utmp.5, ascii.7, cpuset.7, glob.7, man-pages.7, man.7, mdoc.7, mdoc.samples.7, regex.7: Global fix: use \\ rather than \e for literal backslash
Reported-by: Jan Engelhardt <jengelh@inai.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 10:23:07 +02:00
Michael Kerrisk 66a9882e46 bdflush.2, get_robust_list.2, kexec_load.2, madvise.2, mmap.2, mount.2, prctl.2, query_module.2, rt_sigqueueinfo.2, shmget.2, sigaction.2, syscalls.2, umount.2, malloc.3, hpsa.4, initrd.4, proc.5, bootparam.7, icmp.7, netlink.7, signal.7: Global fix: use "Linux kernel source" consistently
Rather than "kernel source".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 10:02:34 +02:00
Michael Kerrisk 67914165b3 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-22 15:28:19 +02:00
Michael Kerrisk 055024ed2e proc.5: Update description of 'starttime' field of /proc/PID/stat
The unit of measurement changed from jiffies to clock ticks in
Linux 2.6.

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=675891

Reported-by: Frédéric Brière <fbriere@fbriere.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-22 15:27:31 +02:00
Michael Kerrisk 00702accc4 proc.5: Clarify header file referred related to 'flags' field of /proc/PID/stat
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 21:10:51 +02:00
Tolga Dalman 2b5407af0c proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:30:21 +02:00
David Prévot 8d708d6bf6 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-11 06:24:37 +12:00
Michael Kerrisk 4175f99924 add_key.2, query_module.2, request_key.2, resolver.3, stpcpy.3, strftime.3, elf.5, proc.5, mdoc.samples.7: srcfix: Wrap source lines at sentence boundaries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
Michael Kerrisk b5d204d02b proc.5: Document /proc/[pid]/cgroup
Upstreamed from Red Hat / Fedora

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:15 +12:00
Michael Kerrisk 9ab6bd3188 proc.5: Note that CAP_SYS_ADMIN processes can override file-max
Upstreamed from red Hat / Fedora

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:15 +12:00
Michael Kerrisk b9c48803b8 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:15 +12:00
Elie De Brauwer 78fc91ec1b proc.5: Fix description of fourth field of /proc/loadavg
SIgned-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 06:21:20 +13:00
Michael Kerrisk 2c4201f01a proc.5: srcfix: Added pointer to a commit
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-05 07:38:45 +02:00