diff options
Diffstat (limited to 'usr/src/man/man2')
142 files changed, 996 insertions, 3604 deletions
diff --git a/usr/src/man/man2/Intro.2 b/usr/src/man/man2/Intro.2 index ad92060030..6194a6a260 100644 --- a/usr/src/man/man2/Intro.2 +++ b/usr/src/man/man2/Intro.2 @@ -4,7 +4,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 Intro 2 "17 Nov 2008" "SunOS 5.11" "System Calls" +.TH INTRO 2 "Nov 17, 2008" .SH NAME Intro, intro \- introduction to system calls and error numbers .SH SYNOPSIS @@ -55,12 +55,10 @@ following is a complete list of the error numbers and their names as defined in <\fBerrno.h\fR>. .sp .ne 2 -.mk .na \fB1 EPERM\fR .ad .RS 23n -.rt Lacking appropriate privileges .sp Typically this error indicates an attempt to modify a file in some way @@ -74,12 +72,10 @@ to override the restriction. .sp .ne 2 -.mk .na \fB2 ENOENT\fR .ad .RS 23n -.rt No such file or directory .sp A file name is specified and the file should exist but doesn't, or one of the @@ -88,12 +84,10 @@ directories in a path name does not exist. .sp .ne 2 -.mk .na \fB3 ESRCH\fR .ad .RS 23n -.rt No such process, LWP, or thread .sp No process can be found in the system that corresponds to the specified @@ -102,12 +96,10 @@ No process can be found in the system that corresponds to the specified .sp .ne 2 -.mk .na \fB4 EINTR\fR .ad .RS 23n -.rt Interrupted system call .sp An asynchronous signal (such as interrupt or quit), which the user has elected @@ -121,12 +113,10 @@ thread or \fBLWP\fR calls \fBfork\fR(2). .sp .ne 2 -.mk .na \fB5 EIO\fR .ad .RS 23n -.rt I/O error .sp Some physical I/O error has occurred. This error may in some cases occur on a @@ -135,12 +125,10 @@ call following the one to which it actually applies. .sp .ne 2 -.mk .na \fB6 ENXIO\fR .ad .RS 23n -.rt No such device or address .sp I/O on a special file refers to a subdevice which does not exist, or exists @@ -150,12 +138,10 @@ drive is not on-line or no disk pack is loaded on a drive. .sp .ne 2 -.mk .na \fB7 E2BIG\fR .ad .RS 23n -.rt Arg list too long .sp An argument list longer than \fBARG_MAX\fR bytes is presented to a member of @@ -166,12 +152,10 @@ exported shell variables. .sp .ne 2 -.mk .na \fB8 ENOEXEC\fR .ad .RS 23n -.rt Exec format error .sp A request is made to execute a file which, although it has the appropriate @@ -180,12 +164,10 @@ permissions, does not start with a valid format (see \fBa.out\fR(4)). .sp .ne 2 -.mk .na \fB9 EBADF\fR .ad .RS 23n -.rt Bad file number .sp Either a file descriptor refers to no open file, or a \fBread\fR(2) @@ -195,12 +177,10 @@ writing (respectively, reading). .sp .ne 2 -.mk .na \fB10 ECHILD\fR .ad .RS 23n -.rt No child processes .sp A \fBwait\fR(3C) function call was executed by a process that had no existing @@ -209,12 +189,10 @@ or unwaited-for child processes. .sp .ne 2 -.mk .na \fB11 EAGAIN\fR .ad .RS 23n -.rt No more processes, or no more LWPs .sp For example, the \fBfork\fR(2) function failed because the system's process @@ -224,12 +202,10 @@ call failed because of insufficient memory or swap space. .sp .ne 2 -.mk .na \fB12 ENOMEM\fR .ad .RS 23n -.rt Not enough space .sp During execution of \fBbrk()\fR or \fBsbrk()\fR (see \fBbrk\fR(2)), or one of @@ -243,12 +219,10 @@ function. .sp .ne 2 -.mk .na \fB13 EACCES\fR .ad .RS 23n -.rt Permission denied .sp An attempt was made to access a file in a way forbidden by the protection @@ -260,12 +234,10 @@ to override the protection system. .sp .ne 2 -.mk .na \fB14 EFAULT\fR .ad .RS 23n -.rt Bad address .sp The system encountered a hardware fault in attempting to use an argument of a @@ -278,12 +250,10 @@ address to a routine will result in undefined behavior. .sp .ne 2 -.mk .na \fB15 ENOTBLK\fR .ad .RS 23n -.rt Block device required .sp A non-block device or file was mentioned where a block device was required (for @@ -292,12 +262,10 @@ example, in a call to the \fBmount\fR(2) function). .sp .ne 2 -.mk .na \fB16 EBUSY\fR .ad .RS 23n -.rt Device busy .sp An attempt was made to mount a device that was already mounted or an attempt @@ -311,12 +279,10 @@ held, and by the processor control function \fBP_ONLINE\fR. .sp .ne 2 -.mk .na \fB17 EEXIST\fR .ad .RS 23n -.rt File exists .sp An existing file was mentioned in an inappropriate context (for example, call @@ -325,12 +291,10 @@ to the \fBlink\fR(2) function). .sp .ne 2 -.mk .na \fB18 EXDEV\fR .ad .RS 23n -.rt Cross-device link .sp A hard link to a file on another device was attempted. @@ -338,12 +302,10 @@ A hard link to a file on another device was attempted. .sp .ne 2 -.mk .na \fB19 ENODEV\fR .ad .RS 23n -.rt No such device .sp An attempt was made to apply an inappropriate operation to a device (for @@ -352,12 +314,10 @@ example, read a write-only device). .sp .ne 2 -.mk .na \fB20 ENOTDIR\fR .ad .RS 23n -.rt Not a directory .sp A non-directory was specified where a directory is required (for example, in a @@ -366,12 +326,10 @@ path prefix or as an argument to the \fBchdir\fR(2) function). .sp .ne 2 -.mk .na \fB21 EISDIR\fR .ad .RS 23n -.rt Is a directory .sp An attempt was made to write on a directory. @@ -379,12 +337,10 @@ An attempt was made to write on a directory. .sp .ne 2 -.mk .na \fB22 EINVAL\fR .ad .RS 23n -.rt Invalid argument .sp An invalid argument was specified (for example, unmounting a non-mounted @@ -395,12 +351,10 @@ attributes was attempted. .sp .ne 2 -.mk .na \fB23 ENFILE\fR .ad .RS 23n -.rt File table overflow .sp The system file table is full (that is, \fBSYS_OPEN\fR files are open, and @@ -409,12 +363,10 @@ temporarily no more files can be opened). .sp .ne 2 -.mk .na \fB24 EMFILE\fR .ad .RS 23n -.rt Too many open files .sp No process may have more than \fBOPEN_MAX\fR file descriptors open at a time. @@ -422,12 +374,10 @@ No process may have more than \fBOPEN_MAX\fR file descriptors open at a time. .sp .ne 2 -.mk .na \fB25 ENOTTY\fR .ad .RS 23n -.rt Inappropriate ioctl for device .sp A call was made to the \fBioctl\fR(2) function specifying a file that is not a @@ -436,12 +386,10 @@ special character device. .sp .ne 2 -.mk .na \fB26 ETXTBSY\fR .ad .RS 23n -.rt Text file busy (obsolete) .sp An attempt was made to execute a pure-procedure program that is currently open @@ -451,12 +399,10 @@ program that is being executed. \fB(This message is obsolete.)\fR .sp .ne 2 -.mk .na \fB27 EFBIG\fR .ad .RS 23n -.rt File too large .sp The size of the file exceeded the limit specified by resource @@ -468,12 +414,10 @@ below. .sp .ne 2 -.mk .na \fB28 ENOSPC\fR .ad .RS 23n -.rt No space left on device .sp While writing an ordinary file or creating a directory entry, there is no free @@ -484,12 +428,10 @@ more record entries left on the system. .sp .ne 2 -.mk .na \fB29 ESPIPE\fR .ad .RS 23n -.rt Illegal seek .sp A call to the \fBlseek\fR(2) function was issued to a pipe. @@ -497,12 +439,10 @@ A call to the \fBlseek\fR(2) function was issued to a pipe. .sp .ne 2 -.mk .na \fB30 EROFS\fR .ad .RS 23n -.rt Read-only file system .sp An attempt to modify a file or directory was made on a device mounted @@ -511,12 +451,10 @@ read-only. .sp .ne 2 -.mk .na \fB31 EMLINK\fR .ad .RS 23n -.rt Too many links .sp An attempt to make more than the maximum number of links, \fBLINK_MAX\fR, to a @@ -525,12 +463,10 @@ file. .sp .ne 2 -.mk .na \fB32 EPIPE\fR .ad .RS 23n -.rt Broken pipe .sp A write on a pipe for which there is no process to read the data. This @@ -540,12 +476,10 @@ ignored. .sp .ne 2 -.mk .na \fB33 EDOM\fR .ad .RS 23n -.rt Math argument out of domain of function .sp The argument of a function in the math package (3M) is out of the domain of the @@ -554,12 +488,10 @@ function. .sp .ne 2 -.mk .na \fB34 ERANGE\fR .ad .RS 23n -.rt Math result not representable .sp The value of a function in the math package (3M) is not representable within @@ -568,12 +500,10 @@ machine precision. .sp .ne 2 -.mk .na \fB35 ENOMSG\fR .ad .RS 23n -.rt No message of desired type .sp An attempt was made to receive a message of a type that does not exist on the @@ -582,12 +512,10 @@ specified message queue (see \fBmsgrcv\fR(2)). .sp .ne 2 -.mk .na \fB36 EIDRM\fR .ad .RS 23n -.rt Identifier removed .sp This error is returned to processes that resume execution due to the removal of @@ -597,100 +525,82 @@ an identifier from the file system's name space (see \fBmsgctl\fR(2), .sp .ne 2 -.mk .na \fB37 ECHRNG\fR .ad .RS 23n -.rt Channel number out of range .RE .sp .ne 2 -.mk .na \fB38 EL2NSYNC\fR .ad .RS 23n -.rt Level 2 not synchronized .RE .sp .ne 2 -.mk .na \fB39 EL3HLT\fR .ad .RS 23n -.rt Level 3 halted .RE .sp .ne 2 -.mk .na \fB40 EL3RST\fR .ad .RS 23n -.rt Level 3 reset .RE .sp .ne 2 -.mk .na \fB41 ELNRNG\fR .ad .RS 23n -.rt Link number out of range .RE .sp .ne 2 -.mk .na \fB42 EUNATCH\fR .ad .RS 23n -.rt Protocol driver not attached .RE .sp .ne 2 -.mk .na \fB43 ENOCSI\fR .ad .RS 23n -.rt No CSI structure available .RE .sp .ne 2 -.mk .na \fB44 EL2HLT\fR .ad .RS 23n -.rt Level 2 halted .RE .sp .ne 2 -.mk .na \fB45 EDEADLK\fR .ad .RS 23n -.rt Deadlock condition .sp A deadlock situation was detected and avoided. This error pertains to file and @@ -700,12 +610,10 @@ and r/w locks. .sp .ne 2 -.mk .na \fB46 ENOLCK\fR .ad .RS 23n -.rt No record locks available .sp There are no more locks available. The system lock table is full (see @@ -714,12 +622,10 @@ There are no more locks available. The system lock table is full (see .sp .ne 2 -.mk .na \fB47 ECANCELED\fR .ad .RS 23n -.rt Operation canceled .sp The associated asynchronous operation was canceled before completion. @@ -727,12 +633,10 @@ The associated asynchronous operation was canceled before completion. .sp .ne 2 -.mk .na \fB48 ENOTSUP\fR .ad .RS 23n -.rt Not supported .sp This version of the system does not support this feature. Future versions of @@ -741,12 +645,10 @@ the system may provide support. .sp .ne 2 -.mk .na \fB49 EDQUOT\fR .ad .RS 23n -.rt Disc quota exceeded .sp A \fBwrite\fR(2) to an ordinary file, the creation of a directory or symbolic @@ -757,23 +659,19 @@ file failed because the user's quota of inodes was exhausted. .sp .ne 2 -.mk .na \fB58-59\fR .ad .RS 23n -.rt Reserved .RE .sp .ne 2 -.mk .na \fB60 ENOSTR\fR .ad .RS 23n -.rt Device not a stream .sp A \fBputmsg\fR(2) or \fBgetmsg\fR(2) call was attempted on a file descriptor @@ -782,23 +680,19 @@ that is not a STREAMS device. .sp .ne 2 -.mk .na \fB61 ENODATA\fR .ad .RS 23n -.rt No data available .RE .sp .ne 2 -.mk .na \fB62 ETIME\fR .ad .RS 23n -.rt Timer expired .sp The timer set for a STREAMS \fBioctl\fR(2) call has expired. The cause of this @@ -811,12 +705,10 @@ also returned in the case of \fB_lwp_cond_timedwait\fR(2) or .sp .ne 2 -.mk .na \fB63 ENOSR\fR .ad .RS 23n -.rt Out of stream resources .sp During a \fBSTREAMS\fR \fBopen\fR(2) call, either no \fBSTREAMS\fR queues or @@ -826,12 +718,10 @@ condition; one may recover from it if other processes release resources. .sp .ne 2 -.mk .na \fB65 ENOPKG\fR .ad .RS 23n -.rt Package not installed .sp This error occurs when users attempt to use a call from a package which has not @@ -840,12 +730,10 @@ been installed. .sp .ne 2 -.mk .na \fB71 EPROTO\fR .ad .RS 23n -.rt Protocol error .sp Some protocol error occurred. This error is device-specific, but is generally @@ -854,12 +742,10 @@ not related to a hardware failure. .sp .ne 2 -.mk .na \fB77 EBADMSG\fR .ad .RS 23n -.rt Not a data message .sp During a \fBread\fR(2), \fBgetmsg\fR(2), or \fBioctl\fR(2) \fBI_RECVFD\fR call @@ -867,34 +753,28 @@ to a STREAMS device, something has come to the head of the queue that can not be processed. That something depends on the call: .sp .ne 2 -.mk .na \fB\fBread()\fR:\fR .ad .RS 13n -.rt control information or passed file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBgetmsg()\fR:\fR .ad .RS 13n -.rt passed file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBioctl()\fR:\fR .ad .RS 13n -.rt control or data information. .RE @@ -902,12 +782,10 @@ control or data information. .sp .ne 2 -.mk .na \fB78 ENAMETOOLONG\fR .ad .RS 23n -.rt File name too long .sp The length of the path argument exceeds \fIPATH_MAX\fR, or the length of a @@ -917,23 +795,19 @@ see \fBlimits.h\fR(3HEAD). .sp .ne 2 -.mk .na \fB79 EOVERFLOW\fR .ad .RS 23n -.rt Value too large for defined data type. .RE .sp .ne 2 -.mk .na \fB80 ENOTUNIQ\fR .ad .RS 23n -.rt Name not unique on network .sp Given log name not unique. @@ -941,12 +815,10 @@ Given log name not unique. .sp .ne 2 -.mk .na \fB81 EBADFD\fR .ad .RS 23n -.rt File descriptor in bad state .sp Either a file descriptor refers to no open file or a read request was made to a @@ -955,23 +827,19 @@ file that is open only for writing. .sp .ne 2 -.mk .na \fB82 EREMCHG\fR .ad .RS 23n -.rt Remote address changed .RE .sp .ne 2 -.mk .na \fB83 ELIBACC\fR .ad .RS 23n -.rt Cannot access a needed share library .sp Trying to \fBexec\fR an \fBa.out\fR that requires a static shared library and @@ -981,12 +849,10 @@ to use it. .sp .ne 2 -.mk .na \fB84 ELIBBAD\fR .ad .RS 23n -.rt Accessing a corrupted shared library .sp Trying to \fBexec\fR an \fBa.out\fR that requires a static shared library (to @@ -996,12 +862,10 @@ static shared library is probably corrupted. .sp .ne 2 -.mk .na \fB85 ELIBSCN\fR .ad .RS 23n -.rt \fB\&.lib\fR section in \fBa.out\fR corrupted .sp Trying to \fBexec\fR an \fBa.out\fR that requires a static shared library (to @@ -1012,12 +876,10 @@ libraries are needed. The \fBa.out\fR is probably corrupted. .sp .ne 2 -.mk .na \fB86 ELIBMAX\fR .ad .RS 23n -.rt Attempting to link in more shared libraries than system limit .sp Trying to \fBexec\fR an \fBa.out\fR that requires more static shared libraries @@ -1027,12 +889,10 @@ Administration Guide: IP Services\fR .sp .ne 2 -.mk .na \fB87 ELIBEXEC\fR .ad .RS 23n -.rt Cannot \fBexec\fR a shared library directly .sp Attempting to \fBexec\fR a shared library directly. @@ -1040,12 +900,10 @@ Attempting to \fBexec\fR a shared library directly. .sp .ne 2 -.mk .na \fB88 EILSEQ\fR .ad .RS 23n -.rt Error 88 .sp Illegal byte sequence. Handle multiple characters as a single character. @@ -1053,35 +911,29 @@ Illegal byte sequence. Handle multiple characters as a single character. .sp .ne 2 -.mk .na \fB89 ENOSYS\fR .ad .RS 23n -.rt Operation not applicable .RE .sp .ne 2 -.mk .na \fB90 ELOOP\fR .ad .RS 23n -.rt Number of symbolic links encountered during path name traversal exceeds \fBMAXSYMLINKS\fR .RE .sp .ne 2 -.mk .na \fB91 ESTART\fR .ad .RS 23n -.rt Restartable system call .sp Interrupted system call should be restarted. @@ -1089,12 +941,10 @@ Interrupted system call should be restarted. .sp .ne 2 -.mk .na \fB92 ESTRPIPE\fR .ad .RS 23n -.rt If pipe/FIFO, don't sleep in stream head .sp Streams pipe error (not externally visible). @@ -1102,45 +952,37 @@ Streams pipe error (not externally visible). .sp .ne 2 -.mk .na \fB93 ENOTEMPTY\fR .ad .RS 23n -.rt Directory not empty .RE .sp .ne 2 -.mk .na \fB94 EUSERS\fR .ad .RS 23n -.rt Too many users .RE .sp .ne 2 -.mk .na \fB95 ENOTSOCK\fR .ad .RS 23n -.rt Socket operation on non-socket .RE .sp .ne 2 -.mk .na \fB96 EDESTADDRREQ\fR .ad .RS 23n -.rt Destination address required .sp A required address was omitted from an operation on a transport endpoint. @@ -1149,12 +991,10 @@ Destination address required. .sp .ne 2 -.mk .na \fB97 EMGSIZE\fR .ad .RS 23n -.rt Message too long .sp A message sent on a transport provider was larger than the internal message @@ -1163,12 +1003,10 @@ buffer or some other network limit. .sp .ne 2 -.mk .na \fB98 EPROTOTYPE\fR .ad .RS 23n -.rt Protocol wrong type for socket .sp A protocol was specified that does not support the semantics of the socket type @@ -1177,12 +1015,10 @@ requested. .sp .ne 2 -.mk .na \fB99 ENOPROTOOPT\fR .ad .RS 23n -.rt Protocol not available .sp A bad option or level was specified when getting or setting options for a @@ -1191,12 +1027,10 @@ protocol. .sp .ne 2 -.mk .na \fB120 EPROTONOSUPPORT\fR .ad .RS 23n -.rt Protocol not supported .sp The protocol has not been configured into the system or no implementation for @@ -1205,12 +1039,10 @@ it exists. .sp .ne 2 -.mk .na \fB121 ESOCKTNOSUPPORT\fR .ad .RS 23n -.rt Socket type not supported .sp The support for the socket type has not been configured into the system or no @@ -1219,12 +1051,10 @@ implementation for it exists. .sp .ne 2 -.mk .na \fB122 EOPNOTSUPP\fR .ad .RS 23n -.rt Operation not supported on transport endpoint .sp For example, trying to accept a connection on a datagram transport endpoint. @@ -1232,12 +1062,10 @@ For example, trying to accept a connection on a datagram transport endpoint. .sp .ne 2 -.mk .na \fB123 EPFNOSUPPORT\fR .ad .RS 23n -.rt Protocol family not supported .sp The protocol family has not been configured into the system or no @@ -1246,12 +1074,10 @@ implementation for it exists. Used for the Internet protocols. .sp .ne 2 -.mk .na \fB124 EAFNOSUPPORT\fR .ad .RS 23n -.rt Address family not supported by protocol family .sp An address incompatible with the requested protocol was used. @@ -1259,12 +1085,10 @@ An address incompatible with the requested protocol was used. .sp .ne 2 -.mk .na \fB125 EADDRINUSE\fR .ad .RS 23n -.rt Address already in use .sp User attempted to use an address already in use, and the protocol does not @@ -1273,12 +1097,10 @@ allow this. .sp .ne 2 -.mk .na \fB126 EADDRNOTAVAIL\fR .ad .RS 23n -.rt Cannot assign requested address .sp Results from an attempt to create a transport endpoint with an address not on @@ -1287,12 +1109,10 @@ the current machine. .sp .ne 2 -.mk .na \fB127 ENETDOWN\fR .ad .RS 23n -.rt Network is down .sp Operation encountered a dead network. @@ -1300,12 +1120,10 @@ Operation encountered a dead network. .sp .ne 2 -.mk .na \fB128 ENETUNREACH\fR .ad .RS 23n -.rt Network is unreachable .sp Operation was attempted to an unreachable network. @@ -1313,12 +1131,10 @@ Operation was attempted to an unreachable network. .sp .ne 2 -.mk .na \fB129 ENETRESET\fR .ad .RS 23n -.rt Network dropped connection because of reset .sp The host you were connected to crashed and rebooted. @@ -1326,12 +1142,10 @@ The host you were connected to crashed and rebooted. .sp .ne 2 -.mk .na \fB130 ECONNABORTED\fR .ad .RS 23n -.rt Software caused connection abort .sp A connection abort was caused internal to your host machine. @@ -1339,12 +1153,10 @@ A connection abort was caused internal to your host machine. .sp .ne 2 -.mk .na \fB131 ECONNRESET\fR .ad .RS 23n -.rt Connection reset by peer .sp A connection was forcibly closed by a peer. This normally results from a loss @@ -1353,12 +1165,10 @@ of the connection on the remote host due to a timeout or a reboot. .sp .ne 2 -.mk .na \fB132 ENOBUFS\fR .ad .RS 23n -.rt No buffer space available .sp An operation on a transport endpoint or pipe was not performed because the @@ -1367,12 +1177,10 @@ system lacked sufficient buffer space or because a queue was full. .sp .ne 2 -.mk .na \fB133 EISCONN\fR .ad .RS 23n -.rt Transport endpoint is already connected .sp A connect request was made on an already connected transport endpoint; or, a @@ -1382,12 +1190,10 @@ transport endpoint specified a destination when already connected. .sp .ne 2 -.mk .na \fB134 ENOTCONN\fR .ad .RS 23n -.rt Transport endpoint is not connected .sp A request to send or receive data was disallowed because the transport endpoint @@ -1396,12 +1202,10 @@ is not connected and (when sending a datagram) no address was supplied. .sp .ne 2 -.mk .na \fB143 ESHUTDOWN\fR .ad .RS 23n -.rt Cannot send after transport endpoint shutdown .sp A request to send data was disallowed because the transport endpoint has @@ -1410,23 +1214,19 @@ already been shut down. .sp .ne 2 -.mk .na \fB144 ETOOMANYREFS\fR .ad .RS 23n -.rt Too many references: cannot splice .RE .sp .ne 2 -.mk .na \fB145 ETIMEDOUT\fR .ad .RS 23n -.rt Connection timed out .sp A \fBconnect\fR(3SOCKET) or \fBsend\fR(3SOCKET) request failed because the @@ -1437,12 +1237,10 @@ connected party did not properly respond after a period of time; or a .sp .ne 2 -.mk .na \fB146 ECONNREFUSED\fR .ad .RS 23n -.rt Connection refused .sp No connection could be made because the target machine actively refused it. @@ -1452,12 +1250,10 @@ the remote host. .sp .ne 2 -.mk .na \fB147 EHOSTDOWN\fR .ad .RS 23n -.rt Host is down .sp A transport provider operation failed because the destination host was down. @@ -1465,12 +1261,10 @@ A transport provider operation failed because the destination host was down. .sp .ne 2 -.mk .na \fB148 EHOSTUNREACH\fR .ad .RS 23n -.rt No route to host .sp A transport provider operation was attempted to an unreachable host. @@ -1478,12 +1272,10 @@ A transport provider operation was attempted to an unreachable host. .sp .ne 2 -.mk .na \fB149 EALREADY\fR .ad .RS 23n -.rt Operation already in progress .sp An operation was attempted on a non-blocking object that already had an @@ -1492,12 +1284,10 @@ operation in progress. .sp .ne 2 -.mk .na \fB150 EINPROGRESS\fR .ad .RS 23n -.rt Operation now in progress .sp An operation that takes a long time to complete (such as a \fBconnect()\fR) was @@ -1506,12 +1296,10 @@ attempted on a non-blocking object. .sp .ne 2 -.mk .na \fB151 ESTALE\fR .ad .RS 23n -.rt Stale NFS file handle .RE diff --git a/usr/src/man/man2/__sparc_utrap_install.2 b/usr/src/man/man2/__sparc_utrap_install.2 index a40ba121a0..c331a4d6b3 100644 --- a/usr/src/man/man2/__sparc_utrap_install.2 +++ b/usr/src/man/man2/__sparc_utrap_install.2 @@ -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 __sparc_utrap_install 2 "11 Nov 1997" "SunOS 5.11" "System Calls" +.TH __SPARC_UTRAP_INSTALL 2 "Nov 11, 1997" .SH NAME __sparc_utrap_install \- install a SPARC V9 user trap handler .SH SYNOPSIS @@ -52,47 +52,46 @@ asterisk (\fB*\fR) are implemented as precise traps only. .sp .TS -tab() box; -cw(2.74i) |cw(2.76i) -lw(2.74i) |lw(2.76i) -. -\fBTrap Name\fR\fBUser Trap Type (utrap_entry_t)\fR +box; +c | c +l | l . +\fBTrap Name\fR \fBUser Trap Type (utrap_entry_t)\fR _ -\fBillegal_instruction\fRT{ +\fBillegal_instruction\fR T{ \fBUT_ILLTRAP_INSTRUCTION\fR +*\fB or UT_ILLEGAL_INSTRUCTION\fR T} _ -\fBfp_disabled\fR\fBUT_FP_DISABLED\fR +* +\fBfp_disabled\fR \fBUT_FP_DISABLED\fR +* _ -\fBfp_exception_ieee_754\fR\fBUT_FP_EXCEPTION_IEEE_754\fR + +\fBfp_exception_ieee_754\fR \fBUT_FP_EXCEPTION_IEEE_754\fR + _ -\fBfp_exception_other\fR\fBUT_FP_EXCEPTION_OTHER\fR +\fBfp_exception_other\fR \fBUT_FP_EXCEPTION_OTHER\fR _ -\fBtag_overflow\fR\fBUT_TAG_OVERFLOW\fR +* +\fBtag_overflow\fR \fBUT_TAG_OVERFLOW\fR +* _ -\fBdivision_by_zero\fR\fBUT_DIVISION_BY_ZERO\fR + +\fBdivision_by_zero\fR \fBUT_DIVISION_BY_ZERO\fR + _ -\fBmem_address_not_aligned\fR\fBUT_MEM_ADDRESS_NOT_ALIGNED\fR + +\fBmem_address_not_aligned\fR \fBUT_MEM_ADDRESS_NOT_ALIGNED\fR + _ -\fBprivileged_action\fR\fBUT_PRIVILEGED_ACTION\fR + +\fBprivileged_action\fR \fBUT_PRIVILEGED_ACTION\fR + _ -\fBprivileged_opcode\fR\fBUT_PRIVILEGED_OPCODE\fR +\fBprivileged_opcode\fR \fBUT_PRIVILEGED_OPCODE\fR _ -\fBasync_data_error\fR\fBUT_ASYNC_DATA_ERROR\fR +\fBasync_data_error\fR \fBUT_ASYNC_DATA_ERROR\fR _ -\fBtrap_instruction\fRT{ +\fBtrap_instruction\fR T{ \fBUT_TRAP_INSTRUCTION_16 \fRthrough \fBUT_TRAP_INSTRUCTION_31\fR +* T} _ T{ \fBinstruction_access_exception\fR \fBinstruction_access_MMU_miss\fR \fBinstruction_access_error\fR -T}T{ +T} T{ \fBUT_INSTRUCTION_EXCEPTION \fRor \fBUT_INSTRUCTION_PROTECTION \fRor \fBUT_INSTRUCTION_ERROR \fR T} _ T{ \fBdata_access_exception\fR \fBdata_access_MMU_miss\fR \fBdata_access_error\fR \fBdata_access_protection\fR -T}T{ +T} T{ \fBUT_DATA_EXCEPTION \fRor \fBUT_DATA_PROTECTION \fRor \fBUT_DATA_ERROR\fR T} .TE @@ -103,7 +102,6 @@ The following explanations are provided for those user trap types that are not self-explanatory. .sp .ne 2 -.mk .na \fB\fBUT_ILLTRAP_INSTRUCTION\fR\fR .ad @@ -115,7 +113,6 @@ It is always precise. .sp .ne 2 -.mk .na \fB\fBUT_ILLEGAL_INSTRUCTION\fR\fR .ad @@ -128,7 +125,6 @@ specifies the interface. The trap may be precise or deferred. .sp .ne 2 -.mk .na \fB\fBUT_PRIVILEGED_OPCODE\fR\fR .ad @@ -141,7 +137,6 @@ only specifies the interface. .sp .ne 2 -.mk .na \fB\fBUT_DATA_EXCEPTION,\fR \fBUT_INSTRUCTION_EXCEPTION\fR\fR .ad @@ -153,7 +148,6 @@ access, respectively. .sp .ne 2 -.mk .na \fB\fBUT_DATA_PROTECTION,\fR \fBUT_INSTRUCTION_PROTECTION\fR\fR .ad @@ -166,7 +160,6 @@ respectively. .sp .ne 2 -.mk .na \fB\fBUT_DATA_ERROR,\fR \fBUT_INSTRUCTION_ERROR\fR\fR .ad @@ -180,7 +173,6 @@ data or instruction access, respectively. \fB%l1\fR will contain either .sp .ne 2 -.mk .na \fB\fBUT_FP_DISABLED\fR\fR .ad @@ -247,33 +239,32 @@ indicated in the following table. .sp .TS -tab() box; -lw(1.76i) |lw(3.74i) -lw(1.76i) |lw(3.74i) -. -\fBInstructions\fR\fBAdditional Information\fR +box; +l | l +l | l . +\fBInstructions\fR \fBAdditional Information\fR _ -LD-type (LDSTUB)T{ +LD-type (LDSTUB) T{ \fB%o2\fR contains the effective address (\fIrs1\fR + \fIrs2\fR | \fIsimm13\fR). T} _ -ST-type (CAS, SWAP)T{ +ST-type (CAS, SWAP) T{ \fB%o2\fR contains the effective address (\fI rs1\fR + \fIrs2\fR |\fIsimm13\fR). T} _ -Integer arithmeticT{ +Integer arithmetic T{ \fB%o2\fR contains the \fIrs1\fR value. \fB%o3\fR contains the \fIrs2\fR | \fIsimm13\fR value. \fB%o4\fR contains the contents of the \fB%y\fR register. T} _ -Floating-point arithmeticT{ +Floating-point arithmetic T{ \fB%o2\fR contains the address of \fIrs1\fR value. \fB%o3\fR contains the address of \fIrs2\fR value. T} _ -Control-transferT{ +Control-transfer T{ \fB%o2\fR contains the target address (\fIrs1\fR + \fIrs2\fR | \fIsimm13\fR). T} _ -Asynchronous data errorsT{ +Asynchronous data errors T{ \fB%o2\fR contains the address that caused the error. \fB%o3\fR contains the effective ASI, if available, else \(mi1. T} .TE @@ -328,12 +319,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fB__sparc_utrap_install()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fItype\fR argument is not a supported user trap type; the new user trap handler address is not word aligned; the old user trap handler address cannot be returned; or the user program is not a 64-bit executable. @@ -387,13 +376,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/_lwp_cond_signal.2 b/usr/src/man/man2/_lwp_cond_signal.2 index 4300294f32..a5a3b18c65 100644 --- a/usr/src/man/man2/_lwp_cond_signal.2 +++ b/usr/src/man/man2/_lwp_cond_signal.2 @@ -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 _lwp_cond_signal 2 "8 Dec 1995" "SunOS 5.11" "System Calls" +.TH _LWP_COND_SIGNAL 2 "Dec 8, 1995" .SH NAME _lwp_cond_signal, _lwp_cond_broadcast \- signal a condition variable .SH SYNOPSIS @@ -51,23 +51,19 @@ The \fB_lwp_cond_signal()\fR and \fB_lwp_cond_broadcast()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIcvp\fR argument points to an invalid LWP condition variable. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIcvp\fR argument points to an invalid address. .RE diff --git a/usr/src/man/man2/_lwp_cond_wait.2 b/usr/src/man/man2/_lwp_cond_wait.2 index e6d6c33002..171b713ff5 100644 --- a/usr/src/man/man2/_lwp_cond_wait.2 +++ b/usr/src/man/man2/_lwp_cond_wait.2 @@ -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 _lwp_cond_wait 2 "13 Apr 2001" "SunOS 5.11" "System Calls" +.TH _LWP_COND_WAIT 2 "Apr 13, 2001" .SH NAME _lwp_cond_wait, _lwp_cond_timedwait, _lwp_cond_reltimedwait \- wait on a condition variable @@ -73,24 +73,20 @@ If any of the following conditions are detected, \fB_lwp_cond_wait()\fR, the corresponding value: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIcvp\fR argument points to an invalid LWP condition variable or the \fImp\fR argument points to an invalid LWP mutex. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fImp\fR, \fIcvp\fR, or \fIabstime\fR argument points to an illegal address. .RE @@ -102,12 +98,10 @@ If any of the following conditions occur, \fB_lwp_cond_wait()\fR, the corresponding value: .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 9n -.rt The call was interrupted by a signal or \fBfork\fR(2). .RE @@ -117,12 +111,10 @@ If any of the following conditions occur, \fB_lwp_cond_timedwait()\fR and \fB_lwp_cond_reltimedwait()\fR fail and return the corresponding value: .sp .ne 2 -.mk .na \fB\fBETIME\fR\fR .ad .RS 9n -.rt The time specified in\fIabstime\fR or \fIreltime\fR has passed. .RE diff --git a/usr/src/man/man2/_lwp_info.2 b/usr/src/man/man2/_lwp_info.2 index 05e72423ae..5ef042d167 100644 --- a/usr/src/man/man2/_lwp_info.2 +++ b/usr/src/man/man2/_lwp_info.2 @@ -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 _lwp_info 2 "8 Aug 2001" "SunOS 5.11" "System Calls" +.TH _LWP_INFO 2 "Aug 8, 2001" .SH NAME _lwp_info \- return the time-accounting information of a single LWP .SH SYNOPSIS @@ -51,12 +51,10 @@ If the following condition is detected, \fB_lwp_info()\fR returns the corresponding value: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuffer\fR argument points to an illegal address. .RE @@ -66,12 +64,10 @@ Additionally, the \fB_lwp_info()\fR function will fail for 32-bit interfaces if: .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The size of the \fBtv_sec\fR member of the \fBtimestruc_t\fR type pointed to by \fBlwp_utime\fR and \fBlwp_stime\fR is too small to contain the correct number of seconds. @@ -85,13 +81,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/_lwp_kill.2 b/usr/src/man/man2/_lwp_kill.2 index cdcb4c6462..bfb964b403 100644 --- a/usr/src/man/man2/_lwp_kill.2 +++ b/usr/src/man/man2/_lwp_kill.2 @@ -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 _lwp_kill 2 "8 Aug 2001" "SunOS 5.11" "System Calls" +.TH _LWP_KILL 2 "Aug 8, 2001" .SH NAME _lwp_kill \- send a signal to a LWP .SH SYNOPSIS @@ -38,23 +38,19 @@ If any of the following conditions occur, \fB_lwp_kill()\fR fails and returns the corresponding value: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIsig\fR argument is not a valid signal number. .RE .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 10n -.rt The \fItarget_lwp\fR argument cannot be found in the current process. .RE @@ -66,13 +62,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/_lwp_mutex_lock.2 b/usr/src/man/man2/_lwp_mutex_lock.2 index 69841cb737..5a40b63df4 100644 --- a/usr/src/man/man2/_lwp_mutex_lock.2 +++ b/usr/src/man/man2/_lwp_mutex_lock.2 @@ -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 _lwp_mutex_lock 2 "30 Jul 1992" "SunOS 5.11" "System Calls" +.TH _LWP_MUTEX_LOCK 2 "Jul 30, 1992" .SH NAME _lwp_mutex_lock, _lwp_mutex_unlock, _lwp_mutex_trylock \- mutual exclusion .SH SYNOPSIS @@ -61,23 +61,19 @@ If any of the following conditions are detected, \fB_lwp_mutex_lock()\fR, corresponding value: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fImp\fR argument points to an invalid LWP mutex. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fImp\fR argument points to an illegal address. .RE @@ -87,12 +83,10 @@ If any of the following conditions occur, \fB_lwp_mutex_trylock()\fR fails and returns the corresponding value: .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 9n -.rt The \fImp\fR argument points to a locked mutex. .RE diff --git a/usr/src/man/man2/_lwp_self.2 b/usr/src/man/man2/_lwp_self.2 index 8f117b1827..f0f72c7195 100644 --- a/usr/src/man/man2/_lwp_self.2 +++ b/usr/src/man/man2/_lwp_self.2 @@ -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 _lwp_self 2 "8 Aug 2001" "SunOS 5.11" "System Calls" +.TH _LWP_SELF 2 "Aug 8, 2001" .SH NAME _lwp_self \- get LWP identifier .SH SYNOPSIS @@ -26,13 +26,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/_lwp_sema_wait.2 b/usr/src/man/man2/_lwp_sema_wait.2 index bd9b881182..9baad89013 100644 --- a/usr/src/man/man2/_lwp_sema_wait.2 +++ b/usr/src/man/man2/_lwp_sema_wait.2 @@ -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 _lwp_sema_wait 2 "8 May 1998" "SunOS 5.11" "System Calls" +.TH _LWP_SEMA_WAIT 2 "May 8, 1998" .SH NAME _lwp_sema_wait, _lwp_sema_trywait, _lwp_sema_init, _lwp_sema_post \- semaphore operations @@ -68,23 +68,19 @@ The \fB_lwp_sema_init()\fR, \fB_lwp_sema_trywait()\fR, \fB_lwp_sema_wait()\fR, and \fB_lwp_sema_post()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIsema\fR argument points to an invalid semaphore. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIsema\fR argument points to an illegal address. .RE @@ -93,12 +89,10 @@ The \fIsema\fR argument points to an illegal address. The \fB_lwp_sema_wait()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 9n -.rt The function execution was interrupted by a signal or \fBfork\fR(2). .RE @@ -107,12 +101,10 @@ The function execution was interrupted by a signal or \fBfork\fR(2). The \fB_lwp_sema_trywait()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 9n -.rt The function was called on a semaphore with a zero count. .RE @@ -121,12 +113,10 @@ The function was called on a semaphore with a zero count. The \fB_lwp_sema_post()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The value of the \fIsema\fR argument exceeds \fBSEM_VALUE_MAX\fR. .RE diff --git a/usr/src/man/man2/_lwp_suspend.2 b/usr/src/man/man2/_lwp_suspend.2 index 6e0f4331eb..f545805f57 100644 --- a/usr/src/man/man2/_lwp_suspend.2 +++ b/usr/src/man/man2/_lwp_suspend.2 @@ -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 _lwp_suspend 2 "13 Aug 2001" "SunOS 5.11" "System Calls" +.TH _LWP_SUSPEND 2 "Aug 13, 2001" .SH NAME _lwp_suspend, _lwp_continue \- continue or suspend LWP execution .SH SYNOPSIS @@ -47,12 +47,10 @@ If the following condition occurs, \fB_lwp_suspend()\fR and \fB_lwp_continue()\fR fail and return the corresponding value: .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 9n -.rt The \fItarget_lwpid\fR argument cannot be found in the current process. .RE @@ -64,13 +62,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/access.2 b/usr/src/man/man2/access.2 index 3be767eebe..fc0ad5b901 100644 --- a/usr/src/man/man2/access.2 +++ b/usr/src/man/man2/access.2 @@ -10,7 +10,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 access 2 "16 Jun 2009" "SunOS 5.11" "System Calls" +.TH ACCESS 2 "Jun 16, 2009" .SH NAME access, faccessat \- determine accessibility of a file .SH SYNOPSIS @@ -46,45 +46,37 @@ test, \fBF_OK\fR. These constants are defined in <\fBunistd.h\fR> as follows: .sp .ne 2 -.mk .na \fB\fBR_OK\fR\fR .ad .RS 8n -.rt Test for read permission. .RE .sp .ne 2 -.mk .na \fB\fBW_OK\fR\fR .ad .RS 8n -.rt Test for write permission. .RE .sp .ne 2 -.mk .na \fB\fBX_OK\fR\fR .ad .RS 8n -.rt Test for execute or search permission. .RE .sp .ne 2 -.mk .na \fB\fBF_OK\fR\fR .ad .RS 8n -.rt Check existence of file .RE @@ -115,12 +107,10 @@ Values for \fIflag\fR are constructed by a bitwise-inclusive OR of flags from the following list, defined in \fB<fcntl.h>\fR: .sp .ne 2 -.mk .na \fB\fBAT_EACCESS\fR\fR .ad .RS 14n -.rt The checks for accessibility are performed using the effective user and group IDs instead of the real user and group ID as required in a call to \fBaccess()\fR. @@ -138,46 +128,38 @@ and \fBerrno\fR is set to indicate the error. The \fBaccess()\fR and \fBfaccessat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Permission bits of the file mode do not permit the requested access, or search permission is denied on a component of the path prefix. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the \fBaccess()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in resolving \fIpath\fR, or loop exists in symbolic links encountered during resolution of the \fIpath\fR argument. @@ -185,12 +167,10 @@ argument. .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds {\fBPATH_MAX\fR}, or a pathname component is longer than {\fBNAME_MAX\fR} while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -198,59 +178,49 @@ effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of \fIpath\fR does not name an existing file or \fIpath\fR is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a character or block device special file and the corresponding device has been retired by the fault management framework. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt Write access is requested for a file on a read-only file system. .RE @@ -259,12 +229,10 @@ Write access is requested for a file on a read-only file system. The \fBfaccessat()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 9n -.rt The \fIpath\fR argument does not specify an absolute path and the \fIfd\fR argument is neither \fBAT_FDCWD\fR nor a valid file descriptor open for reading or searching. @@ -275,35 +243,29 @@ or searching. The \fBaccess()\fR and \fBfaccessat()\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The value of the \fIamode\fR argument is invalid. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt Pathname resolution of a symbolic link produced an intermediate result whose length exceeds {\fBPATH_MAX\fR}. .RE .sp .ne 2 -.mk .na \fB\fBETXTBSY\fR\fR .ad .RS 16n -.rt Write access is requested for a pure procedure (shared text) file that is being executed. .RE @@ -313,23 +275,19 @@ executed. The \fBfaccessat()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The value of the \fIflag\fR argument is not valid. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 11n -.rt The \fIpath\fR argument is not an absolute path and \fIfd\fR is neither \fBAT_FDCWD\fR nor a file descriptor associated with a directory. .RE @@ -356,17 +314,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -StandardSee below. +Standard See below. .TE .sp diff --git a/usr/src/man/man2/acct.2 b/usr/src/man/man2/acct.2 index 8e576a2196..1306be81c2 100644 --- a/usr/src/man/man2/acct.2 +++ b/usr/src/man/man2/acct.2 @@ -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 acct 2 "20 Jan 2003" "SunOS 5.11" "System Calls" +.TH ACCT 2 "Jan 20, 2003" .SH NAME acct \- enable or disable process accounting .SH SYNOPSIS @@ -43,57 +43,47 @@ returned and \fBerrno\fR is set to indicate the error. The \fBacct()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt The file named by \fIpath\fR is not an ordinary file. .RE .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 16n -.rt An attempt is being made to enable accounting using the same file that is currently being used. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds {\fBPATH_MAX\fR}, or the length of a \fIpath\fR argument exceeds {\fBNAME_MAX\fR} while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -101,46 +91,38 @@ is in effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt One or more components of the accounting file pathname do not exist. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The {\fBPRIV_SYS_ACCT\fR} privilege is not asserted in the effective set of the calling process. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The named file resides on a read-only file system. .RE diff --git a/usr/src/man/man2/acl.2 b/usr/src/man/man2/acl.2 index 5d433da0e6..2bfea7f337 100644 --- a/usr/src/man/man2/acl.2 +++ b/usr/src/man/man2/acl.2 @@ -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 acl 2 "10 Jan 2007" "SunOS 5.11" "System Calls" +.TH ACL 2 "Jan 10, 2007" .SH NAME acl, facl \- get or set a file's Access Control List (ACL) .SH SYNOPSIS @@ -32,23 +32,19 @@ fit into buffer \fIaclbufp\fR. The \fBacl()\fR function is used to manipulate The following types are supported for \fIaclbufp\fR: .sp .ne 2 -.mk .na \fB\fBaclent_t\fR\fR .ad .RS 12n -.rt Used by the UFS file system. .RE .sp .ne 2 -.mk .na \fB\fBace_t\fR\fR .ad .RS 12n -.rt Used by the ZFS and NFSv4 file systems. .RE @@ -57,12 +53,10 @@ Used by the ZFS and NFSv4 file systems. The following values for \fIcmd\fR are supported: .sp .ne 2 -.mk .na \fB\fBSETACL\fR\fR .ad .RS 17n -.rt \fInentries\fR \fBaclent_t\fR \fBACL\fR entries, specified in buffer \fIaclbufp\fR, are stored in the file's \fBACL\fR. All directories in the path name must be searchable. @@ -70,12 +64,10 @@ name must be searchable. .sp .ne 2 -.mk .na \fB\fBGETACL\fR\fR .ad .RS 17n -.rt Buffer \fIaclbufp\fR is filled with the file's \fBaclent_t\fR \fBACL\fR entries. Read access to the file is not required, but all directories in the path name must be searchable. @@ -83,12 +75,10 @@ path name must be searchable. .sp .ne 2 -.mk .na \fB\fBGETACLCNT\fR\fR .ad .RS 17n -.rt The number of entries in the file's \fBaclent_t\fR \fBACL\fR is returned. Read access to the file is not required, but all directories in the path name must be searchable. @@ -96,12 +86,10 @@ be searchable. .sp .ne 2 -.mk .na \fB\fBACE_SETACL\fR\fR .ad .RS 17n -.rt \fInentries\fR \fBace_t\fR ACL entries, specified in buffer \fIaclbufp\fR, are stored in the file's ACL. All directories in the path name must be searchable. Write ACL access is required to change the file's ACL. @@ -109,12 +97,10 @@ Write ACL access is required to change the file's ACL. .sp .ne 2 -.mk .na \fB\fBACE_GETACL\fR\fR .ad .RS 17n -.rt Buffer \fIaclbufp\fR is filled with the file's \fBace_t\fR ACL entries. Read access to the file is required and all directories in the path name must be searchable. @@ -122,12 +108,10 @@ searchable. .sp .ne 2 -.mk .na \fB\fBACE_GETACLCNT\fR\fR .ad .RS 17n -.rt The number of entries in the file's \fBace_t\fR ACL is returned. Read access to the file is required and all directories in the path name must be searchable. @@ -147,34 +131,28 @@ Upon successful completion, \fBacl()\fR and \fBfacl()\fR return \fB0\fR if The \fBacl()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 11n -.rt The caller does not have access to a component of the pathname. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n -.rt The \fIpathp\fR or \fIaclbufp\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The \fIcmd\fR argument is not \fBGETACL\fR, \fBSETACL\fR, \fBACE_GETACL\fR, \fBGETACLCNT\fR, or \fBACE_GETACLCNT\fR; the \fIcmd\fR argument is \fBSETACL\fR and \fInentries\fR is less than 3; or the \fIcmd\fR argument is @@ -184,34 +162,28 @@ is not valid. .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 11n -.rt A disk I/O error has occurred while storing or retrieving the \fBACL.\fR .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 11n -.rt A component of the path does not exist. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 11n -.rt The \fIcmd\fR argument is \fBGETACL\fR and \fInentries\fR is less than the number of entries in the file's \fBACL\fR, or the \fIcmd\fR argument is \fBSETACL\fR and there is insufficient space in the file system to store the @@ -220,12 +192,10 @@ number of entries in the file's \fBACL\fR, or the \fIcmd\fR argument is .sp .ne 2 -.mk .na \fB\fBENOSYS\fR\fR .ad .RS 11n -.rt The \fIcmd\fR argument is \fBSETACL\fR or \fBACE_SETACL\fR and the file specified by \fIpathp\fR resides on a file system that does not support \fBACLs\fR, or the \fBacl()\fR function is not supported by this @@ -234,12 +204,10 @@ implementation. .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 11n -.rt A component of the path specified by \fIpathp\fR is not a directory, or the \fIcmd\fR argument is \fBSETACL\fR or \fBACE_SETACL\fR and an attempt is made to set a default \fBACL\fR on a file type other than a directory. @@ -247,12 +215,10 @@ to set a default \fBACL\fR on a file type other than a directory. .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt The \fIcmd\fR argument is \fBGETACL\fR, but the ACL is composed of \fBace_t\fR entries, and the ACL cannot be translated into \fBaclent_t\fR form. .sp @@ -263,24 +229,20 @@ translated into \fBaclent_t\fR form. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 11n -.rt The effective user \fBID\fR does not match the owner of the file and the process does not have appropriate privilege. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 11n -.rt The \fIcmd\fR argument is \fBSETACL\fR or \fBACE_SETACL\fR and the file specified by \fIpathp\fR resides on a file system that is mounted read-only. .RE @@ -293,13 +255,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving .TE .SH SEE ALSO diff --git a/usr/src/man/man2/adjtime.2 b/usr/src/man/man2/adjtime.2 index bcefc4398f..ef49664ab1 100644 --- a/usr/src/man/man2/adjtime.2 +++ b/usr/src/man/man2/adjtime.2 @@ -1,6 +1,6 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved -.TH adjtime 2 "20 Jan 2003" "SunOS 5.11" "System Calls" +.TH ADJTIME 2 "Jan 20, 2003" .SH NAME adjtime \- correct the time to allow synchronization of the system clock .SH SYNOPSIS @@ -57,12 +57,10 @@ returns \fB\(mi1\fR and sets \fBerrno\fR to indicate the error. The \fBadjtime()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIdelta\fR or \fIolddelta\fR argument points outside the process's allocated address space, or \fIolddelta\fR points to a region of the process's allocated address space that is not writable. @@ -70,24 +68,20 @@ allocated address space that is not writable. .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fBtv_usec\fR member of \fIdelta\fR is not within valid range (\(mi1000000 to 1000000). .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_SYS_TIME\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -97,12 +91,10 @@ calling process. Additionally, the \fBadjtime()\fR function will fail for 32-bit interfaces if: .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The size of the \fBtv_sec\fR member of the \fBtimeval\fR structure pointed to by \fIolddelta\fR is too small to contain the correct number of seconds. .RE diff --git a/usr/src/man/man2/alarm.2 b/usr/src/man/man2/alarm.2 index 73bfaaa279..c43fa7d966 100644 --- a/usr/src/man/man2/alarm.2 +++ b/usr/src/man/man2/alarm.2 @@ -4,7 +4,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 alarm 2 "6 Jun 2007" "SunOS 5.11" "System Calls" +.TH ALARM 2 "Jun 6, 2007" .SH NAME alarm \- schedule an alarm signal .SH SYNOPSIS @@ -58,15 +58,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/audit.2 b/usr/src/man/man2/audit.2 index 6d75a7b52a..883feb3768 100644 --- a/usr/src/man/man2/audit.2 +++ b/usr/src/man/man2/audit.2 @@ -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 audit 2 "16 Apr 2008" "SunOS 5.11" "System Calls" +.TH AUDIT 2 "Apr 16, 2008" .SH NAME audit \- write a record to the audit log .SH SYNOPSIS @@ -42,56 +42,46 @@ returned and \fBerrno\fR is set to indicate the error. The \fBaudit()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBE2BIG\fR\fR .ad .RS 11n -.rt The record length is greater than the maximum allowed record length. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n -.rt The \fIrecord\fR argument points outside the process's allocated address space. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The header token in the record is invalid. .RE .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt Solaris Audit is not defined for this system. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 11n -.rt The {\fBPRIV_PROC_AUDIT\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -108,15 +98,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/auditon.2 b/usr/src/man/man2/auditon.2 index 17806057a9..2db3190caf 100644 --- a/usr/src/man/man2/auditon.2 +++ b/usr/src/man/man2/auditon.2 @@ -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 auditon 2 "6 Apr 2009" "SunOS 5.11" "System Calls" +.TH AUDITON 2 "Apr 6, 2009" .SH NAME auditon \- manipulate auditing .SH SYNOPSIS @@ -28,7 +28,6 @@ command. The \fIdata\fR argument is a pointer to command-specific data. The The following commands are supported: .sp .ne 2 -.mk .na \fB\fBA_GETCOND\fR\fR .ad @@ -38,45 +37,37 @@ Return the system audit on/off/disabled condition in the integer pointed to by \fIdata\fR. The following values can be returned: .sp .ne 2 -.mk .na \fB\fBAUC_AUDITING\fR\fR .ad .RS 16n -.rt Auditing has been turned on. .RE .sp .ne 2 -.mk .na \fB\fBAUC_DISABLED\fR\fR .ad .RS 16n -.rt Auditing system has not been enabled. .RE .sp .ne 2 -.mk .na \fB\fBAUC_NOAUDIT\fR\fR .ad .RS 16n -.rt Auditing has been turned off. .RE .sp .ne 2 -.mk .na \fB\fBAUC_NOSPACE\fR\fR .ad .RS 16n -.rt Auditing has blocked due to lack of space in audit partition. .RE @@ -84,7 +75,6 @@ Auditing has blocked due to lack of space in audit partition. .sp .ne 2 -.mk .na \fB\fBA_SETCOND\fR\fR .ad @@ -95,23 +85,19 @@ by \fIdata\fR. The Solaris Audit subsystem must be enabled by \fBbsmconv\fR(1M) before auditing can be turned on. The following audit states can be set: .sp .ne 2 -.mk .na \fB\fBAUC_AUDITING\fR\fR .ad .RS 16n -.rt Turns on audit record generation. .RE .sp .ne 2 -.mk .na \fB\fBAUC_NOAUDIT\fR\fR .ad .RS 16n -.rt Turns off audit record generation. .RE @@ -119,7 +105,6 @@ Turns off audit record generation. .sp .ne 2 -.mk .na \fB\fBA_GETCLASS\fR\fR .ad @@ -132,7 +117,6 @@ event number. The preselection class mask is returned in the same structure. .sp .ne 2 -.mk .na \fB\fBA_SETCLASS\fR\fR .ad @@ -145,7 +129,6 @@ event number and class mask. .sp .ne 2 -.mk .na \fB\fBA_GETKMASK\fR\fR .ad @@ -158,7 +141,6 @@ events. .sp .ne 2 -.mk .na \fB\fBA_SETKMASK\fR\fR .ad @@ -171,7 +153,6 @@ preselect non-attributable audit events. .sp .ne 2 -.mk .na \fB\fBA_GETPINFO\fR\fR .ad @@ -187,7 +168,6 @@ should be used. .sp .ne 2 -.mk .na \fB\fBA_GETPINFO_ADDR\fR\fR .ad @@ -200,7 +180,6 @@ the specified process in the \fBauditpinfo_addr\fR structure pointed to by .sp .ne 2 -.mk .na \fB\fBA_SETPMASK\fR\fR .ad @@ -214,7 +193,6 @@ set to \fINULL\fR. .sp .ne 2 -.mk .na \fB\fBA_SETUMASK\fR\fR .ad @@ -228,7 +206,6 @@ ignored and should be set to \fINULL\fR. .sp .ne 2 -.mk .na \fB\fBA_SETSMASK\fR\fR .ad @@ -242,7 +219,6 @@ structure are ignored and should be set to \fINULL.\fR .sp .ne 2 -.mk .na \fB\fBA_GETQCTRL\fR\fR .ad @@ -261,7 +237,6 @@ parameters are returned in the \fBau_qctrl\fR structure pointed to by .sp .ne 2 -.mk .na \fB\fBA_SETQCTRL\fR\fR .ad @@ -273,45 +248,37 @@ structure containing the audit queue control parameters. The default and maximum values 'A/B' for the audit queue control parameters are: .sp .ne 2 -.mk .na \fBhigh water\fR .ad .RS 22n -.rt \fB100/10000\fR (audit records) .RE .sp .ne 2 -.mk .na \fBlow water\fR .ad .RS 22n -.rt \fB10/1024\fR (audit records) .RE .sp .ne 2 -.mk .na \fBoutput buffer size\fR .ad .RS 22n -.rt \fB1024/1048576\fR (bytes) .RE .sp .ne 2 -.mk .na \fBdelay\fR .ad .RS 22n -.rt \fB20/20000\fR (hundredths second) .RE @@ -319,7 +286,6 @@ maximum values 'A/B' for the audit queue control parameters are: .sp .ne 2 -.mk .na \fB\fBA_GETCWD\fR\fR .ad @@ -333,7 +299,6 @@ argument is the length of the buffer. .sp .ne 2 -.mk .na \fB\fBA_GETCAR\fR\fR .ad @@ -347,7 +312,6 @@ The \fIdata\fR argument points to a buffer into which the path is copied. The .sp .ne 2 -.mk .na \fB\fBA_GETSTAT\fR\fR .ad @@ -359,7 +323,6 @@ by \fIdata\fR. .sp .ne 2 -.mk .na \fB\fBA_SETSTAT\fR\fR .ad @@ -372,7 +335,6 @@ the corresponding field in the statistics structure pointed to by the .sp .ne 2 -.mk .na \fB\fBA_GETPOLICY\fR\fR .ad @@ -383,7 +345,6 @@ Return the audit policy flags in the integer pointed to by \fIdata\fR. .sp .ne 2 -.mk .na \fB\fBA_SETPOLICY\fR\fR .ad @@ -393,7 +354,6 @@ Set the audit policy flags to the values in the integer pointed to by \fIdata\fR. The following policy flags are recognized: .sp .ne 2 -.mk .na \fB\fBAUDIT_CNT\fR\fR .ad @@ -405,7 +365,6 @@ default action is to suspend processes until storage becomes available. .sp .ne 2 -.mk .na \fB\fBAUDIT_AHLT\fR\fR .ad @@ -417,7 +376,6 @@ default action is to count the number of events that could not be recorded. .sp .ne 2 -.mk .na \fB\fBAUDIT_ARGV\fR\fR .ad @@ -429,7 +387,6 @@ family of functions. The default action is not to include this information. .sp .ne 2 -.mk .na \fB\fBAUDIT_ARGE\fR\fR .ad @@ -441,7 +398,6 @@ record. The default action is not to include this information. .sp .ne 2 -.mk .na \fB\fBAUDIT_SEQ\fR\fR .ad @@ -453,7 +409,6 @@ include it. .sp .ne 2 -.mk .na \fB\fBAUDIT_TRAIL\fR\fR .ad @@ -465,7 +420,6 @@ include it. .sp .ne 2 -.mk .na \fB\fBAUDIT_GROUP\fR\fR .ad @@ -477,7 +431,6 @@ not to include it. .sp .ne 2 -.mk .na \fB\fBAUDIT_PATH\fR\fR .ad @@ -491,7 +444,6 @@ the system call. .sp .ne 2 -.mk .na \fB\fBAUDIT_WINDATA_DOWN\fR\fR .ad @@ -504,7 +456,6 @@ By default, this information is not included. .sp .ne 2 -.mk .na \fB\fBAUDIT_WINDATA_UP\fR\fR .ad @@ -517,7 +468,6 @@ default, this information is not included. .sp .ne 2 -.mk .na \fB\fBAUDIT_PERZONE\fR\fR .ad @@ -531,7 +481,6 @@ from the global zone. .sp .ne 2 -.mk .na \fB\fBAUDIT_ZONENAME\fR\fR .ad @@ -553,47 +502,39 @@ is returned and \fBerrno\fR is set to indicate the error. The \fBauditon()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBE2BIG\fR\fR .ad .RS 10n -.rt The \fIlength\fR field for the command was too small to hold the returned value. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The copy of data to/from the kernel failed. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt One of the arguments was illegal, Solaris Audit has not been installed, or the operation is not valid from a local zone. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_SYS_AUDIT\fR} privilege is not asserted in the effective set of the calling process. .sp @@ -624,15 +565,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/brk.2 b/usr/src/man/man2/brk.2 index a06fc6fbd2..e9d75ec438 100644 --- a/usr/src/man/man2/brk.2 +++ b/usr/src/man/man2/brk.2 @@ -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 brk 2 "14 Jan 1997" "SunOS 5.11" "System Calls" +.TH BRK 2 "Jan 14, 1997" .SH NAME brk, sbrk \- change the amount of space allocated for the calling process's data segment @@ -67,12 +67,10 @@ The \fBbrk()\fR and \fBsbrk()\fR functions will fail and no additional memory will be allocated if: .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt The data segment size limit as set by \fBsetrlimit()\fR (see \fBgetrlimit\fR(2)) would be exceeded; the maximum possible size of a data segment (compiled into the system) would be exceeded; insufficient space exists @@ -83,12 +81,10 @@ mapping (see \fBmmap\fR(2)). .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt Total amount of system memory available for private pages is temporarily insufficient. This may occur even though the space requested was less than the maximum data segment size (see \fBulimit\fR(2)). @@ -116,13 +112,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/chdir.2 b/usr/src/man/man2/chdir.2 index a86abff536..2049ba7dc7 100644 --- a/usr/src/man/man2/chdir.2 +++ b/usr/src/man/man2/chdir.2 @@ -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 chdir 2 "28 Dec 1996" "SunOS 5.11" "System Calls" +.TH CHDIR 2 "Dec 28, 1996" .SH NAME chdir, fchdir \- change working directory .SH SYNOPSIS @@ -43,67 +43,55 @@ indicate the error. The \fBchdir()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for any component of the path name. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fBchdir()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds \fBPATH_MAX\fR, or the length of a \fIpath\fR component exceeds \fBNAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -111,36 +99,30 @@ effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt Either a component of the path prefix or the directory named by \fIpath\fR does not exist or is a null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path name is not a directory. .RE @@ -149,68 +131,56 @@ A component of the path name is not a directory. The \fBfchdir()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 11n -.rt Search permission is denied for \fIfildes\fR. .RE .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is not an open file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 11n -.rt A signal was caught during the execution of the \fBfchdir()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 11n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 11n -.rt The open file descriptor \fIfildes\fR does not refer to a directory. .RE @@ -222,15 +192,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/chmod.2 b/usr/src/man/man2/chmod.2 index 400fdda985..cecd79a1e7 100644 --- a/usr/src/man/man2/chmod.2 +++ b/usr/src/man/man2/chmod.2 @@ -1,15 +1,15 @@ '\" te .\" Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved. -.\" Copyright 1989 AT&T. +.\" Copyright 1989 AT&T. .\" Portions Copyright (c) 2001, the Institute of Electrical and Electronics Engineers, Inc. and The Open Group. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 chmod 2 "12 Sep 2005" "SunOS 5.11" "System Calls" +.TH CHMOD 2 "Sep 12, 2005" .SH NAME chmod, fchmod \- change access permission mode of file .SH SYNOPSIS @@ -37,29 +37,27 @@ by the open file descriptor \fIfildes\fR to the bit pattern contained in .sp .TS -tab(); -lw(1.01i) lw(.69i) lw(3.79i) -lw(1.01i) lw(.69i) lw(3.79i) -. -\fBS_ISUID\fR04000Set user ID on execution. -\fBS_ISGID\fR020#0T{ +l l l +l l l . +\fBS_ISUID\fR 04000 Set user ID on execution. +\fBS_ISGID\fR 020#0 T{ Set group ID on execution if # is \fB7\fR, \fB5\fR, \fB3\fR, or \fB1\fR. Enable mandatory file/record locking if # is \fB6\fR, \fB4\fR, \fB2\fR, or \fB0\fR. T} -\fBS_ISVTX\fR01000Sticky bit. -\fBS_IRWXU\fR00700Read, write, execute by owner. -\fBS_IRUSR\fR00400Read by owner. -\fBS_IWUSR\fR00200Write by owner. -\fBS_IXUSR\fR00100T{ +\fBS_ISVTX\fR 01000 Sticky bit. +\fBS_IRWXU\fR 00700 Read, write, execute by owner. +\fBS_IRUSR\fR 00400 Read by owner. +\fBS_IWUSR\fR 00200 Write by owner. +\fBS_IXUSR\fR 00100 T{ Execute (search if a directory) by owner. T} -\fBS_IRWXG\fR00070Read, write, execute by group. -\fBS_IRGRP\fR00040Read by group. -\fBS_IWGRP\fR00020Write by group. -\fBS_IXGRP\fR00010Execute by group. -\fBS_IRWXO\fR00007Read, write, execute (search) by others. -\fBS_IROTH\fR00004Read by others. -\fBS_IWOTH\fR00002Write by others. -\fBS_IXOTH\fR00001Execute by others. +\fBS_IRWXG\fR 00070 Read, write, execute by group. +\fBS_IRGRP\fR 00040 Read by group. +\fBS_IWGRP\fR 00020 Write by group. +\fBS_IXGRP\fR 00010 Execute by group. +\fBS_IRWXO\fR 00007 Read, write, execute (search) by others. +\fBS_IROTH\fR 00004 Read by others. +\fBS_IWOTH\fR 00002 Write by others. +\fBS_IXOTH\fR 00001 Execute by others. .TE .sp @@ -158,23 +156,19 @@ error. The \fBchmod()\fR and \fBfchmod()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 9n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 9n -.rt The effective user ID does not match the owner of the file and the process does not have appropriate privilege. .sp @@ -192,12 +186,10 @@ apply. See \fBprivileges\fR(5). The \fBchmod()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied on a component of the path prefix of \fIpath\fR. The privilege {\fBFILE_DAC_SEARCH\fR} overrides file permissions restrictions in that case. @@ -205,35 +197,29 @@ in that case. .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt A loop exists in symbolic links encountered during the resolution of the \fIpath\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds \fBPATH_MAX\fR, or the length of a \fIpath\fR component exceeds \fBNAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -241,47 +227,39 @@ effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt Either a component of the path prefix or the file referred to by \fIpath\fR does not exist or is a null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIfildes\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the prefix of \fIpath\fR is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The file referred to by \fIpath\fR resides on a read-only file system. .RE @@ -290,35 +268,29 @@ The file referred to by \fIpath\fR resides on a read-only file system. The \fBfchmod()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is not an open file descriptor .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 11n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 11n -.rt The file referred to by \fIfildes\fR resides on a read-only file system. .RE @@ -327,23 +299,19 @@ The file referred to by \fIfildes\fR resides on a read-only file system. The \fBchmod()\fR and \fBfchmod()\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 10n -.rt A signal was caught during execution of the function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of the \fImode\fR argument is invalid. .RE @@ -352,24 +320,20 @@ The value of the \fImode\fR argument is invalid. The \fBchmod()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt More than {\fBSYMLOOP_MAX\fR} symbolic links were encountered during the resolution of the \fIpath\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt As a result of encountering a symbolic link in resolution of the\fIpath\fR argument, the length of the substituted pathname strings exceeds {\fBPATH_MAX\fR}. @@ -380,12 +344,10 @@ argument, the length of the substituted pathname strings exceeds The \fBfchmod()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIfildes\fR argument refers to a pipe and the system disallows execution of this function on a pipe. .RE @@ -435,7 +397,7 @@ execute, group permissions to read and execute, and other permissions to read. .in +2 .nf #include <sys/stat.h> -#define CHANGEFILE "/etc/myfile" +#define CHANGEFILE "/etc/myfile" \&... chmod(CHANGEFILE, S_IRWXU|S_IRGRP|S_IXGRP|S_IROTH); .fi @@ -480,15 +442,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/chown.2 b/usr/src/man/man2/chown.2 index fed42dd2fb..b3270cafc6 100644 --- a/usr/src/man/man2/chown.2 +++ b/usr/src/man/man2/chown.2 @@ -4,7 +4,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 chown 2 "9 Oct 2008" "SunOS 5.11" "System Calls" +.TH CHOWN 2 "Oct 9, 2008" .SH NAME chown, lchown, fchown, fchownat \- change owner and group of a file .SH SYNOPSIS @@ -28,7 +28,7 @@ chown, lchown, fchown, fchownat \- change owner and group of a file .LP .nf -\fBint\fR \fBfchownat\fR(\fBint\fR \fIfildes\fR, \fBconst char *\fR\fIpath\fR, \fBuid_t\fR \fIowner\fR, +\fBint\fR \fBfchownat\fR(\fBint\fR \fIfildes\fR, \fBconst char *\fR\fIpath\fR, \fBuid_t\fR \fIowner\fR, \fBgid_t\fR \fIgroup\fR, \fBint\fR \fIflag\fR); .fi @@ -116,12 +116,10 @@ returned, the owner and group of the named file remain unchanged, and All of these functions will fail if: .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 9n -.rt The effective user ID does not match the owner of the file and the {\fBPRIV_FILE_CHOWN\fR} privilege is not asserted in the effective set of the calling process, or the {\fBPRIV_FILE_CHOWN_SELF\fR} privilege is not asserted @@ -133,80 +131,66 @@ in the effective set of the calling process. The \fBchown()\fR, \fBlchown()\fR, and \fBfchownat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied on a component of the path prefix of \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address and for \fBfchownat()\fR, the file descriptor has the value \fBAT_FDCWD\fR. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fBchown()\fR or \fBlchown()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The \fIgroup\fR or \fIowner\fR argument is out of range. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds {\fIPATH_MAX\fR}, or the length of a \fIpath\fR component exceeds {\fINAME_MAX\fR} while {\fB_POSIX_NO_TRUNC\fR} is in effect. @@ -214,36 +198,30 @@ of a \fIpath\fR component exceeds {\fINAME_MAX\fR} while .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt Either a component of the path prefix or the file referred to by \fIpath\fR does not exist or is a null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix of \fIpath\fR is not a directory, or the path supplied to \fBfchownat()\fR is relative and the file descriptor provided does not refer to a valid directory. @@ -251,12 +229,10 @@ not refer to a valid directory. .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The named file resides on a read-only file system. .RE @@ -265,12 +241,10 @@ The named file resides on a read-only file system. The \fBfchown()\fR and \fBfchownat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 11n -.rt For \fBfchown()\fR the \fIfildes\fR argument is not an open file descriptor and. .sp @@ -280,57 +254,47 @@ For \fBfchownat()\fR, the \fIpath\fR argument is not absolute and the .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 11n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 11n -.rt A signal was caught during execution of the function. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The \fIgroup\fR or \fIowner\fR argument is out of range. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 11n -.rt The named file referred to by \fIfildes\fR resides on a read-only file system. .RE @@ -342,15 +306,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. _ -MT-LevelSee below. +MT-Level See below. .TE .sp diff --git a/usr/src/man/man2/chroot.2 b/usr/src/man/man2/chroot.2 index 566e732f03..2c81f34038 100644 --- a/usr/src/man/man2/chroot.2 +++ b/usr/src/man/man2/chroot.2 @@ -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 chroot 2 "20 Jan 2003" "SunOS 5.11" "System Calls" +.TH CHROOT 2 "Jan 20, 2003" .SH NAME chroot, fchroot \- change root directory .SH SYNOPSIS @@ -56,12 +56,10 @@ indicate the error. The \fBchroot()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a component of the path prefix of \fIdirname\fR, or search permission is denied for the directory referred to by \fIdirname\fR. @@ -69,79 +67,65 @@ Search permission is denied for a component of the path prefix of .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 16n -.rt The descriptor is not valid. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The \fBfchroot()\fR function attempted to change to a directory the is not the system root and external circumstances do not allow this. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fBchroot()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds \fBPATH_MAX\fR, or the length of a \fIpath\fR component exceeds \fB\fR\fBNAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -149,46 +133,38 @@ is in effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The named directory does not exist or is a null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt Any component of the path name is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The {\fBPRIV_PROC_CHROOT\fR} privilege is not asserted in the effective set of the calling process. .RE diff --git a/usr/src/man/man2/close.2 b/usr/src/man/man2/close.2 index e9fa7a805c..61dce6f38c 100644 --- a/usr/src/man/man2/close.2 +++ b/usr/src/man/man2/close.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 2005, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 close 2 "18 Oct 2005" "SunOS 5.11" "System Calls" +.TH CLOSE 2 "Oct 18, 2005" .SH NAME close \- close a file descriptor .SH SYNOPSIS @@ -112,46 +112,38 @@ returned and \fBerrno\fR is set to indicate the error. The \fBclose()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 11n -.rt The \fBclose()\fR function was interrupted by a signal. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is on a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 11n -.rt There was no free space remaining on the device containing the file. .RE @@ -160,12 +152,10 @@ There was no free space remaining on the device containing the file. The \fBclose()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 7n -.rt An I/O error occurred while reading from or writing to the file system. .RE @@ -249,15 +239,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/creat.2 b/usr/src/man/man2/creat.2 index 14ae004beb..40bf6ffba4 100644 --- a/usr/src/man/man2/creat.2 +++ b/usr/src/man/man2/creat.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 1997, The Open Group. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 creat 2 "25 Mar 2002" "SunOS 5.11" "System Calls" +.TH CREAT 2 "Mar 25, 2002" .SH NAME creat \- create a new file or rewrite an existing one .SH SYNOPSIS @@ -78,15 +78,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/dup.2 b/usr/src/man/man2/dup.2 index dc0d066dae..dcb3bf0b20 100644 --- a/usr/src/man/man2/dup.2 +++ b/usr/src/man/man2/dup.2 @@ -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 dup 2 "28 Dec 1996" "SunOS 5.11" "System Calls" +.TH DUP 2 "Dec 28, 1996" .SH NAME dup \- duplicate an open file descriptor .SH SYNOPSIS @@ -62,45 +62,37 @@ set to indicate the error. The \fBdup()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is not a valid open file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 11n -.rt A signal was caught during the execution of the \fBdup()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEMFILE\fR\fR .ad .RS 11n -.rt The process has too many open files (see \fBgetrlimit\fR(2)). .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is on a remote machine and the link to that machine is no longer active. .RE @@ -113,15 +105,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/exec.2 b/usr/src/man/man2/exec.2 index 97e0ae3e0d..ec5cbe64f3 100644 --- a/usr/src/man/man2/exec.2 +++ b/usr/src/man/man2/exec.2 @@ -1,15 +1,15 @@ '\" te .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved. -.\" Copyright 1989 AT&T. +.\" Copyright 1989 AT&T. .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 exec 2 "16 Jun 2008" "SunOS 5.11" "System Calls" +.TH EXEC 2 "Jun 16, 2008" .SH NAME exec, execl, execle, execlp, execv, execve, execvp \- execute a file .SH SYNOPSIS @@ -17,7 +17,7 @@ exec, execl, execle, execlp, execv, execve, execvp \- execute a file .nf #include <unistd.h> -\fBint\fR \fBexecl\fR(\fBconst char *\fR\fIpath\fR, \fBconst char *\fR\fIarg0\fR, \fB\&... +\fBint\fR \fBexecl\fR(\fBconst char *\fR\fIpath\fR, \fBconst char *\fR\fIarg0\fR, \fB\&... /* const char *\fR\fIargn\fR, \fB(char *)0 */);\fR .fi @@ -510,12 +510,10 @@ indicate the error. The \fBexec\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBE2BIG\fR\fR .ad .RS 16n -.rt The number of bytes in the new process's argument list is greater than the system-imposed limit of {\fBARG_MAX\fR} bytes. The argument list limit is sum of the size of the argument list plus the size of the environment's exported @@ -524,12 +522,10 @@ shell variables. .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a directory listed in the new process file's path prefix. .sp @@ -546,35 +542,29 @@ permission. .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 16n -.rt Total amount of system memory available when reading using raw I/O is temporarily insufficient. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt An argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The new process image file has the appropriate permission and has a recognized executable binary format, but the system does not support execution of a file with this format. @@ -582,36 +572,30 @@ with this format. .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of one of the functions in the \fIexec\fR family. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR or \fIfile\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIfile\fR or \fIpath\fR argument exceeds {\fBPATH_MAX\fR}, or the length of a \fIfile\fR or \fIpath\fR component exceeds {\fBNAME_MAX\fR} while {\fB_POSIX_NO_TRUNC\fR} is in effect. @@ -619,36 +603,30 @@ while {\fB_POSIX_NO_TRUNC\fR} is in effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt One or more components of the new process path name of the file do not exist or is a null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the new process path of the file prefix is not a directory. .RE @@ -658,12 +636,10 @@ The \fBexec\fR functions, except for \fBexeclp()\fR and \fBexecvp()\fR, will fail if: .sp .ne 2 -.mk .na \fB\fBENOEXEC\fR\fR .ad .RS 11n -.rt The new process image file has the appropriate access permission but is not in the proper format. .RE @@ -673,36 +649,30 @@ the proper format. The \fBexec\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt Pathname resolution of a symbolic link produced an intermediate result whose length exceeds {\fBPATH_MAX\fR}. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 16n -.rt The new process image requires more memory than is allowed by the hardware or system-imposed by memory management constraints. See \fBbrk\fR(2). .RE .sp .ne 2 -.mk .na \fB\fBETXTBSY\fR\fR .ad .RS 16n -.rt The new process image file is a pure procedure (shared text) file that is currently open for writing by some process. .RE @@ -729,17 +699,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelSee below. +MT-Level See below. _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .sp diff --git a/usr/src/man/man2/exit.2 b/usr/src/man/man2/exit.2 index afb566828b..341b46c54b 100644 --- a/usr/src/man/man2/exit.2 +++ b/usr/src/man/man2/exit.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 exit 2 "5 Feb 2008" "SunOS 5.11" "System Calls" +.TH EXIT 2 "Feb 5, 2008" .SH NAME exit, _Exit, _exit \- terminate process .SH SYNOPSIS @@ -233,17 +233,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelSee below. +MT-Level See below. _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .sp diff --git a/usr/src/man/man2/fcntl.2 b/usr/src/man/man2/fcntl.2 index 80f6a84c7d..637a62ebf1 100644 --- a/usr/src/man/man2/fcntl.2 +++ b/usr/src/man/man2/fcntl.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 fcntl 2 "17 Jan 2007" "SunOS 5.11" "System Calls" +.TH FCNTL 2 "Jan 17, 2007" .SH NAME fcntl \- file control .SH SYNOPSIS @@ -37,12 +37,10 @@ specifies the operation to be performed by \fBfcntl()\fR. The values for \fIcmd\fR are defined in <\fBfcntl.h\fR> and include: .sp .ne 2 -.mk .na \fB\fBF_DUPFD\fR\fR .ad .RS 15n -.rt Return a new file descriptor which is the lowest numbered available (that is, not already open) file descriptor greater than or equal to the third argument, \fIarg\fR, taken as an integer of type \fBint\fR. The new file descriptor @@ -54,12 +52,10 @@ descriptor is cleared to keep the file open across calls to one of the .sp .ne 2 -.mk .na \fB\fBF_DUP2FD\fR\fR .ad .RS 15n -.rt Similar to \fBF_DUPFD\fR, but always returns \fIarg\fR. \fBF_DUP2FD\fR closes \fIarg\fR if it is open and not equal to \fIfildes.\fR \fBF_DUP2FD\fR is equivalent to \fBdup2\fR(\fIfildes\fR, \fIarg\fR). @@ -67,12 +63,10 @@ equivalent to \fBdup2\fR(\fIfildes\fR, \fIarg\fR). .sp .ne 2 -.mk .na \fB\fBF_FREESP\fR\fR .ad .RS 15n -.rt Free storage space associated with a section of the ordinary file \fIfildes\fR. The section is specified by a variable of data type \fBstruct flock\fR pointed to by \fIarg\fR. The data type \fBstruct flock\fR is defined in the @@ -84,24 +78,20 @@ freed only at the end of a file. .sp .ne 2 -.mk .na \fB\fBF_FREESP64\fR\fR .ad .RS 15n -.rt Equivalent to \fBF_FREESP\fR, but takes a \fBstruct flock64\fR argument rather than a \fBstruct flock\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBF_ALLOCSP\fR\fR .ad .RS 15n -.rt Allocate space for a section of the ordinary file \fIfildes\fR. The section is specified by a variable of data type \fBstruct flock\fR pointed to by \fIarg\fR. The data type \fBstruct flock\fR is defined in the <\fBfcntl.h\fR> @@ -110,24 +100,20 @@ header (see \fBfcntl.h\fR(3HEAD) and is described below. .sp .ne 2 -.mk .na \fB\fBF_ALLOCSP64\fR\fR .ad .RS 15n -.rt Equivalent to \fBF_ALLOCSP\fR, but takes a \fBstruct flock64\fR argument rather than a \fBstruct flock\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBF_GETFD\fR\fR .ad .RS 15n -.rt Get the file descriptor flags defined in <\fBfcntl.h\fR> that are associated with the file descriptor \fIfildes\fR. File descriptor flags are associated with a single file descriptor and do not affect other file descriptors that @@ -136,12 +122,10 @@ refer to the same file. .sp .ne 2 -.mk .na \fB\fBF_GETFL\fR\fR .ad .RS 15n -.rt Get the file status flags and file access modes, defined in <\fBfcntl.h\fR>, for the file descriptor specified by \fIfildes\fR. The file access modes can be extracted from the return value using the mask \fBO_ACCMODE\fR, which is @@ -152,12 +136,10 @@ file descriptions. .sp .ne 2 -.mk .na \fB\fBF_GETOWN\fR\fR .ad .RS 15n -.rt If \fIfildes\fR refers to a socket, get the process or process group \fBID\fR specified to receive \fBSIGURG\fR signals when out-of-band data is available. Positive values indicate a process ID; negative values, other than \(mi1, @@ -167,12 +149,10 @@ results are unspecified. .sp .ne 2 -.mk .na \fB\fBF_GETXFL\fR\fR .ad .RS 15n -.rt Get the file status flags, file access modes, and file creation and assignment flags, defined in <\fBfcntl.h\fR>, for the file descriptor specified by \fIfildes\fR. The file access modes can be extracted from the return value @@ -184,12 +164,10 @@ file descriptions. .sp .ne 2 -.mk .na \fB\fBF_SETFD\fR\fR .ad .RS 15n -.rt Set the file descriptor flags defined in <\fBfcntl.h\fR>, that are associated with \fIfildes\fR, to the third argument, \fIarg\fR, taken as type \fBint\fR. If the \fBFD_CLOEXEC\fR flag in the third argument is 0, the file will remain @@ -199,12 +177,10 @@ successful execution of one of the \fBexec()\fR functions. .sp .ne 2 -.mk .na \fB\fBF_SETFL\fR\fR .ad .RS 15n -.rt Set the file status flags, defined in <\fBfcntl.h\fR>, for the file descriptor specified by \fIfildes\fR from the corresponding bits in the \fIarg\fR argument, taken as type \fBint\fR. Bits corresponding to the file access mode @@ -215,12 +191,10 @@ application, the result is unspecified. .sp .ne 2 -.mk .na \fB\fBF_SETOWN\fR\fR .ad .RS 15n -.rt If \fIfildes\fR refers to a socket, set the process or process group \fBID\fR specified to receive \fBSIGURG\fR signals when out-of-band data is available, using the value of the third argument, \fIarg\fR, taken as type \fBint\fR. @@ -235,12 +209,10 @@ The following commands are available for advisory record locking. Record locking is supported for regular files, and may be supported for other files. .sp .ne 2 -.mk .na \fB\fBF_GETLK\fR\fR .ad .RS 14n -.rt Get the first lock which blocks the lock description pointed to by the third argument, \fIarg\fR, taken as a pointer to type \fBstruct flock\fR, defined in <\fBfcntl.h\fR>. The information retrieved overwrites the information passed to @@ -251,24 +223,20 @@ except for the lock type which will be set to \fBF_UNLCK\fR. .sp .ne 2 -.mk .na \fB\fBF_GETLK64\fR\fR .ad .RS 14n -.rt Equivalent to \fBF_GETLK\fR, but takes a \fBstruct flock64\fR argument rather than a \fBstruct flock\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBF_SETLK\fR\fR .ad .RS 14n -.rt Set or clear a file segment lock according to the lock description pointed to by the third argument, \fIarg\fR, taken as a pointer to type \fBstruct flock\fR, defined in <\fBfcntl.h\fR>. \fBF_SETLK\fR is used to establish shared @@ -281,24 +249,20 @@ return value of \fB\(mi1\fR\&. .sp .ne 2 -.mk .na \fB\fBF_SETLK64\fR\fR .ad .RS 14n -.rt Equivalent to \fBF_SETLK\fR, but takes a \fBstruct flock64\fR argument rather than a \fBstruct flock\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBF_SETLKW\fR\fR .ad .RS 14n -.rt This command is the same as \fBF_SETLK\fR except that if a shared or exclusive lock is blocked by other locks, the process will wait until the request can be satisfied. If a signal that is to be caught is received while \fBfcntl()\fR is @@ -309,12 +273,10 @@ set to \fBEINTR\fR, and the lock operation will not be done. .sp .ne 2 -.mk .na \fB\fBF_SETLKW64\fR\fR .ad .RS 14n -.rt Equivalent to \fBF_SETLKW\fR, but takes a \fBstruct flock64\fR argument rather than a \fBstruct flock\fR argument. .RE @@ -338,13 +300,13 @@ The \fBflock\fR structure contains at least the following elements: .sp .in +2 .nf -short l_type; /* lock operation type */ -short l_whence; /* lock base indicator */ -off_t l_start; /* starting offset from base */ +short l_type; /* lock operation type */ +short l_whence; /* lock base indicator */ +off_t l_start; /* starting offset from base */ off_t l_len; /* lock length; l_len == 0 means - until end of file */ -int l_sysid; /* system ID running process holding lock */ -pid_t l_pid; /* process ID of process holding lock */ + until end of file */ +int l_sysid; /* system ID running process holding lock */ +pid_t l_pid; /* process ID of process holding lock */ .fi .in -2 @@ -413,24 +375,20 @@ share reservation is placed on an entire file to allow cooperating processes to control access to the file. .sp .ne 2 -.mk .na \fB\fBF_SHARE\fR\fR .ad .RS 13n -.rt Sets a share reservation on a file with the specified access mode and designates which types of access to deny. .RE .sp .ne 2 -.mk .na \fB\fBF_UNSHARE\fR\fR .ad .RS 13n -.rt Remove an existing share reservation. .RE @@ -472,34 +430,28 @@ An \fBF_UNSHARE\fR request releases the reservation with the specified Valid \fBf_access\fR values are: .sp .ne 2 -.mk .na \fB\fBF_RDACC\fR\fR .ad .RS 11n -.rt Set a file share reservation for read-only access. .RE .sp .ne 2 -.mk .na \fB\fBF_WRACC\fR\fR .ad .RS 11n -.rt Set a file share reservation for write-only access. .RE .sp .ne 2 -.mk .na \fB\fBF_RWACC\fR\fR .ad .RS 11n -.rt Set a file share reservation for read and write access. .RE @@ -508,56 +460,46 @@ Set a file share reservation for read and write access. Valid \fBf_deny\fR values are: .sp .ne 2 -.mk .na \fB\fBF_COMPAT\fR\fR .ad .RS 12n -.rt Set a file share reservation to compatibility mode. .RE .sp .ne 2 -.mk .na \fB\fBF_RDDNY\fR\fR .ad .RS 12n -.rt Set a file share reservation to deny read access to other processes. .RE .sp .ne 2 -.mk .na \fB\fBF_WRDNY\fR\fR .ad .RS 12n -.rt Set a file share reservation to deny write access to other processes. .RE .sp .ne 2 -.mk .na \fB\fBF_RWDNY\fR\fR .ad .RS 12n -.rt Set a file share reservation to deny read and write access to other processes. .RE .sp .ne 2 -.mk .na \fB\fBF_NODNY\fR\fR .ad .RS 12n -.rt Do not deny read or write access to any other process. .RE @@ -567,192 +509,158 @@ Do not deny read or write access to any other process. Upon successful completion, the value returned depends on \fIcmd\fR as follows: .sp .ne 2 -.mk .na \fB\fBF_DUPFD\fR\fR .ad .RS 14n -.rt A new file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBF_FREESP\fR\fR .ad .RS 14n -.rt Value of \fB0\fR. .RE .sp .ne 2 -.mk .na \fB\fBF_GETFD\fR\fR .ad .RS 14n -.rt Value of flags defined in \fB<fcntl.h>\fR\&. The return value will not be negative. .RE .sp .ne 2 -.mk .na \fB\fBF_GETFL\fR\fR .ad .RS 14n -.rt Value of file status flags and access modes. The return value will not be negative. .RE .sp .ne 2 -.mk .na \fB\fBF_GETLK\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_GETLK64\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_GETOWN\fR\fR .ad .RS 14n -.rt Value of the socket owner process or process group; this will not be \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_GETXFL\fR\fR .ad .RS 14n -.rt Value of file status flags, access modes, and creation and assignment flags. The return value will not be negative. .RE .sp .ne 2 -.mk .na \fB\fBF_SETFD\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_SETFL\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_SETLK\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_SETLK64\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_SETLKW\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_SETLKW64\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_SETOWN\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_SHARE\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE .sp .ne 2 -.mk .na \fB\fBF_UNSHARE\fR\fR .ad .RS 14n -.rt Value other than \fB\(mi1\fR\&. .RE @@ -766,12 +674,10 @@ error. The \fBfcntl()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBF_SETLK\fR or \fBF_SETLK64\fR, the type of lock \fB(l_type)\fR is a shared (\fBF_RDLCK\fR) or exclusive (\fBF_WRLCK\fR) lock, and the segment of a file to be locked is already exclusive-locked by another @@ -791,12 +697,10 @@ existing \fBf_deny\fR share reservation. .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 13n -.rt The \fIfildes\fR argument is not a valid open file descriptor; or the \fIcmd\fR argument is \fBF_SETLK\fR, \fBF_SETLK64\fR, \fBF_SETLKW\fR, or \fBF_SETLKW64\fR, the type of lock, \fBl_type\fR, is a shared lock @@ -821,12 +725,10 @@ reading. .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBF_GETLK\fR, \fBF_GETLK64\fR, \fBF_SETLK\fR, \fBF_SETLK64\fR, \fBF_SETLKW\fR, \fBF_SETLKW64\fR, or \fBF_FREESP\fR and the \fIarg\fR argument points to an illegal address. @@ -837,24 +739,20 @@ to an illegal address. .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBF_SETLKW\fR or \fBF_SETLKW64\fR and the function was interrupted by a signal. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is invalid or not supported by the file system; or the \fIcmd\fR argument is \fBF_DUPFD\fR and \fIarg\fR is negative or greater than or equal to \fBOPEN_MAX\fR; or the \fIcmd\fR argument is \fBF_GETLK\fR, @@ -868,23 +766,19 @@ The \fIcmd\fR argument is \fBF_UNSHARE\fR and a reservation with this .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 13n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBEMFILE\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBF_DUPFD\fR and either \fBOPEN_MAX\fR file descriptors are currently open in the calling process, or no file descriptors greater than or equal to \fIarg\fR are available. @@ -892,12 +786,10 @@ greater than or equal to \fIarg\fR are available. .sp .ne 2 -.mk .na \fB\fBENOLCK\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBF_SETLK\fR, \fBF_SETLK64\fR, \fBF_SETLKW\fR, or \fBF_SETLKW64\fR and satisfying the lock or unlock request would result in the number of locked regions in the system exceeding a system-imposed limit. @@ -905,12 +797,10 @@ number of locked regions in the system exceeding a system-imposed limit. .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 13n -.rt Either the \fIfildes\fR argument is on a remote machine and the link to that machine is no longer active; or the \fIcmd\fR argument is \fBF_FREESP\fR, the file is on a remote machine, and the link to that machine is no longer active. @@ -918,12 +808,10 @@ file is on a remote machine, and the link to that machine is no longer active. .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt One of the values to be returned cannot be represented correctly. .sp The \fIcmd\fR argument is \fBF_GETLK\fR, \fBF_SETLK\fR, or \fBF_SETLKW\fR and @@ -942,12 +830,10 @@ type \fBoff64_t\fR. The \fBfcntl()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 11n -.rt The \fIcmd\fR argument is \fBF_SETLK\fR, \fBF_SETLK64\fR, \fBF_SETLKW\fR, or \fBF_SETLKW64\fR, and the file is currently being mapped to virtual memory using \fBmmap\fR(2). @@ -955,12 +841,10 @@ using \fBmmap\fR(2). .sp .ne 2 -.mk .na \fB\fBEDEADLK\fR\fR .ad .RS 11n -.rt The \fIcmd\fR argument is \fBF_SETLKW\fR or \fBF_SETLKW64\fR, the lock is blocked by some lock from another process and putting the calling process to sleep, waiting for that lock to become free would cause a deadlock. @@ -978,15 +862,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal Safe +MT-Level Async-Signal Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/fork.2 b/usr/src/man/man2/fork.2 index 22652fd85f..630c2e2b27 100644 --- a/usr/src/man/man2/fork.2 +++ b/usr/src/man/man2/fork.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1994, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 fork 2 "28 Oct 2008" "SunOS 5.11" "System Calls" +.TH FORK 2 "Oct 28, 2008" .SH NAME fork, fork1, forkall, forkx, forkallx \- create a new process .SH SYNOPSIS @@ -353,7 +353,6 @@ consisting of a bitwise inclusive-OR of zero or more of the following flags, which are defined in the header \fB<sys/fork.h>\fR: .sp .ne 2 -.mk .na \fB\fBFORK_NOSIGCHLD\fR\fR .ad @@ -367,7 +366,6 @@ continue actions if the parent has requested them. .sp .ne 2 -.mk .na \fB\fBFORK_WAITPID\fR\fR .ad @@ -432,12 +430,10 @@ The \fBfork()\fR, \fBfork1()\fR, \fBforkall()\fR, \fBforkx()\fR, and \fBforkallx()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt A resource control or limit on the total number of processes, tasks or LWPs under execution by a single user, task, project, or zone has been exceeded, or the total amount of system memory available is temporarily insufficient to @@ -446,23 +442,19 @@ duplicate this process. .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt There is not enough swap space. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_PROC_FORK\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -472,12 +464,10 @@ the calling process. The \fBforkx()\fR and \fBforkallx()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIflags\fR argument is invalid. .RE @@ -489,17 +479,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe. +MT-Level Async-Signal-Safe. _ -StandardSee below. +Standard See below. .TE .sp diff --git a/usr/src/man/man2/fpathconf.2 b/usr/src/man/man2/fpathconf.2 index df5320f197..bf6f230c02 100644 --- a/usr/src/man/man2/fpathconf.2 +++ b/usr/src/man/man2/fpathconf.2 @@ -10,7 +10,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 fpathconf 2 "1 Sep 2009" "SunOS 5.11" "System Calls" +.TH FPATHCONF 2 "Sep 1, 2009" .SH NAME fpathconf, pathconf \- get configurable pathname variables .SH SYNOPSIS @@ -49,65 +49,64 @@ file or directory. The variables in the following table come from .sp .TS -tab() box; -cw(2.14i) |cw(2.15i) |cw(1.21i) -lw(2.14i) |lw(2.15i) |lw(1.21i) -. -VariableValue of \fIname\fRNotes +box; +c | c | c +l | l | l . +Variable Value of \fIname\fR Notes _ -{\fBACL_ENABLED\fR}\fB_PC_ACL_ENABLED\fR10 +{\fBACL_ENABLED\fR} \fB_PC_ACL_ENABLED\fR 10 _ -{\fBFILESIZEBITS\fR}\fB_PC_FILESIZEBITS\fR3,4 +{\fBFILESIZEBITS\fR} \fB_PC_FILESIZEBITS\fR 3,4 _ -{\fBLINK_MAX\fR}\fB_PC_LINK_MAX\fR1 +{\fBLINK_MAX\fR} \fB_PC_LINK_MAX\fR 1 _ -{\fBMAX_CANON\fR}\fB_PC_MAX_CANON\fR2 +{\fBMAX_CANON\fR} \fB_PC_MAX_CANON\fR 2 _ -{\fBMAX_INPUT\fR}\fB_PC_MAX_INPUT\fR2 +{\fBMAX_INPUT\fR} \fB_PC_MAX_INPUT\fR 2 _ -{\fBMIN_HOLE_SIZE\fR}\fB_PC_MIN_HOLE_SIZE\fR11 +{\fBMIN_HOLE_SIZE\fR} \fB_PC_MIN_HOLE_SIZE\fR 11 _ -{\fBNAME_MAX\fR}\fB_PC_NAME_MAX\fR3, 4 +{\fBNAME_MAX\fR} \fB_PC_NAME_MAX\fR 3, 4 _ -{\fBPATH_MAX\fR}\fB_PC_PATH_MAX\fR4,5 +{\fBPATH_MAX\fR} \fB_PC_PATH_MAX\fR 4,5 _ -{\fBPIPE_BUF\fR}\fB_PC_PIPE_BUF\fR6 +{\fBPIPE_BUF\fR} \fB_PC_PIPE_BUF\fR 6 _ -{\fBPOSIX_ALLOC_SIZE_MIN\fR}\fB_PC_ALLOC_SIZE_MIN\fR +{\fBPOSIX_ALLOC_SIZE_MIN\fR} \fB_PC_ALLOC_SIZE_MIN\fR _ -{\fBPOSIX_REC_INCR_XFER_SIZE\fR}\fB_PC_REC_INCR_XFER_SIZE\fR +{\fBPOSIX_REC_INCR_XFER_SIZE\fR} \fB_PC_REC_INCR_XFER_SIZE\fR _ -{\fBPOSIX_REC_MAX_XFER_SIZE\fR}\fB_PC_REC_MAX_XFER_SIZE\fR +{\fBPOSIX_REC_MAX_XFER_SIZE\fR} \fB_PC_REC_MAX_XFER_SIZE\fR _ -{\fBPOSIX_REC_MIN_XFER_SIZE\fR}\fB_PC_REC_MIN_XFER_SIZE\fR +{\fBPOSIX_REC_MIN_XFER_SIZE\fR} \fB_PC_REC_MIN_XFER_SIZE\fR _ -{\fBPOSIX_REC_XFER_ALIGN\fR}\fB_PC_REC_XFER_ALIGN\fR +{\fBPOSIX_REC_XFER_ALIGN\fR} \fB_PC_REC_XFER_ALIGN\fR _ -{\fBSYMLINK_MAX\fR}\fB_PC_SYMLINK_MAX\fR4, 9 +{\fBSYMLINK_MAX\fR} \fB_PC_SYMLINK_MAX\fR 4, 9 _ -{\fBXATTR_ENABLED\fR}\fB_PC_XATTR_ENABLED\fR1 +{\fBXATTR_ENABLED\fR} \fB_PC_XATTR_ENABLED\fR 1 _ -{\fBSATTR_ENABLED\fR}\fB_PC_SATTR_ENABLED\fR +{\fBSATTR_ENABLED\fR} \fB_PC_SATTR_ENABLED\fR _ -{\fBXATTR_EXISTS\fR}\fB_PC_XATTR_EXISTS\fR1 +{\fBXATTR_EXISTS\fR} \fB_PC_XATTR_EXISTS\fR 1 _ -{\fBSATTR_EXISTS\fR}\fB_PC_SATTR_EXISTS\fR +{\fBSATTR_EXISTS\fR} \fB_PC_SATTR_EXISTS\fR _ -{\fBACCESS_FILTERING\fR}\fB_PC_ACCESS_FILTERING\fR12 +{\fBACCESS_FILTERING\fR} \fB_PC_ACCESS_FILTERING\fR 12 _ -\fB_POSIX_CHOWN_RESTRICTED\fR\fB_PC_CHOWN_RESTRICTED\fR7 +\fB_POSIX_CHOWN_RESTRICTED\fR \fB_PC_CHOWN_RESTRICTED\fR 7 _ -\fB_POSIX_NO_TRUNC\fR\fB_PC_NO_TRUNC\fR3, 4 +\fB_POSIX_NO_TRUNC\fR \fB_PC_NO_TRUNC\fR 3, 4 _ -\fB_POSIX_VDISABLE\fR\fB_PC_VDISABLE\fR2 +\fB_POSIX_VDISABLE\fR \fB_PC_VDISABLE\fR 2 _ -\fB_POSIX_ASYNC_IO\fR\fB_PC_ASYNC_IO\fR8 +\fB_POSIX_ASYNC_IO\fR \fB_PC_ASYNC_IO\fR 8 _ -\fB_POSIX_PRIO_IO\fR\fB_PC_PRIO_IO\fR8 +\fB_POSIX_PRIO_IO\fR \fB_PC_PRIO_IO\fR 8 _ -\fB_POSIX_SYNC_IO\fR\fB_PC_SYNC_IO\fR8 +\fB_POSIX_SYNC_IO\fR \fB_PC_SYNC_IO\fR 8 _ -\fB_POSIX_TIMESTAMP_RESOLUTION\fR\fB_PC_TIMESTAMP_RESOLUTION\fR1 +\fB_POSIX_TIMESTAMP_RESOLUTION\fR \fB_PC_TIMESTAMP_RESOLUTION\fR 1 .TE .sp @@ -186,23 +185,19 @@ the following flags associated with ACL types supported by the file system; otherwise 0 is returned. .sp .ne 2 -.mk .na \fB\fB_ACL_ACE_ENABLED\fR\fR .ad .RS 23n -.rt The file system supports ACE ACLs. .RE .sp .ne 2 -.mk .na \fB\fB_ACL_ACLENT_ENABLED\fR\fR .ad .RS 23n -.rt The file system supports UFS aclent ACLs. .RE @@ -257,23 +252,19 @@ the application when it was compiled with <\fBlimits.h\fR> or <\fBunistd.h\fR>. The \fBpathconf()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIname\fR is not valid. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 10n -.rt A loop exists in symbolic links encountered during resolution of the \fIpath\fR argument. .RE @@ -283,12 +274,10 @@ argument. The \fBfpathconf()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIname\fR is not valid. .RE @@ -297,47 +286,39 @@ The value of \fIname\fR is not valid. The \fBpathconf()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a component of the path prefix. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt An association of the variable \fIname\fR with the specified file is not supported. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds {\fBPATH_MAX\fR} or a pathname component is longer than {\fBNAME_MAX\fR}. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt As a result of encountering a symbolic link in resolution of the \fIpath\fR argument, the length of the substituted pathname string exceeded {\fBPATH_MAX\fR}. @@ -345,24 +326,20 @@ argument, the length of the substituted pathname string exceeded .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of \fIpath\fR does not name an existing file or \fIpath\fR is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory. .RE @@ -371,23 +348,19 @@ A component of the path prefix is not a directory. The \fBfpathconf()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 10n -.rt The \fIfildes\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt An association of the variable \fIname\fR with the specified file is not supported. .RE @@ -405,17 +378,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getacct.2 b/usr/src/man/man2/getacct.2 index 62cbabeb6e..f7dd397362 100644 --- a/usr/src/man/man2/getacct.2 +++ b/usr/src/man/man2/getacct.2 @@ -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 getacct 2 "20 Jan 2003" "SunOS 5.11" "System Calls" +.TH GETACCT 2 "Jan 20, 2003" .SH NAME getacct, putacct, wracct \- get, put, or write extended accounting data .SH SYNOPSIS @@ -83,23 +83,19 @@ The \fBgetacct()\fR, \fBputacct()\fR, and \fBwracct()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 14n -.rt The \fIidtype\fR argument was not \fBP_TASKID\fR or \fBP_PID\fR. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 14n -.rt The file system containing the extended accounting file is full. The \fBwracct()\fR or \fBputacct()\fR function will fail if the record size would exceed the amount of space remaining on the file system. @@ -107,12 +103,10 @@ exceed the amount of space remaining on the file system. .sp .ne 2 -.mk .na \fB\fBENOTACTIVE\fR\fR .ad .RS 14n -.rt The extended accounting facility for the requested \fBidtype_t\fR is not active. Either \fBputacct()\fR attempted to write a task record when the task accounting file was unset, or \fBgetacct()\fR attempted to retrieve accounting @@ -121,24 +115,20 @@ data for a process when extended process accounting was inactive. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 14n -.rt The {\fBPRIV_SYS_ACCT\fR} privilege is not asserted in the effective set of the calling process. .RE .sp .ne 2 -.mk .na \fB\fBERSCH\fR\fR .ad .RS 14n -.rt The \fIid\fR argument does not refer to a presently active system task \fBID\fR or process \fBID\fR. .RE @@ -148,12 +138,10 @@ or process \fBID\fR. The \fBputacct()\fR and \fBwracct()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIflags\fR argument is neither \fBEW_PARTIAL\fR nor \fBEW_INTERVAL\fR. .RE @@ -165,13 +153,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -lw(2.75i) |lw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getaudit.2 b/usr/src/man/man2/getaudit.2 index 09167e3cca..f7c498fda0 100644 --- a/usr/src/man/man2/getaudit.2 +++ b/usr/src/man/man2/getaudit.2 @@ -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 getaudit 2 "16 Apr 2008" "SunOS 5.11" "System Calls" +.TH GETAUDIT 2 "Apr 16, 2008" .SH NAME getaudit, setaudit, getaudit_addr, setaudit_addr \- get or set process audit information @@ -100,23 +100,19 @@ the error. The \fBgetaudit()\fR and \fBsetaudit()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIinfo\fR parameter points outside the process's allocated address space. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_SYS_AUDIT\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -134,15 +130,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStable +Interface Stability Stable _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getauid.2 b/usr/src/man/man2/getauid.2 index db296be13e..cba39b5321 100644 --- a/usr/src/man/man2/getauid.2 +++ b/usr/src/man/man2/getauid.2 @@ -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 getauid 2 "16 Apr 2008" "SunOS 5.11" "System Calls" +.TH GETAUID 2 "Apr 16, 2008" .SH NAME getauid, setauid \- get or set user audit identity .SH SYNOPSIS @@ -50,23 +50,19 @@ error. The \fBgetauid()\fR and \fBsetauid()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIauid\fR argument points to an invalid address. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_SYS_AUDIT\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -76,12 +72,10 @@ the calling process. The \fBgetauid()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 9n -.rt The {\fBPRIV_PROC_AUDIT\fR} privilege is not asserted in the effective set of the calling process. .RE diff --git a/usr/src/man/man2/getcontext.2 b/usr/src/man/man2/getcontext.2 index 7a713d95ce..98ec4f4857 100644 --- a/usr/src/man/man2/getcontext.2 +++ b/usr/src/man/man2/getcontext.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 getcontext 2 "5 Feb 2001" "SunOS 5.11" "System Calls" +.TH GETCONTEXT 2 "Feb 5, 2001" .SH NAME getcontext, setcontext \- get and set current user context .SH SYNOPSIS @@ -86,13 +86,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -\fBATTRIBUTE TYPE\fRATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getdents.2 b/usr/src/man/man2/getdents.2 index 0dbb1bf6f5..c74af41c44 100644 --- a/usr/src/man/man2/getdents.2 +++ b/usr/src/man/man2/getdents.2 @@ -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 getdents 2 "17 Jul 2001" "SunOS 5.11" "System Calls" +.TH GETDENTS 2 "Jul 17, 2001" .SH NAME getdents \- read directory entries and put in a file system independent format .SH SYNOPSIS @@ -43,90 +43,74 @@ the directory has been reached. Otherwise, \fB\(mi1\fR is returned and The \fBgetdents()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 13n -.rt The \fIfildes\fR argument is not a valid file descriptor open for reading. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 13n -.rt The \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 13n -.rt The \fInbyte\fR argument is not large enough for one directory entry. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 13n -.rt An I/O error occurred while accessing the file system. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 13n -.rt The current file pointer for the directory is not located at a valid entry. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 13n -.rt The \fIfildes\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 13n -.rt The \fIfildes\fR argument is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The value of the \fBdirent\fR structure member \fBd_ino\fR or \fBd_off\fR cannot be represented in an \fBino_t\fR or \fBoff_t\fR. .RE diff --git a/usr/src/man/man2/getgroups.2 b/usr/src/man/man2/getgroups.2 index 886c99109e..4b871aa623 100644 --- a/usr/src/man/man2/getgroups.2 +++ b/usr/src/man/man2/getgroups.2 @@ -4,7 +4,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 getgroups 2 "8 Sep 2006" "SunOS 5.11" "System Calls" +.TH GETGROUPS 2 "Sep 8, 2006" .SH NAME getgroups, setgroups \- get or set supplementary group access list IDs .SH SYNOPSIS @@ -49,12 +49,10 @@ indicate the error. The \fBgetgroups()\fR and \fBsetgroups()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt A referenced part of the array pointed to by \fIgrouplist\fR is an illegal address. .RE @@ -64,12 +62,10 @@ address. The \fBgetgroups()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIgidsetsize\fR is non-zero and less than the number of supplementary group IDs set for the calling process. .RE @@ -79,23 +75,19 @@ supplementary group IDs set for the calling process. The \fBsetgroups()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIngroups\fR is greater than {\fBNGROUPS_MAX\fR}. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_PROC_SETID\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -113,15 +105,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface Stability\fBgetgroups()\fR is Standard. +Interface Stability \fBgetgroups()\fR is Standard. _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getisax.2 b/usr/src/man/man2/getisax.2 index a53ff55659..9f62902964 100644 --- a/usr/src/man/man2/getisax.2 +++ b/usr/src/man/man2/getisax.2 @@ -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 getisax 2 "7 bNov 2007" "SunOS 5.11" "System Calls" +.TH GETISAX 2 "Nov 7, 2007" .SH NAME getisax \- extract valid instruction set extensions .SH SYNOPSIS @@ -46,9 +46,9 @@ is present and fully supportred by the operating system. .in +2 .nf uint_t ui; - + (void) getisax(&ui, 1); - + if (ui & AV_386_SSE2) printf("SSE2 instruction set extension is present.\en"); .fi @@ -62,15 +62,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getitimer.2 b/usr/src/man/man2/getitimer.2 index b21f0b8005..b9acb8e12a 100644 --- a/usr/src/man/man2/getitimer.2 +++ b/usr/src/man/man2/getitimer.2 @@ -2,7 +2,7 @@ .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. -.TH getitimer 2 "15 Jun 2009" "SunOS 5.11" "System Calls" +.TH GETITIMER 2 "Jun 15, 2009" .SH NAME getitimer, setitimer \- get or set value of interval timer .SH SYNOPSIS @@ -58,24 +58,20 @@ values are rounded up to the resolution of the profiling clock. The four timers are as follows: .sp .ne 2 -.mk .na \fB\fBITIMER_REAL\fR\fR .ad .RS 19n -.rt Decrements in real time. A \fBSIGALRM\fR signal is delivered to the process when this timer expires. .RE .sp .ne 2 -.mk .na \fB\fBITIMER_VIRTUAL\fR\fR .ad .RS 19n -.rt Decrements in lightweight process (lwp) virtual time. It runs only when the calling lwp is executing. A \fBSIGVTALRM\fR signal is delivered to the calling lwp when it expires. @@ -83,12 +79,10 @@ lwp when it expires. .sp .ne 2 -.mk .na \fB\fBITIMER_PROF\fR\fR .ad .RS 19n -.rt Decrements both in lightweight process (lwp) virtual time and when the system is running on behalf of the lwp. It is designed to be used by interpreters in statistically profiling the execution of interpreted programs. Each time the @@ -99,12 +93,10 @@ using this timer must be prepared to restart interrupted functions. .sp .ne 2 -.mk .na \fB\fBITIMER_REALPROF\fR\fR .ad .RS 19n -.rt Decrements in real time. It is designed to be used for real-time profiling of multithreaded programs. Each time the \fBITIMER_REALPROF\fR timer expires, one counter in a set of counters maintained by the system for each lightweight @@ -148,12 +140,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBgetitimer()\fR and \fBsetitimer()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The specified number of seconds is greater than 100,000,000, the number of microseconds is greater than or equal to 1,000,000, or the \fIwhich\fR argument is unrecognized. @@ -167,15 +157,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getlabel.2 b/usr/src/man/man2/getlabel.2 index 75436dd510..d0412a2e0b 100644 --- a/usr/src/man/man2/getlabel.2 +++ b/usr/src/man/man2/getlabel.2 @@ -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 getlabel 2 "20 Jul 2007" "SunOS 5.11" "System Calls" +.TH GETLABEL 2 "Jul 20, 2007" .SH NAME getlabel, fgetlabel \- get file sensitivity label .SH SYNOPSIS @@ -52,12 +52,10 @@ Otherwise they return \(mi1 and set \fBerrno\fR to indicate the error. The \fBgetlabel()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a component of the path prefix of \fIpath\fR. To override this restriction, the calling process can assert the \fBPRIV_FILE_DAC_SEARCH\fR privilege. @@ -65,45 +63,37 @@ To override this restriction, the calling process can assert the .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt \fIlabel_p\fR or \fIpath\fR points to an invalid address. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An \fBI/O\fR error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the path argument exceeds \fIPATH_MAX\fR, or a pathname component is longer than \fINAME_MAX\fR while \fI_POSIX_NO_TRUNC\fR is in effect (see \fBpathconf\fR(2)). @@ -111,23 +101,19 @@ is longer than \fINAME_MAX\fR while \fI_POSIX_NO_TRUNC\fR is in effect (see .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The file referred to by \fIpath\fR does not exist. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix of \fIpath\fR is not a directory. .RE @@ -136,34 +122,28 @@ A component of the path prefix of \fIpath\fR is not a directory. The \fBfgetlabel()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 10n -.rt The \fIfd\fR argument is not a valid open file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIlabel_p\fR argument points to an invalid address. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 10n -.rt An \fBI/O\fR error occurred while reading from or writing to the file system. .RE @@ -175,13 +155,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getmsg.2 b/usr/src/man/man2/getmsg.2 index 110a14fe81..5b79c58d16 100644 --- a/usr/src/man/man2/getmsg.2 +++ b/usr/src/man/man2/getmsg.2 @@ -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 getmsg 2 "1 Nov 2001" "SunOS 5.11" "System Calls" +.TH GETMSG 2 "Nov 1, 2001" .SH NAME getmsg, getpmsg \- get next message off a stream .SH SYNOPSIS @@ -146,81 +146,67 @@ previously received partial message. The \fBgetmsg()\fR and \fBgetpmsg()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 11n -.rt The \fBO_NDELAY\fR or \fBO_NONBLOCK\fR flag is set and no messages are available. .RE .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is not a valid file descriptor open for reading. .RE .sp .ne 2 -.mk .na \fB\fBEBADMSG\fR\fR .ad .RS 11n -.rt Queued message to be read is not valid for \fBgetmsg\fR. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n -.rt The \fIctlptr\fR, \fIdataptr\fR, \fIbandp\fR, or \fIflagsp\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 11n -.rt A signal was caught during the execution of the \fBgetmsg\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt An illegal value was specified in \fIflagsp\fR, or the stream referenced by \fIfildes\fR is linked under a multiplexor. .RE .sp .ne 2 -.mk .na \fB\fBENOSTR\fR\fR .ad .RS 11n -.rt A stream is not associated with \fIfildes\fR. .RE @@ -237,13 +223,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -\fBATTRIBUTE TYPE\fRATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getpflags.2 b/usr/src/man/man2/getpflags.2 index dc1df505c4..b8eeb4ae2e 100644 --- a/usr/src/man/man2/getpflags.2 +++ b/usr/src/man/man2/getpflags.2 @@ -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 getpflags 2 "4 Jun 2009" "SunOS 5.11" "System Calls" +.TH GETPFLAGS 2 "Jun 4, 2009" .SH NAME getpflags, setpflags \- get or set process flags .SH SYNOPSIS @@ -30,7 +30,6 @@ current per-process flags. The following values for \fIflag\fR are supported: .sp .ne 2 -.mk .na \fB\fBPRIV_AWARE\fR\fR .ad @@ -45,7 +44,6 @@ for a discussion of this flag. .sp .ne 2 -.mk .na \fB\fBPRIV_AWARE_RESET\fR\fR .ad @@ -65,7 +63,6 @@ through calling \fBsetppriv\fR(2) or by setting \fBPRIV_AWARE\fR to 1. .sp .ne 2 -.mk .na \fB\fBPRIV_DEBUG\fR\fR .ad @@ -78,7 +75,6 @@ set and unset this flag at will. .sp .ne 2 -.mk .na \fB\fBNET_MAC_AWARE\fR\fR .ad @@ -118,12 +114,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBgetpflags()\fR and \fBsetpflags()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIflag\fR or the value to which the \fIflag\fR is set is out of range. .RE @@ -133,12 +127,10 @@ range. The \fBsetpflags()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 9n -.rt An attempt was made to unset \fBPRIV_AWARE\fR but the observed set invariance condition was not met. .RE @@ -151,15 +143,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getpid.2 b/usr/src/man/man2/getpid.2 index 35f91af4aa..802c4dcc9d 100644 --- a/usr/src/man/man2/getpid.2 +++ b/usr/src/man/man2/getpid.2 @@ -10,7 +10,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 getpid 2 "27 Jan 2009" "SunOS 5.11" "System Calls" +.TH GETPID 2 "Jan 27, 2009" .SH NAME getpid, getpgrp, getppid, getpgid \- get process, process group, and parent process IDs @@ -71,12 +71,10 @@ indicate the error. The \fBgetpgid()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 9n -.rt The process whose process \fBID\fR is equal to \fIpid\fR is not in the same session as the calling process, and the implementation does not allow access to the process group \fBID\fR of that process from the calling process. @@ -84,12 +82,10 @@ the process group \fBID\fR of that process from the calling process. .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 9n -.rt There is no process with a process \fBID\fR equal to \fIpid\fR. .RE @@ -98,12 +94,10 @@ There is no process with a process \fBID\fR equal to \fIpid\fR. The \fBgetpgid()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of the \fIpid\fR argument is invalid. .RE @@ -115,17 +109,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getppriv.2 b/usr/src/man/man2/getppriv.2 index b1622d2c7d..b69ae101bb 100644 --- a/usr/src/man/man2/getppriv.2 +++ b/usr/src/man/man2/getppriv.2 @@ -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 getppriv 2 "10 Sep 2004" "SunOS 5.11" "System Calls" +.TH GETPPRIV 2 "Sep 10, 2004" .SH NAME getppriv, setppriv \- get or set a privilege set .SH SYNOPSIS @@ -94,23 +94,19 @@ Upon successful completion, 0 is returned. Otherwise, -1 is returned and The \fBgetppriv()\fR and \fBsetppriv()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIop\fR or \fIwhich\fR is out of range. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIset\fR argument points to an illegal address. .RE @@ -119,12 +115,10 @@ The \fIset\fR argument points to an illegal address. The \fBsetppriv()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 9n -.rt The application attempted to add privileges to \fBPRIV_LIMIT\fR or \fBPRIV_PERMITTED\fR, or the application attempted to add privileges to \fBPRIV_INHERITABLE\fR or \fBPRIV_EFFECTIVE\fR which were not in @@ -139,15 +133,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getrlimit.2 b/usr/src/man/man2/getrlimit.2 index 1d55e05651..3dd0158731 100644 --- a/usr/src/man/man2/getrlimit.2 +++ b/usr/src/man/man2/getrlimit.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1994, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 getrlimit 2 "21 Aug 2006" "SunOS 5.11" "System Calls" +.TH GETRLIMIT 2 "Aug 21, 2006" .SH NAME getrlimit, setrlimit \- control maximum system resource consumption .SH SYNOPSIS @@ -64,12 +64,10 @@ The possible resources, their descriptions, and the actions taken when the current limit is exceeded are summarized as follows: .sp .ne 2 -.mk .na \fB\fBRLIMIT_CORE\fR\fR .ad .RS 17n -.rt The maximum size of a core file in bytes that may be created by a process. A limit of \fB0\fR will prevent the creation of a core file. The writing of a core file will terminate at this size. @@ -77,12 +75,10 @@ core file will terminate at this size. .sp .ne 2 -.mk .na \fB\fBRLIMIT_CPU\fR\fR .ad .RS 17n -.rt The maximum amount of CPU time in seconds used by a process. This is a soft limit only. The \fBSIGXCPU\fR signal is sent to the process. If the process is holding or ignoring \fBSIGXCPU\fR, the behavior is scheduling class defined. @@ -90,24 +86,20 @@ holding or ignoring \fBSIGXCPU\fR, the behavior is scheduling class defined. .sp .ne 2 -.mk .na \fB\fBRLIMIT_DATA\fR\fR .ad .RS 17n -.rt The maximum size of a process's heap in bytes. The \fBbrk\fR(2) function will fail with \fBerrno\fR set to \fBENOMEM\fR. .RE .sp .ne 2 -.mk .na \fB\fBRLIMIT_FSIZE\fR\fR .ad .RS 17n -.rt The maximum size of a file in bytes that may be created by a process. A limit of \fB0\fR will prevent the creation of a file. The \fBSIGXFSZ\fR signal is sent to the process. If the process is holding or ignoring \fBSIGXFSZ\fR, @@ -117,12 +109,10 @@ with \fBerrno\fR set to \fBEFBIG\fR. .sp .ne 2 -.mk .na \fB\fBRLIMIT_NOFILE\fR\fR .ad .RS 17n -.rt One more than the maximum value that the system may assign to a newly created descriptor. This limit constrains the number of file descriptors that a process may create. @@ -130,12 +120,10 @@ may create. .sp .ne 2 -.mk .na \fB\fBRLIMIT_STACK\fR\fR .ad .RS 17n -.rt The maximum size of a process's stack in bytes. The system will not automatically grow the stack beyond this limit. .sp @@ -158,12 +146,10 @@ disposition of \fBSIGSEGV\fR will be set to \fBSIG_DFL\fR before it is sent. .sp .ne 2 -.mk .na \fB\fBRLIMIT_VMEM\fR\fR .ad .RS 17n -.rt The maximum size of a process's mapped address space in bytes. If this limit is exceeded, the \fBbrk\fR(2) and \fBmmap\fR(2) functions will fail with \fBerrno\fR set to \fBENOMEM\fR. In addition, the automatic stack growth will @@ -172,12 +158,10 @@ fail with the effects outlined above. .sp .ne 2 -.mk .na \fB\fBRLIMIT_AS\fR\fR .ad .RS 17n -.rt This is the maximum size of a process's total available memory, in bytes. If this limit is exceeded, the \fBbrk\fR(2), \fBmalloc\fR(3C), \fBmmap\fR(2) and \fBsbrk\fR(2) functions will fail with \fBerrno\fR set to \fBENOMEM\fR. In @@ -197,13 +181,11 @@ implementation defined parameters: .sp .TS -tab(); -cw(2.75i) cw(2.75i) -lw(2.75i) lw(2.75i) -. -LimitImplementation Defined Constant -\fBRLIMIT_FSIZE\fR\fBFCHR_MAX\fR -\fBRLIMIT_NOFILE\fR\fBOPEN_MAX\fR +c c +l l . +Limit Implementation Defined Constant +\fBRLIMIT_FSIZE\fR \fBFCHR_MAX\fR +\fBRLIMIT_NOFILE\fR \fBOPEN_MAX\fR .TE .sp @@ -247,35 +229,29 @@ indicate the error. The \fBgetrlimit()\fR and \fBsetrlimit()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIrlp\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt An invalid \fIresource\fR was specified; or in a \fBsetrlimit()\fR call, the new \fBrlim_cur\fR exceeds the new \fBrlim_max\fR. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The limit specified to \fBsetrlimit()\fR would have raised the maximum limit value and {\fBPRIV_SYS_RESOURCE\fR} is not asserted in the effective set of the current process. @@ -286,12 +262,10 @@ current process. The \fBsetrlimit()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The limit specified cannot be lowered because current usage is already higher than the limit. .RE @@ -317,13 +291,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -\fBATTRIBUTE TYPE\fRATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getsid.2 b/usr/src/man/man2/getsid.2 index bf2851d2ed..3446f5363e 100644 --- a/usr/src/man/man2/getsid.2 +++ b/usr/src/man/man2/getsid.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 getsid 2 "22 Jan 1996" "SunOS 5.11" "System Calls" +.TH GETSID 2 "Jan 22, 1996" .SH NAME getsid \- get process group ID of session leader .SH SYNOPSIS @@ -36,12 +36,10 @@ of the session leader of the specified process. Otherwise, it returns The \fBgetsid()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 9n -.rt The process specified by \fIpid\fR is not in the same session as the calling process, and the implementation does not allow access to the process group \fBID\fR of the session leader of that process from the calling process. @@ -49,12 +47,10 @@ process, and the implementation does not allow access to the process group .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 9n -.rt There is no process with a process \fBID\fR equal to \fIpid\fR. .RE @@ -66,13 +62,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -\fBATTRIBUTE TYPE\fRATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getuid.2 b/usr/src/man/man2/getuid.2 index 4a61a6de0d..6d22e6fd6b 100644 --- a/usr/src/man/man2/getuid.2 +++ b/usr/src/man/man2/getuid.2 @@ -4,7 +4,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 getuid 2 "28 Dec 1996" "SunOS 5.11" "System Calls" +.TH GETUID 2 "Dec 28, 1996" .SH NAME getuid, geteuid, getgid, getegid \- get real user, effective user, real group, and effective group IDs @@ -59,15 +59,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/getustack.2 b/usr/src/man/man2/getustack.2 index 2fe573beed..6e2918e73e 100644 --- a/usr/src/man/man2/getustack.2 +++ b/usr/src/man/man2/getustack.2 @@ -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 getustack 2 "2 Nov 2004" "SunOS 5.11" "System Calls" +.TH GETUSTACK 2 "Nov 2, 2004" .SH NAME getustack, setustack \- retrieve or change the address of per-LWP stack boundary information @@ -42,12 +42,10 @@ returned and \fBerrno\fR is set to indicate the error. These functions will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIspp\fR or \fIsp\fR argument does not refer to a valid address. .RE @@ -66,15 +64,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(5.5i) |cw(0i) -lw(5.5i) |lw(0i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/ioctl.2 b/usr/src/man/man2/ioctl.2 index f3a0e86e09..cebb081819 100644 --- a/usr/src/man/man2/ioctl.2 +++ b/usr/src/man/man2/ioctl.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 ioctl 2 "15 Feb 1996" "SunOS 5.11" "System Calls" +.TH IOCTL 2 "Feb 15, 1996" .SH NAME ioctl \- control device .SH SYNOPSIS @@ -57,34 +57,28 @@ returned and \fBerrno\fR is set to indicate the error. The \fBioctl()\fR function will fail for any type of file if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 10n -.rt The \fIfildes\fR argument is not a valid open file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 10n -.rt A signal was caught during the execution of the \fBioctl()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The stream or multiplexer referenced by \fIfildes\fR is linked (directly or indirectly) downstream from a multiplexer. .RE @@ -98,82 +92,68 @@ cases. Under the following conditions, requests to device drivers may fail and set \fBerrno\fR to indicate the error .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n -.rt The \fIrequest\fR argument requires a data transfer to or from a buffer pointed to by \fIarg\fR, but \fIarg\fR points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The \fIrequest\fR or \fIarg\fR argument is not valid for this device. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 11n -.rt Some physical I/O error has occurred. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is on a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTTY\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is not associated with a streams device that accepts control functions. .RE .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 11n -.rt The \fIrequest\fR and \fIarg\fR arguments are valid for this device driver, but the service requested can not be performed on this particular subdevice. .RE .sp .ne 2 -.mk .na \fB\fBENODEV\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument refers to a valid streams device, but the corresponding device driver does not support the \fBioctl()\fR function. .RE @@ -189,13 +169,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/issetugid.2 b/usr/src/man/man2/issetugid.2 index e06f632de5..711a3eb300 100644 --- a/usr/src/man/man2/issetugid.2 +++ b/usr/src/man/man2/issetugid.2 @@ -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 issetugid 2 "19 Feb 2003" "SunOS 5.11" "System Calls" +.TH ISSETUGID 2 "Feb 19, 2003" .SH NAME issetugid \- determine if current executable is running setuid or setgid .SH SYNOPSIS @@ -67,15 +67,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/kill.2 b/usr/src/man/man2/kill.2 index 6f15904f49..794cb22ef1 100644 --- a/usr/src/man/man2/kill.2 +++ b/usr/src/man/man2/kill.2 @@ -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 kill 2 "22 Mar 2004" "SunOS 5.11" "System Calls" +.TH KILL 2 "Mar 22, 2004" .SH NAME kill \- send a signal to a process or a group of processes .SH SYNOPSIS @@ -71,23 +71,19 @@ signal is sent, and \fBerrno\fR is set to indicate the error. The \fBkill()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIsig\fR argument is not a valid signal number. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The \fIsig\fR argument is \fBSIGKILL\fR and the \fIpid\fR argument is \fB(pid_t)-1\fR (that is, the calling process does not have permission to send the signal to any of the processes specified by \fIpid\fR). @@ -102,12 +98,10 @@ signal to a process with a different session ID. .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 10n -.rt No process or process group can be found corresponding to that specified by \fIpid\fR. .RE @@ -125,15 +119,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/link.2 b/usr/src/man/man2/link.2 index bb2491913e..479c1fe202 100644 --- a/usr/src/man/man2/link.2 +++ b/usr/src/man/man2/link.2 @@ -4,7 +4,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 link 2 "18 May 2007" "SunOS 5.11" "System Calls" +.TH LINK 2 "May 18, 2007" .SH NAME link \- link to a file .SH SYNOPSIS @@ -44,24 +44,20 @@ returned, no link is created, and \fBerrno\fR is set to indicate the error. The \fBlink()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt A component of either path prefix denies search permission, or the requested link requires writing in a directory with a mode that denies write permission. .RE .sp .ne 2 -.mk .na \fB\fBEDQUOT\fR\fR .ad .RS 16n -.rt The directory where the entry for the new link is being placed cannot be extended because the user's quota of disk blocks on that file system has been exhausted. @@ -69,79 +65,65 @@ exhausted. .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 16n -.rt The link named by \fInew\fR exists. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIexisting\fR or \fInew\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEILSEQ\fR\fR .ad .RS 16n -.rt The path argument includes non-UTF8 characters and the file system accepts only file names where all characters are part of the UTF-8 character codeset. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fBlink()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBEMLINK\fR\fR .ad .RS 16n -.rt The maximum number of links to a file would be exceeded. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIexisting\fR or \fInew\fR argument exceeds \fBPATH_MAX\fR, or the length of a \fIexisting\fR or \fInew\fR component exceeds \fBNAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -149,12 +131,10 @@ while \fB_POSIX_NO_TRUNC\fR is in effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The \fIexisting\fR or \fInew\fR argument is a null pathname; a component of either path prefix does not exist; or the file named by \fIexisting\fR does not exist. @@ -162,46 +142,38 @@ exist. .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIexisting\fR or \fInew\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 16n -.rt The directory that would contain the link cannot be extended. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of either path prefix is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The file named by \fIexisting\fR is a directory and the {\fBPRIV_SYS_LINKDIR\fR} privilege is not asserted in the effective set of the calling process. @@ -213,23 +185,19 @@ the calling process. .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The requested link requires writing in a directory on a read-only file system. .RE .sp .ne 2 -.mk .na \fB\fBEXDEV\fR\fR .ad .RS 16n -.rt The link named by \fInew\fR and the file named by \fIexisting\fR are on different logical devices (file systems). .RE @@ -242,15 +210,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/llseek.2 b/usr/src/man/man2/llseek.2 index f1f30652ca..326fc9a201 100644 --- a/usr/src/man/man2/llseek.2 +++ b/usr/src/man/man2/llseek.2 @@ -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 llseek 2 "1 Apr 2005" "SunOS 5.11" "System Calls" +.TH LLSEEK 2 "Apr 1, 2005" .SH NAME llseek \- move extended read/write file pointer .SH SYNOPSIS @@ -94,23 +94,19 @@ set to indicate the error. The \fBllseek()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 10n -.rt The \fIfildes\fR argument is not an open file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIwhence\fR argument is not \fBSEEK_SET\fR, \fBSEEK_CUR\fR, or \fBSEEK_END\fR; the \fIoffset\fR argument is not a valid offset for this file system type; or the \fIfildes\fR argument is not a remote file descriptor and @@ -119,24 +115,20 @@ the resulting file pointer would be negative. .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 10n -.rt For \fBSEEK_DATA\fR, there are no more data regions past the supplied offset. For \fBSEEK_HOLE\fR, there are no more holes past the supplied offset. .RE .sp .ne 2 -.mk .na \fB\fBESPIPE\fR\fR .ad .RS 10n -.rt The \fIfildes\fR argument is associated with a pipe or FIFO. .RE diff --git a/usr/src/man/man2/lseek.2 b/usr/src/man/man2/lseek.2 index 0f8dedf809..69b3b65abb 100644 --- a/usr/src/man/man2/lseek.2 +++ b/usr/src/man/man2/lseek.2 @@ -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 lseek 2 "4 May 2005" "SunOS 5.11" "System Calls" +.TH LSEEK 2 "May 4, 2005" .SH NAME lseek \- move read/write file pointer .SH SYNOPSIS @@ -109,23 +109,19 @@ error. The \fBlseek()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 13n -.rt The \fIfildes\fR argument is not an open file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 13n -.rt The \fIwhence\fR argument is not \fBSEEK_SET\fR, \fBSEEK_CUR\fR, or \fBSEEK_END\fR; or the \fIfildes\fR argument is not a remote file descriptor and the resulting file pointer would be negative. @@ -133,36 +129,30 @@ and the resulting file pointer would be negative. .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 13n -.rt For \fBSEEK_DATA\fR, there are no more data regions past the supplied offset. For \fBSEEK_HOLE\fR, there are no more holes past the supplied offset. .RE .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The resulting file offset would be a value which cannot be represented correctly in an object of type \fBoff_t\fR for regular files. .RE .sp .ne 2 -.mk .na \fB\fBESPIPE\fR\fR .ad .RS 13n -.rt The \fIfildes\fR argument is associated with a pipe, a FIFO, or a socket. .RE @@ -185,15 +175,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/memcntl.2 b/usr/src/man/man2/memcntl.2 index 12b05bd873..0e380753d1 100644 --- a/usr/src/man/man2/memcntl.2 +++ b/usr/src/man/man2/memcntl.2 @@ -4,7 +4,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 memcntl 2 "10 Apr 2007" "SunOS 5.11" "System Calls" +.TH MEMCNTL 2 "Apr 10, 2007" .SH NAME memcntl \- memory management control .SH SYNOPSIS @@ -13,7 +13,7 @@ memcntl \- memory management control #include <sys/types.h> #include <sys/mman.h> -\fBint\fR \fBmemcntl\fR(\fBcaddr_t\fR \fIaddr\fR, \fBsize_t\fR \fIlen\fR, \fBint\fR \fIcmd\fR, \fBcaddr_t\fR \fIarg\fR, +\fBint\fR \fBmemcntl\fR(\fBcaddr_t\fR \fIaddr\fR, \fBsize_t\fR \fIlen\fR, \fBint\fR \fIcmd\fR, \fBcaddr_t\fR \fIarg\fR, \fBint\fR \fIattr\fR, \fBint\fR \fImask\fR); .fi @@ -34,23 +34,19 @@ bit pattern contained in \fIattr\fR. The following attributes specify page mapping selection criteria: .sp .ne 2 -.mk .na \fB\fBSHARED\fR\fR .ad .RS 11n -.rt Page is mapped shared. .RE .sp .ne 2 -.mk .na \fB\fBPRIVATE\fR\fR .ad .RS 11n -.rt Page is mapped private. .RE @@ -61,34 +57,28 @@ selection criteria are constructed by a bitwise OR operation on the attribute bits and must match exactly. .sp .ne 2 -.mk .na \fB\fBPROT_READ\fR\fR .ad .RS 14n -.rt Page can be read. .RE .sp .ne 2 -.mk .na \fB\fBPROT_WRITE\fR\fR .ad .RS 14n -.rt Page can be written. .RE .sp .ne 2 -.mk .na \fB\fBPROT_EXEC\fR\fR .ad .RS 14n -.rt Page can be executed. .RE @@ -97,23 +87,19 @@ Page can be executed. The following criteria may also be specified: .sp .ne 2 -.mk .na \fB\fBPROC_TEXT\fR\fR .ad .RS 13n -.rt Process text. .RE .sp .ne 2 -.mk .na \fB\fBPROC_DATA\fR\fR .ad .RS 13n -.rt Process data. .RE @@ -133,7 +119,6 @@ The operation to be performed is identified by the argument \fIcmd\fR. The symbolic names for the operations are defined in <\fBsys/mman.h\fR> as follows: .sp .ne 2 -.mk .na \fB\fBMC_LOCK\fR\fR .ad @@ -157,7 +142,6 @@ potential future enhancements. .sp .ne 2 -.mk .na \fB\fBMC_LOCKAS\fR\fR .ad @@ -170,23 +154,19 @@ future enhancements. The \fIarg\fR argument is a bit pattern built from the flags: .sp .ne 2 -.mk .na \fB\fBMCL_CURRENT\fR\fR .ad .RS 15n -.rt Lock current mappings. .RE .sp .ne 2 -.mk .na \fB\fBMCL_FUTURE\fR\fR .ad .RS 15n -.rt Lock future mappings. .RE @@ -198,7 +178,6 @@ to the address space will be locked, provided sufficient memory is available. .sp .ne 2 -.mk .na \fB\fBMC_SYNC\fR\fR .ad @@ -212,34 +191,28 @@ backing storage for a modified \fBMAP_PRIVATE\fR mapping is its swap area. The behavior of the operation: .sp .ne 2 -.mk .na \fB\fBMS_ASYNC\fR\fR .ad .RS 17n -.rt Perform asynchronous writes. .RE .sp .ne 2 -.mk .na \fB\fBMS_SYNC\fR\fR .ad .RS 17n -.rt Perform synchronous writes. .RE .sp .ne 2 -.mk .na \fB\fBMS_INVALIDATE\fR\fR .ad .RS 17n -.rt Invalidate mappings. .RE @@ -255,7 +228,6 @@ require a memory object to be in a known state. .sp .ne 2 -.mk .na \fB\fBMC_UNLOCK\fR\fR .ad @@ -268,7 +240,6 @@ potential future enhancements. .sp .ne 2 -.mk .na \fB\fBMC_UNLOCKAS\fR\fR .ad @@ -282,7 +253,6 @@ compatibility with potential future enhancements. .sp .ne 2 -.mk .na \fB\fBMC_HAT_ADVISE\fR\fR .ad @@ -374,12 +344,10 @@ returns \fB\(mi1\fR and sets \fBerrno\fR to indicate an error. The \fBmemcntl()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt When the selection criteria match, some or all of the memory identified by the operation could not be locked when \fBMC_LOCK\fR or \fBMC_LOCKAS\fR was specified, some or all mappings in the address range [\fIaddr\fR, \fIaddr\fR + @@ -393,12 +361,10 @@ memory. .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 10n -.rt When the selection criteria match, some or all of the addresses in the range [\fIaddr, addr + len\fR) are locked and \fBMC_SYNC\fR with the \fBMS_INVALIDATE\fR option was specified. @@ -406,12 +372,10 @@ When the selection criteria match, some or all of the addresses in the range .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIaddr\fR argument specifies invalid selection criteria or is not a multiple of the page size as returned by \fBsysconf\fR(3C); the \fIaddr\fR and/or \fIlen\fR argument does not have the value \fB0\fR when \fBMC_LOCKAS\fR @@ -423,12 +387,10 @@ the same access permissions within the given size boundaries. .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt When the selection criteria match, some or all of the addresses in the range [\fIaddr\fR, \fIaddr\fR + \fIlen\fR) are invalid for the address space of a process or specify one or more pages which are not mapped. @@ -436,12 +398,10 @@ process or specify one or more pages which are not mapped. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_PROC_LOCK_MEMORY\fR} privilege is not asserted in the effective set of the calling process and \fBMC_LOCK\fR, \fBMC_LOCKAS\fR, \fBMC_UNLOCK\fR, or \fBMC_UNLOCKAS\fR was specified. @@ -455,13 +415,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/meminfo.2 b/usr/src/man/man2/meminfo.2 index 0de1e3768a..e606865486 100644 --- a/usr/src/man/man2/meminfo.2 +++ b/usr/src/man/man2/meminfo.2 @@ -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 meminfo 2 "21 Feb 2003" "SunOS 5.11" "System Calls" +.TH MEMINFO 2 "Feb 21, 2003" .SH NAME meminfo \- provide information about memory .SH SYNOPSIS @@ -20,69 +20,57 @@ meminfo \- provide information about memory .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIinaddr\fR\fR .ad .RS 14n -.rt array of input addresses; the maximum number of addresses that can be processed for each call is \fBMAX_MEMINFO_CNT\fR .RE .sp .ne 2 -.mk .na \fB\fIaddr_count\fR\fR .ad .RS 14n -.rt number of addresses .RE .sp .ne 2 -.mk .na \fB\fIinfo_req\fR\fR .ad .RS 14n -.rt array of types of information requested .RE .sp .ne 2 -.mk .na \fB\fIinfo_count\fR\fR .ad .RS 14n -.rt number of pieces of information requested for each address in \fIinaddr\fR .RE .sp .ne 2 -.mk .na \fB\fIoutdata\fR\fR .ad .RS 14n -.rt array into which results are placed; array size must be the product of \fIinfo_count\fR and \fIaddr_count\fR .RE .sp .ne 2 -.mk .na \fB\fIvalidity\fR\fR .ad .RS 14n -.rt array of size \fIaddr_count\fR containing bitwise result codes; 0th bit evaluates validity of corresponding input address, 1st bit validity of response to first member of \fIinfo_req\fR, and so on @@ -102,78 +90,64 @@ The caller of \fBmeminfo()\fR can obtain the following types of information about both virtual and physical memory. .sp .ne 2 -.mk .na \fB\fBMEMINFO_VPHYSICAL\fR\fR .ad .RS 26n -.rt physical address corresponding to virtual address .RE .sp .ne 2 -.mk .na \fB\fBMEMINFO_VLGRP\fR\fR .ad .RS 26n -.rt locality group of physical page corresponding to virtual address .RE .sp .ne 2 -.mk .na \fB\fBMEMINFO_VPAGESIZE\fR\fR .ad .RS 26n -.rt size of physical page corresponding to virtual address .RE .sp .ne 2 -.mk .na \fB\fBMEMINFO_VREPLCNT\fR\fR .ad .RS 26n -.rt number of replicated physical pages corresponding to specified virtual address .RE .sp .ne 2 -.mk .na \fB\fBMEMINFO_VREPL\fR | \fIn\fR\fR .ad .RS 26n -.rt \fIn\fRth physical replica of specified virtual address .RE .sp .ne 2 -.mk .na \fB\fBMEMINFO_VREPL_LGRP\fR | \fIn\fR\fR .ad .RS 26n -.rt lgrp of \fIn\fRth physical replica of specified virtual address .RE .sp .ne 2 -.mk .na \fB\fBMEMINFO_PLGRP\fR\fR .ad .RS 26n -.rt locality group of specified physical address .RE @@ -188,24 +162,20 @@ returned and \fBerrno\fR is set to indicate the error. The \fBmeminfo()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The area pointed to by \fIoutdata\fR or \fIvalidity\fR could not be written, or the data pointed to by \fIinfo_req\fR or \fIinaddr\fR could not be read. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIinfo_count\fR is greater than 31 or less than 1, or the value of \fIaddr_count\fR is less than 1. .RE @@ -240,7 +210,7 @@ print_info(void **addrvec, int how_many) for (i = 0; i < how_many; i++) inaddr[i] = (uint64_t)addrvec[i]; - if (meminfo(inaddr, how_many, info, info_num, outdata, + if (meminfo(inaddr, how_many, info, info_num, outdata, validity) < 0) { perror("meminfo"); return; @@ -267,7 +237,7 @@ print_info(void **addrvec, int how_many) "page 0x%llx of size %s\en", inaddr[i], outdata[i * info_num], buff); } - } + } } .fi .in -2 @@ -280,15 +250,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStable +Interface Stability Stable _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/mincore.2 b/usr/src/man/man2/mincore.2 index 661eba5a71..222690ac1b 100644 --- a/usr/src/man/man2/mincore.2 +++ b/usr/src/man/man2/mincore.2 @@ -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 mincore 2 "12 Aug 1990" "SunOS 5.11" "System Calls" +.TH MINCORE 2 "Aug 12, 1990" .SH NAME mincore \- determine residency of memory pages .SH SYNOPSIS @@ -42,23 +42,19 @@ Upon successful completion, \fBmincore()\fR returns \fB0\fR. Otherwise, The \fBmincore()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIvec\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIaddr\fR argument is not a multiple of the page size as returned by \fBsysconf\fR(3C), or the \fIlen\fR argument has a value less than or equal to 0. @@ -66,12 +62,10 @@ The \fIaddr\fR argument is not a multiple of the page size as returned by .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt Addresses in the range [\fIaddr, addr + len\fR] are invalid for the address space of a process or specify one or more pages which are not mapped. .RE diff --git a/usr/src/man/man2/mkdir.2 b/usr/src/man/man2/mkdir.2 index 6ee00617cc..6649c96c7d 100644 --- a/usr/src/man/man2/mkdir.2 +++ b/usr/src/man/man2/mkdir.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 2001, the Institute of Electrical and Electronics Engineers, Inc. and The Open Group. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 mkdir 2 "18 May 2007" "SunOS 5.11" "System Calls" +.TH MKDIR 2 "May 18, 2007" .SH NAME mkdir \- make a directory .SH SYNOPSIS @@ -62,24 +62,20 @@ error. The \fBmkdir()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Either a component of the path prefix denies search permission or write permission is denied on the parent directory of the directory to be created. .RE .sp .ne 2 -.mk .na \fB\fBEDQUOT\fR\fR .ad .RS 16n -.rt The directory where the new file entry is being placed cannot be extended because the user's quota of disk blocks on that file system has been exhausted; the new directory cannot be created because the user's quota of disk blocks on @@ -89,91 +85,75 @@ system where the file is being created has been exhausted. .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 16n -.rt The named file already exists. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt An attempt was made to create an extended attribute that is a directory. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error has occurred while accessing the file system. .RE .sp .ne 2 -.mk .na \fB\fBEILSEQ\fR\fR .ad .RS 16n -.rt The path argument includes non-UTF8 characters and the file system accepts only file names where all characters are part of the UTF-8 character codeset. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR, or a loop exists in symbolic links encountered during resolution of \fIpath\fR .RE .sp .ne 2 -.mk .na \fB\fBEMLINK\fR\fR .ad .RS 16n -.rt The maximum number of links to the parent directory would be exceeded. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds \fBPATH_MAX\fR, or the length of a \fIpath\fR component exceeds \fBNAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -181,57 +161,47 @@ effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of the path prefix does not exist or is a null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 16n -.rt No free space is available on the device containing the directory. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The path prefix resides on a read-only file system. .RE @@ -240,12 +210,10 @@ The path prefix resides on a read-only file system. The \fBmkdir()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt As a result of encountering a symbolic link in resolution of the \fIpath\fR argument, the length of the substituted pathname string exceeded {\fBPATH_MAX\fR}. @@ -267,7 +235,7 @@ group, and with read and search permissions for others. #include <sys/stat.h> int status; \&... -status = mkdir("/home/cnd/mod1", +status = mkdir("/home/cnd/mod1", S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH); .fi .in -2 @@ -280,15 +248,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/mknod.2 b/usr/src/man/man2/mknod.2 index bc33328fb0..e50db4b73f 100644 --- a/usr/src/man/man2/mknod.2 +++ b/usr/src/man/man2/mknod.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 2004 Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 mknod 2 "19 Feb 2004" "SunOS 5.11" "System Calls" +.TH MKNOD 2 "Feb 19, 2004" .SH NAME mknod \- make a directory, a special file, or a regular file .SH SYNOPSIS @@ -30,56 +30,46 @@ The file type is specified in \fImode\fR by the \fBS_IFMT\fR bits, which must be set to one of the following values: .sp .ne 2 -.mk .na \fB\fBS_IFIFO\fR\fR .ad .RS 11n -.rt fifo special .RE .sp .ne 2 -.mk .na \fB\fBS_IFCHR\fR\fR .ad .RS 11n -.rt character special .RE .sp .ne 2 -.mk .na \fB\fBS_IFDIR\fR\fR .ad .RS 11n -.rt directory .RE .sp .ne 2 -.mk .na \fB\fBS_IFBLK\fR\fR .ad .RS 11n -.rt block special .RE .sp .ne 2 -.mk .na \fB\fBS_IFREG\fR\fR .ad .RS 11n -.rt ordinary file .RE @@ -91,31 +81,29 @@ and may be constructed by a bitwise \fBOR\fR operation of the following values: .sp .TS -tab(); -lw(1.08i) lw(.89i) lw(3.53i) -lw(1.08i) lw(.89i) lw(3.53i) -. -\fBS_ISUID\fR04000Set user ID on execution. -\fBS_ISGID\fR020#0T{ +l l l +l l l . +\fBS_ISUID\fR 04000 Set user ID on execution. +\fBS_ISGID\fR 020#0 T{ Set group ID on execution if # is \fB7\fR, \fB5\fR, \fB3\fR, or \fB1\fR. Enable mandatory file/record locking if # is \fB6\fR, \fB4\fR, \fB2\fR, or \fB0\fR T} -\fBS_ISVTX\fR01000T{ +\fBS_ISVTX\fR 01000 T{ On directories, restricted deletion flag; on regular files on a UFS file system, do not cache flag. T} -\fBS_IRWXU\fR00700Read, write, execute by owner. -\fBS_IRUSR\fR00400Read by owner. -\fBS_IWUSR\fR00200Write by owner. -\fBS_IXUSR\fR00100T{ +\fBS_IRWXU\fR 00700 Read, write, execute by owner. +\fBS_IRUSR\fR 00400 Read by owner. +\fBS_IWUSR\fR 00200 Write by owner. +\fBS_IXUSR\fR 00100 T{ Execute (search if a directory) by owner. T} -\fBS_IRWXG\fR00070Read, write, execute by group. -\fBS_IRGRP\fR00040Read by group. -\fBS_IWGRP\fR00020Write by group. -\fBS_IXGRP\fR00010Execute by group. -\fBS_IRWXO\fR00007Read, write, execute (search) by others. -\fBS_IROTH\fR00004Read by others. -\fBS_IWOTH\fR00002Write by others -\fBS_IXOTH\fR00001Execute by others. +\fBS_IRWXG\fR 00070 Read, write, execute by group. +\fBS_IRGRP\fR 00040 Read by group. +\fBS_IWGRP\fR 00020 Write by group. +\fBS_IXGRP\fR 00010 Execute by group. +\fBS_IRWXO\fR 00007 Read, write, execute (search) by others. +\fBS_IROTH\fR 00004 Read by others. +\fBS_IWOTH\fR 00002 Write by others +\fBS_IXOTH\fR 00001 Execute by others. .TE .sp @@ -150,24 +138,20 @@ indicate the error. The \fBmknod()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt A component of the path prefix denies search permission, or write permission is denied on the parent directory. .RE .sp .ne 2 -.mk .na \fB\fBEDQUOT\fR\fR .ad .RS 16n -.rt The directory where the new file entry is being placed cannot be extended because the user's quota of disk blocks on that file system has been exhausted, or the user's quota of inodes on the file system where the file is being @@ -176,78 +160,64 @@ created has been exhausted. .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 16n -.rt The named file exists. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fBmknod()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt An invalid argument exists. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while accessing the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds {\fB\fR\fBPATH_MAX\fR}, or the length of a \fIpath\fR component exceeds {\fB\fR\fBNAME_MAX\fR} while \fB\fR\fB_POSIX_NO_TRUNC\fR is in effect. @@ -255,70 +225,58 @@ length of a \fIpath\fR component exceeds {\fB\fR\fBNAME_MAX\fR} while .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of the path prefix specified by \fIpath\fR does not name an existing directory or \fIpath\fR is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 16n -.rt The directory that would contain the new file cannot be extended or the file system is out of file allocation resources. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt Not all privileges are asserted in the effective set of the calling process. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The directory in which the file is to be created is located on a read-only file system. .RE @@ -328,12 +286,10 @@ system. The \fBmknod()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt Pathname resolution of a symbolic link produced an intermediate result whose length exceeds {\fBPATH_MAX\fR}. .RE @@ -361,15 +317,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/mmap.2 b/usr/src/man/man2/mmap.2 index b3c9a1f0f8..2c10a4aa78 100644 --- a/usr/src/man/man2/mmap.2 +++ b/usr/src/man/man2/mmap.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 mmap 2 "4 Feb 2009" "SunOS 5.11" "System Calls" +.TH MMAP 2 "Feb 4, 2009" .SH NAME mmap \- map pages of memory .SH SYNOPSIS @@ -74,45 +74,37 @@ one or more of the other flags in the following table, defined in the header <\fBsys/mman.h\fR>. .sp .ne 2 -.mk .na \fB\fBPROT_READ\fR\fR .ad .RS 14n -.rt Data can be read. .RE .sp .ne 2 -.mk .na \fB\fBPROT_WRITE\fR\fR .ad .RS 14n -.rt Data can be written. .RE .sp .ne 2 -.mk .na \fB\fBPROT_EXEC\fR\fR .ad .RS 14n -.rt Data can be executed. .RE .sp .ne 2 -.mk .na \fB\fBPROT_NONE\fR\fR .ad .RS 14n -.rt Data cannot be accessed. .RE @@ -140,89 +132,73 @@ mapped data. The value of \fIflags\fR is the bitwise inclusive \fBOR\fR of these options, defined in <\fBsys/mman.h\fR>: .sp .ne 2 -.mk .na \fB\fBMAP_SHARED\fR\fR .ad .RS 17n -.rt Changes are shared. .RE .sp .ne 2 -.mk .na \fB\fBMAP_PRIVATE\fR\fR .ad .RS 17n -.rt Changes are private. .RE .sp .ne 2 -.mk .na \fB\fBMAP_FIXED\fR\fR .ad .RS 17n -.rt Interpret \fIaddr\fR exactly. .RE .sp .ne 2 -.mk .na \fB\fBMAP_NORESERVE\fR\fR .ad .RS 17n -.rt Do not reserve swap space. .RE .sp .ne 2 -.mk .na \fB\fBMAP_ANON\fR\fR .ad .RS 17n -.rt Map anonymous memory. .RE .sp .ne 2 -.mk .na \fB\fBMAP_ALIGN\fR\fR .ad .RS 17n -.rt Interpret \fIaddr\fR as required aligment. .RE .sp .ne 2 -.mk .na \fB\fBMAP_TEXT\fR\fR .ad .RS 17n -.rt Map text. .RE .sp .ne 2 -.mk .na \fB\fBMAP_INITDATA\fR\fR .ad .RS 17n -.rt Map initialized data segment. .RE @@ -378,7 +354,7 @@ If length > 4 Mbytes round to 4-Mbyte multiple elseif length > 512 Kbytes round to 512-Kbyte multiple -else +else round to 64-Kbyte multiple .fi .in -2 @@ -471,7 +447,6 @@ Combine amounts over 1008 Kbytes into 4080-Kbyte chunks. The following is the output from a 32-bit program demonstrating this: .sp .ne 2 -.mk .na \fBmap 8192 bytes: \fB0xff390000\fR\fR .ad @@ -486,7 +461,6 @@ The following is the output from a 32-bit program demonstrating this: .sp .ne 2 -.mk .na \fBmap 512 Kbytes: \fB0xff180000\fR\fR .ad @@ -501,7 +475,6 @@ The following is the output from a 32-bit program demonstrating this: .sp .ne 2 -.mk .na \fBmap 496 Kbytes: \fB0xff000000\fR\fR .ad @@ -516,7 +489,6 @@ The following is the output from a 32-bit program demonstrating this: .sp .ne 2 -.mk .na \fBmap 1 Mbyte: \fB0xfee00000\fR\fR .ad @@ -531,7 +503,6 @@ The following is the output from a 32-bit program demonstrating this: .sp .ne 2 -.mk .na \fBmap 1008 Kbytes: \fB0xfeb80000\fR\fR .ad @@ -546,7 +517,6 @@ The following is the output from a 32-bit program demonstrating this: .sp .ne 2 -.mk .na \fBmap 4 Mbytes: \fB0xfe400000\fR\fR .ad @@ -561,7 +531,6 @@ The following is the output from a 32-bit program demonstrating this: .sp .ne 2 -.mk .na \fBmap 4080 Kbytes: \fB0xfd800000\fR\fR .ad @@ -580,7 +549,6 @@ The following is the output of the same program compiled as a 64-bit application: .sp .ne 2 -.mk .na \fBmap 8192 bytes: \fB0xffffffff7f000000\fR\fR .ad @@ -595,7 +563,6 @@ application: .sp .ne 2 -.mk .na \fBmap 512 Kbytes: \fB0xffffffff7ee00000\fR\fR .ad @@ -610,7 +577,6 @@ application: .sp .ne 2 -.mk .na \fBmap 496 Kbytes: \fB0xffffffff7ec00000\fR\fR .ad @@ -625,7 +591,6 @@ application: .sp .ne 2 -.mk .na \fBmap 1 Mbyte: \fB0xffffffff7e900000\fR\fR .ad @@ -640,7 +605,6 @@ application: .sp .ne 2 -.mk .na \fBmap 1008 Kbytes: \fB0xffffffff7e600000\fR\fR .ad @@ -655,7 +619,6 @@ application: .sp .ne 2 -.mk .na \fBmap 4 Mbytes: \fB0xffffffff7e000000\fR\fR .ad @@ -670,7 +633,6 @@ application: .sp .ne 2 -.mk .na \fBmap 4080 Kbytes: \fB0xffffffff7d400000\fR\fR .ad @@ -702,12 +664,10 @@ and continuing for \fIlen\fR bytes may have been unmapped. The \fBmmap()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 13n -.rt The \fIfildes\fR file descriptor is not open for read, regardless of the protection specified; or \fIfildes\fR is not open for write and \fBPROT_WRITE\fR was specified for a \fBMAP_SHARED\fR type mapping. @@ -715,12 +675,10 @@ protection specified; or \fIfildes\fR is not open for write and .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 13n -.rt The mapping could not be locked in memory. .sp There was insufficient room to reserve swap space for the mapping. @@ -728,24 +686,20 @@ There was insufficient room to reserve swap space for the mapping. .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 13n -.rt The \fIfildes\fR file descriptor is not open (and \fBMAP_ANON\fR was not specified). .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 13n -.rt The arguments \fIaddr\fR (if \fBMAP_FIXED\fR was specified) or \fIoff\fR are not multiples of the page size as returned by \fBsysconf()\fR. .sp @@ -768,36 +722,30 @@ The argument \fIlen\fR has a value equal to 0. .sp .ne 2 -.mk .na \fB\fBEMFILE\fR\fR .ad .RS 13n -.rt The number of mapped regions would exceed an implementation-dependent limit (per process or per system). .RE .sp .ne 2 -.mk .na \fB\fBENODEV\fR\fR .ad .RS 13n -.rt The \fIfildes\fR argument refers to an object for which \fBmmap()\fR is meaningless, such as a terminal. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 13n -.rt The \fBMAP_FIXED\fR option was specified and the range [\fIaddr, addr + len\fR) exceeds that allowed for the address space of a process. .sp @@ -813,24 +761,20 @@ calls to \fBmmap()\fR exceeds \fBRLIMIT_VMEM\fR (see \fBgetrlimit\fR(2)). .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 13n -.rt The system does not support the combination of accesses requested in the \fIprot\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 13n -.rt Addresses in the range [\fIoff, off + len\fR) are invalid for the object specified by \fIfildes\fR. .sp @@ -841,12 +785,10 @@ The \fBMAP_FIXED\fR option was specified in \fIflags\fR and the combination of .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The file is a regular file and the value of \fIoff\fR plus \fIlen\fR exceeds the offset maximum establish in the open file description associated with \fIfildes\fR. @@ -857,12 +799,10 @@ the offset maximum establish in the open file description associated with The \fBmmap()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt The file to be mapped is already locked using advisory or mandatory record locking. See \fBfcntl\fR(2). .RE @@ -933,15 +873,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/mmapobj.2 b/usr/src/man/man2/mmapobj.2 index 036d97fdaa..a8b2a25120 100644 --- a/usr/src/man/man2/mmapobj.2 +++ b/usr/src/man/man2/mmapobj.2 @@ -4,7 +4,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 mmapobj 2 "1 Dec 2008" "SunOS 5.11" "System Calls" +.TH MMAPOBJ 2 "Dec 1, 2008" .SH NAME mmapobj \- map a file object in the appropriate manner .SH SYNOPSIS @@ -19,28 +19,23 @@ mmapobj \- map a file object in the appropriate manner .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIfd\fR\fR .ad .RS 12n -.rt The open file descriptor for the file to be mapped. .RE .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 12n -.rt Indicates that the default behavior of \fBmmapobj()\fR should be modified accordingly. Available flags are: .sp .ne 2 -.mk .na \fB\fBMMOBJ_INTERPRET\fR\fR .ad @@ -52,7 +47,6 @@ single image. This flag can be used only with \fBELF\fR and \fBAOUT\fR files. .sp .ne 2 -.mk .na \fB\fBMMOBJ_PADDING\fR\fR .ad @@ -70,24 +64,20 @@ changed. This padding request will be ignored for the \fBAOUT\fR format. .sp .ne 2 -.mk .na \fB\fIstorage\fR\fR .ad .RS 12n -.rt A pointer to the \fBmmapobj_result_t\fR array where the mapping data will be copied out after a successful mapping of \fIfd\fR. .RE .sp .ne 2 -.mk .na \fB\fIelements\fR\fR .ad .RS 12n -.rt A pointer to the number of \fBmmapobj_result_t\fR elements pointed to by \fIstorage\fR. On return, \fIelements\fR contains the number of mappings required to fully map the requested object. If the original value of @@ -97,12 +87,10 @@ modified to contain the number of mappings necessary. .sp .ne 2 -.mk .na \fB\fIarg\fR\fR .ad .RS 12n -.rt A pointer to additional information that might be associated with the specific request. Only the \fBMMOBJ_PADDING\fR request uses this argument. If \fBMMOBJ_PADDING\fR is not specified, \fIarg\fR must be \fINULL\fR. @@ -119,7 +107,6 @@ the rules for that file format. The following \fBELF\fR and \fBAOUT\fR formats are supported: .sp .ne 2 -.mk .na \fB\fBET_EXEC\fR and \fBAOUT\fR executables\fR .ad @@ -132,7 +119,6 @@ address of each mapping is explicitly defined by the file's program headers. .sp .ne 2 -.mk .na \fB\fBET_DYN\fR and \fBAOUT\fR shared objects\fR .ad @@ -147,7 +133,6 @@ program headers. .sp .ne 2 -.mk .na \fB\fBET_REL\fR and \fBET_CORE\fR\fR .ad @@ -238,12 +223,10 @@ data is copied to storage. The \fBmmapobj()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBE2BIG\fR\fR .ad .RS 14n -.rt The \fIelements\fR argument was not large enough to hold the number of loadable segments in \fIfd\fR. The \fIelements\fR argument will be modified to contain the number of segments required. @@ -251,35 +234,29 @@ the number of segments required. .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 14n -.rt The file system containing the \fIfd\fR to be mapped does not allow execute access, or the file descriptor pointed to by \fIfd\fR is not open for reading. .RE .sp .ne 2 -.mk .na \fB\fBEADDRINUSE\fR\fR .ad .RS 14n -.rt The mapping requirements overlap an object that is already used by the process. .RE .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 14n -.rt There is insufficient room to reserve swap space for the mapping. .sp The file to be mapped is already locked using advisory or mandatory record @@ -288,35 +265,29 @@ locking. See \fBfcntl\fR(2). .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 14n -.rt The \fIfd\fR argument is not a valid open file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 14n -.rt The \fIstorage\fR, \fIarg\fR, or \fIelements\fR argument points to an invalid address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 14n -.rt The \fIflags\fR argument contains an invalid flag. .sp \fBMMOBJ_PADDING\fR was not specified in \fIflags\fRand \fIarg\fR was non-null. @@ -324,24 +295,20 @@ The \fIflags\fR argument contains an invalid flag. .sp .ne 2 -.mk .na \fB\fBENODEV\fR\fR .ad .RS 14n -.rt The \fIfd\fR argument refers to an object for which \fBmmapobj()\fR is meaningless, such as a terminal. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 14n -.rt Insufficient memory is available to hold the program headers. .sp Insufficient memory is available in the address space to create the mapping. @@ -349,12 +316,10 @@ Insufficient memory is available in the address space to create the mapping. .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 14n -.rt The current user data model does not match the \fIfd\fR to be interpreted; thus, a 32-bit process that tried to use \fBmmapobj()\fR to interpret a 64-bit object would return \fBENOTSUP\fR. @@ -367,12 +332,10 @@ The \fBELF\fR header contains an unaligned \fIe_phentsize\fR value. .sp .ne 2 -.mk .na \fB\fBENOSYS\fR\fR .ad .RS 14n -.rt An unsupported filesystem operation was attempted while trying to map in the object. .RE @@ -385,15 +348,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityPrivate +Interface Stability Private _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/mount.2 b/usr/src/man/man2/mount.2 index 8eb7428e26..1e6aec0e18 100644 --- a/usr/src/man/man2/mount.2 +++ b/usr/src/man/man2/mount.2 @@ -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 mount 2 "26 Feb 2004" "SunOS 5.11" "System Calls" +.TH MOUNT 2 "Feb 26, 2004" .SH NAME mount \- mount a file system .SH SYNOPSIS @@ -66,12 +66,10 @@ The \fImflag\fR argument is constructed by a bitwise-inclusive-OR of flags from the following list, defined in <\fBsys/mount.h\fR>. .sp .ne 2 -.mk .na \fB\fBMS_DATA\fR\fR .ad .RS 16n -.rt The \fIdataptr\fR and \fIdatalen\fR arguments describe a block of file system-specific binary data at address \fIdataptr\fR of length \fIdatalen\fR. This is interpreted by file system-specific code within the operating system @@ -82,24 +80,20 @@ type does not require this data, \fIdataptr\fR and \fIdatalen\fR should both be .sp .ne 2 -.mk .na \fB\fBMS_GLOBAL\fR\fR .ad .RS 16n -.rt Mount a file system globally if the system is configured and booted as part of a cluster (see \fBclinfo\fR(1M)). .RE .sp .ne 2 -.mk .na \fB\fBMS_NOSUID\fR\fR .ad .RS 16n -.rt Prevent programs that are marked set-user-\fBID\fR or set-group-\fBID\fR from executing (see \fBchmod\fR(1)). It also causes \fBopen\fR(2) to return \fBENXIO\fR when attempting to open block or character special files. @@ -107,12 +101,10 @@ executing (see \fBchmod\fR(1)). It also causes \fBopen\fR(2) to return .sp .ne 2 -.mk .na \fB\fBMS_OPTIONSTR\fR\fR .ad .RS 16n -.rt The \fIoptptr\fR and \fIoptlen\fR arguments describe a character buffer at address \fIoptptr\fR of size \fIoptlen\fR. When calling \fBmount()\fR, the character buffer should contain a null-terminated string of options to be @@ -132,12 +124,10 @@ be returned in the recognized options list that is returned. .sp .ne 2 -.mk .na \fB\fBMS_OVERLAY\fR\fR .ad .RS 16n -.rt Allow the file system to be mounted over an existing file system mounted on \fIdir\fR, making the underlying file system inaccessible. If a mount is attempted on a pre-existing mount point without setting this flag, the mount @@ -146,12 +136,10 @@ will fail. .sp .ne 2 -.mk .na \fB\fBMS_RDONLY\fR\fR .ad .RS 16n -.rt Mount the file system for reading only. This flag should also be specified for file systems that are incapable of writing (for example, CDROM). Without this flag, writing is permitted according to individual file accessibility. @@ -159,12 +147,10 @@ flag, writing is permitted according to individual file accessibility. .sp .ne 2 -.mk .na \fB\fBMS_REMOUNT\fR\fR .ad .RS 16n -.rt Remount a read-only file system as read-write. .RE @@ -179,12 +165,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBmount()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt The permission bits of the mount point do not permit read/write access or search permission is denied on a component of the path prefix. .sp @@ -199,12 +183,10 @@ mounts or read-write access in the case of read/write mounts. .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 16n -.rt The \fIdir\fR argument is currently mounted on, is someone's current working directory, or is otherwise busy; or the device associated with \fIspec\fR is currently mounted. @@ -212,48 +194,40 @@ currently mounted. .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIspec\fR, \fIdir\fR, \fIfstype\fR, \fIdataptr\fR, or \fIoptptr\fR argument points outside the allocated address space of the process. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The super block has an invalid magic number, the \fIfstype\fR is invalid, or \fIdir\fR is not an absolute path. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIspec\fR or \fIdir\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds \fIPATH_MAX\fR, or the length of a \fIpath\fR component exceeds \fINAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -261,70 +235,58 @@ effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt None of the named files exists or is a null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 16n -.rt The file system state in the super-block is not \fBFsOKAY\fR and \fImflag\fR requests write permission. .RE .sp .ne 2 -.mk .na \fB\fBENOTBLK\fR\fR .ad .RS 16n -.rt The \fIspec\fR argument is not a block special device. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt The \fIdir\fR argument is not a directory, or a component of a path prefix is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 16n -.rt A global mount is attempted (the \fBMS_GLOBAL\fR flag is set in \fImflag\fR) on a machine which is not booted as a cluster; a local mount is attempted and \fIdir\fR is within a globally mounted file system; or a remount was attempted @@ -333,58 +295,48 @@ on a file system that does not support remounting. .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 16n -.rt The device associated with \fIspec\fR does not exist. .RE .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 16n -.rt The length of the option string to be returned in the \fIoptptr\fR argument exceeds the size of the buffer specified by \fIoptlen\fR. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The {\fBPRIV_SYS_MOUNT\fR} privilege is not asserted in the effective set of the calling process. .RE .sp .ne 2 -.mk .na \fB\fBEREMOTE\fR\fR .ad .RS 16n -.rt The \fIspec\fR argument is remote and cannot be mounted. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The \fIspec\fR argument is write protected and \fImflag\fR requests write permission. .RE diff --git a/usr/src/man/man2/mprotect.2 b/usr/src/man/man2/mprotect.2 index 1ebaafcec4..630a5ad766 100644 --- a/usr/src/man/man2/mprotect.2 +++ b/usr/src/man/man2/mprotect.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 mprotect 2 "12 Jan 1998" "SunOS 5.11" "System Calls" +.TH MPROTECT 2 "Jan 12, 1998" .SH NAME mprotect \- set protection of memory mapping .SH SYNOPSIS @@ -28,45 +28,37 @@ specified by \fIprot\fR. Legitimate values for \fIprot\fR are the same as those permitted for \fBmmap\fR(2) and are defined in <\fBsys/mman.h\fR> as: .sp .ne 2 -.mk .na \fB\fBPROT_READ\fR\fR .ad .RS 14n -.rt \fB/* page can be read */\fR .RE .sp .ne 2 -.mk .na \fB\fBPROT_WRITE\fR\fR .ad .RS 14n -.rt \fB/* page can be written */\fR .RE .sp .ne 2 -.mk .na \fB\fBPROT_EXEC\fR\fR .ad .RS 14n -.rt \fB/* page can be executed */\fR .RE .sp .ne 2 -.mk .na \fB\fBPROT_NONE\fR\fR .ad .RS 14n -.rt \fB/* page can not be accessed */\fR .RE @@ -88,36 +80,30 @@ returns \fB\(mi1\fR and sets \fBerrno\fR to indicate the error. The \fBmprotect()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt The \fIprot\fR argument specifies a protection that violates the access permission the process has to the underlying memory object. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIlen\fR argument has a value equal to 0, or \fIaddr\fR is not a multiple of the page size as returned by \fBsysconf\fR(3C). .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt Addresses in the range [\fIaddr, addr + len\fR) are invalid for the address space of a process, or specify one or more pages which are not mapped. .RE @@ -127,12 +113,10 @@ space of a process, or specify one or more pages which are not mapped. The \fBmprotect()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt The address range [\fIaddr, addr + len\fR) includes one or more pages that have been locked in memory and that were mapped \fB\fR\fBMAP_PRIVATE\fR\fB;\fR \fIprot\fR includes \fB\fR\fBPROT_WRITE\fR\fB;\fR and the system has @@ -149,13 +133,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -\fBATTRIBUTE TYPE\fRATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/msgctl.2 b/usr/src/man/man2/msgctl.2 index fd65c0a00a..8af54f1da2 100644 --- a/usr/src/man/man2/msgctl.2 +++ b/usr/src/man/man2/msgctl.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 msgctl 2 "22 Mar 2004" "SunOS 5.11" "System Calls" +.TH MSGCTL 2 "Mar 22, 2004" .SH NAME msgctl \- message control operations .SH SYNOPSIS @@ -25,12 +25,10 @@ The \fBmsgctl()\fR function provides a variety of message control operations as specified by \fIcmd\fR. The following \fIcmd\fRs are available: .sp .ne 2 -.mk .na \fB\fBIPC_STAT\fR\fR .ad .RS 12n -.rt Place the current value of each member of the data structure associated with \fImsqid\fR into the structure pointed to by \fIbuf\fR. The contents of this structure are defined in \fBIntro\fR(2). @@ -38,12 +36,10 @@ structure are defined in \fBIntro\fR(2). .sp .ne 2 -.mk .na \fB\fBIPC_SET\fR\fR .ad .RS 12n -.rt Set the value of the following members of the data structure associated with \fImsqid\fR to the corresponding value found in the structure pointed to by \fIbuf\fR: @@ -66,12 +62,10 @@ associated with \fImsqid\fR. Only a process with the .sp .ne 2 -.mk .na \fB\fBIPC_RMID\fR\fR .ad .RS 12n -.rt Remove the message queue identifier specified by \fImsqid\fR from the system and destroy the message queue and data structure associated with it. This \fIcmd\fR can only be executed by a process that has an effective user \fBID\fR @@ -91,35 +85,29 @@ returns \fB\(mi1\fR and sets \fBerrno\fR to indicate the error. The \fBmsgctl()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBIPC_STAT\fR and operation permission is denied to the calling process (see \fBIntro\fR(2)). .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 13n -.rt The \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 13n -.rt The \fImsqid\fR argument is not a valid message queue identifier; or the \fIcmd\fR argument is not a valid command or is \fBIPC_SET\fR and \fBmsg_perm.uid\fR or \fBmsg_perm.gid\fR is not valid. @@ -127,24 +115,20 @@ The \fImsqid\fR argument is not a valid message queue identifier; or the .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBIPC_STAT\fR and \fIuid\fR or \fIgid\fR is too large to be stored in the structure pointed to by \fIbuf\fR. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBIPC_RMID\fR or \fBIPC_SET\fR, the {\fBPRIV_SYS_IPC_OWNER\fR} privilege is not asserted in the effective set of the calling process, and is not equal to the value of \fBmsg_perm.cuid\fR or @@ -163,13 +147,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/msgget.2 b/usr/src/man/man2/msgget.2 index 8acc61aa7b..aba5614cfa 100644 --- a/usr/src/man/man2/msgget.2 +++ b/usr/src/man/man2/msgget.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1994, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 msgget 2 "14 Aug 2006" "SunOS 5.11" "System Calls" +.TH MSGGET 2 "Aug 14, 2006" .SH NAME msgget \- get message queue .SH SYNOPSIS @@ -92,12 +92,10 @@ set to indicate the error. The \fBmsgget()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt A message queue identifier exists for \fIkey\fR, but operation permission (see \fBIntro\fR(2)) as specified by the low-order 9 bits of \fImsgflg\fR would not be granted. @@ -105,36 +103,30 @@ be granted. .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 10n -.rt A message queue identifier exists for \fIkey\fR but (\fImsgflg\fR\fB&IPC_CREAT\fR) and (\fImsgflg\fR\fB&IPC_EXCL\fR) are both true. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 10n -.rt A message queue identifier does not exist for \fIkey\fR and (\fImsgflg\fR\fB&IPC_CREAT\fR) is false. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 10n -.rt A message queue identifier is to be created but the system-imposed limit on the maximum number of allowed message queue identifiers system wide would be exceeded. See NOTES. @@ -148,13 +140,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/msgids.2 b/usr/src/man/man2/msgids.2 index 1ef775c8bf..88eee4bf1d 100644 --- a/usr/src/man/man2/msgids.2 +++ b/usr/src/man/man2/msgids.2 @@ -4,7 +4,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 msgids 2 "8 Mar 2000" "SunOS 5.11" "System Calls" +.TH MSGIDS 2 "Mar 8, 2000" .SH NAME msgids \- discover all message queue identifiers .SH SYNOPSIS @@ -44,12 +44,10 @@ Upon successful completion, \fBmsgids()\fR returns \fB0\fR. Otherwise, The \fBmsgids()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuf\fR or \fIpnids\fR argument points to an illegal address. .RE @@ -87,7 +85,7 @@ examine_queues() break; /* we need a bigger buffer */ ids = realloc(ids, (nids = n) * sizeof (int)); - } + } for (i = 0; i < n; i++) process_msgid(ids[i]); @@ -105,13 +103,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/msgrcv.2 b/usr/src/man/man2/msgrcv.2 index 6fa0ac3681..27d82b95b1 100644 --- a/usr/src/man/man2/msgrcv.2 +++ b/usr/src/man/man2/msgrcv.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T @(#)msgrcv.2 1.33 98/05/12 Copyright (c) 1999, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 msgrcv 2 "19 May 1999" "SunOS 5.11" "System Calls" +.TH MSGRCV 2 "May 19, 1999" .SH NAME msgrcv \- message receive operation .SH SYNOPSIS @@ -37,7 +37,7 @@ below is an example of what this user-defined buffer might look like: struct mymsg { long int mtype; /* message type */ char mtext[1]; /* message text */ -} +} .fi .in -2 @@ -152,68 +152,56 @@ returned, no message is received, and \fBerrno\fR is set to indicate the error. The \fBmsgrcv()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBE2BIG\fR\fR .ad .RS 10n -.rt The value of \fBmtext\fR is greater than \fImsgsz\fR and (\fImsgflg\fR\fB&MSG_NOERROR\fR) is 0. .RE .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt Operation permission is denied to the calling process. See \fBIntro\fR(2). .RE .sp .ne 2 -.mk .na \fB\fBEIDRM\fR\fR .ad .RS 10n -.rt The message queue identifier \fImsqid\fR is removed from the system. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 10n -.rt The \fBmsgrcv()\fR function was interrupted by a signal. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fImsqid\fR argument is not a valid message queue identifier. .RE .sp .ne 2 -.mk .na \fB\fBENOMSG\fR\fR .ad .RS 10n -.rt The queue does not contain a message of the desired type and (\fImsgflg\fR\fB&IPC_NOWAIT\fR) is non-zero. .RE @@ -223,12 +211,10 @@ The queue does not contain a message of the desired type and The \fBmsgrcv()\fR function may fail if: .sp .ne 2 -.mk .na \fB \fBEFAULT\fR\fR .ad .RS 11n -.rt The \fImsgp\fR argument points to an illegal address. .RE @@ -245,13 +231,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/msgsnap.2 b/usr/src/man/man2/msgsnap.2 index e1f707688f..1f34206f9c 100644 --- a/usr/src/man/man2/msgsnap.2 +++ b/usr/src/man/man2/msgsnap.2 @@ -4,7 +4,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 msgsnap 2 "8 Mar 2000" "SunOS 5.11" "System Calls" +.TH MSGSNAP 2 "Mar 8, 2000" .SH NAME msgsnap \- message queue snapshot operation .SH SYNOPSIS @@ -100,35 +100,29 @@ Upon successful completion, \fBmsgsnap()\fR returns \fB0\fR. Otherwise, The \fBmsgsnap()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt Operation permission is denied to the calling process. See \fBIntro\fR(2). .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fImsqid\fR argument is not a valid message queue identifier or the value of \fIbufsz\fR is less than \fBsizeof(struct msgsnap_head)\fR. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuf\fR argument points to an illegal address. .RE @@ -171,7 +165,7 @@ process_msgid(int msqid) break; /* we need a bigger buffer */ buf = realloc(buf, bufsize = buf->msgsnap_size); - } + } /* process each message in the queue (there may be none) */ mhead = (struct msgsnap_mhead *)(buf + 1); /* first message */ @@ -185,7 +179,7 @@ process_msgid(int msqid) mhead = (struct msgsnap_mhead *) ((char *)mhead + sizeof(struct msgsnap_mhead) + ((mlen + sizeof(size_t) - 1) & ~(sizeof(size_t) - 1))); - } + } free(buf); } @@ -200,13 +194,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/msgsnd.2 b/usr/src/man/man2/msgsnd.2 index 7cd4dd6b11..ad7a0f3fe7 100644 --- a/usr/src/man/man2/msgsnd.2 +++ b/usr/src/man/man2/msgsnd.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 msgsnd 2 "11 Feb 2003" "SunOS 5.11" "System Calls" +.TH MSGSND 2 "Feb 11, 2003" .SH NAME msgsnd \- message send operation .SH SYNOPSIS @@ -138,57 +138,47 @@ returned, no message is sent, and \fBerrno\fR is set to indicate the error. The \fBmsgsnd()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt Operation permission is denied to the calling process. See \fBIntro\fR(2). .RE .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt The message cannot be sent for one of the reasons cited above and (\fImsgflg\fR\fB&IPC_NOWAIT\fR) is non-zero. .RE .sp .ne 2 -.mk .na \fB\fBEIDRM\fR\fR .ad .RS 10n -.rt The message queue identifier \fImsgid\fR is removed from the system. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 10n -.rt The \fBmsgsnd()\fR function was interrupted by a signal. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fImsqid\fR is not a valid message queue identifier, or the value of \fBmtype\fR is less than 1. .sp @@ -201,12 +191,10 @@ limit. The \fBmsgsnd()\fR function may fail if: .sp .ne 2 -.mk .na \fB \fBEFAULT\fR\fR .ad .RS 11n -.rt The \fImsgp\fR argument points to an illegal address. .RE @@ -223,13 +211,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/munmap.2 b/usr/src/man/man2/munmap.2 index c86f398bae..606a259bb0 100644 --- a/usr/src/man/man2/munmap.2 +++ b/usr/src/man/man2/munmap.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 munmap 2 "5 Jan 1998" "SunOS 5.11" "System Calls" +.TH MUNMAP 2 "Jan 5, 1998" .SH NAME munmap \- unmap pages of memory .SH SYNOPSIS @@ -43,12 +43,10 @@ returns \fB\(mi1\fR and sets \fBerrno\fR to indicate an error. The \fBmunmap()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIaddr\fR argument is not a multiple of the page size as returned by \fBsysconf\fR(3C); addresses in the range [\fIaddr, addr + len\fR) are outside the valid range for the address space of a process; or the \fIlen\fR argument @@ -63,13 +61,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/nice.2 b/usr/src/man/man2/nice.2 index 4d943e949d..15b98be8f0 100644 --- a/usr/src/man/man2/nice.2 +++ b/usr/src/man/man2/nice.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 nice 2 "1 Apr 2004" "SunOS 5.11" "System Calls" +.TH NICE 2 "Apr 1, 2004" .SH NAME nice \- change priority of a process .SH SYNOPSIS @@ -55,24 +55,20 @@ not changed, and \fBerrno\fR is set to indicate the error. The \fBnice()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fBnice()\fR function is called by a process in a scheduling class other than time-sharing or fixed-priority. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The \fIincr\fR argument is negative or greater than 40 and the {\fBPRIV_PROC_PRIOCNTL\fR} privilege is not asserted in the effective set of the calling process. @@ -97,15 +93,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/ntp_adjtime.2 b/usr/src/man/man2/ntp_adjtime.2 index 17d9f6665c..e905117b90 100644 --- a/usr/src/man/man2/ntp_adjtime.2 +++ b/usr/src/man/man2/ntp_adjtime.2 @@ -4,7 +4,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 ntp_adjtime 2 "21 May 2009" "SunOS 5.11" "System Calls" +.TH NTP_ADJTIME 2 "May 21, 2009" .SH NAME ntp_adjtime \- adjust local clock parameters .SH SYNOPSIS @@ -65,35 +65,29 @@ Upon successful completion, \fBntp_adjtime()\fR returns the current clock state The \fBntp_adjtime()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fItptr\fR argument is an invalid pointer. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fBconstant\fR member of the structure pointed to by \fItptr\fR is less than 0 or greater than 30. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_SYS_TIME\fR} privilege is not asserted in the effective set of the calling process. .RE diff --git a/usr/src/man/man2/ntp_gettime.2 b/usr/src/man/man2/ntp_gettime.2 index 687187a5f9..1a0976163c 100644 --- a/usr/src/man/man2/ntp_gettime.2 +++ b/usr/src/man/man2/ntp_gettime.2 @@ -4,7 +4,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 ntp_gettime 2 "21 May 2009" "SunOS 5.11" "System Calls" +.TH NTP_GETTIME 2 "May 21, 2009" .SH NAME ntp_gettime \- get local clock values .SH SYNOPSIS @@ -46,12 +46,10 @@ Upon successful completion, \fBntp_gettime()\fR returns the current clock state The \fBntp_gettime()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fItptr\fR argument points to an invalid address. .RE @@ -60,12 +58,10 @@ The \fItptr\fR argument points to an invalid address. The \fBntp_gettime()\fR function will fail for 32-bit interfaces if: .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The size of the \fBtime.tv_sec\fR member of the \fBntptimeval\fR structure pointed to by \fItptr\fR is too small to contain the correct number of seconds. .RE diff --git a/usr/src/man/man2/open.2 b/usr/src/man/man2/open.2 index 348b55522a..30ae089ca7 100644 --- a/usr/src/man/man2/open.2 +++ b/usr/src/man/man2/open.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 open 2 "16 Jun 2008" "SunOS 5.11" "System Calls" +.TH OPEN 2 "Jun 16, 2008" .SH NAME open, openat \- open a file .SH SYNOPSIS @@ -68,34 +68,28 @@ exactly one of the first three values (file access modes) below in the value of \fIoflag\fR: .sp .ne 2 -.mk .na \fB\fBO_RDONLY\fR\fR .ad .RS 12n -.rt Open for reading only. .RE .sp .ne 2 -.mk .na \fB\fBO_WRONLY\fR\fR .ad .RS 12n -.rt Open for writing only. .RE .sp .ne 2 -.mk .na \fB\fBO_RDWR\fR\fR .ad .RS 12n -.rt Open for reading and writing. The result is undefined if this flag is applied to a FIFO. .RE @@ -105,7 +99,6 @@ to a FIFO. Any combination of the following may be used: .sp .ne 2 -.mk .na \fB\fBO_APPEND\fR\fR .ad @@ -116,7 +109,6 @@ If set, the file offset is set to the end of the file prior to each write. .sp .ne 2 -.mk .na \fB\fBO_CREAT\fR\fR .ad @@ -149,7 +141,6 @@ both. .sp .ne 2 -.mk .na \fB\fBO_DSYNC\fR\fR .ad @@ -161,7 +152,6 @@ I/O data integrity completion. .sp .ne 2 -.mk .na \fB\fBO_EXCL\fR\fR .ad @@ -179,7 +169,6 @@ regardless of the contents of the symbolic link. If \fBO_EXCL\fR is set and .sp .ne 2 -.mk .na \fB\fBO_LARGEFILE\fR\fR .ad @@ -191,7 +180,6 @@ that can be represented correctly in an object of type \fBoff64_t\fR. .sp .ne 2 -.mk .na \fB\fBO_NOCTTY\fR\fR .ad @@ -203,7 +191,6 @@ the terminal device to become the controlling terminal for the process. .sp .ne 2 -.mk .na \fB\fBO_NOFOLLOW\fR\fR .ad @@ -215,7 +202,6 @@ If the path names a symbolic link, \fBopen()\fR fails and sets \fBerrno\fR to .sp .ne 2 -.mk .na \fB\fBO_NOLINKS\fR\fR .ad @@ -227,7 +213,6 @@ sets \fBerrno\fR to \fBEMLINK\fR. .sp .ne 2 -.mk .na \fB\fBO_NONBLOCK\fR or \fBO_NDELAY\fR\fR .ad @@ -285,7 +270,6 @@ Otherwise, the behavior of \fBO_NONBLOCK\fR and \fBO_NDELAY\fR is unspecified. .sp .ne 2 -.mk .na \fB\fBO_RSYNC\fR\fR .ad @@ -302,7 +286,6 @@ file integrity completion. .sp .ne 2 -.mk .na \fB\fBO_SYNC\fR\fR .ad @@ -314,7 +297,6 @@ I/O file integrity completion. .sp .ne 2 -.mk .na \fB\fBO_TRUNC\fR\fR .ad @@ -329,7 +311,6 @@ result of using \fBO_TRUNC\fR with \fBO_RDONLY\fR is undefined. .sp .ne 2 -.mk .na \fB\fBO_XATTR\fR\fR .ad @@ -391,34 +372,28 @@ were called with \fIcmd\fR \fBF_SHARE_NBMAND\fR and the \fBfshare_t\fR values set as follows: .sp .ne 2 -.mk .na \fB\fBf_access\fR\fR .ad .RS 12n -.rt Set to the type of read/write access for which the file is opened. .RE .sp .ne 2 -.mk .na \fB\fBf_deny\fR\fR .ad .RS 12n -.rt \fBF_NODNY\fR .RE .sp .ne 2 -.mk .na \fB\fBf_id\fR\fR .ad .RS 12n -.rt The file descriptor value returned from \fBopen()\fR. .RE @@ -447,12 +422,10 @@ and no files are created or modified. The \fBopen()\fR and \fBopenat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied on a component of the path prefix. .sp The file exists and the permissions specified by \fIoflag\fR are denied. @@ -472,35 +445,29 @@ processes to open files for reading regardless of permission bits. .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 16n -.rt A mandatory share reservation could not be obtained because the desired access conflicts with an existing \fBf_deny\fR share reservation. .RE .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 16n -.rt The file descriptor provided to \fBopenat()\fR is invalid. .RE .sp .ne 2 -.mk .na \fB\fBEDQUOT\fR\fR .ad .RS 16n -.rt The file does not exist, \fBO_CREAT\fR is specified, and either the directory where the new file entry is being placed cannot be extended because the user's quota of disk blocks on that file system has been exhausted, or the user's @@ -510,23 +477,19 @@ exhausted. .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 16n -.rt The \fBO_CREAT\fR and \fBO_EXCL\fR flags are set and the named file exists. .RE .sp .ne 2 -.mk .na \fB\fBEILSEQ\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument includes non-UTF8 characters and the file system accepts only file names where all characters are part of the UTF-8 character codeset. @@ -534,34 +497,28 @@ codeset. .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during \fBopen()\fR. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The system does not support synchronized I/O for this file, or the \fBO_XATTR\fR flag was supplied and the underlying file system does not support extended file attributes. @@ -569,36 +526,30 @@ extended file attributes. .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument names a \fBSTREAMS\fR file and a hangup or error occurred during the \fBopen()\fR. .RE .sp .ne 2 -.mk .na \fB\fBEISDIR\fR\fR .ad .RS 16n -.rt The named file is a directory and \fIoflag\fR includes \fBO_WRONLY\fR or \fBO_RDWR\fR. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in resolving \fIpath\fR. .sp A loop exists in symbolic links encountered during resolution of the \fIpath\fR @@ -610,71 +561,59 @@ link. .sp .ne 2 -.mk .na \fB\fBEMFILE\fR\fR .ad .RS 16n -.rt There are currently {\fBOPEN_MAX\fR} file descriptors open in the calling process. .RE .sp .ne 2 -.mk .na \fB\fBEMLINK\fR\fR .ad .RS 16n -.rt The \fBO_NOLINKS\fR flag is set and the named file has a link count greater than 1. .RE .sp .ne 2 -.mk .na \fB\fBEMULTIHOP\fR\fR .ad .RS 16n -.rt Components of \fIpath\fR require hopping to multiple remote machines and the file system does not allow it. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds {\fBPATH_MAX\fR} or a pathname component is longer than {\fBNAME_MAX\fR}. .RE .sp .ne 2 -.mk .na \fB\fBENFILE\fR\fR .ad .RS 16n -.rt The maximum allowable number of files is currently open in the system. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The \fBO_CREAT\fR flag is not set and the named file does not exist; or the \fBO_CREAT\fR flag is set and either the path prefix does not exist or the \fIpath\fR argument points to an empty string. @@ -682,59 +621,49 @@ The \fBO_CREAT\fR flag is not set and the named file does not exist; or the .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine, and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument names a STREAMS-based file and the system is unable to allocate a STREAM. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 16n -.rt The directory or file system that would contain the new file cannot be expanded, the file does not exist, and \fBO_CREAT\fR is specified. .RE .sp .ne 2 -.mk .na \fB\fBENOSYS\fR\fR .ad .RS 16n -.rt The device specified by \fIpath\fR does not support the open operation. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory or a relative path was supplied to \fBopenat()\fR, the \fBO_XATTR\fR flag was not supplied, and the file descriptor does not refer to a directory. @@ -742,12 +671,10 @@ file descriptor does not refer to a directory. .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 16n -.rt The \fBO_NONBLOCK\fR flag is set, the named file is a FIFO, the \fBO_WRONLY\fR flag is set, and no process has the file open for reading; or the named file is a character special or block special file and the device associated with this @@ -757,23 +684,19 @@ framework . .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 16n -.rt An attempt was made to open a path that corresponds to a \fBAF_UNIX\fR socket. .RE .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 16n -.rt The named file is a regular file and either \fBO_LARGEFILE\fR is not set and the size of the file cannot be represented correctly in an object of type \fBoff_t\fR or \fBO_LARGEFILE\fR is set and the size of the file cannot be @@ -782,12 +705,10 @@ represented correctly in an object of type \fBoff64_t\fR. .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The named file resides on a read-only file system and either \fBO_WRONLY\fR, \fBO_RDWR\fR, \fBO_CREAT\fR (if file does not exist), or \fBO_TRUNC\fR is set in the \fIoflag\fR argument. @@ -798,12 +719,10 @@ in the \fIoflag\fR argument. The \fBopenat()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 9n -.rt The \fIfildes\fR argument is not a valid open file descriptor or is not \fBAT_FTCWD\fR. .RE @@ -813,59 +732,49 @@ The \fIfildes\fR argument is not a valid open file descriptor or is not The \fBopen()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument names the slave side of a pseudo-terminal device that is locked. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The value of the \fIoflag\fR argument is not valid. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt Pathname resolution of a symbolic link produced an intermediate result whose length exceeds {\fBPATH_MAX\fR}. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument names a \fBSTREAMS\fR file and the system is unable to allocate resources. .RE .sp .ne 2 -.mk .na \fB\fBETXTBSY\fR\fR .ad .RS 16n -.rt The file is a pure procedure (shared text) file that is being executed and \fIoflag\fR is \fBO_WRONLY\fR or \fBO_RDWR\fR. .RE @@ -914,8 +823,8 @@ file and exits. .nf #include <fcntl.h> #include <stdio.h> -#include <stdlib.h> -#define LOCKFILE "/etc/ptmp" +#include <stdlib.h> +#define LOCKFILE "/etc/ptmp" \&... int pfd; /* Integer for file descriptor returned by open() call. */ \&... @@ -971,17 +880,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -StandardFor \fBopen()\fR, see \fBstandards\fR(5). +Standard For \fBopen()\fR, see \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/p_online.2 b/usr/src/man/man2/p_online.2 index e2a05dc705..4506daa081 100644 --- a/usr/src/man/man2/p_online.2 +++ b/usr/src/man/man2/p_online.2 @@ -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 p_online 2 "11 Jan 2009" "SunOS 5.11" "System Calls" +.TH P_ONLINE 2 "Jan 11, 2009" .SH NAME p_online \- return or change processor operational status .SH SYNOPSIS @@ -101,12 +101,10 @@ state remains unchanged, and \fBerrno\fR is set to indicate the error. The \fBp_online()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 11n -.rt The \fIflag\fR was \fBP_OFFLINE\fR or \fBP_SPARE\fR and the specified processor is the only on-line processor, there are currently \fBLWPs\fR bound to the processor, or the processor performs some essential function that cannot be @@ -122,12 +120,10 @@ platform- specific resource is not available. .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt A non-existent processor \fBID\fR was specified or \fIflag\fR was invalid. .sp The caller is in a non-global zone, the pools facility is active, and the @@ -136,24 +132,20 @@ processor is not a member of the zone's pool's processor set. .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt The specified processor is powered off, and the platform does not support power on of individual processors. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 11n -.rt The flag was not \fBP_STATUS\fR and the {\fBPRIV_SYS_RES_CONFIG\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -197,13 +189,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/pause.2 b/usr/src/man/man2/pause.2 index 6e3c113e54..6a365408fd 100644 --- a/usr/src/man/man2/pause.2 +++ b/usr/src/man/man2/pause.2 @@ -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 pause 2 "28 Dec 1996" "SunOS 5.11" "System Calls" +.TH PAUSE 2 "Dec 28, 1996" .SH NAME pause \- suspend process until signal .SH SYNOPSIS @@ -41,12 +41,10 @@ it returns \fB\(mi1\fR and sets \fBerrno\fR to indicate the error. The \fBpause()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 9n -.rt A signal is caught by the calling process and control is returned from the signal-catching function. .RE @@ -59,15 +57,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/pcsample.2 b/usr/src/man/man2/pcsample.2 index a2f08a6acb..95e06644ce 100644 --- a/usr/src/man/man2/pcsample.2 +++ b/usr/src/man/man2/pcsample.2 @@ -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 pcsample 2 "10 Mar 1998" "SunOS 5.11" "System Calls" +.TH PCSAMPLE 2 "Mar 10, 1998" .SH NAME pcsample \- program execution time profile .SH SYNOPSIS @@ -58,12 +58,10 @@ during the previous invocation. If \fInsamples\fR is invalid, it returns The \fBpcsample()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fInsamples\fR is not valid. .RE @@ -75,15 +73,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -Interface StabilityStable +Interface Stability Stable .TE .SH SEE ALSO diff --git a/usr/src/man/man2/pipe.2 b/usr/src/man/man2/pipe.2 index d8e61d8017..c2e8d94e24 100644 --- a/usr/src/man/man2/pipe.2 +++ b/usr/src/man/man2/pipe.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 2001, the Institute of Electrical and Electronics Engineers, Inc. and The Open Group. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 pipe 2 "23 Apr 2002" "SunOS 5.11" "System Calls" +.TH PIPE 2 "Apr 23, 2002" .SH NAME pipe \- create an interprocess channel .SH SYNOPSIS @@ -50,23 +50,19 @@ returned and \fBerrno\fR is set to indicate the error. The \fBpipe()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEMFILE\fR\fR .ad .RS 10n -.rt More than {\fBOPEN_MAX\fR} file descriptors are already in use by this process. .RE .sp .ne 2 -.mk .na \fB\fBENFILE\fR\fR .ad .RS 10n -.rt The number of simultaneously open files in the system would exceed a system-imposed limit. .RE @@ -79,15 +75,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/poll.2 b/usr/src/man/man2/poll.2 index 20036d28de..f91d8b017d 100644 --- a/usr/src/man/man2/poll.2 +++ b/usr/src/man/man2/poll.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 poll 2 "23 Aug 2001" "SunOS 5.11" "System Calls" +.TH POLL 2 "Aug 23, 2001" .SH NAME poll \- input/output multiplexing .SH SYNOPSIS @@ -50,106 +50,88 @@ The \fBfd\fR member specifies an open file descriptor and the \fBevents\fR and of any combination of the following event flags: .sp .ne 2 -.mk .na \fB\fBPOLLIN\fR\fR .ad .RS 14n -.rt Data other than high priority data may be read without blocking. For streams, this flag is set in \fBrevents\fR even if the message is of zero length. .RE .sp .ne 2 -.mk .na \fB\fBPOLLRDNORM\fR\fR .ad .RS 14n -.rt Normal data (priority band equals 0) may be read without blocking. For streams, this flag is set in \fBrevents\fR even if the message is of zero length. .RE .sp .ne 2 -.mk .na \fB\fBPOLLRDBAND\fR\fR .ad .RS 14n -.rt Data from a non-zero priority band may be read without blocking. For streams, this flag is set in \fBrevents\fR even if the message is of zero length. .RE .sp .ne 2 -.mk .na \fB\fBPOLLPRI\fR\fR .ad .RS 14n -.rt High priority data may be received without blocking. For streams, this flag is set in \fBrevents\fR even if the message is of zero length. .RE .sp .ne 2 -.mk .na \fB\fBPOLLOUT\fR\fR .ad .RS 14n -.rt Normal data (priority band equals 0) may be written without blocking. .RE .sp .ne 2 -.mk .na \fB\fBPOLLWRNORM\fR\fR .ad .RS 14n -.rt The same as \fBPOLLOUT\fR. .RE .sp .ne 2 -.mk .na \fB\fBPOLLWRBAND\fR\fR .ad .RS 14n -.rt Priority data (priority band > 0) may be written. This event only examines bands that have been written to at least once. .RE .sp .ne 2 -.mk .na \fB\fBPOLLERR\fR\fR .ad .RS 14n -.rt An error has occurred on the device or stream. This flag is only valid in the \fBrevents\fR bitmask; it is not used in the \fBevents\fR member. .RE .sp .ne 2 -.mk .na \fB\fBPOLLHUP\fR\fR .ad .RS 14n -.rt A hangup has occurred on the stream. This event and \fBPOLLOUT\fR are mutually exclusive; a stream can never be writable if a hangup has occurred. However, this event and \fBPOLLIN\fR, \fBPOLLRDNORM\fR, \fBPOLLRDBAND\fR, or @@ -159,12 +141,10 @@ this event and \fBPOLLIN\fR, \fBPOLLRDNORM\fR, \fBPOLLRDBAND\fR, or .sp .ne 2 -.mk .na \fB\fBPOLLNVAL\fR\fR .ad .RS 14n -.rt The specified \fBfd\fR value does not belong to an open file. This flag is only valid in the \fBrevents\fR member; it is not used in the \fBevents\fR member. .RE @@ -225,46 +205,38 @@ indicate the error. The \fBpoll()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt Allocation of internal data structures failed, but the request may be attempted again. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt Some argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 10n -.rt A signal was caught during the \fBpoll()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The argument \fInfds\fR is greater than \fB{OPEN_MAX}\fR, or one of the \fBfd\fR members refers to a stream or multiplexer that is linked (directly or indirectly) downstream from a multiplexer. @@ -278,13 +250,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/priocntl.2 b/usr/src/man/man2/priocntl.2 index 603086ff6a..45adfab4d6 100644 --- a/usr/src/man/man2/priocntl.2 +++ b/usr/src/man/man2/priocntl.2 @@ -4,7 +4,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 priocntl 2 "11 May 2006" "SunOS 5.11" "System Calls" +.TH PRIOCNTL 2 "May 11, 2006" .SH NAME priocntl \- process scheduler control .SH SYNOPSIS @@ -60,24 +60,20 @@ of \fIidtype\fR. The possible values for \fIidtype\fR and corresponding interpretations of \fIid\fR are as follows: .sp .ne 2 -.mk .na \fB\fBP_ALL\fR\fR .ad .RS 12n -.rt The \fBpriocntl()\fR function applies to all existing LWPs. The value of \fIid\fR is ignored. The permission restrictions described below still apply. .RE .sp .ne 2 -.mk .na \fB\fBP_CID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a class ID (returned by the \fBpriocntl()\fR \fBPC_GETCID\fR command as explained below). The \fBpriocntl()\fR function applies to all LWPs in the specified class. @@ -85,36 +81,30 @@ applies to all LWPs in the specified class. .sp .ne 2 -.mk .na \fB\fBP_GID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a group ID. The \fBpriocntl()\fR function applies to all LWPs with this effective group ID. .RE .sp .ne 2 -.mk .na \fB\fBP_LWPID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is an LWP ID. The \fIpriocntl\fR function applies to the LWP with the specified ID within the calling process. .RE .sp .ne 2 -.mk .na \fB\fBP_PGID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a process group ID. The \fBpriocntl()\fR function applies to all LWPs currently associated with processes in the specified process group. @@ -122,12 +112,10 @@ process group. .sp .ne 2 -.mk .na \fB\fBP_PID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a process ID specifying a single process. The \fBpriocntl()\fR function applies to all LWPs currently associated with the specified process. @@ -135,12 +123,10 @@ specified process. .sp .ne 2 -.mk .na \fB\fBP_PPID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a parent process ID. The \fBpriocntl()\fR function applies to all LWPs currently associated with processes with the specified parent process ID. @@ -148,72 +134,60 @@ parent process ID. .sp .ne 2 -.mk .na \fB\fBP_PROJID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a project ID. The \fBpriocntl()\fR function applies to all LWPs with this project ID. .RE .sp .ne 2 -.mk .na \fB\fBP_SID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a session ID. The \fBpriocntl()\fR function applies to all LWPs currently associated with processes in the specified session. .RE .sp .ne 2 -.mk .na \fB\fBP_TASKID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a task ID. The \fBpriocntl()\fR function applies to all LWPs currently associated with processes in the specified task. .RE .sp .ne 2 -.mk .na \fB\fBP_UID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a user ID. The \fBpriocntl()\fR function applies to all LWPs with this effective user ID. .RE .sp .ne 2 -.mk .na \fB\fBP_ZONEID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a zone ID. The \fBpriocntl()\fR function applies to all LWPs with this zone ID. .RE .sp .ne 2 -.mk .na \fB\fBP_CTID\fR\fR .ad .RS 12n -.rt The \fIid\fR argument is a process contract ID. The \fBpriocntl()\fR function applies to all LWPs with this process contract ID. .RE @@ -337,12 +311,10 @@ and \fBPC_GETPARMS\fR on a long-term basis. Available \fBpriocntl()\fR commands are: .sp .ne 2 -.mk .na \fB\fBPC_ADMIN\fR\fR .ad .RS 16n -.rt This command provides functionality needed for the implementation of the \fBdispadmin\fR(1M) utility. It is not intended for general use by other applications. @@ -350,12 +322,10 @@ applications. .sp .ne 2 -.mk .na \fB\fBPC_DONICE\fR\fR .ad .RS 16n -.rt Set or get nice value of the specified LWP(s) associated with the specified process(es). When this command is used with the \fIidtype\fR of \fBP_LWPID\fR, it sets the nice value of the LWP. The \fIarg\fR argument points to a structure @@ -379,12 +349,10 @@ set of target LWPs but returns the error immediately. .sp .ne 2 -.mk .na \fB\fBPC_GETCID\fR\fR .ad .RS 16n -.rt Get class ID and class attributes for a specific class given the class name. The \fIidtype\fR and \fIid\fR arguments are ignored. If \fIarg\fR is non-null, it points to a structure of type \fBpcinfo_t\fR. The \fIpc_clname\fR buffer @@ -407,12 +375,10 @@ If \fIarg\fR is a null pointer, no attribute data is returned but the .sp .ne 2 -.mk .na \fB\fBPC_GETCLINFO\fR\fR .ad .RS 16n -.rt Get class name and class attributes for a specific class given class ID. The \fIidtype\fR and \fIid\fR arguments are ignored. If \fIarg\fR is non-null, it points to a structure of type \fBpcinfo_t\fR. The \fIpc_cid\fR member is the @@ -433,12 +399,10 @@ If \fIarg\fR is a null pointer, no attribute data is returned but the .sp .ne 2 -.mk .na \fB\fBPC_GETPARMS\fR\fR .ad .RS 16n -.rt Get the class and/or class-specific scheduling parameters of an LWP. The \fIarg\fR member points to a structure of type \fBpcparms_t\fR. .sp @@ -464,12 +428,10 @@ returned in the \fIpc_clparms\fR buffer. .sp .ne 2 -.mk .na \fB\fBPC_GETXPARMS\fR\fR .ad .RS 16n -.rt Get the class or class-specific scheduling parameters of an LWP. The class name (first argument after \fBPC_GETXPARMS\fR) specifies the class and the (key, value) pair sequence contains a pointer to the class-specific parameters. The @@ -507,12 +469,10 @@ char pc_clname[PC_CLNMSZ]; /* Class name */ .sp .ne 2 -.mk .na \fB\fBPC_SETPARMS\fR\fR .ad .RS 16n -.rt Set the class and class-specific scheduling parameters of the specified LWP(s) associated with the specified process(es). When this command is used with the \fIidtype\fR of P_LWPID, it will set the class and class-specific scheduling @@ -539,12 +499,10 @@ LWPs but returns the error immediately. .sp .ne 2 -.mk .na \fB\fBPC_SETXPARMS\fR\fR .ad .RS 16n -.rt Set the class and class-specific scheduling parameters of the specified LWP(s) associated with the specified process(es). When this command is used with \fBP_LWPID\fR as \fIidtype\fR, it will set the class and class-specific @@ -728,34 +686,28 @@ values defined in \fB<sys/rtpriocntl.h>\fR, in which case the value of \fIrt_tqsecs\fR is ignored: .sp .ne 2 -.mk .na \fB\fBRT_TQINF\fR\fR .ad .RS 15n -.rt Set an infinite time quantum. .RE .sp .ne 2 -.mk .na \fB\fBRT_TQDEF\fR\fR .ad .RS 15n -.rt Set the time quantum to the default for this priority (see \fBrt_dptbl\fR(4)). .RE .sp .ne 2 -.mk .na \fB\fBRT_NOCHANGE\fR\fR .ad .RS 15n -.rt Do not set the time quantum. This value is useful when you wish to change the realtime priority of an LWP without affecting the time quantum. Specifying this value when changing the class of an LWP to realtime from some other class is @@ -774,18 +726,17 @@ same key results in an error return and \fBerrno\fR set to \fBEINVAL\fR. .sp .TS -tab() box; -cw(1.44i) |cw(1.08i) |cw(2.98i) -lw(1.44i) |lw(1.08i) |lw(2.98i) -. -KeyValue TypeDescription +box; +c | c | c +l | l | l . +Key Value Type Description _ -\fBRT_KY_PRI\fR\fBpri_t\fRrealtime priority -\fBRT_KY_TQSECS\fR\fBuint_t\fRseconds in time quantum +\fBRT_KY_PRI\fR \fBpri_t\fR realtime priority +\fBRT_KY_TQSECS\fR \fBuint_t\fR seconds in time quantum _ -\fBRT_KY_TQNSECS\fR\fBint\fRnanoseconds in time quantum +\fBRT_KY_TQNSECS\fR \fBint\fR nanoseconds in time quantum _ -\fBRT_KY_TQSIG\fR\fBint\fRrealtime time quantum signal +\fBRT_KY_TQSIG\fR \fBint\fR realtime time quantum signal .TE .sp @@ -964,14 +915,13 @@ specification of the same key results in an error return and \fBerrno\fR set to .sp .TS -tab() box; -cw(1.44i) |cw(1.08i) |cw(2.98i) -lw(1.44i) |lw(1.08i) |lw(2.98i) -. -KeyValue TypeDescription +box; +c | c | c +l | l | l . +Key Value Type Description _ -\fBTS_KY_UPRILIM\fR\fBpri_t\fRuser priority limit -\fBTS_KY_UPRI\fR\fBpri_t\fRuser priority +\fBTS_KY_UPRILIM\fR \fBpri_t\fR user priority limit +\fBTS_KY_UPRI\fR \fBpri_t\fR user priority .TE .sp @@ -1078,14 +1028,12 @@ results in an error return and \fBerrno\fR set to \fBEINVAL\fR. .sp .TS -tab(); -cw(1.83i) cw(1.83i) cw(1.83i) -lw(1.83i) lw(1.83i) lw(1.83i) -. -KeyValue TypeDescription -\fBIA_KY_UPRILIM\fR\fBpri_t\fRuser priority limit -\fBIA_KY_UPRI\fR\fBpri_t\fRuser priority -\fBIA_KY_MODE\fR\fBint\fRinteractive mode +c c c +l l l . +Key Value Type Description +\fBIA_KY_UPRILIM\fR \fBpri_t\fR user priority limit +\fBIA_KY_UPRI\fR \fBpri_t\fR user priority +\fBIA_KY_MODE\fR \fBint\fR interactive mode .TE .sp @@ -1372,34 +1320,28 @@ values (defined in \fB<sys/fxpriocntl.h>\fR), in which case the value of \fIfx_tqsecs\fR is ignored: .sp .ne 2 -.mk .na \fB\fBFX_TQINF\fR\fR .ad .RS 15n -.rt Set an infinite time quantum. .RE .sp .ne 2 -.mk .na \fB\fBFX_TQDEF\fR\fR .ad .RS 15n -.rt Set the time quantum to the default for this priority (see \fBfx_dptbl\fR(4)). .RE .sp .ne 2 -.mk .na \fB\fBFX_NOCHANGE\fR\fR .ad .RS 15n -.rt Do not set the time quantum. This value is useful in changing the user priority of an LWP without affecting the time quantum. Specifying this value when changing the class of an LWP to fixed-priority from some other class is @@ -1418,18 +1360,17 @@ same key results in an error return and \fBerrno\fR set to \fBEINVAL\fR. .sp .TS -tab() box; -cw(1.44i) |cw(1.08i) |cw(2.98i) -lw(1.44i) |lw(1.08i) |lw(2.98i) -. -KeyValue TypeDescription +box; +c | c | c +l | l | l . +Key Value Type Description _ -\fBFX_KY_UPRILIM\fR\fBpri_t\fRuser priority limit -\fBFX_KY_UPRI\fR\fBpri_t\fRuser priority +\fBFX_KY_UPRILIM\fR \fBpri_t\fR user priority limit +\fBFX_KY_UPRI\fR \fBpri_t\fR user priority _ -\fBFX_KY_TQSECS\fR\fBuint_t\fRseconds in time quantum +\fBFX_KY_TQSECS\fR \fBuint_t\fR seconds in time quantum _ -\fBFX_KY_TQNSECS\fR\fBint\fRnanoseconds in time quantum +\fBFX_KY_TQNSECS\fR \fBint\fR nanoseconds in time quantum .TE .sp @@ -1485,12 +1426,10 @@ the error. The \fBpriocntl()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt An attempt to change the class of an LWP failed because of insufficient resources other than memory (for example, class-specific kernel data structures). @@ -1498,46 +1437,38 @@ structures). .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt One of the arguments points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The argument \fIcmd\fR was invalid, an invalid or unconfigured class was specified, or one of the parameters specified was invalid. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt An attempt to change the class of an LWP failed because of insufficient memory. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_PROC_PRIOCNTL\fR} privilege is not asserted in the effective set of the calling LWP. .sp @@ -1546,23 +1477,19 @@ The calling LWP does not have sufficient privileges to affect the target LWP. .sp .ne 2 -.mk .na \fB\fBERANGE\fR\fR .ad .RS 10n -.rt The requested time quantum is out of range. .RE .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 10n -.rt None of the specified LWPs exist. .RE diff --git a/usr/src/man/man2/priocntlset.2 b/usr/src/man/man2/priocntlset.2 index 693ee6fdf1..ab4c7bce2e 100644 --- a/usr/src/man/man2/priocntlset.2 +++ b/usr/src/man/man2/priocntlset.2 @@ -4,7 +4,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 priocntlset 2 "1 Apr 2008" "SunOS 5.11" "System Calls" +.TH PRIOCNTLSET 2 "Apr 1, 2008" .SH NAME priocntlset \- generalized process scheduler control .SH SYNOPSIS @@ -62,45 +62,37 @@ is to apply to. The valid values for \fBp_op\fR and the processes they specify are: .sp .ne 2 -.mk .na \fB\fBPOP_DIFF\fR\fR .ad .RS 12n -.rt Set difference: processes in left set and not in right set. .RE .sp .ne 2 -.mk .na \fB\fBPOP_AND\fR\fR .ad .RS 12n -.rt Set intersection: processes in both left and right sets. .RE .sp .ne 2 -.mk .na \fB\fBPOP_OR\fR\fR .ad .RS 12n -.rt Set union: processes in either left or right sets or both. .RE .sp .ne 2 -.mk .na \fB\fBPOP_XOR\fR\fR .ad .RS 12n -.rt Set exclusive-or: processes in left or right set but not in both. .RE @@ -131,12 +123,10 @@ Otherwise, it returns \fB\(mi1\fR and sets \fBerrno\fR to indicate the error. The \fBpriocntlset()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt An attempt to change the class of a process failed because of insufficient resources other than memory (for example, class-specific kernel data structures). @@ -144,47 +134,39 @@ structures). .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt One of the arguments points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The argument \fIcmd\fR was invalid, an invalid or unconfigured class was specified, or one of the parameters specified was invalid. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt An attempt to change the class of a process failed because of insufficient memory. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_PROC_PRIOCNTL\fR} privilege is not asserted in the effective set of the calling LWP. .sp @@ -193,23 +175,19 @@ The calling LWP does not have sufficient privileges to affect the target LWP. .sp .ne 2 -.mk .na \fB\fBERANGE\fR\fR .ad .RS 10n -.rt The requested time quantum is out of range. .RE .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 10n -.rt None of the specified processes exist. .RE diff --git a/usr/src/man/man2/processor_bind.2 b/usr/src/man/man2/processor_bind.2 index 6e342e89fe..1a767db550 100644 --- a/usr/src/man/man2/processor_bind.2 +++ b/usr/src/man/man2/processor_bind.2 @@ -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 processor_bind 2 "13 Mar 2009" "SunOS 5.11" "System Calls" +.TH PROCESSOR_BIND 2 "Mar 13, 2009" .SH NAME processor_bind \- bind LWPs to a processor .SH SYNOPSIS @@ -84,24 +84,20 @@ returned and \fBerrno\fR is set to indicate the error. The \fBprocessor_bind()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n -.rt The location pointed to by \fIobind\fR was not \fINULL\fR and not writable by the user. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The specified processor is not on-line, or the \fIidtype\fR argument was not \fBP_PID\fR, \fBP_LWPID\fR, \fBP_PROJID\fR, \fBP_TASKID\fR, \fBP_CTID\fR, or \fBP_ZONEID\fR. @@ -112,23 +108,19 @@ processor is not a member of the zone's pool's processor set. .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt Binding a system process to a processor set is not supported. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 11n -.rt The {\fBPRIV_PROC_OWNER\fR} privilege is not asserted in the effective set of the calling process and its real or effective user ID does not match the real or effective user \fBID\fR of one of the \fBLWP\fRs being bound. @@ -136,12 +128,10 @@ or effective user \fBID\fR of one of the \fBLWP\fRs being bound. .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 11n -.rt No processes, \fBLWP\fRs, or tasks were found to match the criteria specified by \fIidtype\fR and \fIid\fR. .RE @@ -154,15 +144,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/processor_info.2 b/usr/src/man/man2/processor_info.2 index 05dd2138b8..75ad40a7b6 100644 --- a/usr/src/man/man2/processor_info.2 +++ b/usr/src/man/man2/processor_info.2 @@ -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 processor_info 2 "28 Jun 2004" "SunOS 5.11" "System Calls" +.TH PROCESSOR_INFO 2 "Jun 28, 2004" .SH NAME processor_info \- determine type and status of a processor .SH SYNOPSIS @@ -63,12 +63,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBprocessor_info()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt An non-existent processor \fBID\fR was specified. .sp The caller is in a non-global zone, the pools facility is active, and the @@ -77,12 +75,10 @@ processor is not a member of the zone's pool's processor set. .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fBprocessor_info_t\fR structure pointed to by \fIinfop\fR was not writable by the user. .RE diff --git a/usr/src/man/man2/profil.2 b/usr/src/man/man2/profil.2 index c3eeab0e2e..ed6b076c3c 100644 --- a/usr/src/man/man2/profil.2 +++ b/usr/src/man/man2/profil.2 @@ -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 profil 2 "12 Nov 2001" "SunOS 5.11" "System Calls" +.TH PROFIL 2 "Nov 12, 2001" .SH NAME profil \- execution time profile .SH SYNOPSIS diff --git a/usr/src/man/man2/pset_bind.2 b/usr/src/man/man2/pset_bind.2 index 91d5520b90..2162ecd7b9 100644 --- a/usr/src/man/man2/pset_bind.2 +++ b/usr/src/man/man2/pset_bind.2 @@ -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 pset_bind 2 "13 Mar 2009" "SunOS 5.11" "System Calls" +.TH PSET_BIND 2 "Mar 13, 2009" .SH NAME pset_bind \- bind LWPs to a set of processors .SH SYNOPSIS @@ -87,36 +87,30 @@ Upon successful completion, 0 is returned. Otherwise, \(mi1 is returned and The \fBpset_bind()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 11n -.rt One of the \fBLWP\fRs is bound to a processor, and the specified processor set does not include that processor. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n -.rt The location pointed to by \fIopset\fR was not \fINULL\fR and not writable by the user. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt An invalid processor set \fBID\fR was specified; or \fIidtype\fR was not \fBP_PID\fR, \fBP_LWPID\fR, \fBP_PROJID\fR, \fBP_TASKID\fR, \fBP_ZONEID\fR, or \fBP_CTID\fR. @@ -124,12 +118,10 @@ An invalid processor set \fBID\fR was specified; or \fIidtype\fR was not .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt The pools facility is active. See \fBpooladm\fR(1M) and \fBpool_set_status\fR(3POOL) for information about enabling and disabling the pools facility. Processes can be bound to pools using the \fBpoolbind\fR(1M) @@ -140,12 +132,10 @@ Binding a system process to a processor set is not supported. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 11n -.rt The {\fBPRIV_PROC_OWNER\fR} is not asserted in the effecive set of the calling process and either the real or effective user ID of the calling process does not match the real or effective user \fBID\fR of one of the LWPs being bound, @@ -157,12 +147,10 @@ for more information about processor set attributes. .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 11n -.rt No processes, \fBLWP\fRs, or tasks were found to match the criteria specified by \fIidtype\fR and \fIid\fR. .RE @@ -175,15 +163,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/pset_create.2 b/usr/src/man/man2/pset_create.2 index c53983fbb3..fe62db84c1 100644 --- a/usr/src/man/man2/pset_create.2 +++ b/usr/src/man/man2/pset_create.2 @@ -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 pset_create 2 "22 Feb 2008" "SunOS 5.11" "System Calls" +.TH PSET_CREATE 2 "Feb 22, 2008" .SH NAME pset_create, pset_destroy, pset_assign \- manage sets of processors .SH SYNOPSIS @@ -81,23 +81,19 @@ Upon successful completion, these functions return \fB0\fR. Otherwise, These functions will fail if: .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 11n -.rt The processor could not be moved to the specified processor set. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n -.rt The location pointed to by \fInewpset\fR was not writable by the user, or the location pointed to by \fIopset\fR was not \fINULL\fR and not writable by the user. @@ -105,36 +101,30 @@ user. .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The specified processor does not exist, the specified processor is not on-line, or an invalid processor set was specified. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n -.rt There was insufficient space for \fBpset_create\fR to create a new processor set. .RE .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt The pools facility is active. See \fBpooladm\fR(1M) and \fBpool_set_status\fR(3POOL) for information about enabling and disabling the pools facility. @@ -142,12 +132,10 @@ pools facility. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 11n -.rt The {\fBPRIV_SYS_RES_CONFIG\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -160,15 +148,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/pset_info.2 b/usr/src/man/man2/pset_info.2 index efc4e38375..20ab0a048a 100644 --- a/usr/src/man/man2/pset_info.2 +++ b/usr/src/man/man2/pset_info.2 @@ -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 pset_info 2 "28 Jun 2004" "SunOS 5.11" "System Calls" +.TH PSET_INFO 2 "Jun 28, 2004" .SH NAME pset_info \- get information about a processor set .SH SYNOPSIS @@ -61,24 +61,20 @@ returned and \fBerrno\fR is set to indicate the error. The \fBpset_info()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The location pointed to by \fItype\fR, \fInumcpus\fR, or \fIcpulist\fR was not null and not writable by the user. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt An invalid processor set \fBID\fR was specified. .sp The caller is in a non-global zone, the pools facility is active, and the @@ -93,15 +89,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStable +Interface Stability Stable _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/pset_list.2 b/usr/src/man/man2/pset_list.2 index 4691828d27..cf45101329 100644 --- a/usr/src/man/man2/pset_list.2 +++ b/usr/src/man/man2/pset_list.2 @@ -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 pset_list 2 "28 Jun 2004" "SunOS 5.11" "System Calls" +.TH PSET_LIST 2 "Jun 28, 2004" .SH NAME pset_list \- get list of processor sets .SH SYNOPSIS @@ -42,12 +42,10 @@ Upon successful completion, 0 is returned. Otherwise, -1 is returned and The \fBpset_list()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The location pointed to by \fIpsetlist\fR or \fInumpsets\fR was not null and not writable by the user. .RE @@ -66,15 +64,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStable +Interface Stability Stable _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/pset_setattr.2 b/usr/src/man/man2/pset_setattr.2 index 05d97cd13e..6010fe2493 100644 --- a/usr/src/man/man2/pset_setattr.2 +++ b/usr/src/man/man2/pset_setattr.2 @@ -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 pset_setattr 2 "28 Jun 2004" "SunOS 5.11" "System Calls" +.TH PSET_SETATTR 2 "Jun 28, 2004" .SH NAME pset_setattr, pset_getattr \- set or get processor set attributes .SH SYNOPSIS @@ -36,12 +36,10 @@ The value of the \fIattr\fR argument is the bitwise inclusive-OR of these attributes, defined in <\fBsys/pset.h\fR>: .sp .ne 2 -.mk .na \fB\fBPSET_NOESCAPE\fR\fR .ad .RS 17n -.rt Unbinding of LWPs from the processor set with this attribute requires the {\fBPRIV_SYS_RES_CONFIG\fR} privilege to be asserted in the effective set of the calling process. @@ -67,23 +65,19 @@ and \fBerrno\fR is set to indicate the error. These function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n -.rt The location pointed to by \fIattr\fR was not writable by the user. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt An invalid processor set ID was specified. .sp The caller is in a non-global zone, the pools facility is active, and the @@ -92,12 +86,10 @@ processor is not a member of the zone's pool's processor set. .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt The pools facility is active. See \fBpooladm\fR(1M) and \fBpool_set_status\fR(3POOL) for information about enabling and disabling the pools facility. @@ -111,15 +103,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStable +Interface Stability Stable _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/putmsg.2 b/usr/src/man/man2/putmsg.2 index bf155211fb..85d98f8b8f 100644 --- a/usr/src/man/man2/putmsg.2 +++ b/usr/src/man/man2/putmsg.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 putmsg 2 "1 Nov 2003" "SunOS 5.11" "System Calls" +.TH PUTMSG 2 "Nov 1, 2003" .SH NAME putmsg, putpmsg \- send a message on a stream .SH SYNOPSIS @@ -121,12 +121,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBputmsg()\fR and \fBputpmsg()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 16n -.rt A non-priority message was specified, the \fBO_NDELAY\fR or \fBO_NONBLOCK\fR flag is set and the stream write queue is full due to internal flow control conditions. @@ -134,45 +132,37 @@ conditions. .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 16n -.rt The \fIfildes\fR argument is not a valid file descriptor open for writing. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIctlptr\fR or \fIdataptr\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fBputmsg()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt An undefined value was specified in \fIflags\fR; \fIflags\fR is set to \fBRS_HIPRI\fR and no control part was supplied; or the stream referenced by \fIfildes\fR is linked below a multiplexor. @@ -180,47 +170,39 @@ An undefined value was specified in \fIflags\fR; \fIflags\fR is set to .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 16n -.rt Buffers could not be allocated for the message that was to be created due to insufficient streams memory resources. .RE .sp .ne 2 -.mk .na \fB\fBENOSTR\fR\fR .ad .RS 16n -.rt The \fIfildes\fR argument is not associated with a stream. .RE .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 16n -.rt A hangup condition was generated downstream for the specified stream, or the other end of the pipe is closed. .RE .sp .ne 2 -.mk .na \fB\fBEPIPE\fR or \fBEIO\fR\fR .ad .RS 16n -.rt The \fIfildes\fR argument refers to a streams-based pipe and the other end of the pipe is closed. A \fBSIGPIPE\fR signal is generated for the calling thread. This error condition occurs only with SUS-conforming applications. See @@ -229,12 +211,10 @@ thread. This error condition occurs only with SUS-conforming applications. See .sp .ne 2 -.mk .na \fB\fBERANGE\fR\fR .ad .RS 16n -.rt The size of the data part of the message does not fall within the range specified by the maximum and minimum packet sizes of the topmost stream module. This value is also returned if the control part of the message is larger than @@ -254,12 +234,10 @@ but reflects the prior error. The \fBputpmsg()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIflags\fR argument is set to \fBMSG_HIPRI\fR and \fIband\fR is non-zero. .RE @@ -271,13 +249,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/read.2 b/usr/src/man/man2/read.2 index b1716f5916..71e0211dd2 100644 --- a/usr/src/man/man2/read.2 +++ b/usr/src/man/man2/read.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 read 2 "13 Sep 2007" "SunOS 5.11" "System Calls" +.TH READ 2 "Sep 13, 2007" .SH NAME read, readv, pread \- read from file .SH SYNOPSIS @@ -295,12 +295,10 @@ the functions return \fB\(mi1\fR and set \fBerrno\fR to indicate the error. The \fBread()\fR, \fBreadv()\fR, and \fBpread()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 11n -.rt Mandatory file/record locking was set, \fBO_NDELAY\fR or \fBO_NONBLOCK\fR was set, and there was a blocking record lock; total amount of system memory available when reading using raw I/O is temporarily insufficient; no data is @@ -311,67 +309,55 @@ was set; or no message is waiting to be read on a stream and \fBO_NDELAY\fR or .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is not a valid file descriptor open for reading. .RE .sp .ne 2 -.mk .na \fB\fBEBADMSG\fR\fR .ad .RS 11n -.rt Message waiting to be read on a stream is not a data message. .RE .sp .ne 2 -.mk .na \fB\fBEDEADLK\fR\fR .ad .RS 11n -.rt The read was going to go to sleep and cause a deadlock to occur. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 11n -.rt A signal was caught during the read operation and no data was transferred. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt An attempt was made to read from a stream linked to a multiplexor. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 11n -.rt A physical I/O error has occurred, or the process is in a background process group and is attempting to read from its controlling terminal, and either the process is ignoring or blocking the \fBSIGTTIN\fR signal or the process group @@ -380,48 +366,40 @@ of the process is orphaned. .sp .ne 2 -.mk .na \fB\fBEISDIR\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument refers to a directory on a file system type that does not support read operations on directories. .RE .sp .ne 2 -.mk .na \fB\fBENOLCK\fR\fR .ad .RS 11n -.rt The system record lock table was full, so the \fBread()\fR or \fBreadv()\fR could not go to sleep until the blocking record lock was removed. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is on a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 11n -.rt The device associated with \fIfildes\fR is a block special or character special file and the value of the file pointer is out of range. .RE @@ -431,23 +409,19 @@ file and the value of the file pointer is out of range. The \fBread()\fR and \fBpread()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fInbyte\fR argument overflowed an \fBssize_t\fR. .RE @@ -456,12 +430,10 @@ The \fInbyte\fR argument overflowed an \fBssize_t\fR. The \fBread()\fR and \fBreadv()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The file is a regular file, \fInbyte\fR is greater than 0, the starting position is before the end-of-file, and the starting position is greater than or equal to the offset maximum established in the open file description @@ -473,23 +445,19 @@ associated with \fIfildes\fR. The \fBreadv()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIiov\fR argument points outside the allocated address space. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIiovcnt\fR argument was less than or equal to \fB0\fR or greater than {\fBIOV_MAX\fR}. See \fBIntro\fR(2) for a definition of {\fBIOV_MAX\fR}). .sp @@ -502,12 +470,10 @@ of the \fBiov_len\fR values in the \fIiov\fR array overflowed an \fBssize_t\fR. The \fBpread()\fR function will fail and the file pointer remain unchanged if: .sp .ne 2 -.mk .na \fB\fBESPIPE\fR\fR .ad .RS 10n -.rt The \fIfildes\fR argument is associated with a pipe or FIFO. .RE @@ -524,17 +490,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-Level\fBread()\fR is Async-Signal-Safe +MT-Level \fBread()\fR is Async-Signal-Safe _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/readlink.2 b/usr/src/man/man2/readlink.2 index 1831fcaa1b..1cc3d38181 100644 --- a/usr/src/man/man2/readlink.2 +++ b/usr/src/man/man2/readlink.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 readlink 2 "1 Dec 2003" "SunOS 5.11" "System Calls" +.TH READLINK 2 "Dec 1, 2003" .SH NAME readlink \- read the contents of a symbolic link .SH SYNOPSIS @@ -40,103 +40,85 @@ unchanged, and sets \fBerrno\fR to indicate the error. The \fBreadlink()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a component of the path prefix of \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt \fIpath\fR or \fIbuf\fR points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument names a file that is not a symbolic link. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while reading from the file system. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of \fIpath\fR does not name an existing file or \fIpath\fR is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt A loop exists in symbolic links encountered during resolution of the \fIpath\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of \fIpath\fR exceeds {\fBPATH_MAX\fR}, or a pathname component is longer than {\fBNAME_MAX\fR} while \fB_POSIX_NO_TRUNC\fR is in effect. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBENOSYS\fR\fR .ad .RS 16n -.rt The file system does not support symbolic links. .RE @@ -145,35 +127,29 @@ The file system does not support symbolic links. The \fBreadlink()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Read permission is denied for the directory. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt More than {\fBSYMLOOP_MAX\fR} symbolic links were encountered in resolving \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt As a result of encountering a symbolic link in resolution of the path argument, the length of the substituted pathname string exceeded {\fBPATH_MAX\fR}. .RE @@ -191,15 +167,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/rename.2 b/usr/src/man/man2/rename.2 index afb97fc037..6780e534da 100644 --- a/usr/src/man/man2/rename.2 +++ b/usr/src/man/man2/rename.2 @@ -4,7 +4,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 rename 2 "4 Oct 2007" "SunOS 5.11" "System Calls" +.TH RENAME 2 "Oct 4, 2007" .SH NAME rename, renameat \- change the name of a file .SH SYNOPSIS @@ -165,12 +165,10 @@ returned and \fBerrno\fR is set to indicate an error. The \fBrename()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt A component of either path prefix denies search permission; one of the directories containing \fIold\fR and \fInew\fR denies write permissions; or write permission is denied by a directory pointed to by \fIold\fR or \fInew\fR. @@ -178,71 +176,59 @@ write permission is denied by a directory pointed to by \fIold\fR or \fInew\fR. .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 16n -.rt The \fInew\fR argument is a directory and the mount point for a mounted file system. .RE .sp .ne 2 -.mk .na \fB\fBEDQUOT\fR\fR .ad .RS 16n -.rt The directory where the new name entry is being placed cannot be extended because the user's quota of disk blocks on that file system has been exhausted. .RE .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 16n -.rt The link named by \fInew\fR is a directory containing entries other than `\fB\&.\fR' (the directory itself) and `\fB\&..\fR' (the parent directory). .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt Either \fIold\fR or \fInew\fR references an invalid address. .RE .sp .ne 2 -.mk .na \fB\fBEILSEQ\fR\fR .ad .RS 16n -.rt The path argument includes non-UTF8 characters and the file system accepts only file names where all characters are part of the UTF-8 character codeset. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The \fInew\fR argument directory pathname contains a path prefix that names the \fIold\fR directory, or an attempt was made to rename a regular file to an extended attribute or from an extended attribute to a regular file. @@ -250,46 +236,38 @@ extended attribute or from an extended attribute to a regular file. .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while making or updating a directory entry. .RE .sp .ne 2 -.mk .na \fB\fBEISDIR\fR\fR .ad .RS 16n -.rt The \fInew\fR argument points to a directory but \fIold\fR points to a file that is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating the pathname. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of \fIold\fR or \fInew\fR exceeds \fBPATH_MAX\fR, or a pathname component is longer than \fBNAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -297,24 +275,20 @@ effect. .sp .ne 2 -.mk .na \fB\fBEMLINK\fR\fR .ad .RS 16n -.rt The file named by \fIold\fR is a directory, and the link count of the parent directory of \fInew\fR would exceed \fBLINK_MAX\fR. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The link named by \fIold\fR does not name an existing file, a component of the path prefix of \fInew\fR does not exist, or either \fIold\fR or \fInew\fR points to an empty string. @@ -322,23 +296,19 @@ points to an empty string. .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 16n -.rt The directory that would contain \fInew\fR cannot be extended. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of either path prefix is not a directory, or \fIold\fR names a directory and \fInew\fR names a file that is not a directory, or \fItofd\fR and \fIdirfd\fR in \fBrenameat()\fR do not reference a directory. @@ -346,24 +316,20 @@ directory and \fInew\fR names a file that is not a directory, or \fItofd\fR and .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The requested operation requires writing in a directory on a read-only file system. .RE .sp .ne 2 -.mk .na \fB\fBEXDEV\fR\fR .ad .RS 16n -.rt The links named by \fIold\fR and \fInew\fR are on different file systems. .RE @@ -372,12 +338,10 @@ The links named by \fIold\fR and \fInew\fR are on different file systems. The \fBrenameat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt An attempt was made to rename a regular file as an attribute file or to rename an attribute file as a regular file. .RE @@ -390,17 +354,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -StandardFor \fBrename()\fR, see \fBstandards\fR(5). +Standard For \fBrename()\fR, see \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/resolvepath.2 b/usr/src/man/man2/resolvepath.2 index aedc4a86a6..76da1bd1fc 100644 --- a/usr/src/man/man2/resolvepath.2 +++ b/usr/src/man/man2/resolvepath.2 @@ -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 resolvepath 2 "12 May 1997" "SunOS 5.11" "System Calls" +.TH RESOLVEPATH 2 "May 12, 1997" .SH NAME resolvepath \- resolve all symbolic links of a path name .SH SYNOPSIS @@ -39,46 +39,38 @@ unchanged, and sets \fBerrno\fR to indicate the error. The \fBresolvepath()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a component of the path prefix of \fIpath\fR or for a path prefix component resulting from the resolution of a symbolic link. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR or \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while reading from the file system. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument is an empty string or a component of \fIpath\fR or a path name component produced by resolving a symbolic link does not name an existing file. @@ -86,23 +78,19 @@ existing file. .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in resolving \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of \fIpath\fR exceeds \fIPATH_MAX\fR, or a path name component is longer than \fINAME_MAX\fR. Path name resolution of a symbolic link produced an intermediate result whose length exceeds \fIPATH_MAX\fR or a component whose @@ -111,12 +99,10 @@ length exceeds \fINAME_MAX\fR. .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix of \fIpath\fR or of a path prefix component resulting from the resolution of a symbolic link is not a directory. .RE diff --git a/usr/src/man/man2/rmdir.2 b/usr/src/man/man2/rmdir.2 index 7ad069f3ac..e861fcfa40 100644 --- a/usr/src/man/man2/rmdir.2 +++ b/usr/src/man/man2/rmdir.2 @@ -4,7 +4,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 rmdir 2 "18 May 2007" "SunOS 5.11" "System Calls" +.TH RMDIR 2 "May 18, 2007" .SH NAME rmdir \- remove a directory .SH SYNOPSIS @@ -46,12 +46,10 @@ not changed. The \fBrmdir()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a component of the path prefix and {\fBPRIV_FILE_DAC_SEARCH\fR} is not asserted in the effective set of the calling process @@ -67,92 +65,76 @@ The directory is not owned by the user and is not writable by the user. .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 16n -.rt The directory to be removed is the mount point for a mounted file system. .RE .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 16n -.rt The directory contains entries other than those for "\fB\&.\fR" and "\fB\&..\fR". .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The directory to be removed is the current directory, or the final component of \fIpath\fR is "\fB\&.\fR". .RE .sp .ne 2 -.mk .na \fB\fBEILSEQ\fR\fR .ad .RS 16n -.rt The path argument includes non-UTF8 characters and the file system accepts only file names where all characters are part of the UTF-8 character codeset. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while accessing the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds \fBPATH_MAX\fR, or the length of a \fIpath\fR component exceeds \fINAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -160,46 +142,38 @@ effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The named directory does not exist or is the null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine, and the connection to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The directory entry to be removed is part of a read-only file system. .RE @@ -211,15 +185,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/semctl.2 b/usr/src/man/man2/semctl.2 index 787ef05dc2..86ce78b2c6 100644 --- a/usr/src/man/man2/semctl.2 +++ b/usr/src/man/man2/semctl.2 @@ -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 semctl 2 "1 Feb 2003" "SunOS 5.11" "System Calls" +.TH SEMCTL 2 "Feb 1, 2003" .SH NAME semctl \- semaphore control operations .SH SYNOPSIS @@ -59,23 +59,19 @@ semaphore operations as specified by \fIcmd\fR are executed with respect to the semaphore specified by \fIsemid\fR and \fIsemnum\fR. .sp .ne 2 -.mk .na \fB\fBGETVAL\fR\fR .ad .RS 11n -.rt Return the value of semval (see \fBIntro\fR(2)). {READ} .RE .sp .ne 2 -.mk .na \fB\fBSETVAL\fR\fR .ad .RS 11n -.rt Set the value of \fBsemval\fR to \fIarg.\fR\fIval\fR. {ALTER} When this command is successfully executed, the \fBsemadj\fR value corresponding to the specified semaphore in all processes is cleared. @@ -83,34 +79,28 @@ specified semaphore in all processes is cleared. .sp .ne 2 -.mk .na \fB\fBGETPID\fR\fR .ad .RS 11n -.rt Return the value of \fB(int) sempid\fR. {READ} .RE .sp .ne 2 -.mk .na \fB\fBGETNCNT\fR\fR .ad .RS 11n -.rt Return the value of \fBsemncnt\fR. {READ} .RE .sp .ne 2 -.mk .na \fB\fBGETZCNT\fR\fR .ad .RS 11n -.rt Return the value of \fBsemzcnt\fR. {READ} .RE @@ -120,23 +110,19 @@ The following operations return and set, respectively, every \fBsemval\fR in the set of semaphores. .sp .ne 2 -.mk .na \fB\fBGETALL\fR\fR .ad .RS 10n -.rt Place \fBsemval\fRs into array pointed to by \fIarg.\fR\fBarray\fR. {READ} .RE .sp .ne 2 -.mk .na \fB\fBSETALL\fR\fR .ad .RS 10n -.rt Set \fBsemval\fRs according to the array pointed to by \fIarg.\fR\fBarray\fR. {ALTER}. When this cmd is successfully executed, the \fBsemadj\fR values corresponding to each specified semaphore in all processes are cleared. @@ -147,12 +133,10 @@ corresponding to each specified semaphore in all processes are cleared. The following operations are also available. .sp .ne 2 -.mk .na \fB\fBIPC_STAT\fR\fR .ad .RS 12n -.rt Place the current value of each member of the data structure associated with \fIsemid\fR into the structure pointed to by \fIarg.\fR\fBbuf\fR. The contents of this structure are defined in \fBIntro\fR(2). {READ} @@ -160,12 +144,10 @@ of this structure are defined in \fBIntro\fR(2). {READ} .sp .ne 2 -.mk .na \fB\fBIPC_SET\fR\fR .ad .RS 12n -.rt Set the value of the following members of the data structure associated with \fIsemid\fR to the corresponding value found in the structure pointed to by \fIarg\fR.\fBbuf\fR: @@ -187,12 +169,10 @@ associated with \fImsqid\fR. Only a process with the .sp .ne 2 -.mk .na \fB\fBIPC_RMID\fR\fR .ad .RS 12n -.rt Remove the semaphore identifier specified by \fIsemid\fR from the system and destroy the set of semaphores and data structure associated with it. This command can be executed only by a process that has the {\fBPRIV_IPC_OWNER\fR} @@ -207,45 +187,37 @@ privilege or an effective user \fBID\fR equal to the value of Upon successful completion, the value returned depends on \fIcmd\fR as follows: .sp .ne 2 -.mk .na \fB\fBGETVAL\fR\fR .ad .RS 11n -.rt the value of \fBsemval\fR .RE .sp .ne 2 -.mk .na \fB\fBGETPID\fR\fR .ad .RS 11n -.rt the value of \fB(int) sempid\fR .RE .sp .ne 2 -.mk .na \fB\fBGETNCNT\fR\fR .ad .RS 11n -.rt the value of \fBsemncnt\fR .RE .sp .ne 2 -.mk .na \fB\fBGETZCNT\fR\fR .ad .RS 11n -.rt the value of \fBsemzcnt\fR .RE @@ -259,34 +231,28 @@ returned and \fBerrno\fR is set to indicate the error. The \fBsemctl()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 13n -.rt Operation permission is denied to the calling process (see \fBIntro\fR(2)). .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 13n -.rt The source or target is not a valid address in the user process. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 13n -.rt The \fIsemid\fR argument is not a valid semaphore identifier; the \fIsemnum\fR argument is less than 0 or greater than \fBsem_nsems\fR \(mi1; or the \fIcmd\fR argument is not a valid command or is \fBIPC_SET\fR and \fBsem_perm.uid\fR or @@ -295,12 +261,10 @@ argument is not a valid command or is \fBIPC_SET\fR and \fBsem_perm.uid\fR or .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is equal to \fBIPC_RMID\fR or \fBIPC_SET\fR, the effective user ID of the calling process is not equal to the value of \fBsem_perm.cuid\fR or \fBsem_perm.uid\fR in the data structure associated with @@ -310,24 +274,20 @@ the calling process. .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBIPC_STAT\fR and \fIuid\fR or \fIgid\fR is too large to be stored in the structure pointed to by \fIarg.buf\fR. .RE .sp .ne 2 -.mk .na \fB\fBERANGE\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBSETVAL\fR or \fBSETALL\fR and the value to which \fBsemval\fR is to be set is greater than the system imposed maximum. .RE @@ -340,13 +300,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/semget.2 b/usr/src/man/man2/semget.2 index 0ff9d8581a..73d35256bd 100644 --- a/usr/src/man/man2/semget.2 +++ b/usr/src/man/man2/semget.2 @@ -4,7 +4,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 semget 2 "14 Aug 2006" "SunOS 5.11" "System Calls" +.TH SEMGET 2 "Aug 14, 2006" .SH NAME semget \- get set of semaphores .SH SYNOPSIS @@ -84,12 +84,10 @@ set to indicate the error. The \fBsemget()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt A semaphore identifier exists for \fIkey\fR, but operation permission (see \fBIntro\fR(2)) as specified by the low-order 9 bits of \fIsemflg\fR would not be granted. @@ -97,24 +95,20 @@ be granted. .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 10n -.rt A semaphore identifier exists for \fIkey\fR but both (\fIsemflg\fR\fB&IPC_CREAT\fR) and (\fIsemflg\fR\fB&IPC_EXCL\fR) are both true. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fInsems\fR argument is either less than or equal to 0 or greater than the system-imposed limit. See NOTES. .sp @@ -125,24 +119,20 @@ equal to 0. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 10n -.rt A semaphore identifier does not exist for \fIkey\fR and (\fIsemflg\fR\fB&IPC_CREAT\fR) is false. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 10n -.rt A semaphore identifier is to be created but the system-imposed limit on the maximum number of allowed semaphores or semaphore identifiers system-wide would be exceeded. See NOTES. @@ -156,13 +146,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/semids.2 b/usr/src/man/man2/semids.2 index 8ffe66faee..ea4398cd0d 100644 --- a/usr/src/man/man2/semids.2 +++ b/usr/src/man/man2/semids.2 @@ -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 semids 2 "8 Mar 2000" "SunOS 5.11" "System Calls" +.TH SEMIDS 2 "Mar 8, 2000" .SH NAME semids \- discover all semaphore identifiers .SH SYNOPSIS @@ -43,12 +43,10 @@ Upon successful completion, \fBsemids()\fR returns \fB0\fR. Otherwise, The \fBsemids()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuf\fR or \fIpnids\fR argument points to an illegal address. .RE @@ -85,7 +83,7 @@ examine_semids() break; /* we need a bigger buffer */ ids = realloc(ids, (nids = n) * sizeof (int)); - } + } for (i = 0; i < n; i++) process_semid(ids[i]); @@ -103,13 +101,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/semop.2 b/usr/src/man/man2/semop.2 index 775a31eef4..07e616dcac 100644 --- a/usr/src/man/man2/semop.2 +++ b/usr/src/man/man2/semop.2 @@ -4,7 +4,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 semop 2 "12 May 2006" "SunOS 5.11" "System Calls" +.TH SEMOP 2 "May 12, 2006" .SH NAME semop, semtimedop \- semaphore operations .SH SYNOPSIS @@ -225,91 +225,75 @@ returned and \fBerrno\fR is set to indicate the error. The \fBsemop()\fR and \fBsemtimedop()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBE2BIG\fR\fR .ad .RS 10n -.rt The \fInsops\fR argument is greater than the system-imposed maximum. See NOTES. .RE .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt Operation permission is denied to the calling process (see \fBIntro\fR(2)). .RE .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt The operation would result in suspension of the calling process but (\fIsem_flg\fR\fB&IPC_NOWAIT\fR) is true. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIsops\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEFBIG\fR\fR .ad .RS 10n -.rt The value of \fBsem_num\fR is less than 0 or greater than or equal to the number of semaphores in the set associated with \fIsemid\fR. .RE .sp .ne 2 -.mk .na \fB\fBEIDRM\fR\fR .ad .RS 10n -.rt A \fIsemid\fR was removed from the system. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 10n -.rt A signal was received. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIsemid\fR argument is not a valid semaphore identifier, or the number of individual semaphores for which the calling process requests a \fBSEM_UNDO\fR operation would exceed the system-imposed limit. Solaris does not impose a @@ -319,12 +303,10 @@ requests a \fBSEM_UNDO\fR operation. .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 10n -.rt The limit on the number of individual processes requesting a \fBSEM_UNDO\fR operation would be exceeded. Solaris does not impose a limit on the number of individual processes requesting an \fBSEM_UNDO\fR operation. @@ -332,12 +314,10 @@ individual processes requesting an \fBSEM_UNDO\fR operation. .sp .ne 2 -.mk .na \fB\fBERANGE\fR\fR .ad .RS 10n -.rt An operation would cause a \fBsemval\fR or a \fBsemadj\fR value to overflow the system-imposed limit. .RE @@ -347,12 +327,10 @@ system-imposed limit. The \fBsemtimedop()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt The timeout expired before the requested operation could be completed. .RE @@ -361,23 +339,19 @@ The timeout expired before the requested operation could be completed. The \fBsemtimedop()\fR function will fail if one of the following is detected: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fItimeout\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fItimeout\fR argument specified a \fBtv_sec\fR or \fBtv_nsec\fR value less than 0, or a \fBtv_nsec\fR value greater than or equal to 1000 million. .RE @@ -390,13 +364,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface Stability\fBsemop()\fR is Standard. +Interface Stability \fBsemop()\fR is Standard. .TE .SH SEE ALSO diff --git a/usr/src/man/man2/setpgid.2 b/usr/src/man/man2/setpgid.2 index f7ded83fb2..a97e7691b1 100644 --- a/usr/src/man/man2/setpgid.2 +++ b/usr/src/man/man2/setpgid.2 @@ -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 setpgid 2 "28 Dec 1996" "SunOS 5.11" "System Calls" +.TH SETPGID 2 "Dec 28, 1996" .SH NAME setpgid \- set process group ID .SH SYNOPSIS @@ -45,12 +45,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBsetpgid()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt The \fIpid\fR argument matches the process \fBID\fR of a child process of the calling process and the child process has successfully executed one of the \fIexec\fR family of functions (see \fBexec\fR(2)). @@ -58,12 +56,10 @@ calling process and the child process has successfully executed one of the .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIpgid\fR argument is less than (\fBpid_t) 0\fR or greater than or equal to \fBPID_MAX\fR, or the calling process has a controlling terminal that does not support job control. @@ -71,23 +67,19 @@ not support job control. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The process indicated by the \fIpid\fR argument is a session leader. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The \fIpid\fR argument matches the process \fBID\fR of a child process of the calling process and the child process is not in the same session as the calling process. @@ -95,12 +87,10 @@ process. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The \fIpgid\fR argument does not match the process \fBID\fR of the process indicated by the \fIpid\fR argument, and there is no process with a process group \fBID\fR that matches \fIpgid\fR in the same session as the calling @@ -109,12 +99,10 @@ process. .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 10n -.rt The \fIpid\fR argument does not match the process \fBID\fR of the calling process or of a child process of the calling process. .RE @@ -127,15 +115,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/setpgrp.2 b/usr/src/man/man2/setpgrp.2 index 52ce46bf08..3268d6bf34 100644 --- a/usr/src/man/man2/setpgrp.2 +++ b/usr/src/man/man2/setpgrp.2 @@ -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 setpgrp 2 "5 Jan 2000" "SunOS 5.11" "System Calls" +.TH SETPGRP 2 "Jan 5, 2000" .SH NAME setpgrp \- set process group ID .SH SYNOPSIS @@ -40,13 +40,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/setrctl.2 b/usr/src/man/man2/setrctl.2 index 3f0381213e..57c8248027 100644 --- a/usr/src/man/man2/setrctl.2 +++ b/usr/src/man/man2/setrctl.2 @@ -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 setrctl 2 "31 Jan 2007" "SunOS 5.11" "System Calls" +.TH SETRCTL 2 "Jan 31, 2007" .SH NAME setrctl, getrctl \- set or get resource control values .SH SYNOPSIS @@ -109,24 +109,20 @@ error. The \fBsetrctl()\fR and \fBgetrctl()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 12n -.rt The \fIcontrolname\fR, \fIold_blk\fR, or \fInew_blk\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 12n -.rt No resource control with the given name is known to the system, or the resource control block contains properties that are not valid for the resource control specified. @@ -138,12 +134,10 @@ calling process. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 12n -.rt No value beyond the given resource control block exists. .sp \fBRCTL_USE_RECIPIENT_PID\fR was used and the process ID set by @@ -153,24 +147,20 @@ zone, depending on the resource control name. .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 12n -.rt No value matching the given resource control block was found for any of \fBRCTL_NEXT\fR, \fBRCTL_DELETE\fR, or \fBRCTL_REPLACE\fR. .RE .sp .ne 2 -.mk .na \fB\fBENOTSUPP\fR\fR .ad .RS 12n -.rt The resource control requested by \fBRCTL_USAGE\fR does not support the usage operation. .RE @@ -180,12 +170,10 @@ operation. The \fBsetrctl()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt The rctl value specified cannot be changed by the current process, including the case where the recipient process ID does not match the calling process and the calling process is unprivileged. @@ -193,12 +181,10 @@ the calling process is unprivileged. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt An attempt to set a system limit was attempted. .RE @@ -285,13 +271,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/setregid.2 b/usr/src/man/man2/setregid.2 index 7f83e1b9cc..0b2832d2bb 100644 --- a/usr/src/man/man2/setregid.2 +++ b/usr/src/man/man2/setregid.2 @@ -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 setregid 2 "22 Mar 2004" "SunOS 5.11" "System Calls" +.TH SETREGID 2 "Mar 22, 2004" .SH NAME setregid \- set real and effective group IDs .SH SYNOPSIS @@ -50,24 +50,20 @@ changed. The \fBsetregid()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIrgid\fR or \fIegid\fR is less than 0 or greater than \fBUID_MAX\fR (defined in <\fBlimits.h\fR>). .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_PROC_SETID\fR} privilege is not asserted in the effective set of the calling processes and a change was specified other than changing the real group \fBID\fR to the saved set-group-\fBID\fR or changing the effective group @@ -88,13 +84,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/setreuid.2 b/usr/src/man/man2/setreuid.2 index 33823a6a6c..937d57f024 100644 --- a/usr/src/man/man2/setreuid.2 +++ b/usr/src/man/man2/setreuid.2 @@ -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 setreuid 2 "22 Mar 2004" "SunOS 5.11" "System Calls" +.TH SETREUID 2 "Mar 22, 2004" .SH NAME setreuid \- set real and effective user IDs .SH SYNOPSIS @@ -53,24 +53,20 @@ changed. The \fBsetreuid()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIruid\fR or \fIeuid\fR is less than \fB0\fR or greater than \fBUID_MAX\fR (defined in <\fBlimits.h\fR>). .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {PRIV_PROC_SETID} privilege is not asserted in the effective set of the calling processes and a change was specified other than changing the real user \fBID\fR to the effective user \fBID\fR, or changing the effective user @@ -93,13 +89,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/setsid.2 b/usr/src/man/man2/setsid.2 index 0a0bd2ee2f..007819db71 100644 --- a/usr/src/man/man2/setsid.2 +++ b/usr/src/man/man2/setsid.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 setsid 2 "21 Aug 2002" "SunOS 5.11" "System Calls" +.TH SETSID 2 "Aug 21, 2002" .SH NAME setsid \- create session and set process group ID .SH SYNOPSIS @@ -43,12 +43,10 @@ and sets \fBerrno\fR to indicate the error. The \fBsetsid()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 9n -.rt The calling process is already a process group leader, or the process group \fBID\fR of a process other than the calling process matches the process \fBID\fR of the calling process. @@ -62,15 +60,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/settaskid.2 b/usr/src/man/man2/settaskid.2 index 92ea735323..0e96d5516d 100644 --- a/usr/src/man/man2/settaskid.2 +++ b/usr/src/man/man2/settaskid.2 @@ -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 settaskid 2 "10 Apr 2007" "SunOS 5.11" "System Calls" +.TH SETTASKID 2 "Apr 10, 2007" .SH NAME settaskid, gettaskid, getprojid \- set or get task or project IDs .SH SYNOPSIS @@ -60,23 +60,19 @@ indicate the error. The \fBsettaskid()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt The invoking task was created with the \fBTASK_FINAL\fR flag. .RE .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt A resource control limiting the number of tasks or LWPs in the current project or zone has been exceeded. .sp @@ -85,23 +81,19 @@ A resource control on the given project would be exceeded. .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The given project \fBID\fR is not within the valid project \fBID\fR range. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_PROC_TASKID\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -114,13 +106,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/setuid.2 b/usr/src/man/man2/setuid.2 index da5cfbfc85..8bebbbe282 100644 --- a/usr/src/man/man2/setuid.2 +++ b/usr/src/man/man2/setuid.2 @@ -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 setuid 2 "20 Jan 2003" "SunOS 5.11" "System Calls" +.TH SETUID 2 "Jan 20, 2003" .SH NAME setuid, setegid, seteuid, setgid \- set user and group IDs .SH SYNOPSIS @@ -89,23 +89,19 @@ returned and \fBerrno\fR is set to indicate the error. The \fBsetuid()\fR and \fBsetgid()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of \fIuid\fR or \fIgid\fR is out of range. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt For \fBsetuid()\fR and \fBseteuid()\fR, the {\fBPRIV_PROC_SETID\fR} privilege is not asserted in the effective set of the calling process and the \fIuid\fR argument does not match either the real or saved user IDs, or an attempt is @@ -125,15 +121,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/shmctl.2 b/usr/src/man/man2/shmctl.2 index 0011da9cf0..e9bd523d21 100644 --- a/usr/src/man/man2/shmctl.2 +++ b/usr/src/man/man2/shmctl.2 @@ -4,7 +4,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 shmctl 2 "10 Apr 2007" "SunOS 5.11" "System Calls" +.TH SHMCTL 2 "Apr 10, 2007" .SH NAME shmctl \- shared memory control operations .SH SYNOPSIS @@ -45,12 +45,10 @@ more information. The following operations require the specified tokens: .sp .ne 2 -.mk .na \fB\fBIPC_STAT\fR\fR .ad .RS 14n -.rt Place the current value of each member of the data structure associated with \fIshmid\fR into the structure pointed to by \fIbuf\fR. The contents of this structure are defined in \fBIntro\fR(2). {\fBREAD\fR} @@ -58,12 +56,10 @@ structure are defined in \fBIntro\fR(2). {\fBREAD\fR} .sp .ne 2 -.mk .na \fB\fBIPC_SET\fR\fR .ad .RS 14n -.rt Set the value of the following members of the data structure associated with \fIshmid\fR to the corresponding value found in the structure pointed to by \fIbuf\fR: @@ -83,12 +79,10 @@ or an effective user \fBID\fR equal to the value of \fBshm_perm.cuid\fR or .sp .ne 2 -.mk .na \fB\fBIPC_RMID\fR\fR .ad .RS 14n -.rt Remove the shared memory identifier specified by \fIshmid\fR from the system. The segment referenced by the identifier will be destroyed when all processes with the segment attached have either detached the segment or exited. If the @@ -101,24 +95,20 @@ has appropriate privileges or an effective user ID equal to the value of .sp .ne 2 -.mk .na \fB\fBSHM_LOCK\fR\fR .ad .RS 14n -.rt Lock the shared memory segment specified by \fIshmid\fR in memory. This command can be executed only by a process that has appropriate privileges. .RE .sp .ne 2 -.mk .na \fB\fBSHM_UNLOCK\fR\fR .ad .RS 14n -.rt Unlock the shared memory segment specified by \fIshmid\fR. This command can be executed only by a process that has appropriate privileges. .RE @@ -138,35 +128,29 @@ returned and \fBerrno\fR is set to indicate the error. The \fBshmctl()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is equal to \fBIPC_STAT\fR and \fB{READ}\fR operation permission is denied to the calling process. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 13n -.rt The \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 13n -.rt The \fIshmid\fR argument is not a valid shared memory identifier; or the \fIcmd\fR argument is not a valid command or is \fBIPC_SET\fR and \fBshm_perm.uid\fR or \fBshm_perm.gid\fR is not valid. @@ -174,12 +158,10 @@ The \fIshmid\fR argument is not a valid shared memory identifier; or the .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is equal to \fBSHM_LOCK\fR and there is not enough memory, or the operation would exceed a limit or resource control on locked memory. @@ -187,24 +169,20 @@ memory. .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is \fBIPC_STAT\fR and \fIuid\fR or \fIgid\fR is too large to be stored in the structure pointed to by \fIbuf\fR. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 13n -.rt The \fIcmd\fR argument is equal to \fBIPC_RMID\fR or \fBIPC_SET\fR, the effective user ID of the calling process is not equal to the value of \fBshm_perm.cuid\fR or \fBshm_perm.uid\fR in the data structure associated with @@ -224,13 +202,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/shmget.2 b/usr/src/man/man2/shmget.2 index 682981f8d7..a20cfad5e6 100644 --- a/usr/src/man/man2/shmget.2 +++ b/usr/src/man/man2/shmget.2 @@ -4,7 +4,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 shmget 2 "14 Aug 2006" "SunOS 5.11" "System Calls" +.TH SHMGET 2 "Aug 14, 2006" .SH NAME shmget \- get shared memory segment identifier .SH SYNOPSIS @@ -89,12 +89,10 @@ set to indicate the error. The \fBshmget()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt A shared memory identifier exists for \fIkey\fR but operation permission (see \fBIntro\fR(2)) as specified by the low-order 9 bits of \fIshmflg\fR would not be granted. @@ -102,24 +100,20 @@ be granted. .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 10n -.rt A shared memory identifier exists for \fIkey\fR but both (\fIshmflg\fR\fB&IPC_CREAT\fR) and (\fIshmflg\fR\fB&IPC_EXCL\fR) are true. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIsize\fR argument is less than the system-imposed minimum or greater than the system-imposed maximum. See NOTES. .sp @@ -129,24 +123,20 @@ associated with it is less than \fIsize\fR and \fIsize\fR is not equal to 0. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 10n -.rt A shared memory identifier does not exist for \fIkey\fR and (\fIshmflg\fR\fB&IPC_CREAT\fR) is false. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt A shared memory identifier and associated shared memory segment are to be created but the amount of available memory is not sufficient to fill the request. @@ -154,12 +144,10 @@ request. .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 10n -.rt A shared memory identifier is to be created but the system-imposed limit on the maximum number of allowed shared memory identifiers system-wide would be exceeded. See NOTES. @@ -173,13 +161,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/shmids.2 b/usr/src/man/man2/shmids.2 index 3129cb4050..62619aaed9 100644 --- a/usr/src/man/man2/shmids.2 +++ b/usr/src/man/man2/shmids.2 @@ -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 shmids 2 "8 Mar 2000" "SunOS 5.11" "System Calls" +.TH SHMIDS 2 "Mar 8, 2000" .SH NAME shmids \- discover all shared memory identifiers .SH SYNOPSIS @@ -43,12 +43,10 @@ Upon successful completion, \fBshmids()\fR returns \fB0\fR. Otherwise, The \fBshmids()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuf\fR or \fIpnids\fR argument points to an illegal address. .RE @@ -85,7 +83,7 @@ examine_shmids() break; /* we need a bigger buffer */ ids = realloc(ids, (nids = n) * sizeof (int)); - } + } for (i = 0; i < n; i++) process_shmid(ids[i]); @@ -103,13 +101,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/shmop.2 b/usr/src/man/man2/shmop.2 index 10a6cff4da..067d75e3bd 100644 --- a/usr/src/man/man2/shmop.2 +++ b/usr/src/man/man2/shmop.2 @@ -4,7 +4,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 shmop 2 "10 Mar 2008" "SunOS 5.11" "System Calls" +.TH SHMOP 2 "Mar 10, 2008" .SH NAME shmop, shmat, shmdt \- shared memory operations .SH SYNOPSIS @@ -141,23 +141,19 @@ and \fBerrno\fR is set to indicate the error. The \fBshmat()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 10n -.rt Operation permission is denied to the calling process (see \fBIntro\fR(2)). .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIshmid\fR argument is not a valid shared memory identifier. .sp The \fIshmaddr\fR argument is not equal to 0, and the value of @@ -186,24 +182,20 @@ specified by \fBshmid()\fR had previously been attached by a call to .sp .ne 2 -.mk .na \fB\fBEMFILE\fR\fR .ad .RS 10n -.rt The number of shared memory segments attached to the calling process would exceed the system-imposed limit. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt The available data space is not large enough to accommodate the shared memory segment. .RE @@ -213,24 +205,20 @@ segment. The \fBshmdt()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIshmaddr\fR argument is not the data segment start address of a shared memory segment. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt (\fIshmflg\fR\fB&SHM_SHARE_MMU\fR) is true and attaching to the shared memory segment would exceed a limit or resource control on locked memory. .RE @@ -248,17 +236,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/sigaction.2 b/usr/src/man/man2/sigaction.2 index 085f5473d0..36c4ef1a9a 100644 --- a/usr/src/man/man2/sigaction.2 +++ b/usr/src/man/man2/sigaction.2 @@ -4,7 +4,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 sigaction 2 "23 Mar 2005" "SunOS 5.11" "System Calls" +.TH SIGACTION 2 "Mar 23, 2005" .SH NAME sigaction \- detailed signal management .SH SYNOPSIS @@ -76,12 +76,10 @@ of the signal. It is formed by a logical \fBOR\fR of any of the following values: .sp .ne 2 -.mk .na \fB\fBSA_ONSTACK\fR\fR .ad .RS 16n -.rt If set and the signal is caught, and if the thread that is chosen to processes a delivered signal has an alternate signal stack declared with \fBsigaltstack\fR(2), then it will process the signal on that stack. Otherwise, @@ -90,12 +88,10 @@ the signal is delivered on the thread's normal stack. .sp .ne 2 -.mk .na \fB\fBSA_RESETHAND\fR\fR .ad .RS 16n -.rt If set and the signal is caught, the disposition of the signal is reset to \fBSIG_DFL\fR and the signal will not be blocked on entry to the signal handler (\fBSIGILL\fR, \fBSIGTRAP\fR, and \fBSIGPWR\fR cannot be automatically reset @@ -104,24 +100,20 @@ when delivered; the system silently enforces this restriction). .sp .ne 2 -.mk .na \fB\fBSA_NODEFER\fR\fR .ad .RS 16n -.rt If set and the signal is caught, the signal will not be automatically blocked by the kernel while it is being caught. .RE .sp .ne 2 -.mk .na \fB\fBSA_RESTART\fR\fR .ad .RS 16n -.rt If set and the signal is caught, functions that are interrupted by the execution of this signal's handler are transparently restarted by the system, namely \fBfcntl\fR(2), \fBioctl\fR(2), \fBwait\fR(3C), \fBwaitid\fR(2), and the @@ -137,12 +129,10 @@ error. .sp .ne 2 -.mk .na \fB\fBSA_SIGINFO\fR\fR .ad .RS 16n -.rt If cleared and the signal is caught, \fIsig\fR is passed as the only argument to the signal-catching function. If set and the signal is caught, two additional arguments are passed to the signal-catching function. If the second @@ -155,12 +145,10 @@ delivered (see \fBucontext.h\fR(3HEAD)). .sp .ne 2 -.mk .na \fB\fBSA_NOCLDWAIT\fR\fR .ad .RS 16n -.rt If set and \fIsig\fR equals \fBSIGCHLD\fR, the system will not create zombie processes when children of the calling process exit. If the calling process subsequently issues a \fBwait\fR(3C), it blocks until all of the calling @@ -170,12 +158,10 @@ process's child processes terminate, and then returns \fB\(mi1\fR with .sp .ne 2 -.mk .na \fB\fBSA_NOCLDSTOP\fR\fR .ad .RS 16n -.rt If set and \fIsig\fR equals \fBSIGCHLD\fR, \fBSIGCHLD\fR will not be sent to the calling process when its child processes stop or continue. .RE @@ -192,12 +178,10 @@ is installed. The \fBsigaction()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of the \fIsig\fR argument is not a valid signal number or is equal to \fBSIGKILL\fR or \fBSIGSTOP\fR. In addition, if in a multithreaded process, it is equal to \fBSIGWAITING\fR, \fBSIGCANCEL\fR, or \fBSIGLWP\fR. @@ -211,17 +195,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/sigaltstack.2 b/usr/src/man/man2/sigaltstack.2 index 50e56186a2..ff72414e8e 100644 --- a/usr/src/man/man2/sigaltstack.2 +++ b/usr/src/man/man2/sigaltstack.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 sigaltstack 2 "1 Nov 2003" "SunOS 5.11" "System Calls" +.TH SIGALTSTACK 2 "Nov 1, 2003" .SH NAME sigaltstack \- set or get signal alternate stack context .SH SYNOPSIS @@ -53,12 +53,10 @@ growth and alignment. The \fBss_flags\fR member specifies the new stack state and may be set to the following: .sp .ne 2 -.mk .na \fB\fBSS_DISABLE\fR\fR .ad .RS 14n -.rt The stack is to be disabled and \fBss_sp\fR and \fBss_size\fR are ignored. If \fBSS_DISABLE\fR is not set, the stack will be enabled. .RE @@ -72,12 +70,10 @@ and size of that stack. The \fBss_flags\fR member specifies the stack's state, and may contain the following values: .sp .ne 2 -.mk .na \fB\fBSS_ONSTACK\fR\fR .ad .RS 14n -.rt The thread is currently executing on the alternate signal stack. Attempts to modify the alternate signal stack while the thread is executing on it will fail. @@ -85,12 +81,10 @@ fail. .sp .ne 2 -.mk .na \fB\fBSS_DISABLE\fR\fR .ad .RS 14n -.rt The alternate signal stack is currently disabled. .RE @@ -105,46 +99,38 @@ returned and \fBerrno\fR is set to indicate the error. The \fBsigaltstack()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIss\fR or \fIoss\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIss\fR argument is not a null pointer, and the \fBss_flags\fR member pointed to by \fIss\fR contains flags other than \fBSS_DISABLE\fR. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt The size of the alternate stack area is less than \fBMINSIGSTKSZ\fR. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt An attempt was made to modify an active stack. .RE @@ -156,15 +142,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/sigpending.2 b/usr/src/man/man2/sigpending.2 index 63a315b04a..b88dc78518 100644 --- a/usr/src/man/man2/sigpending.2 +++ b/usr/src/man/man2/sigpending.2 @@ -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 sigpending 2 "28 Dec 1996" "SunOS 5.11" "System Calls" +.TH SIGPENDING 2 "Dec 28, 1996" .SH NAME sigpending \- examine signals that are blocked and pending .SH SYNOPSIS @@ -32,12 +32,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBsigpending()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIset\fR argument points to an illegal address. .RE @@ -49,15 +47,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/sigprocmask.2 b/usr/src/man/man2/sigprocmask.2 index 4cb6f47a59..97fab1dfc2 100644 --- a/usr/src/man/man2/sigprocmask.2 +++ b/usr/src/man/man2/sigprocmask.2 @@ -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 sigprocmask 2 "23 Mar 2005" "SunOS 5.11" "System Calls" +.TH SIGPROCMASK 2 "Mar 23, 2005" .SH NAME sigprocmask \- change or examine caller's signal mask .SH SYNOPSIS @@ -56,12 +56,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBsigprocmask()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The value of the \fIhow\fR argument is not equal to one of the defined values. .RE @@ -70,12 +68,10 @@ The value of the \fIhow\fR argument is not equal to one of the defined values. The \fBsigprocmask()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIset\fR or \fIoset\fR argument points to an illegal address. .RE @@ -87,15 +83,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/sigsend.2 b/usr/src/man/man2/sigsend.2 index bfdf70ffef..2801dda2b0 100644 --- a/usr/src/man/man2/sigsend.2 +++ b/usr/src/man/man2/sigsend.2 @@ -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 sigsend 2 "19 Jul 2004" "SunOS 5.11" "System Calls" +.TH SIGSEND 2 "Jul 19, 2004" .SH NAME sigsend, sigsendset \- send a signal to a process or a group of processes .SH SYNOPSIS @@ -114,45 +114,37 @@ set of processes the function is to apply to. The valid values for \fBp_op\fR and the processes they specify are: .sp .ne 2 -.mk .na \fB\fBPOP_DIFF\fR\fR .ad .RS 12n -.rt Set difference: processes in left set and not in right set. .RE .sp .ne 2 -.mk .na \fB\fBPOP_AND\fR\fR .ad .RS 12n -.rt Set intersection: processes in both left and right sets. .RE .sp .ne 2 -.mk .na \fB\fBPOP_OR\fR\fR .ad .RS 12n -.rt Set union: processes in either left or right set or both. .RE .sp .ne 2 -.mk .na \fB\fBPOP_XOR\fR\fR .ad .RS 12n -.rt Set exclusive-or: processes in left or right set but not in both. .RE @@ -167,36 +159,30 @@ returned and \fBerrno\fR is set to indicate the error. The \fBsigsend()\fR and \fBsigsendset()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIsig\fR argument is not a valid signal number, or the \fIidtype\fR argument is not a valid idtype field. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIsig\fR argument is \fBSIGKILL,\fR \fIidtype\fR is \fBP_PID\fR and \fIid\fR is \fB1\fR (proc1). .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The effective user of the calling process does not match the real or saved user ID of the receiving process, the calling process does not have the {\fBPRIV_PROC_OWNER\fR} privilege asserted in the effective set, and the @@ -211,12 +197,10 @@ receiving process. .sp .ne 2 -.mk .na \fB\fBESRCH\fR\fR .ad .RS 10n -.rt No process can be found corresponding to that specified by \fIid\fR and \fIidtype\fR. .RE @@ -226,12 +210,10 @@ No process can be found corresponding to that specified by \fIid\fR and The \fBsigsendset()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIpsp\fR argument points to an illegal address. .RE diff --git a/usr/src/man/man2/sigsuspend.2 b/usr/src/man/man2/sigsuspend.2 index abd0d95cdd..565ddce419 100644 --- a/usr/src/man/man2/sigsuspend.2 +++ b/usr/src/man/man2/sigsuspend.2 @@ -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 sigsuspend 2 "24 Jun 2001" "SunOS 5.11" "System Calls" +.TH SIGSUSPEND 2 "Jun 24, 2001" .SH NAME sigsuspend \- install a signal mask and suspend caller until signal .SH SYNOPSIS @@ -45,12 +45,10 @@ sets \fBerrno\fR to indicate the error. The \fBsigsuspend()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 9n -.rt A signal was caught by the caller and control was returned from the signal catching function. .RE @@ -60,12 +58,10 @@ catching function. The \fBsigsuspend()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIset\fR argument points to an illegal address. .RE @@ -77,15 +73,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/sigwait.2 b/usr/src/man/man2/sigwait.2 index 0477de92c1..b038447dc5 100644 --- a/usr/src/man/man2/sigwait.2 +++ b/usr/src/man/man2/sigwait.2 @@ -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 sigwait 2 "16 Apr 2009" "SunOS 5.11" "System Calls" +.TH SIGWAIT 2 "Apr 16, 2009" .SH NAME sigwait \- wait until a signal is posted .SH SYNOPSIS @@ -65,34 +65,28 @@ standard-conforming version returns an error number to indicate the error. The \fBsigwait()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIset\fR argument points to an invalid address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 10n -.rt The wait was interrupted by an unblocked, caught signal. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIset\fR argument contains an unsupported signal number. .RE @@ -137,24 +131,24 @@ main(void) pthread_t t; pthread_t t2; pthread_t t3; - + sigfillset ( &signalSet ); /* * Block signals in initial thread. New threads will * inherit this signal mask. */ pthread_sigmask ( SIG_BLOCK, &signalSet, NULL ); - + printf("Creating threads\en"); - + pthread_create(&t, NULL, sigint, NULL); pthread_create(&t2, NULL, threadTwo, NULL); pthread_create(&t3, NULL, threadThree, NULL); - + printf("##################\en"); printf("press CTRL-C to deliver SIGINT to sigint thread\en"); printf("##################\en"); - + pthread_exit((void *)0); } static void * @@ -182,19 +176,19 @@ sigint(void *arg) { int sig; int err; - + printf("thread sigint [tid: %d] awaiting SIGINT\en", pthread_self()); - + /* /* use standard-conforming sigwait() -- 2 args: signal set, signum */ err = sigwait ( &signalSet, &sig ); - + /* test for SIGINT; could catch other signals */ if (err || sig != SIGINT) abort(); - + printf("\enSIGINT signal %d caught by sigint thread [tid: %d]\en", sig, pthread_self()); pthread_exit((void *)0); @@ -210,17 +204,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/stat.2 b/usr/src/man/man2/stat.2 index df24fda9dc..ff1db97318 100644 --- a/usr/src/man/man2/stat.2 +++ b/usr/src/man/man2/stat.2 @@ -4,7 +4,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 stat 2 "10 Oct 2007" "SunOS 5.11" "System Calls" +.TH STAT 2 "Oct 10, 2007" .SH NAME stat, lstat, fstat, fstatat \- get file status .SH SYNOPSIS @@ -108,12 +108,10 @@ char st_fstype[_ST_FSTYPSZ]; Descriptions of structure members are as follows: .sp .ne 2 -.mk .na \fB\fBst_mode\fR\fR .ad .RS 14n -.rt The mode of the file as described for the \fBmknod()\fR function. In addition to the modes described on the \fBmknod\fR(2) manual page, the mode of a file can also be \fBS_IFSOCK\fR if the file is a socket, \fBS_IFDOOR\fR if the file @@ -124,24 +122,20 @@ or by \fBfstat()\fR when the \fBAT_SYMLINK_NOFOLLOW\fR flag is set. .sp .ne 2 -.mk .na \fB\fBst_ino\fR\fR .ad .RS 14n -.rt This field uniquely identifies the file in a given file system. The pair \fBst_ino\fR and \fBst_dev\fR uniquely identifies regular files. .RE .sp .ne 2 -.mk .na \fB\fBst_dev\fR\fR .ad .RS 14n -.rt This field uniquely identifies the file system that contains the file. Its value may be used as input to the \fBustat()\fR function to determine more information about this file system. No other meaning is associated with this @@ -150,12 +144,10 @@ value. .sp .ne 2 -.mk .na \fB\fBst_rdev\fR\fR .ad .RS 14n -.rt This field should be used only by administrative commands. It is valid only for block special or character special files and only has meaning on the system where the file was configured. @@ -163,57 +155,47 @@ where the file was configured. .sp .ne 2 -.mk .na \fB\fBst_nlink\fR\fR .ad .RS 14n -.rt This field should be used only by administrative commands. .RE .sp .ne 2 -.mk .na \fB\fBst_uid\fR\fR .ad .RS 14n -.rt The user \fBID\fR of the file's owner. .RE .sp .ne 2 -.mk .na \fB\fBst_gid\fR\fR .ad .RS 14n -.rt The group \fBID\fR of the file's group. .RE .sp .ne 2 -.mk .na \fB\fBst_size\fR\fR .ad .RS 14n -.rt For regular files, this is the address of the end of the file. For block special or character special, this is not defined. See also \fBpipe\fR(2). .RE .sp .ne 2 -.mk .na \fB\fBst_atime\fR\fR .ad .RS 14n -.rt Time when file data was last accessed. Some of the functions that change this member are: \fBcreat()\fR, \fBmknod()\fR, \fBpipe()\fR, \fButime\fR(2), and \fBread\fR(2). @@ -221,12 +203,10 @@ member are: \fBcreat()\fR, \fBmknod()\fR, \fBpipe()\fR, \fButime\fR(2), and .sp .ne 2 -.mk .na \fB\fBst_mtime\fR\fR .ad .RS 14n -.rt Time when data was last modified. Some of the functions that change this member are: \fBcreat()\fR, \fBmknod()\fR, \fBpipe()\fR, \fButime()\fR, and \fBwrite\fR(2). @@ -234,12 +214,10 @@ are: \fBcreat()\fR, \fBmknod()\fR, \fBpipe()\fR, \fButime()\fR, and .sp .ne 2 -.mk .na \fB\fBst_ctime\fR\fR .ad .RS 14n -.rt Time when file status was last changed. Some of the functions that change this member are: \fBchmod\fR(2), \fBchown\fR(2), \fBcreat\fR(2), \fBlink\fR(2), \fBmknod\fR(2), \fBpipe\fR(2), \fBrename\fR(2), \fBunlink\fR(2), @@ -248,36 +226,30 @@ member are: \fBchmod\fR(2), \fBchown\fR(2), \fBcreat\fR(2), \fBlink\fR(2), .sp .ne 2 -.mk .na \fB\fBst_blksize\fR\fR .ad .RS 14n -.rt A hint as to the "best" unit size for I/O operations. This field is not defined for block special or character special files. .RE .sp .ne 2 -.mk .na \fB\fBst_blocks\fR\fR .ad .RS 14n -.rt The total number of physical blocks of size 512 bytes actually allocated on disk. This field is not defined for block special or character special files. .RE .sp .ne 2 -.mk .na \fB\fBst_fstype\fR\fR .ad .RS 14n -.rt A null-teminated string that uniquely identifies the type of the filesystem that contains the file. .RE @@ -294,23 +266,19 @@ The \fBstat()\fR, \fBfstat()\fR, \fBlstat()\fR, and \fBfstatat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 13n -.rt An error occurred while reading from the file system. .RE .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The file size in bytes or the number of blocks allocated to the file or the file serial number cannot be represented correctly in the structure pointed to by \fIbuf\fR. @@ -321,58 +289,48 @@ by \fIbuf\fR. The \fBstat()\fR, \fBlstat()\fR, and \fBfstatat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a component of the path prefix. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIbuf\fR or \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fBstat()\fR or \fBlstat()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt A loop exists in symbolic links encountered during the resolution of the \fIpath\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds {\fBPATH_MAX\fR}, or the length of a \fIpath\fR component exceeds {\fBNAME_MAX\fR} while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -380,36 +338,30 @@ is in effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of \fIpath\fR does not name an existing file or \fIpath\fR is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory, or the \fIfildes\fR argument does not refer to a valid directory when given a non-null relative path. .RE @@ -419,46 +371,38 @@ does not refer to a valid directory when given a non-null relative path. The \fBfstat()\fR and \fBfstatat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is not a valid open file descriptor. The \fIfildes\fR argument to \fBfstatat()\fR can also have the valid value of \fBAT_FDCWD\fR. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 11n -.rt The \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 11n -.rt A signal was caught during the execution of the \fBfstat()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument points to a remote machine and the link to that machine is no longer active. .RE @@ -468,12 +412,10 @@ machine is no longer active. The \fBstat()\fR, \fBfstat()\fR, and \fBlstat()\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt One of the members is too large to store in the \fBstat\fR structure pointed to by \fIbuf\fR. .RE @@ -483,24 +425,20 @@ by \fIbuf\fR. The \fBstat()\fR and \fBlstat()\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt More than {\fBSYMLOOP_MAX\fR} symbolic links were encountered during the resolution of the \fIpath\fR argument. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt As a result of encountering a symbolic link in resolution of the\fIpath\fR argument, the length of the substituted pathname strings exceeds {\fBPATH_MAX\fR}. @@ -511,12 +449,10 @@ argument, the length of the substituted pathname strings exceeds The \fBstat()\fR and \fBfstatat()\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 9n -.rt The \fIpath\fR argument names a character or block device special file and the corresponding I/O device has been retired by the fault management framework. .RE @@ -578,17 +514,17 @@ while ((dp = readdir(dir)) != NULL) { /* Get entry's information. */ if (stat(dp->d_name, &statbuf) == -1) continue; - + /* Print out type, permissions, and number of links. */ printf("%10.10s", sperm (statbuf.st_mode)); printf("%4d", statbuf.st_nlink); - + /* Print out owners name if it is found using getpwuid(). */ if ((pwd = getpwuid(statbuf.st_uid)) != NULL) printf(" %-8.8s", pwd->pw_name); else printf(" %-8d", statbuf.st_uid); - + /* Print out group name if it's found using getgrgid(). */ if ((grp = getgrgid(statbuf.st_gid)) != NULL) printf(" %-8.8s", grp->gr_name); @@ -598,10 +534,10 @@ while ((dp = readdir(dir)) != NULL) { /* Print size of file. */ printf(" %9jd", (intmax_t)statbuf.st_size); tm = localtime(&statbuf.st_mtime); - + /* Get localized date string. */ strftime(datestring, sizeof(datestring), nl_langinfo(D_T_FMT), tm); - + printf(" %s %s\en", datestring, dp->d_name); } .fi @@ -674,17 +610,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -Standard See below. +Standard See below. .TE .sp diff --git a/usr/src/man/man2/statvfs.2 b/usr/src/man/man2/statvfs.2 index 86e417de60..d7b1781566 100644 --- a/usr/src/man/man2/statvfs.2 +++ b/usr/src/man/man2/statvfs.2 @@ -3,14 +3,14 @@ .\" 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 statvfs 2 "22 Mar 2004" "SunOS 5.11" "System Calls" +.TH STATVFS 2 "Mar 22, 2004" .SH NAME statvfs, fstatvfs \- get file system information .SH SYNOPSIS .LP .nf #include <sys/types.h> -#include <sys/statvfs.h> +#include <sys/statvfs.h> \fBint\fR \fBstatvfs\fR(\fBconst char *restrict\fR \fIpath\fR, \fBstruct statvfs *restrict\fR \fIbuf\fR); .fi @@ -53,7 +53,7 @@ fsfilcnt_t f_ffree; /* total # of free file nodes */ fsfilcnt_t f_favail; /* # of inodes avail to non-privileged user*/ u_long f_fsid; /* file system id (dev for now) */ -char f_basetype[FSTYPSZ]; /* target fs type name, +char f_basetype[FSTYPSZ]; /* target fs type name, null-terminated */ u_long f_flag; /* bit mask of flags */ u_long f_namemax; /* maximum file name length */ @@ -96,12 +96,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBstatvfs()\fR and \fBfstatvfs()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt One of the values to be returned cannot be represented correctly in the structure pointed to by \fIbuf\fR. .RE @@ -111,103 +109,85 @@ structure pointed to by \fIbuf\fR. The \fBstatvfs()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied on a component of the path prefix. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR or \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fBstatvfs()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while reading the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of a \fIpath\fR component exceeds \fBNAME_MAX\fR characters, or the length of \fIpath\fR The exceeds \fBPATH_MAX\fR characters. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt Either a component of the path prefix or the file referred to by \fIpath\fR does not exist. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix of \fIpath\fR is not a directory. .RE @@ -216,45 +196,37 @@ A component of the path prefix of \fIpath\fR is not a directory. The \fBfstatvfs()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 10n -.rt The \fIfildes\fR argument is not an open file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 10n -.rt A signal was caught during the execution of the \fBfstatvfs()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 10n -.rt An I/O error occurred while reading the file system. .RE @@ -271,13 +243,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/stime.2 b/usr/src/man/man2/stime.2 index ed53229a64..458394b7f2 100644 --- a/usr/src/man/man2/stime.2 +++ b/usr/src/man/man2/stime.2 @@ -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 stime 2 "22 Mar 2004" "SunOS 5.11" "System Calls" +.TH STIME 2 "Mar 22, 2004" .SH NAME stime \- set system time and date .SH SYNOPSIS @@ -31,23 +31,19 @@ returned and \fBerrno\fR is set to indicate the error. The \fBstime()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fItp\fR argument points to an invalid (negative) value. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_SYS_TIME\fR} privilege is not asserted in the effective set of the calling process. .RE diff --git a/usr/src/man/man2/swapctl.2 b/usr/src/man/man2/swapctl.2 index 2ad39ff122..d0f705b842 100644 --- a/usr/src/man/man2/swapctl.2 +++ b/usr/src/man/man2/swapctl.2 @@ -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 swapctl 2 "25 Sep 1997" "SunOS 5.11" "System Calls" +.TH SWAPCTL 2 "Sep 25, 1997" .SH NAME swapctl \- manage swap space .SH SYNOPSIS @@ -109,36 +109,30 @@ Under the following conditions, the function \fBswapctl()\fR fails and sets \fBerrno\fR to: .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 16n -.rt Part of the range specified by \fBsr_start\fR and \fBsr_length\fR is already being used for swapping on the specified resource (\fBSC_ADD\fR). .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt Either \fIarg\fR, \fBsr_name\fR, or \fBste_path\fR points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The specified function value is not valid, the path specified is not a swap resource (\fBSC_REMOVE\fR), part of the range specified by \fBsr_start\fR and \fBsr_length\fR lies outside the resource specified (\fBSC_ADD\fR), or the @@ -147,35 +141,29 @@ specified swap area is less than one page (\fBSC_ADD\fR). .sp .ne 2 -.mk .na \fB\fBEISDIR\fR\fR .ad .RS 16n -.rt The path specified for \fBSC_ADD\fR is a directory. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating the pathname provided to \fBSC_ADD\fR or \fBSC_REMOVE\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of a component of the path specified for \fBSC_ADD\fR or \fBSC_REMOVE\fR exceeds \fBNAME_MAX\fR characters or the length of the path exceeds \fBPATH_MAX\fR characters and \fB_POSIX_NO_TRUNC\fR is in effect. @@ -183,23 +171,19 @@ exceeds \fBPATH_MAX\fR characters and \fB_POSIX_NO_TRUNC\fR is in effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The pathname specified for \fBSC_ADD\fR or \fBSC_REMOVE\fR does not exist. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 16n -.rt An insufficient number of \fBstruct\fR \fBswapent\fR structures were provided to \fBSC_LIST\fR, or there were insufficient system storage resources available during an \fBSC_ADD\fR or \fBSC_REMOVE\fR, or the system would not have enough @@ -208,48 +192,40 @@ swap space after an \fBSC_REMOVE\fR. .sp .ne 2 -.mk .na \fB\fBENOSYS\fR\fR .ad .RS 16n -.rt The pathname specified for \fBSC_ADD\fR or \fBSC_REMOVE\fR is not a file or block special device. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt Pathname provided to \fBSC_ADD\fR or \fBSC_REMOVE\fR contained a component in the path prefix that was not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The {\fBPRIV_SYS_MOUNT\fR} was not asserted in the effective set of the calling process. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The pathname specified for \fBSC_ADD\fR is a read-only file system. .RE @@ -258,12 +234,10 @@ The pathname specified for \fBSC_ADD\fR is a read-only file system. Additionally, the \fBswapctl()\fR function will fail for 32-bit interfaces if: .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt The amount of swap space configured on the machine is too large to be represented by a 32-bit quantity. .RE @@ -304,7 +278,7 @@ again: } /* allocate swaptable for num+1 entries */ if ((s = (swaptbl_t *) - malloc(num * sizeof(swapent_t) + + malloc(num * sizeof(swapent_t) + sizeof(struct swaptable))) == (void *) 0) { fprintf(stderr, "Malloc Failed\en"); @@ -320,7 +294,7 @@ again: for (i = 0; i < (num + 1); i++) { s->swt_ent[i].ste_path = strtab + (i * MAXSTRSIZE); } - + s->swt_n = num + 1; if ((n = swapctl(SC_LIST, s)) < 0) { perror("swapctl"); diff --git a/usr/src/man/man2/symlink.2 b/usr/src/man/man2/symlink.2 index 3cc3df4ccb..11d440cc67 100644 --- a/usr/src/man/man2/symlink.2 +++ b/usr/src/man/man2/symlink.2 @@ -4,7 +4,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 symlink 2 "18 May 2007" "SunOS 5.11" "System Calls" +.TH SYMLINK 2 "May 18, 2007" .SH NAME symlink \- make a symbolic link to a file .SH SYNOPSIS @@ -42,23 +42,19 @@ not made. The \fBsymlink()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a component of the path prefix of \fIname2\fR. .RE .sp .ne 2 -.mk .na \fB\fBEDQUOT\fR\fR .ad .RS 16n -.rt The directory where the entry for the new symbolic link is being placed cannot be extended because the user's quota of disk blocks on that file system has been exhausted; the new symbolic link cannot be created because the user's @@ -69,68 +65,56 @@ exhausted. .sp .ne 2 -.mk .na \fB\fBEEXIST\fR\fR .ad .RS 16n -.rt The file referred to by \fIname2\fR already exists. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIname1\fR or \fIname2\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEILSEQ\fR\fR .ad .RS 16n -.rt The path argument includes non-UTF8 characters and the file system accepts only file names where all characters are part of the UTF-8 character codeset. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurs while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links are encountered in translating \fIname2\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIname2\fR argument exceeds \fBPATH_MAX\fR, or the length of a \fIname2\fR component exceeds \fBNAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -138,23 +122,19 @@ in effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of the path prefix of \fIname2\fR does not exist. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 16n -.rt The directory in which the entry for the new symbolic link is being placed cannot be extended because no space is left on the file system containing the directory; the new symbolic link cannot be created because no space is left on @@ -164,34 +144,28 @@ file system on which the file is being created. .sp .ne 2 -.mk .na \fB\fBENOSYS\fR\fR .ad .RS 16n -.rt The file system does not support symbolic links. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix of \fIname2\fR is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The file \fIname2\fR would reside on a read-only file system. .RE @@ -203,13 +177,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/sync.2 b/usr/src/man/man2/sync.2 index 42022980d6..bb04a13263 100644 --- a/usr/src/man/man2/sync.2 +++ b/usr/src/man/man2/sync.2 @@ -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 sync 2 "5 Jul 1990" "SunOS 5.11" "System Calls" +.TH SYNC 2 "Jul 5, 1990" .SH NAME sync \- update super block .SH SYNOPSIS @@ -38,13 +38,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/sysfs.2 b/usr/src/man/man2/sysfs.2 index 7e079fb49f..b83c63ed85 100644 --- a/usr/src/man/man2/sysfs.2 +++ b/usr/src/man/man2/sysfs.2 @@ -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 sysfs 2 "5 Jul 1990" "SunOS 5.11" "System Calls" +.TH SYSFS 2 "Jul 5, 1990" .SH NAME sysfs \- get file system type information .SH SYNOPSIS @@ -33,24 +33,20 @@ configured in the system. The number of arguments accepted by \fBsysfs()\fR depends on the \fIopcode\fR argument, which can take the following values: .sp .ne 2 -.mk .na \fB\fBGETFSIND\fR\fR .ad .RS 13n -.rt Translate \fIfsname\fR, a null-terminated file-system type identifier, into a file-system type index. .RE .sp .ne 2 -.mk .na \fB\fBGETFSTYP\fR\fR .ad .RS 13n -.rt Translate \fIfs_index\fR, a file-system type index, into a null-terminated file-system type identifier and write it into the buffer pointed to by \fIbuf\fR, which must be at least of size \fBFSTYPSZ\fR as defined in @@ -59,12 +55,10 @@ file-system type identifier and write it into the buffer pointed to by .sp .ne 2 -.mk .na \fB\fBGETNFSTYP\fR\fR .ad .RS 13n -.rt Return the total number of file system types configured in the system. .RE @@ -75,34 +69,28 @@ Upon successful completion, the value returned depends upon the \fIopcode\fR argument as follows: .sp .ne 2 -.mk .na \fB\fBGETFSIND\fR\fR .ad .RS 13n -.rt the file-system type index .RE .sp .ne 2 -.mk .na \fB\fBGETFSTYP\fR\fR .ad .RS 13n -.rt \fB0\fR .RE .sp .ne 2 -.mk .na \fB\fBGETNFSTYP\fR\fR .ad .RS 13n -.rt the number of file system types configured .RE @@ -116,23 +104,19 @@ error. The \fBsysfs()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuf\fR or \fIfsname\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIfsname\fR argument points to an invalid file-system identifier; the \fIfs_index\fR argument is 0 or invalid; or the \fIopcode\fR argument is invalid. diff --git a/usr/src/man/man2/sysinfo.2 b/usr/src/man/man2/sysinfo.2 index a62d1f7c61..648fce0403 100644 --- a/usr/src/man/man2/sysinfo.2 +++ b/usr/src/man/man2/sysinfo.2 @@ -4,7 +4,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 sysinfo 2 "29 Jan 2009" "SunOS 5.11" "System Calls" +.TH SYSINFO 2 "Jan 29, 2009" .SH NAME sysinfo \- get and set system information strings .SH SYNOPSIS @@ -32,7 +32,6 @@ than a string. The values for \fIcommand\fR are as follows: .sp .ne 2 -.mk .na \fB\fBSI_SYSNAME\fR\fR .ad @@ -45,7 +44,6 @@ implementation of the operating system, for example, \fBSunOS\fR or \fBUTS\fR. .sp .ne 2 -.mk .na \fB\fBSI_HOSTNAME\fR\fR .ad @@ -64,7 +62,6 @@ length (plus the terminating null). .sp .ne 2 -.mk .na \fB\fBSI_SET_HOSTNAME\fR\fR .ad @@ -79,7 +76,6 @@ calling process. .sp .ne 2 -.mk .na \fB\fBSI_RELEASE\fR\fR .ad @@ -92,7 +88,6 @@ or \fB4.1\fR. .sp .ne 2 -.mk .na \fB\fBSI_VERSION\fR\fR .ad @@ -105,7 +100,6 @@ string are defined by the system provider. .sp .ne 2 -.mk .na \fB\fBSI_MACHINE\fR\fR .ad @@ -117,7 +111,6 @@ by \fBuname\fR(2) in the \fImachine\fR field, for example, \fBsun4u\fR. .sp .ne 2 -.mk .na \fB\fBSI_ARCHITECTURE\fR\fR .ad @@ -131,7 +124,6 @@ predefined names in the C language compilation system. .sp .ne 2 -.mk .na \fB\fBSI_ARCHITECTURE_64\fR\fR .ad @@ -146,7 +138,6 @@ allow a 64-bit application to run. .sp .ne 2 -.mk .na \fB\fBSI_ARCHITECTURE_32\fR\fR .ad @@ -160,7 +151,6 @@ compilation system. .sp .ne 2 -.mk .na \fB\fBSI_ARCHITECTURE_K\fR\fR .ad @@ -174,7 +164,6 @@ compilation system. .sp .ne 2 -.mk .na \fB\fBSI_ARCHITECTURE_NATIVE\fR\fR .ad @@ -188,7 +177,6 @@ compilation system. .sp .ne 2 -.mk .na \fB\fBSI_ISALIST\fR\fR .ad @@ -218,7 +206,6 @@ handle instruction set extensions. .sp .ne 2 -.mk .na \fB\fBSI_PLATFORM\fR\fR .ad @@ -231,7 +218,6 @@ model of the hardware platform, for example, \fBSUNW,Sun-Blade-1500\fR, .sp .ne 2 -.mk .na \fB\fBSI_HW_PROVIDER\fR\fR .ad @@ -243,7 +229,6 @@ Copies the name of the hardware manufacturer into the array pointed to by .sp .ne 2 -.mk .na \fB\fBSI_HW_SERIAL\fR\fR .ad @@ -265,7 +250,6 @@ lifetime of a given system. .sp .ne 2 -.mk .na \fB\fBSI_SRPC_DOMAIN\fR\fR .ad @@ -277,7 +261,6 @@ by \fIbuf\fR. .sp .ne 2 -.mk .na \fB\fBSI_SET_SRPC_DOMAIN\fR\fR .ad @@ -291,7 +274,6 @@ of the calling process. .sp .ne 2 -.mk .na \fB\fBSI_DHCP_CACHE\fR\fR .ad @@ -323,35 +305,29 @@ Otherwise, \(mi1 is returned and \fBerrno\fR is set to indicate the error. The \fBsysinfo()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuf\fR argument does not point to a valid address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIcount\fR argument for a non-SET command is less than 0 or the data for a SET command exceeds the limits established by the implementation. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt The {\fBPRIV_SYS_ADMIN\fR} was not asserted in the effective set of the calling process. .RE diff --git a/usr/src/man/man2/time.2 b/usr/src/man/man2/time.2 index b83999fd31..11e250a3cd 100644 --- a/usr/src/man/man2/time.2 +++ b/usr/src/man/man2/time.2 @@ -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 time 2 "28 Dec 1996" "SunOS 5.11" "System Calls" +.TH TIME 2 "Dec 28, 1996" .SH NAME time \- get time .SH SYNOPSIS @@ -38,15 +38,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/times.2 b/usr/src/man/man2/times.2 index 8dd857282c..506507eec5 100644 --- a/usr/src/man/man2/times.2 +++ b/usr/src/man/man2/times.2 @@ -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 times 2 "14 May 1997" "SunOS 5.11" "System Calls" +.TH TIMES 2 "May 14, 1997" .SH NAME times \- get process and child process times .SH SYNOPSIS @@ -73,12 +73,10 @@ and \fBerrno\fR is set to indicate the error. The \fBtimes()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuffer\fR argument points to an illegal address. .RE @@ -90,15 +88,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/uadmin.2 b/usr/src/man/man2/uadmin.2 index a38a011636..111b962dfd 100644 --- a/usr/src/man/man2/uadmin.2 +++ b/usr/src/man/man2/uadmin.2 @@ -4,7 +4,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 uadmin 2 "25 Mar 2009" "SunOS 5.11" "System Calls" +.TH UADMIN 2 "Mar 25, 2009" .SH NAME uadmin \- administrative control .SH SYNOPSIS @@ -28,68 +28,56 @@ initialized to \fINULL\fR if not used. As specified by \fIcmd\fR, the following commands are available: .sp .ne 2 -.mk .na \fB\fBA_SHUTDOWN\fR\fR .ad .RS 14n -.rt The system is shut down. All user processes are killed, the buffer cache is flushed, and the root file system is unmounted. The action to be taken after the system has been shut down is specified by \fIfcn\fR. The functions are generic; the hardware capabilities vary on specific machines. .sp .ne 2 -.mk .na \fB\fBAD_HALT\fR\fR .ad .RS 17n -.rt Halt the processor(s). .RE .sp .ne 2 -.mk .na \fB\fBAD_POWEROFF\fR\fR .ad .RS 17n -.rt Halt the processor(s) and turn off the power. .RE .sp .ne 2 -.mk .na \fB\fBAD_BOOT\fR\fR .ad .RS 17n -.rt Reboot the system, using the kernel file. .RE .sp .ne 2 -.mk .na \fB\fBAD_IBOOT\fR\fR .ad .RS 17n -.rt Interactive reboot; user is prompted for bootable program name. .RE .sp .ne 2 -.mk .na \fB\fBAD_FASTREBOOT\fR\fR .ad .RS 17n -.rt Bypass BIOS and boot loader .RE @@ -97,24 +85,20 @@ Bypass BIOS and boot loader .sp .ne 2 -.mk .na \fB\fBA_REBOOT\fR\fR .ad .RS 14n -.rt The system stops immediately without any further processing. The action to be taken next is specified by \fIfcn\fR as above. .RE .sp .ne 2 -.mk .na \fB\fBA_DUMP\fR\fR .ad .RS 14n -.rt The system is forced to panic immediately without any further processing and a crash dump is written to the dump device (see \fBdumpadm\fR(1M)). The action to be taken next is specified by \fIfcn\fR, as above. @@ -122,29 +106,24 @@ to be taken next is specified by \fIfcn\fR, as above. .sp .ne 2 -.mk .na \fB\fBA_REMOUNT\fR\fR .ad .RS 14n -.rt The root file system is mounted again after having been fixed. This should be used only during the startup process. .RE .sp .ne 2 -.mk .na \fB\fBA_FREEZE\fR\fR .ad .RS 14n -.rt Suspend the whole system. The system state is preserved in the state file. The following subcommands, specified by \fIfcn\fR, are available. .sp .ne 2 -.mk .na \fB\fBAD_SUSPEND_TO_DISK\fR\fR .ad @@ -156,7 +135,6 @@ state S4. .sp .ne 2 -.mk .na \fB\fBAD_CHECK_SUSPEND_TO_DISK\fR\fR .ad @@ -169,7 +147,6 @@ on your system. .sp .ne 2 -.mk .na \fB\fBAD_SUSPEND_TO_RAM\fR\fR .ad @@ -180,7 +157,6 @@ Save the system state to memory This subcommand is equivalent to ACPI state S3. .sp .ne 2 -.mk .na \fB\fBAD_CHECK_SUSPEND_TO_RAM\fR\fR .ad @@ -195,7 +171,6 @@ The following subcommands, specified by \fIfcn\fR, are obsolete and might be removed in a subsequent release: .sp .ne 2 -.mk .na \fB\fBAD_COMPRESS\fR\fR .ad @@ -208,7 +183,6 @@ instead. .sp .ne 2 -.mk .na \fB\fBAD_CHECK\fR\fR .ad @@ -222,7 +196,6 @@ your system. This subcommand has been replaced by .sp .ne 2 -.mk .na \fB\fBAD_FORCE\fR\fR .ad @@ -241,45 +214,37 @@ undefined behavior. Upon successful completion, the value returned depends on \fIcmd\fR as follows: .sp .ne 2 -.mk .na \fB\fBA_SHUTDOWN\fR\fR .ad .RS 14n -.rt Never returns. .RE .sp .ne 2 -.mk .na \fB\fBA_REBOOT\fR\fR .ad .RS 14n -.rt Never returns. .RE .sp .ne 2 -.mk .na \fB\fBA_FREEZE\fR\fR .ad .RS 14n -.rt \fB0\fR upon resume. .RE .sp .ne 2 -.mk .na \fB\fBA_REMOUNT\fR\fR .ad .RS 14n -.rt \fB0\fR. .RE @@ -293,80 +258,66 @@ error. The \fBuadmin()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 11n -.rt Suspend is already in progress. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The \fIcmd\fR argument is invalid. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n -.rt Suspend/resume ran out of physical memory. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 11n -.rt Suspend/resume could not allocate enough space on the root file system to store system information. .RE .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt Suspend/resume is not supported on this platform or the command specified by \fIcmd\fR is not allowed. .RE .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 11n -.rt Unable to successfully suspend system. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 11n -.rt The {\fBPRIV_SYS_CONFIG\fR} privilege is not asserted in the effective set of the calling process. .RE @@ -379,13 +330,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp diff --git a/usr/src/man/man2/ulimit.2 b/usr/src/man/man2/ulimit.2 index 00b04e52ff..776bc6a071 100644 --- a/usr/src/man/man2/ulimit.2 +++ b/usr/src/man/man2/ulimit.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 ulimit 2 "1 Feb 2003" "SunOS 5.11" "System Calls" +.TH ULIMIT 2 "Feb 1, 2003" .SH NAME ulimit \- get and set process limits .SH SYNOPSIS @@ -29,12 +29,10 @@ effective in limiting the growth of regular files. Pipes are limited to The \fIcmd\fR values, defined in <\fBulimit.h\fR>, include: .sp .ne 2 -.mk .na \fB\fBUL_GETFSIZE\fR\fR .ad .RS 15n -.rt Return the soft file size limit of the process. The limit is in units of 512-byte blocks and is inherited by child processes. Files of any size can be read. The return value is the integer part of the soft file size limit divided @@ -44,12 +42,10 @@ unspecified. .sp .ne 2 -.mk .na \fB\fBUL_SETFSIZE\fR\fR .ad .RS 15n -.rt Set the hard and soft file size limits for output operations of the process to the value of the second argument, taken as a \fBlong int\fR. Any process may decrease its own hard limit, but only a process with appropriate privileges may @@ -60,23 +56,19 @@ would overflow an \fBrlimit_t\fR, the actual value set is unspecified. .sp .ne 2 -.mk .na \fB\fBUL_GMEMLIM\fR\fR .ad .RS 15n -.rt Get the maximum possible break value (see \fBbrk\fR(2)). .RE .sp .ne 2 -.mk .na \fB\fBUL_GDESLIM\fR\fR .ad .RS 15n -.rt Get the current value of the maximum number of open files per process configured in the system. .RE @@ -93,23 +85,19 @@ limit. Otherwise, \fB\(mi1\fR is returned, the limit is not changed, and The \fBulimit()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIcmd\fR argument is not valid. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 10n -.rt A process that has not asserted {\fBPRIV_SYS_RESOURCE\fR} in its effective set is trying to increase its file size limit. .RE @@ -134,13 +122,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard .TE .SH SEE ALSO diff --git a/usr/src/man/man2/umask.2 b/usr/src/man/man2/umask.2 index 06bd79f838..1976cbab95 100644 --- a/usr/src/man/man2/umask.2 +++ b/usr/src/man/man2/umask.2 @@ -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 umask 2 "28 Dec 1996" "SunOS 5.11" "System Calls" +.TH UMASK 2 "Dec 28, 1996" .SH NAME umask \- set and get file creation mask .SH SYNOPSIS @@ -35,15 +35,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/umount.2 b/usr/src/man/man2/umount.2 index a7f64379c1..8b402558ee 100644 --- a/usr/src/man/man2/umount.2 +++ b/usr/src/man/man2/umount.2 @@ -4,7 +4,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 umount 2 "4 Aug 2008" "SunOS 5.11" "System Calls" +.TH UMOUNT 2 "Aug 4, 2008" .SH NAME umount, umount2 \- unmount a file system .SH SYNOPSIS @@ -35,12 +35,10 @@ additional capability of unmounting file systems even if there are open files active. The \fImflag\fR argument must contain one of the following values: .sp .ne 2 -.mk .na \fB0\fR .ad .RS 12n -.rt Perform a normal unmount that is equivalent to \fBumount()\fR. The \fBumount2()\fR function returns \fBEBUSY\fR if there are open files active within the file system to be unmounted. @@ -48,12 +46,10 @@ within the file system to be unmounted. .sp .ne 2 -.mk .na \fB\fBMS_FORCE\fR\fR .ad .RS 12n -.rt Unmount the file system, even if there are open files active. A forced unmount can result in loss of data, so it should be used only when a regular unmount is unsuccessful. The \fBumount2()\fR function returns \fBENOTSUP\fR if the @@ -72,12 +68,10 @@ returned and \fBerrno\fR is set to indicate the error. The \fBumount()\fR and \fBumount2()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt The permission bits of the mount point do not permit read/write access or search permission is denied on a component of the path prefix. .sp @@ -92,57 +86,47 @@ mounts or read-write access in the case of read/write mounts. .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 16n -.rt A file on \fIfile\fR is busy. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The file pointed to by \fIfile\fR points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The file pointed to by \fIfile\fR is not mounted. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating the path pointed to by \fIfile\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIfile\fR argument exceeds \fIPATH_MAX\fR, or the length of a \fIfile\fR component exceeds \fINAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -150,58 +134,48 @@ in effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The file pointed to by \fIfile\fR does not exist or is not an absolute path. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The file pointed to by \fIfile\fR is on a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTBLK\fR\fR .ad .RS 16n -.rt The file pointed to by \fIfile\fR is not a block special device. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The {\fBPRIV_SYS_MOUNT\fR} privilege is not asserted in the effective set of the calling process. .RE .sp .ne 2 -.mk .na \fB\fBEREMOTE\fR\fR .ad .RS 16n -.rt The file pointed to by \fIfile\fR is remote. .RE @@ -210,12 +184,10 @@ The file pointed to by \fIfile\fR is remote. The \fBumount2()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBENOTSUP\fR\fR .ad .RS 11n -.rt The file pointed to by \fIfile\fR does not support this operation. .RE diff --git a/usr/src/man/man2/uname.2 b/usr/src/man/man2/uname.2 index 29344755c1..3006877357 100644 --- a/usr/src/man/man2/uname.2 +++ b/usr/src/man/man2/uname.2 @@ -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 uname 2 "21 Jul 1999" "SunOS 5.11" "System Calls" +.TH UNAME 2 "Jul 21, 1999" .SH NAME uname \- get name of current operating system .SH SYNOPSIS @@ -53,12 +53,10 @@ Upon successful completion, a non-negative value is returned. Otherwise, The \fBuname()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIname\fR argument points to an illegal address. .RE @@ -70,15 +68,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/unlink.2 b/usr/src/man/man2/unlink.2 index a1459f9fd4..6547d8c797 100644 --- a/usr/src/man/man2/unlink.2 +++ b/usr/src/man/man2/unlink.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 unlink 2 "18 May 2007" "SunOS 5.11" "System Calls" +.TH UNLINK 2 "May 18, 2007" .SH NAME unlink, unlinkat \- remove directory entry .SH SYNOPSIS @@ -90,24 +90,20 @@ unlinked. The \fBunlink()\fR and \fBunlinkat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied for a component of the \fIpath\fR prefix, or write permission is denied on the directory containing the link to be removed. .RE .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt The parent directory has the sticky bit set and the file is not writable by the user, the user does not own the parent directory, the user does not own the file, and the user is not a privileged user. @@ -115,68 +111,56 @@ file, and the user is not a privileged user. .sp .ne 2 -.mk .na \fB\fBEBUSY\fR\fR .ad .RS 16n -.rt The entry to be unlinked is the mount point for a mounted file system. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEILSEQ\fR\fR .ad .RS 16n -.rt The path argument includes non-UTF8 characters and the file system accepts only file names where all characters are part of the UTF-8 character codeset. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fBunlink()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds \fBPATH_MAX\fR, or the length of a \fIpath\fR component exceeds \fBNAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -184,35 +168,29 @@ effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The named file does not exist or is a null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the \fIpath\fR prefix is not a directory or the provided directory descriptor for \fBunlinkat()\fR is not \fBAT_FDCWD\fR or does not reference a directory. @@ -220,12 +198,10 @@ reference a directory. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The named file is a directory and {\fBPRIV_SYS_LINKDIR\fR} is not asserted in the effective set of the calling process, or the filesystem implementation does not support \fBunlink()\fR or \fBunlinkat()\fR on directories. @@ -233,12 +209,10 @@ not support \fBunlink()\fR or \fBunlinkat()\fR on directories. .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The directory entry to be unlinked is part of a read-only file system. .RE @@ -247,24 +221,20 @@ The directory entry to be unlinked is part of a read-only file system. The \fBunlink()\fR and \fBunlinkat()\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt Pathname resolution of a symbolic link produced an intermediate result whose length exceeds {\fBPATH_MAX\fR}. .RE .sp .ne 2 -.mk .na \fB\fBETXTBSY\fR\fR .ad .RS 16n -.rt The entry to be unlinked is the last directory entry to a pure procedure (shared text) file that is being executed. .RE @@ -281,17 +251,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityT{ +Interface Stability T{ \fBunlink()\fR is Standard; \fBunlinkat()\fR is Evolving T} _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/ustat.2 b/usr/src/man/man2/ustat.2 index 4219f7fbbd..7979f64d3e 100644 --- a/usr/src/man/man2/ustat.2 +++ b/usr/src/man/man2/ustat.2 @@ -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 ustat 2 "23 Jul 2001" "SunOS 5.11" "System Calls" +.TH USTAT 2 "Jul 23, 2001" .SH NAME ustat \- get file system statistics .SH SYNOPSIS @@ -48,70 +48,58 @@ returned and \fBerrno\fR is set to indicate the error. The \fBustat()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBECOMM\fR\fR .ad .RS 13n -.rt The \fIdev\fR argument is on a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 13n -.rt The \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 13n -.rt A signal was caught during the execution of the \fBustat()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 13n -.rt The \fIdev\fR argument is not the device number of a device containing a mounted file system. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 13n -.rt The \fIdev\fR argument refers to a device on a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBEOVERFLOW\fR\fR .ad .RS 13n -.rt One of the values returned cannot be represented in the structure pointed to by \fIbuf\fR. .RE diff --git a/usr/src/man/man2/utime.2 b/usr/src/man/man2/utime.2 index 8c91bdd841..e9c7b5827e 100644 --- a/usr/src/man/man2/utime.2 +++ b/usr/src/man/man2/utime.2 @@ -4,7 +4,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 utime 2 "1 Sep 2009" "SunOS 5.11" "System Calls" +.TH UTIME 2 "Sep 1, 2009" .SH NAME utime \- set file access and modification times .SH SYNOPSIS @@ -60,79 +60,65 @@ Upon successful completion, 0 is returned. Otherwise, \(mi1 is returned and The \fButime()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied by a component of the \fIpath\fR prefix. .RE .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt The process does not have appropriate privileges and is not the owner of the file, write permission is denied for the file, and \fItimes\fR is \fINULL\fR. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fButime()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds \fIPATH_MAX\fR, or the length of a \fIpath\fR component exceeds \fINAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in effect. @@ -140,46 +126,38 @@ effect. .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt The named file does not exist or is a null pathname. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the \fIpath\fR prefix is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The effective user of the calling process is not the owner of the file, {\fBPRIV_FILE_OWNER\fR} is not asserted in the effective set of the calling process, and \fItimes\fR is not \fINULL\fR. @@ -187,12 +165,10 @@ process, and \fItimes\fR is not \fINULL\fR. .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The file system containing the file is mounted read-only. .RE @@ -204,17 +180,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/utimes.2 b/usr/src/man/man2/utimes.2 index 57a7e977c3..66241e9709 100644 --- a/usr/src/man/man2/utimes.2 +++ b/usr/src/man/man2/utimes.2 @@ -9,13 +9,13 @@ .\" 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 utimes 2 "1 Sep 2009" "SunOS 5.11" "System Calls" +.TH UTIMES 2 "Sep 1, 2009" .SH NAME utimes, futimesat \- set file access and modification times .SH SYNOPSIS .LP .nf -#include <sys/time.h> +#include <sys/time.h> \fBint\fR \fButimes\fR(\fBconst char *\fR\fIpath\fR, \fBconst struct timeval\fR \fItimes\fR[2]); .fi @@ -70,12 +70,10 @@ be affected. The \fButimes()\fR and \fBfutimesat()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt Search permission is denied by a component of the path prefix; or the \fItimes\fR argument is a null pointer and the effective user \fBID\fR of the process does not match the owner of the file and write access is denied. @@ -83,12 +81,10 @@ process does not match the owner of the file and write access is denied. .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIpath\fR or \fItimes\fR argument points to an illegal address. For \fBfutimesat()\fR, \fIpath\fR might have the value \fINULL\fR if the \fIfildes\fR argument refers to a valid open file descriptor. @@ -96,23 +92,19 @@ The \fIpath\fR or \fItimes\fR argument points to an illegal address. For .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal was caught during the execution of the \fButimes()\fR function. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The number of microseconds specified in one or both of the \fBtimeval\fR structures pointed to by \fItimes\fR was greater than or equal to 1,000,000 or less than 0. @@ -120,70 +112,58 @@ less than 0. .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in resolving \fIpath\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt The length of the \fIpath\fR argument exceeds {\fIPATH_MAX\fR} or a pathname component is longer than {\fINAME_MAX\fR}. .RE .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 16n -.rt The \fIpath\fR argument points to a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of \fIpath\fR does not name an existing file or \fIpath\fR is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix is not a directory or the \fIpath\fR argument is relative and the \fIfildes\fR argument is not \fBAT_FDCWD\fR or does not refer to a valid directory. @@ -191,12 +171,10 @@ to a valid directory. .sp .ne 2 -.mk .na \fB\fBEPERM\fR\fR .ad .RS 16n -.rt The \fItimes\fR argument is not a null pointer and the calling process's effective user \fBID\fR has write access to the file but does not match the owner of the file and the calling process does not have the appropriate @@ -205,12 +183,10 @@ privileges. .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The file system containing the file is read-only. .RE @@ -219,12 +195,10 @@ The file system containing the file is read-only. The \fButimes()\fR and \fBfutimesat()\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt Path name resolution of a symbolic link produced an intermediate result whose length exceeds {\fIPATH_MAX\fR}. .RE @@ -237,15 +211,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -StandardSee below. +Standard See below. .TE .sp diff --git a/usr/src/man/man2/uucopy.2 b/usr/src/man/man2/uucopy.2 index 7b7cfd631a..0fd0bd8cc2 100644 --- a/usr/src/man/man2/uucopy.2 +++ b/usr/src/man/man2/uucopy.2 @@ -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 uucopy 2 "12 Sep 2006" "SunOS 5.11" "System Calls" +.TH UUCOPY 2 "Sep 12, 2006" .SH NAME uucopy \- no-fault memory-to-memory copy .SH SYNOPSIS @@ -38,12 +38,10 @@ returns \(mi1 and set \fBerrno\fR to indicate the error. The \fBuucopy()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt Either the \fIs1\fR or \fIs2\fR arguments points to an illegal address. .RE @@ -55,15 +53,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityEvolving +Interface Stability Evolving _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/vfork.2 b/usr/src/man/man2/vfork.2 index c93b666fc5..beebb68987 100644 --- a/usr/src/man/man2/vfork.2 +++ b/usr/src/man/man2/vfork.2 @@ -2,7 +2,7 @@ .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T. .\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. -.TH vfork 2 "13 Dec 2006" "SunOS 5.11" "System Calls" +.TH VFORK 2 "Dec 13, 2006" .SH NAME vfork, vforkx \- spawn new process in a virtual memory efficient way .SH SYNOPSIS @@ -99,12 +99,10 @@ process is created, and \fBerrno\fR is set to indicate the error. The \fBvfork()\fR and \fBvforkx()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 10n -.rt The system-imposed limit on the total number of processes under execution (either system-quality or by a single user) would be exceeded. This limit is determined when the system is generated. @@ -112,12 +110,10 @@ determined when the system is generated. .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 10n -.rt There is insufficient swap space for the new process. .RE @@ -126,12 +122,10 @@ There is insufficient swap space for the new process. The \fBvforkx()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIflags\fR argument is invalid. .RE @@ -143,15 +137,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityObsolete +Interface Stability Obsolete _ -MT-LevelUnsafe +MT-Level Unsafe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/vhangup.2 b/usr/src/man/man2/vhangup.2 index 6e0875d2a0..c61a84811c 100644 --- a/usr/src/man/man2/vhangup.2 +++ b/usr/src/man/man2/vhangup.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1998, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. -.TH vhangup 2 "19 Mar 1998" "SunOS 5.11" "System Calls" +.TH VHANGUP 2 "Mar 19, 1998" .SH NAME vhangup \- virtually "hangup" the current controlling terminal .SH SYNOPSIS .LP .nf -#include <unistd.h> +#include <unistd.h> \fBvoid\fR \fBvhangup\fR(\fBvoid\fR); .fi diff --git a/usr/src/man/man2/waitid.2 b/usr/src/man/man2/waitid.2 index 914d25ce6a..aceb962439 100644 --- a/usr/src/man/man2/waitid.2 +++ b/usr/src/man/man2/waitid.2 @@ -1,13 +1,13 @@ '\" te .\" Copyright 1989 AT&T. Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 waitid 2 "9 Jun 2004" "SunOS 5.11" "System Calls" +.TH WAITID 2 "Jun 9, 2004" .SH NAME waitid \- wait for child process to change state .SH SYNOPSIS @@ -57,68 +57,56 @@ The \fIoptions\fR argument is used to specify which state changes any of the following flags: .sp .ne 2 -.mk .na \fB\fBWCONTINUED\fR\fR .ad .RS 14n -.rt Return the status for any child that was stopped and has been continued. .RE .sp .ne 2 -.mk .na \fB\fBWEXITED\fR\fR .ad .RS 14n -.rt Wait for process(es) to exit. .RE .sp .ne 2 -.mk .na \fB\fBWNOHANG\fR\fR .ad .RS 14n -.rt Return immediately. .RE .sp .ne 2 -.mk .na \fB\fBWNOWAIT\fR\fR .ad .RS 14n -.rt Keep the process in a waitable state. .RE .sp .ne 2 -.mk .na \fB\fBWSTOPPED\fR\fR .ad .RS 14n -.rt Wait for and return the process status of any child that has stopped upon receipt of a signal. .RE .sp .ne 2 -.mk .na \fB\fBWTRAPPED\fR\fR .ad .RS 14n -.rt Wait for traced process(es) to become trapped or reach a breakpoint (see \fBptrace\fR(3C)). .RE @@ -152,47 +140,39 @@ have changed state if \fBinfo->si_pid\fR is \fB0\fR. The \fBwaitid()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBECHILD\fR\fR .ad .RS 10n -.rt The set of processes specified by \fIidtype\fR and \fIid\fR does not contain any unwaited processes. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIinfop\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 10n -.rt The \fBwaitid()\fR function was interrupted due to the receipt of a signal by the calling process. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt An invalid value was specified for \fIoptions\fR, or \fIidtype\fR and \fIid\fR specify an invalid set of processes. .RE @@ -212,15 +192,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityStandard +Interface Stability Standard _ -MT-LevelAsync-Signal-Safe +MT-Level Async-Signal-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man2/write.2 b/usr/src/man/man2/write.2 index f3a84a7dc7..78309c766a 100644 --- a/usr/src/man/man2/write.2 +++ b/usr/src/man/man2/write.2 @@ -2,14 +2,14 @@ .\" Copyright (c) 2087, Sun Microsystems, Inc. All Rights Reserved. .\" Copyright 1989 AT&T .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. -.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at +.\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at .\" 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. .\" 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 write 2 "29 Jan 2008" "SunOS 5.11" "System Calls" +.TH WRITE 2 "Jan 29, 2008" .SH NAME write, pwrite, writev \- write on a file .SH SYNOPSIS @@ -317,12 +317,10 @@ unchanged, and \fBerrno\fR is set to indicate an error. The \fBwrite()\fR, \fBpwrite()\fR, and \fBwritev()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad .RS 11n -.rt Mandatory file/record locking is set, \fBO_NDELAY\fR or \fBO_NONBLOCK\fR is set, and there is a blocking record lock; an attempt is made to write to a stream that can not accept data with the \fBO_NDELAY\fR or \fBO_NONBLOCK\fR @@ -332,58 +330,48 @@ requested and less than \fInbytes\fR of free space is available. .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is not a valid file descriptor open for writing. .RE .sp .ne 2 -.mk .na \fB\fBEDEADLK\fR\fR .ad .RS 11n -.rt The write was going to go to sleep and cause a deadlock situation to occur. .RE .sp .ne 2 -.mk .na \fB\fBEDQUOT\fR\fR .ad .RS 11n -.rt The user's quota of disk blocks on the file system containing the file has been exhausted. .RE .sp .ne 2 -.mk .na \fB\fBEFBIG\fR\fR .ad .RS 11n -.rt An attempt is made to write a file that exceeds the process's file size limit or the maximum file size (see \fBgetrlimit\fR(2) and \fBulimit\fR(2)). .RE .sp .ne 2 -.mk .na \fB\fBEFBIG\fR\fR .ad .RS 11n -.rt The file is a regular file, \fInbyte\fR is greater than 0, and the starting position is greater than or equal to the offset maximum established in the file description associated with \fIfildes\fR. @@ -391,23 +379,19 @@ description associated with \fIfildes\fR. .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 11n -.rt A signal was caught during the write operation and no data was transferred. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 11n -.rt The process is in the background and is attempting to write to its controlling terminal whose \fBTOSTOP\fR flag is set, or the process is neither ignoring nor blocking \fBSIGTTOU\fR signals and the process group of the process is @@ -416,12 +400,10 @@ orphaned. .sp .ne 2 -.mk .na \fB\fBENOLCK\fR\fR .ad .RS 11n -.rt Enforced record locking was enabled and \fB{LOCK_MAX}\fR regions are already locked in the system, or the system record lock table was full and the write could not go to sleep until the blocking record lock was removed. @@ -429,58 +411,48 @@ could not go to sleep until the blocking record lock was removed. .sp .ne 2 -.mk .na \fB\fBENOLINK\fR\fR .ad .RS 11n -.rt The \fIfildes\fR argument is on a remote machine and the link to that machine is no longer active. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 11n -.rt During a write to an ordinary file, there is no free space left on the device. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt An attempt is made to write to a streams with insufficient streams memory resources available in the system. .RE .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 11n -.rt A hangup occurred on the stream being written to. .RE .sp .ne 2 -.mk .na \fB\fBEPIPE\fR\fR .ad .RS 11n -.rt An attempt is made to write to a pipe or a \fBFIFO\fR that is not open for reading by any process, or that has only one end open (or to a file descriptor created by \fBsocket\fR(3SOCKET), using type \fBSOCK_STREAM\fR that is no @@ -491,12 +463,10 @@ or ignore the signal. .sp .ne 2 -.mk .na \fB\fBERANGE\fR\fR .ad .RS 11n -.rt The transfer request size was outside the range supported by the streams file associated with \fIfildes\fR. .RE @@ -506,23 +476,19 @@ associated with \fIfildes\fR. The \fBwrite()\fR and \fBpwrite()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n -.rt The \fIbuf\fR argument points to an illegal address. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fInbyte\fR argument overflowed an \fBssize_t\fR. .RE @@ -531,12 +497,10 @@ The \fInbyte\fR argument overflowed an \fBssize_t\fR. The \fBpwrite()\fR function fails and the file pointer remains unchanged if: .sp .ne 2 -.mk .na \fB\fBESPIPE\fR\fR .ad .RS 10n -.rt The \fIfildes\fR argument is associated with a pipe or FIFO. .RE @@ -545,36 +509,30 @@ The \fIfildes\fR argument is associated with a pipe or FIFO. The \fBwrite()\fR and \fBwritev()\fR functions may fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The stream or multiplexer referenced by \fIfildes\fR is linked (directly or indirectly) downstream from a multiplexer. .RE .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 10n -.rt A request was made of a non-existent device, or the request was outside the capabilities of the device. .RE .sp .ne 2 -.mk .na \fB\fBENXIO\fR\fR .ad .RS 10n -.rt A hangup occurred on the stream being written to. .RE @@ -588,12 +546,10 @@ error message. The \fBwritev()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n -.rt The \fIiovcnt\fR argument was less than or equal to 0 or greater than {\fBIOV_MAX\fR}; one of the \fBiov_len\fR values in the \fIiov\fR array was negative; or the sum of the \fBiov_len\fR values in the \fIiov\fR array @@ -613,17 +569,16 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityCommitted +Interface Stability Committed _ -MT-Level\fBwrite()\fR is Async-Signal-Safe +MT-Level \fBwrite()\fR is Async-Signal-Safe _ -StandardSee \fBstandards\fR(5). +Standard See \fBstandards\fR(5). .TE .SH SEE ALSO diff --git a/usr/src/man/man2/yield.2 b/usr/src/man/man2/yield.2 index 7aff55f449..fa14fe6d65 100644 --- a/usr/src/man/man2/yield.2 +++ b/usr/src/man/man2/yield.2 @@ -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 yield 2 "20 Jul 1993" "SunOS 5.11" "System Calls" +.TH YIELD 2 "Jul 20, 1993" .SH NAME yield \- yield execution to another lightweight process .SH SYNOPSIS |