Various pages: Use .nf/.fi in SYNOPSIS

The majority of pages use .nf/.fi in SYNOPSIS, but there are
still many that don't and use .br to achieve newlines. Fix many
of those. This brings greater consistency to the pages, which
eases editing and may ease future scripted edits to the pages.

Many of these changes were script-assisted, with some additional
manual edits.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2021-01-03 12:49:03 +01:00
parent 511bb71b0c
commit c7db92b96a
210 changed files with 423 additions and 205 deletions

View File

@ -26,7 +26,9 @@
.SH NAME
getent \- get entries from Name Service Switch libraries
.SH SYNOPSIS
.nf
.B getent\ [\fIoption\fP]...\ \fIdatabase\fP\ \fIkey\fP...
.fi
.SH DESCRIPTION
The
.B getent

View File

@ -15,7 +15,9 @@
.SH NAME
ldd \- print shared object dependencies
.SH SYNOPSIS
.nf
.BR ldd " [\fIoption\fP]... \fIfile\fP..."
.fi
.SH DESCRIPTION
.B ldd
prints the shared objects (shared libraries) required by each program or

View File

@ -25,7 +25,9 @@
.SH NAME
memusage \- profile memory usage of a program
.SH SYNOPSIS
.nf
.BR memusage " [\fIoption\fR]... \fIprogram\fR [\fIprogramoption\fR]..."
.fi
.SH DESCRIPTION
.B memusage
is a bash script which profiles memory usage of the program,

View File

@ -24,7 +24,9 @@
.SH NAME
memusagestat \- generate graphic from memory profiling data
.SH SYNOPSIS
.nf
.BR memusagestat " [\fIoption\fR]... \fIdatafile\fR [\fIoutfile\fR]"
.fi
.SH DESCRIPTION
.B memusagestat
creates a PNG file containing a graphical representation of the

View File

@ -24,7 +24,9 @@
.SH NAME
mtrace \- interpret the malloc trace log
.SH SYNOPSIS
.nf
.BR mtrace " [\fIoption\fR]... [\fIbinary\fR] \fImtracedata\fR"
.fi
.SH DESCRIPTION
.B mtrace
is a Perl script used to interpret and provide human readable output

View File

@ -30,6 +30,7 @@
.SH NAME
_exit, _Exit \- terminate the calling process
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.BI "void _exit(int " status );
@ -37,6 +38,7 @@ _exit, _Exit \- terminate the calling process
.B #include <stdlib.h>
.PP
.BI "void _Exit(int " status );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -39,11 +39,13 @@
.SH NAME
_syscall \- invoking a system call without library support (OBSOLETE)
.SH SYNOPSIS
.nf
.B #include <linux/unistd.h>
.PP
A _syscall macro
.PP
desired system call
.fi
.SH DESCRIPTION
The important thing to know about a system call is its prototype.
You need to know how many arguments, their types,

View File

@ -34,11 +34,12 @@
.SH NAME
chdir, fchdir \- change working directory
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.BI "int chdir(const char *" path );
.br
.BI "int fchdir(int " fd );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -22,10 +22,12 @@
.SH NAME
epoll_ctl \- control interface for an epoll file descriptor
.SH SYNOPSIS
.nf
.B #include <sys/epoll.h>
.PP
.BI "int epoll_ctl(int " epfd ", int " op ", int " fd \
", struct epoll_event *" event );
.fi
.SH DESCRIPTION
This system call is used to add, modify, or remove
entries in the interest list of the

View File

@ -23,9 +23,11 @@
.SH NAME
eventfd \- create a file descriptor for event notification
.SH SYNOPSIS
.nf
.B #include <sys/eventfd.h>
.PP
.BI "int eventfd(unsigned int " initval ", int " flags );
.fi
.SH DESCRIPTION
.BR eventfd ()
creates an "eventfd object" that can be used as

View File

@ -38,11 +38,12 @@
.SH NAME
execve \- execute program
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.BI "int execve(const char *" pathname ", char *const " argv [],
.br
.BI " char *const " envp []);
.fi
.SH DESCRIPTION
.BR execve ()
executes the program referred to by \fIpathname\fP.

View File

@ -27,13 +27,13 @@
.SH NAME
execveat \- execute program relative to a directory file descriptor
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.BI "int execveat(int " dirfd ", const char *" pathname ","
.br
.BI " char *const " argv "[], char *const " envp "[],"
.br
.BI " int " flags );
.fi
.SH DESCRIPTION
.\" commit 51f39a1f0cea1cacf8c787f652f26dfee9611874
The

View File

