Commit Graph

5128 Commits

Author SHA1 Message Date
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
Michael Kerrisk f1b0cf261c Document MS_SILENT (and MS_VERBOSE)
Maxin suggested a patch, which I've rewritten and expanded.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Maxin B. John <maxin.john@ap.sony.com>
2008-10-01 15:17:47 +02:00
Michael Kerrisk 6a0f91ccfa readdir.3: SEE ALSO: add getdents(2)
Because readdir() is implemented on top of getdents(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 15:08:04 +02:00
Michael Kerrisk efb92ba155 getdents.2, readdir.3: d_type is currently only supported on ext[234]
As at kernel 2.6.27, only ext[234] support d_type.
On other file systems, d_type is always set to DT_UNKNOWN (0).

Reported-by: Ricardo Catalinas Jimnez <jimenezrick@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 15:06:36 +02:00
Michael Kerrisk c42ad30f8c fma.3: Add some source code comments explaining two domain error cases.
Two of the "domain error" cases described on this page are treated in
the same way on Linux, but POSIX.1 specifies some optional differences
for the two cases.  Make life easier for future page reviewers/editors
by adding some comments explaining that POSIX.1-2001 distinguishes
the two cases.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Nicolas Franois <nicolas.francois@centraliens.net>
2008-09-29 13:42:58 +02:00
Nicolas Franois 69cb728c2f wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:24:36 +02:00
Nicolas Franois 11c87468b9 nextafter.3: Make description more precise: s/next/largest/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:22:21 +02:00
Nicolas Franois 166f4f1630 floor.3: Fix error in description: s/smallest/largest/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:21:55 +02:00
Nicolas Franois f010f3a2ce ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:05:56 +02:00
Nicolas Franois 4718ba1c3b atan2.3: Fix error in description of range or return value
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

In recent changes to the man page, mtk accidentally cganged
the description of the return value range to -pi/2..pi/2;
the corect range is -pi..pi.
2008-09-29 13:01:44 +02:00
Michael Kerrisk bc0a3def1d utimensat.2: POSIX.1-2008 revision will likely affect FTMs for futimens()
Make it clear that the POSIX.1 revision that is likely
to affect the feature test macro requirements for futimens() is
POSIX.1-2008.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Nicolas Franois <nicolas.francois@centraliens.net>
2008-09-29 12:52:30 +02:00
Nicolas Franois 26b42bb4bf utimensat.2: Make various wordings a little more precise.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

The times argument point to *an array of* structures, and the
man-page should say that consistently.
2008-09-29 12:42:09 +02:00
Michael Kerrisk 2dd5352dae send.2: make kernel version for MSG_CONFIRM more precise
s/2.3+ only/Since Linux 2.3.15/

Reported-by: Nicolas Franois <nicolas.francois@centraliens.net>
2008-09-29 12:35:13 +02:00
Nicolas Franois aab31be272 move_pages.2: Make a detail og EPERM error more precise
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 12:20:39 +02:00
Marko Kreen 7d557e75c0 strcpy.3: Revert earlier change to example strncpy() calls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

I browsed the changes there and found a buggy code snippet:
2008-09-29 12:01:26 +02:00
Nicolas Franois 5f3fb725ab recv.2: Move kernel version number to first mention to MSG_ERRQUEUE.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:46:01 +02:00
Nicolas Franois 553f115ece cmsg.3: Add parentheses after macro names.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:33:04 +02:00
Nicolas Franois 494b842ba0 Remove a line of junk text.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:30:57 +02:00
Nicolas Franois 9d16961a57 Typo and whitespace fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:15:48 +02:00
Nicolas Franois 178d104e83 Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:09:52 +02:00
Nicolas Franois 44e5793157 Typo and wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:00:36 +02:00
Kirill A. Shutemov afc4edc132 semop.2: fix typo in example
(The '&' before sop in the semop() call is unneeded.)
Signed-off-by: Kirill A. Shutemov <kirill@shutemov.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 09:49:35 +02:00
Michael Kerrisk 16d023bce2 grfix 2008-09-29 08:48:18 +02:00
Michael Kerrisk 12e86dbff5 mq_overview.7: add mq_notify() to list of lib. functions and syscalls in MQ API 2008-09-29 06:05:04 +02:00
Michael Kerrisk 247ac1d3da mg_getattr.3: mq_getattr() and mq_setattr() are layered on mq_getsetattr(2)
mq_getattr() and mq_setattr() are library functions layered on
top of the mq_getsetattr(2) system call.
(This is useful info for users of strace(1).)
2008-09-29 05:51:25 +02:00
Michael Kerrisk c89e428bcd mq_receive.3: mq_send() is a library function layered on mq_timedreceive() syscall
This info is useful for users of strace(1).
2008-09-29 05:40:37 +02:00
Michael Kerrisk 5496c8c1d2 mq_send.3: mq_send() is a library function layered on mq_timedsend() syscall
This info is useful for users of strace(1).
2008-09-29 05:36:48 +02:00