1 ==================== Changes in man-pages-3.78 ====================
3 Released: ????-??-??, Munich
9 The following people contributed patches/fixes or (noted in brackets
10 in the changelog below) reports, notes, and ideas that have been
11 incorporated in changes in this release:
13 Akihiro Motoki <amotoki@gmail.com>
14 Alexey Ishchuk <aishchuk@linux.vnet.ibm.com>
15 Carlos O'Donell <carlos@redhat.com>
16 Christian Seiler <christian@iwakd.de>
17 Daniel J Blueman <daniel@quora.org>
18 David Drysdale <drysdale@google.com>
19 David Herrmann <dh.herrmann@gmail.com>
20 Elie De Brauwer <eliedebrauwer@gmail.com>
21 Elliot Hughes <enh@google.com>
22 Jessica McKellar <jessica.mckellar@gmail.com>
23 Kees Cook <keescook@chromium.org>
24 Michael Hayes <mike@aiinc.ca>
25 Michael Kerrisk <mtk.manpages@gmail.com>
26 Rich Felker <dalias@aerifal.cx>
27 Vince Weaver <vincent.weaver@maine.edu>
29 Apologies if I missed anyone!
32 New and rewritten pages
33 -----------------------
36 David Drysdale, Michael Kerrisk [Rich Felker]
37 New page for execveat(2)
40 Michael Kerrisk, David Herrmann
41 New page for memfd_create() system call
42 Including notes about file sealing
46 New page for s390 s390_pci_mmio_write() and s390_pci_mmio_read()
47 New manual page for the new PCI MMIO memory access system
48 calls, s390_pci_mmio_write() and s390_pci_mmio_read(),
49 added for the s390 platform.
52 Newly documented interfaces in existing pages
53 ---------------------------------------------
56 David Herrmann [Michael Kerrisk]
57 Document F_ADD_SEALS and F_GET_SEALS commands
61 Document /proc/sys/vm/compact_memory
63 Document /proc/sys/fs/nr_open
71 New link to new s390_pci_mmio_write(2) page
74 Changes to individual pages
75 ---------------------------
79 Add reference to RLIMIT_NOFILE for EMFILE error
81 Add reference to RLIMIT_NOFILE for EBADF error on 'newfd'.
86 SEE ALSO: add execveat(2)
94 ERRORS: add EPERM for operation denied by file seal
98 ERRORS: add EBUSY case for F_SETPIPE_SZ
100 Add reference to RLIMIT_NOFILE for F_DUPFD EINVAL error on 'arg'.
102 ERRORS: add open file description lock error cases
106 Update text on RLIMIT_NOFILE ceiling to refer to /proc/sys/fs/file-max
109 Michael Kerrisk [Daniel J Blueman]
116 SEE ALSO: add memfd_create(2)
120 Refer to RLIMIT_NOFILE for explanation of EMFILE error
122 Add execveat(2) in system call list under "Rationale for openat()"
126 Clarify description of overflow events
127 Update the perf_event_open manpage to be more consistent when
128 discussing overflow events. It merges the discussion of
129 poll-type notifications with those generated by SIGIO
131 This addresses the remaining FIXMEs is the document.
133 Remove inaccurate paragraph describing attr.config
134 Remove an inaccurate paragraph about values in the attr.config
135 field. This information was never true in any released kernel;
136 it somehow snuck into the manpage because it is still described
137 this way in tools/perf/design.txt in the kernel source tree.
139 Correct the kernel version number for PERF_COUNT_HW_CACHE_NODE
141 Add some kernel version numbers to various fields and constants
147 Ptrace and siginfo details
148 While writing some additional seccomp tests, I realized
149 PTRACE_EVENT_SECCOMP wasn't documented yet. Fixed this, and added
150 additional notes related to ptrace events SIGTRAP details.
154 Update details on glibc readv()/writev() wrapper behavior
155 And add a historical detail about Linux 2.0.
159 Mention RLIMIT_NOFILE as a possible cause of EINVAL error
164 Add mips an d arm64 to tables, along with some further
165 details on these architectures,
169 Add s390_pci_mmio_read(2) and s390_pci_mmio_write(2)
171 Note kernel() version that introduced get_kernel_syms()
172 Note kernel version that introduced ppc_rtas()
173 Note kernel version that introduced create_module()
174 Note kernel version that added setup()
176 Remove some details for sync_file_range2()
177 Make the table a bit simpler. The details can anyway be
178 found in the system call man page.
181 Michael Kerrisk [Elliot Hughes]
182 If both tv_sec fields are UTIME_OMIT, the file need not exist
183 As noted by Elliot, if both tv_sec fields are UTIME_OMIT,
184 utimensat() will return success even if the file does not exist.
188 The RLIMIT_NOFILE resource limit is a common cause of EMFILE
192 SEE ALSO: add execveat(2)
196 Consistency fix: use "stream" as name for "FILE *" argument
197 Harmonize all the manual pages to use "stream" for FILE*
198 instead of randomly using "fp" or "stream." Choosing something
199 and being consistent helps users scan the man pages quickly
200 and understand what they are looking at.
204 Rewrite the script+close-on-exec problem as a BUG
205 Also, add one or two details about this scenario.
207 The natural idiom when using fexecve() is to use the close-on-exec flag
211 Consistency fix: use "stream" as name for "FILE *" argument
215 Consistency fix: use "stream" as name for "FILE *" argument
219 Consistency fix: use "stream" as name for "FILE *" argument
223 Consistency fix: use "stream" as name for "FILE *" argument
227 Consistency fix: use "stream" as name for "FILE *" argument
230 Michael Kerrisk [Carlos O'Donell]
231 Describe return value when 'uid' is not found
235 Consistency fix: use "stream" as name for "FILE *" argument
239 Consistency fix: use "stream" as name for "FILE *" argument
243 Consistency fix: use "stream" as name for "FILE *" argument
247 Note that posix_fallocate() is implemented using fallocate(2)
251 Consistency fix: use "stream" as name for "FILE *" argument
252 Harmonize all the manual pages to use "stream" for FILE*
253 instead of randomly using "fp" or "stream." Choosing something
254 and being consistent helps users scan the man pages quickly
255 and understand what they are looking at.
259 Correct variable name
263 Remove bogus statement about NR_OPEN being a ceiling for file-max