@ -25,11 +25,12 @@
.SH NAME
fanotify_init \- create and initialize fanotify group
.SH SYNOPSIS
.nf
.B #include <fcntl.h>
.br
.B #include <sys/fanotify.h>
.PP
.BI "int fanotify_init(unsigned int " flags ", unsigned int " event_f_flags );
.fi
.SH DESCRIPTION
For an overview of the fanotify API, see
.BR fanotify (7).

View File

@ -36,9 +36,11 @@
.SH NAME
flock \- apply or remove an advisory lock on an open file
.SH SYNOPSIS
.nf
.B #include <sys/file.h>
.PP
.BI "int flock(int " fd ", int " operation );
.fi
.SH DESCRIPTION
Apply or remove an advisory lock on the open file specified by
.IR fd .

View File

@ -40,11 +40,12 @@
.SH NAME
fork \- create a child process
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.B pid_t fork(void);
.fi
.SH DESCRIPTION
.BR fork ()
creates a new process by duplicating the calling process.

View File

@ -39,11 +39,13 @@
.SH NAME
fsync, fdatasync \- synchronize a file's in-core state with storage device
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.BI "int fsync(int " fd );
.PP
.BI "int fdatasync(int " fd );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -26,13 +26,13 @@
.SH NAME
getgid, getegid \- get group identity
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.br
.B #include <sys/types.h>
.PP
.B gid_t getgid(void);
.br
.B gid_t getegid(void);
.fi
.SH DESCRIPTION
.BR getgid ()
returns the real group ID of the calling process.

View File

@ -33,8 +33,8 @@
.SH NAME
getgroups, setgroups \- get/set list of supplementary group IDs
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.BI "int getgroups(int " size ", gid_t " list []);
@ -42,6 +42,7 @@ getgroups, setgroups \- get/set list of supplementary group IDs
.B #include <grp.h>
.PP
.BI "int setgroups(size_t " size ", const gid_t *" list );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -43,10 +43,12 @@
.SH NAME
getpeername \- get name of connected peer socket
.SH SYNOPSIS
.nf
.B #include <sys/socket.h>
.PP
.BI "int getpeername(int " sockfd ", struct sockaddr *" addr \
", socklen_t *" addrlen );
.fi
.SH DESCRIPTION
.BR getpeername ()
returns the address of the peer connected to the socket

View File

@ -26,13 +26,13 @@
.SH NAME
getpid, getppid \- get process identification
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.B pid_t getpid(void);
.br
.B pid_t getppid(void);
.fi
.SH DESCRIPTION
.BR getpid ()
returns the process ID (PID) of the calling process.

View File

@ -46,13 +46,13 @@
.SH NAME
getpriority, setpriority \- get/set program scheduling priority
.SH SYNOPSIS
.nf
.B #include <sys/time.h>
.br
.B #include <sys/resource.h>
.PP
.BI "int getpriority(int " which ", id_t " who );
.br
.BI "int setpriority(int " which ", id_t " who ", int " prio );
.fi
.SH DESCRIPTION
The scheduling priority of the process, process group, or user, as
indicated by

View File

@ -28,9 +28,11 @@
.SH NAME
getrandom \- obtain a series of random bytes
.SH SYNOPSIS
.nf
.B #include <sys/random.h>
.PP
.BI "ssize_t getrandom(void *"buf ", size_t " buflen ", unsigned int " flags );
.fi
.SH DESCRIPTION
The
.BR getrandom ()

View File

@ -29,13 +29,13 @@
.SH NAME
getresuid, getresgid \- get real, effective and saved user/group IDs
.SH SYNOPSIS
.nf
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.br
.B #include <unistd.h>
.PP
.BI "int getresuid(uid_t *" ruid ", uid_t *" euid ", uid_t *" suid );
.br
.BI "int getresgid(gid_t *" rgid ", gid_t *" egid ", gid_t *" sgid );
.fi
.SH DESCRIPTION
.BR getresuid ()
returns the real UID, the effective UID, and the saved set-user-ID

View File

@ -65,18 +65,16 @@
.SH NAME
getrlimit, setrlimit, prlimit \- get/set resource limits
.SH SYNOPSIS
.nf
.B #include <sys/time.h>
.br
.B #include <sys/resource.h>
.PP
.BI "int getrlimit(int " resource ", struct rlimit *" rlim );
.br
.BI "int setrlimit(int " resource ", const struct rlimit *" rlim );
.PP
.BI "int prlimit(pid_t " pid ", int " resource \
", const struct rlimit *" new_limit ,
.br
.BI "int prlimit(pid_t " pid ", int " resource ", const struct rlimit *" new_limit ,
.BI " struct rlimit *" old_limit );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -40,11 +40,12 @@
.SH NAME
getrusage \- get resource usage
.SH SYNOPSIS
.nf
.B #include <sys/time.h>
.br
.B #include <sys/resource.h>
.PP
.BI "int getrusage(int " who ", struct rusage *" usage );
.fi
.SH DESCRIPTION
.BR getrusage ()
returns resource usage measures for

