-==================== Changes in man-pages-3.38 ====================
+==================== Changes in man-pages-3.68 ====================
-Released: 2012-03-25, Christchurch
+Released: 2014-05-28, Munich
+Alastair McKinstry <mckinstry@computer.org>
+Carsten Grohmann <carstengrohmann@gmx.de>
+Colin Williams <colinwilliams1968@gmail.com>
+Heinrich Schuchardt <xypron.glpk@gmx.de>
+Lars Wirzenius <liw@iki.fi>
+Marko Myllynen <myllynen@redhat.com>
+Michael Kerrisk <mtk.manpages@gmail.com>
+Peng Haitao <penght@cn.fujitsu.com>
+Rasmus Villemoes <rv@rasmusvillemoes.dk>
+Richard Braakman <richard.braakman@jollamobile.com>
+Simon Paillard <spaillard@debian.org>
Contributors
------------
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Akihiro MOTOKI <amotoki@gmail.com>
-Artyom Pervukhin <artyom@evasive.ru>
-Beňas Petr <xbenas00@stud.fit.vutbr.cz>
-Ben Bacarisse <software@bsb.me.uk>
-Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
-David Prévot <david@tilapin.org>
-Denis Barbier <bouzim@gmail.com>
-Denys Vlasenko <vda.linux@googlemail.com>
-Eric Blake <ebb9@byu.net>
-Iain Fraser <iainkfraser@gmail.com>
-Justin T Pryzby <justinp@norchemlab.com>
-Kirill Brilliantov <brilliantov@inbox.ru>
-Mark R Bannister <mark@proseconsulting.co.uk>
-Matthew Gregan <kinetik@flim.org>
-Michael Kerrisk <mtk.manpages@gmail.com>
-Nix <nix@esperi.org.uk>
-Peter Schiffer <pschiffe@redhat.com>
-Sergei Zhirikov <sfzhi@yahoo.com>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
-get_nprocs_conf.3
- Beňas Petr
- New page documenting get_nprocs_conf(3) and get_nprocs(3)
- Michael Kerrisk
- Some additions and improvements
-
-malloc_get_state.3
- Michael Kerrisk
- New page documenting malloc_get_state(3) and malloc_set_state(3)
-
-mallopt.3
- Michael Kerrisk
- New man page for mallopt(3)
-
-mtrace.3
- Michael Kerrisk
- Complete rewrite of page, adding much more detail
-
-scandirat.3
- Mark R Bannister
- New page for scandirat(3) (new in glibc 2.15)
-
-
-Newly documented interfaces in existing pages
----------------------------------------------
-
-posix_memalign.3
- Michael Kerrisk
- Document aligned_alloc(3)
- aligned_alloc() is new in C11.
- Michael Kerrisk
- Document pvalloc(3)
-
-qsort.3
- Mark R Bannister
- Add documentation of qsort_r(3)
- Ben Bacarisse
- Improvements to Mark R Bannister's qsort_r() patch
- Michael Kerrisk
- Add VERSIONS section for qsort_r()
+localedef.1
+ Marko Myllynen [Richard Braakman, Alastair McKinstry, Lars Wirzenius]
+ New page for localedef(1)
+ Add new page based on Debian localedef(1) page.
New and changed links
---------------------
-aligned_alloc.3
- Michael Kerrisk
- New link to posix_memalign.3
-
-get_nprocs.3
- Beňas Petr
- Link to new get_nprocs_conf.3 page
+procfs.5
+ New link to proc.5
+ Since the term "procfs" is widely used, it seems reasonable to have
+ a link from that name to proc(5).
-malloc_set_state.3
- Michael Kerrisk
- Link to new malloc_get_state.3 page
-
-pvalloc.3
- Michael Kerrisk
- New link to posix_memalign.3
+Changes to individual pages
+---------------------------
-Global changes
---------------
+locale.1
+ Marko Myllynen
+ Provide a step-by-step example of how to use a custom locale
+ Marko Myllynen
+ Use LC_TELEPHONE instead of LC_MESSAGES in the example
+ yesstr/nostr in LC_MESSAGES are planned to be changed at some
+ point [1], so it's better to provide an example which won't
+ be obsoleted by that change.
-Various pages
- Michael Kerrisk
- Global formatting fix: balance .nf/.fi pairs
+ [1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
-Various pages
+adjtimex.2
Michael Kerrisk
- Global fix: place sections in correct order
+ Add featute test macro requirements
-Various pages
- Michael Kerrisk [Justin T Pryzby]
- Global fix: Remove duplicated words
- Remove instances of duplicate words found using Justin's
- grep-fu:
-
- for f in man?/*.[1-9]; do
- grep -HE ' ([[:alpha:]]{2,} +)\1' "$f" |
- grep -Evw '(proc|hugetlbfs|XXX*|root|long) *\1';
- done | grep -E --colo ' ([[:alpha:]]{2,} +)\1'
-
-Various pages
+clone.2
Michael Kerrisk
- Correct order of SEE ALSO entries
-
+ ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
-Changes to individual pages
----------------------------
-
-futimesat.2
+fork.2
Michael Kerrisk
- PROTOTYPE: Correct header file and feature test macro requirements
-
-keyctl.2
- Bjarni Ingi Gislason
- Strip trailing tabs from source line
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=664688
-
-ptrace.2
- Denys Vlasenko
- Document PTRACE_GETEVENTMSG for PTRACE_EVENT_EXEC
- Denys Vlasenko
- Various fixes to recent updates of this page
+ ERRORS: add pid_max and threads-max to EAGAIN
+ And rewrite text to be the same as pthread_create(3).
-symlinkat.2
- Michael Kerrisk [Eric Blake]
- PROTOTYPE: Correct header file
-
-syscalls.2
- Michael Kerrisk
- Remove unimplemented system calls from main syscall list
- The unimplemented system calls are in any case noted lower down
- in the page. Also: rearrange the text describing the unimplemented
- system calls.
+getrlimit.2
Michael Kerrisk
- Note a few system calls that were removed in Linux 2.6
+ RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE
+
+remap_file_pages.2
+ Rasmus Villemoes
+ Fix prototype
+ The pgoff argument has type size_t, not ssize_t (and in the
+ kernel it is unsigned long).
+
+set_mempolicy.2
+ Rasmus Villemoes
+ Fix prototype for set_mempolicy(2)
+ The nodemask argument is const. The return type in numaif.h is long.
+
+swapon.2
+ Rasmus Villemoes
+ Remove header from synopsis
+ The <asm/page.h> header is not readily available, and the comment
+ seems to indicate that it is for getting PAGE_SIZE. But it is
+ never mentioned why one would need to know that, and it is in any
+ case better obtained using sysconf(), provided by <unistd.h>.
+
+a64l.3
+ Rasmus Villemoes
+ Fix prototype for a64l()
+ The argument is const, both according to POSIX and the
+ glibc headers.
+
+adjtime.3
+ Rasmus Villemoes
+ Add required header
+ The prototype for adjtime(3) is declared in <sys/time.h>.
+
+argz_add.3
+ Rasmus Villemoes
+ Fix prototypes
+ Update the prototypes of argz_{delete,extract,next} to agree with
+ glibc headers and manual.
+
+bstring.3
+ Rasmus Villemoes
+ Fix prototypes
+ The length parameter n has type size_t in bcmp(), bcopy() and
+ bzero().
+
+envz_add.3
+ Rasmus Villemoes
+ Fix prototypes
+ The envz_len parameters for envz_entry() and envz_get() are not
+ passed by reference.
+
+fpathconf.3
+ Rasmus Villemoes
+ Fix prototype
+ The path argument to pathconf() is const.
+
+fseek.3
+ Rasmus Villemoes
+ Fix prototype
+ The pos argument to fsetpos() is const.
+
+gcvt.3
+ Rasmus Villemoes
+ Fix prototype
+ The ndigit paramenter to gcvt() has type int.
+
+getaddrinfo_a.3
+ Rasmus Villemoes
+ Fix prototype
+ The pointer arguments to gai_suspend() are const.
+
+getauxval.3
+ Rasmus Villemoes
+ Fix permissions
+ There doesn't seem to be any reason for getauxval.3 to be
+ executable...
+
+getnameinfo.3
+ Rasmus Villemoes
+ Fix prototype
+ The hostlen and servlen parameters have type socklet_t.
+ (The types changed in glibc 2.2)
Michael Kerrisk
- Add process_vm_readv(2) and process_vm_writev(2)
-
-unlinkat.2
- Michael Kerrisk [Eric Blake]
- PROTOTYPE: Correct header file
+ Note types of 'hostlen'; and 'servlen' in glibc < 2.2
+
+getrpcent.3
+ Rasmus Villemoes
+ Fix prototype
+ The argument to getrpcbyname() is const.
+
+getrpcport.3
+ Rasmus Villemoes
+ Add #include and fix prototype
+ The prototype for getrpcport() is obtained by #include'ing
+ <rpc/rpc.h>. Also, update its prototype.
+
+getspnam.3
+ Rasmus Villemoes
+ Fix prototype
+ The struct spwd argument to putspent() is const.
+
+getutent.3
+ Rasmus Villemoes
+ Fix prototypes
+ The arguments to getutid(), getutline(), and pututline()
+ are const.
+
+inet.3
+ Rasmus Villemoes
+ Fix prototype
+ The parameters to inet_makeaddr have type in_addr_t.
+
+inet_net_pton.3
+ Rasmus Villemoes
+ srcfix, cfix
+ Use a consistent style throughout the man-pages.
+
+key_setsecret.3
+ Rasmus Villemoes
+ Fix prototypes
+ Remove const qualifiers from arguments to key_decryptsession,
+ key_encryptsession, and key_setsecret.
+
+makecontext.3
+ Rasmus Villemoes
+ Fix prototype
+ The second argument to swapcontext() is const.
+
+makedev.3
+ Rasmus Villemoes
+ Fix prototype
+ gnu_dev_makedev, and hence its trivial macro wrapper makedev, takes
+ two unsigned int parameters; this is consistent with it being the
+ inverse of (gnu_dev_)major/minor, which return unsigned int.
+
+malloc_trim.3
+ Rasmus Villemoes
+ Fix prototype
+ As mentioned further down, malloc_trim returns an integer.
+
+mq_getattr.3
+ Rasmus Villemoes
+ Fix prototype
+ The newattr parameter to mq_setattr is const.
+
+newlocale.3
+ Marko Myllynen
+ List all available category masks
Michael Kerrisk
- PROTOTYPE: Add <fcntl.h> for AT_* constants
+ Add LC_ALL_MASK description
+
+nl_langinfo.3
+ Marko Myllynen
+ Expand the example code a bit
+ Better illustrate querying elements from different categories.
+
+perror.3
+ Rasmus Villemoes
+ Fix declaration
+ The elements of the array sys_errlist are also const.
+
+pthread_attr_setaffinity_np.3
+pthread_attr_setdetachstate.3
+pthread_attr_setguardsize.3
+pthread_attr_setinheritsched.3
+pthread_attr_setschedparam.3
+pthread_attr_setschedpolicy.3
+pthread_attr_setscope.3
+pthread_attr_setstack.3
+pthread_attr_setstackaddr.3
+pthread_attr_setstacksize.3
+ Rasmus Villemoes
+ Constify parameters
+ Each of the pthread_attr_get* functions extract some piece of
+ information from a pthread_attr_t, which is passed by const
+ reference. Add the const keyword to the prototypes of these
+ functions.
+
+pthread_cleanup_push_defer_np.3
+ Michael Kerrisk [Rasmus Villemoes]
+ Add feature test macro requirements
+
+pthread_create.3
+ Michael Kerrisk [Carsten Grohmann]
+ Add pid_max limit to EAGAIN error cases
+
+pthread_equal.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_equal() is thread safe.
+
+pthread_exit.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_exit() is thread safe.
+
+pthread_getcpuclockid.3
+ Peng Haitao
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_getcpuclockid() is thread safe.
+
+pthread_setaffinity_np.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setaffinity_np() and
+ pthread_getaffinity_np() are thread safe.
+
+pthread_setconcurrency.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setconcurrency() and
+ pthread_getconcurrency() are thread safe.
+
+pthread_setname_np.3
+ Rasmus Villemoes
+ Fix prototype
+ The name parameter of pthread_getname_np is an output parameter and
+ hence not const.
+
+pthread_setschedparam.3
+ Rasmus Villemoes
+ Fix prototypes
+ Add return type for pthread_{s,g}etschedparam.
+
+pthread_setschedprio.3
+ Rasmus Villemoes
+ Fix prototype
+ Add return type for pthread_setschedprio.
+
+pthread_sigqueue.3
+ Rasmus Villemoes
+ Add missing #include <signal.h>
+
+rcmd.3
+ Rasmus Villemoes
+ Fix prototypes
+ Unlike the BSDs, the second argument of rcmd() and rcmd_af() has
+ type unsigned short.
+ The first argument of iruserok_af() has type const void*.
+
+re_comp.3
+ Rasmus Villemoes
+ Fix prototypes
+ re_comp and re_exec take const char* arguments.
+
+resolver.3
+ Rasmus Villemoes
+ Fix prototypes and extern-declaration
+ Fix const- and signedness of various char* parameters.
+
+ Also, there is no "struct state", but _res is a struct
+ __res_state. (Actually, _res is errno-like in that it is really a
+ macro expanding to (*__res_state()).)
+
+rexec.3
+ Rasmus Villemoes
+ Fix prototypes
+ The user, passwd and cmd arguments to rexec and rexec_af are all
+ const.
+
+rtime.3
+ Rasmus Villemoes
+ Replace header
+ The header <rpc/des_crypt.h> does not provide rtime();
+ <rpc/auth_des.h> does, as is also implied in both the NOTES and
+ EXAMPLE sections.
-utimensat.2
+scandir.3
+ Rasmus Villemoes
+ Fix prototypes
+ The alphasort and versionsort functions take arguments of type
+ const struct dirent **, not const void *.
+
+setlocale.3
+ Michael Kerrisk [Marko Myllynen]
+ Simplify locale category listing and add GNU-specific locale categories
+ Some information that was here will move to locale(7).
+ Marko Myllynen
+ Remove now obsolete NOTES section
+
+setnetgrent.3
+ Rasmus Villemoes
+ Fix prototype
+ The buflen argument to getnetgrent_r has type size_t.
+
+sigvec.3
+ Rasmus Villemoes
+ Fix prototype
+ The vec argument to sigvec is const.
+
+tsearch.3
+ Rasmus Villemoes
+ Fix prototype
+ The rootp argument to tfind is "void * const *",
+ not "const void **".
+
+core.5
Michael Kerrisk
- PROTOTYPE: Add <fcntl.h> for AT_* constants
-
-copysign.3
- Michael Kerrisk [Tolga Dalman]
- DESCRIPTION: Add a couple of examples
+ Core dump files are nowadays core.pid by default
-malloc.3
+locale.5
+ Marko Myllynen
+ Document mon_grouping and grouping properly
Michael Kerrisk
- NOTES: Add a short discussion of arenas
+ Note default value for 'first_workday'
+ Michael Kerrisk [Marko Myllynen]
+ Add brief descriptions of collating-element and collating-symbol
+ Marko Myllynen
+ t_fmt_ampm is needed only for locales that employ AM/PM convention
+ Michael Kerrisk [Marko Myllynen]
+ Remove crufty reference to /usr/lib/nls/src
+ That file is nowhere to be found
+ Marko Myllynen
+ Clarify LC_TIME/am_pm and LC_NAME keywords usage
+ am_pm should be defined only if AM/PM convention is used to signal
+ applications they should not try to print them when using them in
+ unwanted.
+
+ Same for all LC_NAME keywords expect for name_fmt which should be
+ always defined.
+ Marko Myllynen
+ Clarify lang_term / lang_lib
+ As noted by Keld Simonsen in the lib-locales@sourceware mailing
+ list:
+
+ https://sourceware.org/ml/libc-locales/2014-q2/msg00008.html
+ From: Keld Simonsen <keld at rap dot rap dot dk>
+ To: Marko Myllynen <myllynen at redhat dot com>
+ Date: Tue, 29 Apr 2014 17:02:09 +0200
+
+ lang_term reflects ISO 639-2/T (terminology) codes, while
+ lang_lib reflects ISO 639-2/B (bibliographic) codes.
+ lang_term is preferred over lang_lib codes for locale names.
+ There are 20 specific ISO 639-2/B codes.
+ Marko Myllynen
+ Correct the FILES section
+
+proc.5
Michael Kerrisk
- Replace discussion of MALLOC_CHECK_ with pointer to mallopt(3)
- Michael Kerrisk
- SEE ALSO: Add mtrace(3)
- SEE ALSO: add malloc_get_state(3)
+ 'pid_max' is a system-wide limit on number of threads and processes
+ Since PIDs > /proc/sys/kernel/pid_max are not allocated, this
+ file thus also imposes a system-wide limit on the number of
+ threads and processes.
-posix_memalign.3
+capabilities.7
Michael Kerrisk
- Rename memalign() argument
- Rename "boundary" to "alignment" for consistency
- with posix_memalign().
+ CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
Michael Kerrisk
- Improve discussion of feature test macros and header files for valloc(3)
-
-rtnetlink.3
- Kirill Brilliantov [Sergei Zhirikov]
- Fix example code, rta_len assignment should use RTA_LENGTH()
- See also http://bugs.debian.org/655088
+ CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
-scandir.3
- Mark R Bannister
- SEE ALSO: Add scandirat(3)
-
-sigqueue.3
- Nix
- Remove rt_sigqueueinfo from TH line
- rt_sigqueueinfo() now has its own manual page, so should not
- be listed in the .TH line of this page.
-
-tzset.3
- Peter Schiffer
- Correct description for Julian 'n' date format
- The Julian 'n' date format counts starting from 0, not 1.
+charsets.7
+ Michael Kerrisk [Marko Myllynen]
+ Remove crufty statement that Romanian may be switching to ISO 8859-16
Michael Kerrisk
- Add some clarifying remarks to discussion of Julian day formats
-
-packet.7
- Michael Kerrisk [Iain Fraser]
- Fix comment on 'sll_hatype' field
+ Remove ancient paragraph on charsets supported in glibc 2.3.2
+ That test is rather ancient, and probably of little use.
+
+fanotify.7
+ Heinrich Schuchardt
+ Fix to example program: fanotifyi read() should use aligned buffer
+
+inotify.7
+ Heinrich Schuchardt
+ Add example program
+ This example of the usage of the inotify API shows the
+ usage of inotify_init1(2) and inotify_add_watch(2) as well
+ as polling and reading from the inotify file descriptor.
+ Heinrich Schuchardt
+ munmap() does not generate inotify events
+
+locale.7
+ Marko Myllynen [Michael Kerrisk]
+ Document the LOCPATH environment variable
+ Michael Kerrisk
+ Add further details on various categories
-tcp.7
- Michael Kerrisk [Artyom Pervukhin]
- Correct RFC for TIME_WAIT assassination hazards
OSDN Git Service
