Compare commits

..

No commits in common. "33248cfe50ebb8762208e7ef3264676dad71b016" and "911789ee7626fff60dcdcf059b81e10fdecf0921" have entirely different histories.

44 changed files with 90 additions and 583 deletions

View File

@ -1,4 +1,4 @@
==================== Changes in man-pages-5.13 ====================
==================== Changes in man-pages-5.12 ====================
Released: ????-??-??, Munich

View File

@ -54191,395 +54191,3 @@ tcp.7
uri.7
Michael Kerrisk
Note that 'logical' quoting is the norm in Europe
==================== Changes in man-pages-5.12 ====================
Released: 2021-06-20, Christchurch
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:
Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Akihiro Motoki <amotoki@gmail.com>
Alejandro Colomar <alx.manpages@gmail.com>
Alyssa Ross <hi@alyssa.is>
Aurelien Aptel <aaptel@suse.com>
Borislav Petkov <bp@suse.de>
Bruce Merry <bmerry@ska.ac.za>
Chris Keilbart <keilbartchris@gmail.com>
Christian Brauner <christian@brauner.io>
Christoph Anton Mitterer <calestyo@scientia.net>
dann frazier <dann.frazier@canonical.com>
Dmitry V. Levin <ldv@altlinux.org>
Florian Weimer <fw@deneb.enyo.de>
Huang Ying <ying.huang@intel.com>
Jakub Wilk <jwilk@jwilk.net>
James O. D. Hunt <jamesodhunt@gmail.com>
Jann Horn <jannh@google.com>
Johannes Berg <johannes@sipsolutions.net>
Jon Murphy <jonmurphy1618@gmail.com>
Josh Triplett <josh@joshtriplett.org>
Katsuhiro Numata <byakkomon@gmail.com>
Kees Cook <keescook@chromium.org>
Mark Kettenis <kettenis@openbsd.org>
Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Rapoport <rppt@linux.vnet.ibm.com>
Peter Xu <peterx@redhat.com>
Sargun Dhillon <sargun@sargun.me>
Stefan Puiu <stefan.puiu@gmail.com>
Štěpán Němec <stepnem@gmail.com>
thomasavoss <thomasavoss@protonmail.com>
Topi Miettinen <toiwoton@gmail.com>
Tycho Andersen <tycho@tycho.pizza>
Utkarsh Singh <utkarsh190601@gmail.com>
Vishwajith K <vishuvikas1996@gmail.com>
Walter Harms <wharms@bfs.de>
Yang Xu <xuyang2018.jy@fujitsu.com>
Zhiheng Li <phoenix_lzh@sina.com>
наб <nabijaczleweli@nabijaczleweli.xyz>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
seccomp_unotify.2
Michael Kerrisk [Tycho Andersen, Jann Horn, Kees Cook, Christian Brauner
Sargun Dhillon]
New page documenting the seccomp user-space notification mechanism
MAX.3
Alejandro Colomar
New page to document MAX() and MIN()
Newly documented interfaces in existing pages
---------------------------------------------
seccomp.2
Tycho Andersen [MichaelKerrisk]
Document SECCOMP_GET_NOTIF_SIZES
Tycho Andersen
Document SECCOMP_FILTER_FLAG_NEW_LISTENER [Michael Kerrisk]
Tycho Andersen
Document SECCOMP_RET_USER_NOTIF [Michael Kerrisk]
set_mempolicy.2
Huang Ying [Alejandro Colomar, "Huang, Ying"]
Add mode flag MPOL_F_NUMA_BALANCING
userfaultfd.2
Peter Xu [Alejandro Colomar, Mike Rapoport]
Add UFFD_FEATURE_THREAD_ID docs
Peter Xu [Alejandro Colomar, Mike Rapoport]
Add write-protect mode docs
proc.5
Michael Kerrisk
Document /proc/sys/vm/sysctl_hugetlb_shm_group
system_data_types.7
Alejandro Colomar
Add 'blksize_t'
Alejandro Colomar
Add 'blkcnt_t'
Alejandro Colomar
Add 'mode_t'
Alejandro Colomar
Add 'struct sockaddr'
Alejandro Colomar
Add 'cc_t'
Alejandro Colomar
Add 'socklen_t'
New and changed links
---------------------
blkcnt_t.3
Alejandro Colomar
New link to system_data_types(7)
blksize_t.3
Alejandro Colomar
New link to system_data_types(7)
cc_t.3
Alejandro Colomar
New link to system_data_types(7)
MIN.3
Michael Kerrisk
New link to MIN.3
mode_t.3
Alejandro Colomar
New link to system_data_types(7)
sockaddr.3
Alejandro Colomar
New link to system_data_types(7)
socklen_t.3
Alejandro Colomar
New link to system_data_types(7)
Global changes
--------------
Many pages
Alejandro Colomar
SYNOPSIS: Use syscall(SYS_...); for system calls without a wrapper
Many pages
Alejandro Colomar
SYNOPSIS: Document why each header is required
Many pages
Alejandro Colomar
SYNOPSIS: Remove unused includes
Various pages
Alejandro Colomar
Add note about the use of syscall(2)
Various pages
Alejandro Colomar
SYNOPSIS: Miscellaneous fixes to includes
A few pages
Alejandro Colomar
SYNOPSIS: Add missing 'const'
Changes to individual pages
---------------------------
dup.2
Michael Kerrisk
Rewrite the description of dup() somewhat
As can be seen by any number of StackOverflow questions, people
persistently misunderstand what dup() does, and the existing manual
page text, which talks of "copying" a file descriptor doesn't help.
Rewrite the text a little to try to prevent some of these
misunderstandings, in particular noting at the start that dup()
allocates a new file descriptor.
Michael Kerrisk
Clarify what silent closing means
Alejandro Colomar
SYNOPSIS: Use consistent comments through pages
epoll_wait.2
Alejandro Colomar
Move misplaced subsection to NOTES from BUGS
execveat.2
Michael Kerrisk
Library support has been added in glibc 2.34
_exit.2
Michael Kerrisk
Add a little more detail on the raw _exit() system cal
exit_group.2
Alejandro Colomar
Use 'noreturn' in prototypes
flock.2
Aurelien Aptel [Alejandro Colomar]
Add CIFS details
CIFS flock() locks behave differently than the standard.
Give an overview of those differences.
ioperm.2
Alejandro Colomar
Remove obvious comment
memfd_create.2
mmap.2
shmget.2
Michael Kerrisk [Yang Xu]
Document the EPERM error for huge page allocations
This error can occur if the caller is does not have CAP_IPC_LOCK
and is not a member of the sysctl_hugetlb_shm_group.
mmap.2
Bruce Merry
Clarify that MAP_POPULATE is best-effort
mount.2
Topi Miettinen
Document SELinux use of MS_NOSUID mount flag
open.2
Alejandro Colomar [Walter Harms]
Fix bug in linkat(2) call example
AT_EMPTY_PATH works with empty strings (""), but not with NULL
(or at least it's not obvious).
Michael Kerrisk
Make it clearer that an FD is an index into the process's FD table
Sometimes people are confused, thinking a file descriptor is just a
number....
perfmonctl.2
Michael Kerrisk
This system call was removed in Linux 5.10
pipe.2
Alejandro Colomar
SYNOPSIS: Fix incorrect prototype
Michael Kerrisk
Rearrange SYNOPSIS so that minority version pipe() is at end
ptrace.2
Dmitry V. Levin [Alejandro Colomar, Mathieu Desnoyers]
Mention PTRACE_GET_SYSCALL_INFO in RETURN VALUE section
seccomp.2
Michael Kerrisk
Reorder list of SECCOMP_SET_MODE_FILTER flags alphabetically
(No content changes.)
Michael Kerrisk
SEE ALSO: add seccomp_unotify(2)
select.2
Michael Kerrisk
Strengthen the warning regarding the low value of FD_SETSIZE
All modern code should avoid select(2) in favor of poll(2)
or epoll(7).
Michael Kerrisk
Relocate sentence about the fd_set value-result arguments to BUGS
syscalls.2
Michael Kerrisk
perfmonctl(2) was removed in Linux 5.10
bswap.3
Alejandro Colomar
bswap_*() are implemented using functions
Even though it's true that they are macros,
it's transparent to the user.
The user will see their results casted to unsigned types
after the conversion due to the underlying functions,
so it's better to document these as the underlying functions,
specifying the types.
cmsg.3
unix.7
Michael Kerrisk
Refer to seccomp_unotify(2) for an example of SCM_RIGHTS usage
cpow.3
Alejandro Colomar
Use 'complex' after the type consistently
ctime.3
Michael Kerrisk [Katsuhiro Numata]
Restore documentation of 'tm_gmtoff' field
errno.3
Alejandro Colomar [Florian Weimer, Mark Kettenis]
Fix ENODATA text
ENODATA is an XSI STREAMS extension (not base POSIX).
exec.3
Josh Triplett [Alejandro Colomar]
Clarify that execvpe() uses PATH from the caller, not envp
Josh Triplett [Alejandro Colomar]
Fix description of 'e' variants
The envp argument specifies the environment of the new process
image, not "the environment of the caller".
fflush.3
Alejandro Colomar
SEE ALSO: Add fpurge(3)
getline.3
наб [Ahelenia Ziemiańska, Alejandro Colomar]
!*lineptr is sufficient
No implementation or spec requires *n to be 0 to allocate
a new buffer.
getopt.3
James O. D. Hunt [Alejandro Colomar]
Clarify behaviour
printf.3
Utkarsh Singh [Alejandro Colomar]
Add overall structure of format string
pthread_attr_setinheritsched.3
pthread_attr_setschedparam.3
Alejandro Colomar
SYNOPSIS: Use 'restrict' in prototypes
pthread_mutexattr_setrobust.3
Michael Kerrisk
Note that the *_np() APIs are deprecated since glibc 2.34
Alejandro Colomar
SYNOPSIS: Remove incorrect 'const'
pthread_mutex_consistent.3
Michael Kerrisk
Note that pthread_mutexattr_setrobust() is now deprecated
pthread_yield.3
Michael Kerrisk
Note that this function is deprecated since glibc 2.34
rpc.3
Alejandro Colomar
SYNOPSIS: Fix prototypes (misc.)
scanf.3
Alyssa Ross [Alejandro Colomar]
Clarify that %n supports type modifiers
xdr.3
Alejandro Colomar
SYNOPSIS: Fix prototype types
Use the same types glibc uses, and add a missing 'const'.
capabilities.7
Michael Kerrisk
CAP_IPC_LOCK also governs memory allocation using huge pages
environ.7
Josh Triplett [Alejandro Colomar]
Remove obsolete admonishment of the GZIP environment variable
kernel_lockdown.7
dann frazier [Alejandro Colomar]
Remove description of lifting via SysRq (not upstream)
The patch that implemented lockdown lifting via SysRq ended up
getting dropped[*] before the feature was merged upstream. Having
the feature documented but unsupported has caused some confusion
for our users.
mount_namespaces.7
namespaces.7
Michael Kerrisk
Relocate reference to pam_namespace(8) from namespaces.7 to
mount_namespaces.7.
signal.7
Michael Kerrisk
Add reference to seccomp_unotify(2)
The seccomp user-space notification feature can cause changes in
the semantics of SA_RESTART with respect to system calls that
would never normally be restarted. Point the reader to the page
that provide further details.
vsock.7
Alyssa Ross
ioctls are on /dev/vsock, not sockets

View File

@ -1,7 +1,7 @@
RELEASE
The Linux man page maintainer proudly announces. . .
man-pages-5.13.tar.gz - man pages for Linux
man-pages-5.12.tar.gz - man pages for Linux
Differences from the previous manual pages release are listed in
the file "Changes".

View File

@ -1,13 +1,13 @@
Begin3
Title: Section 2, 3, 4, 5 and 7 man pages for Linux
Version: 5.13
Version: 5.12
Entered-date: ????-??-??
Description: Linux manual pages
Keywords: man pages
Author: several
Maintained-by: Michael Kerrisk <mtk.manpages@gmail.com>
Primary-site: http://www.kernel.org/pub/linux/docs/man-pages
????k man-pages-5.13.tar.gz
????k man-pages-5.12.tar.gz
Copying-policy: several; the pages are all freely distributable as long as
nroff source is provided
End

View File

@ -22,7 +22,7 @@
.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
.TH EXIT_GROUP 2 2021-06-20 "Linux" "Linux Programmer's Manual"
.TH EXIT_GROUP 2 2008-11-27 "Linux" "Linux Programmer's Manual"
.SH NAME
exit_group \- exit all threads in a process
.SH SYNOPSIS

View File

@ -25,8 +25,8 @@
ioctl_fideduperange \- share some the data of one file with another file
.SH SYNOPSIS
.nf
.BR "#include <linux/fs.h>" " /* Definition of " FIDEDUPERANGE " and
.BR " FILE_DEDUPE_* " constants */
.BR "#include <linux/fs.h>" " /* Definition of " FIDEDUPERANGE " and
.BR " FILE_DEDUPE_* " constants */"
.B #include <sys/ioctl.h>
.PP
.BI "int ioctl(int " src_fd ", FIDEDUPERANGE, struct file_dedupe_range *" arg );