View File

@ -28,11 +28,12 @@
.SH NAME
getsid \- get session ID
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.BI "pid_t getsid(pid_t" " pid" );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -27,13 +27,13 @@
.SH NAME
getuid, geteuid \- get user identity
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.br
.B #include <sys/types.h>
.PP
.B uid_t getuid(void);
.br
.B uid_t geteuid(void);
.fi
.SH DESCRIPTION
.BR getuid ()
returns the real user ID of the calling process.

View File

@ -33,9 +33,11 @@
.SH NAME
idle \- make process 0 idle
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.B int idle(void);
.fi
.SH DESCRIPTION
.BR idle ()
is an internal system call used during bootstrap.

View File

@ -29,9 +29,11 @@
.SH NAME
inotify_add_watch \- add a watch to an initialized inotify instance
.SH SYNOPSIS
.nf
.B #include <sys/inotify.h>
.PP
.BI "int inotify_add_watch(int " fd ", const char *" pathname ", uint32_t " mask );
.fi
.SH DESCRIPTION
.BR inotify_add_watch ()
adds a new watch, or modifies an existing watch,

View File

@ -28,11 +28,13 @@
.SH NAME
inotify_rm_watch \- remove an existing watch from an inotify instance
.SH SYNOPSIS
.nf
.B #include <sys/inotify.h>
.PP
.BI "int inotify_rm_watch(int " fd ", int " wd );
.\" Before glibc 2.10, the second argument was types as uint32_t.
.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=7040
.fi
.SH DESCRIPTION
.BR inotify_rm_watch ()
removes the watch associated with the watch descriptor

View File

@ -42,11 +42,13 @@
.SH NAME
ioctl \- control device
.SH SYNOPSIS
.nf
.B #include <sys/ioctl.h>
.PP
.BI "int ioctl(int " fd ", unsigned long " request ", ...);"
.\" POSIX says 'request' is int, but glibc has the above
.\" See https://bugzilla.kernel.org/show_bug.cgi?id=42705
.fi
.SH DESCRIPTION
The
.BR ioctl ()

View File

@ -24,13 +24,13 @@
.SH NAME
ioctl_ficlonerange, ioctl_ficlone \- share some the data of one file with another file
.SH SYNOPSIS
.nf
.B #include <sys/ioctl.h>
.br
.B #include <linux/fs.h>
.PP
.BI "int ioctl(int " dest_fd ", FICLONERANGE, struct file_clone_range *" arg );
.br
.BI "int ioctl(int " dest_fd ", FICLONE, int " src_fd );
.fi
.SH DESCRIPTION
If a filesystem supports files sharing physical storage between multiple
files ("reflink"), this

View File

@ -24,11 +24,12 @@
.SH NAME
ioctl_fideduperange \- share some the data of one file with another file
.SH SYNOPSIS
.nf
.B #include <sys/ioctl.h>
.br
.B #include <linux/fs.h>
.PP
.BI "int ioctl(int " src_fd ", FIDEDUPERANGE, struct file_dedupe_range *" arg );
.fi
.SH DESCRIPTION
If a filesystem supports files sharing physical storage between multiple
files, this

View File

@ -24,13 +24,13 @@
.SH NAME
ioctl_fslabel \- get or set a filesystem label
.SH SYNOPSIS
.nf
.B #include <sys/ioctl.h>
.br
.B #include <linux/fs.h>
.PP
.BI "int ioctl(int " fd ", FS_IOC_GETFSLABEL, char " label [FSLABEL_MAX]);
.br
.BI "int ioctl(int " fd ", FS_IOC_SETFSLABEL, char " label [FSLABEL_MAX]);
.fi
.SH DESCRIPTION
If a filesystem supports online label manipulation, these
.BR ioctl (2)

View File

@ -24,13 +24,13 @@
.SH NAME
ioctl_getfsmap \- retrieve the physical layout of the filesystem
.SH SYNOPSIS
.nf
.B #include <sys/ioctl.h>
.br
.B #include <linux/fs.h>
.br
.B #include <linux/fsmap.h>
.PP
.BI "int ioctl(int " fd ", FS_IOC_GETFSMAP, struct fsmap_head * " arg );
.fi
.SH DESCRIPTION
This
.BR ioctl (2)

View File

