Commit Graph

503 Commits

Author SHA1 Message Date
Michael Kerrisk d84d0300a5 eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getaddrinfo.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5: srcfix
s/\.R " "/\\\&/ as a way of getting a blank line after a .SS heading.
(Suggested by Sam Varshavchik <mrsam@courier-mta.com>)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 20:42:45 -05:00
Michael Kerrisk c5571b613b Removed trailing white space at end of lines 2008-10-29 15:43:44 -05:00
Michael Kerrisk 9c33050447 eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strtol.3, core.5: global fix: Add ".SS Program source" to EXAMPLE
Add ".SS Program source" to clearly distinguish shell session and
descriptive text from actual program code.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:23 -05:00
Michael Kerrisk b43a3b301e eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, malloc.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7: Global fix: Format user input in shell sessions in boldface
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:23 -05:00
Michael Kerrisk fa802e7b90 proc.5: Document /proc/sys/kernel/threads-max
Defines the system-wide limit on the number of threads (tasks).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:11 -05:00
Pierre Cazenave 01f59bf3d5 utmp.5: It is just "other" who should not have write perms on utmp
The page was vague before, saying that utmp should not be writable
by any user.  This isn't true: it can be, and typically is, writable
by user and group.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 06:24:10 +02:00
Michael Kerrisk 897ea72349 utmp.5: wfix
Improve wording referring to include file that defines struct utmp.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 06:24:06 +02:00
Michael Kerrisk acddbaea0c Removed trailing white space at end of lines 2008-10-07 10:58:44 +02:00
Michael Kerrisk dd021848ab proc.5: tstamp 2008-10-06 15:07:03 +02:00
Michael Kerrisk c1eea65af0 proc.5: rewrite and simplify description of /proc/mounts
Most of the relevant discussion is now under /proc/PID/mounts;
all that needs to be here is a mention of the pre-2.4.19
system-wide namespace situation, and a reference to the
discussion under /proc/PID/mounts.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 14:23:00 +02:00
Michael Kerrisk 140ebdb93e mount.2: srcfix: remove outdated FIXME.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 14:18:16 +02:00
Michael Kerrisk cea61382b1 proc.5: Add description of /proc/PID/mounts
Largely cribbed from existing /proc/mounts discussion, which is
about to be rewritten.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 14:16:16 +02:00
Pavel Heimlich 783a623352 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 10:02:53 +02:00
Michael Kerrisk bd6e015628 acct.5: wfix (remove duplicate word) 2008-10-05 06:52:21 +02:00
Nicolas François 9d16961a57 Typo and whitespace fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:15:48 +02:00
Nicolas François 44e5793157 Typo and wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:00:36 +02:00
Michael Kerrisk 71c48553a1 Removed trailing white space at end of lines 2008-09-23 15:51:25 +02:00
Michael Kerrisk cf21356ddf Update timestamp 2008-09-23 15:05:49 +02:00
Michael Kerrisk c3ea9f2ded Can't use comma instead of slash to separate port and protocol.
Remove crufty text about use of comma instead of slash to separate
port and protocol.  It's not true as at glibc 2.8, and it's not
clear if/when it was ever true.
2008-09-23 11:20:21 +02:00
Michael Kerrisk d394fbfcd7 Remove refs to noonexisent docs.
Remove SEE ALSO references to nonexistent Guides to Yellow Pages
and Bind/Hesiod docs.
2008-09-23 10:56:51 +02:00
Michael Kerrisk 91924ca616 Minor wording and orthography fixes. 2008-09-23 10:51:43 +02:00
Michael Kerrisk a2610398b8 Remove some bugs, that no longer seen to be true in glibc 2.8. 2008-09-23 10:46:24 +02:00
Michael Kerrisk 837f7a82d3 Wording and grammar fixes 2008-09-23 10:19:32 +02:00
Michael Kerrisk d4e9903bb7 Removed trailing white space at end of lines 2008-09-10 12:39:34 +00:00
Michael Kerrisk a4fad1c6bb nop 2008-09-10 11:40:29 +00:00
Michael Kerrisk bda049a5d9 Place .so line start if file 2008-09-10 11:32:21 +00:00
Michael Kerrisk 67da52673e Start new sentence on new source line. 2008-09-10 03:45:09 +00:00
Michael Kerrisk eeeffe2d3b grfix 2008-09-10 03:41:35 +00:00
Michael Kerrisk 5b0dc1baed s/time zone/timezone/ for consistency across pages and with POSIX.1. 2008-09-07 04:17:25 +00:00
Michael Kerrisk ed26d24c76 Taken from Debian, with light edits 2008-09-04 14:02:12 +00:00
Michael Kerrisk 23ec6ff0a6 Document new fields in /proc/interrupts that were added in Linux 2.6.24. 2008-09-02 08:21:31 +00:00
Michael Kerrisk 77b802ec67 Remove sentence wrongly saying that meminfo reports
info in bytes; note that meminfo reports system-wide
memory usage statistics.
2008-08-28 05:49:20 +00:00
Michael Kerrisk 73edb42bed In the desription if /proc/[pid]/environ, remove reference to
lilo(8)/grub(8) since there seems to be nothing in those pages
that related to this /proc file.
2008-08-27 21:33:19 +00:00
Michael Kerrisk 69119dc7bb s/\[number]/[pid]/ in file names for /proc/PID files.
And similar changes for task/[tid] sub-directories.
2008-08-27 18:25:11 +00:00
Michael Kerrisk a2aac0390e SEE ALSO: Add bash(1). 2008-08-26 18:16:56 +00:00
Michael Kerrisk 788901248b Make the page more helpful to non-programmers by referencing
the documentation of the shell's 'ulimit' command in the
discussion of RLIMIT_CORE and RLIMIT_FSIZE.
Note that a core dump file can be used in a debugger.
2008-08-26 04:34:37 +00:00
Michael Kerrisk 7c47550e76 spfix 2008-08-18 08:20:12 +00:00
Michael Kerrisk 610f75cc09 Remove /proc/PID/numa_maps material (it is now in numa(7)). 2008-08-13 08:13:01 +00:00
Michael Kerrisk 533dbdda9c Link to new numa(7) page, which incorporates the
/proc/PID/numa_maps description.
As part of the numactl() package, the /proc/PID/numa_maps
documentation was in a numa_maps.5 page; this link
ensures that "man 5 numa_maps" still works.
(Eventually, we may want to remove it.)
2008-08-13 07:43:14 +00:00
Michael Kerrisk fd8df7ac02 s/rpc/RPC/ 2008-08-13 05:01:59 +00:00
Michael Kerrisk 5a35e62092 Removed trailing white space at end of lines 2008-08-12 10:27:05 +00:00
Michael Kerrisk 7388733a37 Add documentation of the /proc/PID/numa_maps file.
This material was formerly the numa_maps.5 page in the numactl
package, but really belongs in man-pages (since it describes
a kernel interface).
2008-08-12 10:20:50 +00:00
Michael Kerrisk 3bc960c2e8 ffixes 2008-08-12 09:34:10 +00:00
Michael Kerrisk c45bd688fd s/floating point/floating-point/ when used attributively. 2008-07-23 02:57:20 +00:00
Michael Kerrisk 9fd8b18591 tfix 2008-07-18 03:58:23 +00:00
Michael Kerrisk fd7193f57a Removed trailing white space at end of lines 2008-07-16 13:11:30 +00:00
Michael Kerrisk 44a2c3286c Even when the CONFORMING TO section is just a list of standards,
they should be terminated by a period.
2008-07-15 13:39:17 +00:00
Michael Kerrisk e98268b49a Add Documentation/sysctl/vm.txt to SEE ALSO.
Other minor edits.
2008-07-15 11:45:13 +00:00
Michael Kerrisk 82c333257b removed a FIXME 2008-07-15 11:41:51 +00:00
Michael Kerrisk 427965596f removed a FIXME 2008-07-15 11:39:49 +00:00
Michael Kerrisk aa1f2cc12b tfix 2008-07-15 11:38:30 +00:00
Michael Kerrisk bfde23a20d Make kernel version for /proc/sys/kernel/panic_on_oops more precise.
Make kernel version for /proc/sys/kernel/pid_max more precise.
2008-07-15 11:07:37 +00:00
Michael Kerrisk c3d9780d9c Document /proc/sys/vm/oom_dump_tasks (new in Linux 2.6.25).
Document /proc/sys/vm/panic_on_oom (new in Linux 2.6.18).
2008-07-15 11:03:08 +00:00
Michael Kerrisk 417fceb71a Remove redudant summary list of files in description of /proc/sys/kernel. 2008-07-15 08:51:41 +00:00
Michael Kerrisk e10120df66 Document /proc/sys/vm/oom_kill_allocating_task (new in Linux 2.6.24). 2008-07-15 08:48:01 +00:00
Michael Kerrisk fb8e1d1b2a sffix 2008-07-15 08:32:08 +00:00
Michael Kerrisk cc2d5c36d3 Tweak description of /proc/config.gz + update a FIXME 2008-07-15 08:22:19 +00:00
Michael Kerrisk 250e01ecb1 Add some details on /proc/config.gz. 2008-07-15 08:07:02 +00:00
Michael Kerrisk f6e524c4fc Document /proc/config.gz 2008-07-15 06:15:22 +00:00
Michael Kerrisk 74aace8a7f Small wording fixes -- express <= and >= in words when in running text. 2008-07-09 19:38:19 +00:00
Michael Kerrisk 87174b3ae2 Small wording fixes 2008-07-09 15:36:44 +00:00
Michael Kerrisk 8ee190da4a s/UNIX/Unix/, when not used as part of a trademark,
for consistency with majority usage in pages.
2008-07-09 14:17:06 +00:00
Michael Kerrisk bf5a72471e Added "Copyright" string to lines that had "([Cc])" for copyright. 2008-07-08 14:32:54 +00:00
Michael Kerrisk bf46db0786 grfix 2008-07-07 20:58:35 +00:00
Michael Kerrisk b878f418fe spfix 2008-07-07 20:58:19 +00:00
Michael Kerrisk 3d54a9102a Wrapped long source lines 2008-07-06 15:10:32 +00:00
Michael Kerrisk 5c411b17a1 Add pointer to description of /proc/PID/cpuset in cpuset(7). 2008-07-03 20:13:32 +00:00
Michael Kerrisk b22e49b8ec SEE ALSO: Add getpwent(3), getpwnam(3). 2008-07-03 15:23:13 +00:00
Michael Kerrisk a8f6012cc7 SEE ALSO: Add getgrent(3), getgrnam(3). 2008-07-03 15:22:58 +00:00
Michael Kerrisk e242920a32 ffix 2008-07-02 13:38:55 +00:00
Michael Kerrisk bce4320132 ffix 2008-07-02 13:38:07 +00:00
Michael Kerrisk 0ad7707a3f SEE ALSO: add getutmp(3) 2008-07-02 11:32:01 +00:00
Michael Kerrisk 40374cfc16 ffix 2008-07-02 10:57:36 +00:00
Michael Kerrisk 0425de01c7 s/ / / 2008-07-01 14:15:13 +00:00
Michael Kerrisk c4fe9aef4a ffix 2008-07-01 14:04:23 +00:00
Michael Kerrisk a8b32c31c2 SEE ALSO: Add mmap(2). 2008-07-01 14:02:46 +00:00
Michael Kerrisk 145230159a Added FIXME 2008-07-01 02:09:18 +00:00
Michael Kerrisk 18701562c1 s/user name/username/ 2008-06-30 14:36:59 +00:00
Michael Kerrisk 377dda5900 Rmoved some crufty text; ffixes; 2008-06-29 07:01:28 +00:00
Michael Kerrisk 593f7b6f7e Enhance description of ut_session 2008-06-29 06:24:54 +00:00
Michael Kerrisk 94a6e588ec Relocate some text. 2008-06-29 06:21:36 +00:00
Michael Kerrisk 6f26e80fa1 Linux defines the utmpx structure to be same as utmp 2008-06-29 06:19:20 +00:00
Michael Kerrisk 0ef1b0fc23 Add discussion of POSIX.1 utmpx specification.
Move some text from CONFORMING To to NOTES.
2008-06-29 06:16:33 +00:00
Michael Kerrisk 1c3f428027 Link to utmp.5 2008-06-29 06:11:16 +00:00
Michael Kerrisk 3e85e8b3c3 Added comments to macros for ut_type field. 2008-06-29 06:04:03 +00:00
Michael Kerrisk 136c760794 Correct the description of the ut_id field 2008-06-29 05:50:02 +00:00
Michael Kerrisk 3721bd3f13 Consolidate duplicated information about ut_tv and ut_session
on biarch platforms.
2008-06-29 05:24:03 +00:00
Michael Kerrisk b40e1143a6 wfix 2008-06-29 05:02:57 +00:00
Michael Kerrisk b0075a1770 ffix 2008-06-29 05:00:32 +00:00
Michael Kerrisk f6f269ab4d Add coments to structure defn. 2008-06-29 04:58:29 +00:00
Michael Kerrisk f56413a060 ffix 2008-06-29 04:57:10 +00:00
Michael Kerrisk 93574a8080 wfix + ffix 2008-06-29 04:56:36 +00:00
Michael Kerrisk ff2548cada UT_LINESIZE is 32 (not 12). 2008-06-29 04:54:17 +00:00
Michael Kerrisk 5dff4b55de wfix 2008-06-29 04:51:21 +00:00
Michael Kerrisk b381fd9f76 tstamp 2008-06-29 04:48:55 +00:00
Michael Kerrisk 4a36e281c9 ffix 2008-06-29 04:45:30 +00:00
Michael Kerrisk 45ec232d31 Provide a little more detail on fields of utmp structure. 2008-06-29 04:43:41 +00:00
Michael Kerrisk 31ccb5f8fd SEE ALSO: add login(3), logout(3), logwtmp(3) 2008-06-29 04:30:53 +00:00
Michael Kerrisk 39446c2fec wrap line at sentence break 2008-06-29 04:02:19 +00:00
Michael Kerrisk 6387216bb2 Wrap lines at sentence breaks. 2008-06-28 04:57:20 +00:00
Michael Kerrisk 4a4865687c ffix 2008-06-28 04:26:29 +00:00
Michael Kerrisk ddaec46d7f s/host name/hostname/ 2008-06-27 03:37:56 +00:00
Michael Kerrisk 5b8dbfd4d0 ffixes 2008-06-26 13:23:48 +00:00
Michael Kerrisk cd60dedde9 Removed trailing white space at end of lines 2008-06-25 15:32:01 +00:00
Michael Kerrisk 268f000bcf /proc/stat CPU time units are sysconf(_SC_CLK_TCK).
ASEE ALSO: add time(7).
2008-06-24 13:56:03 +00:00
Michael Kerrisk 7a017e241f The vaious time fiels in /proc/PID/stat return time
in clock ticks (USER_HZ, cputime_to_clock_t()).
2008-06-24 13:15:17 +00:00
Michael Kerrisk 59a40ed789 Clarified and expanded the description of /proc/[number]/fd.
Updated, clarified and expanded the description several
fields in /proc/[number]/stat.
Updated and clarified the description of /proc/[number]/statm.
Updated and clarified the description of /proc/sys/fs/dentry-state.
Many formatting, wording, and grammar fixes.
2008-06-24 09:28:11 +00:00
Michael Kerrisk e23fde73fa We don't have the cpuset(7) page yet, so comment out /proc/[number]/cpuset
description.
2008-06-24 03:42:39 +00:00
Michael Kerrisk 743638fdbe ffix 2008-06-24 03:41:21 +00:00
Michael Kerrisk a1c9dc591b Refine discssion of guest time for utime and cutime fields. 2008-06-24 03:25:39 +00:00
Michael Kerrisk b81087ab66 Added .\" comment 2008-06-23 10:00:02 +00:00
Michael Kerrisk c8e9f4f193 user time includes guest time. 2008-06-22 10:51:59 +00:00
Michael Kerrisk afef1764bd spfix 2008-06-22 10:40:48 +00:00
Michael Kerrisk 1bb54c6c2d spfix 2008-06-22 10:40:34 +00:00
Michael Kerrisk 14c069537c Document guest (virtual CPU) time field in /proc/stat.
Document guest (virtual CPU) time fields in /proc/PID/stat.
2008-09-18 12:30:43 +00:00
Michael Kerrisk c5565cf1ec minor fixes 2008-06-18 09:41:30 +00:00
Michael Kerrisk 2fadbfb588 For consistency, "fix" cases where aregument of .B or .I was on the following source line. 2008-06-18 08:57:49 +00:00
Michael Kerrisk 33af850128 LC_TIME: Describe first_weekday and first_workday 2008-06-17 14:11:43 +00:00
Michael Kerrisk 16b5f7ba5d Documented /proc/PID/status 2008-06-17 13:22:28 +00:00
Michael Kerrisk 28f2c98d3a Add pointer to description of /proc/PID/cpuset in cpuset(7). 2008-06-16 20:16:23 +00:00
Michael Kerrisk a1d5601bee Removed trailing white space at end of lines 2008-06-12 11:52:08 +00:00
Michael Kerrisk b4e9ee8f48 Document /proc/PID/oom_score, which was new in kernel 2.6.11.
This file displays the "badness" score of the process, which
provides the basis for OOM-killer decisions.

