Commit Graph

5747 Commits

Author SHA1 Message Date
Michael Kerrisk 16625773f9 fmemopen.3: Fix VERSIONS information
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Petr Baudis <pasky@suse.cz>
2008-12-06 12:03:31 -05:00
Michael Kerrisk ebfa6f2804 Changes.old: Minor clean ups
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 23:19:15 -05:00
Michael Kerrisk 7d29a946b8 Start of man-pages-3.16: updating Changes and Changes.old 2008-12-05 23:15:25 -05:00
Michael Kerrisk bcd020fb49 Start of man-pages-3.16: updating .Announce and .lsm files 2008-12-05 23:15:25 -05:00
Michael Kerrisk 4c19abbd38 Start of man-pages-3.16: renaming .Announce and .lsm files 2008-12-05 23:15:25 -05:00
Michael Kerrisk 5609cb294a Ready for 3.15 2008-12-05 22:55:03 -05:00
Michael Kerrisk 8ccde1f0a5 Removed trailing white space at end of lines 2008-12-05 22:53:52 -05:00
Michael Kerrisk 58389fa5a7 Expanded tabs 2008-12-05 22:53:36 -05:00
Michael Kerrisk 88596f05a1 Changes: Update for 3.15
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:26 -05:00
Michael Kerrisk d308da3058 pread.2: tfix 2008-12-05 22:47:26 -05:00
Michael Kerrisk 5cedb08f41 bindresvport.3: Fix errors regarding port used, plus other rewrites
Glibc's bindresvport() takes no notice of sin->sin_port:
it always returns an arbitrary reserved port in the
anonymous range (512-1023).  (Reported by Mats Wichmann.)

Also:
* Add EADDRINUSE and EACCES errors.
* Mention use of getsockname(2).
* Other minor rewrites and reorderings of the text.
* Explicitly note that glib's bindresvport() ignores
  sin->sin_port.
* Change license There's now virtually no text remaining from
  the 1.70 version of this page.

Reported-by: Mats Wichmann <mats.d.wichmann@intel.com>
Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com>
Reviewed-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:26 -05:00
Michael Kerrisk 6eb334b2cf bind.2, rcmd.3, capabilities.7, ip.7: Global fix: s/reserved port/privileged port/
Some pages used one term, some pages the other term;
make some consistency.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:26 -05:00
Michael Kerrisk 97aec57c6f setlocale.3, locale.7: Clean up the description of LANGUAGE environment variable
Clean up the $LANGUAGE description, by removing bogus comments
from setlocale(3) and expanding the mention in locale(7).

Maybe you will decide that a more detailed description should be left
to the gettext(3) documentation, but I actually care about the invisible
part of the patch more since the comments have put me off the track
initially ($LANGUAGE has nothing to do with setlocale(3) and is
completely isolated to gettext, as obvious from the glibc sources).

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:25 -05:00
Michael Kerrisk f439817725 dlopen.3: wsfix 2008-12-05 22:47:25 -05:00
Michael Kerrisk 1d2c48b3a7 dlopen.3: ffix 2008-12-05 22:47:25 -05:00
Petr Baudis 27a61e8622 dlopen.3: Describe confusing dladdr() behavior
dladdr() will act unexpectedly if called from non-pic code on a
compile-time-generated function pointer:

    /* test_dladdr.c */

    #define _GNU_SOURCE
    #include <dlfcn.h>
    #include <stdio.h>

    int
    main(void)
    {
        void *func;
        Dl_info info = {};

        func = printf;
        dladdr(func, &info);
        printf("%s at %p resolved from %s\n", info.dli_sname,
                func, info.dli_fname);

        return 0;
    }

    $ cc test_dladdr.c -ldl
    $ ./a.out
    printf at 0x804838c resolved from ./a.out
    $ cc -fPIC test_dladdr.c -ldl
    $ ./a.out
    _IO_printf at 0xb7f71c30 resolved from /lib/libc.so.6

In the long term, it might make sense to make dladdr() recognize
plt pointers and recurse, but I'm too afraid of Ulrich ;-)
(and he seems to be heavy proponent of pic code anyway, so
the chances for that to be accepted probably aren't high).

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:25 -05:00
Michael Kerrisk dcaec854fe syslog.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:25 -05:00
Michael Kerrisk 03d5ef0d71 signal.2: grfix 2008-12-05 22:47:24 -05:00
Michael Kerrisk a3680fde95 setfsgid.2, setfsuid.2: Simplify version information and move to a VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:24 -05:00
Michael Kerrisk 8b98e6fc31 select.2: Rewrote text describing feature test macro requirements for pselect()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:24 -05:00
Michael Kerrisk 21c39e5919 select_tut.2: Fix SHUT_FD* macros in example program
Add "do {} while (0)"

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:24 -05:00
Michael Kerrisk 54781a2395 select_tut.2: wsfix in example program 2008-12-05 22:47:24 -05:00
Michael Kerrisk 5af0d2f5d3 pread.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:23 -05:00
Michael Kerrisk d95f2e31bd mq_getsetattr.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:23 -05:00
Michael Kerrisk 12bbec1b16 getsid.2: Simplified version information and moved to a new VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:23 -05:00
Michael Kerrisk 8461e2c703 memmem.3: Remove sentence saying that libc 5.0.9 is still widely used
That was a *long* time ago.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:23 -05:00
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