@ -9,9 +9,11 @@
.SH NAME
ioctl_tty \- ioctls for terminals and serial lines
.SH SYNOPSIS
.nf
.B "#include <termios.h>"
.PP
.BI "int ioctl(int " fd ", int " cmd ", ...);"
.fi
.SH DESCRIPTION
The
.BR ioctl (2)

View File

@ -35,10 +35,11 @@
.SH NAME
ioperm \- set port input/output permissions
.SH SYNOPSIS
.B #include <sys/io.h>
/* for glibc */
.nf
.BR "#include <sys/io.h>" " /* for glibc */"
.PP
.BI "int ioperm(unsigned long " from ", unsigned long " num ", int " turn_on );
.fi
.SH DESCRIPTION
.BR ioperm ()
sets the port access permission bits for the calling thread for

View File

@ -34,9 +34,11 @@
.SH NAME
iopl \- change I/O privilege level
.SH SYNOPSIS
.nf
.B #include <sys/io.h>
.PP
.BI "int iopl(int " level );
.fi
.SH DESCRIPTION
.BR iopl ()
changes the I/O privilege level of the calling thread,

View File

@ -28,7 +28,9 @@
.SH NAME
lookup_dcookie \- return a directory entry's path
.SH SYNOPSIS
.nf
.BI "int lookup_dcookie(u64 " cookie ", char *" buffer ", size_t " len );
.fi
.SH DESCRIPTION
Look up the full path of the directory entry specified by the value
.IR cookie .

View File

@ -47,11 +47,12 @@
.SH NAME
lseek \- reposition read/write file offset
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.BI "off_t lseek(int " fd ", off_t " offset ", int " whence );
.fi
.SH DESCRIPTION
.BR lseek ()
repositions the file offset of the open file description

View File

@ -36,9 +36,11 @@
.SH NAME
madvise \- give advice about use of memory
.SH SYNOPSIS
.nf
.B #include <sys/mman.h>
.PP
.BI "int madvise(void *" addr ", size_t " length ", int " advice );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -35,11 +35,12 @@
.SH NAME
mincore \- determine whether pages are resident in memory
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.br
.B #include <sys/mman.h>
.PP
.BI "int mincore(void *" addr ", size_t " length ", unsigned char *" vec );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -26,9 +26,11 @@
.SH NAME
msync \- synchronize a file with a memory map
.SH SYNOPSIS
.nf
.B #include <sys/mman.h>
.PP
.BI "int msync(void *" addr ", size_t " length ", int " flags );
.fi
.SH DESCRIPTION
.BR msync ()
flushes changes made to the in-core copy of a file that was mapped

View File

@ -35,9 +35,11 @@
.SH NAME
nanosleep \- high-resolution sleep
.SH SYNOPSIS
.nf
.B #include <time.h>
.PP
.BI "int nanosleep(const struct timespec *" req ", struct timespec *" rem );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -32,9 +32,11 @@
.SH NAME
nice \- change process priority
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.BI "int nice(int " inc );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -31,9 +31,11 @@
.SH NAME
pause \- wait for signal
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.B int pause(void);
.fi
.SH DESCRIPTION
.BR pause ()
causes the calling process (or thread) to sleep

View File

@ -34,9 +34,11 @@
.SH NAME
personality \- set the process execution domain
.SH SYNOPSIS
.nf
.B #include <sys/personality.h>
.PP
.BI "int personality(unsigned long " persona );
.fi
.SH DESCRIPTION
Linux supports different execution domains, or personalities, for each
process.

View File

@ -28,7 +28,9 @@
.SH NAME
pivot_root \- change the root mount
.SH SYNOPSIS
.nf
.BI "int pivot_root(const char *" new_root ", const char *" put_old );
.fi
.PP
.IR Note :
There is no glibc wrapper for this system call; see NOTES.

View File

@ -29,11 +29,11 @@
.SH NAME
reboot \- reboot or enable/disable Ctrl-Alt-Del
.SH SYNOPSIS
.nf
/* Since kernel version 2.1.30 there are symbolic names LINUX_REBOOT_*
for the constants and a fourth argument to the call: */
.PP
.B #include <unistd.h>
.br
.B #include <linux/reboot.h>
.PP
.BI "int reboot(int " magic ", int " magic2 ", int " cmd ", void *" arg );
@ -44,10 +44,10 @@ reboot \- reboot or enable/disable Ctrl-Alt-Del
wrapper around the system call: */
.PP
.B #include <unistd.h>
.br
.B #include <sys/reboot.h>
.PP
.BI "int reboot(int " cmd );
.fi
.SH DESCRIPTION
The
.BR reboot ()

View File

