Commit Graph

1925 Commits

Author SHA1 Message Date
Michael Kerrisk ad3f4748db sched_setaffinity.2: Removed discussion of CPU_* macros()
These macros are now moving to a separate page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-13 08:56:56 -05:00
Michael Kerrisk 2ce777b42c sched_setaffinity.2: wfix 2008-11-13 08:56:55 -05:00
Michael Kerrisk 718af393c7 sched_setaffinity.2: Minor updates in VERSIONS
Document the version of glibc that added the CPU_*() macros.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-13 08:56:55 -05:00
Michael Kerrisk 940c8ce244 getdents.2, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, pthread_setaffinity_np.3, pthread_setschedparam.3, pthread_tryjoin_np.3: Use consistent error-handling function names
Many older pages use a handle_error() macro to do simple
error handling from system and library function calls.
Switch these pages to do similar.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 14:51:13 -05:00
Michael Kerrisk da8dbaa525 fsync.2: Update feature test macro requirements for fsync()
Since glibc 2.8, the fsync() declaration is also exposed if
_POSIX_C_SOURCE >= 200112L

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-07 21:42:33 -05:00
Michael Kerrisk a5a061ee0c clone.2: srcfix: added comment about CLONE_STOPPED going away in glibc 2.8 2008-11-07 21:32:57 -05:00
Michael Kerrisk 9b6ba4d8a4 sched_setscheduler.2: tfix
s/2.6.20/2.6.30/ to fix an earlier typo in the description
of the likely kernel version that will have fully fledged
real-time features.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:27 -05:00
Michael Kerrisk 3ba07ec788 sched_setaffinity.2: SEE ALSO: add sched_getcpu(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:06 -05:00
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 3213bb2813 sched_setaffinity.3: minor: rework EPERM text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 17:06:01 -05:00
Michael Kerrisk a212694364 sched_setaffinity.2: Clarify EINVAL error for cpusetsize < kernel mask size
For sched_setaffinity(), the EINVAL error that occurs
if 'cpusetsize' is smaller than the kernel CPU set size only
occurs with kernels before 2.6.9.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 17:00:02 -05:00
Michael Kerrisk 4187c37c68 sched_setaffinity.2: SEE ALSO: Add pthread_setaffinity_np(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 16:36:45 -05:00
Michael Kerrisk 40bea7025b sched_setaffinity.2: wfix 2008-11-04 13:56:30 -05:00
Michael Kerrisk 89cb804a31 readlink.2: srcfix: Note that bufsiz has a signed type at kernel level
So on a direct syscall, the EINVAL could also occur for bufsiz < 0.
But at the moment, the error text is sufficiently vague
("bufsiz is not positive") that a change to the man page text
is probably not needed.
2008-11-04 11:21:18 -05:00
Sam Varshavchik 344689bd06 pipe.2: wfix: SYNPOSIS: add missing word "int"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 09:16:00 -05:00
Sam Varshavchik 1c32ee471c eventfd.2, mprotect.2, signalfd.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 09:03:49 -05:00
Ulrich Mueller 7c5f05139c open.2: tfix: in CONFORMING TO: s/POSIX.1-2001/POSIX.1-2008/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 08:51:26 -05:00
Michael Kerrisk 1c8de4731b dup.2: wfix 2008-10-30 20:43:16 -05:00
Michael Kerrisk 51d5e556bc umount.2: srcfix: remove out-of-date FIXME 2008-10-30 12:26:25 -05:00
Michael Kerrisk d57b917015 syscalls.2: srcfix: add FIXME 2008-10-30 09:39:46 -05:00
Michael Kerrisk a18e24a14a vfork.2: Child holds parent's memory until execve() or *termination*
The page was phrased in a few places to describe the child as
holding the parent's memory until the child does an execve(2)
or an _exit(2).  The latter case should really be the more
general process termimation (i.e., either _exit(2) or abnormal
termination).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Valdis.Kletnieks@vt.edu
2008-10-30 08:12:12 -05:00
Michael Kerrisk c5571b613b Removed trailing white space at end of lines 2008-10-29 15:43:44 -05:00
Michael Kerrisk 08c9b488f4 timerfd_create.2, ctime.3, frexp.3, strftime.3, strtok.3, tty_ioctl.4, iso_8859-7.7: tstamp 2008-10-29 15:36:12 -05:00
Michael Kerrisk a439142940 open.2: srcfix: add comments re NFS and O_APPEND 2008-10-29 14:54:27 -05:00
Christoph Hellwig 17edb54cdc getdents.2: Fix text relating to DT_UNKNOWN and 'd_type' support
Some file systems provide partial support for 'dt_type',
returning DT_UNKNOWN for cases they don't support.
Update the discussion of 'd_type' and DT_UNKNOWN to
support this.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:26 -05:00
Michael Kerrisk ea45ad970d vfork.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:26 -05:00
Michael Kerrisk f9f812378c vfork.2: minor: Clarify that standards text is current (not a draft).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:26 -05:00
Michael Kerrisk 600c9aa993 vfork.2: grfix 2008-10-29 14:54:26 -05:00
Michael Kerrisk b4dcb33109 vfork.2: Clarify meaning of "child releases the parent's memory"
The man page was not explicit about how the memory used by
the child is released back to the parent.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Halesh S <halesh.s@india.com>
2008-10-29 14:54:26 -05:00
Michael Kerrisk 71b2fb380d getsockopt.2: EINVAL can also occur if 'optval' is invalid
In some cases, EINVAL can occur if 'optval' is invalid.
Note this, and point reader to an example in ip(7).
In response to:
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Christian Grigis <glove@earthling.net>
2008-10-29 14:54:25 -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 9d0cc7117c wait.2: ffix 2008-10-29 14:54:22 -05:00
Michael Kerrisk ecae8a080a getpeername.2, getsockname.2: SEE ALSO: add ip(7) and unix(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:13 -05:00
Michael Kerrisk 44c95a090f stat.2, tsearch.3, tzset.3: wfix: s/SysV/System V/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:12 -05:00
Michael Kerrisk e70c986bd8 sched_yield.2: Add NOTES text on appropriate use of sched_yield()
Strategic calls to sched_yield() can be used to improve
performance, but unnecessary use should be avoided.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:12 -05:00
Michael Kerrisk 7559496c14 sched_yield.2: minor: relocate some text to NOTES
Relocate some text from DESCRIPTION to NOTES.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:12 -05:00
Michael Kerrisk 15eeae41d2 sched_yield.2: Rewrite description in terms of threads
The text formerly described the operation of sched_yield() in
terms of processes.  It should be in terms of threads.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:12 -05:00
Michael Kerrisk 7acf5ebe43 sigaction.2: Clarify that sa_mask affects the *per-thread* signal mask
The page didn't previously clearly explain the scope of the
signal mask that is affected by sa_mask.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:12 -05:00
Michael Kerrisk 03d8058444 sigprocmask.2: tstamp 2008-10-29 14:54:11 -05:00
Michael Kerrisk 92ae39656e sigprocmask.2: Clarify that sigprocmask() operates on a per-thread mask
The first sentence of the page was vague on the scope of the
attribute changed by sigprocmask().  Reword to make this
clearer and add a sentence in NOTES to explicitly state that
the signal mask is a per-thread attribute.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:11 -05:00
Michael Kerrisk 1ee674a478 socket.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 08:18:36 +02:00
Michael Kerrisk 0cc9687dad socketpair.2: Refer to socket(2) for SOCK_CLOEXEC and SOCK_NONBLOCK
Refer the reader to socket(2) for a description of the SOCK_CLOEXEC
and SOCK_NONBLOCK flags, which are supported by socketpair() since
Linux 2.6.27.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:43 +02:00
Michael Kerrisk af14d9f842 socket.2: Document SOCK_NONBLOCK and SOCK_CLOEXEC flags
These flags, specified in the 'type' argument, are supported
since Linux 2.6.27.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:43 +02:00
Michael Kerrisk 51d61866ba inotify_init.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:42 +02:00
Michael Kerrisk 9c9cccf799 epoll_create.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:42 +02:00
Michael Kerrisk 1fadf79b1f signalfd.2: Add signalfd4() details to CONFORMING TO
signalfd4() is also Linux-specific.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:42 +02:00
Michael Kerrisk 8c6e516d64 pipe.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:42 +02:00
Michael Kerrisk e03c5b2c17 dup.2: wfix: remove some crufty text from recent changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:42 +02:00
Michael Kerrisk ef7db4f5b3 inotify_init.2, pipe.2, timerfd_create.2: tfix
s/fcntl ()/fcntl (2)/ in xref

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:42 +02:00