From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from omta002.cacentral1.a.cloudfilter.net (omta002.cacentral1.a.cloudfilter.net [3.97.99.33]) by sourceware.org (Postfix) with ESMTPS id 43C0A3858C2C for ; Thu, 30 Sep 2021 14:54:42 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 43C0A3858C2C Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=SystematicSW.ab.ca Authentication-Results: sourceware.org; spf=none smtp.mailfrom=systematicsw.ab.ca Received: from shw-obgw-4003a.ext.cloudfilter.net ([10.228.9.183]) by cmsmtp with ESMTP id VexRmNzaBps7PVxSLmG8hw; Thu, 30 Sep 2021 14:54:41 +0000 Received: from SystematicSW.ab.ca ([68.147.0.90]) by cmsmtp with ESMTP id VxSLmutmIcHSBVxSLmvLns; Thu, 30 Sep 2021 14:54:41 +0000 X-Authority-Analysis: v=2.4 cv=I4EG+Psg c=1 sm=1 tr=0 ts=6155cfb1 a=T+ovY1NZ+FAi/xYICV7Bgg==:117 a=T+ovY1NZ+FAi/xYICV7Bgg==:17 a=VwQbUJbxAAAA:8 a=GcyzOjIWAAAA:8 a=pWDFVDnqYgHsvLGPPcwA:9 a=gum9uCRGmoYA:10 a=AjGcO6oz07-iQ99wixmX:22 a=hQL3dl6oAZ8NdCsdz28n:22 From: "Cygwin Linux Man Pages Package Maintainer" To: "Cygwin Announcements" Reply-To: "Cygwin" Date: Thu, 30 Sep 2021 08:50:10 -0600 Message-Id: <20210930085010.52757-1-Brian.Inglis@SystematicSW.ab.ca> Subject: New: man-pages-linux 5.13 - Linux Manual Pages X-CMAE-Envelope: MS4xfO2DKVjTuTzwVpGfyP+01iQOtUXFREJyQW4tKAoPKPyGrz61n7q8P13DBdVHWkNzrLCNZDV/xnBEteselzGg1cJmDsO9kah0QTShO2ReJDiGOVh6k1U4 gbMyoQWAzLOb35mWFuOWXsJFBUUMtWEHBC7+TykWluUquhzsUWVxZXw3dLOAtostL+sy+HcGfLRB28DO4WcB5ZYOIbvDbkFYwuxjR5+u+DTQ60WUkSHHtfc1 Qcy5VwqkyO0YpFju5823gW5wgUWMCGH2Ar9GDzYYpec= X-Spam-Status: No, score=-1160.8 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS, KAM_LAZY_DOMAIN_SECURITY, KAM_SHORT, RCVD_IN_BARRACUDACENTRAL, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=no autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: cygwin-announce@cygwin.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Read-only mailing list announcing new and updated Cygwin packages List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Sep 2021 14:54:44 -0000 The following new package has been added to the Cygwin distribution: * man-pages-linux 5.13 Documents the Linux kernel system calls and C library interfaces used by programs, plus system and administrative utilities, devices, file system, file, and data formats, and related information. For more information, please see the project home page: https://kernel.org/doc/man-pages/ You may also search and read the pages online: https://man7.org/linux/man-pages/ As Cygwin has its own man pages with some conflicts, these man pages are installed under /usr/share/man/linux/, so by default searching or viewing these pages requires the option: $ apropos -m|--systems linux ... $ man -m|--systems linux ... Cygwin man pages are under the default system "man", so for convenience both systems may be specified separated by comma e.g. $ man -m man,linux ... The path or option may also be added explicitly to a users MANPATH or alias e.g. $ export MANPATH=$MANPATH:/usr/share/man/linux $ alias apropos='apropos -m man,linux' $ alias man='man -m man,linux' Add -a to show both Cygwin and Linux manual pages if present, or swap the order to prioritize Linux. For recent changes, please see below, or after installation read /usr/share/doc/man-pages-linux/CHANGES: https://man7.org/linux/man-pages/changelog.html Version 5.13 2021-08-27 New and rewritten pages * mount_setattr.2 New manual page for the mount_setattr() system call Newly documented interfaces in existing pages * futex.2 Document FUTEX_LOCK_PI2 * ioctl_tty.2 Document ioctls: TCGETS2, TCSETS2, TCSETSW2, TCSETSF2 * pidfd_open.2 Document PIDFD_NONBLOCK * seccomp_unotify.2 Document SECCOMP_ADDFD_FLAG_SEND * sigaction.2 Document SA_EXPOSE_TAGBITS and the flag support detection protocol * statx.2 Document STATX_MNT_ID * capabilities.7 * user_namespaces.7 Describe CAP_SETFCAP for mapping UID 0 * mount_namespaces.7 More clearly explain the notion of locked mounts For a long time, this manual page has had a brief discussion of "locked" mounts, without clearly saying what this concept is, or why it exists. Expand the discussion with an explanation of what locked mounts are, why mounts are locked, and some examples of the effect of locking. * user_namespaces.7 Document /proc/PID/projid_map * ld.so.8 Document --list-tunables option added in glibc 2.33 Global changes Few/Various pages: * ERRORS: correct alphabetic order * Place SEE ALSO entries in correct order * Arrange .SH sections in correct order * Consistently use '*argv[]' * Fix EBADF error description Make the description of the EBADF error for invalid 'dirfd' more uniform. In particular, note that the error only occurs when the pathname is relative, and that it occurs when the 'dirfd' is neither valid *nor* has the value AT_FDCWD. * ERRORS: combine errors into a single alphabetic list These pages split out extra errors for some APIs into a separate list. Probably, the pages are easier to read if all errors are combined into a single list. Note that there still remain a few pages where the errors are listed separately for different APIs. For the moment, it seems best to leave those pages as is, since the error lists are largely distinct in those pages. * Terminology clean-up: "mount point" ==> "mount" Many times, these pages use the terminology "mount point", where "mount" would be better. A "mount point" is the location at which a mount is attached. A "mount" is an association between a filesystem and a mount point. * accept.2 * access.2 * getpriority.2 * mlock.2 ERRORS: combine errors into a single list These pages split out errors into separate lists (perhaps per API, perhaps "may" vs "shall", perhaps "Linux-specific" vs standard(??)), but there's no good reason to do this. It makes the error list harder to read, and is inconsistent with other pages. So, combine the errors into a single list. * fanotify_mark.2 * futimesat.2 * mount_setattr.2 * statx.2 * symlink.2 * mkfifo.3 Refer the reader to openat(2) for explanation of why 'dirfd' is useful Changes to individual pages * iconv.1 * iconvconfig.8 FILES: note that files may be under /usr/lib64 rather than /lib/64 * ldd.1 Fix example command * add_key.2 * keyctl.2 * request_key.2 Note that the "libkeyutils" package provides * close_range.2 Glibc 2.34 has added a close_range() wrapper * execve.2 The pathname given to interpreter is not necessarily absolute SEE ALSO: getauxval(3) getauxval(3) is useful background regarding execve(2). * fanotify_mark.2 ERRORS: add missing EBADF error for invalid 'dirfd' * ioctl_tty.2 Update DTR example Do not include unused (and incompatible) header file termios.h and include required header files for puts() and close() functions. * mount.2 ERRORS: add EPERM error for case where a mount is locked Refer the reader to mount_namespaces(7) for details. SEE ALSO: add mount_setattr(2) * open.2 Explicitly describe the EBADF error that can occur with openat() In particular, specifying an invalid file descriptor number in 'dirfd' can be used as a check that 'pathname' is absolute. Clarify that openat()'s dirfd must be opened with O_RDONLY or O_PATH Add mount_setattr(2) to list of 'dirfd' APIs * open_by_handle_at.2 ERRORS: add missing EBADF error for invalid 'dirfd' * readv2.2 Note preadv2(..., RWF_NOWAIT) bug in BUGS section * readv.2 * pipe.7 Make text on pipe writes more general to avoid a confusion in writev(2) * seccomp.2 Clarify that bad system calls kill the thread (not the process) * syscalls.2 Add quotactl_fd(); remove quotactl_path() quotactl_path() was never wired up in Linux 5.13. It was replaced instead by quotactl_fd() Add system calls that are new in 5.13 * umount.2 ERRORS: add EINVAL for case where mount is locked * wait.2 Add ESRCH for when pid == INT_MIN ERRORS: document EAGAIN for waitid() on a PID file descriptor * getaddrinfo.3 Note that 'errno' is set in parallel with EAI_SYSTEM * getauxval.3 SEE ALSO: add execve(2) * getopt.3 Further clarification of 'optstring' * pthread_setname_np.3 EXAMPLES: remove a bug by simplifying the code * strlen.3 * wcslen.3 Recommend alternatives where input buffer might not be null-terminated * strstr.3 Document special case for empty needle * termios.3 SPARC architecture has 4 different Bnnn constants Add information how to set baud rate to any other value Use bold style for Bnn and EXTn macro constants Document missing baud-rate constants * tsearch.3 NAME: add twalk_r * wcstok.3 Fix type mismatch in the example * proc.5 Add /proc/PID/projid_map, referring reader to user_namespaces(7) Remove duplicated /proc/[pid]/gid_map entry * mount_namespaces.7 Terminology clean-up: "mount point" ==> "mount" Many times, this page uses the terminology "mount point", where "mount" would be better. A "mount point" is the location at which a mount is attached. A "mount" is an association between a filesystem and a mount point. SEE ALSO: add mount_setattr(2) * namespaces.7 Fix confusion caused by text reorganization * path_resolution.7 Improve description of trailing slashes * posixoptions.7 Fix legacy functions list (s/getcwd/getwd/) * user_namespaces.7 Fix a reference to a kernel document Add a definition of "global root" * vdso.7 Update CLOCK_REALTIME_COARSE + CLOCK_MONOTONIC_COARSE info for powerpc Add y2038 compliant gettime for ppc/32