@ -34,7 +34,9 @@
.SH NAME
restart_syscall \- restart a system call after interruption by a stop signal
.SH SYNOPSIS
.nf
.B long restart_syscall(void);
.fi
.PP
.IR Note :
There is no glibc wrapper for this system call; see NOTES.

View File

@ -31,9 +31,11 @@
.SH NAME
rmdir \- delete a directory
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.BI "int rmdir(const char *" pathname );
.fi
.SH DESCRIPTION
.BR rmdir ()
deletes a directory, which must be empty.

View File

@ -30,9 +30,11 @@
.SH NAME
sched_rr_get_interval \- get the SCHED_RR interval for the named process
.SH SYNOPSIS
.nf
.B #include <sched.h>
.PP
.BI "int sched_rr_get_interval(pid_t " pid ", struct timespec *" tp );
.fi
.SH DESCRIPTION
.BR sched_rr_get_interval ()
writes into the

View File

@ -30,9 +30,11 @@
.SH NAME
sched_yield \- yield the processor
.SH SYNOPSIS
.nf
.B #include <sched.h>
.PP
.B int sched_yield(void);
.fi
.SH DESCRIPTION
.BR sched_yield ()
causes the calling thread to relinquish the CPU.

View File

@ -20,6 +20,7 @@
.SH NAME
sendfile \- transfer data between file descriptors
.SH SYNOPSIS
.nf
.B #include <sys/sendfile.h>
.PP
.BI "ssize_t sendfile(int" " out_fd" ", int" " in_fd" ", off_t *" \
@ -28,22 +29,16 @@ sendfile \- transfer data between file descriptors
.\" in the notes, not in the header.
.\"
.\" .B #include <features.h>
.\" .br
.\" .B #if (__GLIBC__==2 && __GLIBC_MINOR__>=1) || __GLIBC__>2
.\" .br
.\" .B #include <sys/sendfile.h>
.\" .br
.\" #else
.\" .br
.\" .B #include <sys/types.h>
.\" .br
.\" .B /* No system prototype before glibc 2.1. */
.\" .br
.\" .BI "ssize_t sendfile(int" " out_fd" ", int" " in_fd" ", off_t *" \
.\" offset ", size_t" " count" )
.\" .br
.\" .B #endif
.\"
.fi
.SH DESCRIPTION
.BR sendfile ()
copies data between one file descriptor and another.

View File

@ -30,13 +30,13 @@
.SH NAME
seteuid, setegid \- set effective user or group ID
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.BI "int seteuid(uid_t " euid );
.br
.BI "int setegid(gid_t " egid );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -33,9 +33,11 @@
.SH NAME
setfsgid \- set group identity used for filesystem checks
.SH SYNOPSIS
.nf
.B #include <sys/fsuid.h>
.PP
.BI "int setfsgid(uid_t " fsgid );
.fi
.SH DESCRIPTION
On Linux, a process has both a filesystem group ID and an effective group ID.
The (Linux-specific) filesystem group ID is used

View File

@ -33,9 +33,11 @@
.SH NAME
setfsuid \- set user identity used for filesystem checks
.SH SYNOPSIS
.nf
.B #include <sys/fsuid.h>
.PP
.BI "int setfsuid(uid_t " fsuid );
.fi
.SH DESCRIPTION
On Linux, a process has both a filesystem user ID and an effective user ID.
The (Linux-specific) filesystem user ID is used

View File

@ -31,11 +31,12 @@
.SH NAME
setgid \- set group identity
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.BI "int setgid(gid_t " gid );
.fi
.SH DESCRIPTION
.BR setgid ()
sets the effective group ID of the calling process.

View File

@ -28,13 +28,13 @@
.SH NAME
setresuid, setresgid \- set real, effective and saved user or group ID
.SH SYNOPSIS
.nf
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.br
.B #include <unistd.h>
.PP
.BI "int setresuid(uid_t " ruid ", uid_t " euid ", uid_t " suid );
.br
.BI "int setresgid(gid_t " rgid ", gid_t " egid ", gid_t " sgid );
.fi
.SH DESCRIPTION
.BR setresuid ()
sets the real user ID, the effective user ID, and the

View File

@ -47,13 +47,13 @@
.SH NAME
setreuid, setregid \- set real and/or effective user or group ID
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.BI "int setreuid(uid_t " ruid ", uid_t " euid );
.br
.BI "int setregid(gid_t " rgid ", gid_t " egid );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -32,14 +32,14 @@
.SH NAME
setsid \- creates a session and sets the process group ID
.SH SYNOPSIS
.nf
.ad l
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.B pid_t setsid(void);
.br
.ad b
.fi
.SH DESCRIPTION
.BR setsid ()
creates a new session if the calling process is not a

