summaryrefslogtreecommitdiffstats
path: root/Changes
blob: dfc77af5e26f7dccf05c87ef8694ab1f12c4a73a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
==================== Changes in man-pages-3.58 ====================

Released: 2014-02-11, Munich


Contributors
------------

The following people contributed patches/fixes or (noted in brackets
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:

Cyril Hrubis <chrubis@suse.cz>
Daniel Borkmann <dborkman@redhat.com>
David Prévot <taffit@debian.org>
Fabrice Bauzac <libnoon@gmail.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
Network Nut <sillystack@gmail.com>
Ola Olsson <ola1olsson@gmail.com>
Peng Haitao <penght@cn.fujitsu.com>
Peter Schiffer <pschiffe@redhat.com>
Simone Piccardi <piccardi@truelite.it>
Simon Paillard <spaillard@debian.org>
Yuri Kozlov <yuray@komyakino.ru>
Марк Коренберг <socketpair@gmail.com>
未卷起的浪 <ayjj_8109@qq.com>

Apologies if I missed anyone!


Newly documented interfaces in existing pages
---------------------------------------------

pipe.2
    Michael Kerrisk
        Document the pipe2() O_DIRECT flag added in Linux 3.4

packet.7
    Daniel Borkmann
        Document PACKET_QDISC_BYPASS
            New in Linux 3.14.


Global changes
--------------

Various pages
    Simon Paillard
        Formatting fix: add space between function and () if BR or IR
            Detected through the regex:
                git grep -P '^\.(BR|IR) [\w]*\([\d]*\)$'

Various pages
    Simon Paillard
        Formatting fix: add space between word and punctuation if BR or IR
            Detected through the regex:
                git grep -P '^\.(BR|IR) [^ ]*[,\.]$'

            Could probably be extended to match more cases and fix in perl.

Various pages
    Michael Kerrisk
        Use Oxford comma

gettid.2
restart_syscall.2
passwd.5
socket.7
    Michael Kerrisk
        Fix order of SEE ALSO entries


Changes to individual pages
---------------------------

epoll_wait.2
    Michael Kerrisk  [Network Nut]
        Remove word "minimum" from the description of 'timeout'

epoll_wait.2
poll.2
select.2
    Michael Kerrisk
        Go into more detail on timeout and when call will cease blocking

getxattr.2
listxattr.2
removexattr.2
setxattr.2
    Michael Kerrisk  [Fabrice Bauzac]
        Correct header file is <sys/xattr.h> (not <xattr/xattr.h>)
            See https://bugzilla.kernel.org/show_bug.cgi?id=70141

msgctl.2
    Cyril Hrubis
        Add note about ignored arg to IPC_RMID

prctl.2
    Michael Kerrisk  [Марк Коренберг]
        PR_SET_PDEATHSIG value is preserved across execve(2)

recv.2
    Michael Kerrisk
        Rework and reorganize the text in various parts of the page.
        Isolate details specific to recv() vs recvfrom() vs recvmsg()
            Place details specific to each system call under a
            a separate subheading.
        Rework discussion of 'src_addr' and 'addrlen' for recvfrom()
        Add description of 'buf' and 'len' in recvfrom() section
        'addrlen' should be 0 (*not* NULL) when 'src_addr' is NULL
        Improve text describing recvfrom() call that is equivalent to recv()
    Michael Kerrisk  [未卷起的浪]
        Describe the various cases where the return value can be 0

shmctl.2
    Michael Kerrisk
        Note that 'buf' is ignored for IPC_RMID

symlinkat.2
    Michael Kerrisk
        Make argument names consistent with symlink(2) page

isalpha.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread-safe
            The functions isalnum(), isalpha(), isascii(), isblank(),
            iscntrl(), isdigit(), isgraph(), islower(), isprint(),
            ispunct(), isspace(), isupper() and isxdigit() are thread safe.

isatty.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread-safe
            The function isatty() is thread safe.

isgreater.3
    Peng Haitao
        ATTRIBUTES: Note macros that are thread-safe
            The macros isgreater(), isgreaterequal(), isless(),
            islessequal(), islessgreater() and isunordered() are thread safe.

iswalnum.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread safe with exceptions
            The function iswalnum() is thread safe with exceptions.

iswalpha.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread safe with exceptions
            The function iswalpha() is thread safe with exceptions.

iswblank.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread safe with exceptions
            The function iswblank() is thread safe with exceptions.

iswcntrl.3
    Peng Haitao
        ATTRIBUTES: Note function that is thread safe with exceptions
            The function iswcntrl() is thread safe with exceptions.

lockf.3
    Michael Kerrisk  [Simone Piccardi]
        Fix incorrect argument mentioned under EINVAL error

pthread_kill.3
    Michael Kerrisk
        Add feature test macro requirements

pthread_sigmask.3
    Michael Kerrisk
        Add feature test macro requirements

strtoul.3
    Peng Haitao
        ATTRIBUTES: Note functions that are thread safe with exceptions
            The functions strtoul(), strtoull() and strtouq() are thread safe
            with exceptions.

nscd.conf.5
    Peter Schiffer
        Add note about default values

proc.5
    Michael Kerrisk
        SEE ALSO: Add some further kernel Documentation/sysctl files

man-pages.7
    Michael Kerrisk
        ATTRIBUTES sections come after VERSIONS
            Peng Haitao has consistently ordered the ATTRIBUTES after
            VERSIONS, so adjust the text in man-pages.7

vdso.7
    Michael Kerrisk
        Add words "virtual dynamic shared object" in DESCRIPTION