View File

@ -21,7 +21,7 @@
.\" with various additions by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\"
.TH IOPRIO_SET 2 2021-06-20 "Linux" "Linux Programmer's Manual"
.TH IOPRIO_SET 2 2019-03-06 "Linux" "Linux Programmer's Manual"
.SH NAME
ioprio_get, ioprio_set \- get/set I/O scheduling class and priority
.SH SYNOPSIS

View File

@ -221,12 +221,6 @@ Do not allow programs to be executed from this filesystem.
.B MS_NOSUID
Do not honor set-user-ID and set-group-ID bits or file capabilities
when executing programs from this filesystem.
In addition, SELinux domain
transitions require the permission
.IR nosuid_transition ,
which in turn needs
also the policy capability
.IR nnp_nosuid_transition .
.\" (This is a security feature to prevent users executing set-user-ID and
.\" set-group-ID programs from removable disk devices.)
.TP

View File

@ -56,7 +56,7 @@ pipe, pipe2 \- create pipe
.B struct fd_pair {
.B " long fd[2];"
.B "};"
.B struct fd_pair pipe(void);
.B struct fd_pair pipe();
.fi
.SH DESCRIPTION
.BR pipe ()

View File

@ -25,7 +25,7 @@
.\"
.\" Commit ecb8ac8b1f146915aa6b96449b66dd48984caacc
.\"
.TH PROCESS_MADVISE 2 2021-06-20 "Linux" "Linux Programmer's Manual"
.TH PROCESS_MADVISE 2 2021-01-12 "Linux" "Linux Programmer's Manual"
.SH NAME
process_madvise \- give advice about use of memory to a process
.SH SYNOPSIS

View File

@ -38,7 +38,7 @@ s390_guarded_storage \- operations with z/Architecture guarded storage facility
.PP
.IR Note :
glibc provides no wrapper for
.BR s390_guarded_storage (),
.BR s390_guarded_storage (2),
necessitating the use of
.BR syscall (2).
.SH DESCRIPTION

View File

@ -36,7 +36,7 @@ s390_runtime_instr \- enable/disable s390 CPU run-time instrumentation
.PP
.IR Note :
glibc provides no wrapper for
.BR s390_runtime_instr (),
.BR s390_runtime_instr (2),
necessitating the use of
.BR syscall (2).
.SH DESCRIPTION

View File

@ -38,7 +38,7 @@ s390_sthyi \- emulate STHYI instruction
.PP
.IR Note :
glibc provides no wrapper for
.BR s390_sthyi (),
.BR s390_sthyi (2),
necessitating the use of
.BR syscall (2).
.SH DESCRIPTION

View File

@ -31,25 +31,20 @@
seccomp \- operate on Secure Computing state of the process
.SH SYNOPSIS
.nf
.BR "#include <linux/seccomp.h>" " /* Definition of " SECCOMP_* " constants */"
.BR "#include <linux/filter.h>" " /* Definition of " "struct sock_fprog" " */"
.BR "#include <linux/audit.h>" " /* Definition of " AUDIT_* " constants */"
.BR "#include <linux/signal.h>" " /* Definition of " SIG* " constants */"
.BR "#include <sys/ptrace.h>" " /* Definition of " PTRACE_* " constants */"
.B #include <linux/seccomp.h>
.B #include <linux/filter.h>
.B #include <linux/audit.h>
.B #include <linux/signal.h>
.B #include <sys/ptrace.h>
.\" Kees Cook noted: Anything that uses SECCOMP_RET_TRACE returns will
.\" need <sys/ptrace.h>
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.PP
.BI "int syscall(SYS_seccomp, unsigned int " operation ", unsigned int " flags ,
.BI " void *" args );
.BI "int seccomp(unsigned int " operation ", unsigned int " flags \
", void *" args );
.fi
.PP
.IR Note :
glibc provides no wrapper for
.BR seccomp (),
necessitating the use of
.BR syscall (2).
There is no glibc wrapper for this system call; see NOTES.
.SH DESCRIPTION
The
.BR seccomp ()
@ -935,6 +930,9 @@ Tile (since Linux 4.3)
PA-RISC (since Linux 4.6)
.\" User mode Linux since Linux 4.6
.PD
.PP
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.\"
.SS Caveats
There are various subtleties to consider when applying seccomp filters

