From: Michael Kerrisk Date: Tue, 15 Aug 2017 15:44:09 +0000 (+0200) Subject: _exit.2, accept.2, chmod.2, dup.2, getgroups.2, keyctl.2, link.2, mkdir.2, mknod... X-Git-Tag: man-pages-4.13~301 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=f90f031e0f1f4529fa7536aca61dfe54509745a5;p=thirdparty%2Fman-pages.git _exit.2, accept.2, chmod.2, dup.2, getgroups.2, keyctl.2, link.2, mkdir.2, mknod.2, pipe.2, poll.2, reboot.2, rename.2, select.2, select_tut.2, stat.2, symlink.2, unlink.2, __ppc_get_timebase.3, abs.3, bzero.3, crypt.3, dbopen.3, dl_iterate_phdr.3, dlinfo.3, dlsym.3, duplocale.3, encrypt.3, err.3, ffs.3, fpurge.3, ftw.3, getdate.3, gethostbyname.3, getlogin.3, getmntent.3, getpwent_r.3, getpwnam.3, getspnam.3, inet_pton.3, insque.3, isfdtype.3, mallinfo.3, mallopt.3, matherr.3, mcheck.3, mempcpy.3, mkfifo.3, mq_getattr.3, newlocale.3, open_memstream.3, openpty.3, perror.3, posix_memalign.3, posix_spawn.3, printf.3, pthread_attr_init.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setaffinity_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_sigqueue.3, regex.3, resolver.3, rpmatch.3, rtnetlink.3, scanf.3, setbuf.3, strchr.3, strfromd.3, strverscmp.3, termios.3, tsearch.3, unlocked_stdio.3, updwtmp.3, netlink.7, rtld-audit.7, sock_diag.7, unix.7: ffix Signed-off-by: Michael Kerrisk --- diff --git a/man2/_exit.2 b/man2/_exit.2 index 5f30db2bc3..59d2cae5f4 100644 --- a/man2/_exit.2 +++ b/man2/_exit.2 @@ -33,7 +33,7 @@ _exit, _Exit \- terminate the calling process .B #include .PP .BI "void _exit(int " status ); -.PP + .B #include .PP .BI "void _Exit(int " status ); diff --git a/man2/accept.2 b/man2/accept.2 index 83407b313f..aee2bf5a8f 100644 --- a/man2/accept.2 +++ b/man2/accept.2 @@ -47,7 +47,7 @@ accept, accept4 \- accept a connection on a socket .B #include .PP .BI "int accept(int " sockfd ", struct sockaddr *" addr ", socklen_t *" addrlen ); -.PP + .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include .PP diff --git a/man2/chmod.2 b/man2/chmod.2 index c4569f67b5..fd31ee14eb 100644 --- a/man2/chmod.2 +++ b/man2/chmod.2 @@ -39,7 +39,7 @@ chmod, fchmod, fchmodat \- change permissions of a file .BI "int chmod(const char *" pathname ", mode_t " mode ); .br .BI "int fchmod(int " fd ", mode_t " mode ); -.PP + .BR "#include " " /* Definition of AT_* constants */" .B #include .PP diff --git a/man2/dup.2 b/man2/dup.2 index 5a6d4fa4e6..77e312982f 100644 --- a/man2/dup.2 +++ b/man2/dup.2 @@ -43,7 +43,7 @@ dup, dup2, dup3 \- duplicate a file descriptor .PP .BI "int dup(int " oldfd ); .BI "int dup2(int " oldfd ", int " newfd ); -.PP + .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .BR "#include " " /* Obtain O_* constant definitions */ .B #include diff --git a/man2/getgroups.2 b/man2/getgroups.2 index 1873a7aecf..bd89eec2ce 100644 --- a/man2/getgroups.2 +++ b/man2/getgroups.2 @@ -38,7 +38,7 @@ getgroups, setgroups \- get/set list of supplementary group IDs .B #include .PP .BI "int getgroups(int " size ", gid_t " list []); -.PP + .B #include .PP .BI "int setgroups(size_t " size ", const gid_t *" list ); diff --git a/man2/keyctl.2 b/man2/keyctl.2 index ea4c5a2bb4..0df6bcf4b8 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -34,7 +34,7 @@ keyctl \- manipulate the kernel's key management facility .B #include .PP .BI "long keyctl(int " operation ", ...)" -.PP + .B "/* For direct call via syscall(2): */" .B #include .B #include diff --git a/man2/link.2 b/man2/link.2 index 5dde324138..64a719e6c6 100644 --- a/man2/link.2 +++ b/man2/link.2 @@ -37,7 +37,7 @@ link, linkat \- make a new name for a file .B #include .PP .BI "int link(const char *" oldpath ", const char *" newpath ); -.PP + .BR "#include " "/* Definition of AT_* constants */" .B #include .PP diff --git a/man2/mkdir.2 b/man2/mkdir.2 index a081125314..592a6070f1 100644 --- a/man2/mkdir.2 +++ b/man2/mkdir.2 @@ -18,7 +18,7 @@ mkdir, mkdirat \- create a directory .\" .B #include .PP .BI "int mkdir(const char *" pathname ", mode_t " mode ); -.PP + .BR "#include " "/* Definition of AT_* constants */" .B #include .PP diff --git a/man2/mknod.2 b/man2/mknod.2 index 501f4137f1..e3708cb348 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -23,7 +23,7 @@ mknod, mknodat \- create a special or ordinary file .B #include .PP .BI "int mknod(const char *" pathname ", mode_t " mode ", dev_t " dev ); -.PP + .BR "#include " "/* Definition of AT_* constants */" .B #include .PP diff --git a/man2/pipe.2 b/man2/pipe.2 index f522e84c7d..89ccbcc727 100644 --- a/man2/pipe.2 +++ b/man2/pipe.2 @@ -41,7 +41,7 @@ pipe, pipe2 \- create pipe .B #include .PP .BI "int pipe(int " pipefd "[2]);" -.PP + .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .BR "#include " " /* Obtain O_* constant definitions */ .B #include diff --git a/man2/poll.2 b/man2/poll.2 index eed77adf8d..4b3c15f768 100644 --- a/man2/poll.2 +++ b/man2/poll.2 @@ -36,7 +36,7 @@ poll, ppoll \- wait for some event on a file descriptor .B #include .PP .BI "int poll(struct pollfd *" fds ", nfds_t " nfds ", int " timeout ); -.PP + .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include .B #include diff --git a/man2/reboot.2 b/man2/reboot.2 index 5dc54d74f2..2dabab8d0c 100644 --- a/man2/reboot.2 +++ b/man2/reboot.2 @@ -37,7 +37,7 @@ reboot \- reboot or enable/disable Ctrl-Alt-Del .B #include .PP .BI "int reboot(int " magic ", int " magic2 ", int " cmd ", void *" arg ); -.PP + /* Under glibc and most alternative libc's (including uclibc, dietlibc, musl and a few others), some of the constants involved have gotten symbolic names RB_*, and the library call is a 1-argument diff --git a/man2/rename.2 b/man2/rename.2 index 38a32f5d6b..8b2db438a7 100644 --- a/man2/rename.2 +++ b/man2/rename.2 @@ -38,7 +38,7 @@ rename, renameat, renameat2 \- change the name or location of a file .B #include .PP .BI "int rename(const char *" oldpath ", const char *" newpath ); -.PP + .BR "#include " "/* Definition of AT_* constants */" .B #include .PP diff --git a/man2/select.2 b/man2/select.2 index f22628d8d7..8b1d430509 100644 --- a/man2/select.2 +++ b/man2/select.2 @@ -44,7 +44,7 @@ synchronous I/O multiplexing /* According to POSIX.1-2001, POSIX.1-2008 */ .br .B #include -.PP + /* According to earlier standards */ .br .B #include @@ -63,7 +63,7 @@ synchronous I/O multiplexing .BI "void FD_SET(int " fd ", fd_set *" set ); .br .BI "void FD_ZERO(fd_set *" set ); -.PP + .B #include .PP .BI "int pselect(int " nfds ", fd_set *" readfds ", fd_set *" writefds , diff --git a/man2/select_tut.2 b/man2/select_tut.2 index 285863909e..7d710c76de 100644 --- a/man2/select_tut.2 +++ b/man2/select_tut.2 @@ -38,7 +38,7 @@ synchronous I/O multiplexing /* According to POSIX.1-2001, POSIX.1-2008 */ .br .B #include -.PP + /* According to earlier standards */ .br .B #include @@ -57,7 +57,7 @@ synchronous I/O multiplexing .BI "void FD_SET(int " fd ", fd_set *" set ); .br .BI "void FD_ZERO(fd_set *" set ); -.PP + .B #include .PP .BI "int pselect(int " nfds ", fd_set *" readfds ", fd_set *" writefds , diff --git a/man2/stat.2 b/man2/stat.2 index 4b3708666f..af55b1fbf0 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -53,7 +53,7 @@ stat, fstat, lstat, fstatat \- get file status .BI "int fstat(int " fd ", struct stat *" statbuf ); .br .BI "int lstat(const char *" pathname ", struct stat *" statbuf ); -.PP + .BR "#include " "/* Definition of AT_* constants */" .B #include .PP diff --git a/man2/symlink.2 b/man2/symlink.2 index 789580287c..8c558d5fb6 100644 --- a/man2/symlink.2 +++ b/man2/symlink.2 @@ -38,7 +38,7 @@ symlink, symlinkat \- make a new name for a file .B #include .PP .BI "int symlink(const char *" target ", const char *" linkpath ); -.PP + .BR "#include " "/* Definition of AT_* constants */" .B #include .PP diff --git a/man2/unlink.2 b/man2/unlink.2 index 11c048af8c..e0a86d1256 100644 --- a/man2/unlink.2 +++ b/man2/unlink.2 @@ -38,7 +38,7 @@ unlink, unlinkat \- delete a name and possibly the file it refers to .B #include .PP .BI "int unlink(const char *" pathname ); -.PP + .BR "#include " "/* Definition of AT_* constants */" .B #include .PP diff --git a/man3/__ppc_get_timebase.3 b/man3/__ppc_get_timebase.3 index c5bd02f802..0c998ca694 100644 --- a/man3/__ppc_get_timebase.3 +++ b/man3/__ppc_get_timebase.3 @@ -31,7 +31,7 @@ __ppc_get_timebase, __ppc_get_timebase_freq \- get the current value .B #include .PP .BI "uint64_t __ppc_get_timebase(void)" - +.PP .BI "uint64_t __ppc_get_timebase_freq(void);" .SH DESCRIPTION .BR __ppc_get_timebase () diff --git a/man3/abs.3 b/man3/abs.3 index 9329f8d21e..7519f3defa 100644 --- a/man3/abs.3 +++ b/man3/abs.3 @@ -43,7 +43,7 @@ abs, labs, llabs, imaxabs \- compute the absolute value of an integer .BI "long int labs(long int " j ); .br .BI "long long int llabs(long long int " j ); -.PP + .B #include .PP .BI "intmax_t imaxabs(intmax_t " j ); diff --git a/man3/bzero.3 b/man3/bzero.3 index 11bfb75b00..0247c44c7d 100644 --- a/man3/bzero.3 +++ b/man3/bzero.3 @@ -28,11 +28,11 @@ bzero, explicit_bzero \- zero a byte string .SH SYNOPSIS .nf .B #include - +.PP .BI "void bzero(void *" s ", size_t " n ); .B #include - +.PP .BI "void explicit_bzero(void *" s ", size_t " n ); .fi .SH DESCRIPTION diff --git a/man3/crypt.3 b/man3/crypt.3 index 5515d33aa1..35185c43f5 100644 --- a/man3/crypt.3 +++ b/man3/crypt.3 @@ -43,7 +43,7 @@ crypt, crypt_r \- password and data encryption .B #include .PP .BI "char *crypt(const char *" key ", const char *" salt ); -.PP + .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .br .B #include diff --git a/man3/dbopen.3 b/man3/dbopen.3 index 0db6d34f76..1ff08e5d60 100644 --- a/man3/dbopen.3 +++ b/man3/dbopen.3 @@ -43,7 +43,7 @@ dbopen \- database access methods .B #include .B #include .B #include - +.PP .BI "DB *dbopen(const char *" file ", int " flags ", int " mode \ ", DBTYPE " type , .BI " const void *" openinfo ); diff --git a/man3/dl_iterate_phdr.3 b/man3/dl_iterate_phdr.3 index bc8dc1de91..7c49ffa5f0 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -29,7 +29,7 @@ dl_iterate_phdr \- walk through list of shared objects .nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include - +.PP .BI "int dl_iterate_phdr(" .BI " int (*" callback ") (struct dl_phdr_info *" info , .BI " size_t " size ", void *" data ")," diff --git a/man3/dlinfo.3 b/man3/dlinfo.3 index 8d71fcd752..8de25ab2a4 100644 --- a/man3/dlinfo.3 +++ b/man3/dlinfo.3 @@ -31,9 +31,9 @@ dlinfo \- obtain information about a dynamically loaded object .B #define _GNU_SOURCE .B #include .B #include - +.PP .BR "int dlinfo(void *" handle ", int " request ", void *" info ); - +.PP Link with \fI\-ldl\fP. .fi .SH DESCRIPTION diff --git a/man3/dlsym.3 b/man3/dlsym.3 index cd673f313a..215f108167 100644 --- a/man3/dlsym.3 +++ b/man3/dlsym.3 @@ -29,7 +29,7 @@ dlsym, dlvsym \- obtain address of a symbol in a shared object or executable .B #include .PP .BI "void *dlsym(void *" handle ", const char *" symbol ); -.PP + .B #define _GNU_SOURCE .br .B #include diff --git a/man3/duplocale.3 b/man3/duplocale.3 index 7794959f03..5bc03d9c67 100644 --- a/man3/duplocale.3 +++ b/man3/duplocale.3 @@ -29,7 +29,7 @@ duplocale \- duplicate a locale object .SH SYNOPSIS .nf .B #include - +.PP .BI "locale_t duplocale(locale_t " locobj ); .fi .PP diff --git a/man3/encrypt.3 b/man3/encrypt.3 index 1f74ec6331..ef3dee393d 100644 --- a/man3/encrypt.3 +++ b/man3/encrypt.3 @@ -36,13 +36,13 @@ encrypt, setkey, encrypt_r, setkey_r \- encrypt 64-bit messages .B #include .PP .BI "void encrypt(char " block "[64], int " edflag ); -.PP + .BR "#define _XOPEN_SOURCE" " /* See feature_test_macros(7) */" .br .B #include .PP .BI "void setkey(const char *" key ); -.PP + .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .br .B "#include " diff --git a/man3/err.3 b/man3/err.3 index be0fe71d50..1d38a69a7b 100644 --- a/man3/err.3 +++ b/man3/err.3 @@ -50,7 +50,7 @@ err, verr, errx, verrx, warn, vwarn, warnx, vwarnx \- formatted error messages .BI "void warn(const char *" fmt ", ...);" .PP .BI "void warnx(const char *" fmt ", ...);" -.PP + .B #include .PP .BI "void verr(int " eval ", const char *" fmt ", va_list " args ); diff --git a/man3/ffs.3 b/man3/ffs.3 index 15ab23b4a2..ce653fcca3 100644 --- a/man3/ffs.3 +++ b/man3/ffs.3 @@ -38,7 +38,7 @@ ffs, ffsl, ffsll \- find first bit set in a word .B #include .PP .BI "int ffs(int " i ); -.PP + .B #include .PP .BI "int ffsl(long int " i ); diff --git a/man3/fpurge.3 b/man3/fpurge.3 index 56348a5eeb..7f9d87d06c 100644 --- a/man3/fpurge.3 +++ b/man3/fpurge.3 @@ -31,7 +31,7 @@ fpurge, __fpurge \- purge a stream .B #include .PP .BI "int fpurge(FILE *" stream ); -.PP + /* supported */ .B #include .br diff --git a/man3/ftw.3 b/man3/ftw.3 index 31b9a32225..9bfd4b1553 100644 --- a/man3/ftw.3 +++ b/man3/ftw.3 @@ -39,14 +39,14 @@ ftw, nftw \- file tree walk .SH SYNOPSIS .nf .B #include - +.PP .BI "int nftw(const char *" dirpath , .BI " int (*" fn ") (const char *" fpath ", const struct stat *" sb , .BI " int " typeflag ", struct FTW *" ftwbuf ), .BI " int " nopenfd ", int " flags ); .B #include - +.PP .BI "int ftw(const char *" dirpath , .BI " int (*" fn ") (const char *" fpath ", const struct stat *" sb , .BI " int " typeflag ), diff --git a/man3/getdate.3 b/man3/getdate.3 index f483636865..c37dc239f5 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -36,7 +36,7 @@ getdate, getdate_r \- convert a date-plus-time string to broken-down time .BI "struct tm *getdate(const char *" string ); .PP .B "extern int getdate_err;" -.PP + .B "#include " .PP .BI "int getdate_r(const char *" string ", struct tm *" res ); diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index c8c6499762..49b6e56e5b 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -49,7 +49,7 @@ gethostent_r \- get network host entry .B extern int h_errno; .PP .BI "struct hostent *gethostbyname(const char *" name ); -.PP + .BR "#include " " /* for AF_INET */" .BI "struct hostent *gethostbyaddr(const void *" addr , .BI " socklen_t " len ", int " type ); diff --git a/man3/getlogin.3 b/man3/getlogin.3 index 9020623274..08d9d38269 100644 --- a/man3/getlogin.3 +++ b/man3/getlogin.3 @@ -34,7 +34,7 @@ getlogin, getlogin_r, cuserid \- get username .B "char *getlogin(void);" .br .BI "int getlogin_r(char *" buf ", size_t " bufsize ); -.PP + .B #include .PP .BI "char *cuserid(char *" string ); diff --git a/man3/getmntent.3 b/man3/getmntent.3 index 5e78377c98..1743eb2524 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -47,7 +47,7 @@ getmntent_r \- get filesystem descriptor file entry .BI "int endmntent(FILE *" streamp ); .PP .BI "char *hasmntopt(const struct mntent *" mnt ", const char *" opt ); -.PP + /* GNU extension */ .B #include .PP diff --git a/man3/getpwent_r.3 b/man3/getpwent_r.3 index b5ef7d44cb..a8791a3d5d 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -29,11 +29,9 @@ getpwent_r, fgetpwent_r \- get passwd file entry reentrantly .B #include .PP .BI "int getpwent_r(struct passwd *" pwbuf ", char *" buf , -.br .BI " size_t " buflen ", struct passwd **" pwbufp ); .PP .BI "int fgetpwent_r(FILE *" stream ", struct passwd *" pwbuf ", char *" buf , -.br .BI " size_t " buflen ", struct passwd **" pwbufp ); .fi .PP diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index 137d7a4832..e9b9d34b36 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -47,11 +47,9 @@ getpwnam, getpwnam_r, getpwuid, getpwuid_r \- get password file entry .BI "struct passwd *getpwuid(uid_t " uid ); .PP .BI "int getpwnam_r(const char *" name ", struct passwd *" pwd , -.br .BI " char *" buf ", size_t " buflen ", struct passwd **" result ); .PP .BI "int getpwuid_r(uid_t " uid ", struct passwd *" pwd , -.br .BI " char *" buf ", size_t " buflen ", struct passwd **" result ); .fi .PP diff --git a/man3/getspnam.3 b/man3/getspnam.3 index e106799d77..2a7d1535c9 100644 --- a/man3/getspnam.3 +++ b/man3/getspnam.3 @@ -13,7 +13,6 @@ lckpwdf, ulckpwdf \- get shadow password file entry .SH SYNOPSIS .nf /* General shadow password file API */ -.br .B #include .PP .BI "struct spwd *getspnam(const char *" name ); @@ -33,25 +32,20 @@ lckpwdf, ulckpwdf \- get shadow password file entry .B int lckpwdf(void); .PP .B int ulckpwdf(void); -.PP + /* GNU extension */ -.br .B #include .PP .BI "int getspent_r(struct spwd *" spbuf , -.br .BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .PP .BI "int getspnam_r(const char *" name ", struct spwd *" spbuf , -.br .BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .PP .BI "int fgetspent_r(FILE *" stream ", struct spwd *" spbuf , -.br .BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .PP .BI "int sgetspent_r(const char *" s ", struct spwd *" spbuf , -.br .BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .fi .PP diff --git a/man3/inet_pton.3 b/man3/inet_pton.3 index 941da4cd09..1dfa813541 100644 --- a/man3/inet_pton.3 +++ b/man3/inet_pton.3 @@ -30,7 +30,7 @@ inet_pton \- convert IPv4 and IPv6 addresses from text to binary form .SH SYNOPSIS .nf .B #include - +.PP .BI "int inet_pton(int " "af" ", const char *" "src" ", void *" "dst" ); .fi .SH DESCRIPTION diff --git a/man3/insque.3 b/man3/insque.3 index 754c61b8c4..a882102bd2 100644 --- a/man3/insque.3 +++ b/man3/insque.3 @@ -41,7 +41,7 @@ insque, remque \- insert/remove an item from a queue .B #include .PP .BI "void insque(void *" elem ", void *" prev ); - +.PP .BI "void remque(void *" elem ); .fi .PP diff --git a/man3/isfdtype.3 b/man3/isfdtype.3 index 755630c21a..746c9839f7 100644 --- a/man3/isfdtype.3 +++ b/man3/isfdtype.3 @@ -30,7 +30,7 @@ isfdtype \- test file type of a file descriptor .nf .B #include .B #include - +.PP .BI "int isfdtype(int " fd ", int " fdtype ); .fi .PP diff --git a/man3/mallinfo.3 b/man3/mallinfo.3 index dd23f3c974..8e5a909abe 100644 --- a/man3/mallinfo.3 +++ b/man3/mallinfo.3 @@ -28,7 +28,7 @@ mallinfo \- obtain memory allocation information .SH SYNOPSIS .B #include - +.PP .B struct mallinfo mallinfo(void); .SH DESCRIPTION The diff --git a/man3/mallopt.3 b/man3/mallopt.3 index c735ed103d..db273ee054 100644 --- a/man3/mallopt.3 +++ b/man3/mallopt.3 @@ -28,7 +28,7 @@ mallopt \- set memory allocation parameters .SH SYNOPSIS .B #include - +.PP .BI "int mallopt(int " param ", int " value ); .SH DESCRIPTION The diff --git a/man3/matherr.3 b/man3/matherr.3 index 19935f3d87..006c7ef1c7 100644 --- a/man3/matherr.3 +++ b/man3/matherr.3 @@ -30,9 +30,9 @@ matherr \- SVID math library exception handling .SH SYNOPSIS .nf .B #include - +.PP .BI "int matherr(struct exception *" exc ); - +.PP .B extern _LIB_VERSION_TYPE _LIB_VERSION; .fi .PP diff --git a/man3/mcheck.3 b/man3/mcheck.3 index 1de46bee98..96cdba673f 100644 --- a/man3/mcheck.3 +++ b/man3/mcheck.3 @@ -30,11 +30,11 @@ mcheck, mcheck_check_all, mcheck_pedantic, mprobe \- heap consistency checking .B #include .PP .BI "int mcheck(void (*" abortfunc ")(enum mcheck_status " mstatus )); - +.PP .BI "int mcheck_pedantic(void (*" abortfunc ")(enum mcheck_status " mstatus )); - +.PP .B void mcheck_check_all(void); - +.PP .BI "enum mcheck_status mprobe(void *" ptr ); .fi .SH DESCRIPTION diff --git a/man3/mempcpy.3 b/man3/mempcpy.3 index ac5e341ac8..034dc6623e 100644 --- a/man3/mempcpy.3 +++ b/man3/mempcpy.3 @@ -13,13 +13,11 @@ mempcpy, wmempcpy \- copy memory area .SH SYNOPSIS .nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .BI "void *mempcpy(void *" dest ", const void *" src ", size_t " n ); -.PP + .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .BI "wchar_t *wmempcpy(wchar_t *" dest ", const wchar_t *" src ", size_t " n ); diff --git a/man3/mkfifo.3 b/man3/mkfifo.3 index 1351d8ac58..a5a7f927bc 100644 --- a/man3/mkfifo.3 +++ b/man3/mkfifo.3 @@ -34,7 +34,7 @@ mkfifo, mkfifoat \- make a FIFO special file (a named pipe) .B #include .PP .BI "int mkfifo(const char *" pathname ", mode_t " mode ); -.PP + .BR "#include " "/* Definition of AT_* constants */" .B #include .PP diff --git a/man3/mq_getattr.3 b/man3/mq_getattr.3 index 7144611a82..f115df53c6 100644 --- a/man3/mq_getattr.3 +++ b/man3/mq_getattr.3 @@ -31,7 +31,7 @@ mq_getattr, mq_setattr \- get/set message queue attributes .B #include .PP .BI "int mq_getattr(mqd_t " mqdes ", struct mq_attr *" attr ); - +.PP .BI "int mq_setattr(mqd_t " mqdes ", const struct mq_attr *" newattr "," .BI " struct mq_attr *" oldattr ); .fi diff --git a/man3/newlocale.3 b/man3/newlocale.3 index 578ef38a13..46e8d9dd82 100644 --- a/man3/newlocale.3 +++ b/man3/newlocale.3 @@ -29,10 +29,10 @@ newlocale, freelocale \- create, modify, and free a locale object .SH SYNOPSIS .nf .B #include - +.PP .BI "locale_t newlocale(int " category_mask ", const char *" locale ", .BI " locale_t " base ); - +.PP .BI "void freelocale(locale_t " locobj ); .fi .PP diff --git a/man3/open_memstream.3 b/man3/open_memstream.3 index 9a10d733d1..27042ecf0b 100644 --- a/man3/open_memstream.3 +++ b/man3/open_memstream.3 @@ -12,11 +12,11 @@ open_memstream, open_wmemstream \- open a dynamic memory buffer stream .SH SYNOPSIS .nf .B #include - +.PP .BI "FILE *open_memstream(char **" ptr ", size_t *" sizeloc ); .B #include - +.PP .BI "FILE *open_wmemstream(wchar_t **" ptr ", size_t *" sizeloc ); .fi .PP diff --git a/man3/openpty.3 b/man3/openpty.3 index 24660bdda4..db317aa361 100644 --- a/man3/openpty.3 +++ b/man3/openpty.3 @@ -45,7 +45,7 @@ openpty, login_tty, forkpty \- terminal utility functions .BI "pid_t forkpty(int *" amaster ", char *" name , .BI " const struct termios *" termp , .BI " const struct winsize *" winp ); -.PP + .B #include .PP .BI "int login_tty(int " fd ); diff --git a/man3/perror.3 b/man3/perror.3 index ef57ea6f96..ab383f444b 100644 --- a/man3/perror.3 +++ b/man3/perror.3 @@ -35,7 +35,7 @@ perror \- print a system error message .B #include .PP .BI "void perror(const char *" s ); -.PP + .B #include .PP .BI "const char * const " sys_errlist []; diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3 index ad411b7fed..3a0950c69a 100644 --- a/man3/posix_memalign.3 +++ b/man3/posix_memalign.3 @@ -36,7 +36,7 @@ posix_memalign, aligned_alloc, memalign, valloc, pvalloc \- allocate aligned mem .BI "int posix_memalign(void **" memptr ", size_t " alignment ", size_t " size ); .BI "void *aligned_alloc(size_t " alignment ", size_t " size ); .BI "void *valloc(size_t " size ); -.PP + .B #include .PP .BI "void *memalign(size_t " alignment ", size_t " size ); diff --git a/man3/posix_spawn.3 b/man3/posix_spawn.3 index 3dd9a1fd8a..cc646b34aa 100644 --- a/man3/posix_spawn.3 +++ b/man3/posix_spawn.3 @@ -34,12 +34,12 @@ posix_spawn, posix_spawnp \- spawn a process .SH SYNOPSIS .nf .B #include - +.PP .BI "int posix_spawn(pid_t *" pid ", const char *" path , .BI " const posix_spawn_file_actions_t *" file_actions , .BI " const posix_spawnattr_t *" attrp , .BI " char *const " argv[] ", char *const " envp[] ); - +.PP .BI "int posix_spawnp(pid_t *" pid ", const char *" file , .BI " const posix_spawn_file_actions_t *" file_actions , .BI " const posix_spawnattr_t *" attrp , diff --git a/man3/printf.3 b/man3/printf.3 index dae1ced1e3..ad80df5ad6 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -47,7 +47,7 @@ vsprintf, vsnprintf \- formatted output conversion .BI "int sprintf(char *" str ", const char *" format ", ...);" .br .BI "int snprintf(char *" str ", size_t " size ", const char *" format ", ...);" -.PP + .B #include .PP .BI "int vprintf(const char *" format ", va_list " ap ); diff --git a/man3/pthread_attr_init.3 b/man3/pthread_attr_init.3 index 1433f98f84..293617edc7 100644 --- a/man3/pthread_attr_init.3 +++ b/man3/pthread_attr_init.3 @@ -30,7 +30,7 @@ thread attributes object .SH SYNOPSIS .nf .B #include - +.PP .BI "int pthread_attr_init(pthread_attr_t *" attr ); .BI "int pthread_attr_destroy(pthread_attr_t *" attr ); .PP diff --git a/man3/pthread_cancel.3 b/man3/pthread_cancel.3 index 8450e72c00..8c9b206476 100644 --- a/man3/pthread_cancel.3 +++ b/man3/pthread_cancel.3 @@ -29,7 +29,7 @@ pthread_cancel \- send a cancellation request to a thread .SH SYNOPSIS .nf .B #include - +.PP .BI "int pthread_cancel(pthread_t " thread ); .PP Compile and link with \fI\-pthread\fP. diff --git a/man3/pthread_cleanup_push.3 b/man3/pthread_cleanup_push.3 index 26c319f02d..928615dbc9 100644 --- a/man3/pthread_cleanup_push.3 +++ b/man3/pthread_cleanup_push.3 @@ -30,7 +30,7 @@ thread cancellation clean-up handlers .SH SYNOPSIS .nf .B #include - +.PP .BI "void pthread_cleanup_push(void (*" routine ")(void *)," .BI " void *" arg ); .BI "void pthread_cleanup_pop(int " execute ); diff --git a/man3/pthread_create.3 b/man3/pthread_create.3 index a433d44728..33099adb0c 100644 --- a/man3/pthread_create.3 +++ b/man3/pthread_create.3 @@ -29,7 +29,7 @@ pthread_create \- create a new thread .SH SYNOPSIS .nf .B #include - +.PP .BI "int pthread_create(pthread_t *" thread ", const pthread_attr_t *" attr , .BI " void *(*" start_routine ") (void *), void *" arg ); .fi diff --git a/man3/pthread_getattr_default_np.3 b/man3/pthread_getattr_default_np.3 index 059611075c..bfcd52d0dd 100644 --- a/man3/pthread_getattr_default_np.3 +++ b/man3/pthread_getattr_default_np.3 @@ -30,7 +30,7 @@ get or set default thread-creation attributes .nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include - +.PP .BI "int pthread_getattr_default_np(pthread_attr_t *" attr ); .BI "int pthread_setattr_default_np(pthread_attr_t *" attr ); .PP diff --git a/man3/pthread_getattr_np.3 b/man3/pthread_getattr_np.3 index 679f139738..0b0224c8f4 100644 --- a/man3/pthread_getattr_np.3 +++ b/man3/pthread_getattr_np.3 @@ -30,7 +30,7 @@ pthread_getattr_np \- get attributes of created thread .nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include - +.PP .BI "int pthread_getattr_np(pthread_t " thread ", pthread_attr_t *" attr ); .PP Compile and link with \fI\-pthread\fP. diff --git a/man3/pthread_getcpuclockid.3 b/man3/pthread_getcpuclockid.3 index 6efc6738c3..73fbcea1fc 100644 --- a/man3/pthread_getcpuclockid.3 +++ b/man3/pthread_getcpuclockid.3 @@ -30,7 +30,7 @@ pthread_getcpuclockid \- retrieve ID of a thread's CPU time clock .nf .B #include .B #include - +.PP .BI "int pthread_getcpuclockid(pthread_t " thread ", clockid_t *" clock_id ); .PP Compile and link with \fI\-pthread\fP. diff --git a/man3/pthread_setaffinity_np.3 b/man3/pthread_setaffinity_np.3 index 96736f0f65..64487719de 100644 --- a/man3/pthread_setaffinity_np.3 +++ b/man3/pthread_setaffinity_np.3 @@ -31,7 +31,7 @@ CPU affinity of a thread .nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include - +.PP .BI "int pthread_setaffinity_np(pthread_t " thread ", size_t " cpusetsize , .BI " const cpu_set_t *" cpuset ); .BI "int pthread_getaffinity_np(pthread_t " thread ", size_t " cpusetsize , diff --git a/man3/pthread_setschedparam.3 b/man3/pthread_setschedparam.3 index 01a92e8484..08cf3f790e 100644 --- a/man3/pthread_setschedparam.3 +++ b/man3/pthread_setschedparam.3 @@ -30,7 +30,7 @@ scheduling policy and parameters of a thread .SH SYNOPSIS .nf .B #include - +.PP .BI "int pthread_setschedparam(pthread_t " thread ", int " policy , .BI " const struct sched_param *" param ); .BI "int pthread_getschedparam(pthread_t " thread ", int *" policy , diff --git a/man3/pthread_sigmask.3 b/man3/pthread_sigmask.3 index 400d81f817..e528448e56 100644 --- a/man3/pthread_sigmask.3 +++ b/man3/pthread_sigmask.3 @@ -29,7 +29,7 @@ pthread_sigmask \- examine and change mask of blocked signals .SH SYNOPSIS .nf .B #include - +.PP .BI "int pthread_sigmask(int " how ", const sigset_t *" set \ ", sigset_t *" oldset ); .fi diff --git a/man3/pthread_sigqueue.3 b/man3/pthread_sigqueue.3 index d09be06428..a123a23a09 100644 --- a/man3/pthread_sigqueue.3 +++ b/man3/pthread_sigqueue.3 @@ -29,7 +29,7 @@ pthread_sigqueue \- queue a signal and data to a thread .nf .B #include .B #include - +.PP .BI "int pthread_sigqueue(pthread_t " thread ", int " sig , .BI " const union sigval " value ); .fi diff --git a/man3/regex.3 b/man3/regex.3 index 90ffb8cdb5..68aab89a84 100644 --- a/man3/regex.3 +++ b/man3/regex.3 @@ -34,16 +34,16 @@ regcomp, regexec, regerror, regfree \- POSIX regex functions .nf .B #include .B #include - +.PP .BI "int regcomp(regex_t *" preg ", const char *" regex ", int " cflags ); - +.PP .BI "int regexec(const regex_t *" preg ", const char *" string \ ", size_t " nmatch , .BI " regmatch_t " pmatch[] ", int " eflags ); - +.PP .BI "size_t regerror(int " errcode ", const regex_t *" preg ", char *" errbuf , .BI " size_t " errbuf_size ); - +.PP .BI "void regfree(regex_t *" preg ); .fi .SH DESCRIPTION diff --git a/man3/resolver.3 b/man3/resolver.3 index a0bf15424d..b23bf5b323 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -40,39 +40,39 @@ dn_comp, dn_expand \- resolver routines .B #include .B #include .B #include - +.PP .B struct __res_state; .B typedef struct __res_state *res_state; - +.PP .BI "int res_ninit(res_state " statep ); - +.PP .BI "int res_nquery(res_state " statep , .BI " const char *" dname ", int " class ", int " type , .BI " unsigned char *" answer ", int " anslen ); - +.PP .BI "int res_nsearch(res_state " statep , .BI " const char *" dname ", int " class ", int " type , .BI " unsigned char *" answer ", int " anslen ); - +.PP .BI "int res_nquerydomain(res_state " statep , .BI " const char *" name ", const char *" domain , .BI " int " class ", int " type ", unsigned char *" answer , .BI " int " anslen ); - +.PP .BI "int res_nmkquery(res_state " statep , .BI " int " op ", const char *" dname ", int " class , .BI " int " type ", const unsigned char *" data ", int " datalen , .BI " const unsigned char *" newrr , .BI " unsigned char *" buf ", int " buflen ); - +.PP .BI "int res_nsend(res_state " statep , .BI " const unsigned char *" msg ", int " msglen , .BI " unsigned char *" answer ", int " anslen ); - +.PP .BI "int dn_comp(const char *" exp_dn ", unsigned char *" comp_dn , .BI " int " length ", unsigned char **" dnptrs , .BI " unsigned char **" lastdnptr ); - +.PP .BI "int dn_expand(const unsigned char *" msg , .BI " const unsigned char *" eomorig , .BI " const unsigned char *" comp_dn ", char *" exp_dn , @@ -82,24 +82,24 @@ dn_comp, dn_expand \- resolver routines .SS Deprecated .nf .B extern struct __res_state _res; - +.PP .B int res_init(void); - +.PP .BI "int res_query(const char *" dname ", int " class ", int " type , .BI " unsigned char *" answer ", int " anslen ); - +.PP .BI "int res_search(const char *" dname ", int " class ", int " type , .BI " unsigned char *" answer ", int " anslen ); - +.PP .BI "int res_querydomain(const char *" name ", const char *" domain , .BI " int " class ", int " type ", unsigned char *" answer , .BI " int " anslen ); - +.PP .BI "int res_mkquery(int " op ", const char *" dname ", int " class , .BI " int " type ", const unsigned char *" data ", int " datalen , .BI " const unsigned char *" newrr , .BI " unsigned char *" buf ", int " buflen ); - +.PP .BI "int res_send(const unsigned char *" msg ", int " msglen , .BI " unsigned char *" answer ", int " anslen ); .fi diff --git a/man3/rpmatch.3 b/man3/rpmatch.3 index 4255b15cc7..2230344310 100644 --- a/man3/rpmatch.3 +++ b/man3/rpmatch.3 @@ -32,7 +32,7 @@ rpmatch \- determine if the answer to a question is affirmative or negative .SH SYNOPSIS .nf .B #include - +.PP .BI "int rpmatch(const char *" response ); .fi .PP diff --git a/man3/rtnetlink.3 b/man3/rtnetlink.3 index 994d9c7ba3..bc3e979ea9 100644 --- a/man3/rtnetlink.3 +++ b/man3/rtnetlink.3 @@ -20,7 +20,7 @@ rtnetlink \- macros to manipulate rtnetlink messages .B #include .br .B #include - +.PP .BI "rtnetlink_socket = socket(AF_NETLINK, int " socket_type \ ", NETLINK_ROUTE);" .PP diff --git a/man3/scanf.3 b/man3/scanf.3 index 9339041dad..b86f639c64 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -55,13 +55,13 @@ scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- input format conversion .SH SYNOPSIS .nf .B #include - +.PP .BI "int scanf(const char *" format ", ...);" .BI "int fscanf(FILE *" stream ", const char *" format ", ...);" .BI "int sscanf(const char *" str ", const char *" format ", ...);" -.PP -.B #include +.B #include +.PP .BI "int vscanf(const char *" format ", va_list " ap ); .BI "int vsscanf(const char *" str ", const char *" format ", va_list " ap ); .BI "int vfscanf(FILE *" stream ", const char *" format ", va_list " ap ); diff --git a/man3/setbuf.3 b/man3/setbuf.3 index 1003a1d549..61df9f256d 100644 --- a/man3/setbuf.3 +++ b/man3/setbuf.3 @@ -51,13 +51,13 @@ setbuf, setbuffer, setlinebuf, setvbuf \- stream buffering operations .SH SYNOPSIS .nf .B #include - +.PP .BI "void setbuf(FILE *" stream ", char *" buf ); - +.PP .BI "void setbuffer(FILE *" stream ", char *" buf ", size_t " size ); - +.PP .BI "void setlinebuf(FILE *" stream ); - +.PP .BI "int setvbuf(FILE *" stream ", char *" buf ", int " mode \ ", size_t " size ); .fi diff --git a/man3/strchr.3 b/man3/strchr.3 index 07b55bebfe..606578ed79 100644 --- a/man3/strchr.3 +++ b/man3/strchr.3 @@ -40,7 +40,7 @@ strchr, strrchr, strchrnul \- locate character in string .BI "char *strchr(const char *" s ", int " c ); .PP .BI "char *strrchr(const char *" s ", int " c ); -.PP + .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include .PP diff --git a/man3/strfromd.3 b/man3/strfromd.3 index 892bb3d445..1888a6510b 100644 --- a/man3/strfromd.3 +++ b/man3/strfromd.3 @@ -36,7 +36,7 @@ a string .SH SYNOPSIS .nf .B #include - +.PP .BI "int strfromd(char *restrict " str ", size_t " n ", .BI " const char *restrict " format ", double " fp ");" .BI "int strfromf(char *restrict " str ", size_t " n ", @@ -44,7 +44,7 @@ a string .BI "int strfroml(char *restrict " str ", size_t " n ", .BI " const char *restrict " format ", long double " fp ");" .fi - +.PP .in -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): diff --git a/man3/strverscmp.3 b/man3/strverscmp.3 index 75f5dcf260..e71e1b6d58 100644 --- a/man3/strverscmp.3 +++ b/man3/strverscmp.3 @@ -29,7 +29,6 @@ strverscmp \- compare two version strings .SH SYNOPSIS .nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .BI "int strverscmp(const char *" s1 ", const char *" s2 ); diff --git a/man3/termios.3 b/man3/termios.3 index add5ef9a2f..4520572193 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -45,7 +45,6 @@ get and set terminal attributes, line control, get and set baud rate .SH SYNOPSIS .nf .B #include -.br .B #include .PP .BI "int tcgetattr(int " fd ", struct termios *" termios_p ); diff --git a/man3/tsearch.3 b/man3/tsearch.3 index 944dee9147..4d277867a0 100644 --- a/man3/tsearch.3 +++ b/man3/tsearch.3 @@ -41,9 +41,8 @@ tsearch, tfind, tdelete, twalk, tdestroy \- manage a binary tree .BI "void twalk(const void *" root ", void (*" action ")(const void *" nodep , .BI " const VISIT " which , .BI " const int " depth "));" -.PP + .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .BI "void tdestroy(void *" root ", void (*" free_node ")(void *" nodep )); diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3 index 49e294aa11..ec5fc9a3dc 100644 --- a/man3/unlocked_stdio.3 +++ b/man3/unlocked_stdio.3 @@ -49,7 +49,7 @@ putchar_unlocked \- nonlocking stdio functions .PP .BI "char *fgets_unlocked(char *" s ", int " n ", FILE *" stream ); .BI "int fputs_unlocked(const char *" s ", FILE *" stream ); -.PP + .B #include .PP .BI "wint_t getwc_unlocked(FILE *" stream ); diff --git a/man3/updwtmp.3 b/man3/updwtmp.3 index 67ff9d18c7..aa06ab4ad3 100644 --- a/man3/updwtmp.3 +++ b/man3/updwtmp.3 @@ -38,7 +38,7 @@ updwtmp, logwtmp \- append an entry to the wtmp file .BI "void logwtmp(const char *" line ", const char *" name \ ", const char *" host ); .fi - +.PP For .BR logwtmp (), link with \fI\-lutil\fP. diff --git a/man7/netlink.7 b/man7/netlink.7 index 3dab0b9924..b4cc0f93a7 100644 --- a/man7/netlink.7 +++ b/man7/netlink.7 @@ -16,7 +16,7 @@ netlink \- communication between kernel and user space (AF_NETLINK) .B #include .B #include .B #include - +.PP .BI "netlink_socket = socket(AF_NETLINK, " socket_type ", " netlink_family ); .fi .SH DESCRIPTION diff --git a/man7/rtld-audit.7 b/man7/rtld-audit.7 index 52fbdcdc5b..1853d32393 100644 --- a/man7/rtld-audit.7 +++ b/man7/rtld-audit.7 @@ -29,9 +29,10 @@ .SH NAME rtld-audit \- auditing API for the dynamic linker .SH SYNOPSIS +.nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" - .B #include +.fi .SH DESCRIPTION The GNU dynamic linker (run-time linker) provides an auditing API that allows an application diff --git a/man7/sock_diag.7 b/man7/sock_diag.7 index f29ae07620..f8eab86418 100644 --- a/man7/sock_diag.7 +++ b/man7/sock_diag.7 @@ -30,7 +30,7 @@ sock_diag \- obtaining information about sockets .B #include .BR "#include " " /* for UNIX domain sockets */" .BR "#include " " /* for IPv4 and IPv6 sockets */" - +.PP .BI "diag_socket = socket(AF_NETLINK, " socket_type ", NETLINK_SOCK_DIAG);" .fi .SH DESCRIPTION diff --git a/man7/unix.7 b/man7/unix.7 index feda14ed3f..0204a33de2 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -24,7 +24,7 @@ unix \- sockets for local interprocess communication .B #include .br .B #include - +.PP .IB unix_socket " = socket(AF_UNIX, type, 0);" .br .IB error " = socketpair(AF_UNIX, type, 0, int *" sv ");"