From mboxrd@z Thu Jan 1 00:00:00 1970 From: walter harms Subject: Re: man-pages-3.56 released Date: Wed, 15 Jan 2014 11:04:54 +0100 Message-ID: <52D65D46.10301@bfs.de> References: <52D18F23.3060105@gmail.com> Reply-To: wharms-fPG8STNUNVg@public.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: QUOTED-PRINTABLE Return-path: In-Reply-To: <52D18F23.3060105-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> Sender: linux-man-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: "Michael Kerrisk (man-pages)" Cc: "linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org" List-Id: linux-man@vger.kernel.org hi, i send a few new pages and one fix that is missing here at 08.10.2013 any particular reason why they are not included ? re, wh Am 11.01.2014 19:36, schrieb Michael Kerrisk (man-pages): > Gidday, >=20 > The Linux man-pages maintainer proudly announces: >=20 > man-pages-3.56 - man pages for Linux >=20 > Tarball download: > http://www.kernel.org/doc/man-pages/download.html > Git repository: > https://git.kernel.org/cgit/docs/man-pages/man-pages.git/ > Online changelog: > http://man7.org/linux/man-pages/changelog.html#release_3.56 >=20 > A short summary of the release is blogged at: > http://linux-man-pages.blogspot.com/2014/01/man-pages-356-is-released= =2Ehtml >=20 > The current version of the pages is browsable at: > http://man7.org/linux/man-pages/ >=20 > You are receiving this message either because: >=20 > a) You contributed to the content of this release. >=20 > b) You are subscribed to linux-man-u79uwXL29TaiAVqoAR/hOA@public.gmane.org >=20 > c) I have information (possibly inaccurate) that you are the maintain= er > of a translation of the manual pages, or are the maintainer of the > manual pages set in a particular distribution, or have expressed > interest in helping with man-pages maintenance, or have otherwise > expressed interest in being notified about man-pages releases. > If you don't want to receive such messages from me, or you know of > some other translator or maintainer who may want to receive such > notifications, send me a message. >=20 > Cheers, >=20 > Michael >=20 >=20 > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Changes = in man-pages-3.56 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D >=20 > Released: 2014-01-11, Christchurch >=20 > In memory of Doris Church (1939-2013) >=20 >=20 > Contributors > ------------ >=20 > The following people contributed patches/fixes or (noted in brackets > in the changelog below) reports, notes, and ideas that have been > incorporated in changes in this release: >=20 > Andre Majorel > Arif Zaman > Bert Wesarg > Daniel Borkmann > David Malcolm > David Pr=C3=A9vot > Dongsheng Song > Elie De Brauwer > James Smith > Janne Blomqvist > Joseph S. Myers > Luke Hutchison > Marco Dione > Mathieu Desnoyers > Mathieu Malaterre > Matthias Klose > Michael Kerrisk > Mike Frysinger > Moritz 'Morty' Str=C3=BCbe > Nadav Har'El > Ond=C5=99ej B=C3=ADlka > Pr=C3=A1draig Brady > Peng Haitao > Raphael Geissert > Shawn Landden > Simon Paillard > Stephen Kell > Sudhanshu Goswami > Sworddragon2 > Vince Weaver > Willem de Bruijn > Yuri Kozlov >=20 > Apologies if I missed anyone! >=20 >=20 > New and rewritten pages > ----------------------- >=20 > fgetc.3 > gets.3 > David Malcolm > Split gets(3) to isolate unsafe gets(3) to a page on its own > Currently man3/gets.3 documents various safe I/O function= s, along > with the toxic "gets" function. >=20 > At the risk of being melodramatic, this strikes me as aki= n to > storing rat poison in a food cabinet, in the same style o= f > packaging as the food, but with a post-it note on it sayi= ng > "see warnings below". >=20 > I think such "never use this" functions should be quarant= ined > into their own manpages, rather than listing them alongsi= de > sane functions. >=20 > The attached patch does this for "gets", moving the docum= entation > of the good functions from man3/gets.3 into man3/fgetc.3, > updating the SO links in the relevant functions to point = at the > latter. >=20 > It then rewrites man3/gets.3 to spell out that "gets" is = toxic > and should never be used (with a link to CWE-242 for good > measure). > Michael Kerrisk [Andre Majorel] > Tweaks to David Malcolm's patch >=20 > vdso.7 > Mike Frysinger > New page documenting the vDSO mapped into each process by the= kernel >=20 >=20 > Newly documented interfaces in existing pages > --------------------------------------------- >=20 > reboot.2 > Elie De Brauwer > Document LINUX_REBOOT_SW_SUSPEND >=20 >=20 > New and changed links > --------------------- >=20 > fgets.3 > getc.3 > getchar.3 > ungetc.3 > Michael Kerrisk > Adjust links to gets(3) to point to fgetc(3) >=20 >=20 > Global changes > -------------- >=20 > Various pages > Michael Kerrisk > Global fix of "NULL pointer" > Change "NULL pointer" to "NULL" or null pointer". > POSIX uses the term "null pointer", not "NULL pointer". >=20 > Various pages > Michael Kerrisk > Stylistic changes to code example > For ease of reading, don't embed assignments inside if(). >=20 > Various pages > Michael Kerrisk > Replace uses of "i.e.," in main text with "that is" or simila= r > Usual man-pages style is to use "i.e." only within > parenthetical expressions. >=20 > Various pages > Michael Kerrisk > Replace uses of "e.g." in main text with "for example" or sim= ilar > Usual man-pages style is to use "e.g." only within > parenthetical expressions. >=20 > Various pages > Michael Kerrisk > Add "Program source" subheading under EXAMPLE >=20 > Various pages > Michael Kerrisk > Add "static" to global variables and functions in example pro= gram >=20 >=20 > Changes to individual pages > --------------------------- >=20 > clock_getres.2 > Michael Kerrisk [Nadav Har'El] > Improve description of CLOCK_PROCESS_CPUTIME_ID > See https://bugzilla.kernel.org/show_bug.cgi?id=3D67291 >=20 > close.2 > Michael Kerrisk [P?draig Brady] > Note that errors from close() should be used only for diagnos= is > In particular, retrying after EINTR is a bad idea. >=20 > See http://austingroupbugs.net/view.php?id=3D529 >=20 > See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37= 702 > Subject: [RFC][BZ #14627] Make linux close errno to EINPR= OGRESS > when interrupted in signal. >=20 > execve.2 > Michael Kerrisk [Marco Dione] > Add further cases to EFAULT error > See https://sourceware.org/bugzilla/show_bug.cgi?id=3D164= 02 >=20 > perf_event_open.2 > Vince Weaver [Sudhanshu Goswami] > Clarify issues with the disabled bit > Clarify the perf_event_open behavior with respect to the = disabled > bit and creating event groups. > Vince Weaver [Sudhanshu Goswami] > Clarify issues with the exclusive bit > Warn that using the perf_event_open "exclusive" bit, whil= e > it might seem like a good idea, might lead to all 0 resul= ts > in some common usage cases. >=20 > reboot.2 > Elie De Brauwer > Mention RB_POWER_OFF > The manpage did not mention RB_POWER_OFF which is the gli= bc > symbolic name for LINUX_REBOOT_CMD_POWER_OFF. >=20 > $ cd /usr/include > $ cat x86_64-linux-gnu/sys/reboot.h | grep POWER_OFF > define RB_POWER_OFF 0x4321fedc > Elie De Brauwer > Add "Linux" to kernel version numbers > Michael Kerrisk > Add RB_SW_SUSPEND synonym > Michael Kerrisk > Add RB_KEXEC synonym >=20 > setpgid.2 > Michael Kerrisk [Joseph S. Myers] > BSD getpgrp() and setpgrp() go away in glibc 2.19 > socket.2 > Michael Kerrisk [Dongsheng Song] > Remove crufty statement that AF_INET does not support SOCK_SE= QPACKET > Linux AF_INET supports SOCK_SEQPACKET via SCTP. >=20 > syscall.2 > Mike Frysinger > Fix ia64 registers > The original list of registers was created by confusing s= trace > source code--this is for parsing legacy 32-bit code (whic= h is > dead and no one cares). Update the list to reflect native= ia64 > syscall interface. >=20 > syscall.2 > syscalls.2 > getauxval.3 > Mike Frysinger > Add references to new vdso(7) page >=20 > utimensat.2 > Michael Kerrisk > Small wording improvement for times!=3DNULL case >=20 > dlopen.3 > Michael Kerrisk [Mike Frysinger] > Update remarks on cast needed when assigning dlsym() return v= alue > POSIX.1-2013 eases life when casting the dlsym() return v= alue to a > function pointer > Michael Kerrisk [Stephen Kell] > Fix description of dli_sname > See https://sourceware.org/bugzilla/show_bug.cgi?id=3D162= 62 >=20 > getline.3 > Michael Kerrisk [Luke Hutchison] > Correct description of how '*n' is used when '*lineptr' =3D=3D= NULL > See https://sourceware.org/bugzilla/show_bug.cgi?id=3D546= 8 > Michael Kerrisk > Remove SEE ALSO reference to unsafe gets(3) >=20 > mcheck.3 > Simon Paillard [Raphael Geissert] > typo in compiler flag > See http://bugs.debian.org/732464 >=20 > mkstemp.3 > Michael Kerrisk [Janne Blomqvist] > Better describe 'flags' that can be specified for mkostemp() >=20 > printf.3 > Michael Kerrisk [Arif Zaman] > Fix memory leak in snprintf() example > See http://stackoverflow.com/questions/19933479/snprintf-= man-page-example-memory-leak >=20 > pthread_kill.3 > Michael Kerrisk [Mathieu Desnoyers] > POSIX.1-2008 removes ESRCH > POSIX.1-2001 mistakenly documented an ESRCH error, and > POSIX.1-2008 removes this error. Glibc does return > this error in cases where it can determine that a thread = ID > is invalid, but equally, the use of an invalid thread ID > can cause a segmentation fault. >=20 > puts.3 > Michael Kerrisk > SEE ALSO: replace reference to gets(3) with fgets(3) >=20 > scanf.3 > Michael Kerrisk [Ond=C5=99ej B=C3=ADlka] > Improve discussion of obsolete 'a' dynamic allocation modifie= r >=20 > setjmp.3 > Michael Kerrisk [Joseph S. Myers] > BSD setjmp() semantics go away in glibc 2.19 >=20 > sigpause.3 > Michael Kerrisk [Joseph S. Myers] > BSD sigpause() goes away in glibc 2.19 > Michael Kerrisk > Correct feature text macro requirements > Peng Haitao > ATTRIBUTES: Note function that is thread-safe > The function sigpause() is thread safe. >=20 > sigqueue.3 > Peng Haitao > ATTRIBUTES: Note function that is thread-safe > The function sigqueue() is thread safe. >=20 > sigwait.3 > Peng Haitao > ATTRIBUTES: Note function that is thread-safe > The function sigwait() is thread safe. >=20 > sin.3 > Peng Haitao > ATTRIBUTES: Note functions that are thread-safe > The functions sin(), sinf() and sinl() are thread safe. >=20 > sincos.3 > Peng Haitao > ATTRIBUTES: Note functions that are thread-safe > The functions sincos(), sincosf() and sincosl() are threa= d safe. >=20 > string.3 > Moritz 'Morty' Str=C3=BCbe > Add short description of the functions > It is helpful to have a short description about what the = different > functions in string.h do. > Michael Kerrisk > Fixes and enhancements to Moritz Str=C3=BCbe's patch >=20 > strptime.3 > Michael Kerrisk [Mathieu Malaterre, Simon Paillard] > Add number ranges to comments in 'tm' structure > See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=3D72= 9570 > Michael Kerrisk > Point to ctime(3) for more details on 'tm' structure > Michael Kerrisk > Some rewording and reorganization >=20 > strsep.3 > Michael Kerrisk > Clarify description > The use of "symbols" in the existing description is confu= sing; > it's "bytes". Other fixes as well. >=20 > strspn.3 > Michael Kerrisk [Mathieu Malaterre] > Improve description in NAME > See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=3D72= 3659 >=20 > strstr.3 > Michael Kerrisk > Clarify RETURN VALUE: s/substring/located substring/ >=20 > sysv_signal.3 > Peng Haitao > ATTRIBUTES: Note function that is thread-safe > The function sysv_signal() is thread safe. >=20 > tan.3 > Peng Haitao > ATTRIBUTES: Note functions that are thread-safe > The functions tan(), tanf() and tanl() are thread safe. >=20 > tanh.3 > Peng Haitao > ATTRIBUTES: Note functions that are thread-safe > The functions tanh(), tanhf() and tanhl() are thread safe= =2E >=20 > toascii.3 > Peng Haitao > ATTRIBUTES: Note function that is thread-safe > The function toascii() is thread safe. >=20 > toupper.3 > Peng Haitao > ATTRIBUTES: Note functions that are thread safe with exceptio= ns > The functions toupper() and tolower() are thread safe wit= h > exceptions. >=20 > towctrans.3 > Peng Haitao > ATTRIBUTES: Note function that is thread-safe > The function towctrans() is thread safe. >=20 > towlower.3 > Peng Haitao > ATTRIBUTES: Note function that is thread safe with exceptions > The function towlower() is thread safe with exceptions. >=20 > towupper.3 > Peng Haitao > ATTRIBUTES: Note function that is thread safe with exceptions > The function towupper() is thread safe with exceptions. >=20 > ualarm.3 > Peng Haitao > ATTRIBUTES: Note function that is thread-safe > The function ualarm() is thread safe. >=20 > wcpncpy.3 > Peng Haitao > ATTRIBUTES: Note function that is thread-safe > The function wcpncpy() is thread safe. >=20 > proc.5 > Michael Kerrisk [Sworddragon2] > Fix formula for CommitLimit under /proc/meminfo > See https://bugzilla.kernel.org/show_bug.cgi?id=3D60991 >=20 > credentials.7 > Michael Kerrisk > List APIs that operate on process groups > Michael Kerrisk > Add details on controlling terminal and foreground/background= jobs >=20 > feature_test_macros.7 > Michael Kerrisk > Document _DEFAULT_SOURCE > Michael Kerrisk [Joseph S. Myers] > From glibc 2.19, _BSD_SOURCE no longer causes __FAVOR_BSD > Starting with glibc 2.19, _BSD_SOURCE no longer causes BS= D > definitions to be favored in cases where standards confli= ct. >=20 > libc.7 > Mike Frysinger > SEE ALSO: add various entries >=20 > man-pages.7 > Michael Kerrisk [Mike Frysinger] > Add STYLE GUIDE section > Incorporate some of the existing material in the page > into the STYLE GUIDE, and add a lot more material, mainly > drawn from the "Global changes" sections in the release > changelogs. > Michael Kerrisk > Add historical note on reason for use of American spelling > Michael Kerrisk [Mike Frysinger] > Various improvements to style guide >=20 > packet.7 > Willem de Bruijn [Daniel Borkmann] > Document fanout, ring, and auxiliary options > This patch adds descriptions of the common packet socket = options > PACKET_AUXDATA, PACKET_FANOUT, PACKET_RX_RING, PACKET_S= TATISTICS, > PACKET_TX_RING > and the ring-specific options > PACKET_LOSS, PACKET_RESERVE, PACKET_TIMESTAMP, PACKET_V= ERSION > Michael Kerrisk > Add kernel version numbers for PACKET_VERSION and PACKET_TIME= STAMP >=20 > ld.so.8 > Michael Kerrisk [Matthias Klose] > Default output file for D_DEBUG is stderr not stdout > See https://sourceware.org/bugzilla/show_bug.cgi?id=3D687= 4 >=20 >=20 -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org More majordomo info at http://vger.kernel.org/majordomo-info.html