Commit Graph

5621 Commits

Author SHA1 Message Date
Michael Kerrisk 6a02322941 memmem.3: grfix wfix 2008-12-05 22:47:23 -05:00
Michael Kerrisk f84addeb7f memmem.3: ffix 2008-12-05 22:47:23 -05:00
Michael Kerrisk 4f9ea6c361 fmemopen.3: minor: wording tweak
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:22 -05:00
Michael Kerrisk 99111b7580 fmemopen.3: ffix 2008-12-05 22:47:22 -05:00
Petr Baudis 8a4051693d open_wmemstream.3: New link to fmemopen.3
fmemopen.3 now documents open_wmemstream().

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:22 -05:00
Michael Kerrisk 45906a480f fmemopen.3: Add VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:22 -05:00
Petr Baudis 3a0f269da2 fmemopen.3: Add description of open_wmemstream(3)
Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:21 -05:00
Petr Baudis 00269a5a24 getaddrinfo.3: Document results ordering and /etc/gai.conf
This patch documents the order of the getaddrinfo(3) results
(RFC 3484), how should the application deal with that,
mentions the extremely common cause of having multiple
results per query (both IPv4 and IPv6 addresses available)
and mentions /etc/gai.conf.

(mtk: Minor tweaks, and note glibc version for /etc/gai.conf)

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:21 -05:00
Petr Baudis a2f86747f1 fopencookie.3: fopencookie() needs _GNU_SOURCE feature test macro
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:21 -05:00
Petr Baudis 5f0aa64a2e fopen.3: SEE ALSO: Add fmemopen(3) and fopencookie(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:21 -05:00
Petr Baudis da607ba120 fmemopen.3: SEE OPEN: Add fopencookie(3)
fopencookie(3) is used to implement fmemopen().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk 2656acee7d atexit.3: Calling exit(3) more than once produces undefined results
If an exit handler itself calls exit(3), the results are
undefined (see the POSIX.1-2001 specification of exit(3)).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk db217984ec atexit.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk ee394477fa atexit.3: The same exit handler may be registered multiple times
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk 41bf770ca3 atexit.3: Calling _exit(2) terminates processing of exit handlers
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:20 -05:00
Michael Kerrisk 374b9a8f7b atexit.3: atexit() and on_exit(3) register functions on the same list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk 84fc5566f5 atexit.3: Terminating registered function using longjmp() is undefined
According to POSIX.1, using longjmp() to terminate execution of
a function registered using atexit() produces undefined results.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk 7c298e468d atexit.3: Terminating registered function using longjmp() is undefined
According to POSIX.1, using longjmp() to terminate execution of
a function registered using atexit() produces undefined results.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk d8437814df on_exit.3: Arg given to registered function is status from *last* call to exit()
It's a subtle point, but if a registered function itself
calls exit(3), then subsequent functions that were registered
with on_exit(3) will see the exit status given to the more
recent exit(3) call.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk 36a0cc2596 on_exit.3: Document handling of registrations on fork(2) and execve(2)
Treatment in these cases is the same as for atexit(3).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:19 -05:00
Michael Kerrisk 6a275cde4d on_exit.3: Note that same function may be registered multiple times
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:18 -05:00
Michael Kerrisk 22a33e86af envz_add.3, wordexp.3: wsfix 2008-12-05 22:47:18 -05:00
Michael Kerrisk 5e4dc2691b open.2, stat.2: tfix s/_FILE_OFF_SET_BITS/_FILE_OFFSET_BITS/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Chris Heath <chris@heathens.co.nz>
2008-12-05 22:47:18 -05:00
Michael Kerrisk ccf11468bd time.7: SEE ALSO: add clock_gettime(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Pavel Machek <pavel@suse.cz>
2008-12-05 22:47:18 -05:00
Michael Kerrisk 9dcc46058a stat.2: Document EOVERFLOW error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Andre Majorel <aym-xunil@teaser.fr>
2008-12-05 22:47:18 -05:00
Michael Kerrisk 7c7fb55221 open.2: EFBIG error is now EOVERFLOW (since Linux 2.6.24)
When a 32-bit app opens a file whose size is too big to be
represented in 31-bits, POSIX.1 specifies the error EOVERFLOW.
Linux used to give EFBIG for this case, but 2.6.24 fixed this.

Also, add some text to describe the error scenario in
more detail.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:18 -05:00
Michael Kerrisk fecaa19a28 accept.2: Reorder ERRORS list
Some errors were listed under a separate "may" heading.
There's probably no real need to do this; integrate
those errors into the main list.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:17 -05:00
Michael Kerrisk 9baab2ae47 accept4.2: New link to accept.2
accept.2 now documents the new accept4() system call.
2008-12-05 22:47:17 -05:00
Michael Kerrisk 6f74cfbb4b accept.2: Document accept4() system call, new in Linux 2.6.28 2008-12-05 22:47:17 -05:00
Michael Kerrisk df4ab0f63f pthread_cleanup_pop_restore_np: New link to new pthread_cleanup_push_defer_np.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:17 -05:00
Michael Kerrisk f06b4f5c47 pthread_cleanup_push_defer_np.3: New page for pthread_cleanup_push_defer_np(3) and pthread_cleanup_pop_restore_np(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:01 -05:00
Michael Kerrisk cc883662a3 uname.2: DESCRIPTION: Point reader at NOTES for further info on field lengths
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Rob Landley <rob@landley.net>
2008-12-05 22:29:01 -05:00
Michael Kerrisk 5892dcdae4 ddp.7: ffix 2008-12-05 22:29:00 -05:00
Michael Kerrisk d91ca9d3b7 fifo.7: minor: note that "ls -l" indicates FIFOs with the file type 'p'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00
Michael Kerrisk 46c0fadf3a remove.3: Minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00
Michael Kerrisk 0c637bbd95 isatty.3: ffix wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00
Michael Kerrisk fac9854624 isatty.3: Complete rewrite of this page, with rather more detail
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00
Michael Kerrisk 3e4088f4a4 getpeername.2, getsockname.2, getsockopt.2, recv.2, send.2, shutdown.2: minor s/s/sockfd/ for cases not caught in previous changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:59 -05:00
Michael Kerrisk 75c5960113 shutdown.2: wfix 2008-12-05 22:28:59 -05:00
Michael Kerrisk 710631e8bf setup.2: Relocate some CONFORMING TO text to VERSIONS and NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:59 -05:00
Michael Kerrisk 97fce6cd66 setsid.2: Rework RETURN VALUE section; add an ERRORS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:59 -05:00
Michael Kerrisk b56905c62b send.2: wfix (s/s/sockfd/ for a case missed earlier) 2008-12-05 22:28:59 -05:00
Michael Kerrisk 167441ee0b send.2: Minor layout fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:59 -05:00
Michael Kerrisk 6926dbf541 recv.2, send.2: Make names of "address" and "address length" args more consistent
Make the names of these arguments more consistent with other
sockets man pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:58 -05:00
Michael Kerrisk a2b8b6d657 connect.2, getpeername.2, getsockname.2: Use consistent argument names
Most other sockets pages are using the names 'addr'
and 'addrlen'; make these pages do the same.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:58 -05:00
Michael Kerrisk f7c494fb23 getsockname.2: Note that returned address is truncated if buffer is too small
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:58 -05:00
Michael Kerrisk cb15903860 getpeername.2: Note that returned address may be truncated if buffer is too small
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00
Michael Kerrisk 59682186ca recv.2: Clarify details when returned address is truncated
If the recvfrom() returned address is truncated, the 'fromlen'
argument indicates the actual size of the address, rather than
a count of the number of bytes in the truncated buffer.

Also clarify that the 'from' argument can be NULL, in which
case 'fromlen' should is unused, and should also be NULL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00
Michael Kerrisk b98353f035 accept.2: Clarify details when returned address is truncated
If the returned address is truncated, the 'addrlen' argument
indicates the actual size of the address, rather than a count
of the number of bytes in the truncated buffer.

Also clarify that if 'addr' argument is NULL, then 'addrlen'
should is unused, and should also be NULL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00
Michael Kerrisk 3fdfdab83c getsockopt.2: Minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00