View File

@ -32,11 +32,12 @@
.SH NAME
setuid \- set user identity
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.PP
.BI "int setuid(uid_t " uid );
.fi
.SH DESCRIPTION
.BR setuid ()
sets the effective user ID of the calling process.

View File

@ -35,9 +35,11 @@
.SH NAME
setup \- setup devices and filesystems, mount root filesystem
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.B int setup(void);
.fi
.SH DESCRIPTION
.BR setup ()
is called once from within

View File

@ -47,13 +47,14 @@
.SH NAME
shmctl \- System V shared memory control
.SH SYNOPSIS
.nf
.ad l
.B #include <sys/ipc.h>
.br
.B #include <sys/shm.h>
.PP
.BI "int shmctl(int " shmid ", int " cmd ", struct shmid_ds *" buf );
.ad b
.fi
.SH DESCRIPTION
.BR shmctl ()
performs the control operation specified by

View File

@ -39,13 +39,14 @@
.SH NAME
shmget \- allocates a System V shared memory segment
.SH SYNOPSIS
.nf
.ad l
.B #include <sys/ipc.h>
.br
.B #include <sys/shm.h>
.PP
.BI "int shmget(key_t " key ", size_t " size ", int " shmflg );
.ad b
.fi
.SH DESCRIPTION
.BR shmget ()
returns the identifier of the System\ V shared memory segment

View File

@ -41,9 +41,11 @@
.SH NAME
shutdown \- shut down part of a full-duplex connection
.SH SYNOPSIS
.nf
.B #include <sys/socket.h>
.PP
.BI "int shutdown(int " sockfd ", int " how );
.fi
.SH DESCRIPTION
The
.BR shutdown ()

View File

@ -27,9 +27,11 @@
.SH NAME
sigaltstack \- set and/or get signal stack context
.SH SYNOPSIS
.nf
.B #include <signal.h>
.PP
.BI "int sigaltstack(const stack_t *" ss ", stack_t *" old_ss );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -37,11 +37,13 @@
.SH NAME
signal \- ANSI C signal handling
.SH SYNOPSIS
.nf
.B #include <signal.h>
.PP
.B typedef void (*sighandler_t)(int);
.PP
.BI "sighandler_t signal(int " signum ", sighandler_t " handler );
.fi
.SH DESCRIPTION
.BR WARNING :
the behavior of

View File

@ -21,9 +21,11 @@
.SH NAME
signalfd \- create a file descriptor for accepting signals
.SH SYNOPSIS
.nf
.B #include <sys/signalfd.h>
.PP
.BI "int signalfd(int " fd ", const sigset_t *" mask ", int " flags );
.fi
.SH DESCRIPTION
.BR signalfd ()
creates a file descriptor that can be used to accept signals

View File

@ -30,9 +30,11 @@
.SH NAME
sigpending, rt_sigpending \- examine pending signals
.SH SYNOPSIS
.nf
.B #include <signal.h>
.PP
.BI "int sigpending(sigset_t *" set );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -31,7 +31,9 @@
.SH NAME
sigreturn, rt_sigreturn \- return from signal handler and cleanup stack frame
.SH SYNOPSIS
.nf
.BI "int sigreturn(...);"
.fi
.SH DESCRIPTION
If the Linux kernel determines that an unblocked
signal is pending for a process, then,

View File

@ -30,9 +30,11 @@
.SH NAME
sigsuspend, rt_sigsuspend \- wait for a signal
.SH SYNOPSIS
.nf
.B #include <signal.h>
.PP
.BI "int sigsuspend(const sigset_t *" mask );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -43,11 +43,12 @@
.SH NAME
socket \- create an endpoint for communication
.SH SYNOPSIS
.nf
.BR "#include <sys/types.h>" " /* See NOTES */"
.br
.B #include <sys/socket.h>
.PP
.BI "int socket(int " domain ", int " type ", int " protocol );
.fi
.SH DESCRIPTION
.BR socket ()
creates an endpoint for communication and returns a file descriptor

View File

@ -26,9 +26,11 @@
.SH NAME
socketcall \- socket system calls
.SH SYNOPSIS
.nf
.B #include <linux/net.h>
.PP
.BI "int socketcall(int " call ", unsigned long *" args );
.fi
.SH DESCRIPTION
.BR socketcall ()
is a common kernel entry point for the socket system calls.

View File

@ -43,12 +43,13 @@
.SH NAME
socketpair \- create a pair of connected sockets
.SH SYNOPSIS
.nf
.BR "#include <sys/types.h>" " /* See NOTES */"
.br
.B #include <sys/socket.h>
.PP
.BI "int socketpair(int " domain ", int " type ", int " protocol \
", int " sv [2]);
.fi
.SH DESCRIPTION
The
.BR socketpair ()

