Commit Graph

5255 Commits

Author SHA1 Message Date
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
Michael Kerrisk 40c75945ad epoll.7: Add error handling for epoll_wait() call in example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 10:59:13 -05:00
Michael Kerrisk 15277745c3 epoll.7: Fix error handling after accept() in example code
Simply continuing after an error is in most cases wrong,
and can lead to infinite loops (e.g., for EMFILE).
So handle an error by terminating.

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Olaf van der Spek <olafvdspek@gmail.com>
2008-11-04 10:58:58 -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
Sam Varshavchik 5b4e617fa4 pthread_tryjoin_np.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 09:00:41 -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 66132b5e47 epoll.7: Improve example code
Fill in some gaps in example code (variable declarations,
adding listening socket to epoll set).
Give variables more meaningful names.
Other minor changes.

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Olaf van der Spek <OlafvdSpek@gmail.com>
2008-11-01 14:30:05 -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
Lefteris Dimitroulakis 289bb92874 iso_8859-7.7: Add characters for Drachma and Greek Ypogegrammeni
Lines for these two characters were added in the previous patch,
but the actual characters were not included in the 4th column
of the table.  This fixes that.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-30 11:08:19 -05:00
Michael Kerrisk 257f73f262 pthread_exit.3: BUGS: thread group with a dead leader and stop signals
Document the bug that can occur when a stop signal
is sent to a thread group whose leader has terminated.
http://thread.gmane.org/gmane.linux.kernel/611611
http://marc.info/?l=linux-kernel&m=122525468300823&w=2

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Bert Wesarg <bert.wesarg@googlemail.com>
2008-10-30 10:56:59 -05:00
Michael Kerrisk d57b917015 syscalls.2: srcfix: add FIXME 2008-10-30 09:39:46 -05:00
Michael Kerrisk cc378aa6ab Changes.old: wspfix 2008-10-30 09:35:18 -05:00
Michael Kerrisk 9ee629ff75 Changes.old: Add Contributors to 3.12 Changelog
I forgot to do this before the 3.12 release.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-30 08:47:52 -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 dd68f56461 Changes.old: Reformat 3.11 Changelog entries
To be consistent with format used in 3.12 changelog (and beyond)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 21:09:46 -05:00
Michael Kerrisk cac193ff17 Start of man-pages-3.13: updating Changes and Changes.old 2008-10-29 20:52:10 -05:00
Michael Kerrisk 3a7507b9d8 Start of man-pages-3.13: updating .Announce and .lsm files 2008-10-29 20:52:10 -05:00
Michael Kerrisk 16a1f10062 Start of man-pages-3.13: renaming .Announce and .lsm files 2008-10-29 20:52:10 -05:00
Michael Kerrisk f561870f72 Ready for 3.12 2008-10-29 15:44:36 -05:00
Michael Kerrisk c5571b613b Removed trailing white space at end of lines 2008-10-29 15:43:44 -05:00
Michael Kerrisk 668ec2fef5 Expanded tabs 2008-10-29 15:43:33 -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 ae8aa0f501 Changes: Update Changelog for 3.12 release
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 15:31:20 -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 2250b3eea5 readdir.3: Fix text relating to DT_UNKNOWN and 'd_type' support
(This mirrors the previous change to getdents.2)
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: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 a87c4a1da3 getaddrinfo.3: Clarify error descriptions with some examples
Clarify the description of some errors by giving examples
that produce the errors.  (Text added for EAI_SERVICE and
EAI_SOCKTYPE.)

Also, add an error case for EAI_BADFLAGS.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: J.H.M. Dassen (Ray) <fsmla@xinara.org>
2008-10-29 14:54:26 -05:00
Lefteris Dimitroulakis ebc15016f1 iso_8859-7.7: Add Drachma, Euro, and Greek Ypogegrammeni
Also, amend description of characters 0241 and 0242.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:25 -05:00
Jason Spiro 9031fc7ae5 strcpy.3: Strengthen warning about checking against buffer overruns
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=413940

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:25 -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 6dd5c68a3d ip.7: Detail EINVAL error for IP_ADD_MEMBERSHIP socket option
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 213bea670e getaddrinfo.3: minor: Add subheadings to EXAMPLE programs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk b522208e56 err.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk e05ccae540 encrypt.3: minor: remove mention of glibc version from EXAMPLE
The relevant text applies to any version of glibc,
so the version number is not needed.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk f91bef833f div.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk a831ef971d frexp.3, strftime.3, strtok.3: Global fix: relocate shell session above example program
Move the shell session text that demonstrates the use of
the example program so that it precedes the actual
example program.  This makes the page consistent with the
majority of other pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -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 7e1d89c9b2 man-pages.7: spfix 2008-10-29 14:54:23 -05:00
Michael Kerrisk b8463199bb man-pages.7: Example shell sessions should have user input boldfaced
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:23 -05:00