1 ==================== Changes in man-pages-3.68 ====================
3 Released: 2014-05-28, Munich
5 Alastair McKinstry <mckinstry@computer.org>
6 Carsten Grohmann <carstengrohmann@gmx.de>
7 Colin Williams <colinwilliams1968@gmail.com>
8 Heinrich Schuchardt <xypron.glpk@gmx.de>
9 Lars Wirzenius <liw@iki.fi>
10 Marko Myllynen <myllynen@redhat.com>
11 Michael Kerrisk <mtk.manpages@gmail.com>
12 Peng Haitao <penght@cn.fujitsu.com>
13 Rasmus Villemoes <rv@rasmusvillemoes.dk>
14 Richard Braakman <richard.braakman@jollamobile.com>
15 Simon Paillard <spaillard@debian.org>
20 The following people contributed patches/fixes or (noted in brackets
21 in the changelog below) reports, notes, and ideas that have been
22 incorporated in changes in this release:
25 Apologies if I missed anyone!
28 New and rewritten pages
29 -----------------------
32 Marko Myllynen [Richard Braakman, Alastair McKinstry, Lars Wirzenius]
33 New page for localedef(1)
34 Add new page based on Debian localedef(1) page.
42 Since the term "procfs" is widely used, it seems reasonable to have
43 a link from that name to proc(5).
46 Changes to individual pages
47 ---------------------------
51 Provide a step-by-step example of how to use a custom locale
53 Use LC_TELEPHONE instead of LC_MESSAGES in the example
54 yesstr/nostr in LC_MESSAGES are planned to be changed at some
55 point [1], so it's better to provide an example which won't
56 be obsoleted by that change.
58 [1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
62 Add featute test macro requirements
66 ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
70 ERRORS: add pid_max and threads-max to EAGAIN
71 And rewrite text to be the same as pthread_create(3).
75 RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE
80 The pgoff argument has type size_t, not ssize_t (and in the
81 kernel it is unsigned long).
85 Fix prototype for set_mempolicy(2)
86 The nodemask argument is const. The return type in numaif.h is long.
90 Remove header from synopsis
91 The <asm/page.h> header is not readily available, and the comment
92 seems to indicate that it is for getting PAGE_SIZE. But it is
93 never mentioned why one would need to know that, and it is in any
94 case better obtained using sysconf(), provided by <unistd.h>.
98 Fix prototype for a64l()
99 The argument is const, both according to POSIX and the
105 The prototype for adjtime(3) is declared in <sys/time.h>.
110 Update the prototypes of argz_{delete,extract,next} to agree with
111 glibc headers and manual.
116 The length parameter n has type size_t in bcmp(), bcopy() and
122 The envz_len parameters for envz_entry() and envz_get() are not
128 The path argument to pathconf() is const.
133 The pos argument to fsetpos() is const.
138 The ndigit paramenter to gcvt() has type int.
143 The pointer arguments to gai_suspend() are const.
148 There doesn't seem to be any reason for getauxval.3 to be
154 The hostlen and servlen parameters have type socklet_t.
155 (The types changed in glibc 2.2)
157 Note types of 'hostlen'; and 'servlen' in glibc < 2.2
162 The argument to getrpcbyname() is const.
166 Add #include and fix prototype
167 The prototype for getrpcport() is obtained by #include'ing
168 <rpc/rpc.h>. Also, update its prototype.
173 The struct spwd argument to putspent() is const.
178 The arguments to getutid(), getutline(), and pututline()
184 The parameters to inet_makeaddr have type in_addr_t.
189 Use a consistent style throughout the man-pages.
194 Remove const qualifiers from arguments to key_decryptsession,
195 key_encryptsession, and key_setsecret.
200 The second argument to swapcontext() is const.
205 gnu_dev_makedev, and hence its trivial macro wrapper makedev, takes
206 two unsigned int parameters; this is consistent with it being the
207 inverse of (gnu_dev_)major/minor, which return unsigned int.
212 As mentioned further down, malloc_trim returns an integer.
217 The newattr parameter to mq_setattr is const.
221 List all available category masks
223 Add LC_ALL_MASK description
227 Expand the example code a bit
228 Better illustrate querying elements from different categories.
233 The elements of the array sys_errlist are also const.
235 pthread_attr_setaffinity_np.3
236 pthread_attr_setdetachstate.3
237 pthread_attr_setguardsize.3
238 pthread_attr_setinheritsched.3
239 pthread_attr_setschedparam.3
240 pthread_attr_setschedpolicy.3
241 pthread_attr_setscope.3
242 pthread_attr_setstack.3
243 pthread_attr_setstackaddr.3
244 pthread_attr_setstacksize.3
247 Each of the pthread_attr_get* functions extract some piece of
248 information from a pthread_attr_t, which is passed by const
249 reference. Add the const keyword to the prototypes of these
252 pthread_cleanup_push_defer_np.3
253 Michael Kerrisk [Rasmus Villemoes]
254 Add feature test macro requirements
257 Michael Kerrisk [Carsten Grohmann]
258 Add pid_max limit to EAGAIN error cases
262 ATTRIBUTES: Note function that is thread-safe
263 The function pthread_equal() is thread safe.
267 ATTRIBUTES: Note function that is thread-safe
268 The function pthread_exit() is thread safe.
270 pthread_getcpuclockid.3
272 ATTRIBUTES: Note function that is thread-safe
273 The function pthread_getcpuclockid() is thread safe.
275 pthread_setaffinity_np.3
277 ATTRIBUTES: Note functions that are thread-safe
278 The functions pthread_setaffinity_np() and
279 pthread_getaffinity_np() are thread safe.
281 pthread_setconcurrency.3
283 ATTRIBUTES: Note functions that are thread-safe
284 The functions pthread_setconcurrency() and
285 pthread_getconcurrency() are thread safe.
290 The name parameter of pthread_getname_np is an output parameter and
293 pthread_setschedparam.3
296 Add return type for pthread_{s,g}etschedparam.
298 pthread_setschedprio.3
301 Add return type for pthread_setschedprio.
305 Add missing #include <signal.h>
310 Unlike the BSDs, the second argument of rcmd() and rcmd_af() has
312 The first argument of iruserok_af() has type const void*.
317 re_comp and re_exec take const char* arguments.
321 Fix prototypes and extern-declaration
322 Fix const- and signedness of various char* parameters.
324 Also, there is no "struct state", but _res is a struct
325 __res_state. (Actually, _res is errno-like in that it is really a
326 macro expanding to (*__res_state()).)
331 The user, passwd and cmd arguments to rexec and rexec_af are all
337 The header <rpc/des_crypt.h> does not provide rtime();
338 <rpc/auth_des.h> does, as is also implied in both the NOTES and
344 The alphasort and versionsort functions take arguments of type
345 const struct dirent **, not const void *.
348 Michael Kerrisk [Marko Myllynen]
349 Simplify locale category listing and add GNU-specific locale categories
350 Some information that was here will move to locale(7).
352 Remove now obsolete NOTES section
357 The buflen argument to getnetgrent_r has type size_t.
362 The vec argument to sigvec is const.
367 The rootp argument to tfind is "void * const *",
372 Core dump files are nowadays core.pid by default
376 Document mon_grouping and grouping properly
378 Note default value for 'first_workday'
379 Michael Kerrisk [Marko Myllynen]
380 Add brief descriptions of collating-element and collating-symbol
382 t_fmt_ampm is needed only for locales that employ AM/PM convention
383 Michael Kerrisk [Marko Myllynen]
384 Remove crufty reference to /usr/lib/nls/src
385 That file is nowhere to be found
387 Clarify LC_TIME/am_pm and LC_NAME keywords usage
388 am_pm should be defined only if AM/PM convention is used to signal
389 applications they should not try to print them when using them in
392 Same for all LC_NAME keywords expect for name_fmt which should be
395 Clarify lang_term / lang_lib
396 As noted by Keld Simonsen in the lib-locales@sourceware mailing
399 https://sourceware.org/ml/libc-locales/2014-q2/msg00008.html
400 From: Keld Simonsen <keld at rap dot rap dot dk>
401 To: Marko Myllynen <myllynen at redhat dot com>
402 Date: Tue, 29 Apr 2014 17:02:09 +0200
404 lang_term reflects ISO 639-2/T (terminology) codes, while
405 lang_lib reflects ISO 639-2/B (bibliographic) codes.
406 lang_term is preferred over lang_lib codes for locale names.
407 There are 20 specific ISO 639-2/B codes.
409 Correct the FILES section
413 'pid_max' is a system-wide limit on number of threads and processes
414 Since PIDs > /proc/sys/kernel/pid_max are not allocated, this
415 file thus also imposes a system-wide limit on the number of
416 threads and processes.
420 CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
422 CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
425 Michael Kerrisk [Marko Myllynen]
426 Remove crufty statement that Romanian may be switching to ISO 8859-16
428 Remove ancient paragraph on charsets supported in glibc 2.3.2
429 That test is rather ancient, and probably of little use.
433 Fix to example program: fanotifyi read() should use aligned buffer
438 This example of the usage of the inotify API shows the
439 usage of inotify_init1(2) and inotify_add_watch(2) as well
440 as polling and reading from the inotify file descriptor.
442 munmap() does not generate inotify events
445 Marko Myllynen [Michael Kerrisk]
446 Document the LOCPATH environment variable
448 Add further details on various categories