View File

@ -29,11 +29,12 @@
.SH NAME
statfs, fstatfs \- get filesystem statistics
.SH SYNOPSIS
.nf
.BR "#include <sys/vfs.h> " "/* or <sys/statfs.h> */"
.PP
.BI "int statfs(const char *" path ", struct statfs *" buf );
.br
.BI "int fstatfs(int " fd ", struct statfs *" buf );
.fi
.SH DESCRIPTION
The
.BR statfs ()

View File

@ -31,9 +31,11 @@
.SH NAME
stime \- set time
.SH SYNOPSIS
.nf
.B #include <time.h>
.PP
.BI "int stime(const time_t *" t );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -43,13 +43,13 @@
.SH NAME
swapon, swapoff \- start/stop swapping to file/device
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.br
.B #include <sys/swap.h>
.PP
.BI "int swapon(const char *" path ", int " swapflags );
.br
.BI "int swapoff(const char *" path );
.fi
.SH DESCRIPTION
.BR swapon ()
sets the swap area to the file or block device specified by

View File

@ -37,11 +37,13 @@
.SH NAME
sync, syncfs \- commit filesystem caches to disk
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.B void sync(void);
.PP
.BI "int syncfs(int " fd );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -32,7 +32,9 @@
.SH NAME
syscalls \- Linux system calls
.SH SYNOPSIS
.nf
Linux system calls.
.fi
.SH DESCRIPTION
The system call is the fundamental interface between an application
and the Linux kernel.

View File

@ -36,9 +36,11 @@
.SH NAME
sysinfo \- return system information
.SH SYNOPSIS
.nf
.B #include <sys/sysinfo.h>
.PP
.BI "int sysinfo(struct sysinfo *" info );
.fi
.SH DESCRIPTION
.BR sysinfo ()
returns certain statistics on memory and swap usage,

View File

@ -30,9 +30,11 @@
.SH NAME
time \- get time in seconds
.SH SYNOPSIS
.nf
.B #include <time.h>
.PP
.BI "time_t time(time_t *" tloc );
.fi
.SH DESCRIPTION
.BR time ()
returns the time as the number of seconds since the

View File

@ -39,9 +39,11 @@
.SH NAME
times \- get process times
.SH SYNOPSIS
.nf
.B #include <sys/times.h>
.PP
.BI "clock_t times(struct tms *" buf );
.fi
.SH DESCRIPTION
.BR times ()
stores the current process times in the

View File

@ -44,13 +44,13 @@
.SH NAME
truncate, ftruncate \- truncate a file to a specified length
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.br
.B #include <sys/types.h>
.PP
.BI "int truncate(const char *" path ", off_t " length );
.br
.BI "int ftruncate(int " fd ", off_t " length );
.fi
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

View File

@ -35,11 +35,12 @@
.SH NAME
umask \- set file mode creation mask
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <sys/stat.h>
.PP
.BI "mode_t umask(mode_t " mask );
.fi
.SH DESCRIPTION
.BR umask ()
sets the calling process's file mode creation mask (umask) to

View File

@ -28,9 +28,11 @@
.SH NAME
uname \- get name and information about current kernel
.SH SYNOPSIS
.nf
.B #include <sys/utsname.h>
.PP
.BI "int uname(struct utsname *" buf );
.fi
.SH DESCRIPTION
.BR uname ()
returns system information in the structure pointed to by

View File

@ -29,7 +29,9 @@ afs_syscall, break, fattach, fdetach, ftime, getmsg, getpmsg, gtty, isastream,
lock, madvise1, mpx, prof, profil, putmsg, putpmsg, security,
stty, tuxcall, ulimit, vserver \- unimplemented system calls
.SH SYNOPSIS
.nf
Unimplemented system calls.
.fi
.SH DESCRIPTION
These system calls are not implemented in the Linux kernel.
.SH RETURN VALUE

View File

@ -32,9 +32,11 @@
.SH NAME
uselib \- load shared library
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.BI "int uselib(const char *" library );
.fi
.PP
.IR Note :
No declaration of this system call is provided in glibc headers; see NOTES.

View File

@ -40,9 +40,11 @@
.SH NAME
write \- write to a file descriptor
.SH SYNOPSIS
.nf
.B #include <unistd.h>
.PP
.BI "ssize_t write(int " fd ", const void *" buf ", size_t " count );
.fi
.SH DESCRIPTION
.BR write ()
writes up to

View File

