Retitled subsection "(Un)supported features" to "Sockets API"
This is consistent with the recent change in tcp(7).
+
+
+==================== Changes in man-pages-3.16 ====================
+
+Released: 2009-01-13, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed notes, ideas, or patches that have
+been incorporated in changes in this release:
+
+Colin Watson <cjwatson@ubuntu.com>
+Florentin Duneau <fduneau@gmail.com>
+Petr Baudis <pasky@suse.cz>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+pthread_getcpuclockid.3
+ Michael Kerrisk
+ New page documenting pthread_getcpuclockid(3)
+
+libc.7
+ Michael Kerrisk
+ New page giving brief overview of C libraries on Linux
+
+rtld-audit.7
+ Michael Kerrisk
+ New page documenting dynamic linker auditing API
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+ld.so.8
+ Petr Baudis
+ Document LD_AUDIT
+ Petr Baudis
+ Document LD_POINTER_GUARD
+
+
+New and changed links
+---------------------
+
+gethostid.2
+ Michael Kerrisk
+ New link to new page location in Section 3
+
+sethostid.2
+ Michael Kerrisk
+ Change link to point to new page location in Section 3
+
+sethostid.3
+ Michael Kerrisk
+ New link to relocated page in Section 3
+
+glibc.7
+ Michael Kerrisk
+ New link to new libc.7
+
+
+Global changes
+--------------
+
+syscalls.2
+feature_test_macros.7
+standards.7
+ Michael Kerrisk
+ SEE ALSO: add libc(7)
+
+dlopen.3
+ld.so.8
+ Michael Kerrisk
+ SEE ALSO: add rtld-audit(7)
+
+
+Changes to individual pages
+---------------------------
+
+gethostid.2
+ Michael Kerrisk
+ Move to Section 3
+ The interfaces documented in this page are purely glibc.
+
+syscalls.2
+ Michael Kerrisk
+ Kernel 2.6.28 adds accept4()
+
+clock_getres.3
+ Michael Kerrisk
+ SEE ALSO: Add pthread_getcpuclockid(3)
+
+fmemopen.3
+ Michael Kerrisk
+ Fix VERSIONS information
+
+gethostid.3
+ Michael Kerrisk
+ 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.
+ Michael Kerrisk
+ RETURN VALUE: describe return value of sethostid()
+ Michael Kerrisk
+ Added BUGS section noting that ID can't be guaranteed to be unique
+ Michael Kerrisk
+ Added ERRORS section describing errors for sethostid()
+ Michael Kerrisk
+ Update section number to reflect relocation into Section 3
+
+printf.3
+ Michael Kerrisk
+ 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
+
+readdir.3
+ Michael Kerrisk
+ Rewrite text describing 'dirent' fields standardized in POSIX.1
+ Michael Kerrisk
+ Clarify text for return value/errno setting for end-of-stream case
+
+nscd.8
+ Petr Baudis
+ 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.
+
+
+==================== Changes in man-pages-3.17 ====================
+
+Released: 2009-01-19, Hobart
+
+
+Contributors
+------------
+
+The following people contributed notes, ideas, or patches that have
+been incorporated in changes in this release:
+
+Adeodato Simó <dato@net.com.org.es>
+Bastien ROUCARIES <roucaries.bastien@gmail.com>
+Davide Libenzi <davidel@xmailserver.org>
+Lefteris Dimitroulakis <edimitro@tee.gr>
+Mads Martin Joergensen <mmj@mmj.dk>
+Marc Lehmann <schmorp@schmorp.de>
+Martin (Joey) Schulze <joey@infodrom.org>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Petr Baudis <pasky@suse.cz>
+Sam Varshavchik <mrsam@courier-mta.com>
+Vegard Nossum <vegard.nossum@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+endian.3
+ Michael Kerrisk
+ New page documenting byte order conversion functions
+ Document functions (new in glibc 2.9) for conversion between
+ host byte order and big-/little- endian byte order:
+ htobe16(), htole16(), be16toh(), le16toh(),
+ htobe32(), htole32(), be32toh(), le32toh(),
+ htobe64(), htole64(), be64toh(), le64toh()
+
+getifaddrs.3
+ Petr Baudis
+ New page documenting getifaddrs(3) and freeifaddrs(3)
+ Many edits and changes of Petr's initial draft by mtk
+
+cp1251.7
+ Lefteris Dimitroulakis
+ New page documenting CP 1251 (Windows Cyrillic) character set
+
+iso-8859-10.7
+ Lefteris Dimitroulakis
+ New page documenting ISO 8859-10 character set
+
+iso_8859-13.7
+ Lefteris Dimitroulakis
+ New page documenting ISO 8859-13 character set
+
+iso_8859-14.7
+ Lefteris Dimitroulakis
+ New page documenting ISO 8859-14 character set
+
+iso_8859-3.7
+ Lefteris Dimitroulakis
+ New page documenting ISO 8859-3 character set
+
+iso_8859-5.7
+ Lefteris Dimitroulakis
+ New page documenting ISO 8859-5 character set
+
+iso_8859-8.7
+ Lefteris Dimitroulakis
+ New page documenting ISO 8859-8 character set
+
+koi8-u.7
+ Lefteris Dimitroulakis
+ New page documenting KOI8-U character set
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+epoll.7
+ Michael Kerrisk
+ Document /proc interfaces for limiting kernel memory usage
+ Document the following /proc files that were added in
+ Linux 2.6.28:
+ /proc/sys/fs/epoll/max_user_instances
+ /proc/sys/fs/epoll/max_user_watches
+
+netdevice.7
+ Michael Kerrisk
+ Document recently added interface flags
+ IFF_LOWER_UP (since Linux 2.6.17)
+ IFF_DORMANT (since Linux 2.6.17)
+ IFF_ECHO (since Linux 2.6.25)
+
+ Documentation taken from comments in <linux/if.h>
+
+
+New and changed links
+---------------------
+
+freeifaddrs.3
+ Michael Kerrisk
+ New link to new getifaddrs.3
+
+htobe16.3
+htole16.3
+be16toh.3
+le16toh.3
+htobe32.3
+htole32.3
+be32toh.3
+le32toh.3
+htobe64.3
+htole64.3
+be64toh.3
+le64toh.3
+ Michael Kerrisk
+ New links to new endian.3
+
+iso-8859-10.7
+iso_8859_10.7
+latin6.7
+ Michael Kerrisk
+ New links to new iso_8859-10.7
+
+iso-8859-13.7
+iso_8859_13.7
+latin7.7
+ Michael Kerrisk
+ New links to new iso_8859-13.7
+
+iso-8859-14.7
+iso_8859_14.7
+latin8.7
+ Michael Kerrisk
+ New links to new iso_8859-14.7
+
+iso-8859-3.7
+iso_8859_3.7
+latin3.7
+ Michael Kerrisk
+ New links to new iso_8859-3.7
+
+iso-8859-5.7
+iso_8859_5.7
+ Michael Kerrisk
+ New links to new iso_8859-5.7
+
+iso-8859-8.7
+iso_8859_8.7
+ Michael Kerrisk
+ New links to new iso_8859-8.7
+
+
+Changes to individual pages
+---------------------------
+
+bind.2
+ Michael Kerrisk
+ SEE ALSO: Add getifaddrs(3)
+
+epoll_create.2
+ Michael Kerrisk
+ Document EMFILE error
+ This error is encountered when the limit imposed by
+ /proc/sys/fs/epoll/max_user_instances is encountered.
+ Michael Kerrisk
+ Clarify distinction between epoll instance and epoll file descriptor
+ Reword so that the notion of an epoll instance is made clear,
+ and made distinct from the notion of an epoll file descriptor.
+ Some other minor rewordings also.
+
+epoll_ctl.2
+ Michael Kerrisk
+ Reordered parts of the text
+ Michael Kerrisk
+ Introduce notion of epoll instance
+ Introduce notion of epoll instance as distinct from
+ epoll file descriptor. Plus other wording clean-ups.
+ Michael Kerrisk
+ Document ENOSPC error (new in Linux 2.6.28)
+ This error results when the limit imposed by
+ /proc/sys/fs/epoll/max_user_watches is encountered.
+
+epoll_wait.2
+ Michael Kerrisk
+ Introduce the notion of an epoll instance into text
+
+getdents.2
+ Michael Kerrisk
+ Before kernel < 2.6.4, 'd_type' was effectively always DT_UNKNOWN
+
+gethostid.2
+ Michael Kerrisk
+ Rename file (was misnamed gethostd.2 in previous release)
+
+getsockname.2
+ Michael Kerrisk
+ SEE ALSO: Add getifaddrs(3)
+
+signalfd.2
+ Michael Kerrisk
+ Fix description of fork() semantics
+ The page text described the semantics of the initial
+ implementation of signalfd(). These were changed early on,
+ but the man page wasn't updated.
+
+byteorder.3
+ Michael Kerrisk
+ SEE ALSO: add endian(3)
+
+longjmp.3
+ Michael Kerrisk
+ Clarify wording re saving/restoring signal mask
+ Michael Kerrisk
+ siglongjmp() restores signal mask iff 'savesigs' was non-zero
+ Note that siglongjmp() restores signal mask if, and only
+ if, 'savesigs' argument of sigsetjmp() was non-zero. (Previous
+ text omitted the "and only if".)
+
+memccpy.3
+ Michael Kerrisk
+ Fix CONFORMING TO: s/C99/POSIX.1-2001/
+ Michael Kerrisk
+ If the memory areas overlap, the results are undefined
+
+sethostid.3
+ Michael Kerrisk
+ Rename file (was misnamed sethostd.3 in previous release)
+
+setjmp.3
+ Michael Kerrisk
+ Clarify wording re saving/restoring signal mask
+ Michael Kerrisk
+ Clarify when setjmp() provides BSD vs System V signal mask semantics
+
+strsep.3
+ Michael Kerrisk
+ BUGS: explicitly list problems afflicting strsep()
+ Previously, the page said this function suffered the same
+ problems as strtok(), but in fact strsep() doesn't suffer
+ from all of the same problems as strtok(), so explicitly
+ list just the problems of strsep() in the strsep.3 page.
+
+proc.5
+ Michael Kerrisk
+ Add pointer to epoll(7) for description of epoll /proc files
+
+epoll.7
+ Michael Kerrisk
+ Various wording changes to improve clarity and consistency
+
+
+==================== Changes in man-pages-3.18 ====================
+
+Released: 2009-02-10, Christchurch
+
+
+Contributors
+------------
+
+The following people contributed notes, ideas, or patches that have
+been incorporated in changes in this release:
+
+Andi Kleen <andi@firstfloor.org>
+Bastien ROUCARIES <roucaries.bastien@gmail.com>
+Christian Siebert <christian.siebert@s2000.tu-chemnitz.de>
+Christopher Head <chead@telus.net>
+Florentin Duneau <fduneau@gmail.com>
+Guillem Jover <guillem@debian.org>
+Lefteris Dimitroulakis <edimitro@tee.gr>
+Lucio Maciel <luciofm@gmail.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Mike Frysinger <vapier@gentoo.org>
+Peter Zijlstra <peterz@infradead.org>
+Petr Baudis <pasky@suse.cz>
+Sam Varshavchik <mrsam@courier-mta.com>
+Satyam Sharma <ssatyam@cse.iitk.ac.in>
+Sebastian Kienzl <seb@riot.org>
+Timo Sirainen <tss@iki.fi>
+Vegard Nossum <vegard.nossum@gmail.com>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+armscii-8.7
+ Lefteris Dimitroulakis
+ New page documenting ArmSCII-8 character set
+
+iso_8859-11.7
+ Lefteris Dimitroulakis
+ New page documenting ISO 8859-11 character set
+
+iso_8859-4.7
+ Lefteris Dimitroulakis
+ New page documenting ISO 8859-4 character set
+
+iso_8859-6.7
+ Lefteris Dimitroulakis
+ New page describing ISO 8859-6 character set
+
+pthread_kill.3
+ Michael Kerrisk
+ New page documenting pthread_kill(3)
+
+pthread_kill_other_threads_np.3
+ Michael Kerrisk
+ New page documenting pthread_kill_other_threads_np(3)
+
+pthread_sigmask.3
+ Michael Kerrisk
+ New page documenting pthread_sigmask(3)
+
+
+Newly documented interfaces in existing pages
+---------------------------------------------
+
+clock_getres.3
+ Michael Kerrisk
+ Document CLOCK_MONOTONIC_RAW, new in 2.6.28
+
+
+New and changed links
+---------------------
+
+clock_gettime.2
+clock_settime.2
+clock_getres.3
+clock_gettime.3
+clock_settime.3
+ Michael Kerrisk
+ Update links to reflect the fact that clock_* pages are now in
+ Section 2
+
+iso-8859-11.7
+iso_8859_11.7
+ Michael Kerrisk
+ New links to new iso_8859-11.7
+
+iso-8859-4.7
+iso_8859_4.7
+latin4.7
+ Michael Kerrisk
+ New links to new iso_8859-4.7
+
+iso-8859-6.7
+iso_8859_6.7
+ Michael Kerrisk
+ New links to new iso_8859-6.7
+
+tis-620.7
+ Michael Kerrisk
+ New link to new iso_8859-11.7
+
+
+Global changes
+--------------
+
+clock_nanosleep.2
+getrusage.2
+timerfd_create.2
+clock.3
+clock_getcpuclockid.3
+ftime.3
+pthread_create.3
+pthread_getcpuclockid.3
+pthread_tryjoin_np.3
+sem_wait.3
+time.7
+ Michael Kerrisk
+ Global fix: Fix xrefs to clock_*.? pages to reflect move to section 2
+
+clock_nanosleep.2
+execve.2
+fork.2
+nanosleep.2
+sigaction.2
+timerfd_create.2
+pthread_getcpuclockid.3
+ualarm.3
+usleep.3
+pthreads.7
+time.7
+ Michael Kerrisk
+ Global fix: s/(3)/(2)/ in section number xrefs for timer_*() API
+ The POSIX timers API is implemented (mostly) within the kernel,
+ so thse interfaces are system calls. Although there are as yet
+ no man pages, when they are added they should be in Section 2,
+ not 3. Therefore fix those pages that currently refer to these
+ interfaces as being in Section 3.
+
+
+Changes to individual pages
+---------------------------
+
+capget.2
+ Andi Kleen
+ Add some details and relocate a paragraph
+ While writing a little program using capset
+ I found the capset manpage quite light on crucial
+ details and I had to resort to RTFS.
+
+ This patch improves the points I found unclear
+ and also moves one misplaced paragraph around.
+
+clock_getres.2
+ Michael Kerrisk
+ Move page from Section 3 to Section 2
+
+eventfd.2
+ Michael Kerrisk
+ glibc eventfd() supports the use of eventfd2() since version 2.9
+
+fork.2
+ Michael Kerrisk
+ SEE ALSO: add daemon(3)
+
+getdents.2
+ Michael Kerrisk
+ Remove unneeded HAVE_D_TYPE from example program
+ Since d_type will always just return DT_UNKNOWN before
+ kernel 2.6.4, we don't need to use a conditional for
+ determining whether we use this flag.
+
+nanosleep.2
+ Michael Kerrisk
+ Relocated misplaced BUGS heading
+
+select_tut.2
+ Michael Kerrisk
+ Clean up error checking in example program (no semantic changes)
+ Michael Kerrisk
+ Many parts tidied and rewritten
+ Remove some redundant text, clarify various pieces,
+ tidy example code, etc.
+ Michael Kerrisk
+ Bug fixes + rewrites in example program
+ Sebastien pointed out that the first example program
+ wrongly thinks it can count signals.
+ Also, some further rewrites by mtk.
+
+socket.2
+ Michael Kerrisk
+ BUGS: Remove discussion SOCK_UUCP
+ As time goes on, this sentence becomes less a piece of humor,
+ and more a puzzle.
+
+stat.2
+ Michael Kerrisk
+ Note that open(O_NOATIME) also causes st_atime not to be updated
+
+timerfd_create.2
+ Michael Kerrisk
+ Add BUGS noting that timerfd supports fewer clock types than
+ timer_create()
+
+btowc.3
+ Michael Kerrisk
+ SEE ALSO: add wctob(3)
+
+clock_getcpuclockid.3
+ Michael Kerrisk
+ SEE ALSO: add pthread_getcpuclockid(3)
+
+cos.3
+ Michael Kerrisk
+ SEE ALSO: add sincos(3)
+
+fexecve.3
+ Timo Sirainen
+ Note that fexecve() depends on a mounted /proc
+ See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514043
+ Michael Kerrisk
+ CONFORMING TO: note addition of fexecve() in POSIX.1-2008
+ Michael Kerrisk
+ 'fd' must be opened read-only and refer to a file that is executable
+
+fmemopen.3
+ Michael Kerrisk
+ CONFORMING TO: note that these functions are in POSIX.1-2008
+
+getifaddrs.3
+ Lucio Maciel
+ Fix memory leak in example program
+ Petr Baudis
+ Various small fixes
+
+getpwnam.3
+ Michael Kerrisk
+ SEE ALSO: add getspnam(3)
+
+getumask.3
+ Michael Kerrisk
+ Updated glibc version number in NOTES
+
+ilogb.3
+ Michael Kerrisk
+ SEE ALSO: add significand(3)
+
+intro.3
+ Michael Kerrisk
+ SEE ALSO: add libc(7)
+
+isalpha.3
+ Michael Kerrisk
+ Fix statement that isalpa() is obsolete; should be isascii()
+ http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=512709
+ Michael Kerrisk
+ SEE ALSO: add toascii(3)
+
+mq_notify.3
+ Michael Kerrisk
+ Add cross reference to pthread_attr_init(3)
+
+pthread_attr_setaffinity_np.3
+ Michael Kerrisk
+ SYNOPSIS: Fix declaration of 'attr'
+
+pthread_getcpuclockid.3
+ Michael Kerrisk
+ SYNOPSIS: fix type of 'thread'
+
+qsort.3
+ Michael Kerrisk
+ EXAMPLE: remove unnecessary "#include <unistd.h>"
+
+random.3
+ Michael Kerrisk
+ SEE ALSO: add random_r(3)
+
+remainder.3
+ Michael Kerrisk
+ SEE ALSO: add div(3)
+
+scandir.3
+ Michael Kerrisk
+ CONFORMING TO: alphasort() and scandir() are added to POSIX.1-2008
+ Michael Kerrisk
+ CONFORMING TO: note that versionsort() was added to glibc in
+ version 2.1
+
+sem_wait.3
+ Michael Kerrisk
+ SEE ALSO: add clock_gettime(2)
+
+significand.3
+ Michael Kerrisk
+ Add CONFORMING TO noting that this function is unstandardized
+
+sigwait.3
+ Michael Kerrisk
+ Add EXAMPLES section referring to pthread_sigmask(3)
+
+sin.3
+ Michael Kerrisk
+ SEE ALSO: add sincos(3)
+
+stpcpy.3
+ Michael Kerrisk
+ Add BUGS section noting the possibility of buffer overruns
+ Michael Kerrisk
+ Add missing pieces/fix various problems in example program
+ Michael Kerrisk
+ CONFORMING TO: stpcpy() is nowadays on the BSDs
+ Michael Kerrisk
+ SEE ALSO: add stpcpy.3
+
+wcscasecmp.3
+ Michael Kerrisk
+ CONFORMING TO: note that this function is added in POSIX.1-2008
+
+wcsdup.3
+ Michael Kerrisk
+ CONFORMING TO: note that this function was added in POSIX.1-2008
+
+wcsncasecmp.3
+ Michael Kerrisk
+ CONFORMING TO: note that this function is added in POSIX.1-2008
+
+wctob.3
+ Michael Kerrisk
+ SEE ALSO: add btowc(3)
+
+proc.5
+ Michael Kerrisk
+ Remove mention of epoll/max_user_instances
+ (Since this interface appeared in 2.6.28, and then
+ disappeared in 2.6.29.)
+
+ascii.7
+ Michael Kerrisk
+ Update SEE ALSO list to include pages added in 3.17
+ Michael Kerrisk
+ SEE ALSO: add recently added iso_8859-*(7) pages
+
+epoll.7
+ Michael Kerrisk
+ remove documentation of /proc/sys/fs/epoll/max_user_instances
+ This /proc interface appeared in 2.6.28. but will be
+ removed in 2.6.29.
+
+ Also, document change in default value of
+ /proc/sys/fs/epoll/max_user_watches (was 1/32 of lowmem,
+ now 1/25 of lowmem).
+
+koi8-r.7
+ Michael Kerrisk
+ SEE ALSO: add koi8-u(7); remove crufty text
+
+standards.7
+ Michael Kerrisk
+ Update to note that latest POSIX/SUS was ratified in 2008
+
+time.7
+ Michael Kerrisk
+ SEE ALSO: add pthread_getcpuclockid(3)