View File

@ -22,7 +22,7 @@
.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
.TH SECCOMP_UNOTIFY 2 2021-06-20 "Linux" "Linux Programmer's Manual"
.TH SECCOMP_UNOTIFY 2 2020-10-01 "Linux" "Linux Programmer's Manual"
.SH NAME
seccomp_unotify \- Seccomp user-space notification mechanism
.SH SYNOPSIS

View File

@ -24,7 +24,7 @@
.\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com>
.\" more precise specification of behavior.
.\"
.TH SET_MEMPOLICY 2 2021-06-20 Linux "Linux Programmer's Manual"
.TH SET_MEMPOLICY 2 2020-12-21 Linux "Linux Programmer's Manual"
.SH NAME
set_mempolicy \- set default NUMA memory policy for a thread and its children
.SH SYNOPSIS

View File

@ -22,7 +22,7 @@
.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
.TH SET_TID_ADDRESS 2 2021-06-20 "Linux" "Linux Programmer's Manual"
.TH SET_TID_ADDRESS 2 2020-12-21 "Linux" "Linux Programmer's Manual"
.SH NAME
set_tid_address \- set pointer to thread ID
.SH SYNOPSIS

View File

@ -27,20 +27,16 @@
spu_create \- create a new spu context
.SH SYNOPSIS
.nf
.BR "#include <sys/spu.h>" " /* Definition of " SPU_* " constants */"
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.B #include <sys/types.h>
.B #include <sys/spu.h>
.PP
.BI "int syscall(SYS_spu_create, const char *" pathname \
", unsigned int " flags ,
.BI " mode_t " mode ", int " neighbor_fd );
.BI "int spu_create(const char *" pathname ", unsigned int " flags \
", mode_t " mode ,
.BI " int " neighbor_fd ");"
.fi
.PP
.IR Note :
glibc provides no wrapper for
.BR spu_create (),
necessitating the use of
.BR syscall (2).
There is no glibc wrapper for this system call; see NOTES.
.SH DESCRIPTION
The
.BR spu_create ()
@ -264,6 +260,9 @@ This call is Linux-specific and implemented only on the PowerPC
architecture.
Programs using this system call are not portable.
.SH NOTES
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
Note however, that
.BR spu_create ()
is meant to be used from libraries that implement a more abstract
interface to SPUs, not to be used from regular applications.

