Commit Graph

5571 Commits

Author SHA1 Message Date
Michael Kerrisk 25737f70b7 glibc.7: New link to new libc.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:48 +13:00
Michael Kerrisk 383354a986 libc.7: New page giving brief overview of C libraries on Linux
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:48 +13:00
Michael Kerrisk f9d5bb737b gethostid.3: Before version 2.2, glibc stored the host ID in /var/adm/hostid
Also: rewrite some text describing the /etc/hostid file, so that
this location is referred to just once on the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:48 +13:00
Michael Kerrisk 4c98d1203b gethostid.3: Added ERRORS section describing errors for sethostid()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:48 +13:00
Michael Kerrisk 0482681627 gethostid.3: RETURN VALUE: describe return value of sethostid()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:48 +13:00
Michael Kerrisk 9caf825633 gethostid.3: Minor wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:47 +13:00
Michael Kerrisk 525748e03a gethostid.3: Added BUGS section noting that ID can't be guaranteed to be unique
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:47 +13:00
Michael Kerrisk 963efe88c5 gethostid.3: Update section number to reflect relocation into Section 3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:31 +13:00
Michael Kerrisk a1096a314e sethostid.3: New link to relocated page in Section 3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 07:04:35 +13:00
Michael Kerrisk 8a2d6d4bd3 gethostid.2: New link to new page location in Section 3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 07:03:45 +13:00
Michael Kerrisk 2d1806c94d sethostid.2: Change link to point to new page location in Section 3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 07:02:55 +13:00
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