diff options
Diffstat (limited to 'usr/src/man/man3xnet')
30 files changed, 264 insertions, 1082 deletions
diff --git a/usr/src/man/man3xnet/accept.3xnet b/usr/src/man/man3xnet/accept.3xnet index d249666b50..79037af1f8 100644 --- a/usr/src/man/man3xnet/accept.3xnet +++ b/usr/src/man/man3xnet/accept.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2003, 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 accept 3XNET "1 Nov 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH ACCEPT 3XNET "Nov 1, 2003" .SH NAME accept \- accept a new connection on a socket .SH SYNOPSIS @@ -15,7 +15,7 @@ accept \- accept a new connection on a socket .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ] #include <sys/socket.h> - + \fBint\fR \fBaccept\fR(\fBint\fR \fIsocket\fR, \fBstruct sockaddr *restrict\fR \fIaddress\fR, \fBsocklen_t *restrict\fR \fIaddress_len\fR); @@ -33,12 +33,10 @@ for that socket. The function takes the following arguments: .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 15n -.rt Specifies a socket that was created with \fBsocket\fR(3XNET), has been bound to an address with \fBbind\fR(3XNET), and has issued a successful call to \fBlisten\fR(3XNET). @@ -46,24 +44,20 @@ an address with \fBbind\fR(3XNET), and has issued a successful call to .sp .ne 2 -.mk .na \fB\fIaddress\fR\fR .ad .RS 15n -.rt Either a null pointer, or a pointer to a \fBsockaddr\fR structure where the address of the connecting socket will be returned. .RE .sp .ne 2 -.mk .na \fB\fIaddress_len\fR\fR .ad .RS 15n -.rt Points to a \fBsocklen_t\fR which on input specifies the length of the supplied \fBsockaddr\fR structure, and on output specifies the length of the stored address. @@ -113,7 +107,6 @@ descriptor of the accepted socket. Otherwise, \(mi1 is returned and The \fBaccept()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad @@ -122,109 +115,90 @@ The \fBaccept()\fR function will fail if: \fB\fBEWOULDBLOCK\fR\fR .ad .RS 16n -.rt O_NONBLOCK is set for the socket file descriptor and no connections are present to be accepted. .RE .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBECONNABORTED\fR\fR .ad .RS 16n -.rt A connection has been aborted. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIaddress\fR or \fIaddress_len\fR parameter can not be accessed or written. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt The \fBaccept()\fR function was interrupted by a signal that was caught before a valid connection arrived. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The \fIsocket\fR is not accepting connections. .RE .sp .ne 2 -.mk .na \fB\fBEMFILE\fR\fR .ad .RS 16n -.rt \fBOPEN_MAX\fR file descriptors are currently open in the calling process. .RE .sp .ne 2 -.mk .na \fB\fBENFILE\fR\fR .ad .RS 16n -.rt The maximum number of file descriptors in the system are already open. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 16n -.rt The socket type of the specified socket does not support accepting connections. .RE @@ -233,45 +207,37 @@ The socket type of the specified socket does not support accepting connections. The \fBaccept()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt No buffer space is available. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n -.rt There was insufficient memory available to complete the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There was insufficient STREAMS resources available to complete the operation. .RE .sp .ne 2 -.mk .na \fB\fBEPROTO\fR\fR .ad .RS 11n -.rt A protocol error has occurred; for example, the STREAMS protocol stack has not been initialized. .RE @@ -284,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 StabilityStandard +Interface Stability Standard _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3xnet/bind.3xnet b/usr/src/man/man3xnet/bind.3xnet index fef4029f2d..45772c3ff8 100644 --- a/usr/src/man/man3xnet/bind.3xnet +++ b/usr/src/man/man3xnet/bind.3xnet @@ -1,14 +1,14 @@ '\" te .\" Copyright (c) 1997, The Open Group. All Rights Reserved. .\" Portions Copyright (c) 2003, 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 bind 3XNET "20 Feb 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH BIND 3XNET "Feb 20, 2003" .SH NAME bind \- bind a name to a socket .SH SYNOPSIS @@ -32,23 +32,19 @@ are identified only by their address family. The function takes the following arguments: .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 15n -.rt Specifies the file descriptor of the socket to be bound. .RE .sp .ne 2 -.mk .na \fB\fIaddress\fR\fR .ad .RS 15n -.rt Points to a \fBsockaddr\fR structure containing the address to be bound to the socket. The length and format of the address depend on the address family of the socket. @@ -56,12 +52,10 @@ the socket. .sp .ne 2 -.mk .na \fB\fIaddress_len\fR\fR .ad .RS 15n -.rt Specifies the length of the \fBsockaddr\fR structure pointed to by the \fIaddress\fR argument. .RE @@ -86,91 +80,75 @@ returned and \fBerrno\fR is set to indicate the error. The \fBbind()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEADDRINUSE\fR\fR .ad .RS 17n -.rt The specified address is already in use. .RE .sp .ne 2 -.mk .na \fB\fBEADDRNOTAVAIL\fR\fR .ad .RS 17n -.rt The specified address is not available from the local machine. .RE .sp .ne 2 -.mk .na \fB\fBEAFNOSUPPORT\fR\fR .ad .RS 17n -.rt The specified address is not a valid address for the address family of the specified socket. .RE .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 17n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 17n -.rt The \fIaddress\fR argument can not be accessed. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 17n -.rt The socket is already bound to an address, and the protocol does not support binding to a new address; or the socket has been shut down. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 17n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 17n -.rt The socket type of the specified socket does not support binding to an address. .RE @@ -179,19 +157,16 @@ The socket type of the specified socket does not support binding to an address. If the address family of the socket is AF_UNIX, then \fBbind()\fR 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 the requested name requires writing in a directory with a mode that denies write permission. .RE .sp .ne 2 -.mk .na \fB\fBEDESTADDRREQ\fR\fR .ad @@ -200,77 +175,64 @@ requires writing in a directory with a mode that denies write permission. \fB\fBEISDIR\fR\fR .ad .RS 16n -.rt The \fIaddress\fR argument is a null pointer. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 16n -.rt An I/O error occurred. .RE .sp .ne 2 -.mk .na \fB\fBELOOP\fR\fR .ad .RS 16n -.rt Too many symbolic links were encountered in translating the pathname in \fIaddress.\fR .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt A component of a pathname exceeded \fINAME_MAX\fR characters, or an entire pathname exceeded \fIPATH_MAX\fR characters. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of the pathname does not name an existing file or the pathname is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix of the pathname in \fIaddress\fR is not a directory. .RE .sp .ne 2 -.mk .na \fB\fBEROFS\fR\fR .ad .RS 16n -.rt The name would reside on a read-only filesystem. .RE @@ -279,69 +241,57 @@ The name would reside on a read-only filesystem. The \fBbind()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 16n -.rt The specified address is protected, and \fB{PRIV_NET_PRIVADOR}\fR is not asserted in the effective set of the current process. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The \fIaddress_len\fR argument is not a valid length for the address family. .RE .sp .ne 2 -.mk .na \fB\fBEISCONN\fR\fR .ad .RS 16n -.rt The socket is already connected. .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 \fIPATH_MAX\fR. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 16n -.rt Insufficient resources were available to complete the call. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 16n -.rt There were insufficient STREAMS resources for the operation to complete. .RE @@ -353,15 +303,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/man3xnet/connect.3xnet b/usr/src/man/man3xnet/connect.3xnet index f56eff4bcd..50c08bb6c2 100644 --- a/usr/src/man/man3xnet/connect.3xnet +++ b/usr/src/man/man3xnet/connect.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright 1994, The X/Open Company Ltd. All Rights Reserved Portions Copyright 1989 AT&T Portions Copyright (c) 1998, 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 connect 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH CONNECT 3XNET "Jun 10, 2002" .SH NAME connect \- connect a socket .SH SYNOPSIS @@ -27,35 +27,29 @@ The \fBconnect()\fR function requests a connection to be made on a socket. The function takes the following arguments: .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 15n -.rt Specifies the file descriptor associated with the socket. .RE .sp .ne 2 -.mk .na \fB\fIaddress\fR\fR .ad .RS 15n -.rt Points to a \fBsockaddr\fR structure containing the peer address. The length and format of the address depend on the address family of the socket. .RE .sp .ne 2 -.mk .na \fB\fIaddress_len\fR\fR .ad .RS 15n -.rt Specifies the length of the \fBsockaddr\fR structure pointed to by the \fIaddress\fR argument. .RE @@ -122,80 +116,66 @@ returned and \fBerrno\fR is set to indicate the error. The \fBconnect()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEADDRNOTAVAIL\fR\fR .ad .RS 17n -.rt The specified address is not available from the local machine. .RE .sp .ne 2 -.mk .na \fB\fBEAFNOSUPPORT\fR\fR .ad .RS 17n -.rt The specified address is not a valid address for the address family of the specified socket. .RE .sp .ne 2 -.mk .na \fB\fBEALREADY\fR\fR .ad .RS 17n -.rt A connection request is already in progress for the specified socket. .RE .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 17n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBECONNREFUSED\fR\fR .ad .RS 17n -.rt The target address was not listening for connections or refused the connection request. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 17n -.rt The address parameter can not be accessed. .RE .sp .ne 2 -.mk .na \fB\fBEINPROGRESS\fR\fR .ad .RS 17n -.rt O_NONBLOCK is set for the file descriptor for the socket and the connection cannot be immediately established; the connection will be established asynchronously. @@ -203,69 +183,57 @@ asynchronously. .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 17n -.rt The attempt to establish a connection was interrupted by delivery of a signal that was caught; the connection will be established asynchronously. .RE .sp .ne 2 -.mk .na \fB\fBEISCONN\fR\fR .ad .RS 17n -.rt The specified socket is connection-mode and is already connected. .RE .sp .ne 2 -.mk .na \fB\fBENETUNREACH\fR\fR .ad .RS 17n -.rt No route to the network is present. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 17n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEPROTOTYPE\fR\fR .ad .RS 17n -.rt The specified address has a different type than the socket bound to the specified peer address. .RE .sp .ne 2 -.mk .na \fB\fBETIMEDOUT\fR\fR .ad .RS 17n -.rt The attempt to connect timed out before a connection was made. .RE @@ -275,59 +243,49 @@ If the address family of the socket is AF_UNIX, then \fBconnect()\fR will fail if: .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 the pathname in \fIaddress\fR. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt A component of a pathname exceeded \fINAME_MAX\fR characters, or an entire pathname exceeded \fIPATH_MAX\fR characters. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of the pathname does not name an existing file or the pathname is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix of the pathname in \fIaddress\fR is not a directory. .RE @@ -337,115 +295,95 @@ directory. The \fBconnect()\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; or write access to the named socket is denied. .RE .sp .ne 2 -.mk .na \fB\fBEADDRINUSE\fR\fR .ad .RS 16n -.rt Attempt to establish a connection that uses addresses that are already in use. .RE .sp .ne 2 -.mk .na \fB\fBECONNRESET\fR\fR .ad .RS 16n -.rt Remote host reset the connection request. .RE .sp .ne 2 -.mk .na \fB\fBEHOSTUNREACH\fR\fR .ad .RS 16n -.rt The destination host cannot be reached (probably because the host is down or a remote router cannot reach it). .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The \fIaddress_len\fR argument is not a valid length for the address family; or invalid address family in sockaddr structure. .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 \fIPATH_MAX\fR. .RE .sp .ne 2 -.mk .na \fB\fBENETDOWN\fR\fR .ad .RS 16n -.rt The local interface used to reach the destination is down. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 16n -.rt No buffer space is available. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 16n -.rt There were insufficient STREAMS resources available to complete the operation. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 16n -.rt The socket is listening and can not be connected. .RE @@ -457,15 +395,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/man3xnet/endhostent.3xnet b/usr/src/man/man3xnet/endhostent.3xnet index aa0163845d..e0564e869c 100644 --- a/usr/src/man/man3xnet/endhostent.3xnet +++ b/usr/src/man/man3xnet/endhostent.3xnet @@ -1,14 +1,14 @@ '\" te .\" Copyright (c) 1997, The Open Group. All Rights Reserved. .\" Portions Copyright (c) 2003, 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 endhostent 3XNET "1 Nov 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH ENDHOSTENT 3XNET "Nov 1, 2003" .SH NAME endhostent, gethostbyaddr, gethostbyname, gethostent, sethostent \- network host database functions @@ -114,23 +114,19 @@ following cases, setting \fIh_errno\fR to the value shown in the list below. Any changes to \fBerrno\fR are unspecified. .sp .ne 2 -.mk .na \fB\fBHOST_NOT_FOUND\fR\fR .ad .RS 18n -.rt No such host is known. .RE .sp .ne 2 -.mk .na \fB\fBNO_DATA\fR\fR .ad .RS 18n -.rt The server recognised the request and the name but no address is available. Another type of request to the name server for the domain might return an answer. @@ -138,23 +134,19 @@ answer. .sp .ne 2 -.mk .na \fB\fBNO_RECOVERY\fR\fR .ad .RS 18n -.rt An unexpected server failure occurred which can not be recovered. .RE .sp .ne 2 -.mk .na \fB\fBTRY_AGAIN\fR\fR .ad .RS 18n -.rt A temporary and possibly transient error occurred, such as a failure of a server to respond. .RE @@ -167,15 +159,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/man3xnet/endnetent.3xnet b/usr/src/man/man3xnet/endnetent.3xnet index a725e5323e..b0dee51d17 100644 --- a/usr/src/man/man3xnet/endnetent.3xnet +++ b/usr/src/man/man3xnet/endnetent.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 endnetent 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH ENDNETENT 3XNET "Jun 10, 2002" .SH NAME endnetent, getnetbyaddr, getnetbyname, getnetent, setnetent \- network database functions @@ -16,7 +16,7 @@ functions .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ] #include <netdb.h> - + \fBvoid\fR \fBendnetent\fR(\fBvoid);struct netent *getnetbyaddr(in_addr_t\fR \fInet\fR, \fBint\fR \fItype\fR); .fi @@ -96,15 +96,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/man3xnet/endprotoent.3xnet b/usr/src/man/man3xnet/endprotoent.3xnet index 7b0db69f0b..39288cabf8 100644 --- a/usr/src/man/man3xnet/endprotoent.3xnet +++ b/usr/src/man/man3xnet/endprotoent.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 endprotoent 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH ENDPROTOENT 3XNET "Jun 10, 2002" .SH NAME endprotoent, getprotobynumber, getprotobyname, getprotoent, setprotoent \- network protocol database functions @@ -15,7 +15,7 @@ network protocol database functions .LP .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ] -#include <netdb.h> +#include <netdb.h> \fBvoid\fR \fBendprotoent\fR(void) .fi @@ -101,15 +101,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/man3xnet/endservent.3xnet b/usr/src/man/man3xnet/endservent.3xnet index a93b8a57a6..aca565db44 100644 --- a/usr/src/man/man3xnet/endservent.3xnet +++ b/usr/src/man/man3xnet/endservent.3xnet @@ -1,14 +1,14 @@ '\" te -.\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved +.\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (C) 2002, 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 endservent 3XNET "14 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH ENDSERVENT 3XNET "Jun 14, 2002" .SH NAME endservent, getservbyport, getservbyname, getservent, setservent \- network services database functions @@ -16,7 +16,7 @@ services database functions .LP .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ] -#include <netdb.h> +#include <netdb.h> \fBvoid\fR \fBendservent\fR(void) .fi @@ -110,15 +110,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/man3xnet/freeaddrinfo.3xnet b/usr/src/man/man3xnet/freeaddrinfo.3xnet index 36079f87fa..c9bbdd7237 100644 --- a/usr/src/man/man3xnet/freeaddrinfo.3xnet +++ b/usr/src/man/man3xnet/freeaddrinfo.3xnet @@ -1,14 +1,14 @@ '\" te .\" Copyright (c) 2001, the Institute of Electrical and Electronics Engineers, Inc. and The Open Group. All Rights Reserved. .\" Portions Copyright (c) 2003, 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 freeaddrinfo 3XNET "1 Nov 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH FREEADDRINFO 3XNET "Nov 1, 2003" .SH NAME freeaddrinfo, getaddrinfo \- get address information .SH SYNOPSIS @@ -205,113 +205,93 @@ structures. The \fBgetaddrinfo()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAI_AGAIN\fR\fR .ad .RS 16n -.rt The name could not be resolved at this time. Future attempts might succeed. .RE .sp .ne 2 -.mk .na \fB\fBEAI_BADFLAGS\fR\fR .ad .RS 16n -.rt The \fBai_flags\fR member of the \fBaddrinfo\fR structure had an invalid value. .RE .sp .ne 2 -.mk .na \fB\fBEAI_FAIL\fR\fR .ad .RS 16n -.rt A non-recoverable error occurred when attempting to resolve the name. .RE .sp .ne 2 -.mk .na \fB\fBEAI_FAMILY\fR\fR .ad .RS 16n -.rt The address family was not recognized. .RE .sp .ne 2 -.mk .na \fB\fBEAI_MEMORY\fR\fR .ad .RS 16n -.rt There was a memory allocation failure when trying to allocate storage for the return value. .RE .sp .ne 2 -.mk .na \fB\fBEAI_NONAME\fR\fR .ad .RS 16n -.rt he name does not resolve for the supplied parameters. Neither \fInodename\fR nor \fIservname\fR were supplied. At least one of these must be supplied. .RE .sp .ne 2 -.mk .na \fB\fBEAI_SERVICE\fR\fR .ad .RS 16n -.rt The service passed was not recognized for the specified socket type. .RE .sp .ne 2 -.mk .na \fB\fBEAI_SOCKTYPE\fR\fR .ad .RS 16n -.rt The intended socket type was not recognized. .RE .sp .ne 2 -.mk .na \fB\fBEAI_SYSTEM\fR\fR .ad .RS 16n -.rt A system error occurred. The error code can be found in \fBerrno\fR. .RE .sp .ne 2 -.mk .na \fB\fBEAI_OVERFLOW\fR\fR .ad .RS 16n -.rt An argument buffer overflowed. .RE @@ -334,15 +314,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/man3xnet/gai_strerror.3xnet b/usr/src/man/man3xnet/gai_strerror.3xnet index 948afb09dd..f4f632256e 100644 --- a/usr/src/man/man3xnet/gai_strerror.3xnet +++ b/usr/src/man/man3xnet/gai_strerror.3xnet @@ -1,14 +1,14 @@ '\" te .\" Copyright (c) 2001, the Institute of Electrical and Electronics Engineers, Inc. and The Open Group. All Rights Reserved. .\" Portions Copyright (c) 2003, 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 gai_strerror 3XNET "1 Dec 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH GAI_STRERROR 3XNET "Dec 1, 2003" .SH NAME gai_strerror \- address and name information error description .SH SYNOPSIS @@ -32,101 +32,83 @@ When the \fIecode\fR argument is one of the following values listed in the <\fBnetdb.h\fR> header: .sp .ne 2 -.mk .na \fB\fBEAI_AGAIN\fR\fR .ad .RS 16n -.rt - + .RE .sp .ne 2 -.mk .na \fB\fBEAI_BADFLAGS\fR\fR .ad .RS 16n -.rt - + .RE .sp .ne 2 -.mk .na \fB\fBEAI_FAIL\fR\fR .ad .RS 16n -.rt - + .RE .sp .ne 2 -.mk .na \fB\fBEAI_FAMILY\fR\fR .ad .RS 16n -.rt - + .RE .sp .ne 2 -.mk .na \fB\fBEAI_MEMORY\fR\fR .ad .RS 16n -.rt - + .RE .sp .ne 2 -.mk .na \fB\fBEAI_NONAME\fR\fR .ad .RS 16n -.rt - + .RE .sp .ne 2 -.mk .na \fB\fBEAI_SERVICE\fR\fR .ad .RS 16n -.rt - + .RE .sp .ne 2 -.mk .na \fB\fBEAI_SOCKTYPE\fR\fR .ad .RS 16n -.rt - + .RE .sp .ne 2 -.mk .na \fB\fBEAI_SYSTEM\fR\fR .ad .RS 16n -.rt - + .RE .sp @@ -151,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 StabilityStandard +Interface Stability Standard _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3xnet/gethostname.3xnet b/usr/src/man/man3xnet/gethostname.3xnet index f2d192fd29..abc3d31668 100644 --- a/usr/src/man/man3xnet/gethostname.3xnet +++ b/usr/src/man/man3xnet/gethostname.3xnet @@ -1,20 +1,20 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 gethostname 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH GETHOSTNAME 3XNET "Jun 10, 2002" .SH NAME gethostname \- get name of current host .SH SYNOPSIS .LP .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ] -#include <unistd.h> +#include <unistd.h> \fBint\fR \fBgethostname\fR(\fBchar *\fR\fIname\fR, \fBsize_t\fR \fInamelen\fR); .fi @@ -47,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-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3xnet/getnameinfo.3xnet b/usr/src/man/man3xnet/getnameinfo.3xnet index 99b3ec6466..60cef94c6c 100644 --- a/usr/src/man/man3xnet/getnameinfo.3xnet +++ b/usr/src/man/man3xnet/getnameinfo.3xnet @@ -1,14 +1,14 @@ '\" te .\" Copyright (c) 2001, the Institute of Electrical and Electronics Engineers, Inc. and The Open Group. All Rights Reserved. .\" Portions Copyright (c) 2003, 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 getnameinfo 3XNET "1 Nov 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH GETNAMEINFO 3XNET "Nov 1, 2003" .SH NAME getnameinfo \- get name information .SH SYNOPSIS @@ -110,68 +110,56 @@ null-terminated strings. The \fBgetnameinfo()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAI_AGAIN\fR\fR .ad .RS 16n -.rt The name could not be resolved at this time. Future attempts might succeed. .RE .sp .ne 2 -.mk .na \fB\fBEAI_BADFLAGS\fR\fR .ad .RS 16n -.rt The \fIflags\fR argument had an invalid value. .RE .sp .ne 2 -.mk .na \fB\fBEAI_FAIL\fR\fR .ad .RS 16n -.rt A non-recoverable error occurred. .RE .sp .ne 2 -.mk .na \fB\fBEAI_FAMILY\fR\fR .ad .RS 16n -.rt The address family was not recognized or the address length was invalid for the specified family. .RE .sp .ne 2 -.mk .na \fB\fBEAI_MEMORY\fR\fR .ad .RS 16n -.rt There was a memory allocation failure. .RE .sp .ne 2 -.mk .na \fB\fBEAI_NONAME\fR\fR .ad .RS 16n -.rt The name does not resolve for the supplied parameters. \fBNI_NAMEREQD\fR is set and the host's name cannot be located, or both \fInodename\fR and \fIservname\fR were \fINULL\fR. @@ -179,12 +167,10 @@ is set and the host's name cannot be located, or both \fInodename\fR and .sp .ne 2 -.mk .na \fB\fBEAI_SYSTEM\fR\fR .ad .RS 16n -.rt A system error occurred. The error code can be found in \fBerrno\fR. .RE @@ -207,15 +193,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/man3xnet/getpeername.3xnet b/usr/src/man/man3xnet/getpeername.3xnet index f11deeec9a..ed96bd2bf2 100644 --- a/usr/src/man/man3xnet/getpeername.3xnet +++ b/usr/src/man/man3xnet/getpeername.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 getpeername 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH GETPEERNAME 3XNET "Jun 10, 2002" .SH NAME getpeername \- get the name of the peer socket .SH SYNOPSIS @@ -47,68 +47,56 @@ Upon successful completion, 0 is returned. Otherwise, \(mi1 is returned and The \fBgetpeername()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 14n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 14n -.rt The \fIaddress\fR or \fIaddress_len\fR parameter can not be accessed or written. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 14n -.rt The socket has been shut down. .RE .sp .ne 2 -.mk .na \fB\fBENOTCONN\fR\fR .ad .RS 14n -.rt The socket is not connected or otherwise has not had the peer prespecified. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 14n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 14n -.rt The operation is not supported for the socket protocol. .RE @@ -117,23 +105,19 @@ The operation is not supported for the socket protocol. The \fBgetpeername()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources were available in the system to complete the call. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -146,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 StabilityStandard +Interface Stability Standard _ -MT-LevelMT-Safe +MT-Level MT-Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3xnet/getsockname.3xnet b/usr/src/man/man3xnet/getsockname.3xnet index 5cafb17832..9afeb8cb07 100644 --- a/usr/src/man/man3xnet/getsockname.3xnet +++ b/usr/src/man/man3xnet/getsockname.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 getsockname 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH GETSOCKNAME 3XNET "Jun 10, 2002" .SH NAME getsockname \- get the socket name .SH SYNOPSIS @@ -48,46 +48,38 @@ indicate the error. The \fBgetsockname()\fR function will fail: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 14n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 14n -.rt The \fIaddress\fR or \fIaddress_len\fR parameter can not be accessed or written. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 14n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 14n -.rt The operation is not supported for this socket's protocol. .RE @@ -96,34 +88,28 @@ The operation is not supported for this socket's protocol. The \fBgetsockname()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The socket has been shut down. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources were available in the system to complete the call. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -136,15 +122,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/man3xnet/getsockopt.3xnet b/usr/src/man/man3xnet/getsockopt.3xnet index dd3528b654..48ea7719fe 100644 --- a/usr/src/man/man3xnet/getsockopt.3xnet +++ b/usr/src/man/man3xnet/getsockopt.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. Portions Copyright (c) 2007, 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 getsockopt 3XNET "21 Jan 2007" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH GETSOCKOPT 3XNET "Jan 21, 2007" .SH NAME getsockopt \- get the socket options .SH SYNOPSIS @@ -49,36 +49,30 @@ The \fIoption_name\fR argument specifies a single option to be retrieved. It can be one of the following values defined in \fB<sys/socket.h>\fR: .sp .ne 2 -.mk .na \fB\fBSO_DEBUG\fR\fR .ad .RS 17n -.rt Reports whether debugging information is being recorded. This option stores an \fBint\fR value. This is a boolean option. .RE .sp .ne 2 -.mk .na \fB\fBSO_ACCEPTCONN\fR\fR .ad .RS 17n -.rt Reports whether socket listening is enabled. This option stores an \fBint\fR value. .RE .sp .ne 2 -.mk .na \fB\fBSO_BROADCAST\fR\fR .ad .RS 17n -.rt Reports whether transmission of broadcast messages is supported, if this is supported by the protocol. This option stores an \fBint\fR value. This is a boolean option. @@ -86,12 +80,10 @@ boolean option. .sp .ne 2 -.mk .na \fB\fBSO_REUSEADDR\fR\fR .ad .RS 17n -.rt Reports whether the rules used in validating addresses supplied to \fBbind\fR(3XNET) should allow reuse of local addresses, if this is supported by the protocol. This option stores an \fBint\fR value. This is a boolean @@ -100,12 +92,10 @@ option. .sp .ne 2 -.mk .na \fB\fBSO_KEEPALIVE\fR\fR .ad .RS 17n -.rt Reports whether connections are kept active with periodic transmission of messages, if this is supported by the protocol. .sp @@ -118,12 +108,10 @@ This is a boolean option. .sp .ne 2 -.mk .na \fB\fBSO_LINGER\fR\fR .ad .RS 17n -.rt Reports whether the socket lingers on \fBclose\fR(2) if data is present. If \fBSO_LINGER\fR is set, the system blocks the process during \fBclose\fR(2) until it can transmit the data or until the end of the interval indicated by @@ -135,12 +123,10 @@ a \fBlinger\fR structure. .sp .ne 2 -.mk .na \fB\fBSO_OOBINLINE\fR\fR .ad .RS 17n -.rt Reports whether the socket leaves received out-of-band data (data marked urgent) in line. This option stores an \fBint\fR value. This is a boolean option. @@ -148,57 +134,47 @@ option. .sp .ne 2 -.mk .na \fB\fBSO_SNDBUF\fR\fR .ad .RS 17n -.rt Reports send buffer size information. This option stores an \fBint\fR value. .RE .sp .ne 2 -.mk .na \fB\fBSO_RCVBUF\fR\fR .ad .RS 17n -.rt Reports receive buffer size information. This option stores an \fBint\fR value. .RE .sp .ne 2 -.mk .na \fB\fBSO_ERROR\fR\fR .ad .RS 17n -.rt Reports information about error status and clears it. This option stores an \fBint\fR value. .RE .sp .ne 2 -.mk .na \fB\fBSO_TYPE\fR\fR .ad .RS 17n -.rt Reports the socket type. This option stores an \fBint\fR value. .RE .sp .ne 2 -.mk .na \fB\fBSO_DONTROUTE\fR\fR .ad .RS 17n -.rt Reports whether outgoing messages bypass the standard routing facilities. The destination must be on a directly-connected network, and messages are directed to the appropriate network interface according to the destination address. The @@ -208,12 +184,10 @@ stores an \fBint\fR value. This is a boolean option. .sp .ne 2 -.mk .na \fB\fBSO_MAC_EXEMPT\fR\fR .ad .RS 17n -.rt Gets the mandatory access control status of the socket. A socket that has this option enabled can communicate with an unlabeled peer if the socket is in the global zone or has a label that dominates the default label of the peer. @@ -224,12 +198,10 @@ available only when the system is configured with Trusted Extensions. .sp .ne 2 -.mk .na \fB\fBSO_ALLZONES\fR\fR .ad .RS 17n -.rt Bypasses zone boundaries (privileged). This option stores an \fBint\fR value. This is a boolean option. .sp @@ -253,23 +225,19 @@ privilege. See \fBzones\fR(5). .sp .ne 2 -.mk .na \fB\fBSO_DOMAIN\fR\fR .ad .RS 17n -.rt get the domain used in the socket (get only) .RE .sp .ne 2 -.mk .na \fB\fBSO_PROTOTYPE\fR\fR .ad .RS 17n -.rt for socket in domains \fBAF_INET\fR and \fBAF_INET6\fR, get the underlying protocol number used in the socket. For socket in domain \fBAF_ROUTE\fR, get the address family used in the socket. @@ -297,57 +265,47 @@ Upon successful completion, \fBgetsockopt()\fR returns \fB0\fR. Otherwise, The \fBgetsockopt()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 15n -.rt The \fIoption_value\fR or \fIoption_len\fR parameter can not be accessed or written. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 15n -.rt The specified option is invalid at the specified socket level. .RE .sp .ne 2 -.mk .na \fB\fBENOPROTOOPT\fR\fR .ad .RS 15n -.rt The option is not supported by the protocol. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument does not refer to a socket. .RE @@ -356,45 +314,37 @@ The \fIsocket\fR argument does not refer to a socket. The \fBgetsockopt()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 11n -.rt The calling process does not have the appropriate privileges. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The socket has been shut down. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources are available in the system to complete the call. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -407,15 +357,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/man3xnet/htonl.3xnet b/usr/src/man/man3xnet/htonl.3xnet index da3eec9086..aa8470a28e 100644 --- a/usr/src/man/man3xnet/htonl.3xnet +++ b/usr/src/man/man3xnet/htonl.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 htonl 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH HTONL 3XNET "Jun 10, 2002" .SH NAME htonl, htons, ntohl, ntohs \- convert values between host and network byte order @@ -16,7 +16,7 @@ order .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ] #include <arpa/inet.h> - + \fBuint32_t\fR \fBhtonl\fR(\fBuint32_t\fR \fIhostlong\fR); .fi @@ -74,15 +74,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/man3xnet/if_nametoindex.3xnet b/usr/src/man/man3xnet/if_nametoindex.3xnet index ea7c233c5f..f5acc96cc4 100644 --- a/usr/src/man/man3xnet/if_nametoindex.3xnet +++ b/usr/src/man/man3xnet/if_nametoindex.3xnet @@ -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 if_nametoindex 3XNET "14 Dec 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH IF_NAMETOINDEX 3XNET "Dec 14, 2003" .SH NAME if_nametoindex, if_indextoname, if_nameindex, if_freenameindex \- functions to map Internet Protocol network interface names and interface indexes @@ -38,34 +38,28 @@ map Internet Protocol network interface names and interface indexes These functions support the following parameters: .sp .ne 2 -.mk .na \fB\fIifname\fR\fR .ad .RS 11n -.rt interface name .RE .sp .ne 2 -.mk .na \fB\fIifindex\fR\fR .ad .RS 11n -.rt interface index .RE .sp .ne 2 -.mk .na \fB\fIptr\fR\fR .ad .RS 11n -.rt pointer returned by \fBif_nameindex()\fR .RE @@ -86,12 +80,10 @@ the specified index is returned. \fBIF_NAMESIZE\fR is defined in the interface name. .sp .ne 2 -.mk .na \fB\fBif_nametoindex()\fR\fR .ad .RS 22n -.rt The \fBif_nametoindex()\fR function returns the interface index corresponding to the interface name pointed to by the \fIifname\fR pointer. If the specified interface name does not exist, the return value is \fB0\fR, and \fIerrno\fR is @@ -102,12 +94,10 @@ example, \fBENOMEM\fR. .sp .ne 2 -.mk .na \fB\fBif_indextoname()\fR\fR .ad .RS 22n -.rt The \fBif_indextoname()\fR function maps an interface index into its corresponding name. This pointer is also the return value of the function. If there is no interface corresponding to the specified index, \fBNULL\fR is @@ -118,12 +108,10 @@ such as running out of memory, \fBif_indextoname()\fR returns \fBNULL\fR and .sp .ne 2 -.mk .na \fB\fB*if_nameindex()\fR\fR .ad .RS 22n -.rt The \fBif_nameindex()\fR function returns an array of \fBif_nameindex\fR structures, one structure per interface. The \fBif_nameindex\fR structure holds the information about a single interface and is defined when the @@ -131,10 +119,10 @@ the information about a single interface and is defined when the .sp .in +2 .nf -struct if_nameindex { - unsigned int if_index; /* 1, 2, ... */ +struct if_nameindex { + unsigned int if_index; /* 1, 2, ... */ char *if_name; /* null terminated name: "eri0", ... */ -}; +}; .fi .in -2 @@ -148,12 +136,10 @@ by the \fBif_freenameindex()\fR function. .sp .ne 2 -.mk .na \fB\fBif_freenameindex()\fR\fR .ad .RS 22n -.rt The \fBif_freenameindex()\fR function frees the dynamic memory that was allocated by \fBif_nameindex()\fR. The argument to this function must be a pointer that was returned by \fBif_nameindex()\fR. @@ -167,15 +153,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/man3xnet/inet_addr.3xnet b/usr/src/man/man3xnet/inet_addr.3xnet index 6a271627c1..c203cc989a 100644 --- a/usr/src/man/man3xnet/inet_addr.3xnet +++ b/usr/src/man/man3xnet/inet_addr.3xnet @@ -1,14 +1,14 @@ '\" te -.\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved +.\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved .\" Portions Copyright (c) 2000, 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 inet_addr 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH INET_ADDR 3XNET "Jun 10, 2002" .SH NAME inet_addr, inet_network, inet_makeaddr, inet_lnaof, inet_netof, inet_ntoa \- Internet address manipulation @@ -16,7 +16,7 @@ Internet address manipulation .LP .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ] -#include <arpa/inet.h> +#include <arpa/inet.h> \fBin_addr_t\fR \fBinet_addr\fR(\fBconst char *\fR\fIcp\fR); .fi @@ -83,24 +83,20 @@ to right). Values specified using dot notation take one of the following forms: .sp .ne 2 -.mk .na \fB\fBa.b.c.d\fR\fR .ad .RS 11n -.rt When four parts are specified, each is interpreted as a byte of data and assigned, from left to right, to the four bytes of an Internet address. .RE .sp .ne 2 -.mk .na \fB\fBa.b.c\fR\fR .ad .RS 11n -.rt When a three-part address is specified, the last part is interpreted as a 16-bit quantity and placed in the rightmost two bytes of the network address. This makes the three-part address format convenient for specifying Class B @@ -109,12 +105,10 @@ network addresses as \fB128.\fR\fInet\fR.\fIhost\fR. .sp .ne 2 -.mk .na \fB\fBa.b\fR\fR .ad .RS 11n -.rt When a two-part address is supplied, the last part is interpreted as a 24-bit quantity and placed in the rightmost three bytes of the network address. This makes the two-part address format convenient for specifying Class A network @@ -123,12 +117,10 @@ addresses as \fInet\fR\fB\&.\fR\fIhost\fR. .sp .ne 2 -.mk .na \fB\fBa\fR\fR .ad .RS 11n -.rt When only one part is given, the value is stored directly in the network address without any byte rearrangement. .RE @@ -178,15 +170,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/man3xnet/inet_ntop.3xnet b/usr/src/man/man3xnet/inet_ntop.3xnet index f44995dd32..f168115af6 100644 --- a/usr/src/man/man3xnet/inet_ntop.3xnet +++ b/usr/src/man/man3xnet/inet_ntop.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 2001, The IEEE and The Open Group. All Rights Reserved. Portions Copyright (c) 2003, 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 inet_ntop 3XNET "1 Nov 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH INET_NTOP 3XNET "Nov 1, 2003" .SH NAME inet_ntop, inet_pton \- convert IPv4 and IPv6 addresses between binary and text form @@ -116,23 +116,19 @@ argument is unknown. The \fBinet_ntop()\fR and \fBinet_pton()\fR functions will fail if: .sp .ne 2 -.mk .na \fB\fBEAFNOSUPPORT\fR\fR .ad .RS 16n -.rt The \fIaf\fR argument is invalid. .RE .sp .ne 2 -.mk .na \fB\fBENOSPC\fR\fR .ad .RS 16n -.rt The size of the \fBinet_ntop()\fR result buffer is inadequate. .RE @@ -144,15 +140,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/man3xnet/listen.3xnet b/usr/src/man/man3xnet/listen.3xnet index ca7bad4058..9bc7b097dc 100644 --- a/usr/src/man/man3xnet/listen.3xnet +++ b/usr/src/man/man3xnet/listen.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 listen 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH LISTEN 3XNET "Jun 10, 2002" .SH NAME listen \- listen for socket connections and limit the queue of incoming connections @@ -57,57 +57,47 @@ returned and \fBerrno\fR is set to indicate the error. The \fBlisten()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEDESTADDRREQ\fR\fR .ad .RS 16n -.rt The socket is not bound to a local address, and the protocol does not support listening on an unbound socket. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The \fIsocket\fR is already connected. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 16n -.rt The socket protocol does not support \fBlisten()\fR. .RE @@ -116,34 +106,28 @@ The socket protocol does not support \fBlisten()\fR. The \fBlisten()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 11n -.rt The calling process does not have the appropriate privileges. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 11n -.rt The \fIsocket\fR has been shut down. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources are available in the system to complete the call. .RE @@ -155,15 +139,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/man3xnet/recv.3xnet b/usr/src/man/man3xnet/recv.3xnet index 271c7a8cc7..ed8488e9c8 100644 --- a/usr/src/man/man3xnet/recv.3xnet +++ b/usr/src/man/man3xnet/recv.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 recv 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH RECV 3XNET "Jun 10, 2002" .SH NAME recv \- receive a message from a connected socket .SH SYNOPSIS @@ -28,80 +28,66 @@ it does not permit the application to retrieve the source address of received data. The function takes the following arguments: .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 10n -.rt Specifies the socket file descriptor. .RE .sp .ne 2 -.mk .na \fB\fIbuffer\fR\fR .ad .RS 10n -.rt Points to a buffer where the message should be stored. .RE .sp .ne 2 -.mk .na \fB\fIlength\fR\fR .ad .RS 10n -.rt Specifies the length in bytes of the buffer pointed to by the \fIbuffer\fR argument. .RE .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 10n -.rt Specifies the type of message reception. Values of this argument are formed by logically OR'ing zero or more of the following values: .sp .ne 2 -.mk .na \fBMSG_PEEK\fR .ad .RS 15n -.rt Peeks at an incoming message. The data is treated as unread and the next \fBrecv()\fR or similar function will still return this data. .RE .sp .ne 2 -.mk .na \fBMSG_OOB\fR .ad .RS 15n -.rt Requests out-of-band data. The significance and semantics of out-of-band data are protocol-specific. .RE .sp .ne 2 -.mk .na \fBMSG_WAITALL\fR .ad .RS 15n -.rt Requests that the function block until the full amount of data requested can be returned. The function may return a smaller amount of data if a signal is caught, if the connection is terminated, if \fBMSG_PEEK\fR was specified, or @@ -153,7 +139,6 @@ an orderly shutdown, \fBrecv()\fR returns 0. Otherwise, -1 is returned and The \fBrecv()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR \fR .ad @@ -162,7 +147,6 @@ The \fBrecv()\fR function will fail if: \fB\fBEWOULDBLOCK\fR\fR .ad .RS 15n -.rt The socket's file descriptor is marked \fBO_NONBLOCK\fR and no data is waiting to be received; or \fBMSG_OOB\fR is set and no out-of-band data is available and either the socket's file descriptor is marked \fBO_NONBLOCK\fR or the @@ -171,101 +155,83 @@ socket does not support blocking to await out-of-band data. .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBECONNRESET\fR\fR .ad .RS 15n -.rt A connection was forcibly closed by a peer. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 15n -.rt The \fIbuffer\fR parameter can not be accessed or written. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 15n -.rt The \fBrecv()\fR function was interrupted by a signal that was caught, before any data was available. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 15n -.rt The \fBMSG_OOB\fR flag is set and no out-of-band data is available. .RE .sp .ne 2 -.mk .na \fB\fBENOTCONN\fR\fR .ad .RS 15n -.rt A receive is attempted on a connection-mode socket that is not connected. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 15n -.rt The specified flags are not supported for this socket type or protocol. .RE .sp .ne 2 -.mk .na \fB\fBETIMEDOUT\fR\fR .ad .RS 15n -.rt The connection timed out during connection establishment, or due to a transmission timeout on active connection. .RE @@ -275,45 +241,37 @@ transmission timeout on active connection. The \fBrecv()\fR function may fail if: .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\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources were available in the system to perform the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n -.rt Insufficient memory was available to fulfill the request. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -326,15 +284,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/man3xnet/recvfrom.3xnet b/usr/src/man/man3xnet/recvfrom.3xnet index a7d20e2c14..2d1eec2fcc 100644 --- a/usr/src/man/man3xnet/recvfrom.3xnet +++ b/usr/src/man/man3xnet/recvfrom.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 recvfrom 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH RECVFROM 3XNET "Jun 10, 2002" .SH NAME recvfrom \- receive a message from a socket .SH SYNOPSIS @@ -33,80 +33,66 @@ received data. The function takes the following arguments: .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 15n -.rt Specifies the socket file descriptor. .RE .sp .ne 2 -.mk .na \fB\fIbuffer\fR\fR .ad .RS 15n -.rt Points to the buffer where the message should be stored. .RE .sp .ne 2 -.mk .na \fB\fIlength\fR\fR .ad .RS 15n -.rt Specifies the length in bytes of the buffer pointed to by the \fIbuffer\fR argument. .RE .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 15n -.rt Specifies the type of message reception. Values of this argument are formed by logically OR'ing zero or more of the following values: .sp .ne 2 -.mk .na \fBMSG_PEEK\fR .ad .RS 15n -.rt Peeks at an incoming message. The data is treated as unread and the next \fBrecvfrom()\fR or similar function will still return this data. .RE .sp .ne 2 -.mk .na \fBMSG_OOB\fR .ad .RS 15n -.rt Requests out-of-band data. The significance and semantics of out-of-band data are protocol-specific. .RE .sp .ne 2 -.mk .na \fBMSG_WAITALL\fR .ad .RS 15n -.rt Requests that the function block until the full amount of data requested can be returned. The function may return a smaller amount of data if a signal is caught, if the connection is terminated, if MSG_PEEK was specified, or if an @@ -117,12 +103,10 @@ error is pending for the socket. .sp .ne 2 -.mk .na \fB\fIaddress\fR\fR .ad .RS 15n -.rt A null pointer, or points to a \fBsockaddr\fR structure in which the sending address is to be stored. The length and format of the address depend on the address family of the socket. @@ -130,12 +114,10 @@ address family of the socket. .sp .ne 2 -.mk .na \fB\fIaddress_len\fR\fR .ad .RS 15n -.rt Specifies the length of the \fBsockaddr\fR structure pointed to by the \fIaddress\fR argument. .RE @@ -196,7 +178,6 @@ function returns \(mi1 and sets \fBerrno\fR to indicate the error. The \fBrecvfrom()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad @@ -205,7 +186,6 @@ The \fBrecvfrom()\fR function will fail if: \fB\fBEWOULDBLOCK\fR\fR .ad .RS 15n -.rt The socket's file descriptor is marked \fBO_NONBLOCK\fR and no data is waiting to be received, or \fBMSG_OOB\fR is set and no out-of-band data is available and either the socket's file descriptor is marked \fBO_NONBLOCK\fR or the @@ -214,101 +194,83 @@ socket does not support blocking to await out-of-band data. .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBECONNRESET\fR\fR .ad .RS 15n -.rt A connection was forcibly closed by a peer. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 15n -.rt The \fIbuffer\fR, \fIaddress\fR or \fIaddress_len\fR parameter can not be accessed or written. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 15n -.rt A signal interrupted \fBrecvfrom()\fR before any data was available. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 15n -.rt The \fBMSG_OOB\fR flag is set and no out-of-band data is available. .RE .sp .ne 2 -.mk .na \fB\fBENOTCONN\fR\fR .ad .RS 15n -.rt A receive is attempted on a connection-mode socket that is not connected. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 15n -.rt The specified flags are not supported for this socket type. .RE .sp .ne 2 -.mk .na \fB\fBETIMEDOUT\fR\fR .ad .RS 15n -.rt The connection timed out during connection establishment, or due to a transmission timeout on active connection. .RE @@ -318,45 +280,37 @@ transmission timeout on active connection. The \fBrecvfrom()\fR function may fail if: .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\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources were available in the system to perform the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n -.rt Insufficient memory was available to fulfill the request. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -369,15 +323,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/man3xnet/recvmsg.3xnet b/usr/src/man/man3xnet/recvmsg.3xnet index c15d4dbcb7..881dc82952 100644 --- a/usr/src/man/man3xnet/recvmsg.3xnet +++ b/usr/src/man/man3xnet/recvmsg.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 2006, 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 recvmsg 3XNET "27 Feb 2006" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH RECVMSG 3XNET "Feb 27, 2006" .SH NAME recvmsg \- receive a message from a socket .SH SYNOPSIS @@ -94,45 +94,37 @@ the bitwise-inclusive OR of all of the following flags that indicate conditions detected for the received message: .sp .ne 2 -.mk .na \fB\fBMSG_EOR\fR\fR .ad .RS 14n -.rt End of record was received (if supported by the protocol). .RE .sp .ne 2 -.mk .na \fB\fBMSG_OOB\fR\fR .ad .RS 14n -.rt Out-of-band data was received. .RE .sp .ne 2 -.mk .na \fB\fBMSG_TRUNC\fR\fR .ad .RS 14n -.rt Normal data was truncated. .RE .sp .ne 2 -.mk .na \fB\fBMSG_CTRUNC\fR\fR .ad .RS 14n -.rt Control data was truncated. .RE @@ -142,23 +134,19 @@ Control data was truncated. The function takes the following arguments: .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 11n -.rt Specifies the socket file descriptor. .RE .sp .ne 2 -.mk .na \fB\fImessage\fR\fR .ad .RS 11n -.rt Points to a \fBmsghdr\fR structure, containing both the buffer to store the source address and the buffers for the incoming message. The length and format of the address depend on the address family of the socket. The \fBmsg_flags\fR @@ -167,45 +155,37 @@ member is ignored on input, but may contain meaningful values on output. .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 11n -.rt Specifies the type of message reception. Values of this argument are formed by logically OR'ing zero or more of the following values: .sp .ne 2 -.mk .na \fB\fBMSG_OOB\fR\fR .ad .RS 15n -.rt Requests out-of-band data. The significance and semantics of out-of-band data are protocol-specific. .RE .sp .ne 2 -.mk .na \fB\fBMSG_PEEK\fR\fR .ad .RS 15n -.rt Peeks at the incoming message. .RE .sp .ne 2 -.mk .na \fB\fBMSG_WAITALL\fR\fR .ad .RS 15n -.rt Requests that the function block until the full amount of data requested can be returned. The function may return a smaller amount of data if a signal is caught, if the connection is terminated, if \fBMSG_PEEK\fR was specified, or if @@ -232,7 +212,6 @@ performed an orderly shutdown, \fBrecvmsg()\fR returns \fB0\fR. Otherwise, The \fBrecvmsg()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad @@ -241,7 +220,6 @@ The \fBrecvmsg()\fR function will fail if: \fB\fBEWOULDBLOCK\fR\fR .ad .RS 15n -.rt The socket's file descriptor is marked \fBO_NONBLOCK\fR and no data is waiting to be received; or \fBMSG_OOB\fR is set and no out-of-band data is available and either the socket's file descriptor is marked \fBO_NONBLOCK\fR or the @@ -250,34 +228,28 @@ socket does not support blocking to await out-of-band data. .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument is not a valid open file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBECONNRESET\fR\fR .ad .RS 15n -.rt A connection was forcibly closed by a peer. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 15n -.rt The \fImessage\fR parameter, or storage pointed to by the \fImsg_name\fR, \fImsg_control\fR or \fImsg_iov\fR fields of the \fImessage\fR parameter, or storage pointed to by the \fBiovec\fR structures pointed to by the @@ -286,80 +258,66 @@ storage pointed to by the \fBiovec\fR structures pointed to by the .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 15n -.rt This function was interrupted by a signal before any data was available. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 15n -.rt The sum of the \fBiov_len\fR values overflows an \fBssize_t\fR. or the MSG_OOB flag is set and no out-of-band data is available. .RE .sp .ne 2 -.mk .na \fB\fBEMSGSIZE\fR\fR .ad .RS 15n -.rt The \fBmsg_iovlen\fR member of the \fBmsghdr\fR structure pointed to by \fImessage\fR is less than or equal to 0, or is greater than \fBIOV_MAX\fR. .RE .sp .ne 2 -.mk .na \fB\fBENOTCONN\fR\fR .ad .RS 15n -.rt A receive is attempted on a connection-mode socket that is not connected. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 15n -.rt The specified flags are not supported for this socket type. .RE .sp .ne 2 -.mk .na \fB\fBETIMEDOUT\fR\fR .ad .RS 15n -.rt The connection timed out during connection establishment, or due to a transmission timeout on active connection. .RE @@ -369,45 +327,37 @@ transmission timeout on active connection. The \fBrecvmsg()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 11n -.rt An \fBIO\fR error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources were available in the system to perform the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n -.rt Insufficient memory was available to fulfill the request. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -420,15 +370,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/man3xnet/send.3xnet b/usr/src/man/man3xnet/send.3xnet index ea8c6c8ca9..c2a697d0f2 100644 --- a/usr/src/man/man3xnet/send.3xnet +++ b/usr/src/man/man3xnet/send.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved. Portions Copyright (c) 2003, 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 send 3XNET "1 Nov 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH SEND 3XNET "Nov 1, 2003" .SH NAME send \- send a message on a socket .SH SYNOPSIS @@ -22,66 +22,54 @@ send \- send a message on a socket .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 10n -.rt Specifies the socket file descriptor. .RE .sp .ne 2 -.mk .na \fB\fIbuffer\fR\fR .ad .RS 10n -.rt Points to the buffer containing the message to send. .RE .sp .ne 2 -.mk .na \fB\fIlength\fR\fR .ad .RS 10n -.rt Specifies the length of the message in bytes. .RE .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 10n -.rt Specifies the type of message transmission. Values of this argument are formed by logically OR'ing zero or more of the following flags: .sp .ne 2 -.mk .na \fB\fBMSG_EOR\fR\fR .ad .RS 11n -.rt Terminates a record (if supported by the protocol) .RE .sp .ne 2 -.mk .na \fB\fBMSG_OOB\fR\fR .ad .RS 11n -.rt Sends out-of-band data on sockets that support out-of-band communications. The significance and semantics of out-of-band data are protocol-specific. .RE @@ -133,7 +121,6 @@ Otherwise, \(mi1 is returned and \fBerrno\fR is set to indicate the error. The \fBsend()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR \fR .ad @@ -142,119 +129,98 @@ The \fBsend()\fR function will fail if: \fB\fBEWOULDBLOCK\fR\fR .ad .RS 16n -.rt The socket's file descriptor is marked \fBO_NONBLOCK\fR and the requested operation would block. .RE .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBECONNRESET\fR\fR .ad .RS 16n -.rt A connection was forcibly closed by a peer. .RE .sp .ne 2 -.mk .na \fB\fBEDESTADDRREQ\fR\fR .ad .RS 16n -.rt The socket is not connection-mode and no peer address is set. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fIbuffer\fR parameter can not be accessed. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal interrupted \fBsend()\fR before any data was transmitted. .RE .sp .ne 2 -.mk .na \fB\fBEMSGSIZE\fR\fR .ad .RS 16n -.rt The message is too large be sent all at once, as the socket requires. .RE .sp .ne 2 -.mk .na \fB\fBENOTCONN\fR\fR .ad .RS 16n -.rt The socket is not connected or otherwise has not had the peer prespecified. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument is associated with a socket that does not support one or more of the values set in \fIflags\fR. .RE .sp .ne 2 -.mk .na \fB\fBEPIPE\fR\fR .ad .RS 16n -.rt The socket is shut down for writing, or the socket is connection-mode and is no longer connected. In the latter case, and if the socket is of type \fBSOCK_STREAM\fR, the \fBSIGPIPE\fR signal is generated to the calling thread. @@ -265,67 +231,55 @@ longer connected. In the latter case, and if the socket is of type The \fBsend()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 15n -.rt The calling process does not have the appropriate privileges. .RE .sp .ne 2 -.mk .na \fB\fBEIO\fR\fR .ad .RS 15n -.rt An I/O error occurred while reading from or writing to the file system. .RE .sp .ne 2 -.mk .na \fB\fBENETDOWN\fR\fR .ad .RS 15n -.rt The local interface used to reach the destination is down. .RE .sp .ne 2 -.mk .na \fB\fBENETUNREACH\fR\fR .ad .RS 15n -.rt No route to the network is present. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 15n -.rt Insufficient resources were available in the system to perform the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 15n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -338,15 +292,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/man3xnet/sendmsg.3xnet b/usr/src/man/man3xnet/sendmsg.3xnet index 1b18e24509..0f4fc5be86 100644 --- a/usr/src/man/man3xnet/sendmsg.3xnet +++ b/usr/src/man/man3xnet/sendmsg.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. Portions Copyright (c) 2003, 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 sendmsg 3XNET "1 Nov 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH SENDMSG 3XNET "Nov 1, 2003" .SH NAME sendmsg \- send a message on a socket using a message structure .SH SYNOPSIS @@ -25,23 +25,19 @@ sendmsg \- send a message on a socket using a message structure The function takes the following arguments: .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 11n -.rt Specifies the socket file descriptor. .RE .sp .ne 2 -.mk .na \fB\fImessage\fR\fR .ad .RS 11n -.rt Points to a \fBmsghdr\fR structure, containing both the destination address and the buffers for the outgoing message. The length and format of the address depend on the address family of the socket. The \fBmsg_flags\fR member is @@ -50,33 +46,27 @@ ignored. .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 11n -.rt Specifies the type of message transmission. The application may specify 0 or the following flag: .sp .ne 2 -.mk .na \fBMSG_EOR\fR .ad .RS 11n -.rt Terminates a record (if supported by the protocol) .RE .sp .ne 2 -.mk .na \fBMSG_OOB\fR .ad .RS 11n -.rt Sends out-of-band data on sockets that support out-of-bound data. The significance and semantics of out-of-band data are protocol-specific. .RE @@ -137,7 +127,6 @@ the error. The \fBsendmsg()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR \fR .ad @@ -146,52 +135,43 @@ The \fBsendmsg()\fR function will fail if: \fB\fBEWOULDBLOCK\fR\fR .ad .RS 16n -.rt The socket's file descriptor is marked O_NONBLOCK and the requested operation would block. .RE .sp .ne 2 -.mk .na \fB\fBEAFNOSUPPORT\fR\fR .ad .RS 16n -.rt Addresses in the specified address family cannot be used with this socket. .RE .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBECONNRESET\fR\fR .ad .RS 16n -.rt A connection was forcibly closed by a peer. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fImessage\fR parameter, or storage pointed to by the \fImsg_name\fR, \fImsg_control\fR or \fImsg_iov\fR fields of the \fImessage\fR parameter, or storage pointed to by the \fBiovec\fR structures pointed to by the @@ -200,34 +180,28 @@ storage pointed to by the \fBiovec\fR structures pointed to by the .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal interrupted \fBsendmsg()\fR before any data was transmitted. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The sum of the \fBiov_len\fR values overflows an \fBssize_t\fR. .RE .sp .ne 2 -.mk .na \fB\fBEMSGSIZE\fR\fR .ad .RS 16n -.rt The message is to large to be sent all at once (as the socket requires), or the \fBmsg_iovlen\fR member of the \fBmsghdr\fR structure pointed to by \fImessage\fR is less than or equal to 0 or is greater than \fBIOV_MAX\fR. @@ -235,46 +209,38 @@ The message is to large to be sent all at once (as the socket requires), or the .sp .ne 2 -.mk .na \fB\fBENOTCONN\fR\fR .ad .RS 16n -.rt The socket is connection-mode but is not connected. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument does not refer a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument is associated with a socket that does not support one or more of the values set in \fIflags\fR. .RE .sp .ne 2 -.mk .na \fB\fBEPIPE\fR\fR .ad .RS 16n -.rt The socket is shut down for writing, or the socket is connection-mode and is no longer connected. In the latter case, and if the socket is of type SOCK_STREAM, the \fBSIGPIPE\fR signal is generated to the calling thread. @@ -286,59 +252,49 @@ If the address family of the socket is \fBAF_UNIX\fR, then \fBsendmsg()\fR will fail if: .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 the pathname in the socket address. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt A component of a pathname exceeded \fINAME_MAX\fR characters, or an entire pathname exceeded \fIPATH_MAX\fR characters. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of the pathname does not name an existing file or the pathname is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix of the pathname in the socket address is not a directory. .RE @@ -348,114 +304,94 @@ directory. The \fBsendmsg()\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; or write access to the named socket is denied. .RE .sp .ne 2 -.mk .na \fB\fBEDESTADDRREQ\fR\fR .ad .RS 16n -.rt The socket is not connection-mode and does not have its peer address set, and no destination address was specified. .RE .sp .ne 2 -.mk .na \fB\fBEHOSTUNREACH\fR\fR .ad .RS 16n -.rt The destination host cannot be reached (probably because the host is down or a remote router cannot reach it). .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\fBEISCONN\fR\fR .ad .RS 16n -.rt A destination address was specified and the socket is already connected. .RE .sp .ne 2 -.mk .na \fB\fBENETDOWN\fR\fR .ad .RS 16n -.rt The local interface used to reach the destination is down. .RE .sp .ne 2 -.mk .na \fB\fBENETUNREACH\fR\fR .ad .RS 16n -.rt No route to the network is present. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 16n -.rt Insufficient resources were available in the system to perform the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 16n -.rt Insufficient memory was available to fulfill the request. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 16n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -466,12 +402,10 @@ If the address family of the socket is \fBAF_UNIX\fR, then \fBsendmsg()\fR 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 \fIPATH_MAX\fR. .RE @@ -484,15 +418,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/man3xnet/sendto.3xnet b/usr/src/man/man3xnet/sendto.3xnet index 5c496238f7..9c9e75bc57 100644 --- a/usr/src/man/man3xnet/sendto.3xnet +++ b/usr/src/man/man3xnet/sendto.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. Portions Copyright (c) 2003, 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 sendto 3XNET "1 Nov 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH SENDTO 3XNET "Nov 1, 2003" .SH NAME sendto \- send a message on a socket .SH SYNOPSIS @@ -58,66 +58,54 @@ the \fBsendto()\fR function. The function takes the following arguments: .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 13n -.rt Specifies the socket file descriptor. .RE .sp .ne 2 -.mk .na \fB\fImessage\fR\fR .ad .RS 13n -.rt Points to a buffer containing the message to be sent. .RE .sp .ne 2 -.mk .na \fB\fIlength\fR\fR .ad .RS 13n -.rt Specifies the size of the message in bytes. .RE .sp .ne 2 -.mk .na \fB\fIflags\fR\fR .ad .RS 13n -.rt Specifies the type of message transmission. Values of this argument are formed by logically OR'ing zero or more of the following flags: .sp .ne 2 -.mk .na \fBMSG_EOR\fR .ad .RS 11n -.rt Terminates a record (if supported by the protocol) .RE .sp .ne 2 -.mk .na \fBMSG_OOB\fR .ad .RS 11n -.rt Sends out-of-band data on sockets that support out-of-band data. The significance and semantics of out-of-band data are protocol-specific. .RE @@ -126,24 +114,20 @@ significance and semantics of out-of-band data are protocol-specific. .sp .ne 2 -.mk .na \fB\fIdest_addr\fR\fR .ad .RS 13n -.rt Points to a \fBsockaddr\fR structure containing the destination address. The length and format of the address depend on the address family of the socket. .RE .sp .ne 2 -.mk .na \fB\fIdest_len\fR\fR .ad .RS 13n -.rt Specifies the length of the \fBsockaddr\fR structure pointed to by the \fIdest_addr\fR argument. .RE @@ -164,18 +148,15 @@ Otherwise, \fB-1\fR is returned and \fBerrno\fR is set to indicate the error. The \fBsendto()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAFNOSUPPORT\fR\fR .ad .RS 16n -.rt Addresses in the specified address family cannot be used with this socket. .RE .sp .ne 2 -.mk .na \fB\fBEAGAIN\fR\fR .ad @@ -184,108 +165,89 @@ Addresses in the specified address family cannot be used with this socket. \fB\fBEWOULDBLOCK\fR\fR .ad .RS 16n -.rt The socket's file descriptor is marked \fBO_NONBLOCK\fR and the requested operation would block. .RE .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBECONNRESET\fR\fR .ad .RS 16n -.rt A connection was forcibly closed by a peer. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n -.rt The \fImessage\fR or \fIdestaddr\fR parameter cannot be accessed. .RE .sp .ne 2 -.mk .na \fB\fBEINTR\fR\fR .ad .RS 16n -.rt A signal interrupted \fBsendto()\fR before any data was transmitted. .RE .sp .ne 2 -.mk .na \fB\fBEMSGSIZE\fR\fR .ad .RS 16n -.rt The message is too large to be sent all at once, as the socket requires. .RE .sp .ne 2 -.mk .na \fB\fBENOTCONN\fR\fR .ad .RS 16n -.rt The socket is connection-mode but is not connected. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument does not refer to a socket. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 16n -.rt The \fIsocket\fR argument is associated with a socket that does not support one or more of the values set in \fIflags\fR. .RE .sp .ne 2 -.mk .na \fB\fBEPIPE\fR\fR .ad .RS 16n -.rt The socket is shut down for writing, or the socket is connection-mode and is no longer connected. In the latter case, and if the socket is of type \fBSOCK_STREAM\fR, the \fBSIGPIPE\fR signal is generated to the calling thread. @@ -297,59 +259,49 @@ If the address family of the socket is \fBAF_UNIX\fR, then \fBsendto()\fR will fail if: .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 the pathname in the socket address. .RE .sp .ne 2 -.mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n -.rt A component of a pathname exceeded \fINAME_MAX\fR characters, or an entire pathname exceeded \fIPATH_MAX\fR characters. .RE .sp .ne 2 -.mk .na \fB\fBENOENT\fR\fR .ad .RS 16n -.rt A component of the pathname does not name an existing file or the pathname is an empty string. .RE .sp .ne 2 -.mk .na \fB\fBENOTDIR\fR\fR .ad .RS 16n -.rt A component of the path prefix of the pathname in the socket address is not a directory. .RE @@ -359,125 +311,103 @@ directory. The \fBsendto()\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; or write access to the named socket is denied. .RE .sp .ne 2 -.mk .na \fB\fBEDESTADDRREQ\fR\fR .ad .RS 16n -.rt The socket is not connection-mode and does not have its peer address set, and no destination address was specified. .RE .sp .ne 2 -.mk .na \fB\fBEHOSTUNREACH\fR\fR .ad .RS 16n -.rt The destination host cannot be reached (probably because the host is down or a remote router cannot reach it). .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n -.rt The \fIdest_len\fR argument is not a valid length for the address family. .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\fBEISCONN\fR\fR .ad .RS 16n -.rt A destination address was specified and the socket is already connected. .RE .sp .ne 2 -.mk .na \fB\fBENETDOWN\fR\fR .ad .RS 16n -.rt The local interface used to reach the destination is down. .RE .sp .ne 2 -.mk .na \fB\fBENETUNREACH\fR\fR .ad .RS 16n -.rt No route to the network is present. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 16n -.rt Insufficient resources were available in the system to perform the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 16n -.rt Insufficient memory was available to fulfill the request. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 16n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -488,12 +418,10 @@ If the address family of the socket is \fBAF_UNIX\fR, then \fBsendto()\fR 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 \fIPATH_MAX\fR. .RE @@ -506,15 +434,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/man3xnet/setsockopt.3xnet b/usr/src/man/man3xnet/setsockopt.3xnet index f87aa23c2a..54afb2e551 100644 --- a/usr/src/man/man3xnet/setsockopt.3xnet +++ b/usr/src/man/man3xnet/setsockopt.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. Portions Copyright (c) 2007, 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 setsockopt 3XNET "21 Jan 2007" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH SETSOCKOPT 3XNET "Jan 21, 2007" .SH NAME setsockopt \- set the socket options .SH SYNOPSIS @@ -47,12 +47,10 @@ to the appropriate protocol module for interpretations. The as follow .sp .ne 2 -.mk .na \fB\fBSO_DEBUG\fR\fR .ad .RS 17n -.rt Turns on recording of debugging information. This option enables or disables debugging in the underlying protocol modules. This option takes an \fBint\fR value. This is a boolean option. @@ -60,24 +58,20 @@ value. This is a boolean option. .sp .ne 2 -.mk .na \fB\fBSO_BROADCAST\fR\fR .ad .RS 17n -.rt Permits sending of broadcast messages, if this is supported by the protocol. This option takes an \fBint\fR value. This is a boolean option. .RE .sp .ne 2 -.mk .na \fB\fBSO_REUSEADDR\fR\fR .ad .RS 17n -.rt Specifies that the rules used in validating addresses supplied to \fBbind\fR(3XNET) should allow reuse of local addresses, if this is supported by the protocol. This option takes an \fBint\fR value. This is a boolean @@ -86,12 +80,10 @@ option. .sp .ne 2 -.mk .na \fB\fBSO_KEEPALIVE\fR\fR .ad .RS 17n -.rt Keeps connections active by enabling the periodic transmission of messages, if this is supported by the protocol. This option takes an \fBint\fR value. .sp @@ -104,12 +96,10 @@ This is a boolean option. .sp .ne 2 -.mk .na \fB\fBSO_LINGER\fR\fR .ad .RS 17n -.rt Lingers on a \fBclose\fR(2) if data is present. This option controls the action taken when unsent messages queue on a socket and \fBclose\fR(2) is performed. If \fBSO_LINGER\fR is set, the system blocks the process during @@ -123,46 +113,38 @@ interval. .sp .ne 2 -.mk .na \fB\fBSO_OOBINLINE\fR\fR .ad .RS 17n -.rt Leaves received out-of-band data (data marked urgent) in line. This option takes an \fBint\fR value. This is a boolean option. .RE .sp .ne 2 -.mk .na \fB\fBSO_SNDBUF\fR\fR .ad .RS 17n -.rt Sets send buffer size. This option takes an \fBint\fR value. .RE .sp .ne 2 -.mk .na \fB\fBSO_RCVBUF\fR\fR .ad .RS 17n -.rt Sets receive buffer size. This option takes an \fBint\fR value. .RE .sp .ne 2 -.mk .na \fB\fBSO_DONTROUTE\fR\fR .ad .RS 17n -.rt Requests that outgoing messages bypass the standard routing facilities. The destination must be on a directly-connected network, and messages are directed to the appropriate network interface according to the destination address. The @@ -172,12 +154,10 @@ takes an \fBint\fR value. This is a boolean option. .sp .ne 2 -.mk .na \fB\fBSO_MAC_EXEMPT\fR\fR .ad .RS 17n -.rt Sets the mandatory access control on the socket. A socket that has this option enabled can communicate with an unlabeled peer if the socket is in the global zone or has a label that dominates the default label of the peer. Otherwise, @@ -188,12 +168,10 @@ when the system is configured with Trusted Extensions. .sp .ne 2 -.mk .na \fB\fBSO_ALLZONES\fR\fR .ad .RS 17n -.rt Bypasses zone boundaries (privileged). This option stores an \fBint\fR value. This is a boolean option. .sp @@ -245,81 +223,67 @@ Upon successful completion, \fBsetsockopt()\fR returns \fB0\fR. Otherwise, The \fBsetsockopt()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEDOM\fR\fR .ad .RS 15n -.rt The send and receive timeout values are too big to fit into the timeout fields in the socket structure. .RE .sp .ne 2 -.mk .na \fB\fBEFAULT\fR\fR .ad .RS 15n -.rt The \fIoption_value\fR parameter can not be accessed or written. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 15n -.rt The specified option is invalid at the specified socket level or the socket has been shut down. .RE .sp .ne 2 -.mk .na \fB\fBEISCONN\fR\fR .ad .RS 15n -.rt The socket is already connected, and a specified option can not be set while the socket is connected. .RE .sp .ne 2 -.mk .na \fB\fBENOPROTOOPT\fR\fR .ad .RS 15n -.rt The option is not supported by the protocol. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 15n -.rt The \fIsocket\fR argument does not refer to a socket. .RE @@ -328,34 +292,28 @@ The \fIsocket\fR argument does not refer to a socket. The \fBsetsockopt()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n -.rt There was insufficient memory available for the operation to complete. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources are available in the system to complete the call. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -368,15 +326,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/man3xnet/shutdown.3xnet b/usr/src/man/man3xnet/shutdown.3xnet index 966de7e1ef..899e15b62c 100644 --- a/usr/src/man/man3xnet/shutdown.3xnet +++ b/usr/src/man/man3xnet/shutdown.3xnet @@ -1,21 +1,21 @@ '\" te -.\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions +.\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions .\" Copyright (c) 1998, 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 shutdown 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH SHUTDOWN 3XNET "Jun 10, 2002" .SH NAME shutdown \- shut down socket send and receive operations .SH SYNOPSIS .LP .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ] -#include <sys/socket.h> +#include <sys/socket.h> \fBint\fR \fBshutdown\fR(\fBint\fR \fIsocket\fR, \fBint\fR \fIhow\fR); .fi @@ -29,43 +29,35 @@ argument. .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIhow\fR\fR .ad .RS 10n -.rt Specifies the type of shutdown. The values are as follows: .sp .ne 2 -.mk .na \fB\fBSHUT_RD\fR\fR .ad .RS 13n -.rt Disables further receive operations. .RE .sp .ne 2 -.mk .na \fB\fBSHUT_WR\fR\fR .ad .RS 13n -.rt Disables further send operations. .RE .sp .ne 2 -.mk .na \fB\fBSHUT_RDWR\fR\fR .ad .RS 13n -.rt Disables further send and receive operations. .RE @@ -73,12 +65,10 @@ Disables further send and receive operations. .sp .ne 2 -.mk .na \fB\fIsocket\fR\fR .ad .RS 10n -.rt Specifies the file descriptor of the socket. .RE @@ -93,45 +83,37 @@ returned and \fBerrno\fR is set to indicate the error. The \fBshutdown()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 12n -.rt The \fIsocket\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBEINVAL\fR\fR .ad .RS 12n -.rt The \fIhow\fR argument is invalid. .RE .sp .ne 2 -.mk .na \fB\fBENOTCONN\fR\fR .ad .RS 12n -.rt The socket is not connected. .RE .sp .ne 2 -.mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 12n -.rt The \fIsocket\fR argument does not refer to a socket. .RE @@ -140,23 +122,19 @@ The \fIsocket\fR argument does not refer to a socket. The \fBshutdown()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources were available in the system to perform the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -169,15 +147,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/man3xnet/sockatmark.3xnet b/usr/src/man/man3xnet/sockatmark.3xnet index 025d7ebabf..d976a8bb0e 100644 --- a/usr/src/man/man3xnet/sockatmark.3xnet +++ b/usr/src/man/man3xnet/sockatmark.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 2001, The IEEE and The Open Group. All Rights Reserved. Portions Copyright (c) 2003, 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 sockatmark 3XNET "1 Oct 2003" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH SOCKATMARK 3XNET "Oct 1, 2003" .SH NAME sockatmark \- determine whether a socket is at the out-of-band mark .SH SYNOPSIS @@ -44,23 +44,19 @@ receive queue, the \fBsockatmark()\fR function returns 0. Otherwise, it returns The \fBsockatmark()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEBADF\fR\fR .ad .RS 10n -.rt The \fIs\fR argument is not a valid file descriptor. .RE .sp .ne 2 -.mk .na \fB\fBENOTTY\fR\fR .ad .RS 10n -.rt The \fIs\fR argument does not specify a descriptor for a socket. .RE @@ -91,15 +87,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-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3xnet/socket.3xnet b/usr/src/man/man3xnet/socket.3xnet index a345590df8..d54426f990 100644 --- a/usr/src/man/man3xnet/socket.3xnet +++ b/usr/src/man/man3xnet/socket.3xnet @@ -1,21 +1,21 @@ '\" te -.\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions +.\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions .\" Copyright (c) 1999, 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 socket 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH SOCKET 3XNET "Jun 10, 2002" .SH NAME socket \- create an endpoint for communication .SH SYNOPSIS .LP .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lxnet\fR [ \fIlibrary\fR ... ] -#include <sys/socket.h> +#include <sys/socket.h> \fBint\fR \fBsocket\fR(\fBint\fR \fIdomain\fR, \fBint\fR \fItype\fR, \fBint\fR \fIprotocol\fR); .fi @@ -32,34 +32,28 @@ The <\fBsys/socket.h\fR> header defines at least the following values for the \fIdomain\fR argument: .sp .ne 2 -.mk .na \fB\fBAF_UNIX\fR\fR .ad .RS 12n -.rt File system pathnames. .RE .sp .ne 2 -.mk .na \fB\fBAF_INET\fR\fR .ad .RS 12n -.rt Internet Protocol version 4 (IPv4) address. .RE .sp .ne 2 -.mk .na \fB\fBAF_INET6\fR\fR .ad .RS 12n -.rt Internet Protocol version 6 (IPv6) address. .RE @@ -70,36 +64,30 @@ semantics of communication over the socket. The socket types supported by the system are implementation-dependent. Possible socket types include: .sp .ne 2 -.mk .na \fB\fBSOCK_STREAM\fR\fR .ad .RS 18n -.rt Provides sequenced, reliable, bidirectional, connection-mode byte streams, and may provide a transmission mechanism for out-of-band data. .RE .sp .ne 2 -.mk .na \fB\fBSOCK_DGRAM\fR\fR .ad .RS 18n -.rt Provides datagrams, which are connectionless-mode, unreliable messages of fixed maximum length. .RE .sp .ne 2 -.mk .na \fB\fBSOCK_SEQPACKET\fR\fR .ad .RS 18n -.rt Provides sequenced, reliable, bidirectional, connection-mode transmission path for records. A record can be sent using one or more output operations and received using one or more input operations, but a single operation never @@ -122,34 +110,28 @@ function or to create some sockets. The function takes the following arguments: .sp .ne 2 -.mk .na \fB\fIdomain\fR\fR .ad .RS 12n -.rt Specifies the communications domain in which a socket is to be created. .RE .sp .ne 2 -.mk .na \fB\fItype\fR\fR .ad .RS 12n -.rt Specifies the type of socket to be created. .RE .sp .ne 2 -.mk .na \fB\fIprotocol\fR\fR .ad .RS 12n -.rt Specifies a particular protocol to be used with the socket. Specifying a \fIprotocol\fR of 0 causes \fBsocket()\fR to use an unspecified default protocol appropriate for the requested socket type. @@ -182,57 +164,47 @@ socket file descriptor. Otherwise a value of \fB-1\fR is returned and The \fBsocket()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAFNOSUPPORT\fR\fR .ad .RS 19n -.rt The implementation does not support the specified address family. .RE .sp .ne 2 -.mk .na \fB\fBEMFILE\fR\fR .ad .RS 19n -.rt No more file descriptors are available for this process. .RE .sp .ne 2 -.mk .na \fB\fBENFILE\fR\fR .ad .RS 19n -.rt No more file descriptors are available for the system. .RE .sp .ne 2 -.mk .na \fB\fBEPROTONOSUPPORT\fR\fR .ad .RS 19n -.rt The protocol is not supported by the address family, or the protocol is not supported by the implementation. .RE .sp .ne 2 -.mk .na \fB\fBEPROTOTYPE\fR\fR .ad .RS 19n -.rt The socket type is not supported by the protocol. .RE @@ -241,45 +213,37 @@ The socket type is not supported by the protocol. The \fBsocket()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 11n -.rt The process does not have appropriate privileges. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources were available in the system to perform the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n -.rt Insufficient memory was available to fulfill the request. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -292,15 +256,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/man3xnet/socketpair.3xnet b/usr/src/man/man3xnet/socketpair.3xnet index ab7e175bd8..a43b4038df 100644 --- a/usr/src/man/man3xnet/socketpair.3xnet +++ b/usr/src/man/man3xnet/socketpair.3xnet @@ -1,13 +1,13 @@ '\" te .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved Portions Copyright (c) 1998, 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 socketpair 3XNET "10 Jun 2002" "SunOS 5.11" "X/Open Networking Services Library Functions" +.TH SOCKETPAIR 3XNET "Jun 10, 2002" .SH NAME socketpair \- create a pair of connected sockets .SH SYNOPSIS @@ -34,36 +34,30 @@ semantics of communications over the socket. The socket types supported by the system are implementation-dependent. Possible socket types include: .sp .ne 2 -.mk .na \fB\fBSOCK_STREAM\fR\fR .ad .RS 18n -.rt Provides sequenced, reliable, bidirectional, connection-mode byte streams, and may provide a transmission mechanism for out-of-band data. .RE .sp .ne 2 -.mk .na \fB\fBSOCK_DGRAM\fR\fR .ad .RS 18n -.rt Provides datagrams, which are connectionless-mode, unreliable messages of fixed maximum length. .RE .sp .ne 2 -.mk .na \fB\fBSOCK_SEQPACKET\fR\fR .ad .RS 18n -.rt Provides sequenced, reliable, bidirectional, connection-mode transmission path for records. A record can be sent using one or more output operations and received using one or more input operations, but a single operation never @@ -83,34 +77,28 @@ The process may need to have appropriate privileges to use the .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIdomain\fR\fR .ad .RS 17n -.rt Specifies the communications domain in which the sockets are to be created. .RE .sp .ne 2 -.mk .na \fB\fItype\fR\fR .ad .RS 17n -.rt Specifies the type of sockets to be created. .RE .sp .ne 2 -.mk .na \fB\fIprotocol\fR\fR .ad .RS 17n -.rt Specifies a particular protocol to be used with the sockets. Specifying a \fIprotocol\fR of 0 causes \fBsocketpair()\fR to use an unspecified default protocol appropriate for the requested socket type. @@ -118,12 +106,10 @@ protocol appropriate for the requested socket type. .sp .ne 2 -.mk .na \fB\fIsocket_vector\fR\fR .ad .RS 17n -.rt Specifies a 2-integer array to hold the file descriptors of the created socket pair. .RE @@ -149,68 +135,56 @@ returned and \fBerrno\fR is set to indicate the error. The \fBsocketpair()\fR function will fail if: .sp .ne 2 -.mk .na \fB\fBEAFNOSUPPORT\fR\fR .ad .RS 19n -.rt The implementation does not support the specified address family. .RE .sp .ne 2 -.mk .na \fB\fBEMFILE\fR\fR .ad .RS 19n -.rt No more file descriptors are available for this process. .RE .sp .ne 2 -.mk .na \fB\fBENFILE\fR\fR .ad .RS 19n -.rt No more file descriptors are available for the system. .RE .sp .ne 2 -.mk .na \fB\fBEOPNOTSUPP\fR\fR .ad .RS 19n -.rt The specified protocol does not permit creation of socket pairs. .RE .sp .ne 2 -.mk .na \fB\fBEPROTONOSUPPORT\fR\fR .ad .RS 19n -.rt The protocol is not supported by the address family, or the protocol is not supported by the implementation. .RE .sp .ne 2 -.mk .na \fB\fBEPROTOTYPE\fR\fR .ad .RS 19n -.rt The socket type is not supported by the protocol. .RE @@ -219,45 +193,37 @@ The socket type is not supported by the protocol. The \fBsocketpair()\fR function may fail if: .sp .ne 2 -.mk .na \fB\fBEACCES\fR\fR .ad .RS 11n -.rt The process does not have appropriate privileges. .RE .sp .ne 2 -.mk .na \fB\fBENOBUFS\fR\fR .ad .RS 11n -.rt Insufficient resources were available in the system to perform the operation. .RE .sp .ne 2 -.mk .na \fB\fBENOMEM\fR\fR .ad .RS 11n -.rt Insufficient memory was available to fulfill the request. .RE .sp .ne 2 -.mk .na \fB\fBENOSR\fR\fR .ad .RS 11n -.rt There were insufficient STREAMS resources available for the operation to complete. .RE @@ -270,15 +236,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 |