summaryrefslogtreecommitdiffstats
path: root/Changes
blob: 0c4f48977ae1aa289530e789532e0b25322c7c57 (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
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
==================== Changes in man-pages-3.78 ====================

Released: 2015-01-22, 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:

Akihiro Motoki <amotoki@gmail.com>
Alexey Ishchuk <aishchuk@linux.vnet.ibm.com>
Carlos O'Donell <carlos@redhat.com>
Christian Seiler <christian@iwakd.de>
Daniel J Blueman <daniel@quora.org>
David Drysdale <drysdale@google.com>
David Herrmann <dh.herrmann@gmail.com>
Elie De Brauwer <eliedebrauwer@gmail.com>
Elliot Hughes <enh@google.com>
Jessica McKellar <jessica.mckellar@gmail.com>
Kees Cook <keescook@chromium.org>
Michael Hayes <mike@aiinc.ca>
Michael Kerrisk <mtk.manpages@gmail.com>
Rich Felker <dalias@aerifal.cx>
Vince Weaver <vincent.weaver@maine.edu>

Apologies if I missed anyone!


New and rewritten pages
-----------------------

execveat.2
    David Drysdale, Michael Kerrisk  [Rich Felker]
        New page for execveat(2)

memfd_create.2
    Michael Kerrisk, David Herrmann
        New page for memfd_create() system call
             Including notes about file sealing

s390_pci_mmio_write.2
    Alexey Ishchuk
        New page for s390 s390_pci_mmio_write() and s390_pci_mmio_read()
            New manual page for the new PCI MMIO memory access system
            calls, s390_pci_mmio_write() and s390_pci_mmio_read(),
            added for the s390 platform.


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

fcntl.2
    David Herrmann  [Michael Kerrisk]
        Document F_ADD_SEALS and F_GET_SEALS commands

proc.5
    Elie De Brauwer
        Document /proc/sys/vm/compact_memory
    Michael Kerrisk
        Document /proc/sys/fs/nr_open


New and changed links
---------------------

s390_pci_mmio_read.2
    Michael Kerrisk
        New link to new s390_pci_mmio_write(2) page


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

dup.2
    Michael Kerrisk
        Add reference to RLIMIT_NOFILE for EMFILE error
    Michael Kerrisk
        Add reference to RLIMIT_NOFILE for EBADF error on 'newfd'.

execve.2
fexecve.3
    Michael Kerrisk
        SEE ALSO: add execveat(2)

fallocate.2
mmap.2
open.2
truncate.2
write.2
    Michael Kerrisk
        ERRORS: add EPERM for operation denied by file seal

fcntl.2
    Michael Kerrisk
        ERRORS: add EBUSY case for F_SETPIPE_SZ
    Michael Kerrisk
        Add reference to RLIMIT_NOFILE for F_DUPFD EINVAL error on 'arg'.
    Michael Kerrisk
        ERRORS: add open file description lock error cases

getrlimit.2
    Michael Kerrisk
        Update text on RLIMIT_NOFILE ceiling to refer to /proc/sys/fs/file-max

mbind.2
    Michael Kerrisk  [Daniel J Blueman]
        Clarify EFAULT text

mmap.2
shmget.2
shm_open.3
    Michael Kerrisk
        SEE ALSO: add memfd_create(2)

open.2
    Michael Kerrisk
        Refer to RLIMIT_NOFILE for explanation of EMFILE error
    Michael Kerrisk
        Add execveat(2) in system call list under "Rationale for openat()"

perf_event_open.2
    Vince Weaver
        Clarify description of overflow events
            Update the perf_event_open manpage to be more consistent when
            discussing overflow events.  It merges the discussion of
            poll-type notifications with those generated by SIGIO
            signal handlers.
            This addresses the remaining FIXMEs is the document.
    Vince Weaver
        Remove inaccurate paragraph describing attr.config
            Remove an inaccurate paragraph about values in the attr.config
            field.  This information was never true in any released kernel;
            it somehow snuck into the manpage because it is still described
            this way in tools/perf/design.txt in the kernel source tree.
    Michael Kerrisk
        Correct the kernel version number for PERF_COUNT_HW_CACHE_NODE
    Michael Kerrisk
        Add some kernel version numbers to various fields and constants

ptrace.2
sigaction.2
seccomp.2
    Kees Cook
        Ptrace and siginfo details
            While writing some additional seccomp tests, I realized
            PTRACE_EVENT_SECCOMP wasn't documented yet. Fixed this, and added
            additional notes related to ptrace events SIGTRAP details.

readv.2
    Michael Kerrisk
        Update details on glibc readv()/writev() wrapper behavior
            And add a historical detail about Linux 2.0.

select.2
    Michael Kerrisk
        Mention RLIMIT_NOFILE as a possible cause of EINVAL error

syscall.2
    Kees Cook
        Add arm64 and mips
            Add mips an d arm64 to tables, along with some further
            details on these architectures,

syscalls.2
    Michael Kerrisk
        Add s390_pci_mmio_read(2) and s390_pci_mmio_write(2)
    Michael Kerrisk
        Note kernel() version that introduced get_kernel_syms()
        Note kernel version that introduced ppc_rtas()
        Note kernel version that introduced create_module()
        Note kernel version that added setup()
    Michael Kerrisk
        Remove some details for sync_file_range2()
            Make the table a bit simpler. The details can anyway be
            found in the system call man page.

utimensat.2
    Michael Kerrisk  [Elliot Hughes]
        If both tv_sec fields are UTIME_OMIT, the file need not exist
            As noted by Elliot, if both tv_sec fields are UTIME_OMIT,
            utimensat() will return success even if the file does not exist.

errno.3
    Michael Kerrisk
        The RLIMIT_NOFILE resource limit is a common cause of EMFILE

exec.3
    Michael Kerrisk
        SEE ALSO: add execveat(2)

fclose.3
    Carlos O'Donell
        Consistency fix: use "stream" as name for "FILE *" argument
            Harmonize all the manual pages to use "stream" for FILE*
            instead of randomly using "fp" or "stream." Choosing something
            and being consistent helps users scan the man pages quickly
            and understand what they are looking at.

fexecve.3
    Michael Kerrisk
        Rewrite the script+close-on-exec problem as a BUG
            Also, add one or two details about this scenario.
    Michael Kerrisk
        The natural idiom when using fexecve() is to use the close-on-exec flag

fmemopen.3
    Michael Kerrisk
        Consistency fix: use "stream" as name for "FILE *" argument

fopencookie.3
    Michael Kerrisk
        Consistency fix: use "stream" as name for "FILE *" argument

getgrent_r.3
    Carlos O'Donell
        Consistency fix: use "stream" as name for "FILE *" argument

getline.3
    Michael Kerrisk
        Consistency fix: use "stream" as name for "FILE *" argument

getmntent.3
    Carlos O'Donell
        Consistency fix: use "stream" as name for "FILE *" argument

getpw.3
    Michael Kerrisk  [Carlos O'Donell]
        Describe return value when 'uid' is not found

getpwent_r.3
    Carlos O'Donell
        Consistency fix: use "stream" as name for "FILE *" argument

getspnam.3
    Carlos O'Donell
        Consistency fix: use "stream" as name for "FILE *" argument

malloc_info.3
    Carlos O'Donell
        Consistency fix: use "stream" as name for "FILE *" argument

posix_fallocate.3
    Michael Kerrisk
        Note that posix_fallocate() is implemented using fallocate(2)

putgrent.3
    Carlos O'Donell
        Consistency fix: use "stream" as name for "FILE *" argument
            Harmonize all the manual pages to use "stream" for FILE*
            instead of randomly using "fp" or "stream." Choosing something
            and being consistent helps users scan the man pages quickly
            and understand what they are looking at.

locale.5
    Akihiro Motoki
        Correct variable name

proc.5
    Michael Kerrisk
        Remove bogus statement about NR_OPEN being a ceiling for file-max