View File

@ -28,18 +28,13 @@
spu_run \- execute an SPU context
.SH SYNOPSIS
.nf
.BR "#include <sys/spu.h>" " /* Definition of " SPU_* " constants */"
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.B #include <sys/spu.h>
.PP
.BI "int spu_run(int " fd ", uint32_t *" npc ", uint32_t *" event );
.fi
.PP
.IR Note :
glibc provides no wrapper for
.BR spu_run (),
necessitating the use of
.BR syscall (2).
There is no glibc wrapper for this system call; see NOTES.
.SH DESCRIPTION
The
.BR spu_run ()
@ -200,6 +195,9 @@ This call is Linux-specific and implemented only by the PowerPC
architecture.
Programs using this system call are not portable.
.SH NOTES
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
Note however, that
.BR spu_run ()
is meant to be used from libraries that implement a more abstract
interface to SPUs, not to be used from regular applications.

View File

@ -41,6 +41,7 @@
stat, fstat, lstat, fstatat \- get file status
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.B #include <sys/stat.h>
.PP
.BI "int stat(const char *restrict " pathname ,
@ -49,7 +50,7 @@ stat, fstat, lstat, fstatat \- get file status
.BI "int lstat(const char *restrict " pathname ,
.BI " struct stat *restrict " statbuf );
.PP
.BR "#include <fcntl.h> " "/* Definition of " AT_* " constants */"
.BR "#include <fcntl.h> " "/* Definition of AT_* constants */"
.B #include <sys/stat.h>
.PP
.BI "int fstatat(int " dirfd ", const char *restrict " pathname ,