Document /proc/PID/oom_adj, which was new in kernel 2.6.11.
This file influences the oom_score of a process.

Document /proc/PID/limits, which was new in 2.6.24.
This file displays a process's resource limits.

Document /proc/PID/fdinfo/*, which was new in 2.6.22.
These files display info about each descriptor opened by the
process: the current file offset, and the file access mode +
file status flags as set in open() or fcntl(F_SETFL).

Document /proc/PID/mountinfo, which was new in 2.6.26.
This file displays information about mount points.
Closely based on text from Documentation/filesystems/proc.txt.

Document /proc/PID/mountstats, which was new in 2.6.17.
This file displays statistics about mount points.
2008-06-12 05:49:06 +00:00
Michael Kerrisk b78e3a8023 Document core_pattern pipe syntax, which appeared in kernel 2.6.19.
Add an example program demonstrating use of core_pattern pipe syntax.
Document /proc/PID/coredump_filter, new in kernel 2.6.23.
Documentation was based on the text in Documentation/filesystems/proc.txt,
plus testing, and reading the kernel source.
2008-06-12 04:59:28 +00:00
Michael Kerrisk aaed8ba0f9 A complete rewrite of this page, now with much more detail. 2008-06-11 22:37:54 +00:00
Michael Kerrisk 6c04f928e2 Fix use of quotes 2008-06-10 12:28:58 +00:00
Michael Kerrisk 8bb93cd4bb Control character names (^X) are writte boldface, without quotes. 2008-06-10 08:44:34 +00:00
Michael Kerrisk 8062a09161 Add FIXME 2008-06-09 21:07:39 +00:00
Michael Kerrisk f81fb4445b s/\\'/\\(aq/ 2008-06-09 15:49:35 +00:00
Michael Kerrisk 84c517a450 Change use of quote characters to get better UTF-8 rendering. 2008-06-05 20:14:50 +00:00
Michael Kerrisk b8b45978b0 /'/\\'/ to produce better UTF rendering 2008-06-05 19:01:25 +00:00
Michael Kerrisk f8a07a2154 s/'/\\'/ to improve rendering in UTF-8. 2008-06-05 17:52:37 +00:00
Michael Kerrisk 26868e5b26 s/`/\`/ for backquotes used in command substitution, for
proper rendering in UTF-8.
2008-06-05 12:26:22 +00:00
Michael Kerrisk bd4b0ce7d0 Added FIXME 2008-05-27 03:01:24 +00:00
Michael Kerrisk f6c0f13754 spfix 2008-05-12 16:14:48 +00:00
Michael Kerrisk 1de3e6adea wfix 2008-05-08 11:14:17 +00:00
Michael Kerrisk b6e956c0bd Small rewording 2008-04-18 15:51:44 +00:00
Michael Kerrisk 0ce57e09c9 gethostname is in Section 2, not section 3. 2008-04-18 15:45:03 +00:00
Michael Kerrisk 6f36deb49c s/realtime/real-time/ 2008-03-19 13:23:34 +00:00
Michael Kerrisk eba722884d s/nonzero/non-zero/ 2008-03-19 13:16:39 +00:00
Michael Kerrisk 972a8ec74e grfix 2008-03-19 11:52:55 +00:00
Michael Kerrisk ecccf7c284 grfix 2008-03-19 08:56:26 +00:00
Michael Kerrisk cf50118f48 Use "run time" when non-attributive, "run-time" when attributive. 2008-03-19 08:46:32 +00:00
Michael Kerrisk 76c44d83f3 s/command line/command-line/ when used attributively. 2008-03-19 08:37:35 +00:00
Michael Kerrisk e7b489f0b9 s/builtin/built-in/ 2008-03-19 08:32:22 +00:00
Michael Kerrisk 24d01c530c s/filesystem/file system/ 2008-03-19 07:26:08 +00:00
Michael Kerrisk 10d76543fe Modify the license on these pages to be the standard verbatim license. 2008-03-18 14:47:54 +00:00
Michael Kerrisk b69987f6de s/time stamp/timestamp/ 2008-03-18 09:52:36 +00:00
Michael Kerrisk 046495ca4b spfix 2008-03-11 12:50:45 +00:00
Michael Kerrisk f9c3f32ab7 ffix 2008-03-05 11:34:16 +00:00
Michael Kerrisk b447cd586d Update /proc/[number]/cmdline description.
It used to be true that the command line arguments were
not accessible when the process had been swapped out.
In ancient kernels (circa 2.0.*) the problem was that the
kernel relied on get_phys_addr to access the user space buffer,
which stopped working as soon as the process was swapped out.
Recent kernels use get_user_pages for the same purpose and thus
they should not have that limitation.
2008-02-22 07:41:04 +00:00