-==================== Changes in man-pages-3.50 ====================
+==================== Changes in man-pages-3.68 ====================
-Released: 2013-03-15, Munich
+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:
-Andrey Vagin <avagin@openvz.org>
-Bernhard Kuemel <bernhard@bksys.at>
-Elie De Brauwer <eliedebrauwer@gmail.com>
-Erik Saule <erik.saule@bmi.osu.edu>
-Florian Weimer <fweimer@bfk.de>
-Friedrich Delgado Friedrichs <friedel@nomaden.org>
-Jonathan Nieder <jrnieder@gmail.com>
-Jose Luis Domingo Lopez <debian@24x7linux.com>
-Mark R Bannister <mark@proseconsulting.co.uk>
-Michael Kerrisk <mtk.manpages@gmail.com>
-Sam Varshavchik <mrsam@courier-mta.com>
-Simon Paillard <spaillard@debian.org>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
-canonicalize_file_name.3
- Michael Kerrisk
- Rewrite page, adding much more detail
-
+localedef.1
+ Marko Myllynen [Richard Braakman, Alastair McKinstry, Lars Wirzenius]
+ New page for localedef(1)
+ Add new page based on Debian localedef(1) page.
-Global changes
---------------
-Various pages
- Michael Kerrisk
- Global fix: s/END_LICENSE/LICENSE_END/
+New and changed links
+---------------------
-Various pages
- Michael Kerrisk
- Global fix: s/bitmask/bit mask/
+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).
Changes to individual pages
---------------------------
-getent.1
- Mark R Bannister
- netgroup description incorrectly refers to initgroups
+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.
-capget.2
- Michael Kerrisk
- Update URL for libcap
+ [1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
-fork.2
+adjtimex.2
Michael Kerrisk
- Port access permission bits (ioperm()) are turned off in the child
+ Add featute test macro requirements
-futex.2
+clone.2
Michael Kerrisk
- 'timeout' is a minimum duration that the call will wait, not a maximum
+ ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
-ioperm.2
- Michael Kerrisk
- Note that iopl() level of 3 is needed to access ports
- Michael Kerrisk
- 'num' is *bits* not bytes!
- Michael Kerrisk
- Linux 2.6.8 lifted the port limit to 65,536
- See http://article.gmane.org/gmane.linux.kernel/202624/
- From: Stas Sergeev <stsp <at> aknet.ru>
- Subject: [patch][rfc] Larger IO bitmap
- Date: 2004-05-07 19:55:03 GMT
+fork.2
Michael Kerrisk
- ioperm() operates on the calling *thread* (not process)
+ ERRORS: add pid_max and threads-max to EAGAIN
+ And rewrite text to be the same as pthread_create(3).
+
+getrlimit.2
Michael Kerrisk
- Clarify meaning of 'turn_on' argument
- Plus form formatting fixes.
+ 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
- Clarify that default state of permission bits in child is off
+ 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
- NOTES: add mention of /proc/ioports
+ 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.
+
+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
- SEE ALSO: add outb(2)
+ Core dump files are nowadays core.pid by default
-iopl.2
+locale.5
+ Marko Myllynen
+ Document mon_grouping and grouping properly
Michael Kerrisk
- CAP_SYS_RAWIO is required to *raise* the I/O privilege level
+ 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
- Clarify that the two least significant bits of 'level' are what matter
- Michael Kerrisk
- SEE ALSO: add outb(2)
+ '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.
-syscalls.2
+capabilities.7
Michael Kerrisk
- Add version information for all (other) syscalls
+ CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
Michael Kerrisk
- Add perfmonctl(2)
-
-futimes.3
- Michael Kerrisk [Jonathan Nieder]
- ERRORS: Add ENOSYS for lutimes()
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620746
+ CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
-getpass.3
- Michael Kerrisk [Erik Saule]
- Suggest use of the ECHO flag as an alternative
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=644261
-
-realpath.3
+charsets.7
+ Michael Kerrisk [Marko Myllynen]
+ Remove crufty statement that Romanian may be switching to ISO 8859-16
Michael Kerrisk
- Document GNU extensions for EACCES and ENOENT errors
-
-stdarg.3
- Michael Kerrisk [Friedrich Delgado Friedrichs]
- Describe va_copy()
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=575077
-
-termios.3
- Michael Kerrisk [Bernhard Kuemel]
- Mention that noncanonical mode does not do input processing
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=643854
-
-random.4
- Elie De Brauwer
- Document write and document the ioctl interface of /dev/random
- The update consists out of two parts:
- - a minor thing which just documents what happens if a write to
- /dev/(u)random is performed, which is used in the example
- script but not explicitly mentioned.
- - the other (biggest) part is the documentation of the ioctl()
- interface which /dev/(u)random exposes. This ioctl() lives in
- drivers/char/random.c and the primitives can be found in
- include/linux/random.h
-
- One comment remains, there used to be an RNDGETPOOL ioctl() which
- disappeared in v2.6.9. I found two patches on the net:
- - http://www.kernel.org/pub/linux/kernel/people/akpm/patches/2.6/2.6.8.1/2.6.8.1-mm4/broken-out/dev-random-remove-rndgetpool-ioctl.patch
- - https://lkml.org/lkml/2004/3/25/168
-
- But as far as I can tell the first one got applied but the 2nd
- one seems more correct. The result is that even today one can
- still find traces of the RNDGETPOOL ioctl() in the header files.
- Is this there for historical reasons or because it might break
- userspace, even though using it will just give an EINVAL.
-
-bootparam.7
- Jose Luis Domingo Lopez
- Document 'rootfstype' option
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182014
-
-capabilities.7
+ 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 various pieces under CAP_SYS_RAWIO
- Info obtained by grepping the kernel source.
- Michael Kerrisk
- Add CAP_SYS_RESOURCE /proc/PID/oom_score_adj case
-
-netlink.7
- Andrey Vagin
- Add a note about broadcast messages to multiple groups
+ Add further details on various categories
-socket.7
- Michael Kerrisk [Florian Weimer]
- Define _GNU_SOURCE to obtain the definition of 'struct ucred'
- See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572210
OSDN Git Service