View File

@ -32,8 +32,9 @@
statx \- get file status (extended)
.SH SYNOPSIS
.nf
.BR "#include <fcntl.h> " "/* Definition of " AT_* " constants */"
.B #include <sys/stat.h>
.B #include <unistd.h>
.BR "#include <fcntl.h> " "/* Definition of AT_* constants */"
.PP
.BI "int statx(int " dirfd ", const char *restrict " pathname ", int " flags ,
.BI " unsigned int " mask ", struct statx *restrict " statxbuf );

View File

@ -32,18 +32,12 @@
subpage_prot \- define a subpage protection for an address range
.SH SYNOPSIS
.nf
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.PP
.BI "int syscall(SYS_subpage_prot, unsigned long " addr ", unsigned long " len ,
.BI " uint32_t *" map );
.BI "int subpage_prot(unsigned long " addr ", unsigned long " len \
", uint32_t *" map );
.fi
.PP
.IR Note :
glibc provides no wrapper for
.BR subpage_prot (),
necessitating the use of
.BR syscall (2).
There is no glibc wrapper for this system call; see NOTES.
.SH DESCRIPTION
The PowerPC-specific
.BR subpage_prot ()
@ -102,6 +96,9 @@ No library support is provided.
.SH CONFORMING TO
This system call is Linux-specific.
.SH NOTES
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.PP
Normal page protections (at the 64-kB page level) also apply;
the subpage protection mechanism is an additional constraint,
so putting 0 in a 2-bit field won't allow writes to a page that is otherwise

