From: Krónos Date: Sun, 10 Oct 1993 23:00:00 +0000 (+0100) Subject: man-pages 1.0 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fheads%2Fprehistory-backwards;p=thirdparty%2Fman-pages.git man-pages 1.0 man-pages-1.1 seems to be missing. :/ Link: Signed-off-by: Alejandro Colomar --- diff --git a/man-pages-1.0.Announce b/man-pages-1.0.Announce new file mode 100644 index 0000000000..31c9b1e2d4 --- /dev/null +++ b/man-pages-1.0.Announce @@ -0,0 +1,37 @@ + + +The Linux Documentation Project proudly announces. . . + + + man-pages-1.0.tar.gz - section 2, 3, 4, 5, 7, and 9 man pages for Linux + + +Here is a breakdown of what this distribution contains: + +Section 2 = system calls +Section 3 = libc calls +Section 4 = devices (e.g., hd, sd) +Section 5 = file formats (e.g., /etc/wtmp, /etc/passwd) +Section 7 = macro packages, etc. (e.g., nroff, ascii) +Section 9 = internal kernel routines (for kernel hackers) + +Note that only Section 2 is really complete, but Section 3 contains several +hundred man pages. I have included all completed man pages in this +distribution to give people an idea of what is available. If you want to +write some man pages, please join the linux-activists DOC channel. + +To install this distribution, do something like: + + cd /usr/man; gtar zxvvpf man-pages-1.0.tar.gz + +I would like to thank the following people (in alphabetical order by first +name) who wrote, edited, or otherwise contributed to this project: + +Alan Cox +Dan Miner +Darren Senn +David Metcalfe +Drew Eckhardt +Ian Jackson +Michael Haardt +Thomas Koenig diff --git a/man-pages-1.2.lsm b/man-pages-1.0.lsm similarity index 88% rename from man-pages-1.2.lsm rename to man-pages-1.0.lsm index 48adf8fe7c..517a60a9b1 100644 --- a/man-pages-1.2.lsm +++ b/man-pages-1.0.lsm @@ -1,6 +1,6 @@ Begin2 Title = Section 2, 3, 4, 5, 7, and 9 man pages for Linux -Version = 1.2 +Version = 1.0 Desc1 = Man pages for Linux. Mostly section 2 is complete. Section Desc2 = 3 has over 200 man pages, but it still far from being finished. Author = Linux Documentation Project @@ -9,7 +9,7 @@ Maintainer = Rik Faith MaintEmail = faith@cs.unc.edu Site1 = ftp.cs.unc.edu Path1 = /pub/faith/linux -File1 = man-pages-1.2.tar.gz +File1 = man-pages-1.0.tar.gz FileSize1 = 150k Site2 = sunsite.unc.edu Path2 = /pub/Linux/? @@ -17,7 +17,7 @@ Site3 = tsx-11.mit.edu Path3 = /pub/linux/docs/man CopyPolicy1 = GPL, Public Domain, or otherwise freely copyable Keywords = man pages -Entered = Mon Nov 29 16:23:35 1993 +Entered = Mon Oct 11 14:15:35 1993 EnteredBy = Rik Faith CheckedEmail = faith@cs.unc.edu End diff --git a/man-pages-1.2.Announce b/man-pages-1.2.Announce deleted file mode 100644 index e7f0e4adee..0000000000 --- a/man-pages-1.2.Announce +++ /dev/null @@ -1,63 +0,0 @@ - - -The Linux Documentation Project proudly announces. . . - - - man-pages-1.2.tar.gz - section 2, 3, 4, 5, 7, and 9 man pages for Linux - -Differences from version 1.0: - Thanks to Giorgio Ciucci for the following *NEW* man pages: - msgctl.2 msgrcv.2 semget.2 shmdt.2 - msgget.2 msgsnd.2 semop.2 ipc.5 - msgop.2 semctl.2 shmat.2 ftok.3 - and for updates to shmctl.2, shmget.2, and shmop.2. - - Michael Haardt pointed out that some general formatting problems needed - fixing: - Multi-word arguments to .SH are now in quotes - Many instances of - (hyphen) were changed to \- (minus) - Several instances of \- (minus) were changed to \(em (dash) - - shells.5 updated (thanks to Michael Haardt) - gethostid.2 updated (thanks for Mitchum DSouza) - Minor updates to write.2, man.7, and a few other man pages. - Fully converted BSD man pages for: - all of the stdio functions (includes printf and scanf) - alloca, popen, stdarg, and exec - - -Here is a breakdown of what this distribution contains: - -Section 2 = system calls -Section 3 = libc calls -Section 4 = devices (e.g., hd, sd) -Section 5 = file formats (e.g., wtmp, /etc/passwd) -Section 7 = macro packages, etc. (e.g., nroff, ascii) -Section 9 = internal kernel routines (for kernel hackers) - -(There are no section 1 or section 8 man pages because these should be -distributed with the binaries they are written for.) - -Note that only Section 2 is really complete, but Section 3 contains several -hundred man pages. I have included all completed man pages in this -distribution to give people an idea of what is available. If you want to -write some man pages, please join the linux-activists DOC channel. - -To install this distribution, do something like: - - cd /usr/man; zcat man-pages-1.2.tar.gz | tar xvpf - - -I would like to thank the following people (in alphabetical order by first -name) who wrote, edited, or otherwise contributed to this project: - -Alan Cox -Dan Miner -Darren Senn -David Metcalfe -Drew Eckhardt -Giorgio Ciucci -Ian Jackson -Luigi P. Bai -Michael Haardt -Mitchum DSouza -Thomas Koenig diff --git a/man2/_exit.2 b/man2/_exit.2 index b317990f6c..ba89a9f9f1 100644 --- a/man2/_exit.2 +++ b/man2/_exit.2 @@ -27,10 +27,10 @@ is returned to the parent process as the process's exit status, and can be collected using one of the .B wait family of calls. -.SH "RETURN VALUE" +.SH RETURN VALUE .B _exit never returns. -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, X/OPEN, BSD 4.3 .SH NOTES .B _exit @@ -39,6 +39,6 @@ does not call any functions registered with the ANSI C function and does not flush standard I/O buffers. To do these things, use .BR exit (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR fork "(2), " execve "(2), " waitpid "(2), " wait4 "(2), " kill "(2), " .BR wait "(3), " exit (3) diff --git a/man2/accept.2 b/man2/accept.2 index bfba018cc5..2bc424313a 100644 --- a/man2/accept.2 +++ b/man2/accept.2 @@ -116,7 +116,7 @@ by issuing a call with providing only the control information, or by calling .BR setsockopt (2). -.SH "RETURN VALUES" +.SH RETURN VALUES The call returns \-1 on error. If it succeeds, it returns a non-negative integer that is a descriptor for the accepted socket. .SH ERRORS @@ -143,5 +143,5 @@ present to be accepted. The .B accept function appeared in BSD 4.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR bind "(2), " connect "(2), " listen "(2), " select "(2), " socket (2) diff --git a/man2/access.2 b/man2/access.2 index 2ff22fb0ec..2248bcf69f 100644 --- a/man2/access.2 +++ b/man2/access.2 @@ -50,7 +50,7 @@ file. Similarly, a DOS file may be found to be "executable," but the .BR execve (2) call will still fail. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -87,7 +87,7 @@ Insufficient kernel memory was available. .I pathname contains a reference to a circular symbolic link, i.e., a symbolic link containing a reference to itself. -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, X/OPEN, BSD 4.3 .SH BUGS .IR Important! " Currently (as of Linux 0.99pl11) the " real @@ -96,6 +96,6 @@ uid and gid are only used when checking access to the final component of the checks on any intervening directories are made using the .I effective ids. -.SH "SEE ALSO" +.SH SEE ALSO .BR stat "(2), " open "(2), " chmod "(2), " chown "(2), " .BR setuid "(2), " setgid (2). diff --git a/man2/acct.2 b/man2/acct.2 index a3e8215862..348eba6cc7 100644 --- a/man2/acct.2 +++ b/man2/acct.2 @@ -23,7 +23,7 @@ acct \- switch process accounting on or off .SH DESCRIPTION .BR WARNING : Since this function is not implemented as of Linux 0.99.11, it will always -return \-1 and set +return -1 and set .I errno to .BR ENOSYS . @@ -35,7 +35,7 @@ turned on, records for each terminating process are appended to \fIfilename\fP as it terminates. An argument of \fBNULL\fP causes accounting to be turned off. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH NOTES diff --git a/man2/alarm.2 b/man2/alarm.2 index 8365d66437..600a1dc4f3 100644 --- a/man2/alarm.2 +++ b/man2/alarm.2 @@ -31,7 +31,7 @@ is scheduled. In any event any previously set .B alarm is cancelled. -.SH "RETURN VALUE" +.SH RETURN VALUE .B alarm returns the number of seconds remaining until any previously scheduled alarm was due to be delivered, or zero if there was no previously @@ -43,8 +43,8 @@ other. Scheduling delays can, as ever, cause the execution of the process to be delayed by an arbitrary amount of time. -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, X/OPEN, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR setitimer "(2), " signal "(2), " sigaction "(2), " .BR gettimeofday "(2), " select "(2), " pause "(2), " sleep (3) diff --git a/man2/bind.2 b/man2/bind.2 index 7655ee913d..a7d202aeeb 100644 --- a/man2/bind.2 +++ b/man2/bind.2 @@ -68,7 +68,7 @@ that must be deleted by the caller when it is no longer needed (using The rules used in name binding vary between communication domains. Consult the manual entries in section 4 for detailed information. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -125,6 +125,6 @@ contains a circular reference (i.e., via a symbolic link) The .B bind function call appeared in BSD 4.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR accept "(2), " connect "(2), " listen "(2), " .BR socket "(2), " getsockname (2) diff --git a/man2/brk.2 b/man2/brk.2 index f6c949f913..d1d45b946a 100644 --- a/man2/brk.2 +++ b/man2/brk.2 @@ -34,7 +34,7 @@ On success, .B brk returns zero, and .B sbrk -returns a pointer to the start of the new area. On error, \-1 is returned, +returns a pointer to the start of the new area. On error, -1 is returned, and .I errno is set to diff --git a/man2/chdir.2 b/man2/chdir.2 index 63b32c202b..04a44ddb59 100644 --- a/man2/chdir.2 +++ b/man2/chdir.2 @@ -17,7 +17,7 @@ chdir \- change working directory changes the current directory to that specified in .IR path . .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/chmod.2 b/man2/chmod.2 index 454c4a31a3..85b4431b8c 100644 --- a/man2/chmod.2 +++ b/man2/chmod.2 @@ -78,7 +78,7 @@ super-user can set the sticky bit, which may have a special meaning (i.e., for directories, a file can only be deleted by the owner or the super-user). .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/chown.2 b/man2/chown.2 index a50626fba5..97b052b37e 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -29,9 +29,9 @@ If the .I owner or .I group -is specified as \-1, then that ID is not changed. +is specified as -1, then that ID is not changed. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/chroot.2 b/man2/chroot.2 index 6772370deb..2f5dc712e5 100644 --- a/man2/chroot.2 +++ b/man2/chroot.2 @@ -20,7 +20,7 @@ The root directory is inherited by all children of the current process. Only the super-user may change the root directory. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/close.2 b/man2/close.2 index dd36e12caf..4dbc8df175 100644 --- a/man2/close.2 +++ b/man2/close.2 @@ -29,16 +29,16 @@ and if the descriptor was the last reference to a file which has been removed using .B unlink the file is deleted. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR close -returns zero on success, or \-1 if an error occurred. +returns zero on success, or -1 if an error occurred. .SH ERRORS .TP .B EBADF .I fd isn't a valid open file descriptor. -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, X/OPEN, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR open "(2), " fcntl "(2), " shutdown (2), .BR unlink "(2), " fclose "(3). diff --git a/man2/connect.2 b/man2/connect.2 index cf881ec47f..82406582a4 100644 --- a/man2/connect.2 +++ b/man2/connect.2 @@ -71,7 +71,7 @@ multiple times to change their association. Datagram sockets may dissolve the association by connecting to an invalid address, such as a null address. .SH "RETURN VALUE" -If the connection or binding succeeds, zero is returned. On error, \-1 is +If the connection or binding succeeds, zero is returned. On error, -1 is returned, and .I errno is set appropriately. @@ -81,6 +81,6 @@ See the Linux kernel source code for details. The .B connect function call first appeared in BSD 4.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR accept "(2), " bind "(2), " listen "(2), " .BR socket "(2), " getsokname (2) diff --git a/man2/dup.2 b/man2/dup.2 index df1da83b5c..b30330ba9e 100644 --- a/man2/dup.2 +++ b/man2/dup.2 @@ -36,9 +36,9 @@ uses the lowest-numbered unused descriptor for the new descriptor. .B dup2 .RI "makes " newfd " be the copy of " oldfd ", closing " oldfd first if necessary. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR dup " and " dup2 -return the new descriptor, or \-1 if an error occurred (in which case, +return the new descriptor, or -1 if an error occurred (in which case, .I errno is set appropriately). .SH ERRORS @@ -65,7 +65,7 @@ also sometimes returns .B EINVAL like .BR F_DUPFD . -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, X/OPEN, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR F_DUPFD "(2), " fcntl "(2), " open "(2), " close (2). diff --git a/man2/execve.2 b/man2/execve.2 index b044e261a7..90aa0dc3e5 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -27,7 +27,7 @@ on the parent process are cleared. If the current program is being ptraced, a \fBSIGTRAP\fP is sent to it after a successful \fBexecve()\fP. .SH "RETURN VALUE" -On success, \fBexecve()\fP does not return, on error \-1 is returned, and +On success, \fBexecve()\fP does not return, on error -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/fcntl.2 b/man2/fcntl.2 index 0942a6bd6d..8c23e60cb2 100644 --- a/man2/fcntl.2 +++ b/man2/fcntl.2 @@ -114,7 +114,7 @@ Value of falgs. F_GETOWN Value of descriptor owner. .PP -On error, \-1 is returned, and +On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -138,9 +138,9 @@ The errors returned by .B dup2 are different from those returned by .BR F_DUPFD . -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, X/OPEN, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR open "(2), " .BR F_DUPFD "(2), " F_GETFD "(2), " F_GETFL "(2), " F_GETLK "(2), " .BR socket "(2). " diff --git a/man2/flock.2 b/man2/flock.2 index 0e96847279..ef9b4dc736 100644 --- a/man2/flock.2 +++ b/man2/flock.2 @@ -44,7 +44,7 @@ and .BR fork (2) do not create multiple instances of a lock. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -61,6 +61,6 @@ is implemented as a call to Please see .BR fcntl (2) for more details on errors. -.SH "SEE ALSO" +.SH SEE ALSO .BR open "(2), " close "(2), " dup "(2), " execve "(2), " fcntl "(2), " .BR fork "(2), " diff --git a/man2/fork.2 b/man2/fork.2 index 2be47c7776..869a05aa62 100644 --- a/man2/fork.2 +++ b/man2/fork.2 @@ -27,7 +27,7 @@ and to create a unique task structure for the child. .SH "RETURN VALUE" On success, the PID of the child process is returned in the parent's thread of execution, and a 0 is returned in the child's thread of execution. On -failure, a \-1 will be returned in the parent's context, no child process +failure, a -1 will be returned in the parent's context, no child process will be created, and .I errno will be set appropriately. diff --git a/man2/fsync.2 b/man2/fsync.2 index 4578535b31..4b9879a63d 100644 --- a/man2/fsync.2 +++ b/man2/fsync.2 @@ -13,7 +13,7 @@ fsync \- synchronize a file's in-core state with that on disk .B fsync copies all in-core parts of a file to disk. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .BUGS diff --git a/man2/getdomainname.2 b/man2/getdomainname.2 index a5d83378d4..23031f2a7b 100644 --- a/man2/getdomainname.2 +++ b/man2/getdomainname.2 @@ -15,7 +15,7 @@ getdomainname, setdomainname \- get/set domain name These functions are used to access or to change the domain name of the current processor. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/getdtablesize.2 b/man2/getdtablesize.2 index 41be195556..935f488f77 100644 --- a/man2/getdtablesize.2 +++ b/man2/getdtablesize.2 @@ -18,9 +18,9 @@ is implemented as a library function in DLL 4.4.1. This function returns .B OPEN_MAX (set to 256 in Linux 0.99.11) if .B OPEN_MAX -was defined when the library was compiled. Otherwise, \-1 is returned, and +was defined when the library was compiled. Otherwise, -1 is returned, and .I errno is set to .BR ENOSYS . -.SH "SEE ALSO" +.SH SEE ALSO .BR close "(2), " dup "(2), " open (2) diff --git a/man2/getgroups.2 b/man2/getgroups.2 index 7c1ef85bbe..e242669ae7 100644 --- a/man2/getgroups.2 +++ b/man2/getgroups.2 @@ -39,12 +39,12 @@ On success, the number of groups stored in is returned (if .I size is zero, however, the number of supplemental group IDs associated with the -process is returned). On error, \-1 is returned, and +process is returned). On error, -1 is returned, and .I errno is set appropriately. .TP .B setgroups -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/gethostid.2 b/man2/gethostid.2 index b12a62f9e3..2656e5af21 100644 --- a/man2/gethostid.2 +++ b/man2/gethostid.2 @@ -2,42 +2,29 @@ .\" .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" May be distributed under the GNU General Public License -.\" Updated with additions from Mitchum DSouza (m.dsouza@mrc-apu.cam.ac.uk) -.\" Portions Copyright 1993 Mitchum DSouza (m.dsouza@mrc-apu.cam.ac.uk) -.\" May be distributed under the GNU General Public License -.TH GETHOSTID 2 "29 November 1993" "Linux 0.99.13" "Linux Programmer's Manual" +.TH GETHOSTID 2 "23 July1993" "Linux 0.99.11" "Linux Programmer's Manual" .SH NAME -gethostid, sethostid \- get or set the unique identifier of the current host +gethostid, sethostid \- get/set host's Internet number [NOT IMPLEMENTED] .SH SYNOPSIS .B #include .sp .B long int gethostid(void); .br -.BR "int sethostid(long int " hostid ) +.BR "int sethostid(long int " id ) .SH DESCRIPTION -Get or set a unique 32-bit identifier for the current machine. The 32-bit -identifier is intended to be unique among all UNIX systems in -existence. This normally resembles the Internet address for the local -machine, as returned by -.BR gethostbyname (3), -and thus usually never needs to be set. +.BR WARNING : +These function are not implemented in the Linux 0.99.11 kernel. -The -.B sethostid -call is restricted to the superuser. +Get or set a unique 32-bit identifier for the current machine. -The -.I hostid -argument is stored in the file -.IR /etc/hostid . -.SH RETURN VALUES -.B gethostid -returns the 32-bit identifier for the current host as set by -.BR sethostid (2). +Although prototypes are present in +.IR /usr/include/unistd.h , +neither the 0.99.11 kernel, nor the DLL 4.4.1 libraries defines this +function. .SH "CONFORMING TO" POSIX.1 does not define these functions, but ISO/IEC 9945-1:1990 mentions -them in B.4.4.1. -.SH FILES -.I /etc/hostid -.SH "SEE ALSO" +them in B.4.4.1. In general, they deal with a 32-bit integer that is +supposed to be unique among all machines in existence, and is often the +Internet address of the machine. +.SH SEE ALSO .BR hostid "(1), " gethostbyname (3) diff --git a/man2/gethostname.2 b/man2/gethostname.2 index b4ee38795d..ab04c56c0d 100644 --- a/man2/gethostname.2 +++ b/man2/gethostname.2 @@ -15,7 +15,7 @@ gethostname, sethostname \- get/set host name These functions are used to access or to change the host name of the current processor. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/getitimer.2 b/man2/getitimer.2 index 9808972559..6891cb0dfe 100644 --- a/man2/getitimer.2 +++ b/man2/getitimer.2 @@ -110,8 +110,8 @@ while the process is active (always true for the signal will be delivered immediately when generated. Otherwise the delivery will be offset by a small time dependant on the system loading. .LP -.SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +.SH RETURN VALUE +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -129,7 +129,7 @@ is not one of .BR ITIMER_VIRT , or .BR ITIMER_PROF . -.SH "SEE ALSO" +.SH SEE ALSO .BR gettimeofday (2), .BR sigaction (2), .BR signal (2). diff --git a/man2/getpagesize.2 b/man2/getpagesize.2 index 0f0344e6f3..c39f80c344 100644 --- a/man2/getpagesize.2 +++ b/man2/getpagesize.2 @@ -24,5 +24,5 @@ defined when the library is compiled, this function returns (set to 4096 in Linux 0.99.11), or .B NBPC (not defined in Linux 0.99.11 or DLL 4.4.1 libraries). -.SH "SEE ALSO" +.SH SEE ALSO .BR sbrk (2) diff --git a/man2/getpeername.2 b/man2/getpeername.2 index 20094892ff..cf70e4af9b 100644 --- a/man2/getpeername.2 +++ b/man2/getpeername.2 @@ -50,7 +50,7 @@ by On return it contains the actual size of the name returned (in bytes). The name is truncated if the buffer provided is too small. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -81,5 +81,5 @@ process address space. The .B getpeername function call appeared in BSD 4.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR accept "(2), " bind "(2), " getsockname (2) diff --git a/man2/getpriority.2 b/man2/getpriority.2 index d3d2dbf268..181b5c7cde 100644 --- a/man2/getpriority.2 +++ b/man2/getpriority.2 @@ -75,7 +75,7 @@ A zero value of .I who denotes the current process, process group, or user. .I Prio -is a value in the range \-20 to 20. The default priority is 0; +is a value in the range -20 to 20. The default priority is 0; lower priorities cause more favorable scheduling. The @@ -85,19 +85,19 @@ enjoyed by any of the specified processes. The .B setpriority call sets the priorities of all of the specified processes to the specified value. Only the super-user may lower priorities. -.SH "RETURN VALUES" +.SH RETURN VALUES Since .B getpriority -can legitimately return the value \-1, it is necessary +can legitimately return the value -1, it is necessary to clear the external variable .Va errno prior to the call, then check it afterward to determine -if a \-1 is an error or a legitimate value. +if a -1 is an error or a legitimate value. The .B setpriority call returns 0 if there is no error, or -\-1 if there is. +-1 if there is. .SH ERRORS .TP 0.8i .B ESRCH diff --git a/man2/getrlimit.2 b/man2/getrlimit.2 index 56de4f4395..792e19d60d 100644 --- a/man2/getrlimit.2 +++ b/man2/getrlimit.2 @@ -95,7 +95,7 @@ struct rusage .fi .in -0.5i .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/getsockname.2 b/man2/getsockname.2 index 2b18194dfa..ba3e6bf73d 100644 --- a/man2/getsockname.2 +++ b/man2/getsockname.2 @@ -50,10 +50,10 @@ the amount of space pointed to by On return it contains the actual size of the name returned (in bytes). .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. -A 0 is returned if the call succeeds, \-1 if it fails. +A 0 is returned if the call succeeds, -1 if it fails. .SH ERRORS .TP 0.8i .B EBADF diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index 955448d7c5..d5be348087 100644 --- a/man2/getsockopt.2 +++ b/man2/getsockopt.2 @@ -308,7 +308,7 @@ returns any pending error on the socket and clears the error status. It may be used to check for asynchronous errors on connected datagram sockets or for other asynchronous errors. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .Sh ERRORS diff --git a/man2/intro.2 b/man2/intro.2 index 7a7f8cdeaf..a33d60f23f 100644 --- a/man2/intro.2 +++ b/man2/intro.2 @@ -32,7 +32,7 @@ They have the form: _syscall\fIX\fP(\fItype\fP,\fIname\fP,\fIatype\fP,\fIa\fP) .RS .HP 1.0i -where \fIX\fP is 0\(en5, which are the number of arguments taken by the +where \fIX\fP is 0-5, which are the number of arguments taken by the system call .HP \fItype\fP is the return type of the system call @@ -101,7 +101,7 @@ create one, especially for C++ users. .sp System calls are not required to return only positive or negative error codes. You need to read the source to be sure how it will return errors. -Usually, it is the negative of a standard error code. i.e., \-EPERM. +Usually, it is the negative of a standard error code. ie. -EPERM. .sp Some system calls require more than six arguments, these are handle differently. And at this moment I don't know how... *smile* diff --git a/man2/ioctl.2 b/man2/ioctl.2 index 10c66f08aa..2c7a5ec1e7 100644 --- a/man2/ioctl.2 +++ b/man2/ioctl.2 @@ -67,7 +67,7 @@ in bytes. Macros and defines used in specifying an ioctl are located in the file .IR sys/ioctl.h . .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -95,5 +95,5 @@ is not valid. An .B ioctl function call appeared in Version 7 AT&T UNIX. -.SH "SEE ALSO" +.SH SEE ALSO .BR execve "(2), " fcntl "(2), " mt "(4), " sd "(4), " tty (4) diff --git a/man2/ioperm.2 b/man2/ioperm.2 index 7857d4f45b..433bf78450 100644 --- a/man2/ioperm.2 +++ b/man2/ioperm.2 @@ -25,7 +25,7 @@ ports, the .B iopl function must be used. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH "CONFORMING TO" diff --git a/man2/iopl.2 b/man2/iopl.2 index 33fbb6a7df..cf63351511 100644 --- a/man2/iopl.2 +++ b/man2/iopl.2 @@ -26,7 +26,7 @@ will probably crash the system, and is not recommended. The I/O privilege level for a normal process is 0. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -42,5 +42,5 @@ The current user is not the super-user. has to be used when you want to access the I/O ports beyond the 0x3ff range: to get the full 65536 ports bitmapped you'd need 8kB of bitmaps/process, which is a bit excessive. -.SH "SEE ALSO" +.SH SEE ALSO .BR ioperm (2) diff --git a/man2/kill.2 b/man2/kill.2 index ff357227eb..6e9b4a6c13 100644 --- a/man2/kill.2 +++ b/man2/kill.2 @@ -31,7 +31,7 @@ If \fIpid\fP is less than \-1, then \fIsig\fP is sent to every process in the process group \fI\-pid\fP. In this case, the number of processes the signal was sent to is returned, or a negative value for failure. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/killpg.2 b/man2/killpg.2 index 6abbb628e1..e3e666ebcc 100644 --- a/man2/killpg.2 +++ b/man2/killpg.2 @@ -61,7 +61,7 @@ special case the continue signal .B SIGCONT may be sent to any process that is a descendant of the current process. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .Sh ERRORS @@ -86,5 +86,5 @@ sending process. The .B killpg function call appeared in BSD4.0. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill "(2), " getpgrp "(2), " signal (2) diff --git a/man2/link.2 b/man2/link.2 index e0ffb06755..8478e53295 100644 --- a/man2/link.2 +++ b/man2/link.2 @@ -29,7 +29,7 @@ both names refer to the same file (and so have the same permissions and ownership) and it is impossible to tell which name was the `original'. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -102,12 +102,12 @@ Hard links, as created by cannot span filesystems. Use .B symlink if this is required. -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, BSD 4.3 .SH BUGS See .BR open (2) re multiple files with the same name, and NFS. -.SH "SEE ALSO" +.SH SEE ALSO .BR symlink "(2), " unlink "(2), " rename "(2), " open (2), .BR stat "(2), " ln "(1), " link (8). diff --git a/man2/listen.2 b/man2/listen.2 index 8ac2f904fe..010750f0bb 100644 --- a/man2/listen.2 +++ b/man2/listen.2 @@ -65,7 +65,7 @@ may receive an error with an indication of or, if the underlying protocol supports retransmission, the request may be ignored so that retries may succeed. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -92,5 +92,5 @@ The .I backlog is currently limited (silently) to 5. [Documenter's note: is this true for Linux?] -.SH "SEE ALSO" +.SH SEE ALSO .BR accept "(2), " connect "(2), " socket (2) diff --git a/man2/lseek.2 b/man2/lseek.2 index 466f444afd..bb08f2c63e 100644 --- a/man2/lseek.2 +++ b/man2/lseek.2 @@ -92,11 +92,11 @@ written into the gap). Some devices are incapable of seeking. The value of the pointer associated with such a device is undefined. -.SH "RETURN VALUES" +.SH RETURN VALUES Upon successful completion, .B lseek returns the resulting offset location as measured in bytes from the -begining of the file. Otherwise, a value of \-1 is returned and +begining of the file. Otherwise, a value of -1 is returned and .I errno is set to indicate the error. .SH ERRORS @@ -118,5 +118,5 @@ POSIX, BSD 4.3 This document's use of .I whence is incorrect English, but maintained for historical reasons. -.SH "SEE ALSO" +.SH SEE ALSO .BR dup "(2), " open "(2), " fseek (3) diff --git a/man2/mkdir.2 b/man2/mkdir.2 index 1f15be0c0c..04302f8735 100644 --- a/man2/mkdir.2 +++ b/man2/mkdir.2 @@ -53,7 +53,7 @@ The directory's owner ID is set to the process's effective user ID. The directory's group ID is set to that of the parent directory in which it is created. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/mknod.2 b/man2/mknod.2 index ce6c68dd36..93494ba539 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -66,7 +66,7 @@ is ignored. .B Mknod requires super-user privileges. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .Sh ERRORS @@ -131,5 +131,5 @@ points outside the process's allocated address space. A .B mknod function call appeared in Version 6 AT&T UNIX. -.SH "SEE ALSO" +.SH SEE ALSO .BR chmod "(2), " stat "(2), " umake (2) diff --git a/man2/mmap.2 b/man2/mmap.2 index 8a004bf9c8..8f511f6587 100644 --- a/man2/mmap.2 +++ b/man2/mmap.2 @@ -149,7 +149,7 @@ swapping should be done. .SH "RETURN VALUES" Upon successful completion, .B mmap -returns a pointer to the mapped region. Otherwise, a value of \-1 is +returns a pointer to the mapped region. Otherwise, a value of -1 is returned and .I errno is set to indicate the error. diff --git a/man2/mount.2 b/man2/mount.2 index 6622fde8c3..124e803c03 100644 --- a/man2/mount.2 +++ b/man2/mount.2 @@ -27,7 +27,7 @@ removes the attachement of the filesystem specified by Only the super-user may mount and unmount filesystems. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/msgctl.2 b/man2/msgctl.2 deleted file mode 100644 index d786b1cb49..0000000000 --- a/man2/msgctl.2 +++ /dev/null @@ -1,143 +0,0 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH MSGCTL 2 "November 1, 1993" "Linux 0.99.13" "Linux Programmer's Manual" -.SH NAME -msgctl \- message control operations -.SH SYNOPSIS -.nf -.B -# include -.B -# include -.B -# include -.fi -.sp -.BI "int msgctl ( int " msqid ", -.BI "int " cmd , -.BI "struct msqid_ds *" buf " )" -.SH DESCRIPTION -The function performs the control operation specified by -.I cmd -on the message queue with identifier -.IR msqid . -Legal values for -.I cmd -are: -.TP 12 -.B IPC_STAT -Copy info from the message queue data structure -into the structure pointed to by -.IR buf . -The user must have read access priviledges on the message queue. -.TP -.B IPC_SET -Write the values of some members of the -.B msqid_ds -structure pointed to by -.I buf -to the message queue data structure, updating also its -.B msg_ctime -member. -Considered members from the user supplied -.B "struct msqid_ds" -pointed to by -.I buf -are -.nf -.sp -.ft B - msg_perm.uid - msg_perm.gid - msg_perm.mode \fR/* only lowest 9-bits */\fP - msg_qbytes -.fi -.ft R -.sp -The calling process effective user\-ID must be one among super\-user, -creator or owner of the message queue. -Only the super\-user can raise the -.B msg_qbytes -value beyond the system parameter -.BR MSGMNB . -.TP -.B IPC_RMID -Remove immediatly the message queue and its data structures -awakening all waiting reader and writer processess (with an error -return and -.B errno -set to -.BR EIDRM ). -The calling process effective user\-ID must be one among super\-user, -creator or owner of the message queue. -.SH "RETURN VALUE" -If successful, the return value will be -.BR 0 , -otherwise -.B \-1 -with -.B errno -indicating the error. -.SH ERRORS -For a failing return, -.B errno -will be set to one among the following values: -.TP 11 -.B EACCESS -The argument -.I cmd -is equal to -.B IPC_STAT -but the calling process has no read access permissions on the message queue -.IR msqid . -.TP -.B EFAULT -The argument -.I cmd -has value -.B IPC_SET -or -.B IPC_STAT -but the address pointed to by -.I buf -isn't accessible. -.TP -.B EIDRM -The message queue was removed. -.TP -.B EINVAL -Invalid value for -.I cmd -or -.IR msqid . -.TP -.B EPERM -The argument -.I cmd -has value -.B IPC_SET -or -.B IPC_RMID -but the calling process effective user\-ID has insufficient -priviledges to execute the command. -Note this is also the case of a non super\-user process -trying to increase the -.B msg_qbytes -value beyond the value specified by the system parameter -.BR MSGMNB . -.SH NOTES -The -.BR IPC_INFO , -.BR MSG_STAT -and -.B MSG_INFO -control calls are used by the -.BR ipcs (1) -program to provide information on allocated resources. -In the future these can be modified as needed or moved to a proc file system -interface. -.SH "SEE ALSO" -.BR ipc (5), -.BR msgget (2), -.BR msgsnd (2), -.BR msgrcv (2). diff --git a/man2/msgget.2 b/man2/msgget.2 deleted file mode 100644 index b89037cfe9..0000000000 --- a/man2/msgget.2 +++ /dev/null @@ -1,199 +0,0 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH MSGGET 2 "November 1, 1993" "Linux 0.99.13" "Linux Programmer's Manual" -.SH NAME -msgget \- get a message queue identifier -.SH SYNOPSIS -.nf -.B -# include -.B -# include -.B -# include -.fi -.sp -.BI "int msgget ( key_t " key , -.BI "int "msgflg " )" -.SH DESCRIPTION -The function returns the messsage queue identifier associated -to the value of the -.I key -argument. -A new message queue is created if -.I key -has value -.B IPC_PRIVATE -or -.I key -isn't -.BR IPC_PRIVATE , -no existing message queue is associated to -.IR key , -and -.B IPC_CREAT -is asserted in -.I msgflg -(i.e. -.IB msgflg &IPC_CREAT -isn't zero). -The presence in -.I msgflg -of the fields -.B IPC_CREAT -and -.B IPC_EXCL -plays the same role, with respect to the existence -of the message queue, as the presence -of -.B O_CREAT -and -.B O_EXCL -in the mode argument of the -.BR open (2) -system call: i.e. the -.B msgget -function fails if -.I msgflg -asserts both -.B IPC_CREAT -and -.B IPC_EXCL -and a message queue already exists for -.IR key . -.PP -Upon creation, the lower 9 bits of the argument -.I msgflg -define the access permissions (for owner, group and others) -to the message queue in the same format, and with the same -meaning, as for the access permissions parameter in the -.BR open (2) -or -.BR creat (2) -system calls (though the execute permissions are not used by the system). -.PP -Furthermore, while creating, -the system call initializes the system message queue data structure -.B msqid_ds -as follows: -.IP -.B msg_perm.cuid -and -.B msg_perm.uid -are set to the effective user\-ID of the calling process. -.IP -.B msg_perm.cgid -and -.B msg_perm.gid -are set to the effective group\-ID of the calling process. -.IP -The lowest order 9 bits of -.B msg_perm.mode -are set to the lowest order 9 bit of -.IR msgflg . -.IP -.BR msg_qnum , -.BR msg_lspid , -.BR msg_lrpid , -.BR msg_stime -and -.B msg_rtime -are set to 0. -.IP -.B msg_ctime -is set to the current time. -.IP -.B msg_qbytes -is set to the system limit -.BR MSGMNB . -.PP -If the message queue already exists, the access permissions are -verified, and a check is made to see if it is marked for -destruction. -.SH "RETURN VALUE" -If successful, the return value will be the message queue identifier (a -positive integer), otherwise -.B \-1 -with -.B errno -indicating the error. -.SH ERRORS -For a failing return, -.B errno -will be set to one among the following values: -.TP 11 -.B EACCES -A message queue exists for -.IR key , -but the calling process has no access permissions to the queue. -.TP -.B EEXIST -A message queue exists for -.B key -and -.I msgflg -was asserting both -.B IPC_CREAT -and -.BR IPC_EXCL . -.TP -.B EIDRM -The message queue is marked as to be removed. -.TP -.B ENOENT -No message queue exists for -.I key -and -.I msgflg -wasn't asserting -.BR IPC_CREAT . -.TP -.B ENOMEM -A message queue has to be created but the system has not enough memory for -the new data structure. -.TP -.B ENOSPC -A message queue has to be created but the system limit for the maximum -number of message queues -.RB ( MSGMNI ) -would be exceeded. -.SH NOTES -.B IPC_PRIVATE -isn't a flag field but a -.B key_t -type. -If this special value is used for -.IR key , -the system call ignores everything but the lowest order 9 bits of -.I msgflg -and creates a new message queue (on success). -.PP -The following is a system limit on message queue resources affecting a -.B msgget -call: -.TP 11 -.B MSGMNI -System wide maximum number of message queues: policy -dependent. -.SH BUGS -Use of -.B IPC_PRIVATE -don't inhibits to other processes the access to the allocated -message queue. -.PP -As for the files, there is currently no intrinsic way for a process to ensure -exclusive access to a message queue. -Asserting both -.B IPC_CREAT -and -.B IPC_EXCL -in -.I msgflg -only ensures (on success) that a new message queue will be created, -it doesn't imply exclusive access to the message queue. -.SH "SEE ALSO" -.BR ftok (3), -.BR ipc (5), -.BR msgctl (2), -.BR msgsnd (2), -.BR msgrcv (2). diff --git a/man2/msgop.2 b/man2/msgop.2 deleted file mode 100644 index a9263f36bd..0000000000 --- a/man2/msgop.2 +++ /dev/null @@ -1,359 +0,0 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH MSGOP 2 "November 1, 1993" "Linux 0.99.13" "Linux Programmer's Manual" -.SH NAME -msgop \- message operations -.SH SYNOPSIS -.nf -.B -# include -.br -.B -# include -.br -.B -# include -.fi -.sp -.BI "int msgsnd ( int " msqid , -.BI "struct msgbuf *" msgp" , -.BI "int " msgsz , -.BI "int " msgflg " )" -.sp -.BI "int msgrcv ( int " msqid , -.BI "struct msgbuf *" msgp , -.BI "int " msgsz , -.BI "long " msgtyp , -.BI "int " msgflg " )" -.SH DESCRIPTION -To send or receive a message the calling process allocates a structure -that looks like the following -.sp -.B - struct msgbuf { -.br -.B - long mtype; -/* message type, must be > 0 */ -.br -.B - char mtext[1]; -/* message data */ -.br -.B - }; -.sp -but with an array -.B mtext -of size -.IR msgsz , -a non-negative integer value. -The structure member -.B mtype -must have a strictly positive integer value that can be -used by the receiving process for message selection -(see the section about -.BR msgrcv ). -.PP -The calling process must have write access permissions to send -and read access permissions to receive a message on the queue. -.PP -The -.B msgsnd -system call enqueue a copy of the message pointed to by the -.I msgp -argument -on the message queue whose identifier is specified by the value -of the -.I msqid -argument. -.PP -The argument -.I msgflg -specifies the system call behaviour if enqueueing the new message -will require more than -.B msg_qbytes -in the queue. -Asserting -.B IPC_NOWAIT -the message will not be sent and the system call fails returning with -.B errno -set to -.BR EAGAIN . -Otherwise the process is suspended until the condition for the -suspension no longer exists (in which case the message is sent and the -system call succeeds), -or the queue is removed (in which case the system call fails -with -.B errno -seto to -.BR EIDRM ), -or the process receives a signal that has to be -caught (in which case the system call fails -with -.B errno -set to -.BR EINTR ). -.PP -Upon successful completion the message queue data structure is updated -as follows: -.IP -.B msg_lspid -is set to the process-\ID of the calling process. -.IP -.B msg_qnum -is incremente by 1. -.IP -.B msg_stime -is set to the current time. -.PP -The system call -.B msgrcv -reads a message from the message queue specified by -.I msqid -into the -.B msgbuf -pointed to by the -.I msgp -argument removing from the queue, on success, the read message. -.PP -The argument -.I msgsz -specifies the maximum size in bytes for the member -.B mtext -of the structure pointed to by the -.I msgp -argument. -If the message text has length greater than -.IR msgsz , -then if the -.I msgflg -argument asserts -.BR MSG_NOERROR , -the message text will be truncated (and the truncated part will be -lost), otherwise the message isn't removed from the queue and -the system call fails returning with -.B errno -set to -.BR E2BIG . -.PP -The argument -.I msgtyp -specifies the type of message requested as follows: -.IP -If -.I msgtyp -is -.BR 0 , -then the message on the queue's front is read. -.IP -If -.I msgtyp -is greater than -.BR 0 , -then the first message on the queue of type -.I msgtyp -is read if -.B MSG_EXCEPT -isn't asserted by the -.I msgflg -argument, otherwise -the first message on the queue of type not equal to -.I msgtyp -will be read. -.IP -If -.I msgtyp -is less than -.BR 0 , -then the first message on the queue with the lowest type less than or -equal to the absolute value of -.I msgtyp -will be read. -.PP -The -.I msgflg -argument asserts none, one or more (or\-ing them) among the following -flags: -.IP -.B IPC_NOWAIT -For immediate return if no message of the requested type is on the queue. -The system call fails with errno set to -.BR ENOMSG . -.IP -.B MSG_EXCEPT -Used with -.I msgtyp -greater than -.B 0 -to read the first message on the queue with message type that differs -from -.IR msgtyp . -.IP -.B MSG_NOERROR -To truncate the message text if longer than -.I msgsz -bytes. -.PP -If no message of the requested type is available and -.B IPC_NOWAIT -isn't asserted in -.IR msgflg , -the calling process is blocked until one of the following conditions occurs: -.IP -A message of the desired type is placed on the queue. -.IP -The message queue is removed from the system. -In such a case the system call fails with -.B errno -set to -.BR EIDRM . -.IP -The calling process receives a signal that has to be caught. -In such a case the system call fails with -.B errno -set to -.BR EINTR . -.PP -Upon successful completion the message queue data structure is updated -as follows: -.IP -.B msg_lrpid -is set to the process-\ID of the calling process. -.IP -.B msg_qnum -is decremente by 1. -.IP -.B msg_rtime -is set to the current time. -.SH "RETURN VALUE" -On a failure both functions return -.B \-1 -with -.B errno -indicating the error, -otherwise -.B msgsnd -returns -.B 0 -and -.B msgrvc -returns the number of bytes actually copied into the -.B mtext -array. -.SH ERRORS -When -.B msgsnd -fails, at return -.B errno -will be set to one among the following values: -.TP 11 -.B EAGAIN -The message can't be sent due to the -.B msg_qbytes -limit for the queue and -.B IPC_NOWAIT -was asserted in -.IR mgsflg . -.TP -.B EACCES -The calling process has no write access permissions on the message queue. -.TP -.B EFAULT -The address pointed to by -.I msgp -isn't accessible. -.TP -.B EIDRM -The message queue was removed. -.TP -.B EINTR -Sleeping on a full message queue condition, the process received a signal -that had to be caught. -.TP -.B EINVAL -Invalid -.I msqid -value, or nonpositive -.I mtype -value, or -invalid -.I msgsz -value (less than 0 or greater than the system value -.BR MSGMAX ). -.TP -.B ENOMEM -The system has not enough memory to make a copy of the supplied -.BR msgbuf . -.PP -When -.B msgrcv -fails, at return -.B errno -will be set to one among the following values: -.TP 11 -.B E2BIG -The message text length is greater than -.I msgsz -and -.B MSG_NOERROR -isn't asserted in -.IR msgflg . -.TP -.B EACCES -The calling process has no read access permissions on the message queue. -.TP -.B EFAULT -The address pointed to by -.I msgp -isn't accessible. -.TP -.B EIDRM -While the process was sleeping to receive a message, -the message queue was removed. -.TP -.B EINTR -While the process was sleeping to receive a message, -the process received a signal that had to be caught. -.TP -.B EINVAL -Illegal -.I msgqid -value, or -.I msgsz -less than -.BR 0 . -.TP -.B ENOMSG -.B IPC_NOWAIT -was asserted in -.I msgflg -and no message of the requested type existed on the message queue. -.SH NOTES -The followings are system limits affecting a -.B msgsnd -system call: -.TP 11 -.B MSGMAX -Maximum size for a message text: the implementation set this value to -4080 bytes. -.TP -.B MSGMNB -Default maximum syze in bytes of a message queue: policy dependent. -The super\-user can increase the size of a message queue beyond -.B MSGMNB -by a -.B msgctl -system call. -.PP -The implementation has no intrinsic limits for the system wide maximum -number of message headers -.RB ( MSGTQL ) -and for the system wide maximum size in bytes of the message pool -.RB ( MSGPOOL ). -.SH "SEE ALSO" -.BR ipc (5), -.BR msgctl (2), -.BR msgget (2), -.BR msgrcv (2), -.BR msgsnd (2). diff --git a/man2/msgrcv.2 b/man2/msgrcv.2 deleted file mode 100644 index b34869edf8..0000000000 --- a/man2/msgrcv.2 +++ /dev/null @@ -1 +0,0 @@ -.so man2/msgop.2 diff --git a/man2/msgsnd.2 b/man2/msgsnd.2 deleted file mode 100644 index b34869edf8..0000000000 --- a/man2/msgsnd.2 +++ /dev/null @@ -1 +0,0 @@ -.so man2/msgop.2 diff --git a/man2/nice.2 b/man2/nice.2 index 6e381ded77..79a89c54e0 100644 --- a/man2/nice.2 +++ b/man2/nice.2 @@ -23,7 +23,7 @@ priority scheme as used by the .B nice interface. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/open.2 b/man2/open.2 index d4a2dd662a..0bb137b819 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -104,9 +104,9 @@ with .I flags equal to .BR O_CREAT|O_WRONLY|O_TRUNC . -.SH "RETURN VALUE" +.SH RETURN VALUE .BR open " and " creat -return the new file descriptor, or \-1 if an error occurred (in which case, +return the new file descriptor, or -1 if an error occurred (in which case, .I errno is set appropriately). .SH ERRORS @@ -173,7 +173,7 @@ whose expansion contains a reference to itself. was to be created but the device containing .I pathname has no room for the new file. -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, X/OPEN, BSD 4.3 .SH BUGS Currently (as of Linux 0.99pl7) all the normal filesystems sometime @@ -189,7 +189,7 @@ is not currently implemented (as of Linux 0.99pl7). There are many infelicities in the protocol underlying NFS, affecting amongst others .BR O_SYNC ", " O_EXCL ", " O_NDELAY " and " O_APPEND . -.SH "SEE ALSO" +.SH SEE ALSO .BR read "(2), " write "(2), " fcntl "(2), " close (2), .BR unlink "(2), " mknod "(2), " stat "(2), " umask (2), .BR mount "(2), " socket "(2), " socket "(2), " fopen (3). diff --git a/man2/pause.2 b/man2/pause.2 index 662b44bf9a..11454b4627 100644 --- a/man2/pause.2 +++ b/man2/pause.2 @@ -17,7 +17,7 @@ pause \- wait for signal causes the process to sleep until a signal is recieved. .SH "RETURN VALUE" .B pause -always returns \-1, and +always returns -1, and .I errno is set to .BR ERESTARTNOHAND . diff --git a/man2/phys.2 b/man2/phys.2 index d9eef978cd..0c33d3f6b3 100644 --- a/man2/phys.2 +++ b/man2/phys.2 @@ -21,7 +21,7 @@ phys \- allow a process to access physical addresses [NOT IMPLEMENTED] .SH DESCRIPTION .BR WARNING : Since this function is not implemented as of Linux 0.99.11, it will always -return \-1 and set +return -1 and set .I errno to .BR ENOSYS . @@ -40,7 +40,7 @@ is rounded up to the next MMU resolution boundary. If \fIsize\fP is zero, any previous \fBphys\fP(2) mapping for that \fIphsynum\fP is nullified. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH "CONFORMING TO" diff --git a/man2/pipe.2 b/man2/pipe.2 index 8e215a27c3..9587b85d72 100644 --- a/man2/pipe.2 +++ b/man2/pipe.2 @@ -22,7 +22,7 @@ is for reading, .I filedes[1] is for writing. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/profil.2 b/man2/profil.2 index d34b972edb..259fe53233 100644 --- a/man2/profil.2 +++ b/man2/profil.2 @@ -47,5 +47,5 @@ with an invalid will result in a core dump. True kernel profiling provides more accurate results. -.SH "SEE ALSO" +.SH SEE ALSO .BR gprof "(1), " setitimer "(2), " signal "(2), " sigaction (2) diff --git a/man2/ptrace.2 b/man2/ptrace.2 index 3cf79ded0b..4007f39fa5 100644 --- a/man2/ptrace.2 +++ b/man2/ptrace.2 @@ -75,7 +75,7 @@ Detach a process that was previously attached. .BR init , the process with process ID 1, may not use this function. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/read.2 b/man2/read.2 index 1c0805e6ae..c84401a6d9 100644 --- a/man2/read.2 +++ b/man2/read.2 @@ -25,9 +25,9 @@ bytes from file descriptor .I fd into the buffer starting at .I buf. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the number of bytes read are returned (zero indicated end of -file). On error, \-1 is returned, and +file). On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -60,7 +60,7 @@ Other errors may occur, depending on the object connected to .IR fd . .SH "CONFORMING TO" SVID, AT&T, POSIX, X/OPEN, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR readdir "(2), " write "(2), " write "(2), " fcntl "(2), " close "(2), " .BR lseek "(2), " .BR select "(2), " readlink "(2), " ioctl "(2), " fread (3). diff --git a/man2/readlink.2 b/man2/readlink.2 index 83f61b8a4e..034408dce8 100644 --- a/man2/readlink.2 +++ b/man2/readlink.2 @@ -53,9 +53,9 @@ does not append a .B NUL character to .IR buf . -.SH "RETURN VALUES" +.SH RETURN VALUES The call returns the count of characters placed in the buffer -if it succeeds, or a \-1 if an error occurs, placing the error +if it succeeds, or a -1 if an error occurs, placing the error code in the global variable .IR errno . .SH ERRORS @@ -92,5 +92,5 @@ extends outside the process's allocated address space. The .B readlink function call appeared in BSD 4.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR stat "(2), " lstat "(2), " symlink (2) diff --git a/man2/reboot.2 b/man2/reboot.2 index 2231ed36ca..10aab32a1e 100644 --- a/man2/reboot.2 +++ b/man2/reboot.2 @@ -40,7 +40,7 @@ does Only the super-user may use this function. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/recv.2 b/man2/recv.2 index e1d5f61189..ef8bfd4cb7 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -91,7 +91,7 @@ received from (see If no messages are available at the socket, the receive call waits for a message to arrive, unless the socket is nonblocking (see .BR fcntl (2)) -in which case the value \-1 is returned and the external variable +in which case the value -1 is returned and the external variable .I errno set to .BR EWOULDBLOCK . @@ -226,7 +226,7 @@ buffer for ancillary data. is returned to indicate that expedited or out-of-band data were received. .SH "RETURN VALUES" -These calls return the number of bytes received, or \-1 +These calls return the number of bytes received, or -1 if an error occurred. .SH ERRORS .TP 0.8i diff --git a/man2/rename.2 b/man2/rename.2 index 5d83439c4c..86381992b0 100644 --- a/man2/rename.2 +++ b/man2/rename.2 @@ -36,7 +36,7 @@ If .I oldpath refers to a symbolic link the link is renamed. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -122,7 +122,7 @@ whose expansion contains a reference to itself. .B ENOSPC The device containing the file has no room for the new directory entry. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX, BSD 4.3, ANSI C .SH BUGS Currently (Linux 0.99pl7) most of the filesystems except Minix will @@ -137,5 +137,5 @@ See re multiple files with the same name, and NFS; see .BR unlink (2) re NFS. -.SH "SEE ALSO" +.SH SEE ALSO .BR link "(2), " unlink "(2), " symlink "(2), " mv "(1), " link (8). diff --git a/man2/rmdir.2 b/man2/rmdir.2 index 155ddea141..5c8e899360 100644 --- a/man2/rmdir.2 +++ b/man2/rmdir.2 @@ -18,7 +18,7 @@ rmdir \- delete a directory .B rmdir deletes a directory, which must be empty. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -81,11 +81,11 @@ refers to a file on a read-only filesystem. .I pathname contains a reference to a circular symbolic link, ie a symbolic link containing a reference to itself. -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, BSD 4.3 .SH BUGS Infelicities in the protocol underlying NFS can cause the unexpected disappearance of directories which are still being used. -.SH "SEE ALSO" +.SH SEE ALSO .BR rename "(2), " mkdir "(2), " chdir "(2), " unlink (2), .BR rmdir "(1), " rm (1) diff --git a/man2/select.2 b/man2/select.2 index 3479bc66ca..e341905778 100644 --- a/man2/select.2 +++ b/man2/select.2 @@ -68,11 +68,11 @@ returns nonzero .I fd is in .I set. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .B select returns the number of descriptors contained in the descriptor sets. On -error, \-1 is returned, and +error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/semctl.2 b/man2/semctl.2 deleted file mode 100644 index 15e7636587..0000000000 --- a/man2/semctl.2 +++ /dev/null @@ -1,296 +0,0 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH SEMCTL 2 "November 1, 1993" "Linux 0.99.13" "Linux Programmer's Manual" -.SH NAME -semctl \- semaphore control operations -.SH SYNOPSIS -.nf -.B -# include -.B -# include -.B -# include -.fi -.sp -.BI "int semctl ( int " semid , -.BI "int " semnun , -.BI "int " cmd , -.BI "union semun " arg " )" -.SH DESCRIPTION -The function performs the control operation specified by -.I cmd -on the semaphore set (or on the -.IR sumun -nth -semaphore of the set) identified by -.IR semid . -The first semaphore of the set is indicated by a value -.B 0 -for -.IR semun . -.PP -The type of -.I arg -is the union -.sp -.B -union semun { -.br -.B - int val; -/* used for SETVAL only */ -.br -.B - struct semid_ds *buf; -/* for IPC_STAT and IPC_SET */ -.br -.B - ushort *array; -/* used for GETALL and SETALL */ -.br -.B -}; -.sp -Legal values for -.I cmd -are -.TP 12 -.B IPC_STAT -Copy info from the semaphore set data structure -into the structure pointed to by -.IB arg .buf . -The argument -.I semnum -is ignored. -The calling process must have read access priviledges on the semaphore set. -.TP -.B IPC_SET -Write the values of some members of the -.B semid_ds -structure pointed to by -.IB arg .buf -to the semaphore set data structure, updating also its -.B sem_ctime -member. -Considered members from the user supplied -.B "struc semid_ds" -pointed to by -.IB arg .buf -are -.nf -.sp -.ft B - sem_perm.uid - sem_perm.gid - sem_perm.mode \fR/* only lowest 9-bits */\fP -.fi -.ft R -.sp -The calling process effective user\-ID must be one among super\-user, -creator or owner of the semaphore set. -The argument -.I semnum -is ignored. -.TP -.B IPC_RMID -Remove immediatly the semaphore set and its data structures -awakening all waiting processess (with an error return and -.B errno -set to -.BR EIDRM ). -The calling process effective user\-ID must be one among super\-user, -creator or owner of the semaphore set. -The argument -.I semnum -is ignored. -.TP -.B GETALL -Return -.B semval -for all semaphores of the set into -.IB arg .array . -The argument -.I semnum -is ignored. -The calling process must have read access priviledges on the semaphore set. -.TP -.B GETNCNT -The system call returns the value of -.B semncnt -for the -.IR semno \-th -semaphore of the set -(i.e. the number of processes waiting for an increase of -.B semval -for the -.IR semno \-th -semaphore of the set). -The calling process must have read access priviledges on the semaphore set. -.TP -.B GETPID -The system call returns the value of -.B sempid -for the -.IR semno \-th -semaphore of the set -(i.e. the pid of the process that executed the last -.B semop -call for the -.IR semno \-th -semaphore of the set). -The calling process must have read access priviledges on the semaphore set. -.TP -.B GETVAL -The system call returns the value of -.B semval -for the -.IR semno \-th -semaphore of the set. -The calling process must have read access priviledges on the semaphore set. -.TP -.B GETZCNT -The system call returns the value of -.B semzcnt -for the -.IR semno \-th -semaphore of the set -(i.e. the number of processes waiting for -.B semval -of the -.IR semno \-th -semaphore of the set to become 0). -The calling process must have read access priviledges on the semaphore set. -.TP -.B SETALL -Set -.B semval -for all semaphores of the set using -.IB arg .array , -updating also the -.B sem_ctime -member of the -.B semid_ds -structure associated to the set. -Undo entries are cleared for altered semaphores in all processes. -Processes sleeping on the wait queue are awakened if some -.B semval -becomes 0 or increases. -The argument -.I semnum -is ignored. -The calling process must have alter access priviledges on the semaphore set. -.TP -.B SETVAL -Set the value of -.B semval -to -.IB arg .val -for the -.IR semnum \-th -semaphore of the set, updating also the -.B sem_ctime -member of the -.B semid_ds -structure associated to the set. -Undo entry is cleared for altered semaphore in all processes. -Processes sleeping on the wait queue are awakened if -.B semval -becomes 0 or increases. -The calling process must have alter access priviledges on the semaphore set. -.SH "RETURN VALUE" -On fail the system call returns -.B \-1 -with -.B errno -indicating the error. -Otherwise the system call returns a nonnegative value depending on -.I cmd -as follows: -.TP 11 -.B GETNCNT -the value of -.BR semncnt . -.TP -.B GETPID -the value of -.BR sempid . -.TP -.B GETVAL -the value of -.BR semval . -.TP -.B GETZCNT -the value of -.BR semzcnt . -.SH ERRORS -For a failing return, -.B errno -will be set to one among the following values: -.TP 11 -.B EACCESS -The calling process has no access permissions needed to execute -.IR cmd . -.TP -.B EFAULT -The address pointed to by -.IB arg .buf -or -.IB arg .array -isn't accessible. -.TP -.B EIDRM -The semaphore set was removed. -.TP -.B EINVAL -Invalid value for -.I cmd -or -.IR semid . -.TP -.B EPERM -The argument -.I cmd -has value -.B IPC_SET -or -.B IPC_RMID -but the calling process effective user\-ID has insufficient -priviledges to execute the command. -.TP -.B ERANGE -The argument -.I cmd -has value -.B SETALL -or -.B SETVAL -and the value to which -.B semval -has to be set (for some semaphore of the set) is less than 0 -or greater than the implementation value -.BR SEMVMX . -.SH NOTES -The -.BR IPC_INFO , -.BR SEM_STAT -and -.B SEM_INFO -control calls are used by the -.BR ipcs (1) -program to provide information on allocated resources. -In the future these can be modified as needed or moved to a proc file system -interface. -.PP -The following system limit on semaphore sets affects a -.B semctl -call: -.TP 11 -.B SEMVMX -Maximum value for -.BR semval : -implementation dependent (32767). -.SH "SEE ALSO" -.BR ipc (5), -.BR shmget (2), -.BR shmat (2), -.BR shmdt (2). diff --git a/man2/semget.2 b/man2/semget.2 deleted file mode 100644 index 5bd13caa61..0000000000 --- a/man2/semget.2 +++ /dev/null @@ -1,231 +0,0 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH SEMGET 2 "November 1, 1993" "Linux 0.99.13" "Linux Programmer's Manual" -.SH NAME -semget \- get a semaphore set identifier -.SH SYNOPSIS -.nf -.B -# include -.B -# include -.B -# include -.fi -.sp -.BI "int semget ( key_t " key , -.BI "int " nsems , -.BI "int " semflg " )" -.SH DESCRIPTION -The function returns the semaphore set identifier -associated to the value of the argument -.IR key . -A new set of -.I nsems -semaphores is created if -.I key -has value -.B IPC_PRIVATE -or -.I key -isn't -.BR IPC_PRIVATE , -no existing message queue is associated to -.IR key , -and -.B IPC_CREAT -is asserted in -.I semflg -(i.e. -.IB semflg &IPC_CREAT -isn't zero). -The presence in -.I semflg -of the fields -.B IPC_CREAT -and -.B IPC_EXCL -plays the same role, with respect to the existence -of the semaphore set, as the presence -of -.B O_CREAT -and -.B O_EXCL -in the mode argument of the -.BR open (2) -system call: i.e. the -.B msgget -function fails if -.I semflg -asserts both -.B IPC_CREAT -and -.B IPC_EXCL -and a semaphore set already exists for -.IR key . -.PP -Upon creation, the lower 9 bits of the argument -.I semflg -define the access permissions (for owner, group and others) -to the semaphore set in the same format, and with the same -meaning, as for the access permissions parameter in the -.BR open (2) -or -.BR creat (2) -system calls (though the execute permissions are not used by the system, -and write permissions, for a semaphore set, effectively means alter -permissions). -.PP -Furthermore, while creating, -the system call initializes the system semaphore set data structure -.B semid_ds -as follows: -.IP -.B sem_perm.cuid -and -.B sem_perm.uid -are set to the effective user\-ID of the calling process. -.IP -.B sem_perm.cgid -and -.B sem_perm.gid -are set to the effective group\-ID of the calling process. -.IP -The lowest order 9 bits of -.B sem_perm.mode -are set to the lowest order 9 bit of -.IR semflg . -.IP -.B sem_nsems -is set to the value of -.IR nsems . -.IP -.B sem_otime -is set to 0. -.IP -.B sem_ctime -is set to the current time. -.PP -The argument -.I nsems -can be -.B 0 -(a don't care) -when the system call isn't a create one. -Otherwise -.I nsems -must be greater than -.B 0 -and less or equal to the maximun number of semaphores per semid, -.RB ( SEMMSL ). -.PP -If the semaphore set already exists, the access permissions are -verified, and a check is made to see if it is marked for destruction. -.SH "RETURN VALUE" -If successful, the return value will be the semaphore set identifier -(a positive integer), otherwise -.B \-1 -with -.B errno -indicating the error. -.SH ERRORS -For a failing return, -.B errno -will be set to one among the following values: -.TP 11 -.B EACCES -A semaphore set exists for -.IR key , -but the calling process has no access permissions to the set. -.TP -.B EEXIST -A semaphore set exists for -.B key -and -.I semflg -was asserting both -.B IPC_CREAT -and -.BR IPC_EXCL . -.TP -.B EIDRM -The semaphore set is marked as to be deleted. -.TP -.B ENOENT -No semaphore set exists for -.I key -and -.I semflg -wasn't asserting -.BR IPC_CREAT . -.TP -.B ENOMEM -A semaphore set has to be created but the system has not enough memory for -the new data structure. -.TP -.B ENOSPC -A semaphore set has to be created but the system limit for the maximum -number of semaphore sets -.RB ( SEMMNI ), -or the system wide maximum number of semaphores -.RB ( SEMMNS ), -would be exceeded. -.SH NOTES -.B IPC_PRIVATE -isn't a flag field but a -.B key_t -type. -If this special value is used for -.IR key , -the system call ignores everything but the lowest order 9 bits of -.I semflg -and creates a new semaphore set (on success). -.PP -The followings are limits on semaphore set resources affecting a -.B semget -call: -.TP 11 -.B SEMMNI -System wide maximum number of semaphore sets: policy dependent. -.TP -.B SEMMSL -Maximum number of semaphores per semid: implementation dependent -(500 currently). -.TP -.B SEMMNS -System wide maximum number of semaphores: policy dependent. -Values greater than -.B SEMMSL * SEMMNI -makes it irrelevant. -.SH BUGS -Use of -.B IPC_PRIVATE -don't inhibits to other processes the access to the allocated -semaphore set. -.PP -As for the files, there is currently no intrinsic way for a process to ensure -exclusive access to a semaphore set. -Asserting both -.B IPC_CREAT -and -.B IPC_EXCL -in -.I semflg -only ensures (on success) that a new semaphore set will be created, -it doesn't imply exclusive access to the semaphore set. -.PP -The data structure associated with each semaphore in the set -isn't initialized by the system call. -In order to initialize those data structures, one has to execute a -subsequent call to -.BR semctl (2) -to perform a -.B SETVAL -or a -.B SETALL -command on the semaphore set. -.SH "SEE ALSO" -.BR ftok (3), -.BR ipc (5), -.BR semctl (2), -.BR semop (2). diff --git a/man2/semop.2 b/man2/semop.2 deleted file mode 100644 index 927a37624c..0000000000 --- a/man2/semop.2 +++ /dev/null @@ -1,315 +0,0 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH SEMOP 2 "November 1, 1993" "Linux 0.99.13" "Linux Programmer's Manual" -.SH NAME -semop \- semaphore operations -.SH SYNOPSIS -.nf -.B -# include -.B -# include -.B -# include -.fi -.sp -.BI "int semop ( int " semid , -.BI "struct sembuf *" sops , -.BI "unsigned " nsops " )" -.SH DESCRIPTION -The function performs operations on selected members of the semaphore set indicated by -.IR semid . -Each of the -.I nsops -elements in the array pointed to by -.I sops -specify an operation to be performed on a semaphore by a -.B "struct sembuf" -including the following members: -.sp -.B -.br -.B - short sem_num; -/* semaphore number: 0 = first */ -.br -.B - short sem_op; -/* semaphore operation */ -.br -.B - short sem_flg; -/* operation flags */ -.sp -Flags recognized in -.B sem_flg -are -.B IPC_NOWAIT -and -.BR SEM_UNDO . -If an operation asserts -.BR SEM_UNDO , -it will be undone when the process exits. -.PP -The system call semantic assures that the operations will be -performed if and only if all of them will succeed. -Each operation is performed on the -.BR sem_num \-th -semaphore of the semaphore set \- where the first semaphore of the set -is semaphore -.B 0 -\- and is one among the following three. -.PP -If -.B sem_op -is a positive integer, the operation adds this value to -.BR semval . -Furthermore, if -.B SEM_UNDO -is asserted for this operation, the system updates the process undo count -for this semaphore. -The operation always goes through, so no process sleeping can happen. -The calling process must have alter permissions on the semaphore set. -.PP -If -.B sem_op -is zero, the process must have read access permissions on the semaphore -set. -If -.B semval -is zero, the operation goes through. -Otherwise, if -.B IPC_NOWAIT -is asserted in -.BR sem_flg , -the system call fails (undoing all previous actions -performed) with -.B errno -set to -.BR EAGAIN . -Otherwise -.B semzcnt -is incremented by one and the process sleeps until -one of the following occours: -.IP -.RS -.IP \(bu -.B semval -becomes 0, at which time the value of -.B semzcnt -is decremented. -.IP \(bu -The semaphore set -is removed: the system call fails with -.B errno -set to -.BR EIDRM . -.IP \(bu -The calling process receives a signal that has to be caught: -the value of -.B semzcnt -is decremented and the system call fails with -.B errno -set to -.BR EINTR . -.RE -.PP -If -.B sem_op -is less than zero, the process must have alter permissions on the -semaphore set. -If -.B semval -is greater than the absolute value of -.BR sem_op , -the absolute value of -.B sem_op -is subtracted by -.BR semval . -Furthermore, if -.B SEM_UNDO -is asserted for this operation, the system updates the process undo count -for this semaphore. -Then the operation goes through. -Otherwise, if -.B IPC_NOWAIT -is asserted in -.BR sem_flg , -the system call fails (undoing all previous actions -performed) with -.B errno -set to -.BR EAGAIN . -Otherwise -.B semncnt -is incremented by one and the process sleeps until -one of the following occours: -.IP -.RS -.IP \(bu -.B semval -becomes greater or equal to the absolute value of -.BR sem_op , -at which time the value of -.B semncnt -is decremented, the absolute value of -.B sem_op -is subctracted from -.B semval -and, if -.B SEM_UNDO -is asserted for this operation, the system updates the process undo count -for this semaphore. -.IP \(bu -The semaphore set is removed from the system: the system call fails with -.B errno -set to -.BR EIDRM . -.IP \(bu -The calling process receives a signal that has to be caught: -the value of -.B semncnt -is decremented and the system call fails with -.B errno -set to -.BR EINTR . -.RE -.PP -In case of success, the -.B sempid -member of the structure -.B sem -for each semaphore specified in the array pointed to by -.I sops -is set to the process\-ID of the calling process. -Furthermore both -.B sem_otime -and -.B sem_ctime -are set to the current time. -.SH "RETURN VALUE" -If successful the system call returns -.BR 0 , -otherwise it returns -.B \-1 -with -.B errno -indicating the error. -.SH ERRORS -For a failing return, -.B errno -will be set to one among the following values: -.TP 11 -.B E2BIG -The argument -.I nsops -is greater than -.BR SEMOPM , -the maximum number of operations allowed per system -call. -.TP -.B EACCES -The calling process has no access permissions on the -semaphore set as required by one of the specified operations. -.TP -.B EAGAIN -An operation could not go through and -.BR IPC_NOWAIT -was asserted in its -.IB sem_flg . -.TP -.B EFAULT -The address pointed to by -.I sops -isn't accessible. -.TP -.B EFBIG -For some operation the value of -.B sem_num -is less than 0 or greater than or equal to the number -of semaphores in the set. -.TP -.B EIDRM -The semaphore set was removed. -.TP -.B EINTR -Sleeping on a wait queue, the process received a signal -that had to be caught. -.TP -.B EINVAL -The semaphore set doesn't exist, or -.I semid -is less than zero, or -.I nsops -has a non-positive value. -.TP -.B ENOMEM -The -.B sem_flg -of some operation asserted -.B SEM_UNDO -and the system has not enough memory to allocate the undo -structure. -.TP -.B ERANGE -For some operation -.B semop+semval -is greater than -.BR SEMVMX , -the implementaion dependent maximun value for -.BR semval . -.SH NOTES -The -.B sem_undo -structures of a process aren't inherited by its child -on execution of a -.BR fork (2) -system call. -They are instead inherited by the substituting process resulting -by the execution of the -.BR exec (2) -system call. -.PP -The followings are limits on semaphore set resources affecting a -.B semop -call: -.TP 11 -.B SEMOPM -Maximum number of operations allowed for one -.B semop -call: policy dependent. -.TP -.B SEMVMX -Maximum allowable value for -.BR semval : -implementation dependent (32767). -.PP -The implementation has no intrinsic limits for -the adjust on exit maximun value -.RB ( SEMAEM ), -the system wide maximum number of undo structures -.RB ( SEMMNU ) -and the per process maximum number of undo entries system parameters. -.SH BUGS -The system maintains a per process -.B sem_undo -structure for each semaphore altered by the process with undo requests. -Those structures are free at process exit. -One major cause for unhappiness with the undo mechanism is that it -does not fit in with the notion of having an atomic set of operations an -an array of semaphores. -The undo requests for an array and each semaphore therein may have been -accumulated over many -.B semopt -calls. -Should the process sleep when -exiting, or should all undo operations be applied with the -.B IPC_NOWAIT -flag in effect? -Currently those undo operations which go through immediatly are applied, -and those that require a wait are ignored silently. -Thus harmless undo usage is guaranteed with private semaphores only. -.SH "SEE ALSO" -.BR ipc (5), -.BR semctl (2), -.BR semget (2). diff --git a/man2/send.2 b/man2/send.2 index 83649175a9..323f9aeab1 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -81,7 +81,7 @@ is returned, and the message is not transmitted. No indication of failure to deliver is implicit in a .BR send . -Locally detected errors are indicated by a return value of \-1. +Locally detected errors are indicated by a return value of -1. If no messages space is available at the socket to hold the message to be transmitted, then @@ -119,8 +119,8 @@ See for a description of the .I msghdr structure. -.SH "RETURN VALUES" -The call returns the number of characters sent, or \-1 +.SH RETURN VALUES +The call returns the number of characters sent, or -1 if an error occurred. .SH ERRORS .TP 0.8i diff --git a/man2/setgid.2 b/man2/setgid.2 index ecf9e555a3..3be572109b 100644 --- a/man2/setgid.2 +++ b/man2/setgid.2 @@ -27,7 +27,7 @@ Under Linux 0.99.11, .B setgid is implemeneted like SysV w/ SAVED_IDS .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/setpgid.2 b/man2/setpgid.2 index 98b9085cc7..01913765e3 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -83,7 +83,7 @@ are used to get/set the process group of the control terminal. .SH "RETURN VALUE" On success, .BR setpgid " and " setpgrp -return zero. On error, \-1 is returned, and +return zero. On error, -1 is returned, and .I errno is set appropriately. diff --git a/man2/setregid.2 b/man2/setregid.2 index cc2c18ad11..cb2d624756 100644 --- a/man2/setregid.2 +++ b/man2/setregid.2 @@ -51,8 +51,8 @@ arguments. Unprivileged users may change the real group ID to the effective group ID and vice-versa; only the super-user may make other changes. -Supplying a value of \-1 for either the real or effective group ID forces -the system to substitute the current ID in place of the \-1 parameter. +Supplying a value of -1 for either the real or effective group ID forces +the system to substitute the current ID in place of the -1 parameter. .SH "NOTES FROM KERNEL SOURCE" .B setregid is done BSD-style, with no consideration of the saved gid, except @@ -67,7 +67,7 @@ will be 100% compatible with BSD. A program which uses just .B setgid will be 100% compatible with POSIX w/ Saved ID's. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -82,5 +82,5 @@ The function call appeared in BSD 4.2. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getgid "(2), " setgid (2) diff --git a/man2/setreuid.2 b/man2/setreuid.2 index 97b3f9bbbe..a51dcb7693 100644 --- a/man2/setreuid.2 +++ b/man2/setreuid.2 @@ -51,8 +51,8 @@ arguments. Unprivileged users may change the real user ID to the effective user ID and vice-versa; only the super-user may make other changes. -Supplying a value of \-1 for either the real or effective user ID forces -the system to substitute the current ID in place of the \-1 parameter. +Supplying a value of -1 for either the real or effective user ID forces +the system to substitute the current ID in place of the -1 parameter. .SH "NOTES FROM KERNEL SOURCE" In Linux 0.99.11, unprivileged users may change the real user ID to the effective uid or vice versa. (BSD-style) @@ -68,7 +68,7 @@ will be 100% compatible with BSD. A program which uses just .B setuid will be 100% compatible with POSIX w/ Saved ID's. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -83,5 +83,5 @@ The function call appeared in BSD 4.2. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getuid "(2), " setuid (2) diff --git a/man2/setuid.2 b/man2/setuid.2 index 1a9d167286..64876d8860 100644 --- a/man2/setuid.2 +++ b/man2/setuid.2 @@ -37,7 +37,7 @@ the POSIX commmittee and/or USG. Note that the BSD-style will allow a root program to temporarily drop privileges and be able to regain them by swapping the real and effective uid. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/shmctl.2 b/man2/shmctl.2 index 678982a6f3..4301f5df8c 100644 --- a/man2/shmctl.2 +++ b/man2/shmctl.2 @@ -1,11 +1,7 @@ .\" Copyright (c) 1993 Luigi P. Bai (lpb@softint.com) July 28, 1993 .\" May be distributed under the GNU General Public License. .\" Modified Wed Jul 28 11:03:24 1993, Rik Faith (faith@cs.unc.edu) -.\" Modified Sun Nov 28 16:43:30 1993, Rik Faith (faith@cs.unc.edu) -.\" with material from Giorgio Ciucci (giorgio@crcc.it) -.\" Portions Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH SHMCTL 2 "November 28, 1993" "Linux 0.99.11" "Linux Programmer's Manual" +.TH SHMCTL 2 "July 28, 1993" "Linux 0.99.11" "Linux Programmer's Manual" .SH NAME shmctl \- shared memory control .SH SYNOPSIS @@ -61,27 +57,21 @@ struct ipc_perm .PP The following \fIcmds\fP are available: .br -.TP 12 +.TP 0.8i .B IPC_STAT is used to copy the information about the shared memory segment into the buffer \fIbuf\fP. The user must have \fBread\fP access to the shared memory segment. .TP .B IPC_SET -is used to apply the changes the user has made to the \fIuid\fP, \fIgid\fP, -or \fImode\fP members of the \fIshm_perms\fP field. Only the lowest 9 bits -of \fImode\fP are used. The -.I shm_ctime -member is also updated. The user must be the owner, creator, or the -super-user. +is used to apply the changes the user has made to the +\fIuid\fP, \fIgid\fP, or \fImode\fP members of the \fIshm_perms\fP field. +The user must be the owner, creator, or the super-user. .TP .B IPC_RMID is used to mark the segment as destroyed. It will actually be destroyed -after the last detach. (I.e., when the -.I shm_nattch -member of the associated structure -.I shmid_ds -is zero.) The user must be the owner, creator, or the super-user. +after the last detach. +The user must be the owner, creator, or the super-user. .PP The user \fImust\fP ensure that a segment is eventually destroyed; otherwise its pages that were faulted in will remain in memory or swap. @@ -89,7 +79,7 @@ its pages that were faulted in will remain in memory or swap. In addition, the \fBsuper-user\fP can prevent or allow swapping of a shared memory segment with the following \fIcmds\fP: (Linux only) .br -.TP 12 +.TP 0.8i .B SHM_LOCK prevents swapping of a shared memory segment. The user must fault in any pages that are required to be present after locking is enabled. @@ -97,17 +87,7 @@ any pages that are required to be present after locking is enabled. .B SHM_UNLOCK allows the shared memory segment to be swapped out. .PP -The -.BR IPC_INFO , -.BR SHM_STAT -and -.B SHM_INFO -control calls are used by the -.BR ipcs (1) -program to provide information on allocated resources. In the future, -these man be modified as needed or moved to a proc file system interface. -.PP -.SH "SYSTEM CALLS" +.SH SYSTEM CALLS .TP .B fork() After a @@ -125,27 +105,15 @@ Upon all attached shared memory segments are detached (not destroyed). .PP .SH "RETURN VALUE" -0 is returned on success, \-1 on error. +0 is returned on success, -1 on error. .SH ERRORS -On error, -.B errno -will be set to one of the following: -.TP 12 +.TP 0.8i .B EACCESS is returned if \fBIPC_STAT\fP is requested and -\fIshm_perm.modes\fP does not allow read access for -.IR msqid . +\fIshm_perm.modes\fP does not allow read access. .TP .B EFAULT -The argument -.I cmd -has value -.B IPC_SET -or -.B IPC_STAT -but the address pointed to by -.I buf -isn't accessible. +is returned if \fIbuf\fP is not accessible. .TP .B EINVAL is returned if \fIshmid\fP is not a valid identifier, or \fIcmd\fP @@ -158,5 +126,5 @@ is returned if \fIshmid\fP points to a removed identifier. is returned if \fBIPC_SET\fP or \fBIPC_RMID\fP is attempted, and the user is not the creator, the owner, or the super-user, and the user does not have permission granted to their group or to the world. -.SH "SEE ALSO" +.SH SEE ALSO .BR shmget "(2), " shmop (2) diff --git a/man2/shmget.2 b/man2/shmget.2 index 06404cc7be..3d62d80f4d 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -1,11 +1,7 @@ .\" Copyright (c) 1993 Luigi P. Bai (lpb@softint.com) July 28, 1993 .\" May be distributed under the GNU General Public License. .\" Modified Wed Jul 28 10:57:35 1993, Rik Faith (faith@cs.unc.edu) -.\" Modified Sun Nov 28 16:43:30 1993, Rik Faith (faith@cs.unc.edu) -.\" with material from Giorgio Ciucci (giorgio@crcc.it) -.\" Portions Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH SHMGET 2 "November 28, 1993" "Linux 0.99.11" "Linux Programmer's Manual" +.TH SHMGET 2 "July 28, 1993" "Linux 0.99.11" "Linux Programmer's Manual" .SH NAME shmget \- allocates a shared memory segment .SH SYNOPSIS @@ -18,35 +14,19 @@ shmget \- allocates a shared memory segment .ad b .SH DESCRIPTION .B shmget() -returns the identifier of the shared memory segment -associated to the value of the argument +allocates a descriptor if there is not one already corresponding to the +given .IR key . -A new shared memory segment, with size equal to the round up of -.I size -to a multiple of +The key is an integer, usually requested from \fBftok()\fP, or +.B IPC_PRIVATE. +.PP +The size is effectively rounded up to .BR PAGE_SIZE , -is created if -.I key -has value -.B IPC_PRIVATE -or -.I key -isn't -.BR IPC_PRIVATE , -no shared memory segment is associated to -.IR key , -and -.B IPC_CREAT -is asserted in -.I shmflg -(i.e. -.IB shmflg &IPC_CREAT -isn't zero). -The presence in +since memory is allocated in pages. .PP .I shmflg is composed of: -.TP 12 +.TP 0.8i .B IPC_CREAT to create a new segment. If this flag is not used, then .B shmget() @@ -59,7 +39,6 @@ used with \fBIPC_CREAT\fP to ensure failure if the segment exists. .TP .B mode_flags (lowest 9 bits) specifying the permissions granted to the owner, group, and world. -Presently, the execute permissions are not used by the system. .PP If a new segment is created, the access permissions from .I shmflg @@ -98,45 +77,7 @@ struct ipc_perm }; .fi .PP -Furthermore, while creating, -the system call initializes the system shared memory segment data structure -.B shmid_ds -as follows: -.IP -.B shm_perm.cuid -and -.B shm_perm.uid -are set to the effective user\-ID of the calling process. -.IP -.B shm_perm.cgid -and -.B shm_perm.gid -are set to the effective group\-ID of the calling process. -.IP -The lowest order 9 bits of -.B shm_perm.mode -are set to the lowest order 9 bit of -.IR shmflg . -.IP -.B shm_segsz -is set to the value of -.IR size. -.IP -.BR shm_lpid , -.BR shm_nattch , -.B shm_atime -and -.B shm_dtime -are set to -.BR 0. -.IP -.B shm_ctime -is set to the current time. -.PP -If the shared memory segment already exists, the access permissions are -verified, and a check is made to see if it is marked for destruction. -.PP -.SH "SYSTEM CALLS" +.SH SYSTEM CALLS .TP 0.8i .B fork() After a @@ -156,12 +97,9 @@ all attached shared memory segments are detached (not destroyed). .SH "RETURN VALUE" A valid segment identifier, .IR shmid , -is returned on success, \-1 on error. +is returned on success, -1 on error. .SH ERRORS -On failure, -.B errno -is set to one of the following: -.TP 12 +.TP 0.8i .B EINVAL is returned if \fBSHMMIN\fP > \fIsize\fP or \fIsize\fP > \fBSHMMAX\fP, or \fIsize\fP is greater than size of segment. @@ -193,60 +131,5 @@ shared memory segment. .TP .B ENOMEM is returned if no memory could be allocated for segment overhead. -.SH NOTES -.B IPC_PRIVATE -isn't a flag field but a -.B key_t -type. -If this special value is used for -.IR key , -the system call ignores everything but the lowest order 9 bits of -.I shmflg -and creates a new shared memory segment (on success). -.PP -The followings are limits on shared memory segment resources affecting a -.B shmget -call: -.TP 11 -.B SHMALL -System wide maximum of shared memory pages: policy dependent. -.TP -.B SHMMAX -Maximum size in bytes for a shared memory segment: implementation -dependent (currently 4M). -.TP -.B SHMMIN -Minimum size in bytes for a shared memory segment: implementation -dependent (currently 1 byte, though -.B PAGE_SIZE -is the effective minimum size). -.TP -.B SHMMNI -System wide maximum number of shared memory segments: implementation -dependent (currently 4096). -.PP -The implementation has no specific limits for the per process maximun -number of shared memory segments -.RB ( SHMSEG ). -.SH BUGS -Use of -.B IPC_PRIVATE -don't inhibits to other processes the access to the allocated -shared memory segment. -.PP -As for the files, there is currently no intrinsic way for a process to ensure -exclusive access to a shared memory segment. -Asserting both -.B IPC_CREAT -and -.B IPC_EXCL -in -.I shmflg -only ensures (on success) that a new shared memory segment will be created, -it doesn't imply exclusive access to the segment. -.SH "SEE ALSO" -.BR ftok (3), -.BR ipc (5), -.BR shmctl (2), -.BR shmat (2), -.BR shmdt (2). +.SH SEE ALSO +.BR ftok "(2), " shmctl "(2), " shmop (2) diff --git a/man2/shmop.2 b/man2/shmop.2 index 1cb1eb9fbc..6f144b5bee 100644 --- a/man2/shmop.2 +++ b/man2/shmop.2 @@ -1,128 +1,46 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) +.\" Copyright (c) 1993 Luigi P. Bai (lpb@softint.com) July 28, 1993 .\" May be distributed under the GNU General Public License. -.\" Modified Sun Nov 28 17:06:19 1993, Rik Faith (faith@cs.unc.edu) -.\" with material from Luigi P. Bai (lpb@softint.com) -.\" Portions Copyright 1993 Luigi P. Bai -.\" May be distributed under the GNU General Public License. -.TH SHMOP 2 "November 28, 1993" "Linux 0.99.13" "Linux Programmer's Manual" +.\" Modified Wed Jul 28 11:06:29 1993, Rik Faith (faith@cs.unc.edu) +.TH SHMOP 2 "July 28, 1993" "Linux 0.99.11" "Linux Programmer's Manual" .SH NAME -shmop \- shared memory operations +shmop, shmat, shmdt \- shared memory operations .SH SYNOPSIS -.nf -.B -# include -.B -# include -.B -# include -.fi +.ad l +.B #include +.sp +.B #include .sp -.BI "char *shmat ( int " shmid , -.BI "char *" shmaddr , -.BI "int " shmflg " )" +.B "char *shmat (int shmid, char *shmaddr, int shmflg);" .sp -.BI "int shmdt ( char *" shmaddr ")" +.BI "int shmdt(char *" shmaddr ); +.ad b .SH DESCRIPTION -The function -.B shmat -attaches the shared memory segment identified by -.B shmid -to the data segment of the calling process. -The attaching address is specified by -.I shmaddr -with one of the following criteria: -.IP -If -.I shmaddr -is -.BR 0 , -the system tries to find an unmapped region in the range 1 \- 1.5G -starting from the upper value and coming down from there. -.IP +.B shmat() +maps a shared segment into the process's address space. Upon success, +the address of the mapped segment is returned. +.PP If .I shmaddr -isn't -.B 0 -and +is 0, then the system finds an unmapped region to map the segment into. +If \fIshmaddr\fP is not 0 then the address must be page-aligned, or +.I shmflg +must specify .B SHM_RND -is asserted in -.IR shmflg , -the attach occurs at address equal to the rounding down of -.I shmaddr -to a multiple of -.BR SHMLBA . -Otherwise -.I shmaddr -must be a page aligned address at which the attach occours. +to round \fIshmaddr\fP DOWN to the nearest page. .PP -If +If +.I shmflg +specifies .B SHM_RDONLY -is asserted in -.IR shmflg , -the segment is attached for reading and the process must have -read access permissions to the segment. -Otherwise the segment is attached for read and write -and the process must have read and write access permissions to the segment. -There is no notion of write-only shared memory segment. -.PP -The -.B brk -value of the calling process is not altered by the attach. -The segment will automatically detached at process exit. -The same segment may be attached as a read and as a read-write -one, and more than once, in the process's address space. -.PP -On a successful -.B shmat -call the system updates the members of the structure -.B shmid_ds -associated to the shared memory segment as follows: -.IP -.B shm_atime -is set to the current time. -.IP -.B shm_lpid -is set to the process-ID of the calling process. -.IP -.B shm_nattch -is incremented by one. -.PP -Note that the attach succeeds also if the shared memory segment is -marked as to be deleted. +then the segment is mapped in for reading only; otherwise, both read +and write access is allowed. .PP -The function -.B shmdt -detaches from the calling process's data segment the shared memory -segment located at the address specified by -.IR shmaddr . -The detaching shared memory segment must be one among the currently -attached ones (to the process's address space) with +.B shmdt() +detaches an already mapped-in segment. .I shmaddr -equal to the value returned by the its attaching -.B shat -call. -.PP -On a successful -.B shmdt -call the system updates the members of the structure -.B shmid_ds -associated to the shared memory segment as follows: -.IP -.B shm_dtime -is set to the current time. -.IP -.B shm_lpid -is set to the process-ID of the calling process. -.IP -.B shm_nattch -is decremented by one. -If it becomes 0 and the segment is marked for deletion, -the segment is deleted. -.PP -The occupied region in the user space of the calling process is -unmapped. -.PP -.SH "SYSTEM CALLS" +must be a valid address returned by +.BR shmat() . +.SH SYSTEM CALLS .TP .B fork() After a @@ -140,73 +58,39 @@ Upon all attached shared memory segments are detached (not destroyed). .PP .SH "RETURN VALUE" -On a failure both functions return -.B \-1 -with -.B errno -indicating the error, -otherwise -.B shmat -returns the address of the attached shared memory segment, and -.B shmdt -returns -.BR 0 . +.B shmat() +returns the mapped address on success, -1 on error. +.PP +.B shmdt() +returns 0 on success, -1 on error. .SH ERRORS -When -.B shmat -fails, at return -.B errno -will be set to one among the following values: -.TP 11 -.B EACCES -The calling process has no access permissions for the requested attach -type. +.sp +.B shmat() +returns the following errors: +.TP 0.8i +.B EACCESS +is returned if the user does not have permission to access the segment. .TP .B EINVAL -Invalid +is returned if .I shmid -value, unaligned (i.e., not page-aligned and fBSHM_RND\fP was not -specified) or invalid +is invalid, .I shmaddr -value, or failing attach at -.BR brk . +is not page-aligned and \fBSHM_RND\fP was not specified, or the +segment could not be mapped into the address space. +.TP +.B EIDRM +is returned if \fIshmid\fP points to a removed identifier. .TP .B ENOMEM -Could not allocate memory for the descriptor or for the page tables. -.PP -The function -.B shmdt -can fails only if there is no shared memory segment attached at -.IR shmaddr , -in such a case at return -.B errno -will be set to -.BR EINVAL . -.SH NOTES -On executing a -.BR fork (2) -system call, the child inherites all the attached shared memory segments. -.PP -The shared memory segments attached to a process executing an -.BR exec (2) -system call will not be attached to the resulting process. +is returned if no memory could be allocated for descriptor or page tables. .PP -The following is a system parameter affecting a -.B shmat -system call: -.TP 11 -.B SHMLBA -Segment low boundary address multiple. -Must be page aligned. -For the current implementation the -.B SHMBLA -value is -.BR PAGE_SIZE . .PP -The implementation has no intrinsic limit to the per process maximum -number of shared memory segments -.RB ( SHMSEG ) -.SH "SEE ALSO" -.BR ipc (5), -.BR shmctl (2), -.BR shmget (2). +.B shmdt() +returns the following errors: +.TP +.B EINVAL +is returned if there is no shared memory segment mapped in at address +.IR shmaddr . +.SH SEE ALSO +.BR shmget "(2), " shmctl (2) diff --git a/man2/shutdown.2 b/man2/shutdown.2 index c0beaffcb3..a89abae382 100644 --- a/man2/shutdown.2 +++ b/man2/shutdown.2 @@ -54,7 +54,7 @@ is 1, further sends will be disallowed. If .I how is 2, further sends and receives will be disallowed. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -74,5 +74,5 @@ The specified socket is not connected. The .B shutdown function call appeared in BSD 4.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR connect "(2), " socket (2) diff --git a/man2/sigblock.2 b/man2/sigblock.2 index f8996a6e5b..a2e15c07ec 100644 --- a/man2/sigblock.2 +++ b/man2/sigblock.2 @@ -62,9 +62,9 @@ It is not possible to block or .B SIGSTOP ; this restriction is silently imposed by the system. -.SH "RETURN VALUES" +.SH RETURN VALUES The previous set of masked signals is returned. .Sh HISTORY These function calls appeared in BSD 4.3 and have been deprecated. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill "(2), " sigprocmask "(2), " sigsetmask "(2), " siggetops (3) diff --git a/man2/signal.2 b/man2/signal.2 index ef604ef457..8fa92e76b2 100644 --- a/man2/signal.2 +++ b/man2/signal.2 @@ -125,5 +125,5 @@ is passed to the functions. .SH BUGS Signals have changed quite a bit in the Linux kernel since this man page was written. It is probably obsolete. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill "(2), " raise (3) diff --git a/man2/sigpause.2 b/man2/sigpause.2 index 1ff7e89404..f217ac4421 100644 --- a/man2/sigpause.2 +++ b/man2/sigpause.2 @@ -52,7 +52,7 @@ return the set of masked signals is restored. .I Sigmask is usually 0 to indicate that no signals are to be blocked. .B Sigpause -always terminates by being interrupted, returning \-1 with +always terminates by being interrupted, returning -1 with .I errno set to .B EINTR @@ -60,6 +60,6 @@ set to The .B sigpause function call appeared in BSD 4.3 and has been deprecated. -.SH "SEE ALSO" +.SH SEE ALSO .BR sigsuspend "(2), " kill "(2), " sigaction "(2), " sigprocmask "(2), " .BR sigblock "(2), " sigvec (2) diff --git a/man2/sigvec.2 b/man2/sigvec.2 index 13dbe4f6e7..98c32778c4 100644 --- a/man2/sigvec.2 +++ b/man2/sigvec.2 @@ -18,5 +18,5 @@ is #defined'd to be This interface is made obsolete by .BR sigaction (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR sigaction "(2), " signal (2) diff --git a/man2/socket.2 b/man2/socket.2 index ed9397500d..bafe74f1c1 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -146,7 +146,7 @@ The communications protocols used to implement a insure that data is not lost or duplicated. If a piece of data for which the peer protocol has buffer space cannot be successfully transmitted within a reasonable length of time, then the connection is considered -broken and calls will indicate an error with \-1 returns and with +broken and calls will indicate an error with -1 returns and with .B ETIMEDOUT as the specific code in the global variable .IR errno . @@ -193,8 +193,8 @@ These options are defined in the file and .BR getsockopt (2) are used to set and get options, respectively. -.SH "RETURN VALUES" -A \-1 is returned if an error occurs, otherwise the return value is a +.SH RETURN VALUES +A -1 is returned if an error occurs, otherwise the return value is a descriptor referencing the socket. .SH ERRORS .TP 0.8i @@ -219,7 +219,7 @@ created until sufficient resources are freed. The .B socket function call appeared in BSD 4.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR accept "(2), " bind "(2), " connect "(2), " getprotoent "(3), " .BR getsockname "(2), " getsockopt "(2), " ioctl "(2), " listen "(2), " .BR read "(2), " recv "(2), " select "(2), " send "(2), " shutdown "(2), " diff --git a/man2/socketpair.2 b/man2/socketpair.2 index c4cc12c2ab..90bec94ee1 100644 --- a/man2/socketpair.2 +++ b/man2/socketpair.2 @@ -58,7 +58,7 @@ and .IR sv [1]. The two sockets are indistinguishable. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -87,5 +87,5 @@ function call appeared in BSD 4.2. This call is currently implemented only for the .B UNIX domain. [Documenter's note: is this true for Linux?] -.SH "SEE ALSO" +.SH SEE ALSO .BR read "(2), " write "(2), " pipe (2) diff --git a/man2/stat.2 b/man2/stat.2 index 4cc35b3b4d..b29bf319a0 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -163,7 +163,7 @@ is identical to stat, only the open file pointed to by is stated in place of .IR file_name . .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/statfs.2 b/man2/statfs.2 index 9ab1b3f0cc..7a886d4b95 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -83,12 +83,12 @@ linux/xia_fs.h: _XIAFS_SUPER_MAGIC 0x012FD16D .fi .RE .PP -Fields that are undefined for a particular file system are set to \-1. +Fields that are undefined for a particular file system are set to -1. .B Fstatfs returns the same information about an open file referenced by descriptor .IR fd . .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/stime.2 b/man2/stime.2 index 6d585d4ce6..eb31d18c06 100644 --- a/man2/stime.2 +++ b/man2/stime.2 @@ -17,7 +17,7 @@ stime \- set time to by \fIt\fP, is measured in seconds from 00:00:00 GMT January 1, 1970. \fBstime()\fP may only be executed by the super user. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/swapon.2 b/man2/swapon.2 index 024378ef10..55967471af 100644 --- a/man2/swapon.2 +++ b/man2/swapon.2 @@ -25,7 +25,7 @@ stops swapping to the file or block device specified by These functions may only be used by the super-user. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/symlink.2 b/man2/symlink.2 index fa676935cd..664a78594d 100644 --- a/man2/symlink.2 +++ b/man2/symlink.2 @@ -45,7 +45,7 @@ exists it will .I not be overwritten. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -108,12 +108,12 @@ Deleting the name referred to by a symlink will actually delete the file (unless it also has other hard links). If this behaviour is not desired, use .BR link . -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, BSD 4.3 .SH BUGS See .BR open (2) re multiple files with the same name, and NFS. -.SH "SEE ALSO" +.SH SEE ALSO .BR link "(2), " unlink "(2), " rename "(2), " open (2), .BR lstat "(2), " ln "(1), " link (8). diff --git a/man2/sysinfo.2 b/man2/sysinfo.2 index d83fe1985f..9e98a02911 100644 --- a/man2/sysinfo.2 +++ b/man2/sysinfo.2 @@ -44,7 +44,7 @@ struct sysinfo { procides a simple way of getting overall system statistics. This is more portable than reading \fI/dev/kmem\fP. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/truncate.2 b/man2/truncate.2 index a39622f6bb..c8106911cb 100644 --- a/man2/truncate.2 +++ b/man2/truncate.2 @@ -55,7 +55,7 @@ data is lost. With .BR ftruncate , the file must be open for writing. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -122,5 +122,5 @@ These function calls appeared in BSD 4.2. .SH BUGS These calls should be generalized to allow ranges of bytes in a file to be discarded. -.SH "SEE ALSO" +.SH SEE ALSO .BR open (2) diff --git a/man2/uname.2 b/man2/uname.2 index 35cddb485f..9c9bc1b11d 100644 --- a/man2/uname.2 +++ b/man2/uname.2 @@ -33,7 +33,7 @@ char domainname[65]; .in 10 .fi .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/undocumented.2 b/man2/undocumented.2 index a2042d6264..99c786d303 100644 --- a/man2/undocumented.2 +++ b/man2/undocumented.2 @@ -5,7 +5,7 @@ .TH UNDOCUMENTED 2 "25 July 1993" "Linux 0.99.11" "Linux Programmer's Manual" .SH NAME break, stty, gtty, prof, ulimit, setsid, siggetmask, sigsetmask, -socketcall, klog, sigreturn, clone, syslog \- undocumented system call +socketcall, klog, ipc, sigreturn, clone, syslog \- undocumented system call .SH SYNOPSIS None. .SH DESCRIPTION diff --git a/man2/unlink.2 b/man2/unlink.2 index 689128735b..ad4a0f5d04 100644 --- a/man2/unlink.2 +++ b/man2/unlink.2 @@ -30,7 +30,7 @@ If the name referred to a socket, fifo or device the name for it is removed but processes which have the object open may continue to use it. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -77,11 +77,11 @@ Insufficient kernel memory was available. .B EROFS .I pathname refers to a file on a read-only filesystem. -.SH "CONFORMING TO" +.SH CONFORMING TO SVID, AT&T, POSIX, X/OPEN, BSD 4.3 .SH BUGS Infelicities in the protocol underlying NFS can cause the unexpected disappearance of files which are still being used. -.SH "SEE ALSO" +.SH SEE ALSO .BR link "(2), " rename "(2), " open "(2), " rmdir (2), .BR " mknod "(2), " mkfifo "(3), remove "(3), " rm "(1), " unlink (8). diff --git a/man2/uselib.2 b/man2/uselib.2 index 37107d48c4..9cd70a7389 100644 --- a/man2/uselib.2 +++ b/man2/uselib.2 @@ -15,7 +15,7 @@ uselib \- select shared library \fBuselib\fP selects the shared library binary that will be used by this processes. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -35,5 +35,5 @@ The library specified by is not readable. .SH "CONFORMING TO" \fBuselib()\fP is Linux specific. -.SH "SEE ALSO" +.SH SEE ALSO .BR open "(2), mmap "(2), " ldd "(1), " gcc "(1), " ar "(1), " ld (1) diff --git a/man2/utime.2 b/man2/utime.2 index 79c0d10e12..5c0a0fc2ca 100644 --- a/man2/utime.2 +++ b/man2/utime.2 @@ -67,7 +67,7 @@ struct timeval { .fi .RE .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/vhangup.2 b/man2/vhangup.2 index f10f0544a7..97f8087ca2 100644 --- a/man2/vhangup.2 +++ b/man2/vhangup.2 @@ -14,12 +14,12 @@ vhangup \- virtually \*(lqhangup\*(rq the current tty simulates a hangup on the current terminal. This call arranges for other users to have a \*(lqclean\*(rq tty at login time. .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS .TP 0.8i .B EPERM The user is not the super-user. -.SH "SEE ALSO" +.SH SEE ALSO .BR init (8) diff --git a/man2/vm86.2 b/man2/vm86.2 index 1fbdd0c6ba..0f9ad6d5f7 100644 --- a/man2/vm86.2 +++ b/man2/vm86.2 @@ -53,7 +53,7 @@ struct vm86_regs { .fi .RE .SH "RETURN VALUE" -On success, zero is returned. On error, \-1 is returned, and +On success, zero is returned. On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS diff --git a/man2/wait.2 b/man2/wait.2 index 4d493be2a5..9f4e0ab323 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -147,5 +147,5 @@ was not set and an unblocked signal or a was caught; this is an extension to the POSIX.1 standard. .SH "CONFORMS TO" POSIX.1 -.SH "SEE ALSO" +.SH SEE ALSO .BR signal "(2), " wait4 "(2), " signal (7) diff --git a/man2/wait4.2 b/man2/wait4.2 index a79dd97801..79f19d6425 100644 --- a/man2/wait4.2 +++ b/man2/wait4.2 @@ -160,5 +160,5 @@ was not set and an unblocked signal or a was caught; this is an extension to the POSIX.1 standard. .SH "CONFORMS TO" POSIX.1 -.SH "SEE ALSO" +.SH SEE ALSO .BR signal "(2), " getrusage "(2), " wait "(2), " signal (7) diff --git a/man2/write.2 b/man2/write.2 index f9ccd1cd80..2eaa38acd3 100644 --- a/man2/write.2 +++ b/man2/write.2 @@ -6,9 +6,8 @@ .\" Public Licence. It comes with NO WARRANTY. .\" .\" Modified Sat Jul 24 13:35:59 1993 by Rik Faith (faith@cs.unc.edu) -.\" Modified Sun Nov 28 17:19:01 1993 by Rik Faith (faith@cs.unc.edu) .\" -.TH WRITE 2 "28 November 1993" Linux "Linux Programmer's Manual" +.TH WRITE 2 "24 July 1993" Linux "Linux Programmer's Manual" .SH NAME write \- write to a file descriptor .SH SYNOPSIS @@ -16,7 +15,7 @@ write \- write to a file descriptor .br .B #include .sp -.BI "ssize_t write(int " fd ", const char *" buf ", size_t " count ); +.BI "int write(int " fd ", const char *" buf ", size_t " count ); .SH DESCRIPTION .B write writes up to @@ -25,9 +24,9 @@ bytes from file descriptor .I fd from the buffer starting at .I buf. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the number of bytes written are returned (zero indicated end of -file). On error, \-1 is returned, and +file). On error, -1 is returned, and .I errno is set appropriately. .SH ERRORS @@ -72,7 +71,7 @@ Other errors may occur, depending on the object connected to .IR fd . .SH "CONFORMING TO" SVID, AT&T, POSIX, X/OPEN, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR open "(2), " read "(2), " fcntl "(2), " close (2), .BR lseek "(2), " .BR select "(2), " ioctl "(2), " fwrite (3). diff --git a/man3/abort.3 b/man3/abort.3 index 26c662ddfc..5dae01030d 100644 --- a/man3/abort.3 +++ b/man3/abort.3 @@ -26,5 +26,5 @@ function will still override it. The \fBabort()\fP function never returns. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR sigaction "(2), " exit (3) diff --git a/man3/abs.3 b/man3/abs.3 index 1b9d989cae..96c824579e 100644 --- a/man3/abs.3 +++ b/man3/abs.3 @@ -26,5 +26,5 @@ SVID 3, POSIX, BSD 4.3, ISO 9899 .SH NOTES Trying to take the absolute value of the most negative integer is not defined. -.SH "SEE ALSO" +.SH SEE ALSO .BR ceil "(3), " floor "(3), " fabs "(3), " labs "(3), " rint (3) diff --git a/man3/acos.3 b/man3/acos.3 index 471f7bcf02..a7b310846c 100644 --- a/man3/acos.3 +++ b/man3/acos.3 @@ -17,7 +17,7 @@ acos \- arc cosine function .SH DESCRIPTION The \fBacos()\fP function calculates the arc cosine of \fIx\fP; that is the value whose cosine is \fIx\fP. If \fIx\fP falls outside the range -\-1 to 1, \fBacos()\fP fails and \fIerrno\fP is set. +-1 to 1, \fBacos()\fP fails and \fIerrno\fP is set. .SH "RETURN VALUE" The \fBacos()\fP function returns the arc cosine in radians and the value is mathematically defined to be between 0 and PI (inclusive). @@ -27,5 +27,5 @@ value is mathematically defined to be between 0 and PI (inclusive). \fIx\fP is out of range. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR asin "(3), " atan "(3), " atan2 "(3), " cos "(3), " sin "(3), " tan (3) diff --git a/man3/acosh.3 b/man3/acosh.3 index bbecf0f646..0a432a21bb 100644 --- a/man3/acosh.3 +++ b/man3/acosh.3 @@ -25,5 +25,5 @@ is set. \fIx\fP is out of range. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR asinh "(3), " atanh "(3), " cosh "(3), " sinh "(3), " tanh (3) diff --git a/man3/alloca.3 b/man3/alloca.3 deleted file mode 100644 index 6703c4f7f5..0000000000 --- a/man3/alloca.3 +++ /dev/null @@ -1,75 +0,0 @@ -.\" Copyright (c) 1980, 1991 Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)alloca.3 5.1 (Berkeley) 5/2/91 -.\" -.\" Converted for Linux, Mon Nov 29 11:05:55 1993, faith@cs.unc.edu -.\" -.TH ALLOCA 3 "29 November 1993" "GNU" "Linux Programmer's Manual" -.SH NAME -alloca \- memory allocator -.SH SYNOPSIS -.B #include -.sp -.BI "void *alloca( size_t " size ); -.SH DESCRIPTION -The -.B alloca -function allocates -.I size -bytes of space in the stack frame of the caller. This temporary space is -automatically freed on return. -.SH "RETURN VALUES" -The -.B alloca -function returns a pointer to the beginning of the allocated space. If the -allocation failed, a -.B NULL -pointer is returned. -.SH HISTORY -There is evidence that the -.B alloca -function appears in 32v, pwb, pwb.2, 3bsd, and 4bsd. There is a man page -for it in BSD 4.3. Linux uses the GNU version. -.SH BUGS -The -.B alloca -function is machine dependent. -.SH SEE ALSO -.BR brk "(2), " pagesize "(2), " calloc "(3), " malloc "(3), " realloc (3) -.\" .Sh HISTORY -.\" The -.\" .Fn alloca -.\" function appeared in -.\" .Bx ?? . -.\" The function appeared in 32v, pwb and pwb.2 and in 3bsd 4bsd -.\" The first man page (or link to a man page that I can find at the -.\" moment is 4.3... diff --git a/man3/asin.3 b/man3/asin.3 index 37cf8f14bc..675d56adce 100644 --- a/man3/asin.3 +++ b/man3/asin.3 @@ -17,7 +17,7 @@ asin \- arc sine function .SH DESCRIPTION The \fBasin()\fP function calculates the arc sine of \fIx\fP; that is the value whose sine is \fIx\fP. If \fIx\fP falls outside the range -\-1 to 1, \fBasin()\fP fails and \fIerrno\fP is set. +-1 to 1, \fBasin()\fP fails and \fIerrno\fP is set. .SH "RETURN VALUE" The \fBasin()\fP function returns the arc sine in radians and the value is mathematically defined to be between -PI/2 and PI/2 @@ -28,5 +28,5 @@ value is mathematically defined to be between -PI/2 and PI/2 \fIx\fP is out of range. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " atan "(3), " atan2 "(3), " cos "(3), " sin "(3), " tan (3) diff --git a/man3/asinh.3 b/man3/asinh.3 index 1c7a6fca70..f91a9e24f7 100644 --- a/man3/asinh.3 +++ b/man3/asinh.3 @@ -19,5 +19,5 @@ The \fBasinh()\fP function calculates the inverse hyperbolic sine of \fIx\fP; that is the value whose hyperbolic sine is \fIx\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh "(3), " atanh "(3), " cosh "(3), " sinh "(3), " tanh (3) diff --git a/man3/assert.3 b/man3/assert.3 index bbdfcd84d8..876d280007 100644 --- a/man3/assert.3 +++ b/man3/assert.3 @@ -31,5 +31,5 @@ is implemented as a macro; if the expression tested has side - effects, program behaviour will be different depending on wether .B NDEBUG is defined. This may create Heisenbugs which go away when debugging is turned on. -.SH "SEE ALSO" +.SH SEE ALSO .BR exit "(3), " abort (3) diff --git a/man3/atan.3 b/man3/atan.3 index e2b2a7da30..07001a4366 100644 --- a/man3/atan.3 +++ b/man3/atan.3 @@ -23,5 +23,5 @@ value is mathematically defined to be between -PI/2 and PI/2 (inclusive). .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan2 "(3), " cos "(3), " sin "(3), " tan (3) diff --git a/man3/atan2.3 b/man3/atan2.3 index b64e7fe317..a99344d90d 100644 --- a/man3/atan2.3 +++ b/man3/atan2.3 @@ -24,5 +24,5 @@ The \fBatan2()\fP function returns the result in radians, which is between -PI and PI (inclusive). .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan "(3), " cos "(3), " sin "(3), " tan(3) diff --git a/man3/atanh.3 b/man3/atanh.3 index 7f2a7e83ff..4c963d27d2 100644 --- a/man3/atanh.3 +++ b/man3/atanh.3 @@ -25,5 +25,5 @@ not-a-number (NaN) and \fIerrno\fP is set. \fIx\fP is out of range. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR asinh "(3), " acosh "(3), " cosh "(3), " sinh "(3), " tanh (3) diff --git a/man3/atexit.3 b/man3/atexit.3 index 48f933de99..a3a3af2034 100644 --- a/man3/atexit.3 +++ b/man3/atexit.3 @@ -24,7 +24,7 @@ from the program's \fBmain\fP. Functions so registered are called in the reverse order of their registration; no arguments are passed. .SH "RETURN VALUE" The \fBatexit()\fP function returns the value 0 if successful; otherwise -the value \-1 is returned and the global variable \fIerrno\fP is set to +the value -1 is returned and the global variable \fIerrno\fP is set to indicate the error. .SH "ERRORS" .TP @@ -32,5 +32,5 @@ indicate the error. Insufficient memory available to add the function. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR exit "(3), " on_exit (3) diff --git a/man3/atof.3 b/man3/atof.3 index 3f813b9c85..e5ff4b7bec 100644 --- a/man3/atof.3 +++ b/man3/atof.3 @@ -28,5 +28,5 @@ except that \fBatof()\fP does not detect errors. The converted value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atoi "(3), " atol "(3), " strtod "(3), " strtol "(3), " strtoul (3) diff --git a/man3/atoi.3 b/man3/atoi.3 index f2dc21898c..757ea42d75 100644 --- a/man3/atoi.3 +++ b/man3/atoi.3 @@ -28,5 +28,5 @@ except that \fBatoi()\fP does not detect errors. The converted value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atof "(3), " atol "(3), " strtod "(3), " strtol "(3), " strtoul (3) diff --git a/man3/atol.3 b/man3/atol.3 index a174b93441..7ef53c32e6 100644 --- a/man3/atol.3 +++ b/man3/atol.3 @@ -28,5 +28,5 @@ except that \fBatol()\fP does not detect errors. The converted value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atof "(3), " atoi "(3), " strtod "(3), " strtol "(3), " strtoul (3) diff --git a/man3/bcmp.3 b/man3/bcmp.3 index 1a92edcdf7..1ee24b4d10 100644 --- a/man3/bcmp.3 +++ b/man3/bcmp.3 @@ -24,6 +24,6 @@ The \fBbcmp()\fP function returns 0 if the strings are equal, otherwise a non-zero result is returned. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR memcmp "(3), " strcasecmp "(3), " strcmp (3), .BR strcoll "(3), " strncmp "(3), " strncasecmp (3) diff --git a/man3/bcopy.3 b/man3/bcopy.3 index 177d33a449..7a3badc0a8 100644 --- a/man3/bcopy.3 +++ b/man3/bcopy.3 @@ -21,5 +21,5 @@ zero, no bytes are copied. The \fBbcopy()\fP function returns no value. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO memccpy(3), memcpy(3), memmove(3), strcpy(3), strncpy(3) diff --git a/man3/bsearch.3 b/man3/bsearch.3 index 188a90107f..1c5ba2a6fa 100644 --- a/man3/bsearch.3 +++ b/man3/bsearch.3 @@ -37,5 +37,5 @@ array, or NULL if no match is found. If there are multiple elements that match the key, the element returned is unspecified. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR qsort (3) diff --git a/man3/bstring.3 b/man3/bstring.3 index 6a4ffe1284..1602129366 100644 --- a/man3/bstring.3 +++ b/man3/bstring.3 @@ -43,7 +43,7 @@ memmove, memset \- byte string operations The byte string functions perform operations on strings that are not NULL-terminated. See the individual man pages for descriptions of each function. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " bcopy "(3), " bzero "(3), " memccpy "(3), " memchr (3), .BR memcmp "(3), " memcpy "(3), " memfrob "(3), " memmem (3), .BR memmove "(3), " memset (3) diff --git a/man3/byteorder.3 b/man3/byteorder.3 index d552fc076b..3cdfd840b6 100644 --- a/man3/byteorder.3 +++ b/man3/byteorder.3 @@ -39,5 +39,5 @@ whereas the network byte order, as used on the Internet, is Most Significant Byte first. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostbyname "(3), " getservent (3) diff --git a/man3/bzero.3 b/man3/bzero.3 index e0f235d557..2898d625fd 100644 --- a/man3/bzero.3 +++ b/man3/bzero.3 @@ -21,5 +21,5 @@ string \fIs\fP to zero. The \fBbcmp()\fP function returns no value. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR memset "(3), " swab (3) diff --git a/man3/ceil.3 b/man3/ceil.3 index aba468fd3c..e36fb2059e 100644 --- a/man3/ceil.3 +++ b/man3/ceil.3 @@ -19,5 +19,5 @@ The \fBceil()\fP function rounds \fIx\fP upwards to the nearest integer, returning that value as a double. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " fabs "(3), " floor "(3), " labs "(3), " rint (3) diff --git a/man3/clearerr.3 b/man3/clearerr.3 deleted file mode 100644 index 196ef922de..0000000000 --- a/man3/clearerr.3 +++ /dev/null @@ -1 +0,0 @@ -man3/ferror.3 diff --git a/man3/clock.3 b/man3/clock.3 index b37ae2040d..9b115c469e 100644 --- a/man3/clock.3 +++ b/man3/clock.3 @@ -31,5 +31,5 @@ at the start of the program and the end to get maximum portability. The .B times() function call returns more information. -.SH "SEE ALSO" +.SH SEE ALSO .BR times (2) diff --git a/man3/closedir.3 b/man3/closedir.3 index 1b7a2a93f3..871045f7b4 100644 --- a/man3/closedir.3 +++ b/man3/closedir.3 @@ -19,13 +19,13 @@ The \fBclosedir()\fP function closes the directory stream associated with \fIdir\fP. The directory stream descriptor \fIdir\fP is not available after this call. .SH "RETURN VALUE" -The \fBclosedir()\fP function returns 0 on success or \-1 on failure. +The \fBclosedir()\fP function returns 0 on success or -1 on failure. .SH "ERRORS" .TP .B EBADF Invalid directory stream descriptor \fIdir\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR close "(2), " opendir "(3), " readdir "(3), " rewinddir (3), .BR seekdir "(3), " telldir "(3), " scandir (3) diff --git a/man3/confstr.3 b/man3/confstr.3 index d8efc5a52c..82d092e663 100644 --- a/man3/confstr.3 +++ b/man3/confstr.3 @@ -84,5 +84,5 @@ proposed POSIX.2 .SH "BUGS" POSIX.2 is not yet an approved standard; the information in this manpage is subject to change. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh "(1), " exec "(2), " system (3) diff --git a/man3/cos.3 b/man3/cos.3 index 98473ec94a..d4158e362d 100644 --- a/man3/cos.3 +++ b/man3/cos.3 @@ -18,8 +18,8 @@ cos \- cosine function The \fBcos()\fP function returns the cosine of \fIx\fP, where \fIx\fP is given in radians. .SH "RETURN VALUE" -The \fBcos()\fP function returns a value between \-1 and 1. +The \fBcos()\fP function returns a value between -1 and 1. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan "(3), " atan2 "(3), " sin "(3), " tan (3) diff --git a/man3/cosh.3 b/man3/cosh.3 index 3885c05bdb..969a454fe2 100644 --- a/man3/cosh.3 +++ b/man3/cosh.3 @@ -19,5 +19,5 @@ The \fBcosh()\fP function returns the hyperbolic cosine of \fIx\fP, which is defined mathematically as exp(x) + exp(-x) / 2. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh "(3), " asinh "(3), " atanh "(3), " sinh "(3), " tanh (3) diff --git a/man3/ctermid.3 b/man3/ctermid.3 index f9e8bf47b2..00f197a05f 100644 --- a/man3/ctermid.3 +++ b/man3/ctermid.3 @@ -35,5 +35,5 @@ terminal; it may, for example, be .BR /dev/tty . .PP It is not assured that the program can open the terminal. -.SH "SEE ALSO" +.SH SEE ALSO .BR ttyname (3) diff --git a/man3/ctime.3 b/man3/ctime.3 index d8c45bd32c..fd9db56eb9 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -131,10 +131,10 @@ them from the other information in the broken-down time structure. Calling \fBmktime()\fP also sets the external variable \fItzname\fP with information about the current time zone. If the specified broken-down time cannot be represented as calendar time, \fBmktime()\fP returns a -value of (time_t)(\-1) and does not alter the \fItm_wday\fP and \fItm_yday\fP +value of (time_t)(-1) and does not alter the \fItm_wday\fP and \fItm_yday\fP members of the broken-down time structure. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR date "(1), " gettimeofday "(2), " time "(2), " tzset (3), .BR difftime "(3), " strftime (3) diff --git a/man3/difftime.3 b/man3/difftime.3 index fc53aa1d1f..e0b35fa89f 100644 --- a/man3/difftime.3 +++ b/man3/difftime.3 @@ -21,6 +21,6 @@ specified in calendar time, which represents the time elapsed since 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC). .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR date "(1), " gettimeofday "(2), " time (2), .BR ctime "(3), " gmtime "(3), " localtime (3) diff --git a/man3/div.3 b/man3/div.3 index 8ddb9b0a3b..58abb0fba2 100644 --- a/man3/div.3 +++ b/man3/div.3 @@ -23,5 +23,5 @@ contains two integer members named \fIquot\fP and \fIrem\fP. The \fIdiv_t\fP structure. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR ldiv (3) diff --git a/man3/drand48.3 b/man3/drand48.3 index d561439553..b2c9cb4a5f 100644 --- a/man3/drand48.3 +++ b/man3/drand48.3 @@ -43,7 +43,7 @@ The \fBlrand48()\fP and \fBnrand48()\fP functions return non-negative long integers uniformly distributed between 0 and 2^31. .PP The \fBmrand48()\fP and \fBjrand48()\fP functions return signed long -integers uniformly distributed between \-2^31 and 2^31. +integers uniformly distributed between -2^31 and 2^31. .PP The \fBsrand48()\fP, \fBseed48()\fP and \fBlcong48()\fP functions are initialization functions, one of which should be called before using @@ -105,5 +105,5 @@ SVID 3 .SH NOTES These functions are declared obsolete by SVID 3, which states that rand(3) should be used instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR rand "(3), " random (3) diff --git a/man3/drem.3 b/man3/drem.3 index e86650bb34..412a36899d 100644 --- a/man3/drem.3 +++ b/man3/drem.3 @@ -28,5 +28,5 @@ when the function fails and \fIerrno\fP is set. The denominator \fIy\fP is zero. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fmod (3) diff --git a/man3/ecvt.3 b/man3/ecvt.3 index a55fa53be8..e45dd67721 100644 --- a/man3/ecvt.3 +++ b/man3/ecvt.3 @@ -33,5 +33,5 @@ Both the \fBecvt()\fP and \fBfcvt()\fP functions return a pointer to a static string containing the ASCII representation of \fInumber\fP. The static string is overwritten by each call to \fBecvt()\fP or \fBfcvt()\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR gcvt "(3), " sprintf (3) diff --git a/man3/erand48.3 b/man3/erand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/erand48.3 +++ b/man3/erand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3 \ No newline at end of file diff --git a/man3/erf.3 b/man3/erf.3 index c692fb0b6e..05a7ef9ff1 100644 --- a/man3/erf.3 +++ b/man3/erf.3 @@ -26,5 +26,5 @@ The \fBerfc()\fP function returns the complementary error function of \fIx\fP, that is 1.0 - erf(x). .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR exp (3) diff --git a/man3/exec.3 b/man3/exec.3 deleted file mode 100644 index 8a90da03cb..0000000000 --- a/man3/exec.3 +++ /dev/null @@ -1,232 +0,0 @@ -.\" Copyright (c) 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)exec.3 6.4 (Berkeley) 4/19/91 -.\" -.\" Converted for Linux, Mon Nov 29 11:12:48 1993, faith@cs.unc.edu -.\" -.TH EXEC 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -execl, execlp, execle, exect, execv, execvp \- execute a file -.SH SYNOPSIS -.SH SYNOPSIS -.B #include -.sp -.B extern char **environ; -.sp -.BI "int execl( const char *" path ", const char *" arg ", ...); -.br -.BI "int execlp( const char *" file ", const char *" arg ", ...); -.br -.BI "int execle( const char *" path ", const char *" arg -.BI ", ..., char * const " envp "[]);" -.br -.BI "int exect( const char *" path ", char *const " argv "[]);" -.br -.BI "int execv( const char *" path ", char *const " argv "[]);" -.br -.BI "int execvp( const char *" file ", char *const " argv "[]);" -.SH DESCRIPTION -The -.B exec -family of functions replaces the current process image with a new process -image. The functions described in this manual page are front-ends for the -function -.BR execve (2). -(See the manual page for -.B execve -for detailed information about the replacement of the current process.) -.PP -The initial argument for these functions is the pathname of a file which is -to be executed. -.PP -The -.I "const char *arg" -and subsequent ellipses in the -.BR execl , -.BR execlp , -and -.B execle -functions can be thought of as -.IR arg0 , -.IR arg1 , -\&..., -.IR argn . -Together they describe a list of one or more pointers to null-terminated -strings that represent the argument list available to the executed program. -The first argument, by convention, should point to the file name associated -with the file being executed. The list of arguments -.I must -be terminated by a -.B NULL -pointer. -.PP -The -.BR exect , -.BR execv , -and -.B execvp -functions provide an array of pointers to null-terminated strings that -represent the argument list available to the new program. The first -argument, by convention, should point to the file name associated with the -file begin executed. The array of pointers -.I must -be terminated by a -.B NULL -pointer. -.PP -The -.B execle -and -.B exect -functions also specify the environment of the executed process by following -the -.B NULL -pointer that terminates the list of arguments in the parameter list or the -pointer to the argv array with an additional parameter. This additional -parameter is an array of pointers to null-terminated strings and -.I must -be terminated by a -.B NULL -pointer. The other functions take the environment for the new process -image from the external variable -.I environ -in the current process. -.PP -Some of these functions have special semantics. -.PP -The functions -.B execlp -and -.B execvp -will duplicate the actions of the shell in searching for an executable file -if the specified file name does not contain a slash (/) character. The -search path is the path specified in the environment by the -.B PATH -variable. If this variable isn't specified, the default path -``/bin:/usr/bin:'' is used (is this true for Linux?). In addition, certain -errors are treated specially. -.PP -If permission is denied for a file (the attempted -.B execve -returned -.BR EACCES ), -these functions will continue searching the rest of the search path. If no -other file is found, however, they will return with the global variable -.I errno -set to -.BR EACCES . -.PP -If the header of a file isn't recognized (the attempted -.B execve -returned -.BR ENOEXEC ), -these functions will execute the shell with the path of the file as its -first argument. (If this attempt fails, no further searching is done.) -.PP -If the file is currently busy (the attempted -.B execve -returned -.BR ETXTBUSY ), -these functions will sleep for several seconds, periodically re-attempting -to execute the file. (Is this true for Linux?) -.PP -The function -.B exect -executes a file with the program tracing facilities enabled (see -.BR ptrace (2). -.SH "RETURN VALUES" -If any of the -.B exec -functions returns, an error will have occurred. The return value is \-1, -and the global variable -.I errno -will be set to indicate the error. -.SH FILES -.I /bin/sh -.SH ERRORS -.BR Execl , -.BR execle , -.BR execlp -and -.B execvp -may fail and set -.I errno -for any of the errors specified for the library functions -.BR execve (2) -and -.BR malloc (3). -.PP -.B Exect -and -.B execv -may fail and set -.I errno -for any of the errors specified for the library function -.BR execve (2). -.SH "SEE ALSO" -.BR sh "(1), " execve "(2), " fork "(2), " trace "(2), " environ "(7), " -.BR ptrace (2) -.SH COMPATIBILITY -Historically, the default path for the -.B execlp -and -.B execvp -functions was ``:/bin:/usr/bin''. This was changed to place the current -directory last to enhance system security. -.PP -The behavior of -.B execlp -and -.B execvp -when errors occur while attempting to execute the file is historic -practice, but has not traditionally been documented and is not specified by -the POSIX standard. -.PP -Traditionally, the functions -.B execlp -and -.B execvp -ignored all errors except for the ones described above and -.B ENOMEM -and -.BR E2BIG , -upon which they returned. They now return if any error other than the ones -described above occurs. -.SH STANDARDS -.BR Execl , -.BR execv , -.BR execle , -.B execlp -and -.B execvp -conform to -IEEE Std1003.1-88 (``POSIX''). diff --git a/man3/execl.3 b/man3/execl.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/execl.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/execle.3 b/man3/execle.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/execle.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/exect.3 b/man3/exect.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/exect.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/execv.3 b/man3/execv.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/execv.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/execvp.3 b/man3/execvp.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/execvp.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/exit.3 b/man3/exit.3 index 7559382399..612be5b4b2 100644 --- a/man3/exit.3 +++ b/man3/exit.3 @@ -24,5 +24,5 @@ closed. The \fBexit()\fP function does not return. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR _exit "(2), " atexit "(3), " on_exit (3) diff --git a/man3/exp.3 b/man3/exp.3 index 8d544d3600..af117d7338 100644 --- a/man3/exp.3 +++ b/man3/exp.3 @@ -46,5 +46,5 @@ The argument \fIx\fP is negative and \fIy\fP is not an integral value. This would result in a complex number. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR sqrt "(3), " cbrt (3) diff --git a/man3/fabs.3 b/man3/fabs.3 index ed1319cd17..c5f5301b2d 100644 --- a/man3/fabs.3 +++ b/man3/fabs.3 @@ -19,5 +19,5 @@ The \fBfabs()\fP function returns the absolute value of the floating-point number \fIx\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " ceil "(3), " floor "(3), " labs "(3), " rint (3) diff --git a/man3/fclose.3 b/man3/fclose.3 deleted file mode 100644 index 81659bf1bb..0000000000 --- a/man3/fclose.3 +++ /dev/null @@ -1,82 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fclose.3 6.7 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:19:14 1993, faith@cs.unc.edu -.\" -.TH FCLOSE 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fclose \- close a stream -.SH SYNOPSIS -.B #include -.sp -.BI "int fclose( FILE *" stream ); -.SH DESCRIPTION -The -.B fclose -function dissociates the named -.I stream -from its underlying file or set of functions. If the stream was being used -for output, any buffered data is written first, using -.BR fflush (3). -.SH "RETURN VALUES" -Upon successful completion 0 is returned. Otherwise, -.B EOF -is returned and the global variable -.I errno -is set to indicate the error. In either case no further access to the -stream is possible. -.SH ERRORS -.TP -.B EBADF -The argument -.I stream -is not an open stream. -.PP -The -.B fclose -function may also fail and set -.I errno -for any of the errors specified for the routines -.BR close (2) -or -.BR fflush (3). -.SH SEE ALSO -.BR close "(2), " fflush "(3), " fopen "(3), " setbuf (3) -.SH STANDARDS -The -.B fclose -function conforms to ANSI C3.159-1989 (``ANSI C''). diff --git a/man3/fdopen.3 b/man3/fdopen.3 deleted file mode 100644 index 9a4012491e..0000000000 --- a/man3/fdopen.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fopen.3 diff --git a/man3/feof.3 b/man3/feof.3 deleted file mode 100644 index 196ef922de..0000000000 --- a/man3/feof.3 +++ /dev/null @@ -1 +0,0 @@ -man3/ferror.3 diff --git a/man3/ferror.3 b/man3/ferror.3 deleted file mode 100644 index fa0f6915cf..0000000000 --- a/man3/ferror.3 +++ /dev/null @@ -1,93 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)ferror.3 6.8 (Berkeley) 6/29/91 -.\" -.\" -.\" Converted for Linux, Mon Nov 29 14:24:40 1993, faith@cs.unc.edu -.\" -.TH FERROR 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -clearerr, feof, ferror, fileno \- check and reset stream status -.SH SYNOPSIS -.B #include -.sp -.BI "void clearerr( FILE *" stream ); -.br -.BI "int feof( FILE *" stream ); -.br -.BI "int ferror( FILE *" stream ); -.br -.BI "int fileno( FILE *" stream ); -.SH DESCRIPTION -The function -.B clearerr -clears the end-of-file and error indicators for the stream pointed to by -.IR stream . -.PP -The function -.B feof -tests the end-of-file indicator for the stream pointed to by -.IR stream , -returning non-zero if it is set. The end-of-file indicator can only be -cleared by the function -.BR clearerr . -.PP -The function -.B ferror -tests the error indicator for the stream pointed to by -.IR stream , -returning non-zero if it is set. The error indicator can only be reset by -the -.B clearerr -function. -.PP -The function -.B fileno -examines the argument -.I stream -and returns its integer desciptor. -.SH ERRORS -These functions should not fail and do not set the external variable -.IR errno . -.SH SEE ALSO -.BR open "(2), " stdio (3) -.SH STANDARDS -The functions -.BR clearerr , -.BR feof , -and -.BR ferror -conform to C3.159-1989 (``ANSI C''). diff --git a/man3/fflush.3 b/man3/fflush.3 deleted file mode 100644 index aec074dd1d..0000000000 --- a/man3/fflush.3 +++ /dev/null @@ -1,104 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fflush.3 5.4 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu -.\" -.TH FFLUSH 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fflush, fpurge \- flush a stream -.SH SYNOPSIS -.B #include -.sp -.BI "int fflush( FILE *" stream ); -.br -.BI "int fpurge( FILE *" stream ); -.SH DESCRIPTION -The function -.B fflush -forces a write of all buffered data for the given output or update -.I stream -via the stream's underlying write function. The open status of the stream -is unaffected. -.PP -If the -.I stream -argument is -.BR NULL , -.B fflush -flushes -.I all -open output streams. (Does this happen under Linux?) -.PP -The function -.B fpurge -erases any input or output buffered in the given -.IR stream . -For output streams this discards any unwritten output. For input streams -this discards any input read from the underlying object but not yet -obtained via -.BR getc (3); -this includes any text pushed back via -.BR ungetc . -.SH "RETURN VALUES" -Upon successful completion 0 is returned. Otherwise, -.B EOF -is returned and the global variable -.I errno -is set to indicate the error. -.SH ERRORS -.TP -.B EBADF -.I Stream -is not an open stream, or, in the case of -.BR fflush , -not a stream open for writing. -.PP -The function -.B fflush -may also fail and set -.I errno -for any of the errors specified for the routine -.BR write (2). -.SH BUGS -Linux may not support -.BR fpurge . -.SH "SEE ALSO" -.BR write "(2), " fopen "(3), " fclose "(3), " setbuf (3) -.SH STANDARDS -The -.B fflush -function conforms to ANSI C3.159-1989 (``ANSI C''). diff --git a/man3/fgetgrent.3 b/man3/fgetgrent.3 index 05eaf9d745..c4e4f59bb8 100644 --- a/man3/fgetgrent.3 +++ b/man3/fgetgrent.3 @@ -45,6 +45,6 @@ or NULL if there are no more entries or an error occurs. Insufficient memory to allocate group information structure. .SH "CONFORMING TO" SVID 3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getgrnam "(3), " getgrgid "(3), " getgrent (3), .BR setgrent "(3), " endgrent (3) diff --git a/man3/fgetpos.3 b/man3/fgetpos.3 deleted file mode 100644 index a1487b5a8c..0000000000 --- a/man3/fgetpos.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fseek.3 diff --git a/man3/fgetpwent.3 b/man3/fgetpwent.3 index 1a59ef4851..c431737669 100644 --- a/man3/fgetpwent.3 +++ b/man3/fgetpwent.3 @@ -49,6 +49,6 @@ there are no more entries or an error occurs. Insufficient memory to allocate passwd structure. .SH "CONFORMING TO" SVID 3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getpwnam "(3), " getpwuid "(3), " getpwent "(3), " setpwent (3), .BR endpwent "(3), " getpw "(3), " putpwent (3) diff --git a/man3/fileno.3 b/man3/fileno.3 deleted file mode 100644 index 196ef922de..0000000000 --- a/man3/fileno.3 +++ /dev/null @@ -1 +0,0 @@ -man3/ferror.3 diff --git a/man3/floor.3 b/man3/floor.3 index b818e0a5c1..93f003a90d 100644 --- a/man3/floor.3 +++ b/man3/floor.3 @@ -19,5 +19,5 @@ The \fBfloor()\fP function rounds \fIx\fP downwards to the nearest integer, returning that value as a double. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " fabs "(3), " ceil "(3), " rint (3) diff --git a/man3/fmod.3 b/man3/fmod.3 index 0be7e3dd08..6cafed5cff 100644 --- a/man3/fmod.3 +++ b/man3/fmod.3 @@ -27,5 +27,5 @@ when the function fails and \fIerrno\fP is set. The denominator \fIy\fP is zero. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR drem (3) diff --git a/man3/fnmatch.3 b/man3/fnmatch.3 index 48abcbc0eb..a14864ebb3 100644 --- a/man3/fnmatch.3 +++ b/man3/fnmatch.3 @@ -58,5 +58,5 @@ proposed POSIX.2 .SH BUGS POSIX.2 is not yet an approved standard; the information in this manpage is subject to change. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh "(1), " glob "(3), " glob (7) diff --git a/man3/fopen.3 b/man3/fopen.3 deleted file mode 100644 index 39938d08de..0000000000 --- a/man3/fopen.3 +++ /dev/null @@ -1,198 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fopen.3 6.8 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu -.\" -.TH FOPEN 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fopen, fdopen, freopen \- stream open functions -.SH SYNOPSIS -.B #include -.sp -.BI "FILE *fopen( char *" path ", char *" mode ); -.br -.BI "FILE *fdopen( int " fildes ", char *" mode ); -.br -.BI "FILE *freopen( char *" path ", char *" mode ", FILE *" stream ); -.SH DESCRIPTION -The -.B fopen -function opens the file whose name is the string pointed to by -.I path -and associates a stream with it. -.PP -The argument -.I mode -points to a string beginning with one of the following sequences -(Additional characters may follow these sequences.): -.TP -.B r -Open text file for reading. The stream is positioned at the beginning of -the file. -.TP -.B r+ -Open for reading and writing. The stream is positioned at the beginning of -the file. -.TP -.B w -Truncate file to zero length or create text file for writing. The stream -is positioned at the beginning of the file. -.TP -.B w+ -Open for reading and writing. The file is created if it does not exist, -otherwise it is truncated. The stream is positioned at the beginning of -the file. -.TP -.B a -Open for writing. The file is created if it does not exist. The stream is -positioned at the end of the file. -.TP -.B a+ -Open for reading and writing. The file is created if it does not exist. -The stream is positioned at the end of the file. -.PP -The -.I mode -string can also include the letter ``b'' either as a third character or as -a character between the characters in any of the two-character strings -described above. This is strictly for compatibility with ANSI C3.159-1989 -(``ANSI C'') and has no effect; the ``b'' is ignored. Linux may not behave -this way. -.PP -Any created files will have mode -.BR S_IRUSR \&| S_IWUSR \&| S_IRGRP \&| S_IWGRP \&| S_IROTH \&| S_IWOTH -(0666), as modified by the process' umask value (see -.BR umask (2). -.PP -Reads and writes may be intermixed on read/write streams in any order, and -do not require an intermediate seek as in previous versions of -.IR stdio . -This is not portable to other systems, however, and may not work under -Linux (someone should find out and fix this manpage); ANSI C requires that -a file positioning function intervene between output and input, unless an -input operation encounters end-of-file. -.PP -The -.B fdopen -function associates a stream with the existing file descriptor, -.IR fildes . -The -.I mode -of the stream must be compatible with the mode of the file descriptor. -.PP -The -.B freopen -function opens the file whose name is the string pointed to by -.I path -and associates the stream pointed to by -.I stream -with it. The original stream (if it exists) is closed. The -.I mode -argument is used just as in the -.B fopen -function. The primary use of the -.B freopen -function is to change the file associated with a standard text stream -.IR "" ( stderr ", " stdin ", or " stdout ). -.SH "RETURN VALUES" -Upon successful completion -.BR fopen , -.B fdopen -and -.B freopen -return a -.B FILE -pointer. Otherwise, -.B NULL -is returned and the global variable -.I errno -is set to indicate the error. -.SH ERRORS -.TP -.B EINVAL -The -.I mode -provided to -.BR fopen , -.BR fdopen , -or -.B freopen -was invalid. -.PP -The -.BR fopen , -.B fdopen -and -.B freopen -functions may also fail and set -.I errno -for any of the errors specified for the routine -.BR malloc (3). -.PP -The -.B fopen -function may also fail and set -.I errno -for any of the errors specified for the routine -.BR open (2). -.PP -The -.B fdopen -function may also fail and set -.I errno -for any of the errors specified for the routine -.BR fcntl (2). -.PP -The -.B freopen -function may also fail and set -.I errno -for any of the errors specified for the routines -.BR open (2), -.BR fclose (3) -and -.BR fflush (3). -.SH "SEE ALSO" -.BR open "(2), " fclose (3) -.SH STANDARDS -The -.B fopen -and -.B freopen -functions conform to ANSI C3.159-1989 (``ANSI C''). The -.B fdopen -function conforms to IEEE Std1003.1-1988 (``POSIX''). diff --git a/man3/fpathconf.3 b/man3/fpathconf.3 index 8d432c02c5..69a985d04b 100644 --- a/man3/fpathconf.3 +++ b/man3/fpathconf.3 @@ -131,5 +131,5 @@ may exist in the given directory. .PP Some returned vaules may be huge; they are not suitable for allocating memory. -.SH "SEE ALSO" +.SH SEE ALSO .BR getconf "(1), " statfs "(2), " open "(2), " sysconf (3) diff --git a/man3/fprintf.3 b/man3/fprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/fprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/fpurge.3 b/man3/fpurge.3 deleted file mode 100644 index 06ded25c9d..0000000000 --- a/man3/fpurge.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fflush.3 diff --git a/man3/fread.3 b/man3/fread.3 deleted file mode 100644 index 4027135368..0000000000 --- a/man3/fread.3 +++ /dev/null @@ -1,97 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fread.3 6.6 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:37:33 1993, faith@cs.unc.edu -.\" -.TH FREAD 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fread, fwrite \- binary stream input/output -.SH SYNOPSIS -.B #include -.sp -.BI "int fread( void *" ptr ", size_t " size ", size_t " nmemb , -.BI "FILE *" stream ); -.sp -.BI "int fwrite( void *" ptr ", size_t " size ", size_t " nmemb , -.BI "FILE *" stream ); -.SH DESCRIPTION -The function -.B fread -reads -.I nmemb -elements of data, each -.I size -bytes long, from the stream pointed to by -.IR stream , -storing them at the location given by -.IR ptr . -.PP -The function -.B fwrite -writes -.I nmemb -elements of data, each -.I size -bytes long, to the stream pointed to by -.IR stream , -obtaining them from the location given by -.IR ptr . -.SH "RETURN VALUES" -The functions -.B fread -and -.B fwrite -advance the file position indicator for the stream by the number of -characters successfully read or written and return that number. If an -error occurs, or the end-of-file is reached, the return value is a short -character count (or zero). -.PP -The function -.B fread -does not distinguish between end-of-file and error, and callers must use -.BR feof (3) -and -.BR ferror (3) -to determine which occurred. -.SH "SEE ALSO" -.BR read "(2), " write (2) -.SH STANDARDS -The functions -.B fread -and -.B fwrite -conform to ANSI C3.159-1989 (``ANSI C''). diff --git a/man3/freopen.3 b/man3/freopen.3 deleted file mode 100644 index 9a4012491e..0000000000 --- a/man3/freopen.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fopen.3 diff --git a/man3/frexp.3 b/man3/frexp.3 index 349d36d32f..e04abab60c 100644 --- a/man3/frexp.3 +++ b/man3/frexp.3 @@ -26,5 +26,5 @@ times a power of two, and is always in the range 1/2 (inclusive) to zero and zero is stored in \fIexp\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR ldexp "(3), " modf (3) diff --git a/man3/fscanf.3 b/man3/fscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/fscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/fseek.3 b/man3/fseek.3 deleted file mode 100644 index ca1f54902d..0000000000 --- a/man3/fseek.3 +++ /dev/null @@ -1,169 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fseek.3 6.11 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu -.\" -.TH FSEEK 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fgetpos, fseek, fsetpos, ftell, rewind \- reposition a stream -.SH SYNOPSIS -.B #include -.sp -.BI "int fseek( FILE *" stream ", long " offset ", int" whence ); -.br -.BI "long ftell( FILE *" stream ); -.br -.BI "void rewind( FILE *" stream ); -.br -.BI "int fgetpos( FILE *" stream ", fpos_t *" pos ); -.br -.BI "int fsetpos( FILE *" stream ", fpos_t *" pos ); -.SH DESCRIPTION -The -.B fseek -function sets the file position indicator for the stream pointed to by -.IR stream . -The new position, measured in bytes, is obtained by adding -.I offset -bytes to the position specified by -.IR whence . -If -.I whence -is set to -.BR SEEK_SET , -.BR SEEK_CUR , -or -.BR SEEK_END , -the offset is relative to the start of the file, the current position -indicator, or end-of-file, respectively. A successful call to the -.B fseek -function clears the end-of-file indicator for the stream and undoes -any effects of the -.BR ungetc (3) -function on the same stream. -.PP -The -.B ftell -function obtains the current value of the file position indicator for the -stream pointed to by -.IR stream . -.PP -The -.B rewind -function sets the file position indicator for the stream pointed to by -.I stream -to the beginning of the file. It is equivalent to: -.PP -.RS -(void)fseek(stream, 0L, SEEK_SET) -.RE -.PP -except that the error indicator for the stream is also cleared (see -.BR clearerr (3). -.PP -The -.B fgetpos -and -.B fsetpos -functions are alternate interfaces equivalent to -.B ftell -and -.B fseek -(with whence set to -.BR SEEK_SET ), -setting and storing the current value of the file offset into or from the -object referenced by -.IR pos . -On some non-UNIX systems an -.B fpos_t -object may be a complex object and these routines may be the only way to -portably reposition a text stream. -.SH "RETURN VALUES" -The -.B rewind -function returns no value. Upon successful completion, -.BR fgetpos , -.BR fseek , -.B fsetpos -return 0, -and -.B ftell -returns the current offset. Otherwise, \-1 is returned and the global -variable errno is set to indicate the error. -.SH ERRORS -.TP -.B EBADF -The -.I stream -specified is not a seekable stream. -.TP -.B EINVAL -The -.I whence -argument to -.B fseek -was not -.BR SEEK_SET , -.BR SEEK_END , -or -.BR SEEK_CUR . -.PP -The function -.BR fgetpos , -.BR fseek , -.BR fsetpos , -and -.B ftell -may also fail and set -.I errno -for any of the errors specified for the routines -.BR fflush (3), -.BR fstat (2), -.BR lseek (2), -and -.BR malloc (3). -.SH "SEE ALSO" -.BR lseek (2) -.SH STANDARDS -The -.BR fgetpos , -.BR fsetpos , -.BR fseek , -.BR ftell , -and -.BR rewind -functions conform to ANSI C3.159-1989 (``ANSI C''). diff --git a/man3/fsetpos.3 b/man3/fsetpos.3 deleted file mode 100644 index a1487b5a8c..0000000000 --- a/man3/fsetpos.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fseek.3 diff --git a/man3/ftell.3 b/man3/ftell.3 deleted file mode 100644 index a1487b5a8c..0000000000 --- a/man3/ftell.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fseek.3 diff --git a/man3/ftok.3 b/man3/ftok.3 deleted file mode 100644 index b16dfe7da1..0000000000 --- a/man3/ftok.3 +++ /dev/null @@ -1,63 +0,0 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH FTOK 3 "November 1, 1993" "Linux 0.99.13" "Linux Programmer's Manual" -.SH NAME -ftok \- convert a pathname and a project identifier to a System V IPC key -.SH SYNOPSIS -.nf -.B -# include -.B -# include -.fi -.sp -.BI "key_t ftok ( char *" pathname , -.BI "char " proj " )" -.SH DESCRIPTION -The function converts the pathname of an existing accessible -file and a project identifier into a -.B key_t -type System V IPC key. -.SH "RETURN VALUE" -On success the return value will be the converted -.B key_t -value, -otherwise -.B \-1 -with -.B errno -indicating the error as for the -.BR stat (2) -system call. -.SH BUGS -The generated -.B key_t -value is obtained -.BR stat \-ing -the disk file correspondig to -.I pathname -in order to get its i\-node number and the minor device number of the -filesystem on which the disk file resides, -then by combining the 8 bit -.I proj -value along with the the lower 16 bits of the i\-node number, -along with the 8 bits of the minor device number. -The algorithm does not guarantee a unique key value. -In fact -.IP \(bu -Two different names linking to the same file produce same -key values. -.IP \(bu -Using the lower 16 bits of the i\-node number, gives some -chance (also usually small) to have same key values for file names -referring to different i\-nodes. -.IP \(bu -Not discriminating among major device numbers, -gives some chance of collision (also usually small) for -systems with multiple disk controllers. -.SH "SEE ALSO" -.BR ipc (5), -.BR msgget (2), -.BR semget (2), -.BR shmget (2), -.BR stat (2). diff --git a/man3/fwrite.3 b/man3/fwrite.3 deleted file mode 100644 index 86906ede50..0000000000 --- a/man3/fwrite.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fread.3 diff --git a/man3/gcvt.3 b/man3/gcvt.3 index 7f477adb87..d52ca95280 100644 --- a/man3/gcvt.3 +++ b/man3/gcvt.3 @@ -21,5 +21,5 @@ terminated ASCII string and stores the result in \fIbuf\fP. It produces .SH "RETURN VALUE" The \fBgcvt()\fP function returns the address of the string pointed to by \fIbuf\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR ecvt "(3), " fcvt "(3), " sprintf (3) diff --git a/man3/getcwd.3 b/man3/getcwd.3 index 647a7ab491..15f2cca137 100644 --- a/man3/getcwd.3 +++ b/man3/getcwd.3 @@ -80,5 +80,5 @@ set accordingly, and on success. .SH "CONFORMS TO" POSIX.1 -.SH "SEE ALSO" +.SH SEE ALSO .BR chdir "(2), ", free "(3), " malloc (3) diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index 3fd309245b..9154c629fa 100644 --- a/man3/getdirentries.3 +++ b/man3/getdirentries.3 @@ -31,10 +31,10 @@ is updated with the new position after reading. .SH "RETURN VALUE" .B getdirentries returns the number of bytes read or zero when at the end of the directory. -If an error occurs, \-1 is returned, and +If an error occurs, -1 is returned, and .I errno is set appropriately. .SH ERRORS See the Linux library source code for details. -.SH "SEE ALSO" +.SH SEE ALSO .BR open "(2), " lseek (2) diff --git a/man3/getenv.3 b/man3/getenv.3 index 71ec2bcbf7..9ea2733b3b 100644 --- a/man3/getenv.3 +++ b/man3/getenv.3 @@ -23,5 +23,5 @@ The \fBgetenv()\fP function returns a pointer to the value in the environment, or NULL if there is no match. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR putenv "(3), " setenv "(3), " unsetenv (3) diff --git a/man3/getgrent.3 b/man3/getgrent.3 index f20b10756f..f8d577b41c 100644 --- a/man3/getgrent.3 +++ b/man3/getgrent.3 @@ -56,5 +56,5 @@ Insufficient memory to allocate group information structure. .fi .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetgrent "(3), " getgrnam "(3), " getgrgid (3) diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index e431506830..df1ff9afeb 100644 --- a/man3/getgrnam.3 +++ b/man3/getgrnam.3 @@ -54,5 +54,5 @@ Insufficient memory to allocate group information structure. .fi .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetgrent "(3), " getgrent "(3), " setgrent "(3), " endgrent (3) diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index 2ad96f5ab7..d2ce471d2d 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -120,5 +120,5 @@ later. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR resolver "(3), " hosts "(5), " hostname "(7), " resolv+ " (8), " named (8) diff --git a/man3/getmntent.3 b/man3/getmntent.3 index cea8a721c3..0337c62098 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -85,5 +85,5 @@ a match is found and NULL otherwise. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fopen "(3), " fstab (5) diff --git a/man3/getnetent.3 b/man3/getnetent.3 index b45548ebbc..210f018403 100644 --- a/man3/getnetent.3 +++ b/man3/getnetent.3 @@ -81,5 +81,5 @@ error occurs or the end of the file is reached. /etc/networks networks database file .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getprotoent "(3), " getservent "(3), " networks (5) diff --git a/man3/getopt.3 b/man3/getopt.3 index 1742188bb3..c3ba2f3639 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -105,7 +105,7 @@ The .B getopt() function returns the option character if the option was found successfully, ':' if there was a missing parameter for one of the -options, '?' for an unknown option character and \-1 for the end of the +options, '?' for an unknown option character and -1 for the end of the option list. .SH "EXAMPLE" The following example program, from the source code, illustrates the diff --git a/man3/getpass.3 b/man3/getpass.3 deleted file mode 100644 index 9aa699ae6f..0000000000 --- a/man3/getpass.3 +++ /dev/null @@ -1,82 +0,0 @@ -.\" Copyright (c) 1989, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)getpass.3 6.5 (Berkeley) 5/21/91 -.\" -.\" Converted for Linux, Mon Nov 29 14:41:51 1993, faith@cs.unc.edu -.\" -.TH PRINTF 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -getpass \- get a password -.SH SYNOPSIS -.B #include -.br -..B #include -.sp -.B "char *getpass( const char *" prompt ); -.SH DESCRIPTION -The -.B getpass -function displays a prompt to, and reads in a password from, -.IR /dev/tty . -If this file is not accessible, -.B getpass -displays the prompt on the standard error output and reads from the -standard input. -.PP -The password may be up to _PASSWORD_LEN (currently 128) characters in -length. Any additional characters and the terminating newline character -are discarded. (This may be different in Linux.) -.PP -.B Getpass -turns off character echoing while reading the password. -.PP -.SH "RETURN VALUES" -.B Getpass -returns a pointer to the null terminated password. -.SH FILES -.I /dev/tty -.SH "SEE ALSO" -.BR crypt (3) -.SH HISTORY -A -.B getpass -function appeared in Version 7 AT&T UNIX. -.SH BUGS -The -.B getpass -function leaves its result in an internal static object and returns a -pointer to that object. Subsequent calls to -.B getpass -will modify the same object. -.PP -The calling process should zero the password as soon as possible to avoid -leaving the cleartext password visible in the process's address space. diff --git a/man3/getprotoent.3 b/man3/getprotoent.3 index b92d7cac59..b9e1dabb6d 100644 --- a/man3/getprotoent.3 +++ b/man3/getprotoent.3 @@ -78,5 +78,5 @@ error occurs or the end of the file is reached. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getservent "(3), " getnetent "(3), " protocols (5) diff --git a/man3/getpw.3 b/man3/getpw.3 index 7fbd56799c..9e23f7b240 100644 --- a/man3/getpw.3 +++ b/man3/getpw.3 @@ -42,7 +42,7 @@ struct passwd { .fi .RE .SH "RETURN VALUE" -The \fBgetpw()\fP function returns 0 on success, or \-1 if an error +The \fBgetpw()\fP function returns 0 on success, or -1 if an error occurs. .SH ERRORS .TP @@ -52,6 +52,6 @@ Insufficient memory to allocate passwd structure. .nf /etc/passwd password database file .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent "(3), " getpwent "(3), " setpwent "(3), " endpwent (3), .BR getpwnam "(3), " getpwuid "(3), " putpwent (3) diff --git a/man3/getpwent.3 b/man3/getpwent.3 index b3a873fcec..bed499522f 100644 --- a/man3/getpwent.3 +++ b/man3/getpwent.3 @@ -60,6 +60,6 @@ Insufficient memory to allocate passwd structure. .fi .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent "(3), " getpwnam "(3), " getpwuid "(3), " getpw (3), .BR putpwent (3) diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index 048e85aa2c..4ecf395407 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -56,6 +56,6 @@ Insufficient memory to allocate passwd structure. .fi .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent "(3), " getpwent "(3), " setpwent "(3), " endpwent (3), .BR getpw "(3), " putpwent (3) diff --git a/man3/gets.3 b/man3/gets.3 index e149355545..f18c812239 100644 --- a/man3/gets.3 +++ b/man3/gets.3 @@ -125,6 +125,6 @@ library with low - level calls to .B read() for the file descriptor associated with the input stream; the results will be undefined and very probably not what you want. -.SH "SEE ALSO" +.SH SEE ALSO .BR read "(2), " write "(2), " fopen "(3), " fread (3), .BR scanf "(3), " puts "(3), " fseek "(3), " ferror (3) diff --git a/man3/getservent.3 b/man3/getservent.3 index 19ae01f363..6fd6c10d5a 100644 --- a/man3/getservent.3 +++ b/man3/getservent.3 @@ -81,5 +81,5 @@ error occurs or the end of the file is reached. /etc/services services database file .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getprotoent "(3), " getnetent "(3), " services (5) diff --git a/man3/getusershell.3 b/man3/getusershell.3 index 16adb62edc..5d43d8059c 100644 --- a/man3/getusershell.3 +++ b/man3/getusershell.3 @@ -36,5 +36,5 @@ The \fBgetusershell()\fP function returns a NULL pointer on end-of-file. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR shells (5) diff --git a/man3/glob.3 b/man3/glob.3 index c3f19a923c..93777bbb1a 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -174,6 +174,6 @@ These will store their error code in .PP POSIX.2 is not yet an approved standard; the information in this manpage is subject to change. -.SH "SEE ALSO" +.SH SEE ALSO .BR ls "(1), " sh "(1), " exec "(2), " stat "(2), " malloc (3), .BR opendir "(3), " readdir "(3), " wordexp "(3), " glob (7) diff --git a/man3/hypot.3 b/man3/hypot.3 index f3f56eb3e2..d17aae18ac 100644 --- a/man3/hypot.3 +++ b/man3/hypot.3 @@ -19,5 +19,5 @@ The \fBhypot()\fP function returns the sqrt(x*x + y*y). This is the length of the hypotenuse of a right-angle triangle with sides of length \fIx\fP and \fIy\fP, or the distance of the point (x, y) from the origin. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR sqrt (3) diff --git a/man3/index.3 b/man3/index.3 index 2c4125bedc..6fc4a0f17c 100644 --- a/man3/index.3 +++ b/man3/index.3 @@ -31,6 +31,6 @@ The \fBindex()\fP and \fBrindex()\fP functions return a pointer to the matched character or NULL if the character is not found. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR memchr "(3), " strchr "(3), " strpbrk "(3), " strrchr (3), .BR strsep "(3), " strspn "(3), " strstr "(3), " strtok (3) diff --git a/man3/inet.3 b/man3/inet.3 index a253b4115b..033977a0d0 100644 --- a/man3/inet.3 +++ b/man3/inet.3 @@ -30,11 +30,11 @@ inet_netof \- Internet address manipulation routines .SH DESCRIPTION The \fBinet_addr()\fP function converts the Internet host address \fIcp\fP from numbers-and-dots notation into binary data in network -byte order. If the input is invalid, \-1 is returned. +byte order. If the input is invalid, -1 is returned. .PP The \fBinet_network()\fP function extracts the network number in network byte order from the address \fIcp\fP in numbers-and-dots -notation. If the input is invalid, \-1 is returned. +notation. If the input is invalid, -1 is returned. .PP The \fBinet_ntoa()\fP function converts the Internet host address \fIin\fP given in network byte order to a string in standard @@ -74,5 +74,5 @@ first, whereas the network byte order, as used on the Internet, is Most Significant Byte first. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostbyname "(3), " getnetent "(3), " hosts "(5), " networks (5) diff --git a/man3/initgroups.3 b/man3/initgroups.3 index 3a9a3f4934..20e14672c5 100644 --- a/man3/initgroups.3 +++ b/man3/initgroups.3 @@ -21,7 +21,7 @@ reading the group database \fI/etc/group\fP and using all groups of which \fIuser\fP is a member. The additional group \fIgroup\fP is also added to the list. .SH "RETURN VALUE" -The \fBinitgroups()\fP function returns 0 on success, or \-1 if an error +The \fBinitgroups()\fP function returns 0 on success, or -1 if an error occurs. .SH "ERRORS" .TP @@ -36,5 +36,5 @@ Insufficient memory to allocate group information structure. .fi .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getgroups "(2), " setgroups (2) diff --git a/man3/isinf.3 b/man3/isinf.3 index 58235420ee..b0e2b7146d 100644 --- a/man3/isinf.3 +++ b/man3/isinf.3 @@ -19,7 +19,7 @@ isinf, isnan, finite \- test for infinity or not-a-number (NaN) .BI "int finite(double " value ); .fi .SH DESCRIPTION -The \fBisinf()\fP function returns \-1 if \fIvalue\fP represents negative +The \fBisinf()\fP function returns -1 if \fIvalue\fP represents negative infinity, 1 if \fIvalue\fP represents positive infinity, and 0 otherwise. .PP The \fBisnan()\fP function returns a non-zero value if \fIvalue\fP is diff --git a/man3/j0.3 b/man3/j0.3 index 5db5cd2302..4d6a7fa819 100644 --- a/man3/j0.3 +++ b/man3/j0.3 @@ -35,9 +35,9 @@ returns the Bessel function of \fIx\fP of the second kind of order \fIn\fP. .PP For the functions \fBy0()\fP, \fBy1()\fP and \fByn()\fP, the value of \fIx\fP must be positive. For negative values of \fIx\fP, these functions return -\-HUGE_VAL. +-HUGE_VAL. .SH "CONFORMING TO" SVID 3, BSD 4.3 .SH BUGS -There are errors of up to 2e\-16 in the values returned by \fBj0()\fP, -\fBj1()\fP and \fBjn()\fP for values of \fIx\fP between \-8 and 8. +There are errors of up to 2e-16 in the values returned by \fBj0()\fP, +\fBj1()\fP and \fBjn()\fP for values of \fIx\fP between -8 and 8. diff --git a/man3/jrand48.3 b/man3/jrand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/jrand48.3 +++ b/man3/jrand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3 \ No newline at end of file diff --git a/man3/killpg.3 b/man3/killpg.3 index 138247dd62..a394c49d9d 100644 --- a/man3/killpg.3 +++ b/man3/killpg.3 @@ -46,5 +46,5 @@ process the signal ist sent to, and the userid is not that of the superuser. .SH "CONFORMS TO" ??? -.SH "SEE ALSO" +.SH SEE ALSO .BR kill "(2), " signal "(2), " signal (7) diff --git a/man3/labs.3 b/man3/labs.3 index 5bbeeeee69..51399fce8f 100644 --- a/man3/labs.3 +++ b/man3/labs.3 @@ -26,5 +26,5 @@ SVID 3, BSD 4.3, ISO 9899 .SH NOTES Trying to take the absolute value of the most negative integer is not defined. -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " ceil "(3), " floor "(3), " fabs "(3), " rint (3) diff --git a/man3/lcong48.3 b/man3/lcong48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/lcong48.3 +++ b/man3/lcong48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3 \ No newline at end of file diff --git a/man3/ldexp.3 b/man3/ldexp.3 index 971d1101a4..795dccae6c 100644 --- a/man3/ldexp.3 +++ b/man3/ldexp.3 @@ -19,5 +19,5 @@ The \fBldexp()\fP function returns the result of multiplying the floating-point number \fIx\fP by 2 raised to the power \fIexp\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR frexp "(3), " modf (3) diff --git a/man3/ldiv.3 b/man3/ldiv.3 index 54fec47154..0ddfd11f68 100644 --- a/man3/ldiv.3 +++ b/man3/ldiv.3 @@ -23,5 +23,5 @@ contains two long integer members named \fIquot\fP and \fIrem\fP. The \fIldiv_t\fP structure. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR div (3) diff --git a/man3/lgamma.3 b/man3/lgamma.3 index 94751c0b1c..9c0e8e73cd 100644 --- a/man3/lgamma.3 +++ b/man3/lgamma.3 @@ -27,5 +27,5 @@ and \fIerrno\fP is set to ERANGE. Invalid argument - negative integer value of \fIx\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR infnan (3) diff --git a/man3/localeconv.3 b/man3/localeconv.3 index f593b9fd8f..9a2816927a 100644 --- a/man3/localeconv.3 +++ b/man3/localeconv.3 @@ -30,6 +30,6 @@ Support for other locales will be there Real Soon Now. The .B printf() family of functions may or may not honour the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR locale "(1), " localedef "(1), " strcoll "(3), " isalpha (3), .BR setlocale "(3), " strftime "(3), " locale (7) diff --git a/man3/lrand48.3 b/man3/lrand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/lrand48.3 +++ b/man3/lrand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3 \ No newline at end of file diff --git a/man3/malloc.3 b/man3/malloc.3 index b0b8fed840..84255bf4bf 100644 --- a/man3/malloc.3 +++ b/man3/malloc.3 @@ -92,5 +92,5 @@ or if the request fails or if size was equal to 0. .SH "CONFORMS TO" ANSI - C -.SH "SEE ALSO" +.SH SEE ALSO .BR brk (2) diff --git a/man3/mblen.3 b/man3/mblen.3 index 39fa80cb4c..ce1889816a 100644 --- a/man3/mblen.3 +++ b/man3/mblen.3 @@ -26,9 +26,9 @@ mbtowc((wchat_t *)0, s, n); except that the shift state of the \fBmbtowc()\fP function is not affected. .SH "RETURN VALUE" -The \fBmblen()\fP returns the number of bytes in a character or \-1 if +The \fBmblen()\fP returns the number of bytes in a character or -1 if the character is invalid or 0 if \fIs\fP is a NULL string. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mbstowcs "(3), " mbtowc "(3), " wcstombs "(3), " wctomb (3) diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index 2df5e3cc02..83144d69ba 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -19,9 +19,9 @@ The \fBmbstowcs()\fP function converts a sequence of multibyte characters from the array \fIs\fP into a sequence of wide characters and stores up to \fIn\fP wide characters in the array \fIpwcs\fP. .SH "RETURN VALUE" -\fBmbstowcs()\fP returns the number of wide characters stored or \-1 if +\fBmbstowcs()\fP returns the number of wide characters stored or -1 if \fIs\fP contains an invalid multibyte character. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mblen "(3), " mbtowc "(3), " wcstombs "(3), " wctomb (3) diff --git a/man3/mbtowc.3 b/man3/mbtowc.3 index 08db293546..64144618a6 100644 --- a/man3/mbtowc.3 +++ b/man3/mbtowc.3 @@ -20,8 +20,8 @@ which is no longer than \fIn\fP bytes, into a wide character and, if \fIpwc\fP is not NULL, stores the wide character in \fIpwc\fP. .SH "RETURN VALUE" \fBmbtowc()\fP returns the number of bytes in the multibyte character -or \-1 if the multibyte character is not valid. +or -1 if the multibyte character is not valid. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mblen "(3), " mbstowcs "(3), " wcstombs "(3), " wctomb (3) diff --git a/man3/memccpy.3 b/man3/memccpy.3 index 4a58bdc97c..4dd2247c44 100644 --- a/man3/memccpy.3 +++ b/man3/memccpy.3 @@ -24,5 +24,5 @@ in \fIdest\fP after \fIc\fP, or NULL if \fIc\fP was not found in the first \fIn\fP characters of \fIsrc\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memcpy "(3), " memmove "(3), " strcpy "(3), " strncpy (3) diff --git a/man3/memchr.3 b/man3/memchr.3 index 194e9e3bb2..6648126e39 100644 --- a/man3/memchr.3 +++ b/man3/memchr.3 @@ -24,6 +24,6 @@ The \fBmemchr()\fP function returns a pointer to the matching byte or NULL if the character does not occur in the given memory area. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " rindex "(3), " strchr "(3), " strpbrk (3), .BR strrchr "(3), " strsep "(3), " strspn "(3), " strstr (3) diff --git a/man3/memcmp.3 b/man3/memcmp.3 index 9ed847be4a..d7572b63d3 100644 --- a/man3/memcmp.3 +++ b/man3/memcmp.3 @@ -26,6 +26,6 @@ respectively, to be less than, to match, or be greater than the first \fIn\fP bytes of \fIs2\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " strcasecmp "(3), " strcmp "(3), " strcoll (3), .BR strncmp "(3), " strncasecmp (3) diff --git a/man3/memcpy.3 b/man3/memcpy.3 index b29341c1a1..d048b928ec 100644 --- a/man3/memcpy.3 +++ b/man3/memcpy.3 @@ -22,5 +22,5 @@ overlap. Use \fBmemmove\fP(3) if the memory areas do overlap. The \fBmemcpy()\fP function returns a pointer to \fIdest\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memccpy "(3), " memmove "(3), " strcpy "(3), " strncpy (3) diff --git a/man3/memfrob.3 b/man3/memfrob.3 index 9bd72a6add..1a2b46315a 100644 --- a/man3/memfrob.3 +++ b/man3/memfrob.3 @@ -28,5 +28,5 @@ area. .SH "CONFORMING TO" The \fBmemfrob()\fP function is unique to the Linux C Library and GNU C Library. -.SH "SEE ALSO" +.SH SEE ALSO .BR strfry (3) diff --git a/man3/memmem.3 b/man3/memmem.3 index eaeb3441ea..c783c55000 100644 --- a/man3/memmem.3 +++ b/man3/memmem.3 @@ -23,5 +23,5 @@ of length \fIhaystacklen\fP. .SH "RETURN VALUE" The \fBmemmem()\fP function returns a pointer to the beginning of the substring, or NULL if the substring is not found. -.SH "SEE ALSO" +.SH SEE ALSO .BR strstr (3) diff --git a/man3/memmove.3 b/man3/memmove.3 index fc9d62aab6..83bd125ed7 100644 --- a/man3/memmove.3 +++ b/man3/memmove.3 @@ -21,5 +21,5 @@ The \fBmemmove()\fP function copies \fIn\fP bytes from memory area The \fBmemmove()\fP function returns a pointer to \fIdest\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memccpy "(3), " memcpy "(3), " strcpy "(3), " strncpy (3) diff --git a/man3/memset.3 b/man3/memset.3 index e03019b99e..49d1f535a6 100644 --- a/man3/memset.3 +++ b/man3/memset.3 @@ -22,5 +22,5 @@ The \fBmemset()\fP function returns a pointer to the memory area \fIs\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bzero "(3), " swab (3) diff --git a/man3/mkstemp.3 b/man3/mkstemp.3 index ba1e31e8da..0af4bb3fdf 100644 --- a/man3/mkstemp.3 +++ b/man3/mkstemp.3 @@ -32,5 +32,5 @@ The last six characters of \fItemplate\fP were not XXXXXX. The temporary file is not unique. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR mktemp "(3), " tmpnam "(3), " tempnam "(3), " tmpfile (3) diff --git a/man3/mktemp.3 b/man3/mktemp.3 index dc1807c771..8953eaa63c 100644 --- a/man3/mktemp.3 +++ b/man3/mktemp.3 @@ -28,5 +28,5 @@ success, and NULL on failure. The last six characters of \fItemplate\fP were not XXXXXX. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR mkstemp "(3), " tmpnam "(3), " tempnam "(3), " tmpfile (3) diff --git a/man3/modf.3 b/man3/modf.3 index 5a7edfa7d8..85db281e02 100644 --- a/man3/modf.3 +++ b/man3/modf.3 @@ -23,5 +23,5 @@ The integral part is stored in \fIiptr\fP. The \fBmodf()\fP function returns the fractional part of \fIx\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR frexp "(3), " ldexp (3) diff --git a/man3/mrand48.3 b/man3/mrand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/mrand48.3 +++ b/man3/mrand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3 \ No newline at end of file diff --git a/man3/nrand48.3 b/man3/nrand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/nrand48.3 +++ b/man3/nrand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3 \ No newline at end of file diff --git a/man3/on_exit.3 b/man3/on_exit.3 index 7eed9b37c8..0240956df9 100644 --- a/man3/on_exit.3 +++ b/man3/on_exit.3 @@ -26,6 +26,6 @@ to and the \fIarg\fP argument from \fBon_exit()\fP. .SH "RETURN VALUE" The \fBon_exit()\fP function returns the value 0 if successful; otherwise -the value \-1 is returned. -.SH "SEE ALSO" +the value -1 is returned. +.SH SEE ALSO .BR exit "(3), " atexit (3) diff --git a/man3/opendir.3 b/man3/opendir.3 index f94133c4e9..c460c45e95 100644 --- a/man3/opendir.3 +++ b/man3/opendir.3 @@ -42,6 +42,6 @@ Insufficient memory to complete the operation. \fIname\fP is not a directory. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR open "(2), " readdir "(3), " closedir "(3), " rewinddir (3), .BR seekdir "(3), " telldir "(3), " scandir (3) diff --git a/man3/pclose.3 b/man3/pclose.3 deleted file mode 100644 index 663d4a0815..0000000000 --- a/man3/pclose.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/popen.3 diff --git a/man3/popen.3 b/man3/popen.3 deleted file mode 100644 index 06f722f3c2..0000000000 --- a/man3/popen.3 +++ /dev/null @@ -1,146 +0,0 @@ -.\" Copyright 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)popen.3 6.4 (Berkeley) 4/30/91 -.\" -.\" Converted for Linux, Mon Nov 29 14:45:38 1993, faith@cs.unc.edu -.\" -.TH POPEN 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -popen, pclose \- process I/O -.SH SYNOPSIS -.B #include -.br -.BI "FILE *popen( const char *" command ", const char *" type ); -.br -.BI "int pclose( FILE *" stream ); -.SH DESCRIPTION -The -.B popen -function opens a process by creating a pipe, forking, and invoking the -shell. Since a pipe is by definition unidirectional, the -.I type -argument may specify only reading or writing, not both; the resulting -stream is correspondingly read-only or write-only. -.PP -The -.I command -argument is a pointer to a null-terminated string containing a shell -command line. This command is passed to -.I /bin/sh -using the -.B \-c -flag; interpretation, if any, is performed by the shell. The -.I mode -argument is a pointer to a null-terminated string which must be either `r' -for reading or `w' for writing. -.PP -The return value from -.B popen -is a normal standard I/O stream in all respects save that it must be closed -with -.B pclose -rather than -.BR fclose . -Writing to such a stream writes to the standard input of the command; the -command's standard output is the same as that of the process that called -.BR popen , -unless this is altered by the command itself. Conversely, reading from a -``popened'' stream reads the command's standard output, and the command's -standard input is the same as that of the process that called -.BR popen . -.PP -Note that output -.B popen -streams are fully buffered by default. -.PP -The -.B pclose -function waits for the associated process to terminate and returns the exit -status of the command as returned by -.BR wait4 . -.SH "RETURN VALUE" -The -.B popen -function returns -.B NULL -if the -.BR fork (2) -or -.BR pipe (2) -calls fail, or if it cannot allocate memory. -.PP -The -.B pclose -function returns \-1 if -.I stream -is not associated with a ``popened'' command, if -.I stream -already ``pclosed'', or if -.B wait4 -returns an error. -.SH ERRORS -The -.B popen -function does not reliably set -.IR errno . -(Is this true for Linux?) -.SH "SEE ALSO" -.BR fork "(2), " sh "(1), " pipe "(2), " wait4 "(2), " fflush "(3), " -.BR fclose "(3), " fopen "(3), " stdio "(3), " system (3) -.SH BUGS -Since the standard input of a command opened for reading shares its seek -offset with the process that called -.BR popen , -if the original process has done a buffered read, the command's input -position may not be as expected. Similarly, the output from a command -opened for writing may become intermingled with that of the original -process. The latter can be avoided by calling -.BR fflush (3) -before -.BR popen . -.PP -Failure to execute the shell is indistinguishable from the shell's failure -to execute command, or an immediate exit of the command. The only hint is -an exit status of 127. (Is this true under Linux?) -.PP -The -.B popen -argument always calls -.BR sh , -never calls -.BR csh . -.SH HISTORY -A -.B popen -and a -.B pclose -function appeared in Version 7 AT&T UNIX. diff --git a/man3/printf.3 b/man3/printf.3 deleted file mode 100644 index 5f347822f6..0000000000 --- a/man3/printf.3 +++ /dev/null @@ -1,507 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)printf.3 6.14 (Berkeley) 7/30/91 -.\" -.\" Converted for Linux, Mon Nov 29 12:06:07 1993, faith@cs.unc.edu -.\" -.TH PRINTF 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -printf, fprintf, sprintf, vprintf, vfprintf, vsprintf \- formatted output conversion -.SH SYNOPSIS -.B #include -.sp -.BI "int printf( const char *" format ", ...);" -.br -.BI "int fprintf( FILE *" stream ", const char *" format ", ...);" -.br -.BI "int sprintf( char *" str ", const char *" format ", ...);" -.sp -.B #include -.sp -.BI "int vprintf( const char *" format ", va_list " ap ); -.br -.BI "int vfprintf( FILE *" stream ", const char *" format ", va_list " ap ); -.br -.BI "int vsprintf( char *" str ", char *" format ", va_list " ap ); -.SH DESCRIPTION -The -.B printf -family of functions produces output according to a -.I format -as described below. -.B Printf -and -.B vprintf -write output to -.IR stdout , -the standard output stream; -.B fprintf -and -.B vfprintf -write output to the given output -.IR stream ; -.BR sprintf , -and -.BR vsprintf -write to the character string -.IR str . -These functions write the output under the control of a -.I format -string that specifies how subsequent arguments (or arguments accessed via -the variable-length argument facilities of -.BR stdarg (3) -are converted for output. These functions return the number of characters -printed (not including the trailing `\e0' used to end output to strings). -.PP -The format string is composed of zero or more directives: ordinary -characters (not -.BR % ), -which are copied unchanged to the output stream; -and conversion specifications, each of which results in fetching zero or -more subsequent arguments. Each conversion specification is introduced by -the character -.BR % . -The arguments must correspond properly (after type promotion) with the -conversion specifier. After the -.BR % , -the following appear in sequence: -.TP -.B \(bu -Zero or more of the following flags: -.RS -.TP -.B # -specifying that the value should be converted to an ``alternate form''. -For -.BR c , -.BR d , -.BR i , -.BR n , -.BR p , -.BR s , -and -.BR u -conversions, this option has no effect. For -.BR o -conversions, the precision of the number is increased to force the first -character of the output string to a zero (except if a zero value is printed -with an explicit precision of zero). -For -.B x -and -.B X -conversions, a non-zero result has the string `0x' (or `0X' for -.B X -conversions) prepended to it. For -.BR e , -.BR E , -.BR f , -.BR g , -and -.B G -conversions, the result will always contain a decimal point, even if no -digits follow it (normally, a decimal point appears in the results of those -conversions only if a digit follows). For -.B g -and -.B G -conversions, trailing zeros are not removed from the result as they would -otherwise be. -.TP -.B \&0 -specifying zero padding. For all conversions except -.BR n , -the converted value is padded on the left with zeros rather than blanks. -If a precision is given with a numeric conversion -.BR "" ( d , -.BR i , -.BR o , -.BR u , -.BR i , -.BR x , -and -.BR X ), -the -.B \&0 -flag is ignored. -.TP -.B \- -(a negative field width flag) indicates the converted value is to be left -adjusted on the field boundary. Except for -.B n -conversions, the converted value is padded on the right with blanks, rather -than on the left with blanks or zeros. A -.B \- -overrides a -.B \&0 -if both are given. -.TP -.B "" -(a space) specifying that a blank should be left before a positive number -produced by a signed conversion -.BR "" ( d , -.BR e , -.BR E , -.BR f , -.BR g , -.BR G , -or -.BR i ). -.TP -.B + -specifying that a sign always be placed before a number produced by a -signed conversion. A -.B + -overrides a space if both are used. -.RE -.TP -.B \(bu -An optional decimal digit string specifying a minimum field width. If the -converted value has fewer characters than the field width, it will be -padded with spaces on the left (or right, if the left-adjustment flag has -been given) to fill out the field width. -.TP -.B \(bu -An optional precision, in the form of a period (`\&.') followed by an -optional digit string. If the digit string is omitted, the precision is -taken as zero. This gives the minimum number of digits to appear for -.BR d , -.BR i , -.BR o , -.BR u , -.BR x , -and -.B X -conversions, the number of digits to appear after the decimal-point for -.BR e , -.BR E , -and -.B f -conversions, the maximum number of significant digits for -.B g -and -.B G -conversions, or the maximum number of characters to be printed from a -string for -.B s -conversions. -.TP -.B \(bu -The optional character -.BR h , -specifying that a following -.BR d , -.BR i , -.BR o , -.BR u , -.BR x , -or -.BR X -conversion corresponds to a -.I short int -or -.I unsigned short int -argument, or that a following -.B n -conversion corresponds to a pointer to a -.I short int -argument. -.TP -.B \(bu -The optional character -.B l -(ell) specifying that a following -.BR d , -.BR i , -.BR o , -.BR u , -.BR x , -or -.BR X -conversion applies to a pointer to a -.I long int -or -.I unsigned long int -argument, or that a following -.B n -conversion corresponds to a pointer to a -.I long int -argument. -.TP -.B \(bu -The character -.BR L -specifying that a following -.BR e , -.BR E , -.BR f , -.BR g , -or -.B G -conversion corresponds to a -.I long double -argument. -.TP -.B \(bu -A character that specifies the type of conversion to be applied. -.PP -A field width or precision, or both, may be indicated by an asterisk `*' -instead of a digit string. In this case, an -.I int -argument supplies the field width or precision. A negative field width is -treated as a left adjustment flag followed by a positive field width; a -negative precision is treated as though it were missing. -.PP -The conversion specifiers and their meanings are: -.TP -.B diouxX -The -.I int -(or appropriate variant) argument is converted to signed decimal -.BR "" ( d -and -.BR i ), -unsigned octal -.BR "" ( o , -unsigned decimal -.BR "" ( u , -or unsigned hexadecimal -.BR "" ( x -and -.BR X ) -notation. The letters -.B abcdef -are used for -.B x -conversions; the letters -.B ABCDEF -are used for -.B X -conversions. The precision, if any, gives the minimum number of digits -that must appear; if the converted value requires fewer digits, it is -padded on the left with zeros. -.TP -.B DOU -The -.I long int -argument is converted to signed decimal, unsigned octal, or unsigned -decimal, as if the format had been -.BR ld , -.BR lo , -or -.B lu -respectively. These conversion characters are deprecated, and will -eventually disappear. -.TP -.B eE -The -.I double -argument is rounded and converted in the style -.BR "" [\-]d \&. ddd e \\*(Pmdd -where there is one digit before the decimal-point character and the number -of digits after it is equal to the precision; if the precision is missing, -it is taken as 6; if the precision is zero, no decimal-point character -appears. An -.B E -conversion uses the letter -.B E -(rather than -.BR e ) -to introduce the exponent. The exponent always contains at least two -digits; if the value is zero, the exponent is 00. -.TP -.B f -The -.I double -argument is rounded and converted to decimal notation in the style -.BR "" [-]ddd \&. ddd, -where the number of digits after the decimal-point character is equal to -the precision specification. If the precision is missing, it is taken as -6; if the precision is explicitly zero, no decimal-point character appears. -If a decimal point appears, at least one digit appears before it. -.TP -.B g -The -.I double -argument is converted in style -.B f -or -.B e -(or -.B E -for -.B G -conversions). The precision specifies the number of significant digits. -If the precision is missing, 6 digits are given; if the precision is zero, -it is treated as 1. Style -.B e -is used if the exponent from its conversion is less than \-4 or greater -than or equal to the precision. Trailing zeros are removed from the -fractional part of the result; a decimal point appears only if it is -followed by at least one digit. -.TP -.B c -The -.I int -argument is converted to an -.IR unsigned char , -and the resulting character is written. -.TP -.B s -The -.IR "" `` "char *" '' -argument is expected to be a pointer to an array of character type (pointer -to a string). Characters from the array are written up to (but not -including) a terminating -.B NUL -character; if a precision is specified, no more than the number specified -are written. If a precision is given, no null character need be present; -if the precision is not specified, or is greater than the size of the -array, the array must contain a terminating -.B NUL -character. -.TP -.B p -The -.IR "" `` "void *" '' -pointer argument is printed in hexadecimal (as if by -.B %#x -or -.BR %#lx ). -.TP -.B n -The number of characters written so far is stored into the integer -indicated by the -.IR "" `` "int *" '' -(or variant) pointer argument. No argument is converted. -.TP -.B % -A `%' is written. No argument is converted. The complete conversion -specification is `%%'. -.PP -In no case does a non-existent or small field width cause truncation of a -field; if the result of a conversion is wider than the field width, the -field is expanded to contain the conversion result. -.PP -.SH EXAMPLES -.br -To print a date and time in the form `Sunday, July 3, 10:02', -where -.I weekday -and -.I month -are pointers to strings: -.RS -.nf -#include -fprintf(stdout, "%s, %s %d, %.2d:%.2d\en", - weekday, month, day, hour, min); -.fi -.RE -.PP -To print \*(Pi -to five decimal places: -.RS -.nf -#include -#include -fprintf(stdout, "pi = %.5f\en", 4 * atan(1.0)); -.fi -.RE -.PP -To allocate a 128 byte string and print into it: -.RS -.nf -#include -#include -#include -char *newfmt(const char *fmt, ...) -{ - char *p; - va_list ap; - if ((p = malloc(128)) == NULL) - return (NULL); - va_start(ap, fmt); - (void) vsnprintf(p, 128, fmt, ap); - va_end(ap); - return (p); -} -.fi -.RE -.SH "SEE ALSO" -.BR printf "(1), " scanf (3) -.SH STANDARDS -The -.BR fprintf , -.BR printf , -.BR sprintf , -.BR vprintf , -.BR vfprintf , -and -.B vsprintf -functions conform to ANSI C3.159-1989 (``ANSI C''). -.SH BUGS -Some floating point conversions under Linux cause memory leaks. -.PP -The conversion formats -.BR \&%D , -.BR \&%O , -and -.B %U -are not standard and are provided only for backward compatibility. These -may not be provided under Linux. -.PP -The effect of padding the -.B %p -format with zeros (either by the -.B 0 -flag or by specifying a precision), and the benign effect (i.e., none) of -the -.B # -flag on -.B %n -and -.B %p -conversions, as well as other nonsensical combinations such as -.BR %Ld , -are not standard; such combinations should be avoided. -.PP -Because -.B sprintf -and -.B vsprintf -assume an infinitely long string, callers must be careful not to overflow -the actual space; this is often impossible to assure. diff --git a/man3/psignal.3 b/man3/psignal.3 index 9161f03a62..476c25dbc5 100644 --- a/man3/psignal.3 +++ b/man3/psignal.3 @@ -28,5 +28,5 @@ indexed by signal number. The \fBpsignal()\fP function returns no value. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR perror "(3), " strsignal (3) diff --git a/man3/putenv.3 b/man3/putenv.3 index 30a4e5bd30..d27407dbc7 100644 --- a/man3/putenv.3 +++ b/man3/putenv.3 @@ -23,7 +23,7 @@ If \fIname\fP does not already exist in the environment, then then the value of \fIname\fP in the environment is changed to \fIvalue\fP. .SH "RETURN VALUE" -The \fBputenv()\fP function returns zero on success, or \-1 if an error +The \fBputenv()\fP function returns zero on success, or -1 if an error occurs. .SH ERRORS .TP @@ -31,5 +31,5 @@ occurs. Insufficient space to allocate new environment. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getenv "(3), " setenv "(3), " unsetenv (3) diff --git a/man3/putpwent.3 b/man3/putpwent.3 index db9fb67f02..1036ba2c28 100644 --- a/man3/putpwent.3 +++ b/man3/putpwent.3 @@ -38,7 +38,7 @@ struct passwd { .fi .RE .SH "RETURN VALUE" -The \fBputpwent()\fP function returns 0 on success, or \-1 if an error +The \fBputpwent()\fP function returns 0 on success, or -1 if an error occurs. .SH ERRORS .TP @@ -46,6 +46,6 @@ occurs. Invalid (NULL) argument given. .SH "CONFORMING TO" SVID 3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent "(3), " getpwent "(3), " setpwent (3), .BR endpwent "(3), " getpwnam "(3), " getpwuid "(3), " getpw (3) diff --git a/man3/puts.3 b/man3/puts.3 index 07f34eed98..d76054a0f3 100644 --- a/man3/puts.3 +++ b/man3/puts.3 @@ -84,6 +84,6 @@ library with low - level calls to .B write() for the file descriptor associated with the same output stream; the results will be undefined and very probably not what you want. -.SH "SEE ALSO" +.SH SEE ALSO .BR write "(2), " fopen "(3), " fwrite "(3), " scanf (3), .BR gets "(3), " fseek "(3), " ferror (3) diff --git a/man3/qsort.3 b/man3/qsort.3 index 1bd3f09686..39077365d0 100644 --- a/man3/qsort.3 +++ b/man3/qsort.3 @@ -34,5 +34,5 @@ as equal, their order in the sorted array is undefined. The \fBqsort()\fP function returns no value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR sort (1) diff --git a/man3/raise.3 b/man3/raise.3 index 30267d4ac3..277cd147cd 100644 --- a/man3/raise.3 +++ b/man3/raise.3 @@ -20,5 +20,5 @@ It is equivalent to Zero for success, nonzero for failure. .SH "CONFORMS TO" ANSI - C -.SH "SEE ALSO" +.SH SEE ALSO .BR kill "(2), " signal "(2), " getpid (2) diff --git a/man3/rand.3 b/man3/rand.3 index 596dd05fe1..ab3c321636 100644 --- a/man3/rand.3 +++ b/man3/rand.3 @@ -55,5 +55,5 @@ return j % i; program, which credits Ken Arnold, Unix Review, October 1987). .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR random "(3), " srandom "(3), " initstate "(3), " setstate (3) diff --git a/man3/random.3 b/man3/random.3 index 92ceecea15..56a1d0e402 100644 --- a/man3/random.3 +++ b/man3/random.3 @@ -26,7 +26,7 @@ The \fBrandom()\fP function uses a non-linear additive feedback random number generator employing a default table of size 31 long integers to return successive pseudo-random numbers in the range from 0 to RAND_MAX. The period of this random number generator is very large, approximately -16*((2**31)\-1). +16*((2**31)-1). .PP The \fBsrandom()\fP function sets its argument as the seed for a new sequence of pseudo-random integers to be returned by \fBrandom()\fP. @@ -37,7 +37,7 @@ is automatically seeded with a value of 1. The \fBinitstate()\fP function allows a state array \fIstate\fP to be initialized for use by \fBrandom()\fP. The size of the state array \fIn\fP is used by \fBinitstate()\fP to decide how sophisticated a -random number generator it should use \(em the larger the state array, +random number generator it should use \- the larger the state array, the better the random numbers will be. \fIseed\fP is the seed for the initialization, which specifies a starting point for the random number sequence, and provides for restarting at the same point. @@ -63,5 +63,5 @@ the nearest known amount. Using less than 8 bytes will cause an error. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR rand "(3), " srand (3) diff --git a/man3/readdir.3 b/man3/readdir.3 index 5ddf3b0d24..c9a3a98436 100644 --- a/man3/readdir.3 +++ b/man3/readdir.3 @@ -35,6 +35,6 @@ In Linux 0.99.11, is implemented as a kernel function. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR read "(2), " opendir "(3), " closedir "(3), " rewinddir (3), .BR seekdir "(3), " telldir "(3), " scandir (3) diff --git a/man3/readv.3 b/man3/readv.3 index 9f7b8f1111..9ef10d34fb 100644 --- a/man3/readv.3 +++ b/man3/readv.3 @@ -70,7 +70,7 @@ except that multiple buffers are written out. .SH "RETURN VALUES" The .B readv() -function returns the number of bytes or \-1 on error; the +function returns the number of bytes or -1 on error; the .B writev() function returns the number of bytes written. .SH "ERRORS" @@ -111,5 +111,5 @@ It is not advisable to mix calls to functions like .BR readv() " or " writev() , which operate on file descriptors, with the functions from the stdio library; the results will be undefined and probably not what you want. -.SH "SEE ALSO" +.SH SEE ALSO .BR read "(2), " write (2) diff --git a/man3/resolver.3 b/man3/resolver.3 index de9283d133..fe0e0e9116 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -154,15 +154,15 @@ domain and in parent domains. This option is used by .BR gethostbyname (3). [Enabled by default]. .SH "RETURN VALUE" -The \fBres_init()\fP function returns 0 on success, or \-1 if an error +The \fBres_init()\fP function returns 0 on success, or -1 if an error occurs. .PP The \fBres_query()\fP, \fBres_search()\fP, \fBres_querydomain()\fP, \fBres_mkquery()\fP and \fBres_send()\fP functions return the length -of the response, or \-1 if an error occurs. +of the response, or -1 if an error occurs. .PP The \fBdn_comp()\fP and \fBdn_expand()\fP functions return the length -of the compressed name, or \-1 if an error occurs. +of the compressed name, or -1 if an error occurs. .SH FILES .nf /etc/resolv.conf resolver configuration file @@ -170,5 +170,5 @@ of the compressed name, or \-1 if an error occurs. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostbyname "(3), " hostname "(7), " named "(8), " resolv+ (8) diff --git a/man3/rewind.3 b/man3/rewind.3 deleted file mode 100644 index a1487b5a8c..0000000000 --- a/man3/rewind.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fseek.3 diff --git a/man3/rewinddir.3 b/man3/rewinddir.3 index 89a7980b0e..e548715fbf 100644 --- a/man3/rewinddir.3 +++ b/man3/rewinddir.3 @@ -21,6 +21,6 @@ stream \fIdir\fP to the beginning of the directory. The \fBreaddir()\fP function returns no value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR opendir "(3), " readdir "(3), " closedir "(3), " seekdir (3), .BR telldir "(3), " scandir (3) diff --git a/man3/rint.3 b/man3/rint.3 index b2fb0e723d..f2e0a9f2d1 100644 --- a/man3/rint.3 +++ b/man3/rint.3 @@ -23,5 +23,5 @@ The \fBrint()\fP function returns the integer value as a floating-point number. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " ceil "(3), " fabs "(3), " floor "(3), " labs (3) diff --git a/man3/scandir.3 b/man3/scandir.3 index 73a3eec182..0b348c393a 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -34,7 +34,7 @@ alphabetical order. Its parameters are the two directory entries, \fIa\fP and \fIb\fP, to compare. .SH "RETURN VALUE" The \fBscandir()\fP function returns the number of directory entries -selected or \-1 if an error occurs. +selected or -1 if an error occurs. .PP The \fBalphasort()\fP function returns an integer less than, equal to, or greater than zero if the first argument is considered to be @@ -43,8 +43,8 @@ respectively less than, equal to, or greater than the second. .TP .B ENOMEM Insufficient memory to complete the operation. -.SH "CONFORMING TO" +.SH CONFORMING TO BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR opendir "(3), " readdir "(3), " closedir "(3), " rewinddir (3), .BR telldir "(3), " seekdir (3) diff --git a/man3/scanf.3 b/man3/scanf.3 deleted file mode 100644 index e3e44b0186..0000000000 --- a/man3/scanf.3 +++ /dev/null @@ -1,363 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)scanf.3 6.14 (Berkeley) 1/8/93 -.\" -.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu -.\" -.TH SCANF 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- input format conversion -.SH SYNOPSIS -.nf -.B #include -.na -.BI "int scanf( const char *" format ", ..." ); -.br -.BI "int fscanf( FILE *" stream ", const char *" format ", ..." ); -.br -.BI "int sscanf( const char *" str ", const char *" format ", ..." ); -.sp -.B #include -.BI "int vscanf( const char *" format ", va_list " ap ); -.br -.BI "int vsscanf( const char *" str ", const char *" format ", va_list " ap ); -.br -.BI "int vfscanf( FILE *" stream ", const char *" format ", va_list " ap ); -.ad -.SH DESCRIPTION -The -.B scanf -family of functions scans input according to a -.I format -as described below. This format may contain -.IR "conversion specifiers" ; -the results from such conversions, if any, are stored through the -.I pointer -arguments. The -.B scanf -function reads input from the standard input stream -.IR stdin , -.B fscanf -reads input from the stream pointer -.IR stream , -and -.B sscanf -reads its input from the character string pointed to by -.IR str . -.PP -The -.B vfscanf -function is analogous to -.BR vfprintf (3) -and reads input from the stream pointer -.I stream -using a variable argument list of pointers (see -.BR stdarg (3). -The -.B vscanf -function scans a variable argument list from the standard input and the -.B vsscanf -function scans it from a string; these are analogous to the -.B vprintf -and -.B vsprintf -functions respectively. -.PP -Each successive -.I pointer -argument must correspond properly with each successive conversion specifier -(but see `suppression' below). All conversions are introduced by the -.B % -(percent sign) character. The -.I format -string may also contain other characters. White space (such as blanks, -tabs, or newlines) in the -.I format -string match any amount of white space, including none, in the input. -Everything else matches only itself. Scanning stops when an input -character does not match such a format character. Scanning also stops when -an input conversion cannot be made (see below). -.SH CONVERSIONS -Following the -.B % -character introducing a conversion there may be a number of -.I flag -characters, as follows: -.TP -.B * -Suppresses assignment. The conversion that follows occurs as usual, but no -pointer is used; the result of the conversion is simply discarded. -.TP -.B h -Indicates that the conversion will be one of -.B dioux -or -.B n -and the next pointer is a pointer to a -.I short int -(rather than -.IR int ). -.TP -.B l -Indicates either that the conversion will be one of -.B dioux -or -.B n -and the next pointer is a pointer to a -.I long int -(rather than -.IR int ), -or that the conversion will be one of -.B efg -and the next pointer is a pointer to -.I double -(rather than -.IR float ). -.TP -.B L -Indicates that the conversion will be -.B efg -and the next pointer is a pointer to -.IR "long double" . -(This type is not implemented; the -.B L -flag is currently ignored\(emthis may not be true for Linux.) -.PP -In addition to these flags, there may be an optional maximum field width, -expressed as a decimal integer, between the -.B % -and the conversion. If no width is given, a default of `infinity' is used -(with one exception, below); otherwise at most this many characters are -scanned in processing the conversion. Before conversion begins, most -conversions skip white space; this white space is not counted against the -field width. -.PP -The following conversions are available: -.TP -.B % -Matches a literal `%'. That is, `%\&%' in the format string matches a -single input `%' character. No conversion is done, and assignment does not -occur. -.TP -.B d -Matches an optionally signed decimal integer; -the next pointer must be a pointer to -.IR int . -.TP -.B D -Equivalent to -.BR ld ; -this exists only for backwards compatibility. -.TP -.B i -Matches an optionally signed integer; the next pointer must be a pointer to -.IR int . -The integer is read in base 16 if it begins with `0x' or `0X', in base 8 if -it begins with `0', and in base 10 otherwise. Only characters that -correspond to the base are used. -.TP -.B o -Matches an octal integer; the next pointer must be a pointer to -.IR "unsigned int" . -.TP -.B O -Equivalent to -.BR lo ; -this exists for backwards compatibility. -.TP -.B u -Matches an optionally signed decimal integer; the next pointer must be a -pointer to -.IR "unsigned int" . -.TP -.B x -Matches an optionally a signed hexadecimal integer; the next pointer must -be a pointer to -.IR "unsigned int" . -.TP -.B X -Equivalent to -.BR lx ; -this violates the ANSI C3.159-1989 (``ANSI C'') but is backwards compatible -with previous UNIX systems\(emI don't know what Linux does with this. -.TP -.B f -Matches an optionally signed floating-point number; the next pointer must -be a pointer to -.IR float . -.TP -.B e -Equivalent to -.BR f . -.TP -.B g -Equivalent to -.BR f . -.TP -.B E -Equivalent to -.BR lf ; -this violates the ANSI C3.159-1989 (``ANSI C'') -but is backwards compatible with previous UNIX -systems\(emI don't know what Linux does with this. -.TP -.B F -Equivalent to -.BR lf ; -this exists only for backwards compatibility. -.TP -.B s -Matches a sequence of non-white-space characters; the next pointer must be -a pointer to -.IR char , -and the array must be large enough to accept all the sequence and the -terminating -.B NUL -character. The input string stops at white space or at the maximum field -width, whichever occurs first. -.TP -.B c -Matches a sequence of -.I width -count characters (default 1); the next pointer must be a pointer to -.IR char , -and there must be enough room for all the characters (no terminating -.B NUL -is added). The usual skip of leading white space is suppressed. To skip -white space first, use an explicit space in the format. -.TP -.B \&[ -Matches a nonempty sequence of characters from the specified set of -accepted characters; the next pointer must be a pointer to -.IR char , -and there must be enough room for all the characters in the string, plus a -terminating -.B NUL -character. The usual skip of leading white space is suppressed. The -string is to be made up of characters in (or not in) a particular set; the -set is defined by the characters between the open bracket -.B [ -character and a close bracket -.B ] -character. The set -.I excludes -those characters if the first character after the open bracket is a -circumflex -.BR ^ . -To include a close bracket in the set, make it the first character after -the open bracket or the circumflex; any other position will end the set. -The hyphen character -.B - -is also special; when placed between two other characters, it adds all -intervening characters to the set. To include a hyphen, make it the last -character before the final close bracket. For instance, `[^]0-9-]' means -the set `everything except close bracket, zero through nine, and hyphen'. -The string ends with the appearance of a character not in the (or, with a -circumflex, in) set or when the field width runs out. -.TP -.B p -Matches a pointer value (as printed by `%p' in -.BR printf (3); -the next pointer must be a pointer to -.IR void . -.TP -.B n -Nothing is expected; instead, the number of characters consumed thus far -from the input is stored through the next pointer, which must be a pointer -to -.IR int . -This is -.I not -a conversion, although it can be suppressed with the -.B * -flag. -.PP -For backwards compatibility, other conversion characters (except `\e0') are -taken as if they were `%d' or, if uppercase, `%ld', and a `conversion' of -`%\e0' causes an immediate return of -.BR EOF . -The -.B F -and -.B X -conversions will be changed in the future to conform to the - ANSI C standard, after which they will act like -.Cm f -and -.Cm x -respectively. The behavior of Linux on the non-standard points is not -known by this documenter. -.PP -.SH "RETURN VALUES" -These functions return the number of input items assigned, which can be -fewer than provided for, or even zero, in the event of a matching failure. -Zero indicates that, while there was input available, no conversions were -assigned; typically this is due to an invalid input character, such as an -alphabetic character for a `%d' conversion. The value -.B EOF -is returned if an input failure occurs before any conversion such as an -end-of-file occurs. If an error or end-of-file occurs after conversion has -begun, the number of conversions which were successfully completed is -returned. -.SH "SEE ALSO" -.BR strtol "(3), " strtoul "(3), " strtod "(3), " getc "(3), " printf (3) -.SH STANDARDS -The functions -.BR fscanf , -.BR scanf , -and -.BR sscanf -conform to ANSI C3.159-1989 (``ANSI C''). -.SH BUGS -Differences for Linux are not known at this time. The following is for the -BSD version: -.PP -The current situation with -.B %F -and -.B %X -conversions is unfortunate. -.PP -All of the backwards compatibility formats will be removed in the future. -.PP -Numerical strings are truncated to 512 characters; for example, -.B %f -and -.B %d -are implicitly -.B %512f -and -.BR %512d . diff --git a/man3/seed48.3 b/man3/seed48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/seed48.3 +++ b/man3/seed48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3 \ No newline at end of file diff --git a/man3/seekdir.3 b/man3/seekdir.3 index 790990045d..13376463b6 100644 --- a/man3/seekdir.3 +++ b/man3/seekdir.3 @@ -23,6 +23,6 @@ should be used with an offset returned by \fBtelldir()\fP. The \fBseekdir()\fP function returns no value. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR lseek "(2), " opendir "(3), " readdir "(3), " closedir (3), .BR rewinddir "(3), telldir "(3), " scandir (3) diff --git a/man3/setbuf.3 b/man3/setbuf.3 deleted file mode 100644 index 6a993727b5..0000000000 --- a/man3/setbuf.3 +++ /dev/null @@ -1,151 +0,0 @@ -.\" Copyright (c) 1980, 1991 Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" the American National Standards Committee X3, on Information -.\" Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)setbuf.3 6.10 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 14:55:24 1993, faith@cs.unc.edu -.\" -.TH SETBUF 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -setbuf, setbuffer, setlinebuf, setvbuf \- stream buffering operations -.SH SYNOPSIS -.na -.B #include -.sp -.BI "int setbuf( FILE *" stream ", char *" buf ); -.br -.BI "int setbuffer( FILE *" stream ", char *" buf ", size_t" size ); -.br -.BI "int setlinebuf( FILE *" stream ); -.br -.BI "int setvbuf( FILE *" stream ", char *" buf ", int " mode -.BI ", size_t " size ); -.ad -.SH DESCRIPTION -The three types of buffering available are unbuffered, block buffered, and -line buffered. When an output stream is unbuffered, information appears on -the destination file or terminal as soon as written; when it is block -buffered many characters are saved up and written as a block; when it is -line buffered characters are saved up until a newline is output or input is -read from any stream attached to a terminal device (typically stdin). The -function -.BR fflush (3) -may be used to force the block out early. -(See -.BR fclose (3).) -Normally all files are block buffered. When the first I/O operation occurs -on a file, -.BR malloc (3) -is called, and a buffer is obtained. If a stream refers to a terminal (as -.I stdout -normally does) it is line buffered. The standard error stream -.I stderr -is always unbuffered. -.PP -The -.B setvbuf -function may be used at any time on any open stream to change its buffer. -The -.I mode -parameter must be one of the following three macros: -.RS -.TP -.B _IONBF -unbuffered -.TP -.B _IOLBF -line buffered -.TP -.B _IOFBF -fully buffered -.RE -.PP -Except for unbuffered files, the -.I buf -argument should point to a buffer at least -.I size -bytes long; this buffer will be used instead of the current buffer. If the -argument -.I buf -is -.BR NULL , -only the mode is affected; a new buffer will be allocated on the next read -or write operation. The -.I setvbuf -function may be used at any time, but can only change the mode of a stream -when it is not ``active'': that is, before any I/O, or immediately after a -call to -.BR fflush . -.PP -The other three calls are, in effect, simply aliases for calls to -.BR setvbuf . -The -.B setbuf -function is exactly equivalent to the call -.PP -.RS -setvbuf(stream, buf, buf ? _IOFBF : _IONBF, BUFSIZ); -.RE -.PP -The -.B setbuffer -function is the same, except that the size of the buffer is up to the -caller, rather than being determined by the default -.BR BUFSIZ . -The -.B setlinebuf -function is exactly equivalent to the call: -.PP -.RS -setvbuf(stream, (char *)NULL, _IOLBF, 0); -.RE -.SH "SEE ALSO" -.BR fopen "(3), " fclose "(3), " fread "(3), " malloc "(3), " puts "(3), " -.BR printf (3) -.SH STANDARDS -The -.B setbuf -and -.B setvbuf -functions conform to ANSI C3.159-1989 (``ANSI C''). -.SH BUGS -The -.B setbuffer -and -.B setlinebuf -functions are not portable to versions of BSD before 4.2BSD, and may not be -available under Linux. On 4.2BSD and 4.3BSD systems, -.B setbuf -always uses a suboptimal buffer size and should be avoided. diff --git a/man3/setbuffer.3 b/man3/setbuffer.3 deleted file mode 100644 index dc02d9e887..0000000000 --- a/man3/setbuffer.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/setbuf.3 diff --git a/man3/setenv.3 b/man3/setenv.3 index 87143c4b45..278fbfcfb4 100644 --- a/man3/setenv.3 +++ b/man3/setenv.3 @@ -27,9 +27,9 @@ changed. The \fBunsetenv()\fP function deletes the variable \fIname\fP from the environment. .SH "RETURN VALUE" -The \fBsetenv()\fP function returns zero on success, or \-1 if there +The \fBsetenv()\fP function returns zero on success, or -1 if there was insufficient space in the environment. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getenv "(3), " putenv (3) diff --git a/man3/setlinebuf.3 b/man3/setlinebuf.3 deleted file mode 100644 index dc02d9e887..0000000000 --- a/man3/setlinebuf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/setbuf.3 diff --git a/man3/setlocale.3 b/man3/setlocale.3 index 87acc4c46f..6cfb466d55 100644 --- a/man3/setlocale.3 +++ b/man3/setlocale.3 @@ -85,6 +85,6 @@ Support for other locales will be there Real Soon Now. The .B printf() family of functions may or may not honour the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR locale "(1), " localedef "(1), " strcoll "(3), " isalpha (3), .BR localeconv "(3), " strftime "(3), " locale (7) diff --git a/man3/setvbuf.3 b/man3/setvbuf.3 deleted file mode 100644 index dc02d9e887..0000000000 --- a/man3/setvbuf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/setbuf.3 diff --git a/man3/siginterrupt.3 b/man3/siginterrupt.3 index 1eab83262e..6e2fdfb04d 100644 --- a/man3/siginterrupt.3 +++ b/man3/siginterrupt.3 @@ -23,14 +23,14 @@ Linux. However, when a new signal handler is specified with the \fBsignal\fP(2) function, the system call is interrupted by default. .PP If the \fIflags\fP argument is true (1) and no data has been transferred, -then a system call interrupted by the signal \fIsig\fP will return \-1 +then a system call interrupted by the signal \fIsig\fP will return -1 and the global variable \fIerrno\fP will be set to \fIEINTR\fP. .PP If the \fIflags\fP argument is true (1) and data transfer has started, then the system call will be interrupted and will return the actual amount of data transferred. .SH "RETURN VALUE" -The \fBsiginterrupt()\fP function returns 0 on success, or \-1 if the +The \fBsiginterrupt()\fP function returns 0 on success, or -1 if the signal number \fIsig\fP is invalid. .SH "ERRORS" .TP @@ -38,5 +38,5 @@ signal number \fIsig\fP is invalid. The specified signal number is invalid. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR signal (2) diff --git a/man3/sin.3 b/man3/sin.3 index 10207ed9a4..916b8fefc5 100644 --- a/man3/sin.3 +++ b/man3/sin.3 @@ -18,8 +18,8 @@ sin \- sine function The \fBsin()\fP function returns the sine of \fIx\fP, where \fIx\fP is given in radians. .SH "RETURN VALUE" -The \fBsin()\fP function returns a value between \-1 and 1. +The \fBsin()\fP function returns a value between -1 and 1. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan "(3), " atan2 "(3), " cos "(3), " tan (3) diff --git a/man3/sinh.3 b/man3/sinh.3 index 77f29b3c59..96bce69c09 100644 --- a/man3/sinh.3 +++ b/man3/sinh.3 @@ -19,5 +19,5 @@ The \fBsinh()\fP function returns the hyperbolic sine of \fIx\fP, which is defined mathematically as exp(x) - exp(-x) / 2. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh "(3), " asinh "(3), " atanh "(3), " cosh "(3), " tanh (3) diff --git a/man3/sleep.3 b/man3/sleep.3 index 21c6ee6117..4799303c4a 100644 --- a/man3/sleep.3 +++ b/man3/sleep.3 @@ -35,5 +35,5 @@ Using from a signal handler or modifying the handling of .B SIGALRM while sleeping will cause undefined results. -.SH "SEE ALSO" +.SH SEE ALSO .BR signal "(2), " alarm (2) diff --git a/man3/sprintf.3 b/man3/sprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/sprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/srand48.3 b/man3/srand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/srand48.3 +++ b/man3/srand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3 \ No newline at end of file diff --git a/man3/sscanf.3 b/man3/sscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/sscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/stdarg.3 b/man3/stdarg.3 deleted file mode 100644 index 91daf50748..0000000000 --- a/man3/stdarg.3 +++ /dev/null @@ -1,193 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" the American National Standards Committee X3, on Information -.\" Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)stdarg.3 6.8 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:11:11 1993, faith@cs.unc.edu -.\" -.TH STDARG 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -stdarg \- variable argument lists -.SH SYNOPSIS -.B #include -.sp -.BI "void va_start( va_list " ap ", " last ); -.br -.BI "" type "va_arg( va_list " ap ", " type ); -.br -.BI "void va_end( va_list " ap ); -.SH DESCRIPTION -A function may be called with a varying number of arguments of varying -types. The include file -.I stdarg.h -declares a type -.B va_list -and defines three macros for stepping through a list of arguments whose -number and types are not known to the called function. -.PP -The called function must declare an object of type -.B va_list -which is used by the macros -.BR va_start , -.BR va_arg , -and -.BR va_end . -.PP -The -.B va_start -macro initializes -.I ap -for subsequent use by -.B va_arg -and -.BR va_end , -and must be called first. -.PP -The parameter -.I last -is the name of the last parameter before the variable argument list, i.e., -the last parameter of which the calling function knows the type. -.PP -Because the address of this parameter is used in the -.B va_start -macro, it should not be declared as a register variable, or as a function -or an array type. -.PP -The -.B va_start -macro returns no value. -.PP -The -.B va_arg -macro expands to an expression that has the type and value of the next -argument in the call. The parameter -.I ap -is the -.BI va_list " " ap -initialized by -.BR va_start . -Each call to -.B va_arg -modifies -.I ap -so that the next call returns the next argument. The parameter -.I type -is a type name specified so that the type of a pointer to an object that -has the specified type can be obtained simply by adding a * to -.IR type . -.PP -If there is no next argument, or if -.I type -is not compatible with the type of the actual next argument (as promoted -according to the default argument promotions), random errors will occur. -.PP -The first use of the -.B va_arg -macro after that of the -.B va_start -macro returns the argument after -.IR last . -Successive invocations return the values of the remaining arguments. -.PP -The -.B va_end -macro handles a normal return from the function whose variable argument -list was initialized by -.BR va_start . -.PP -The -.B va_end -macro returns no value. -.SH EXAMPLES -The function -.I foo -takes a string of format characters and prints out the argument associated -with each format character based on the type. -.RS -.nf -void foo(char *fmt, ...) -{ - va_list ap; - int d; - char c, *p, *s; - - va_start(ap, fmt); - while (*fmt) - switch(*fmt++) { - case 's': /* string */ - s = va_arg(ap, char *); - printf("string %s\en", s); - break; - case 'd': /* int */ - d = va_arg(ap, int); - printf("int %d\en", d); - break; - case 'c': /* char */ - c = va_arg(ap, char); - printf("char %c\en", c); - break; - } - va_end(ap); -} -.fi -.RE -.SH STANDARDS -The -.BR va_start , -.BR va_arg , -and -.B va_end -macros conform to ANSI C3.159-1989 (``ANSI C''). -.SH COMPATIBILITY -These macros are -.I not -compatible with the historic macros they replace. A backward compatible -version can be found in the include file -.IR varargs.h . -.SH BUGS -Unlike the -.B varargs -macros, the -.B stdarg -macros do not permit programmers to code a function with no fixed -arguments. This problem generates work mainly when converting -.B varargs -code to -.B stdarg -code, but it also creates difficulties for variadic functions that wish to -pass all of their arguments on to a function that takes a -.B va_list -argument, such as -.BR vfprintf (3). diff --git a/man3/stdio.3 b/man3/stdio.3 deleted file mode 100644 index a4192d5062..0000000000 --- a/man3/stdio.3 +++ /dev/null @@ -1,355 +0,0 @@ -.\" Copyright (c) 1990, 1991 Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)stdio.3 6.5 (Berkeley) 5/6/91 -.\" -.\" Converted for Linux, Mon Nov 29 16:07:22 1993, faith@cs.unc.edu -.\" -.TH STDIO 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -stdio \- standard input/output library functions -.SH SYNOPSIS -.B #include -.sp -.B FILE *stdin; -.br -.B FILE *stdout; -.br -.B FILE *stderr; -.SH DESCRIPTION -The standard I/O library provides a simple and efficient buffered stream -I/O interface. Input and ouput is mapped into logical data streams and the -physical I/O characteristics are concealed. The functions and macros are -listed below; more information is available from the individual man pages. -.PP -A stream is associated with an external file (which may be a physical -device) by -.I opening -a file, which may involve creating a new file. Creating an existing file -causes its former contents to be discarded. If a file can support -positioning requests (such as a disk file, as opposed to a terminal) then a -.I file position indicator -associated with the stream is positioned at the start of the file (byte -zero), unless the file is opened with appened mode. If append mode is used, -the position indicator will be placed the end-of-file. The position -indicator is maintained by subsequent reads, writes and positioning -requests. All input occurs as if the characters were read by successive -calls to the -.BR fgetc (3) -function; all ouput takes place as if all characters were read by -successive calls to the -.BR fputc (3) -function. -.PP -A file is disassociated from a stream by -.I closing -the file. Ouput streams are flushed (any unwritten buffer contents are -transfered to the host environment) before the stream is disassociated from -the file. The value of a pointer to a -.B FILE -object is indeterminate after a file is closed (garbage). -.PP -A file may be subsequently reopened, by the same or another program -execution, and its contents reclaimed or modified (if it can be -repositioned at the start). If the main function returns to its original -caller, or the -.BR exit (3) -function is called, all open files are closed (hence all output streams are -flushed) before program termination. Other methods of program termination, -such as -.BR abort (3) -do not bother about closing files properly. -.PP -At program startup, three text streams are predefined and need not be -opened explicitly \(em -.I standard input -(for reading converntional input), \(em -.I standard output -(for writing converntional input), and -.I standard error -(for writing diagnostic output). These streams are abbreviated -.IR stdin , stdout -and -.IR stderr . -When opened, the standard error stream is not fully buffered; the standard -input and output streams are fully buffered if and only if the streams do -not to refer to an interactive device. -.PP -Output streams that refer to terminal devices are always line buffered by -default; pending output to such streams is written automatically whenever -an input stream that refers to a terminal device is read. In cases where a -large amount of computation is done after printing part of a line on an -output terminal, it is necessary to -.BR fflush (3) -the standard output before going off and computing so that the output will -appear. -.PP -The -.B stdio -library is a part of the library -.B libc -and routines are automatically loaded as needed by the compilers -.BR cc (1) -and -.BR pc (1). -The -.B SYNOPSIS -sections of the following manual pages indicate which include files are to -be used, what the compiler declaration for the function looks like and -which external variables are of interest. -.PP -The following are defined as macros; these names may not be re-used without -first removing their current definitions with -.BR #undef : -.BR BUFSIZ , -.BR EOF , -.BR FILENAME_MAX , -.BR FOPEN_MAX , -.BR L_cuserid , -.BR L_ctermid , -.BR L_tmpnam, -.BR NULL , -.BR SEEK_END , -.BR SEEK_SET , -.BR SEE_CUR , -.BR TMP_MAX , -.BR clearerr , -.BR feof , -.BR ferror , -.BR fileno , -.BR fropen , -.BR fwopen , -.BR getc , -.BR getchar , -.BR putc , -.BR putchar , -.BR stderr , -.BR stdin , -.BR stdout . -Function versions of the macro functions -.BR feof , -.BR ferror , -.BR clearerr , -.BR fileno , -.BR getc , -.BR getchar , -.BR putc , -and -.B putchar -exist and will be used if the macros definitions are explicitly removed. -.SH "SEE ALSO" -.BR open "(2), " close "(2), " read "(2), " write (2) -.SH BUGS -The standard buffered functions do not interact well with certain other -library and system functions, especially -.B vfork -and -.BR abort . -This may not be the case under Linux. -.SH STANDARDS -The -.B stdio -library conforms to ANSI C3.159-1989 (``ANSI C''). -.SH "LIST OF FUNCTIONS" -.TP -.B Function -.B Description -.TP -clearerr -check and reset stream status -.TP -fclose -close a stream -.TP -fdopen -stream open functions -.TP -feof -check and reset stream status -.TP -ferror -check and reset stream status -.TP -fflush -flush a stream -.TP -fgetc -get next character or word from input stream -.TP -fgetline -get a line from a stream -.TP -fgetpos -reposition a stream -.TP -fgets -get a line from a stream -.TP -fileno -check and reset stream status -.TP -fopen -stream open functions -.TP -fprintf -formatted output conversion -.TP -fpurge -flush a stream -.TP -fputc -output a character or word to a stream -.TP -fputs -output a line to a stream -.TP -fread -binary stream input/output -.TP -freopen -stream open functions -.TP -fropen -open a stream -.TP -fscanf -input format conversion -.TP -fseek -reposition a stream -.TP -fsetpos -reposition a stream -.TP -ftell -reposition a stream -.TP -fwrite -binary stream input/output -.TP -getc -get next character or word from input stream -.TP -getchar -get next character or word from input stream -.TP -gets -get a line from a stream -.TP -getw -get next character or word from input stream -.TP -mktemp -make temporary file name (unique) -.TP -perror -system error messages -.TP -printf -formatted output conversion -.TP -putc -output a character or word to a stream -.TP -putchar -output a character or word to a stream -.TP -puts -output a line to a stream -.TP -putw -output a character or word to a stream -.TP -remove -remove directory entry -.TP -rewind -reposition a stream -.TP -scanf -input format conversion -.TP -setbuf -stream buffering operations -.TP -setbuffer -stream buffering operations -.TP -setlinebuf -stream buffering operations -.TP -setvbuf -stream buffering operations -.TP -sprintf -formatted output conversion -.TP -sscanf -input format conversion -.TP -strerror -system error messages -.TP -sys_errlist -system error messages -.TP -sys_nerr -system error messages -.TP -tempnam -temporary file routines -.TP -tmpfile -temporary file routines -.TP -tmpnam -temporary file routines -.TP -ungetc -un-get character from input stream -.TP -vfprintf -formatted output conversion -.TP -vfscanf -input format conversion -.TP -vprintf -formatted output conversion -.TP -vscanf -input format conversion -.TP -vsprintf -formatted output conversion -.TP -vsscanf -input format conversion diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3 index f266581015..8047858026 100644 --- a/man3/strcasecmp.3 +++ b/man3/strcasecmp.3 @@ -31,5 +31,5 @@ an integer less than, equal to, or greater than zero if \fIs1\fP less than, to match, or be greater than \fIs2\fP. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " memcmp "(3), " strcmp "(3), " strcoll "(3), " strncmp (3) diff --git a/man3/strcat.3 b/man3/strcat.3 index 75523ec23a..53f2914f97 100644 --- a/man3/strcat.3 +++ b/man3/strcat.3 @@ -30,5 +30,5 @@ The \fBstrcat()\fP and \fBstrncat()\fP functions return a pointer to the resulting string \fIdest\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memccpy "(3), " memcpy "(3), " strcpy "(3), " strncpy (3) diff --git a/man3/strchr.3 b/man3/strchr.3 index 4c1bbdf56a..0152bc541a 100644 --- a/man3/strchr.3 +++ b/man3/strchr.3 @@ -27,6 +27,6 @@ The \fBstrchr()\fP and \fBstrrchr()\fP functions return a pointer to the matched character or NULL if the character is not found. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strpbrk (3), .BR strsep "(3), " strspn "(3), " strstr "(3), " strtok (3) diff --git a/man3/strcmp.3 b/man3/strcmp.3 index 6b4b6c7450..bd9e3b9c34 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -31,6 +31,6 @@ less than, equal to, or greater than zero if \fIs1\fP (or the first match, or be greater than \fIs2\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " memcmp "(3), " strcasecmp "(3), " strncasecmp (3), .BR strcoll (3) diff --git a/man3/strcoll.3 b/man3/strcoll.3 index 798c40810a..ad49838790 100644 --- a/man3/strcoll.3 +++ b/man3/strcoll.3 @@ -32,6 +32,6 @@ SVID 3, BSD 4.3, ISO 9899 The Linux C Library currently only understands the \fI"C"\fP or \fI"POSIX"\fP locales in which \fBstrcoll()\fP is equivalent to \fBstrcmp()\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " memcmp "(3), " strcasecmp "(3), " strcmp (3), .BR strxfrm "(3), " setlocale (3) diff --git a/man3/strcpy.3 b/man3/strcpy.3 index 2e3b3a9e08..c4745ea15e 100644 --- a/man3/strcpy.3 +++ b/man3/strcpy.3 @@ -29,5 +29,5 @@ The \fBstrcpy()\fP and \fBstrncpy()\fP functions return a pointer to the destination string \fIdest\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memccpy "(3), " memcpy "(3), " memmove (3) diff --git a/man3/strdup.3 b/man3/strdup.3 index 2059f82edf..7d13b7ec5b 100644 --- a/man3/strdup.3 +++ b/man3/strdup.3 @@ -27,5 +27,5 @@ string, or NULL if insufficient memory was available. Insufficient memory available to allocate duplicate string. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR calloc "(3), " malloc "(3), " realloc "(3), " free (3) diff --git a/man3/strerror.3 b/man3/strerror.3 index e39a47d7f5..abfe27ad32 100644 --- a/man3/strerror.3 +++ b/man3/strerror.3 @@ -23,5 +23,5 @@ The \fBstrerror()\fP function returns the appropriate description string, or an unknown error message if the error code is unknown. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR errno "(2), " perror "(3), " strsignal (3) diff --git a/man3/strfry.3 b/man3/strfry.3 index bb5a1123bd..62d19364b9 100644 --- a/man3/strfry.3 +++ b/man3/strfry.3 @@ -24,5 +24,5 @@ string. .SH "CONFORMING TO" The \fBstrfry()\fP function is unique to the Linux C Library and GNU C Library. -.SH "SEE ALSO" +.SH SEE ALSO .BR memfrob (3) diff --git a/man3/strftime.3 b/man3/strftime.3 index 6be3c2e5cf..48d69981df 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -154,7 +154,7 @@ in the array \fIs\fP, not including the terminating NULL character. If the value equals \fImax\fP, it means that the array was too small. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR date "(1), " time "(2), " ctime "(3), " setlocale "(3), " sprintf (3) .SH BUGS The function lacks locale support. diff --git a/man3/string.3 b/man3/string.3 index 36e8141dfd..58da764b97 100644 --- a/man3/string.3 +++ b/man3/string.3 @@ -65,7 +65,7 @@ strrchr, strsep, strspn, strstr, strtok, strxfrm, index, rindex The string functions perform string operations on NULL-terminated strings. See the individual man pages for descriptions of each function. -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " rindex "(3), " strcasecmp "(3), " strcat (3), .BR strchr "(3), " strcmp "(3), " strcoll "(3), " strcpy (3), .BR strcspn "(3), " strdup "(3), " strfry "(3), " strlen (3), diff --git a/man3/strlen.3 b/man3/strlen.3 index a698995bc7..b29735e9f1 100644 --- a/man3/strlen.3 +++ b/man3/strlen.3 @@ -21,5 +21,5 @@ The \fBstrlen()\fP function calculates the length of the string The \fBstrlen()\fP function returns the number of characters in \fIs\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR string (3) diff --git a/man3/strncasecmp.3 b/man3/strncasecmp.3 index fd3b6715e8..9733006a5f 100644 --- a/man3/strncasecmp.3 +++ b/man3/strncasecmp.3 @@ -1 +1 @@ -.so man3/strcasecmp.3 +.so man3/strcasecmp.3 \ No newline at end of file diff --git a/man3/strncmp.3 b/man3/strncmp.3 index 1007f4346c..5339168b84 100644 --- a/man3/strncmp.3 +++ b/man3/strncmp.3 @@ -1 +1 @@ -.so man3/strcmp.3 +.so man3/strcmp.3 \ No newline at end of file diff --git a/man3/strpbrk.3 b/man3/strpbrk.3 index 30b699d679..2370bd4508 100644 --- a/man3/strpbrk.3 +++ b/man3/strpbrk.3 @@ -22,6 +22,6 @@ The \fBstrpbrk()\fP function returns a pointer to the character in \fIs\fP that matches one of the characters in \fIaccept\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strsep "(3), " strspn "(3), " strstr "(3), " strtok (3) diff --git a/man3/strsep.3 b/man3/strsep.3 index 9d4d55d65c..88166df46a 100644 --- a/man3/strsep.3 +++ b/man3/strsep.3 @@ -24,6 +24,6 @@ The \fBstrsep()\fP function returns a pointer to the token, or NULL if \fIdelim\fP is not found in \fIstringp\fP. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strpbrk "(3), " strspn "(3), " strstr "(3), " strtok (3) diff --git a/man3/strsignal.3 b/man3/strsignal.3 index 3f66e91c02..0d102051b1 100644 --- a/man3/strsignal.3 +++ b/man3/strsignal.3 @@ -26,5 +26,5 @@ indexed by signal number. .SH "RETURN VALUE" The \fBstrsignal()\fP function returns the appropriate description string, or an unknown signal message if the signal number is invalid. -.SH "SEE ALSO" +.SH SEE ALSO .BR psignal "(3), " strerror (3) diff --git a/man3/strspn.3 b/man3/strspn.3 index 808c3cc966..56d2a95e92 100644 --- a/man3/strspn.3 +++ b/man3/strspn.3 @@ -34,6 +34,6 @@ the inital segment of \fIs\fP which are not in the string \fIreject\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strpbrk "(3), " strsep "(3), " strstr "(3), " strtok (3) diff --git a/man3/strstr.3 b/man3/strstr.3 index f057b19b5d..e5c0fbf9ad 100644 --- a/man3/strstr.3 +++ b/man3/strstr.3 @@ -21,6 +21,6 @@ characters are not compared. .SH "RETURN VALUE" The \fBstrstr()\fP function returns a pointer to the beginning of the substring, or NULL if the substring is not found. -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strpbrk "(3), " strsep "(3), " strspn "(3), " strtok (3) diff --git a/man3/strtok.3 b/man3/strtok.3 index 8f2eaa2b39..4d316dfb79 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -31,6 +31,6 @@ The \fBstrtok()\fP function returns a pointer to the next token, or NULL if there are no more tokens. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strpbrk "(3), " strsep "(3), " strspn "(3), " strstr (3) diff --git a/man3/strtol.3 b/man3/strtol.3 index 0ecdcd91c2..970272ff56 100644 --- a/man3/strtol.3 +++ b/man3/strtol.3 @@ -50,7 +50,7 @@ returns LONG_MAX. In both cases, \fIerrno\fP is set to ERANGE. The given string was out of range; the value converted has been clamped. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atof "(3), " atoi "(3), " atol "(3), " strtod "(3), " strtoul (3) .SH BUGS Ignores the current locale. diff --git a/man3/strtoul.3 b/man3/strtoul.3 index 5ee1a0720a..5b1174a9f8 100644 --- a/man3/strtoul.3 +++ b/man3/strtoul.3 @@ -52,7 +52,7 @@ variable \fIerrno\fP to ERANGE. The given string was out of range; the value converted has been clamped. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atof "(3), " atoi "(3), " atol "(3), " strtod "(3), " strtol (3) .SH BUGS Ignores the current locale. diff --git a/man3/strxfrm.3 b/man3/strxfrm.3 index 8b903e7f79..b71839053f 100644 --- a/man3/strxfrm.3 +++ b/man3/strxfrm.3 @@ -33,6 +33,6 @@ SVID 3, BSD 4.3, ISO 9899 The Linux C Library currently only understands the \fI"C"\fP or \fI"POSIX"\fP locales in which \fBstrxfrm()\fP is equivalent to copying the string using \fBstrncpy()\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " memcmp "(3), " strcasecmp "(3), " strcmp (3), .BR strcoll "(3), " setlocale (3) diff --git a/man3/swab.3 b/man3/swab.3 index 32b390756b..edd8b000e7 100644 --- a/man3/swab.3 +++ b/man3/swab.3 @@ -23,5 +23,5 @@ between machines that have different low/high byte ordering. The \fBswab()\fP function returns no value. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR bstring (3) diff --git a/man3/sysconf.3 b/man3/sysconf.3 index af28bee615..bbb2e535fa 100644 --- a/man3/sysconf.3 +++ b/man3/sysconf.3 @@ -190,5 +190,5 @@ memory. .PP POSIX.2 is not yet an approved standard; the information in this manpage is subject to change. -.SH "SEE ALSO" +.SH SEE ALSO .BR bc "(1), " expr "(1), " locale "(1), " fpathconf "(3), " pathconf (3) diff --git a/man3/system.3 b/man3/system.3 index d902c773f6..deef3bd8e0 100644 --- a/man3/system.3 +++ b/man3/system.3 @@ -68,5 +68,5 @@ indication that the call failed; check .I errno to make sure. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh "(1), " exec "(2), " signal (2) diff --git a/man3/tan.3 b/man3/tan.3 index a0d6594a70..8a9e068488 100644 --- a/man3/tan.3 +++ b/man3/tan.3 @@ -19,5 +19,5 @@ The \fBtan()\fP function returns the tangent of \fIx\fP, where \fIx\fP is given in radians. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan "(3), " atan2 "(3), " cos "(3), " sin (3) diff --git a/man3/tanh.3 b/man3/tanh.3 index 6991b8a8ce..61e07f1ab8 100644 --- a/man3/tanh.3 +++ b/man3/tanh.3 @@ -19,5 +19,5 @@ The \fBtanh()\fP function returns the hyperbolic tangent of \fIx\fP, which is defined mathematically as sinh(x) / cosh(x). .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh "(3), " asinh "(3), " atanh "(3), " cosh "(3), " sinh (3) diff --git a/man3/telldir.3 b/man3/telldir.3 index 1379d15c95..78bba8f86e 100644 --- a/man3/telldir.3 +++ b/man3/telldir.3 @@ -19,13 +19,13 @@ The \fBtelldir()\fP function returns the current location associated with the directory stream \fIdir\fP. .SH "RETURN VALUE" The \fBtelldir()\fP function returns the current location in the directory -stream or \-1 if an error occurs. +stream or -1 if an error occurs. .SH "ERRORS" .TP .B EBADF Invalid directory stream descriptor \fIdir\fP. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR opendir "(3), " readdir "(3), " closedir "(3), " rewinddir (3), .BR seekdir "(3), " scandir (3) diff --git a/man3/tempnam.3 b/man3/tempnam.3 index 8dc0b55281..84a219b7f6 100644 --- a/man3/tempnam.3 +++ b/man3/tempnam.3 @@ -42,5 +42,5 @@ filename, or NULL if a unique filename cannot be generated. Unable to generate a unique filename. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR mktemp "(3), " mkstemp "(3), " tmpnam "(3), " tmpfile (3) diff --git a/man3/tmpfile.3 b/man3/tmpfile.3 index 1cea8d63ee..2bacdb4c14 100644 --- a/man3/tmpfile.3 +++ b/man3/tmpfile.3 @@ -42,5 +42,5 @@ Too many files open in system. Read-only filesystem. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mktemp "(3), " mkstemp "(3), " tmpnam "(3), " tempnam (3) diff --git a/man3/tmpnam.3 b/man3/tmpnam.3 index 61fcc3d424..5602557d0f 100644 --- a/man3/tmpnam.3 +++ b/man3/tmpnam.3 @@ -30,5 +30,5 @@ filename, or NULL if a unique name cannot be generated. Unable to generate a unique filename. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mktemp "(3), " mkstemp "(3), " tempnam "(3), " tmpfile (3) diff --git a/man3/tolower.3 b/man3/tolower.3 deleted file mode 100644 index 033f16e9e0..0000000000 --- a/man3/tolower.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/toupper.3 diff --git a/man3/tzset.3 b/man3/tzset.3 index ed95ef8ef2..bd8934d89d 100644 --- a/man3/tzset.3 +++ b/man3/tzset.3 @@ -101,6 +101,6 @@ relative to the system time conversion information directory .fi .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR date "(1), " gettimeofday "(2), " time "(2), " ctime (3), .BR getenv "(3), " tzfile (5) diff --git a/man3/usleep.3 b/man3/usleep.3 index f74cd7140c..8e7e10f71c 100644 --- a/man3/usleep.3 +++ b/man3/usleep.3 @@ -20,5 +20,5 @@ The \fBusleep()\fP function suspends execution of the calling process for system activity or by the time spent processing the call. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR setitimer "(2), " getitimer "(2), " sleep "(3), " alarm "(3), " select (3) diff --git a/man3/vfprintf.3 b/man3/vfprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/vfprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/vfscanf.3 b/man3/vfscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/vfscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/vprintf.3 b/man3/vprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/vprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/vscanf.3 b/man3/vscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/vscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/vsprintf.3 b/man3/vsprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/vsprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/vsscanf.3 b/man3/vsscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/vsscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index 7892ea36ec..3f8f9c7805 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -19,9 +19,9 @@ The \fBwcstombs()\fP function converts a sequence of wide characters from the array \fIpwcs\fP into a sequence of multibyte characters and stores up to \fIn\fP bytes of multibyte characters in the array \fIs\fP. .SH "RETURN VALUE" -\fBwcstombs()\fP returns the number of bytes stored in \fIs\fP or \-1 if +\fBwcstombs()\fP returns the number of bytes stored in \fIs\fP or -1 if \fIs\fP contains an invalid wide character. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mblen "(3), " mbtowc "(3), " mbstowcs "(3), " wctomb (3) diff --git a/man3/wctomb.3 b/man3/wctomb.3 index e7e9d0931b..f813d2eade 100644 --- a/man3/wctomb.3 +++ b/man3/wctomb.3 @@ -20,8 +20,8 @@ into a multibyte character and, if \fIs\fP is not NULL, stores the multibyte character representation in \fIs\fP. .SH "RETURN VALUE" \fBwctomb()\fP returns the number of bytes in the multibyte character -or \-1 if the wide character is not valid. +or -1 if the wide character is not valid. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mblen "(3), " mbstowcs "(3), " mbtowc "(3), " wcstombs (3) diff --git a/man4/sd.4 b/man4/sd.4 index 9d4112076a..17284b73e5 100644 --- a/man4/sd.4 +++ b/man4/sd.4 @@ -98,5 +98,5 @@ will return -EINVAL. /dev/sd[a-h]: the whole device .br /dev/sd[a-h][0-8]: individual block partitions -.SH "SEE ALSO" +.SH SEE ALSO .BR scsi (4) diff --git a/man5/ipc.5 b/man5/ipc.5 deleted file mode 100644 index 01212f79fb..0000000000 --- a/man5/ipc.5 +++ /dev/null @@ -1,363 +0,0 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH IPC 5 "November 1, 1993" "Linux 0.99.13" "Linux Programmer's Manual" -.SH NAME -ipc \- System V interprocess communication mechanisms -.SH SYNOPSIS -.nf -.B -# include -.B -# include -.B -# include -.B -# include -.B -# include -.SH DESCRIPTION -The manual page refers to the Linux implementation of the System V -interprocess communication mechanisms: -message queues, semaphore sets and shared memory segments. -In the following, the word -.B resource -means an istantiation of one among such mechanisms. -.SS Resource Access Permissions -For each resource the system uses a common structure of type -.BR "struct ipc_perm" -to store information needed in determining permissions to perform an -ipc operation. -The -.B ipc_perm -structure, defined by the -.I -system header file, includes the following members: -.sp -.B - ushort cuid; -/* creator user id */ -.br -.B - ushort cgid; -/* creator group id */ -.br -.B - ushort uid; -/* owner user id */ -.br -.B - ushort gid; -/* owner group id */ -.br -.B - ushort mode; -/* r/w permissions */ -.PP -The -.B mode -member of the -.B ipc_perm -structure defines, with its lower 9 bits, the access permissions to the -resource for a process executing an ipc system call. -The permissions are interpreted as follows: -.sp -.nf - 0400 Read by user. - 0200 Write by user. -.sp .5 - 0040 Read by group. - 0020 Write by group. -.sp .5 - 0004 Read by others. - 0002 Write by others. -.fi -.PP -Bits 0100, 0010 and 0001 (the execute bits) are unused by the system. -Furthermore -"write" -effectively means -"alter" -for a semaphore set. -.PP -The same system header file defines also the following symbolic -constants: -.TP 14 -.B IPC_CREAT -Create entry if key doesn't exists. -.TP -.B IPC_EXCL -Fail if key exists. -.TP -.B IPC_NOWAIT -Error if request must wait. -.TP -.B IPC_PRIVATE -Private key. -.TP -.B IPC_RMID -Remove resource. -.TP -.B IPC_SET -Set resource options. -.TP -.B IPC_STAT -Get resource options. -.PP -Note that -.B IPC_PRIVATE -is a -.B key_t -type, while all the others symbolic constants are flag fields or-able -into an -.B int -type variable. -.SS Message Queues -A message queue is uniquely identified by a positive integer -.RI "( its " msqid ) -and has an associated data structure of type -.BR "struct msquid_ds" , -defined in -.IR , -containing the following members: -.sp -.B - struct ipc_perm msg_perm; -.br -.B - ushort msg_qnum; -/* no of messages on queue */ -.br -.B - ushort msg_qbytes; -/* bytes max on a queue */ -.br -.B - ushort msg_lspid; -/* pid of last msgsnd call */ -.br -.B - ushort msg_lrpid; -/* pid of last msgrcv call */ -.br -.B - time_t msg_stime; -/* last msgsnd time */ -.br -.B - time_t msg_rtime; -/* last msgrcv time */ -.br -.B - time_t msg_ctime; -/* last change time */ -.TP 11 -.B msg_perm -.B ipc_perm -structure that specifies the access permissions on the message -queue. -.TP -.B msg_qnum -Number of messages currently on the message queue. -.TP -.B msg_qbytes -Maximum number of bytes of message text allowed on the message -queue. -.TP -.B msg_lspid -ID of the process that performed the last -.B msgsnd -system call. -.TP -.B msg_lrpid -ID of the process that performed the last -.B msgrcv -system call. -.TP -.B msg_stime -Time of the last -.B msgsnd -system call. -.TP -.B msg_rtime -Time of the last -.B msgcv -system call. -.TP -.B msg_ctime -Time of the last -system call that changed a member of the -.B msqid_ds -structure. -.SS Semaphore Sets -A semaphore set is uniquely identified by a positive integer -.RI "( its " semid ) -and has an associated data structure of type -.BR "struct semid_ds" , -defined in -.IR , -containing the following members: -.sp -.B - struct ipc_perm sem_perm; -.br -.B - time_t sem_otime; -/* last operation time */ -.br -.B - time_t sem_ctime; -/* last change time */ -.br -.B - ushort sem_nsems; -/* count of sems in set */ -.TP 11 -.B sem_perm -.B ipc_perm -structure that specifies the access permissions on the semaphore -set. -.TP -.B sem_otime -Time of last -.B semop -system call. -.TP -.B sem_ctime -Time of last -.B semctl -system call that changed a member of the above structure or of one -semaphore belonging to the set. -.TP -.B sem_nsems -Number of semaphores in the set. -Each semaphore of the set is referenced by a non-negative integer -ranging from -.B 0 -to -.BR sem_nsems\-1 . -.PP -A semaphore is a data structure of type -.B "struct sem" -containing the following members: -.sp -.B - ushort semval; -/* semaphore value */ -.br -.B - short sempid; -/* pid for last operation */ -.br -.B - ushort semncnt; -/* no. of awaiting semval to increase */ -.br -.B - ushort semzcnt; -/* no. of awaiting semval = 0 */ -.TP 11 -.B semval -Semaphore value: a non-negative integer. -.TP -.B sempid -ID of the last process that performed a semaphore operation -on this semaphore. -.TP -.B semncnt -Number of processes suspended awaiting for -.B semval -to increase. -.TP -.B semznt -Number of processes supended awaiting for -.B semval -to become zero. -.SS Shared Memory Segments -A shared memory segment is uniquely identified by a positive integer -.RI "(its " shmid ) -and has an associated data structure of type -.BR "struct shmid_ds" , -defined in -.IR , -containing the following members: -.sp -.B - struct ipc_perm shm_perm; -.br -.B - int shm_segsz; -/* size of segment */ -.br -.B - ushort shm_cpid; -/* pid of creator */ -.br -.B - ushort shm_lpid; -/* pid, last operation */ -.br -.B - short shm_nattch; -/* no. of current attaches */ -.br -.B - time_t shm_atime; -/* time of last attach */ -.br -.B - time_t shm_dtime; -/* time of last detach */ -.br -.B - time_t shm_ctime; -/* time of last change */ -.TP 11 -.B shm_perm -.B ipc_perm -structure that specifies the access permissions on the shared memory -segment. -.TP -.B shm_segsz -Size in bytes of the shared memory segment. -.TP -.B shm_cpid -ID of the process that created the shared memory segment. -.TP -.B shm_lpid -ID of the last process that executed a -.B shmat -or -.B shmdt -system call. -.TP -.B shm_nattch -Number of current alive attaches for this shared memory segment. -.TP -.B shm_atime -Time of the last -.B shmat -system call. -.TP -.B shm_dtime -Time of the last -.B shmdt -system call. -.TP -.B shm_ctime -Time of the last -.B shmctl -system call that changed -.BR shmid_ds . -.SH "SEE ALSO" -.BR ftok (3), -.BR msgctl (2), -.BR msgget (2), -.BR msgrcv (2), -.BR msgsnd (2), -.BR semctl (2), -.BR semget (2), -.BR semop (2), -.BR shmat (2), -.BR shmctl (2), -.BR shmget (2), -.B shmdt (2). diff --git a/man5/shells.5 b/man5/shells.5 index 2f1f5f7482..53145b83eb 100644 --- a/man5/shells.5 +++ b/man5/shells.5 @@ -1,23 +1,21 @@ .\" Copyright (c) 1993 Michael Haardt (u31b3hs@pool.informatik.rwth-aachen.de), Thu May 20 20:45:48 MET DST 1993 .\" This file may be distributed under the GNU General Public License. .\" Modified Sat Jul 24 17:11:07 1993 by Rik Faith (faith@cs.unc.edu) -.\" Modified Sun Nov 21 10:49:38 1993 by Michael Haardt -.TH SHELLS 5 "November 21, 1993" "" "Linux Programmer's Manual" +.TH SHELLS 5 "May 20, 1993" "" "Linux Programmer's Manual" .SH NAME shells \- pathnames of valid login shells .SH DESCRIPTION .B /etc/shells is a text file which contains the full pathnames of valid login shells. .SH EXAMPLES -.B /etc/shells -may contain the following paths: +.B /etc/shells may contain the following paths: .sp .RS -.B /bin/sh +/bin/sh .br -.B /bin/csh +/bin/csh .RE .SH FILES /etc/shells .SH "SEE ALSO" -chsh(1) +.BR chsh (1) diff --git a/man5/shells.5.orig b/man5/shells.5.orig deleted file mode 100644 index 53145b83eb..0000000000 --- a/man5/shells.5.orig +++ /dev/null @@ -1,21 +0,0 @@ -.\" Copyright (c) 1993 Michael Haardt (u31b3hs@pool.informatik.rwth-aachen.de), Thu May 20 20:45:48 MET DST 1993 -.\" This file may be distributed under the GNU General Public License. -.\" Modified Sat Jul 24 17:11:07 1993 by Rik Faith (faith@cs.unc.edu) -.TH SHELLS 5 "May 20, 1993" "" "Linux Programmer's Manual" -.SH NAME -shells \- pathnames of valid login shells -.SH DESCRIPTION -.B /etc/shells -is a text file which contains the full pathnames of valid login shells. -.SH EXAMPLES -.B /etc/shells may contain the following paths: -.sp -.RS -/bin/sh -.br -/bin/csh -.RE -.SH FILES -/etc/shells -.SH "SEE ALSO" -.BR chsh (1) diff --git a/man7/hier.7 b/man7/hier.7 index bb4815f22a..d87975d9f1 100644 --- a/man7/hier.7 +++ b/man7/hier.7 @@ -283,5 +283,5 @@ conventions. .SH BUGS This list is not exhaustive; different systems may be configured differently. -.SH "SEE ALSO" +.SH SEE ALSO .BR find "(1), " ln "(1), " mount (1) diff --git a/man7/locale.7 b/man7/locale.7 index a29a15cab2..9e3dcc660c 100644 --- a/man7/locale.7 +++ b/man7/locale.7 @@ -153,5 +153,5 @@ locales. .PP There is no support for what is probably the most important thing of all, a message catalog. -.SH "SEE ALSO" +.SH SEE ALSO .BR setlocale "(3), " localeconf "(3), " locale "(1), " localedef (1) diff --git a/man7/man.7 b/man7/man.7 index f27f276286..3887d471d3 100644 --- a/man7/man.7 +++ b/man7/man.7 @@ -123,7 +123,7 @@ GNU Public License and many people are working on changes to the kernel) .RE .SH FONTS Although there are many arbitrary conventions for man pages in the UNIX -world, the existence of several hundred Linux-specific man pages defines our +world, the existence of severl hundred Linux-specific man pages defines our standards: .IP For functions, the arguments are always specified using italics, @@ -147,7 +147,7 @@ usually uses the macro). .IP Any reference to another man page (or to the subject of the current man -page) is in bold. If the manual section number is given, it is given in +page) in in bold. If the manual section number is given, it is given in roman, without any spaces (e.g., .BR man (7)). @@ -263,7 +263,7 @@ command is similar to .I /usr/local/lib/groff/tmac/tmac.an .br .I /usr/man/whatis -.SH "SEE ALSO" +.SH SEE ALSO .BR groff (1), .BR man (1), .BR whatis (1), diff --git a/man7/signal.7 b/man7/signal.7 index c5ca578920..229c3cde18 100644 --- a/man7/signal.7 +++ b/man7/signal.7 @@ -67,5 +67,5 @@ A is missing; this is because the 386 hardware does not generate such a signal, but makes porting from other architectures unnecessarily difficult. -.SH "SEE ALSO" +.SH SEE ALSO .BR find "(1), " ln "(1), " mount(1) diff --git a/man7/suffixes.7 b/man7/suffixes.7 index f891348f08..024169d15a 100644 --- a/man7/suffixes.7 +++ b/man7/suffixes.7 @@ -115,5 +115,5 @@ Suffix File type General UNIX conventions .SH BUGS This list is not exhaustive. -.SH "SEE ALSO" +.SH SEE ALSO .BR file "(1), " make (1)