diff options
Diffstat (limited to 'usr/src/man/man3c')
-rw-r--r-- | usr/src/man/man3c/aioread.3c | 16 | ||||
-rw-r--r-- | usr/src/man/man3c/bsd_signal.3c | 18 | ||||
-rw-r--r-- | usr/src/man/man3c/fputc.3c | 15 | ||||
-rw-r--r-- | usr/src/man/man3c/fseek.3c | 10 | ||||
-rw-r--r-- | usr/src/man/man3c/ndbm.3c | 15 | ||||
-rw-r--r-- | usr/src/man/man3c/syslog.3c | 8 |
6 files changed, 25 insertions, 57 deletions
diff --git a/usr/src/man/man3c/aioread.3c b/usr/src/man/man3c/aioread.3c index 03ebaa704d..1a790d07e8 100644 --- a/usr/src/man/man3c/aioread.3c +++ b/usr/src/man/man3c/aioread.3c @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH AIOREAD 3C "Feb 5, 2008" +.TH AIOREAD 3C "May 13, 2017" .SH NAME aioread, aiowrite \- read or write asynchronous I/O operations .SH SYNOPSIS @@ -23,7 +23,6 @@ aioread, aiowrite \- read or write asynchronous I/O operations .fi .SH DESCRIPTION -.sp .LP The \fBaioread()\fR function initiates one asynchronous \fBread\fR(2) and returns control to the calling program. The read continues concurrently with @@ -72,8 +71,8 @@ application until after the operation has completed. While the operation is in progress, this buffer is in use by the operating system. .sp .LP -Notification of the completion of an asynchronous I/O operation can be -obtained synchronously through the \fBaiowait\fR(3C) function, or +Notification of the completion of an asynchronous I/O operation can be +obtained synchronously through the \fBaiowait\fR(3C) function, or asynchronously by installing a signal handler for the \fBSIGIO\fR signal. Asynchronous notification is accomplished by sending the process a \fBSIGIO\fR signal. If a signal handler is not installed for the \fBSIGIO\fR signal, @@ -97,13 +96,11 @@ It is an error to use the same result buffer in more than one outstanding request. These structures can be reused only after the system has completed the operation. .SH RETURN VALUES -.sp .LP -Upon successful completion, \fBaioread()\fR and \fBaiowrite()\fR return +Upon successful completion, \fBaioread()\fR and \fBaiowrite()\fR return \fB0\fR. Upon failure, \fBaioread()\fR and \fBaiowrite()\fR return \fB\(mi1\fR and set \fBerrno\fR to indicate the error. .SH ERRORS -.sp .LP The \fBaioread()\fR and \fBaiowrite()\fR functions will fail if: .sp @@ -165,12 +162,10 @@ Memory resources are unavailable to initiate request. .RE .SH USAGE -.sp .LP The \fBaioread()\fR and \fBaiowrite()\fR functions have transitional interfaces for 64-bit file offsets. See \fBlf64\fR(5). .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -186,9 +181,8 @@ MT-Level Safe .TE .SH SEE ALSO -.sp .LP \fBclose\fR(2), \fBexecve\fR(2), \fBexit\fR(2), \fBllseek\fR(2), \fBlseek\fR(2), \fBopen\fR(2), \fBread\fR(2), \fBwrite\fR(2), -\fBaiocancel\fR(3C), \fBaiowait\fR(3C), \fBsigvec\fR(3UCB), +\fBaiocancel\fR(3C), \fBaiowait\fR(3C), \fBattributes\fR(5), \fBlf64\fR(5) diff --git a/usr/src/man/man3c/bsd_signal.3c b/usr/src/man/man3c/bsd_signal.3c index b8f7784015..1a6cd472ea 100644 --- a/usr/src/man/man3c/bsd_signal.3c +++ b/usr/src/man/man3c/bsd_signal.3c @@ -7,7 +7,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH BSD_SIGNAL 3C "Jul 24, 2002" +.TH BSD_SIGNAL 3C "May 13, 2017" .SH NAME bsd_signal \- simplified signal facilities .SH SYNOPSIS @@ -19,7 +19,6 @@ bsd_signal \- simplified signal facilities .fi .SH DESCRIPTION -.sp .LP The \fBbsd_signal()\fR function provides a partially compatible interface for programs written to historical system interfaces (see \fBUSAGE\fR below). @@ -61,28 +60,24 @@ where \fIsig\fR is the signal number. The behavior is undefined if \fIfunc\fR is a function that takes more than one argument, or an argument of a different type. .SH RETURN VALUES -.sp .LP Upon successful completion, \fBbsd_signal()\fR returns the previous action for \fIsig\fR. Otherwise, \fBSIG_ERR\fR is returned and \fBerrno\fR is set to indicate the error. .SH ERRORS -.sp .LP Refer to \fBsigaction\fR(2). .SH USAGE -.sp .LP -This function is a direct replacement for the \fBBSD\fR \fBsignal\fR(3UCB) +This function is a direct replacement for the \fBBSD\fR \fBsignal()\fR function for simple applications that are installing a single-argument signal handler function. If a \fBBSD\fR signal handler function is being installed that expects more than one argument, the application has to be modified to use -\fBsigaction\fR(2). The \fBbsd_signal()\fR function differs from -\fBsignal\fR(3UCB) in that the \fBSA_RESTART\fR flag is set and the +\fBsigaction\fR(2). The \fBbsd_signal()\fR function differs from the \fBBSD\fR +\fBsignal()\fR in that the \fBSA_RESTART\fR flag is set and the \fBSA_RESETHAND\fR will be clear when \fBbsd_signal()\fR is used. The state of -these flags is not specified for \fBsignal\fR(3UCB). +these flags is not specified for the \fBBSD\fR \fBsignal()\fR. .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -98,7 +93,6 @@ Interface Stability Standard .TE .SH SEE ALSO -.sp .LP \fBsigaction\fR(2), \fBsigaddset\fR(3C), \fBsigemptyset\fR(3C), -\fBsignal\fR(3UCB), \fBattributes\fR(5), \fBstandards\fR(5) +\fBattributes\fR(5), \fBstandards\fR(5) diff --git a/usr/src/man/man3c/fputc.3c b/usr/src/man/man3c/fputc.3c index 4943c8ce60..a9ea15244a 100644 --- a/usr/src/man/man3c/fputc.3c +++ b/usr/src/man/man3c/fputc.3c @@ -7,7 +7,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH FPUTC 3C "Nov 1, 2003" +.TH FPUTC 3C "May 13, 2017" .SH NAME fputc, putc, putc_unlocked, putchar, putchar_unlocked, putw \- put a byte on a stream @@ -45,7 +45,6 @@ stream .fi .SH DESCRIPTION -.sp .LP The \fBfputc()\fR function writes the byte specified by \fIc\fR (converted to an \fBunsigned char\fR) to the output stream pointed to by \fIstream\fR, at the @@ -90,7 +89,6 @@ update between the successful execution of \fBputw()\fR and the next successful completion of a call to \fBfflush\fR(3C) or \fBfclose\fR(3C) on the same stream or a call to \fBexit\fR(3C) or \fBabort\fR(3C). .SH RETURN VALUES -.sp .LP Upon successful completion, \fBfputc()\fR, \fBputc()\fR, \fBputc_unlocked()\fR, \fBputchar()\fR, and \fBputchar_unlocked()\fR return the value that was @@ -106,7 +104,6 @@ sets \fBerrno\fR to indicate the error. An unsuccessful completion will occur, for example, if the file associated with \fIstream\fR is not open for writing or if the output file cannot grow. .SH ERRORS -.sp .LP The \fBfputc()\fR, \fBputc()\fR, \fBputc_unlocked()\fR, \fBputchar()\fR, \fBputchar_unlocked()\fR, and \fBputw()\fR functions will fail if either the @@ -138,7 +135,7 @@ for writing. \fB\fBEFBIG\fR\fR .ad .RS 10n -An attempt was made to write to a file that exceeds the maximum file size or +An attempt was made to write to a file that exceeds the maximum file size or the process' file size limit. .RE @@ -168,7 +165,7 @@ was transferred. \fB\fBEIO\fR\fR .ad .RS 10n -A physical I/O error has occurred, or the process is a member of a background +A physical I/O error has occurred, or the process is a member of a background process group attempting to write to its controlling terminal, \fBTOSTOP\fR is set, the process is neither ignoring nor blocking \fBSIGTTOU\fR and the process group of the process is orphaned. This error may also be returned under @@ -219,7 +216,6 @@ capabilities of the device. .RE .SH USAGE -.sp .LP Functions exist for the \fBputc()\fR, \fBputc_unlocked()\fR, \fBputchar()\fR, and \fBputchar_unlocked()\fR macros. To get the function form, the macro name @@ -244,7 +240,6 @@ in the context of either multibyte character streams or wide-character streams. Application programmers are encouraged to use one of the character-based output functions instead. .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -264,15 +259,13 @@ MT-Level See \fBNOTES\fR below. .TE .SH SEE ALSO -.sp .LP \fBgetrlimit\fR(2), \fBulimit\fR(2) \fBwrite\fR(2), \fBIntro\fR(3), \fBabort\fR(3C), \fBexit\fR(3C), \fBfclose\fR(3C), \fBferror\fR(3C), -\fBfflush\fR(3C), \fBflockfile\fR(3C), \fBfopen\fR(3UCB), \fBprintf\fR(3C), +\fBfflush\fR(3C), \fBflockfile\fR(3C), \fBprintf\fR(3C), \fBputc\fR(3C), \fBputs\fR(3C), \fBsetbuf\fR(3C), \fBstdio\fR(3C), \fBattributes\fR(5), \fBstandards\fR(5) .SH NOTES -.sp .LP The \fBfputc()\fR, \fBputc()\fR, \fBputchar()\fR, and \fBputw()\fR routines are MT-Safe in multithreaded applications. The \fBputc_unlocked()\fR and diff --git a/usr/src/man/man3c/fseek.3c b/usr/src/man/man3c/fseek.3c index 7db56303c2..50e23871d0 100644 --- a/usr/src/man/man3c/fseek.3c +++ b/usr/src/man/man3c/fseek.3c @@ -7,7 +7,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH FSEEK 3C "Nov 1, 2003" +.TH FSEEK 3C "May 13, 2017" .SH NAME fseek, fseeko \- reposition a file-position indicator in a stream .SH SYNOPSIS @@ -24,7 +24,6 @@ fseek, fseeko \- reposition a file-position indicator in a stream .fi .SH DESCRIPTION -.sp .LP The \fBfseek()\fR function sets the file-position indicator for the stream pointed to by \fIstream\fR. The \fBfseeko()\fR function is identical to @@ -94,12 +93,10 @@ underlying file, \fBfseek()\fR will cause the unwritten data to be written to the file and mark the \fBst_ctime\fR and \fBst_mtime\fR fields of the file for update. .SH RETURN VALUES -.sp .LP The \fBfseek()\fR and \fBfseeko()\fR functions return \fB0\fR on success; otherwise, they returned \fB\(mi1\fR and set \fBerrno\fR to indicate the error. .SH ERRORS -.sp .LP The \fBfseek()\fR and \fBfseeko()\fR functions will fail if, either the \fIstream\fR is unbuffered or the \fIstream\fR's buffer needed to be flushed, @@ -235,7 +232,6 @@ correctly in an object of type \fBoff_t\fR. .RE .SH USAGE -.sp .LP Although on the UNIX system an offset returned by \fBftell()\fR or \fBftello()\fR (see \fBftell\fR(3C)) is measured in bytes, and it is @@ -248,7 +244,6 @@ necessarily measured in bytes. The \fBfseeko()\fR function has a transitional interface for 64-bit file offsets. See \fBlf64\fR(5). .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -266,8 +261,7 @@ MT-Level MT-Safe .TE .SH SEE ALSO -.sp .LP -\fBgetrlimit\fR(2), \fBulimit\fR(2), \fBfopen\fR(3UCB), \fBftell\fR(3C), +\fBgetrlimit\fR(2), \fBulimit\fR(2), \fBftell\fR(3C), \fBrewind\fR(3C), \fBungetc\fR(3C), \fBungetwc\fR(3C), \fBattributes\fR(5), \fBlf64\fR(5), \fBstandards\fR(5) diff --git a/usr/src/man/man3c/ndbm.3c b/usr/src/man/man3c/ndbm.3c index 786f92db24..b9f4e24cf2 100644 --- a/usr/src/man/man3c/ndbm.3c +++ b/usr/src/man/man3c/ndbm.3c @@ -5,7 +5,7 @@ .\" http://www.opengroup.org/bookstore/. .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. -.TH NDBM 3C "Sep 17, 2001" +.TH NDBM 3C "May 13, 2017" .SH NAME ndbm, dbm_clearerr, dbm_close, dbm_delete, dbm_error, dbm_fetch, dbm_firstkey, dbm_nextkey, dbm_open, dbm_store \- database functions @@ -58,12 +58,11 @@ dbm_nextkey, dbm_open, dbm_store \- database functions .fi .SH DESCRIPTION -.sp .LP These functions create, access and modify a database. They maintain \fIkey\fR/\fIcontent\fR pairs in a database. The functions will handle large databases (up to a billion blocks) and will access a keyed item in one or two -file system accesses. This package replaces the earlier \fBdbm\fR(3UCB) +file system accesses. This package replaces the earlier \fBdbm\fR library, which managed only a single database. .sp .LP @@ -152,7 +151,6 @@ returned from a call to \fBdbm_open()\fR. .LP These database functions support key/content pairs of at least 1024 bytes. .SH RETURN VALUES -.sp .LP The \fBdbm_store()\fR and \fBdbm_delete()\fR functions return \fB0\fR when they succeed and a negative value when they fail. @@ -185,11 +183,9 @@ The \fBdbm_open()\fR function returns a pointer to a database structure. If an error is detected during the operation, \fBdbm_open()\fR returns a (\fBDBM *\fR)0. .SH ERRORS -.sp .LP No errors are defined. .SH USAGE -.sp .LP The following code can be used to traverse the database: .sp @@ -263,7 +259,6 @@ main() .in -2 .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -281,12 +276,10 @@ MT-Level Unsafe .TE .SH SEE ALSO -.sp .LP \fBar\fR(1), \fBcat\fR(1), \fBcp\fR(1), \fBtar\fR(1), \fBopen\fR(2), -\fBdbm\fR(3UCB), \fBnetconfig\fR(4), \fBattributes\fR(5), \fBstandards\fR(5) +\fBnetconfig\fR(4), \fBattributes\fR(5), \fBstandards\fR(5) .SH NOTES -.sp .LP The \fB\&.pag\fR file will contain holes so that its apparent size may be larger than its actual content. Older versions of the UNIX operating system may @@ -312,5 +305,5 @@ updating and reading is risky. .LP The database files (\fBfile\fR\fB\&.dir\fR and \fBfile\fR\fB\&.pag\fR) are binary and are architecture-specific (for example, they depend on the -architecture's byte order.) These files are not guaranteed to be portable +architecture's byte order.) These files are not guaranteed to be portable across architectures. diff --git a/usr/src/man/man3c/syslog.3c b/usr/src/man/man3c/syslog.3c index 3a3b78a583..1b4dbe6ea3 100644 --- a/usr/src/man/man3c/syslog.3c +++ b/usr/src/man/man3c/syslog.3c @@ -7,7 +7,7 @@ .\" are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical .\" and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. .\" This notice shall appear on any product containing this material. -.TH SYSLOG 3C "Mar 16, 2009" +.TH SYSLOG 3C "May 13, 2017" .SH NAME syslog, openlog, closelog, setlogmask \- control system log .SH SYNOPSIS @@ -45,7 +45,7 @@ timestamp, a tag string, and optionally the process ID. .sp .LP The message body is generated from the \fImessage\fR and following arguments in -the same manner as if these were arguments to \fBprintf\fR(3UCB), except that +the same manner as if these were arguments to \fBprintf\fR(3C), except that occurrences of \fB%m\fR in the format string pointed to by the \fImessage\fR argument are replaced by the error message string associated with the current value of \fBerrno\fR. A trailing \fBNEWLINE\fR character is added if needed. @@ -461,7 +461,7 @@ call to \fBsyslog\fR: .LP A locally-written utility could use the following call to \fBsyslog()\fR to log a message at priority \fBLOG_INFO\fR to be treated by \fBsyslogd\fR(1M) as -other messages to the facility \fBLOG_LOCAL2\fR are: +other messages to the facility \fBLOG_LOCAL2\fR are: .sp .in +2 @@ -494,5 +494,5 @@ Standard See \fBstandards\fR(5). .LP \fBat\fR(1), \fBcrontab\fR(1), \fBlogger\fR(1), \fBlogin\fR(1), \fBlpc\fR(1B), \fBlpr\fR(1B), \fBauditd\fR(1M), \fBcron\fR(1M), \fBgetty\fR(1M), -\fBsu\fR(1M), \fBsyslogd\fR(1M), \fBprintf\fR(3UCB), +\fBsu\fR(1M), \fBsyslogd\fR(1M), \fBprintf\fR(3C), \fBsyslog.conf\fR(4), \fBattributes\fR(5), \fBstandards\fR(5) |