View File

@ -44,6 +44,7 @@
swapon, swapoff \- start/stop swapping to file/device
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.B #include <sys/swap.h>
.PP
.BI "int swapon(const char *" path ", int " swapflags );

View File

@ -39,7 +39,7 @@ symlink, symlinkat \- make a new name for a file
.PP
.BI "int symlink(const char *" target ", const char *" linkpath );
.PP
.BR "#include <fcntl.h> " "/* Definition of " AT_* " constants */"
.BR "#include <fcntl.h> " "/* Definition of AT_* constants */"
.B #include <unistd.h>
.PP
.BI "int symlinkat(const char *" target ", int " newdirfd \

View File

@ -44,8 +44,8 @@
syscall \- indirect system call
.SH SYNOPSIS
.nf
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.BR "#include <sys/syscall.h> " "/* For SYS_xxx definitions */"
.PP
.BI "long syscall(long " number ", ...);"
.fi

View File

@ -35,14 +35,10 @@ syslog, klogctl \- read and/or clear kernel message ring buffer;
set console_loglevel
.SH SYNOPSIS
.nf
.BR "#include <sys/klog.h>" " /* Definition of " SYSLOG_* " constants */"
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.PP
.BI "int syscall(SYS_syslog, int " type ", char *" bufp ", int " len );
.BI "int syslog(int " type ", char *" bufp ", int " len );
.PP
/* The glibc interface */
.B #include <sys/klog.h>
.B "#include <sys/klog.h>"
.PP
.BI "int klogctl(int " type ", char *" bufp ", int " len );
.fi

View File

@ -28,7 +28,7 @@
timer_create \- create a POSIX per-process timer
.SH SYNOPSIS
.nf
.BR "#include <signal.h>" " /* Definition of " SIGEV_* " constants */"
.B #include <signal.h>
.B #include <time.h>
.PP
.BI "int timer_create(clockid_t " clockid ", struct sigevent *restrict " sevp ,

View File

