summaryrefslogtreecommitdiffstats
Commit message (Collapse)AuthorAgeLines
* epoll_wait.2: Use syscall(SYS_...); for system calls without a wrapperrejectedAlejandro Colomar2021-09-05-1/+7
| | | | Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* eventfd.2, poll.2, timerfd_create.2,Alejandro Colomar2021-09-05-27/+27
| | | | | | | | | | | | | | | | circleq.3, list.3, qsort.3, slist.3, stailq.3, tailq.3, inotify.7: Use sizeof consistently Use ``sizeof`` consistently through all the examples in the following way: - Use the name of the variable instead of its type as argument for ``sizeof``. Rationale: https://www.kernel.org/doc/html/v5.8/process/coding-style.html#allocating-memory Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
* endian.3, inet_net_pton.3: Use 'PRIx32' rather than "%x" when printing ↵Alejandro Colomar2021-09-05-4/+6
| | | | | | 'uint32_t' values Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
* sigevent.3: New link to new documented type in system_data_types(7)Alejandro Colomar2021-09-05-0/+1
| | | | Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
* system_data_types.7, ....3: Add types to system_data_types(7)Alejandro Colomar2021-09-05-6/+470
| | | | | | | | | | | | | | | | | | | | loff_t.3, system_data_types.7: Add 'loff_t' Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> error_t.3, system_data_types.7: Add 'error_t' Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> system_data_types.7, [u]int_*ast*_t.3: Add int_*N_t types to system_data_types(7) Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com> system_data_types.7, __int128.3, unsigned-__int128.3: Add 128-bit GCC-specific types to system_data_types(7) Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
* system_data_types.7: time_t: Add Versions noteAlejandro Colomar2021-09-05-0/+3
| | | | | | Prior to POSIX.1-2008, POSIX allowed time_t to be a real-floating type. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
* system_data_types.7: srcfixAlejandro Colomar2021-09-05-22/+0
| | | | | | | | | | | | Remove comment specifying the layout of the page. The page has grown enough to document the layout by itself. Anything that is not clear enough in the current layout should follow documented conventions. This comment is not needed anymore. Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
* copy_file_range.2: Update cross-filesystem support for 5.12Alejandro Colomar2021-09-05-4/+23
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Linux 5.12 fixes a regression. Cross-filesystem (introduced in 5.3) copies were buggy. Move the statements documenting cross-fs to BUGS. Kernels 5.3..5.11 should be patched soon. State version information for some errors related to this. Reported-by: Luis Henriques <lhenriques@suse.de> Reported-by: Amir Goldstein <amir73il@gmail.com> Related: <https://lwn.net/Articles/846403/> Cc: Greg KH <gregkh@linuxfoundation.org> Cc: Michael Kerrisk <mtk.manpages@gmail.com> Cc: Anna Schumaker <anna.schumaker@netapp.com> Cc: Jeff Layton <jlayton@kernel.org> Cc: Steve French <sfrench@samba.org> Cc: Miklos Szeredi <miklos@szeredi.hu> Cc: Trond Myklebust <trond.myklebust@hammerspace.com> Cc: Alexander Viro <viro@zeniv.linux.org.uk> Cc: "Darrick J. Wong" <darrick.wong@oracle.com> Cc: Dave Chinner <dchinner@redhat.com> Cc: Nicolas Boichat <drinkcat@chromium.org> Cc: Ian Lance Taylor <iant@google.com> Cc: Luis Lozano <llozano@chromium.org> Cc: Andreas Dilger <adilger@dilger.ca> Cc: Olga Kornievskaia <aglo@umich.edu> Cc: Christoph Hellwig <hch@infradead.org> Cc: ceph-devel <ceph-devel@vger.kernel.org> Cc: linux-kernel <linux-kernel@vger.kernel.org> Cc: CIFS <linux-cifs@vger.kernel.org> Cc: samba-technical <samba-technical@lists.samba.org> Cc: linux-fsdevel <linux-fsdevel@vger.kernel.org> Cc: Linux NFS Mailing List <linux-nfs@vger.kernel.org> Cc: Walter Harms <wharms@bfs.de> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* basename.3: SYNOPSIS: Add missing 'const'Alejandro Colomar2021-09-05-1/+1
| | | | | | | | | | | | | | Glibc uses 'const' for the basename() parameter. Fix the prototype. ...... .../glibc$ grep_glibc_prototype basename string/string.h:511: extern char *basename (const char *__filename) __THROW __nonnull ((1)); .../glibc$ Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* ptrace.2: Document ptrace with 'int' instead of 'enum'Alejandro Colomar2021-09-05-2/+1
| | | | | | | | | | | | There's a bit of inconsistency with enum in the manual pages. The following functions are implemented using 'enum': pciconfig_iobase(2), prlimit(2), ptrace(2), mcheck(3), mcheck_pedantic(3), mcheck_status(3). Of them, all mcheck*() functions are documented using enum. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
* prctl.2: Rewrite the description of PR_SET_SECCOMP to defer to seccomp(2)Michael Kerrisk2021-09-02-46/+22
| | | | | | | | | | | | | | | | There is a lot of unnecessary duplication of content of the seccomp material in prctl(2) and seccomp(2). Trevor Woerner also noted that there is an error in prctl(2), where it says that the filters "are run in order until the first non-allow result is seen", which contradicts the correct statement in seccomp(2) that *all* filters are executed. So, rewrite the seccomp material in prctl(2) to strip out most of the content duplicated in seccomp(2), and replace the removed text with statements deferring to to seccomp(2). Reported-by: Trevor Woerner <twoerner@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* prctl.2: Note that seccomp(2) is preferred over prctl(2) for setting seccomp ↵Michael Kerrisk2021-09-01-1/+2
| | | | | | mode Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* malloc.3: Clarify that realloc() may move the memory blockMichael Kerrisk2021-08-31-1/+2
| | | | | | | Make it clearer, early in the discussion, that realloc() may move the block. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* malloc.3: wfixMichael Kerrisk2021-08-31-1/+2
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* malloc.3: ffixMichael Kerrisk2021-08-31-1/+3
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* malloc.3: Add some structuring to improve readabilityMichael Kerrisk2021-08-31-6/+11
| | | | | | | Add some subsection (.SS) headings and paragraph breaks in DESCRIPTION, to make the page more easily readable. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* malloc_hook.3: Modernize for glibc 2.34Paul Eggert2021-08-31-3/+10
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* malloc.3: Modernize for glibc 2.34Paul Eggert2021-08-31-84/+79
| | | | | | | | | | | glibc has tightened up its rules for replacing the memory allocator. I went through the malloc man page and looked for how it documented malloc() and related functions, and fixed discrepancies with glibc malloc() documentation and/or implementation. I also reorganized the portability discussion so that portability issues can be seen more clearly. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* mount_namespaces.7: Update references to ↵Michael Kerrisk2021-08-31-4/+4
| | | | | | | | | Documentation/filesystems/sharedsubtree.rst Documentation/filesystems/sharedsubtree.txt has changed to Documentation/filesystems/sharedsubtree.rst. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* proc.5: Fixes various references to kernel docs in Documentation/Michael Kerrisk2021-08-31-7/+18
| | | | | | | | | Especially the change to .rst format in the kernel Documentation/ tree has rendered many of the references in this manual page obsolete. Fix them. Reported-by: Vito Caputo <vcaputo@pengaru.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* operator.7: Reorder symbols as in the standard (C11)Alejandro Colomar2021-08-31-4/+4
| | | | | | | | This makes it easier to compare this page to the standard, to get more details about the rules between operators. Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* operator.7: Fix precedence of the 'cast operator'Alejandro Colomar2021-08-31-1/+2
| | | | | | | | | | | | | | | | | | | | | | Unary operators are mentioned in C11::6.5.3, and casts are in C11::6.5.4 (they are mentioned in order of precedence). And from note 85 (in section 6.5) in that same C11 standard, major subsections 6.5.X are sorted by precedence. As an example (from Jakub), `sizeof(int)+1` is interpreted as `(sizeof(int))+1`, and not `sizeof((int)+1)`. I used C11 and not C18 (the latest) because at least in the draft copy of C18 that I have, there are a few important typos in that section, while the draft copy of C11 that I have is free of those typos. And C11 and C18 are almost identical, with no major changes to the language. Reported-by: David Sletten <david.paul.sletten@gmail.com> Cc: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* termios.3: Use bold style for B0Pali Rohár2021-08-31-1/+3
| | | | | Signed-off-by: Pali Rohár <pali@kernel.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* termios.3: wfixMichael Kerrisk2021-08-31-1/+1
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* termios.3: Clarify zero argument for cfsetispeed()Pali Rohár2021-08-31-1/+5
| | | | | | | | Zero in this case refers to literal constant 0 and not symbolic constant B0. Signed-off-by: Pali Rohár <pali@kernel.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* Changes.old: tfixMichael Kerrisk2021-08-31-1/+1
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* exit_group.2: Remove a confusing reference to _exit(2) in DESCRIPTIONMichael Kerrisk2021-08-31-3/+1
| | | | | | | | | | | | | As noted by Jakub: BTW, the exit_group.2 man page could use an update (possibly by merging it into exit.2): it says that the "system call is is equivalent to _exit(2) except that it terminates not only the calling thread, but all threads in the calling process's thread group", which isn't helpful these days. Reported-by: Jakub Wilk <jwilk@jwilk.net> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* exit_group.2: SEE ALSO: s/exit(2)/_exit(2)/Michael Kerrisk2021-08-31-1/+1
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* _exit.2: Clarify the distinction between the raw syscall and the wrapper ↵Michael Kerrisk2021-08-31-7/+14
| | | | | | | | | function Further clarify the difference between the raw _exit() system call and the C library wrapper. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* ioctl_tty.2: TIOCGSID is equivalent to tcgetsid()Pali Rohár2021-08-30-0/+3
| | | | | Signed-off-by: Pali Rohár <pali@kernel.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* Changes.old: tfixMichael Kerrisk2021-08-27-1/+1
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* syscalls.2: Add Linux 5.14 system callsMichael Kerrisk2021-08-27-1/+2
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* memfd_secret.2: SEE ALSO: add memfd_create(2)Michael Kerrisk2021-08-27-0/+1
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* memfd_create.2: SEE ALSO: add memfd_secret(2)Michael Kerrisk2021-08-27-0/+1
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* memfd_secret.2: Minor edits to Mike Rapoport's patchMichael Kerrisk2021-08-27-6/+6
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* memfd_secret.2: wfixMichael Kerrisk2021-08-27-1/+2
| | | | | | Added "RAM-based" after consultation with Mike Rapoport Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* memfd_secret.2: New page describing memfd_secret() system callMike Rapoport2021-08-27-0/+154
| | | | | Signed-off-by: Mike Rapoport <rppt@linux.ibm.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* Changes.old: tfix in 5.13 changelogMichael Kerrisk2021-08-27-8/+8
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* Changes.old: tfixMichael Kerrisk2021-08-27-0/+2
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* Changes.old: Add missing entry in 5.13 changelogMichael Kerrisk2021-08-27-0/+9
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* Start of man-pages-5.14: updating Changes and Changes.oldMichael Kerrisk2021-08-27-326/+363
|
* Start of man-pages-5.14: updating .Announce and .lsm filesMichael Kerrisk2021-08-27-4/+4
|
* Start of man-pages-5.14: renaming .Announce and .lsm filesMichael Kerrisk2021-08-27-0/+0
|
* Ready for 5.13man-pages-5.13Michael Kerrisk2021-08-27-3/+3
|
* iconv.1, ldd.1, accept.2, access.2, add_key.2, arch_prctl.2, bpf.2, chmod.2, ↵Michael Kerrisk2021-08-27-78/+78
| | | | | | chown.2, close_range.2, copy_file_range.2, execve.2, execveat.2, fanotify_mark.2, futex.2, futimesat.2, getpriority.2, intro.2, ioctl_tty.2, keyctl.2, link.2, membarrier.2, mkdir.2, mknod.2, mlock.2, mount.2, mount_setattr.2, open.2, open_by_handle_at.2, perf_event_open.2, pidfd_open.2, readlink.2, readv.2, rename.2, request_key.2, seccomp.2, sigaction.2, stat.2, statx.2, symlink.2, syscalls.2, umount.2, unlink.2, utimensat.2, wait.2, bsearch.3, fflush.3, getaddrinfo.3, getauxval.3, getopt.3, getsubopt.3, mkfifo.3, pthread_mutex_consistent.3, pthread_setname_np.3, pthread_tryjoin_np.3, scandir.3, sem_wait.3, stailq.3, strlen.3, strstr.3, termios.3, tsearch.3, wcslen.3, wcstok.3, wordexp.3, proc.5, capabilities.7, cgroups.7, fanotify.7, mount_namespaces.7, namespaces.7, path_resolution.7, pipe.7, posixoptions.7, user_namespaces.7, vdso.7, iconvconfig.8, ld.so.8: tstamp Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* Changes: Ready for 5.13Michael Kerrisk2021-08-27-3/+325
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* getaddrinfo.3: Note that 'errno' is set in parallel with EAI_SYSTEMAlejandro Colomar2021-08-27-2/+2
| | | | | | | | | | | | | | The previous wording wasn't very explicit, leaving room for believing that 'errno' may be 0 after returning EAI_SYSTEM. Use a wording similar to other pages, for added consistency. [mtk: edited commit message title; also, POSIX notes that 'errno' is set in this case.] Reported-by: Cristian Morales Vega <christian.morales.vega@gmail.com> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* iconv.1, iconvconfig.8: FILES: note that files may be under /usr/lib64 ↵Michael Kerrisk2021-08-24-0/+8
| | | | | | | | | rather than /lib/64 See https://bugzilla.kernel.org/show_bug.cgi?id=214163 Reported-by: Christopher Yeleighton <giecrilj@stegny.2a.pl> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* mount_namespaces.7: tfixMichael Kerrisk2021-08-22-1/+1
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
* mount_namespaces.7: Minor wording fixMichael Kerrisk2021-08-22-1/+1
| | | | Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>