original/Changes

   1 ==================== Changes in man-pages-3.68 ====================
   2
   3 Released: 2014-05-28, Munich
   4
   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>
  16
  17 Contributors
  18 ------------
  19
  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:
  23
  24
  25 Apologies if I missed anyone!
  26
  27
  28 New and rewritten pages
  29 -----------------------
  30
  31 localedef.1
  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.
  35
  36
  37 New and changed links
  38 ---------------------
  39
  40 procfs.5
  41     New link to proc.5
  42         Since the term "procfs" is widely used, it seems reasonable to have
  43         a link from that name to proc(5).
  44
  45
  46 Changes to individual pages
  47 ---------------------------
  48
  49 locale.1
  50     Marko Myllynen
  51         Provide a step-by-step example of how to use a custom locale
  52     Marko Myllynen
  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.
  57
  58             [1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
  59
  60 adjtimex.2
  61     Michael Kerrisk
  62         Add featute test macro requirements
  63
  64 clone.2
  65     Michael Kerrisk
  66         ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
  67
  68 fork.2
  69     Michael Kerrisk
  70         ERRORS: add pid_max and threads-max to EAGAIN
  71             And rewrite text to be the same as pthread_create(3).
  72
  73 getrlimit.2
  74     Michael Kerrisk
  75         RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE
  76
  77 remap_file_pages.2
  78     Rasmus Villemoes
  79         Fix prototype
  80             The pgoff argument has type size_t, not ssize_t (and in the
  81             kernel it is unsigned long).
  82
  83 set_mempolicy.2
  84     Rasmus Villemoes
  85         Fix prototype for set_mempolicy(2)
  86             The nodemask argument is const. The return type in numaif.h is long.
  87
  88 swapon.2
  89     Rasmus Villemoes
  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>.
  95
  96 a64l.3
  97     Rasmus Villemoes
  98         Fix prototype for a64l()
  99             The argument is const, both according to POSIX and the
 100             glibc headers.
 101
 102 adjtime.3
 103     Rasmus Villemoes
 104         Add required header
 105             The prototype for adjtime(3) is declared in <sys/time.h>.
 106
 107 argz_add.3
 108     Rasmus Villemoes
 109         Fix prototypes
 110             Update the prototypes of argz_{delete,extract,next} to agree with
 111             glibc headers and manual.
 112
 113 bstring.3
 114     Rasmus Villemoes
 115         Fix prototypes
 116             The length parameter n has type size_t in bcmp(), bcopy() and
 117             bzero().
 118
 119 envz_add.3
 120     Rasmus Villemoes
 121         Fix prototypes
 122             The envz_len parameters for envz_entry() and envz_get() are not
 123             passed by reference.
 124
 125 fpathconf.3
 126     Rasmus Villemoes
 127         Fix prototype
 128             The path argument to pathconf() is const.
 129
 130 fseek.3
 131     Rasmus Villemoes
 132         Fix prototype
 133             The pos argument to fsetpos() is const.
 134
 135 gcvt.3
 136     Rasmus Villemoes
 137         Fix prototype
 138             The ndigit paramenter to gcvt() has type int.
 139
 140 getaddrinfo_a.3
 141     Rasmus Villemoes
 142         Fix prototype
 143             The pointer arguments to gai_suspend() are const.
 144
 145 getauxval.3
 146     Rasmus Villemoes
 147         Fix permissions
 148             There doesn't seem to be any reason for getauxval.3 to be
 149             executable...
 150
 151 getnameinfo.3
 152     Rasmus Villemoes
 153         Fix prototype
 154             The hostlen and servlen parameters have type socklet_t.
 155             (The types changed in glibc 2.2)
 156     Michael Kerrisk
 157         Note types of 'hostlen'; and 'servlen' in glibc < 2.2
 158
 159 getrpcent.3
 160     Rasmus Villemoes
 161         Fix prototype
 162             The argument to getrpcbyname() is const.
 163
 164 getrpcport.3
 165     Rasmus Villemoes
 166         Add #include and fix prototype
 167             The prototype for getrpcport() is obtained by #include'ing
 168             <rpc/rpc.h>. Also, update its prototype.
 169
 170 getspnam.3
 171     Rasmus Villemoes
 172         Fix prototype
 173             The struct spwd argument to putspent() is const.
 174
 175 getutent.3
 176     Rasmus Villemoes
 177         Fix prototypes
 178             The arguments to getutid(), getutline(), and pututline()
 179             are const.
 180
 181 inet.3
 182     Rasmus Villemoes
 183         Fix prototype
 184             The parameters to inet_makeaddr have type in_addr_t.
 185
 186 inet_net_pton.3
 187     Rasmus Villemoes
 188         srcfix, cfix
 189             Use a consistent style throughout the man-pages.
 190
 191 key_setsecret.3
 192     Rasmus Villemoes
 193         Fix prototypes
 194             Remove const qualifiers from arguments to key_decryptsession,
 195             key_encryptsession, and key_setsecret.
 196
 197 makecontext.3
 198     Rasmus Villemoes
 199         Fix prototype
 200             The second argument to swapcontext() is const.
 201
 202 makedev.3
 203     Rasmus Villemoes
 204         Fix prototype
 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.
 208
 209 malloc_trim.3
 210     Rasmus Villemoes
 211         Fix prototype
 212             As mentioned further down, malloc_trim returns an integer.
 213
 214 mq_getattr.3
 215     Rasmus Villemoes
 216         Fix prototype
 217             The newattr parameter to mq_setattr is const.
 218
 219 newlocale.3
 220     Marko Myllynen
 221         List all available category masks
 222     Michael Kerrisk
 223         Add LC_ALL_MASK description
 224
 225 nl_langinfo.3
 226     Marko Myllynen
 227         Expand the example code a bit
 228             Better illustrate querying elements from different categories.
 229
 230 perror.3
 231     Rasmus Villemoes
 232         Fix declaration
 233             The elements of the array sys_errlist are also const.
 234
 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
 245     Rasmus Villemoes
 246         Constify parameters
 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
 250             functions.
 251
 252 pthread_cleanup_push_defer_np.3
 253     Michael Kerrisk  [Rasmus Villemoes]
 254         Add feature test macro requirements
 255
 256 pthread_create.3
 257     Michael Kerrisk  [Carsten Grohmann]
 258         Add pid_max limit to EAGAIN error cases
 259
 260 pthread_equal.3
 261     Peng Haitao
 262         ATTRIBUTES: Note function that is thread-safe
 263             The function pthread_equal() is thread safe.
 264
 265 pthread_exit.3
 266     Peng Haitao
 267         ATTRIBUTES: Note function that is thread-safe
 268             The function pthread_exit() is thread safe.
 269
 270 pthread_getcpuclockid.3
 271     Peng Haitao
 272         ATTRIBUTES: Note function that is thread-safe
 273             The function pthread_getcpuclockid() is thread safe.
 274
 275 pthread_setaffinity_np.3
 276     Peng Haitao
 277         ATTRIBUTES: Note functions that are thread-safe
 278             The functions pthread_setaffinity_np() and
 279             pthread_getaffinity_np() are thread safe.
 280
 281 pthread_setconcurrency.3
 282     Peng Haitao
 283         ATTRIBUTES: Note functions that are thread-safe
 284             The functions pthread_setconcurrency() and
 285             pthread_getconcurrency() are thread safe.
 286
 287 pthread_setname_np.3
 288     Rasmus Villemoes
 289         Fix prototype
 290             The name parameter of pthread_getname_np is an output parameter and
 291             hence not const.
 292
 293 pthread_setschedparam.3
 294     Rasmus Villemoes
 295         Fix prototypes
 296             Add return type for pthread_{s,g}etschedparam.
 297
 298 pthread_setschedprio.3
 299     Rasmus Villemoes
 300         Fix prototype
 301             Add return type for pthread_setschedprio.
 302
 303 pthread_sigqueue.3
 304     Rasmus Villemoes
 305         Add missing #include <signal.h>
 306
 307 rcmd.3
 308     Rasmus Villemoes
 309         Fix prototypes
 310             Unlike the BSDs, the second argument of rcmd() and rcmd_af() has
 311             type unsigned short.
 312             The first argument of iruserok_af() has type const void*.
 313
 314 re_comp.3
 315     Rasmus Villemoes
 316         Fix prototypes
 317             re_comp and re_exec take const char* arguments.
 318
 319 resolver.3
 320     Rasmus Villemoes
 321         Fix prototypes and extern-declaration
 322             Fix const- and signedness of various char* parameters.
 323
 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()).)
 327
 328 rexec.3
 329     Rasmus Villemoes
 330         Fix prototypes
 331             The user, passwd and cmd arguments to rexec and rexec_af are all
 332             const.
 333
 334 rtime.3
 335     Rasmus Villemoes
 336         Replace header
 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
 339             EXAMPLE sections.
 340
 341 scandir.3
 342     Rasmus Villemoes
 343         Fix prototypes
 344             The alphasort and versionsort functions take arguments of type
 345             const struct dirent **, not const void *.
 346
 347 setlocale.3
 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).
 351     Marko Myllynen
 352         Remove now obsolete NOTES section
 353
 354 setnetgrent.3
 355     Rasmus Villemoes
 356         Fix prototype
 357             The buflen argument to getnetgrent_r has type size_t.
 358
 359 sigvec.3
 360     Rasmus Villemoes
 361         Fix prototype
 362             The vec argument to sigvec is const.
 363
 364 tsearch.3
 365     Rasmus Villemoes
 366         Fix prototype
 367             The rootp argument to tfind is "void * const *",
 368             not "const void **".
 369
 370 core.5
 371     Michael Kerrisk
 372         Core dump files are nowadays core.pid by default
 373
 374 locale.5
 375     Marko Myllynen
 376         Document mon_grouping and grouping properly
 377     Michael Kerrisk
 378         Note default value for 'first_workday'
 379     Michael Kerrisk  [Marko Myllynen]
 380         Add brief descriptions of collating-element and collating-symbol
 381     Marko Myllynen
 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
 386     Marko Myllynen
 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
 390             unwanted.
 391
 392             Same for all LC_NAME keywords expect for name_fmt which should be
 393             always defined.
 394     Marko Myllynen
 395         Clarify lang_term / lang_lib
 396             As noted by Keld Simonsen in the lib-locales@sourceware mailing
 397             list:
 398
 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
 403
 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.
 408     Marko Myllynen
 409         Correct the FILES section
 410
 411 proc.5
 412     Michael Kerrisk
 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.
 417
 418 capabilities.7
 419     Michael Kerrisk
 420         CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
 421     Michael Kerrisk
 422         CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
 423
 424 charsets.7
 425     Michael Kerrisk  [Marko Myllynen]
 426         Remove crufty statement that Romanian may be switching to ISO 8859-16
 427     Michael Kerrisk
 428         Remove ancient paragraph on charsets supported in glibc 2.3.2
 429             That test is rather ancient, and probably of little use.
 430
 431 fanotify.7
 432     Heinrich Schuchardt
 433         Fix to example program: fanotifyi read() should use aligned buffer
 434
 435 inotify.7
 436     Heinrich Schuchardt
 437         Add example program
 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.
 441     Heinrich Schuchardt
 442         munmap() does not generate inotify events
 443
 444 locale.7
 445     Marko Myllynen [Michael Kerrisk]
 446         Document the LOCPATH environment variable
 447     Michael Kerrisk
 448         Add further details on various categories
 449