@ -31,22 +31,14 @@
tkill, tgkill \- send a signal to a thread
.SH SYNOPSIS
.nf
.BR "#include <signal.h>" " /* Definition of " SIG* " constants */"
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.PP
.BI "int syscall(SYS_tkill, pid_t " tid ", int " sig );
.PP
.B #include <signal.h>
.PP
.BI "int tgkill, pid_t " tgid ", pid_t " tid ", int " sig );
.BI "int tkill(pid_t " tid ", int " sig );
.BI "int tgkill(pid_t " tgid ", pid_t " tid ", int " sig );
.fi
.PP
.IR Note :
glibc provides no wrapper for
.BR tkill (),
necessitating the use of
.BR syscall (2).
There is no glibc wrapper for
.BR tkill ();
see NOTES.
.SH DESCRIPTION
.BR tgkill ()
sends the signal
@ -146,6 +138,10 @@ in
.BR clone (2)
for an explanation of thread groups.
.PP
Glibc does not provide a wrapper for
.BR tkill ();
call it using
.BR syscall (2).
Before glibc 2.30, there was also no wrapper function for
.BR tgkill ().
.SH SEE ALSO

View File

@ -46,6 +46,7 @@ truncate, ftruncate \- truncate a file to a specified length
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.B #include <sys/types.h>
.PP
.BI "int truncate(const char *" path ", off_t " length );
.BI "int ftruncate(int " fd ", off_t " length );

View File

@ -36,6 +36,7 @@
umask \- set file mode creation mask
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.B #include <sys/stat.h>
.PP
.BI "mode_t umask(mode_t " mask );

View File

@ -39,7 +39,7 @@ unlink, unlinkat \- delete a name and possibly the file it refers to
.PP
.BI "int unlink(const char *" pathname );
.PP
.BR "#include <fcntl.h> " "/* Definition of " AT_* " constants */"
.BR "#include <fcntl.h> " "/* Definition of AT_* constants */"
.B #include <unistd.h>
.PP
.BI "int unlinkat(int " dirfd ", const char *" pathname ", int " flags );

View File

@ -29,18 +29,14 @@
userfaultfd \- create a file descriptor for handling page faults in user space
.SH SYNOPSIS
.nf
.BR "#include <fcntl.h>" " /* Definition of " O_* " constants */"
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
.B #include <unistd.h>
.B #include <sys/types.h>
.B #include <linux/userfaultfd.h>
.PP
.BI "int syscall(SYS_userfaultfd, int " flags );
.BI "int userfaultfd(int " flags );
.fi
.PP
.IR Note :
glibc provides no wrapper for
.BR userfaultfd (),
necessitating the use of
.BR syscall (2).
There is no glibc wrapper for this system call; see NOTES.
.SH DESCRIPTION
.BR userfaultfd ()
creates a new userfaultfd object that can be used for delegation of page-fault
@ -579,6 +575,9 @@ non-page-fault events was added in Linux 4.11
is Linux-specific and should not be used in programs intended to be
portable.
.SH NOTES
Glibc does not provide a wrapper for this system call; call it using
.BR syscall (2).
.PP
The userfaultfd mechanism can be used as an alternative to
traditional user-space paging techniques based on the use of the
.BR SIGSEGV

View File

@ -33,6 +33,7 @@
utime, utimes \- change file last access and modification times
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.B #include <utime.h>
.PP
.BI "int utime(const char *" filename ", const struct utimbuf *" times );

View File

@ -28,7 +28,7 @@
utimensat, futimens \- change file timestamps with nanosecond precision
.SH SYNOPSIS
.nf
.BR "#include <fcntl.h>" " /* Definition of " AT_* " constants */"
.B #include <fcntl.h> /* Definition of AT_* constants */
.B #include <sys/stat.h>
.PP
.BI "int utimensat(int " dirfd ", const char *" pathname ,

View File

@ -30,6 +30,7 @@ vmsplice \- splice user pages to/from a pipe
.nf
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <fcntl.h>
.B #include <sys/uio.h>
.PP
.BI "ssize_t vmsplice(int " fd ", const struct iovec *" iov ,
.BI " size_t " nr_segs ", unsigned int " flags );

View File

@ -51,6 +51,7 @@
wait, waitpid, waitid \- wait for process to change state
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.B #include <sys/wait.h>
.PP
.BI "pid_t wait(int *" "wstatus" );

View File

@ -35,6 +35,9 @@
wait3, wait4 \- wait for process to change state, BSD style
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.B #include <sys/time.h>
.B #include <sys/resource.h>
.B #include <sys/wait.h>
.PP
.BI "pid_t wait3(int *" "wstatus" ", int " options ", struct rusage *" rusage );

