Commit Graph

5254 Commits

Author SHA1 Message Date
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
Michael Kerrisk 0a4d78bbe1 mount.2: Add description of namespace
Describe per-process namespaces, including discussion
of clone() and unshare CLONE_NEWNS, and /proc/PID/mounts.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 14:07:03 +02:00
Michael Kerrisk 852ae8c875 mount.2: List a few other file systems that we may see in /proc/filesystems
Add some modern file systems to that list (xfs, jfs, ext3, reiserfs).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 13:19:51 +02:00
Michael Kerrisk a3b00c37dc mount.2: wfix: remove redundant "Linux Notes" subheading 2008-10-06 13:18:33 +02:00
Michael Kerrisk 5614f73308 mount.2, umount.2: split umoun*() out into a separate page
The length of this page means that it's becoming difficult to parse
which info is specific to mount() versus umount()/umount2(), so split
the umount material out into its own page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 13:09:26 +02:00
Michael Kerrisk 9b9b4a8137 spfix 2008-10-06 11:49:27 +02:00
Michael Kerrisk 2411effea2 signal.7: improve description in NAME section
Reported-by: Gergely Soos <sogerc1@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 10:12:00 +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 eeccef1df0 signal.7: Add mention of sigaltstack(2).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 07:46:09 +02:00
Michael Kerrisk e66d51d1ba signal.7: Describe syscalls that synchronously wait for a signal,
(sigwait(), sigwaitinfo(), sigtimedwait(), signalfd)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 07:41:29 +02:00
Michael Kerrisk 22fe4981c2 signal.7: Give overview of syscalls that block until a signal is caught
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 07:30:24 +02:00
Michael Kerrisk 4704a09b80 signal.7: ffix 2008-10-05 07:29:00 +02:00
Michael Kerrisk 7a414038ea signal.7: Add overview of interfaces for sending signals.
(kill(), killpg(), tgkill(), sigqueue(), raise(), etc.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 07:23:58 +02:00
Michael Kerrisk cd7b18e735 pause.2: remove mention of words "library function"
This really is a system call.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 07:20:58 +02:00
Michael Kerrisk bd6e015628 acct.5: wfix (remove duplicate word) 2008-10-05 06:52:21 +02:00
Michael Kerrisk e8f4a1c928 getcwd.3: wfix (remove duplicate word) 2008-10-05 06:50:51 +02:00
Michael Kerrisk 374af67a42 getrlimit.2: refer to execve(2) for RLIMIT_STACK's effect on ARG_MAX
Refer the reader to new text in execve(2) that describes how
(since Linux 2.6.23) RLIMIT_STACK determines the value of ARG_MAX.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 06:24:36 +02:00
Michael Kerrisk 3a9dc9ff79 execve.2: _SC_ARG_MAX is no longer necessarily constant
POSIX.1-2001 says that the values returned by sysconf()
are constant for the life of the process.
But the fact that, since Linux 2.6.23, ARG_MAX is settable
via RLIMIT_STACK means _SC_ARG_MAX is no longer constant,
since it can change at each execve().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 05:59:32 +02:00
Michael Kerrisk f202015b45 execve.2: Linux now imposes a floor on the ARG_MAX limit
Starting with Linux 2.6.23, the ARG_MAX limit became settable via
(1/4 of) RLIMIT_STACK.  This broke ABI compatibility if RLIMIT_STACK
was set such that ARG_MAX was < 32 pages.  Document the fact that
since 2.6.25 Linux imposes a floor on ARG_MAX, so that the old limit
of 32 pages is guaranteed.

For some background on the changes to ARG_MAX in kernels 2.6.23 and
2.6.25, see:
    http://sourceware.org/bugzilla/show_bug.cgi?id=5786
    http://bugzilla.kernel.org/show_bug.cgi?id=10095
    http://thread.gmane.org/gmane.linux.kernel/646709/focus=648101,
    checked into 2.6.25 as commit a64e715fc74b1a7dcc5944f848acc38b2c4d4ee2.

Also some reordering/rewording of the discussion of ARG_MAX.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 05:57:52 +02:00
Michael Kerrisk 00e8730f78 getrlimit.2: Reword/relocate discussion of BSD's historical RLIMIT_OFILE
The old sentence sat on its own in an odd place, and anyway the
modern BSDs use the name RLIMIT_NOFILE.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 05:42:32 +02:00
Michael Kerrisk f3504b0292 srcfix 2008-10-05 03:29:35 +02:00
Michael Kerrisk d5c8829874 signal.7: describe semantics w.r.t. fork() and execve()
Include text describing semantics of fork() and execve() for
signal dispositions, signal mask, and pending signal set.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 08:33:53 +02:00
Michael Kerrisk 3fb46b2b3b sigaction.2: wfix 2008-10-04 08:27:56 +02:00
Michael Kerrisk f7d174ea1b sigaction.2: refer reader to signal(7) for an overview of signals
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Gergely Soos <sogerc1@gmail.com>
2008-10-04 08:01:49 +02:00
Michael Kerrisk 0ac0def44d sigaction.2: explain semantics of signal disposition during fork() and execve()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 07:49:53 +02:00
Michael Kerrisk 0178675542 sigwaitinfo.2: distinguish per-thread and process-wide signals
A sentence clarifying that pending signal set is union of
per-thread and process-wide pending signal sets.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 07:39:50 +02:00
Michael Kerrisk 1218ca8771 sigwaitinfo.2: these interfaces have per-thread semantics
The page was previously fuzzy about whether the these interfaces
have process-wide or per-thread semantics.  (E.g., now the
page states that the calling *thread* (not process) is suspended
until the signal is delivered.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 07:36:18 +02:00
Michael Kerrisk 55aa29202c semop.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 07:14:34 +02:00
Michael Kerrisk dfcc37a6ab getrusage.2: rusage measures are preserved across execve(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 07:10:35 +02:00
Michael Kerrisk 6d01795229 sigaltstack.2: explain inheritance of alternate signal stack across fork(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 06:58:36 +02:00
Michael Kerrisk a6b7b51147 sigpending.2: explain effect of fork() and execve() for pending signal set
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 06:38:30 +02:00
Michael Kerrisk 7acce9fb90 sigpending.2: explain how thread's pending signal set is defined
The pending set is the union of per-thread pending signals and process-wide
pending signals.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 06:34:38 +02:00
Michael Kerrisk eebf482da2 sigprocmask.2: explain effects of fork() and execve() for signal mask
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 06:30:10 +02:00
Michael Kerrisk 4c5bcd47bf sigaction.2: refer to signal(7) for more details on signal mask.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 05:49:12 +02:00
Michael Kerrisk bf50110267 execve.2: updated FIXME (for argv==NULL) in source comments 2008-10-03 06:04:03 +02:00
Michael Kerrisk 1dfd87eee5 readdir.2: The programmer must declare the old_linux_dirent structure
Glibc does not provide a definition of this structure.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 13:30:23 +02:00
Michael Kerrisk 8c1e7c9c47 wspacefix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 13:28:02 +02:00
Michael Kerrisk b82f860abd readdir.2: s/dirent/old_linux_dirent/
Nowadays, this is the name of the structure in the kernel sources.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 13:26:33 +02:00
Michael Kerrisk f8c4a80874 readdir.2: remove words "which may change"
These words are slightly bogus: although the interface is obsolete,
for ABI-compatibility reasons, the kernel folk should never be changing
this interface.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 13:23:25 +02:00
Michael Kerrisk 30508251e3 readdir.2: remove header files from SYNOPSIS
glibc doesn't provide any support for readdir(2),
so remove these header files (which otherwirse suggest
that glibc does provide the required pieces).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 13:20:39 +02:00
Michael Kerrisk d03fa0d508 getdents.2: Add an example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 13:15:42 +02:00
Michael Kerrisk 5ff3825e41 getdents.2: comment out linux_dirent fields with varying location
The location of the fields fater d_name varies according to
the size of d_name.  We can't properly declare them in C;
therefore, put those fields inside a comment.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 13:07:58 +02:00
Michael Kerrisk 5df2ee037d getdents.2: The DT_* constants are defined in <dirent.h>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 11:35:50 +02:00
Michael Kerrisk 298c502435 getdents.2: emove header files from SYNOPSIS
None of the header files provides what is needed.
Calls are made via syscall(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 11:33:34 +02:00
Michael Kerrisk 64150629a7 getdents.2: The programmer must define the linux_dirent structure
Point out that this structure is not defined in glibc headers.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 11:27:17 +02:00
Michael Kerrisk affa1ac7b6 getdents.2: s/dirent/linux_dirent/
The structure isn't currently defined in glibc headers, and the kernel
name of the structure is 'linux_dirent' (as was already used in some,
but not all, places in this page).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-02 11:15:28 +02:00
Michael Kerrisk 6d32be0960 tkill.2: EINVAL error can also occur for invalid TGID
The EINVAL error on an invalid TGID for tgkill() was
not documented; this change documents it.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-01 16:46:11 +02:00