21447
21447
Michael Kerrisk
21448
21448
Small improvement to description of domains
21449
21449
See: https://bugzilla.novell.com/show_bug.cgi?id=651900
21452
==================== Changes in man-pages-3.32 ====================
21454
Released: 2010-12-03, Munich
21460
The following people contributed notes, ideas, or patches that have
21461
been incorporated in changes in this release:
21463
A. Costa <agcosta@gis.net>
21464
Denis Barbier <bouzim@gmail.com>
21465
Emil Mikulic <emikulic@gmail.com>
21466
Eugene Kapun <abacabadabacaba@gmail.com>
21467
Hugh Dickins <hughd@google.com>
21468
Ivana Hutarova Varekova <varekova@redhat.com>
21469
Joern Heissler <kernelbugs@joern.heissler.de>
21470
Lars Wirzenius <liw@liw.fi>
21471
Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
21472
Michael Kerrisk <mtk.manpages@gmail.com>
21473
Petr Uzel <petr.uzel@suse.cz>
21474
Roger Pate <roger@qxxy.com>
21475
T�r�k Edwin <edwintorok@gmail.com>
21476
Yuri Kozlov <yuray@komyakino.ru>
21478
Apologies if I missed anyone!
21481
New and rewritten pages
21482
-----------------------
21486
New page documenting ptrhead_sigqueue()
21487
pthread_sigqueue() is new in glibc 2.11 (requires a kernel with
21488
rt_tgsigqueinfo(), added in Linux 2.6.31).
21491
Newly documented interfaces in existing pages
21492
---------------------------------------------
21496
Add documentation of preadv() and pwritev()
21497
The preadv() and pwritev() system calls were added in
21501
New and changed links
21502
---------------------
21506
New link to readv.2
21510
New link to readv.2
21513
Changes to individual pages
21514
---------------------------
21518
Remove redundant and incorrect info on FTMs from NOTES
21522
Add NOTES explaining 32-bit system calls added in Linux 2.4
21526
Clarify that clock_nanosleep() suspends the calling *thread*
21530
Note that 'size' argument must be greater than 0
21531
See https://bugzilla.kernel.org/show_bug.cgi?id=23872
21533
Added VERSIONS section
21537
Added VERSIONS section
21541
Updated VERSIONS section
21545
Add notes on fcntl64()
21549
Add NOTES on fstatat64(), the name of the underlying system call
21553
Added notes on getdents64()
21557
Add NOTES explaining 32-bit system calls added in Linux 2.4
21561
Add NOTES explaining 32-bit system calls added in Linux 2.4
21565
Improve description of getpagesize()
21566
Improve description of getpagesize() and relocate discussion
21567
of sysconf(_SC_PAGESIZE).
21569
In part inspired by
21570
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=537272
21574
Add NOTES explaining 32-bit system calls added in Linux 2.4
21578
Add example program for prlimit()
21582
Add NOTES explaining 32-bit system calls added in Linux 2.4
21585
Ivana Hutarova Varekova
21586
O_EXCL can be used without O_CREAT for block devices
21587
Since Linux 2.6 there is a possibility to use O_EXCL without
21588
O_CREAT. See patch: http://lkml.org/lkml/2003/8/10/221.
21592
Add notes on pread64() and pwrite64()
21593
See https://bugzilla.kernel.org/show_bug.cgi?id=23072
21595
SEE ALSO: add readv(3)
21599
Wording fix: readv() and writev() are system calls, not functions
21603
Add notes on sendfile64()
21607
Add NOTES explaining 32-bit system calls added in Linux 2.4
21611
Add NOTES explaining 32-bit system calls added in Linux 2.4
21615
Add NOTES explaining 32-bit system calls added in Linux 2.4
21619
Add NOTES explaining 32-bit system calls added in Linux 2.4
21623
Add NOTES explaining 32-bit system calls added in Linux 2.4
21627
Add NOTES explaining 32-bit system calls added in Linux 2.4
21633
SEE ALSO: Add pthread_sigqueue(3)
21637
Fix EOVERFLOW error description
21638
2<<31 should read 1<<31 (which equals 2^31).
21642
Add notes on statfs64() and fstatfs64()
21646
Document SWAP_FLAG_DISCARD and discarding of swap pages
21650
Add notes on truncate64() and ftruncate64()
21654
Change "should not overlap" to "must not overlap"
21655
glibc 2.12 changed things so that applications that use memcpy() on
21656
overlapping regions will encounter problems. (The standards have
21657
long said that the behavious is undefined if the memory areas
21660
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=603144
21661
In reference of http://lwn.net/Articles/414467/
21662
and http://article.gmane.org/gmane.comp.lib.glibc.alpha/15278
21666
usleep() suspends calling thread, not process
21670
Change single quote to double quote in shell session example
21671
The example section has a sample shell session containing:
21673
echo '|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s'
21675
But $PWD won't be expanded in single quotes. It should be double
21676
quotes around the entire argument or some other form.
21680
Added description of async-cancel-safe functions
21684
Reworded the text of various errors
21689
==================== Changes in man-pages-3.33 ====================
21691
Released: 2011-09-16, Munich
21697
The following people contributed patches/fixes or (noted in brackets
21698
in the changelog below) reports, notes and ideas that have been
21699
incorporated in changes in this release:
21701
Akira Fujita <a-fujita@rs.jp.nec.com>
21702
Alexander Schuch <Alex.Schuch@gmx.de>
21703
Andries Brouwer <Andries.Brouwer@cwi.nl>
21704
Brian M. Carlson <sandals@crustytoothpaste.net>
21705
Dan Jacobson <jidanni@jidanni.org>
21706
Folkert van Heusden <folkert.mobiel@gmail.com>
21707
Graham Gower <graham.gower@gmail.com>
21708
Hendrik Jan Thomassen <hjt@atcomputing.nl>
21709
Jan Engelhardt <jengelh@medozas.de>
21710
Joey Adams <joeyadams3.14159@gmail.com>
21711
Johannes Laire <johannes@laire.fi>
21712
Jon Grant <jg@jguk.org>
21713
Josh Triplett <josh@joshtriplett.org>
21714
Konstantin Ritt <ritt.ks@gmail.com>
21715
Luis Javier Merino <ninjalj@gmail.com>
21716
Michael Kerrisk <mtk.manpages@gmail.com>
21717
Mike Frysinger <vapier@gentoo.org>
21718
Mikel Ward <mikel@mikelward.com>
21719
Nick Black <dankamongmen@gmail.com>
21720
Paul Evans <leonerd@leonerd.org.uk>
21721
Petr Pisar <ppisar@redhat.com>
21722
Przemyslaw Pawelczyk <przemyslaw@pawelczyk.it>
21723
Regid Ichira <regid23@yahoo.com>
21724
Reuben Thomas <rrt@sc3d.org>
21725
Richard B. Kreckel <kreckel@ginac.de>
21726
Ryan Mullen <rmmullen@gmail.com>
21727
Sebastian Geiger <sbastig@gmx.net>
21728
Sebastian Unger <sebunger@gmx.net>
21729
Seonghun Lim <wariua@gmail.com>
21730
Serge E. Hallyn <serge.hallyn@canonical.com>
21731
Simon Cross <hodgestar@gmail.com>
21732
Simon Paillard <spaillard@debian.org>
21733
Stan Sieler <sieler@me.com>
21734
Timmy Lee <scuttimmy@gmail.com>
21735
Tolga Dalman <tolga.dalman@googlemail.com>
21736
Tomislav Jonjic <jonjic@cs.unibo.it>
21737
Yuri Kozlov <yuray@komyakino.ru>
21738
Wei Luosheng <weiluosheng001@gmail.com>
21740
Apologies if I missed anyone!
21743
Newly documented interfaces in existing pages
21744
---------------------------------------------
21748
Added new syncfs() system call
21749
syncfs() was added in Linux 2.6.39.
21752
New and changed links
21753
---------------------
21757
New link for sync(2).
21765
Global fix: properly escape minus sign
21768
Changes to individual pages
21769
---------------------------
21773
Note that CLONE_STOPPED was removed in 2.6.38
21776
Michael Kerrisk [Sebastian Geiger]
21777
Note that the first argv[] value should contain name of executable
21780
Michael Kerrisk [Reuben Thomas]
21781
Note that F_GETFL also retrieves file access mode
21784
Michael Kerrisk [Ryan Mullen]
21785
Remove mention of kernel versions in discussion of RLIMIT_CPU
21786
Michael Kerrisk [Seonghun Lim]
21787
Fix example program and add _FILE_OFFSET_BITS requirement
21790
Michael Kerrisk [Brian M. Carlson]
21791
Clarify EINVAL error
21792
See http://bugs.debian.org/cgi-bin/bugreport.cgi?625747
21793
Michael Kerrisk [Seonghun Lim]
21794
Simplify and correct text for EPERM error
21798
Fix off-by-one error in a memory range
21800
Fix small bug in example program
21801
The description of the example program says that it makes the
21802
third page "read-only". Thus use PROT_READ instead of PROT_NONE.
21805
Folkert van Heusden
21806
Remove text describing O_CLOEXEC as Linux-specific
21807
O_CLOEXEC is specified in POSIX.1-2008, as noted
21808
elsewhere in the page.
21811
Michael Kerrisk [Dan Jacobson]
21812
SEE ALSO: Add readlink(1)
21816
Since 2.6.33, 'out_fd' can refer to any file type
21817
Linux kernel commit cc56f7de7f00d188c7c4da1e9861581853b9e92f
21818
meant sendfile(2) can work with any output file.
21820
Shift text on falling back to read()/write() to NOTES
21821
Michael Kerrisk [Tolga Dalman]
21822
Remove mention of kernel version for 'in_fd' argument
21824
Add an explicit reference to splice(2)
21825
Unlike sendfile(), splice() can transfer data
21826
between a pair of sockets.
21829
Michael Kerrisk [Tolga Dalman]
21830
Add a little info about ucontext_t
21833
Michael Kerrisk [Jon Grant]
21834
Small rewording of ENAMETOOLONG error
21838
Some rewrites to description of sync()
21842
Added fanotify_init() and fanotify_mark() to syscall list
21844
Added new 2.6.39 system calls
21846
Updated for Linux 3.0 system calls
21848
Update kernel version at head of syscall list
21850
Update to mention 3.x kernel series
21853
Michael Kerrisk [Serge E. Hallyn]
21854
Update for kernel 2.6.37 changes
21855
Document /proc/sys/kernel/dmesg_restrict.
21856
Document CAP_SYSLOG.
21859
Michael Kerrisk [Alexander Schuch]
21860
NOTES: Fix description of "Seconds since the Epoch"
21863
Michael Kerrisk [Josh Triplett]
21864
Note behavior when timerdfd_settime() old_value is NULL
21865
See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
21867
Fix small error in description of timerfd_settime()
21871
Remove redundant EINTR description
21874
Hendrik Jan Thomassen
21875
Improve EBUSY description
21881
Michael Kerrisk [Richard B. Kreckel, Andries Brouwer]
21882
Fix formula describing function
21883
The man pages for cacos(), cacosh(), catan(), catanh()
21884
contain incorrect formulae describing the functions.
21888
Add example program
21892
Add example program
21899
SEE ALSO: Add reference to inverse function
21903
Add example program
21907
Add example program
21916
SEE ALSO Add reference to "arc" inverse function
21920
SEE ALSO: add cexp(3)
21924
SEE ALSO: Add reference to clog(2)
21927
Michael Kerrisk [Jan Engelhardt]
21928
Fix header file and feature test macro requirements for crypt_r()
21932
Clean up description of error message source
21933
In the second paragraph of DESCRIPTION section, one of the
21934
sources of error messages is incorrect: the four functions obtain
21935
error message only from errno, and "a code" is just relevant
21936
with errc() and warnc(), which are not present on Linux.
21937
see http://www.unix.com/man-page/freebsd/3/ERR/ .
21939
Then, the third paragraph becomes a duplicate.
21944
See http://bugs.debian.org/cgi-bin/bugreport.cgi?614021
21948
Update ERRORS section
21949
EINVAL can occur for hdestroy_r().
21950
EINVAL can't occur for hcreate().
21954
Michael Kerrisk [Mikel Ward]
21955
ERRORS: EBADF can also occur for nonwritable file descriptor
21956
As noted in the DESCRIPTION, the file descriptor must be writable
21957
in order to place a lock.
21961
Reorder prototypes in SYNOPSIS
21962
calloc() comes before realloc() in the other sections,
21963
so should do in SYNOPSIS, too.
21967
SEE ALSO: add reference to wcstombs(3)
21970
Michael Kerrisk [Sebastian Unger]
21971
Clarify that comparison interprets bytes as "unsigned char"
21974
Michael Kerrisk [Seonghun Lim]
21976
Since glibc 2.3, resolved_path can be non-NULL (with the
21977
semantics already documented in the page).
21981
Add ENOENT/ENOTDIR errors
21984
Michael Kerrisk [Luis Javier Merino]
21985
Remove misleading sentence about signal(2) and system call interruption
21988
Michael Kerrisk [Jon Grant]
21989
SEE ALSO: Add strnlen(3)
21992
Michael Kerrisk [Jon Grant]
21993
CONFORMING TO: Note that strnlen() is in POSIX.1-2008
21996
Michael Kerrisk [Tolga Dalman]
21997
Fix NOTES section constants
22001
Use "terminal special characters" consistently throughout page
22002
Michael Kerrisk [Paul Evans]
22003
Add documentation of _POSIX_VDISABLE
22004
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=627841
22006
Add a description of STATUS character
22008
Added description of SWTCH character
22010
Add names of terminal special characters
22012
List terminal special characters in alphabetical order
22016
SEE ALSO: add mbstowcs(3)
22021
Linux 3.0 (commit f8df13e0a901fe55631fed66562369b4dba40f8b)
22022
implements \E[3J to allow scrambling content of console
22023
including scroll-back buffer
22024
(http://thread.gmane.org/gmane.linux.kernel/1125792).
22027
Michael Kerrisk [Stan Sieler]
22028
Add description of 'PPid' field of /proc/PID/status
22029
Michael Kerrisk [Stan Sieler]
22030
Add description of 'SigQ' field of /proc/PID/status
22033
Michael Kerrisk [Serge E. Hallyn]
22034
Document CAP_SYSLOG and related changes in Linux 2.6.37
22036
File capabilities are no longer optional
22037
Starting with Linux 2.6.33, the CONFIG_SECURITY_FILE_CAPABILITIES
22038
has been removed, and file capabilities are always part of the
22043
Updated SEE ALSO list to include all complex math functions
22046
Michael Kerrisk [Simon Cross]
22047
Fix description of address notation: "8 4-digit hexadecimal numbers"
22051
Remove crufty repeated info about LinuxThreads
22055
Add pointer to cmsg(3) for an example of the use of SCM_RIGHTS
22058
==================== Changes in man-pages-3.34 ====================
22060
Released: 2011-09-23, Munich
22066
The following people contributed patches/fixes or (noted in brackets
22067
in the changelog below) reports, notes and ideas that have been
22068
incorporated in changes in this release:
22070
Alan Curry <pacman@kosh.dhis.org>
22071
Benjamin Poirier <benjamin.poirier@gmail.com>
22072
Brian M. Carlson <sandals@crustytoothpaste.net>
22073
David Howells <dhowells@redhat.com>
22074
David Prévot <taffit@debian.org>
22075
Denis Barbier <bouzim@gmail.com>
22076
Doug Goldstein <cardoe@cardoe.com>
22077
Eric Blake <eblake@redhat.com>
22078
Guillem Jover <guillem@hadrons.org>
22079
Jon Grant <jg@jguk.org>
22080
Michael Kerrisk <mtk.manpages@gmail.com>
22081
Neil Horman <nhorman@tuxdriver.com>
22082
Paul Pluzhnikov <ppluzhnikov@google.com>
22083
Reuben Thomas <rrt@sc3d.org>
22084
Stefan Puiu <stefan.puiu@gmail.com>
22085
Stephan Mueller <stephan.mueller@atsec.com>
22086
Stephen Cameron <scameron@beardog.cce.hp.com>
22087
Sunil Mushran <sunil.mushran@oracle.com>
22089
Apologies if I missed anyone!
22092
New and rewritten pages
22093
-----------------------
22096
Michael Kerrisk [Stephan Mueller]
22097
New page for rt_sigqueueinfo(2) and rt_tgsigqueueinfo(2)
22098
This replaces the previous '.so' man page link file for
22099
rt_sigqueueinfo.2, which linked to this sigqueue() man page.
22103
New man page for cciss driver
22104
I obtained the information in this man page as a consequence
22105
of having worked on the cciss driver for the past several years,
22106
and having written considerable portions of it.
22112
New man page for the hpsa driver
22113
I obtained the information in this man page as a consequence
22114
of being the main author of the hpsa driver.
22119
Newly documented interfaces in existing pages
22120
---------------------------------------------
22123
Michael Kerrisk [David Howells]
22124
Document AT_NO_AUTOMOUNT
22125
This flag was added in Linux 2.6.38.
22128
Michael Kerrisk [Eric Blake, Sunil Mushran]
22129
Document SEEK_HOLE and SEEK_DATA
22130
These flags, designed for discovering holes in a file,
22131
were added in Linux 3.1. Included comments from Eric
22132
Blake and Sunil Mushran.
22136
Add MADV_HUGEPAGE and MADV_NOHUGEPAGE
22137
Document the MADV_HUGEPAGE and MADV_NOHUGEPAGE flags added to
22138
madvise() in Linux 2.6.38.
22141
New and changed links
22142
---------------------
22144
rt_tgsigqueueinfo.2
22146
New link to new rt_sigqueueinfo.2 page
22150
Create link to page that was relocated to section 3
22158
Change reference to "sigqueue(2)" to "sigqueue(3)"
22161
Changes to individual pages
22162
---------------------------
22166
ERRORS: Add EPERM and ESPIPE errors
22169
Michael Kerrisk [Alan Curry, Reuben Thomas]
22170
Remove suspect note about 'whence' being incorrect English
22174
PR_SET_DUMPABLE makes process non-ptrace-attachable
22178
Document using st_size to allocate the buffer
22180
Added copyright text + changelog note for Guillem Jover's patch
22182
sched_setscheduler.2
22184
Document 2.6.39 changes to rules governing changes from SCHED_IDLE policy
22185
Since Linux 2.6.39, unprivileged processes under the
22186
SCHED_IDLE policy can switch to another nonrealtime
22187
policy if their nice value falls within the range
22188
permitted by their RLIMIT_NICE limit.
22192
SEE ALSO: Add rt_sigqueueinfo (2)
22195
Michael Kerrisk [Brian M. Carlson]
22196
Add pointers to better, thread-safe alternative functions
22197
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=606899
22201
Add _ISOC95_SOURCE to feature test macro requirements
22202
Since glibc 2.12, _ISOC95_SOURCE can also be used to expose
22203
prototype of this function.
22206
Michael Kerrisk [Jon Grant]
22207
Fix text mentioning terminating null
22211
Replace explicit mention of rt_tgsigqueueinfo() with SEE ALSO reference
22215
Move this page to section 3
22216
Now that the underlying system call rt_sigqueueinfo(2) is
22217
properly documented, move sigqueue() to Section 3, since
22218
it is really a library function.
22220
Update text in line with existence of new rt_sigqueueinfo.2 page
22224
Improve description of 'maxlen' argument
22225
It's worth clarifying 'maxlen' is in wide-char units, not bytes.
22229
Add _ISOC95_SOURCE to feature test macro requirements
22230
Since glibc 2.12, _ISOC95_SOURCE can also be used to expose
22231
prototype of these functions.
22233
feature_test_macros.7
22235
Document _ISOC95_SOURCE
22236
_ISOC95_SOURCE was added in glibc 2.12 as a means
22237
to expose C90 Amendment 1 definitions.
22240
Benjamin Poirier [Neil Horman]
22241
Improve description of IP_MTU_DISCOVER
22245
SEE ALSO: Add rt_sigqueueinfo(2)