@ -28,17 +28,15 @@ Programmer's Manual"
__ppc_set_ppr_med, __ppc_set_ppr_very_low, __ppc_set_ppr_low, __ppc_set_ppr_med_low, __ppc_set_ppr_med_high \-
Set the Program Priority Register
.SH SYNOPSIS
.nf
.B #include <sys/platform/ppc.h>
.PP
.B void __ppc_set_ppr_med(void);
.br
.B void __ppc_set_ppr_very_low(void);
.br
.B void __ppc_set_ppr_low(void);
.br
.B void __ppc_set_ppr_med_low(void);
.br
.B void __ppc_set_ppr_med_high(void);
.fi
.SH DESCRIPTION
These functions provide access to the
.I Program Priority Register

View File

@ -28,13 +28,13 @@ Manual"
__ppc_yield, __ppc_mdoio, __ppc_mdoom \-
Hint the processor to release shared resources
.SH SYNOPSIS
.nf
.B #include <sys/platform/ppc.h>
.PP
.B void __ppc_yield(void);
.br
.B void __ppc_mdoio(void);
.br
.B void __ppc_mdoom(void);
.fi
.SH DESCRIPTION
These functions
provide hints about the usage of resources that are shared with other

View File

@ -9,9 +9,11 @@
.SH NAME
__setfpucw \- set FPU control word on i386 architecture (obsolete)
.SH SYNOPSIS
.nf
.B #include <i386/fpu_control.h>
.PP
.BI "void __setfpucw(unsigned short " control_word );
.fi
.SH DESCRIPTION
.BR __setfpucw ()
transfers

View File

@ -25,11 +25,13 @@
.SH NAME
aio_cancel \- cancel an outstanding asynchronous I/O request
.SH SYNOPSIS
.nf
.B "#include <aio.h>"
.PP
.BI "int aio_cancel(int " fd ", struct aiocb *" aiocbp );
.PP
Link with \fI\-lrt\fP.
.fi
.SH DESCRIPTION
The
.BR aio_cancel ()

View File

@ -25,11 +25,13 @@
.SH NAME
aio_error \- get error status of asynchronous I/O operation
.SH SYNOPSIS
.nf
.B "#include <aio.h>"
.PP
.BI "int aio_error(const struct aiocb *" aiocbp );
.PP
Link with \fI\-lrt\fP.
.fi
.SH DESCRIPTION
The
.BR aio_error ()

View File

@ -25,11 +25,13 @@
.SH NAME
aio_fsync \- asynchronous file synchronization
.SH SYNOPSIS
.nf
.B "#include <aio.h>"
.PP
.BI "int aio_fsync(int " op ", struct aiocb *" aiocbp );
.PP
Link with \fI\-lrt\fP.
.fi
.SH DESCRIPTION
The
.BR aio_fsync ()

View File

@ -25,11 +25,13 @@
.SH NAME
aio_read \- asynchronous read
.SH SYNOPSIS
.nf
.B "#include <aio.h>"
.PP
.BI "int aio_read(struct aiocb *" aiocbp );
.PP
Link with \fI\-lrt\fP.
.fi
.SH DESCRIPTION
The
.BR aio_read ()

View File

@ -25,11 +25,13 @@
.SH NAME
aio_return \- get return status of asynchronous I/O operation
.SH SYNOPSIS
.nf
.B "#include <aio.h>"
.PP
.BI "ssize_t aio_return(struct aiocb *" aiocbp );
.PP
Link with \fI\-lrt\fP.
.fi
.SH DESCRIPTION
The
.BR aio_return ()

View File

@ -25,11 +25,13 @@
.SH NAME
aio_write \- asynchronous write
.SH SYNOPSIS
.nf
.B "#include <aio.h>"
.PP
.BI "int aio_write(struct aiocb *" aiocbp );
.PP
Link with \fI\-lrt\fP.
.fi
.SH DESCRIPTION
The
.BR aio_write ()

View File

@ -44,9 +44,11 @@
.SH NAME
alloca \- allocate memory that is automatically freed
.SH SYNOPSIS
.nf
.B #include <alloca.h>
.PP
.BI "void *alloca(size_t " size );
.fi
.SH DESCRIPTION
The
.BR alloca ()

View File

@ -26,11 +26,13 @@
.SH NAME
bsd_signal \- signal handling with BSD semantics
.SH SYNOPSIS
.fi
.B #include <signal.h>
.PP
.B typedef void (*sighandler_t)(int);
.PP
.BI "sighandler_t bsd_signal(int " signum ", sighandler_t " handler );
.nf
.PP
.RS -4
Feature Test Macro Requirements for glibc (see

Some files were not shown because too many files have changed in this diff Show More