Commit Graph

5610 Commits

Author SHA1 Message Date
Michael Kerrisk 1f4f66a924 gethostid.2: Move to Section 3
The interfaces documented in this page are purely glibc.

Reported-by: Colin Watson <cjwatson@ubuntu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 07:00:44 +13:00
Florentin Duneau de90951b73 CPU_SET.3: tfix
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=510507.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-12 23:22:09 +13:00
Michael Kerrisk e0c674cdbb regex.7: minor: Re-instate AUTHOR section, as required by page license. 2009-01-12 23:17:37 +13:00
Michael Kerrisk 40061dbb0b ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-12 22:58:14 +13:00
Petr Baudis 7b0cacbb10 ld.so.8: Document LD_POINTER_GUARD
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-12 22:57:06 +13:00
Petr Baudis 54eb262054 ld.so.8: Document LD_AUDIT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-12 19:10:46 +13:00
Michael Kerrisk 08f8825735 printf.3: Source and destination buffers may not overlap for *s*printf()
http://sourceware.org/bugzilla/show_bug.cgi?id=7075

Some existing code relies on techniques like the following to
append text to a buffer:

    $ cat s.c
    #include <stdio.h>
    char buf[80] = "not ";
    main()
    {
        sprintf(buf, "%sfail", buf);
	puts(buf);
	return 0;
    }

    $ cc s.c
    $ ./a.out
    not fail

However, the standards say the results are undefined if source
and destination buffers overlap, and with suitable compiler
options, recent changes can cause unexpected results:

    $ cc -v 2>&1 | grep gcc
    gcc version 4.3.1 20080507 (prerelease) [gcc-4_3-branch revision 135036] (SUSE Linux)
    $ cc -D_FORTIFY_SOURCE -O2 s.c
    $ ./a.out
    fail

Reported-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-19 11:47:04 -05:00
Petr Baudis 4209865fa4 crypt.3: ffix
Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-19 10:03:18 -05:00
Michael Kerrisk 6a5dd8b393 readdir.3: Clarify text for return value/errno setting for end-of-stream case
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-19 09:36:12 -05:00
Michael Kerrisk 4b3caf6feb readdir.3: Rewrite text describing 'dirent' fields standardized in POSIX.1 2008-12-19 09:00:58 -05:00
Michael Kerrisk 53e819d017 syscalls.2: Kerenl 2.6.28 adds accept4()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 12:32:56 -05:00
Petr Baudis ac7302a628 nscd.8: Correct NOTES section on reloading configuration files
It behaved this way at least since "Sun Oct 18 15:02:11 1998 +0000",
some four months after including the nscd implementation in glibc. But
there does seem to be a short window between glibc-2.1 and glibc-2.1.3
when nscd -i was not available, I don't think it's worth muddling the
point of the page with that, though.

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 12:20:13 -05:00
Petr Baudis 450c838664 dlopen.3: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 12:11:51 -05:00
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