View File

@ -1,90 +0,0 @@
.\" Copyright (C) 2021 Alejandro Colomar <alx.manpages@gmail.com>
.\"
.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
.TH MAX 3 2020-11-01 "Linux" "Linux Programmer's Manual"
.SH NAME
MAX, MIN \- maximum or minimum of two values
.SH SYNOPSIS
.nf
.B #include <sys/param.h>
.PP
.BI MAX( a ", " b );
.BI MIN( a ", " b );
.fi
.SH DESCRIPTION
These macros return the maximum or minimum of
.I a
and
.IR b .
.SH RETURN VALUE
These macros return the value of one of their arguments,
possibly converted to a different type (see BUGS).
.SH ERRORS
These macros may raise the "invalid" floating-point exception
when any of the arguments is NaN.
.SH CONFORMING TO
These nonstandard macros are present in glibc and the BSDs.
.SH NOTES
If either of the arguments is of a floating-point type,
you might prefer to use
.BR fmax (3)
or
.BR fmin (3),
which can handle NaN.
.PP
The arguments may be evaluated more than once, or not at all.
.PP
Some UNIX systems might provide these macros in a different header,
or not at all.
.SH BUGS
Due to the usual arithmetic conversions,
the result of these macros may be very different from either of the arguments.
To avoid this, ensure that both arguments have the same type.
.SH EXAMPLES
.EX
#include <stdio.h>
#include <stdlib.h>
#include <sys/param.h>
int
main(int argc, char *argv[])
{
int a, b, x;
if (argc != 3) {
fprintf(stderr, "Usage: %s <num> <num>\en", argv[0]);
exit(EXIT_FAILURE);
}
a = atoi(argv[1]);
b = atoi(argv[2]);
x = MAX(a, b);
printf("MAX(%d, %d) is %d\en", a, b, x);
exit(EXIT_SUCCESS);
}
.EE
.SH SEE ALSO
.BR fmax (3),
.BR fmin (3)

View File

@ -1 +0,0 @@
.so man3/MAX.3

View File

@ -22,7 +22,7 @@
.\" the source, must acknowledge the copyright and authors of this work.
.\" %%%LICENSE_END
.\"
.TH BSWAP 3 2021-06-20 "Linux" "Linux Programmer's Manual"
.TH BSWAP 3 2020-11-01 "Linux" "Linux Programmer's Manual"
.SH NAME
bswap_16, bswap_32, bswap_64 \- reverse order of bytes
.SH SYNOPSIS

View File

@ -85,7 +85,7 @@ function returns nonzero if the end-of-file indicator is set for
otherwise, it returns zero.
.PP
The
.BR ferror ()
.BR feof ()
function returns nonzero if the error indicator is set for
.IR stream ;
otherwise, it returns zero.

View File

@ -59,7 +59,9 @@ one was found.
.PP
If
.I "*lineptr"
is set to NULL before the call, then
is set to NULL and
.I *n
is set 0 before the call, then
.BR getline ()
will allocate a buffer for storing the line.
This buffer should be freed by the user program

View File

@ -143,7 +143,7 @@ First, some examples using
.EX
$ \fB./string_comp ABC ABC\fP
<str1> and <str2> are equal
$ \fB./string_comp ABC AB\fP # \(aqC\(aq is ASCII 67; \(aqC\(aq \- \(aq\e0\(aq = 67
$ \fB./string_comp ABC AB\fP # \(aqC\(aq is ASCII 67; \(aqC\(aq \- \(aq\0\(aq = 67
<str1> is greater than <str2> (67)
$ \fB./string_comp ABA ABZ\fP # \(aqA\(aq is ASCII 65; \(aqZ\(aq is ASCII 90
<str1> is less than <str2> (\-25)

View File

@ -9,7 +9,7 @@
.\" 2 of the License, or (at your option) any later version.
.\" %%%LICENSE_END
.\"
.TH KERNEL_LOCKDOWN 7 2021-06-20 Linux "Linux Programmer's Manual"
.TH KERNEL_LOCKDOWN 7 2020-11-01 Linux "Linux Programmer's Manual"
.SH NAME
kernel_lockdown \- kernel image access prevention feature
.SH DESCRIPTION