2014-05-21 11:20:15 +00:00
|
|
|
==================== Changes in man-pages-3.68 ====================
|
2007-09-19 21:40:03 +00:00
|
|
|
|
2014-05-28 14:00:58 +00:00
|
|
|
Released: 2014-05-28, Munich
|
2007-09-19 21:40:03 +00:00
|
|
|
|
2014-05-28 13:59:54 +00:00
|
|
|
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>
|
2007-09-19 21:40:03 +00:00
|
|
|
|
2007-11-24 13:50:54 +00:00
|
|
|
Contributors
|
|
|
|
------------
|
2007-10-23 11:33:49 +00:00
|
|
|
|
2011-09-16 02:56:20 +00:00
|
|
|
The following people contributed patches/fixes or (noted in brackets
|
2012-03-05 20:07:17 +00:00
|
|
|
in the changelog below) reports, notes, and ideas that have been
|
2011-09-16 02:56:20 +00:00
|
|
|
incorporated in changes in this release:
|
2007-09-20 18:15:23 +00:00
|
|
|
|
2013-03-10 10:24:30 +00:00
|
|
|
|
|
|
|
Apologies if I missed anyone!
|
|
|
|
|
|
|
|
|
2014-02-18 14:01:50 +00:00
|
|
|
New and rewritten pages
|
|
|
|
-----------------------
|
|
|
|
|
2014-05-28 13:59:54 +00:00
|
|
|
localedef.1
|
|
|
|
Marko Myllynen [Richard Braakman, Alastair McKinstry, Lars Wirzenius]
|
|
|
|
New page for localedef(1)
|
|
|
|
Add new page based on Debian localedef(1) page.
|
2014-02-18 14:01:50 +00:00
|
|
|
|
2014-03-11 21:40:28 +00:00
|
|
|
|
2014-05-08 09:11:05 +00:00
|
|
|
New and changed links
|
|
|
|
---------------------
|
|
|
|
|
2014-05-28 13:59:54 +00:00
|
|
|
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).
|
2014-02-18 14:01:50 +00:00
|
|
|
|
|
|
|
|
2014-02-16 09:08:04 +00:00
|
|
|
Changes to individual pages
|
|
|
|
---------------------------
|
2013-03-10 10:24:30 +00:00
|
|
|
|
2014-05-28 13:59:54 +00:00
|
|
|
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.
|
|
|
|
|
|
|
|
[1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
|
|
|
|
|
|
|
|
adjtimex.2
|
|
|
|
Michael Kerrisk
|
|
|
|
Add featute test macro requirements
|
|
|
|
|
|
|
|
clone.2
|
|
|
|
Michael Kerrisk
|
|
|
|
ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
|
|
|
|
|
|
|
|
fork.2
|
|
|
|
Michael Kerrisk
|
|
|
|
ERRORS: add pid_max and threads-max to EAGAIN
|
|
|
|
And rewrite text to be the same as pthread_create(3).
|
|
|
|
|
|
|
|
getrlimit.2
|
|
|
|
Michael Kerrisk
|
|
|
|
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
|
|
|
|
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
|
|
|
|
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
|
|
|
|
Core dump files are nowadays core.pid by default
|
|
|
|
|
|
|
|
locale.5
|
|
|
|
Marko Myllynen
|
|
|
|
Document mon_grouping and grouping properly
|
|
|
|
Michael Kerrisk
|
|
|
|
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
|
|
|
|
'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.
|
|
|
|
|
|
|
|
capabilities.7
|
|
|
|
Michael Kerrisk
|
|
|
|
CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
|
|
|
|
Michael Kerrisk
|
|
|
|
CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
|
|
|
|
|
|
|
|
charsets.7
|
|
|
|
Michael Kerrisk [Marko Myllynen]
|
|
|
|
Remove crufty statement that Romanian may be switching to ISO 8859-16
|
|
|
|
Michael Kerrisk
|
|
|
|
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]
|
2014-05-28 14:00:50 +00:00
|
|
|
Document the LOCPATH environment variable
|
2014-05-28 13:59:54 +00:00
|
|
|
Michael Kerrisk
|
|
|
|
Add further details on various categories
|
|
|
|
|