manpagez: man pages & more
man disconnectx(2)
Home | html | info | man

disconnectx(2)              BSD System Calls Manual             disconnectx(2)


NAME

     disconnectx -- disconnects a connection on a socket


SYNOPSIS

     #include <sys/socket.h>

     int
     disconnectx(int socket, sae_associd_t associd, sae_connid_t connid);


DESCRIPTION

     The parameter socket is a socket.  The communication domain of the socket
     determines the availability and behavior of disconnectx().  For connec-
     tion-oriented socket, disconnectx() is analogous to shutdown(2) with
     SHUT_RDWR issued on the socket. For connectionless socket, it disassoci-
     ates any existing association to the peer socket.

     The parameter associd specifies the association identifier.  It should be
     set to SAE_ASSOCID_ANY.

     The parameter connid should be set to SAE_CONNID_ANY.


NOTES

     disconnectx() is currently supported only on AF_INET and AF_INET6 sockets
     of type SOCK_DGRAM and SOCK_STREAM.


RETURN VALUES

     The disconnectx() function returns the value 0 if successful; otherwise
     the value of -1 is returned and the global integer variable errno is set
     to indicate the error.


ERRORS

     The disconnectx() system call succeeds unless:

     [EALREADY]         Operation already in progress.

     [EBADF]            Socket is not a valid descriptor.

     [EINVAL]           The associd or connid argument is invalid or the
                        underlying protocol is no longer attached to socket.

     [ENOTCONN]         The socket is not connected.

     [ENOTSOCK]         Socket is a file, not a socket.


SEE ALSO

     connect(2), connectx(2), socket(2), compat(5)


HISTORY

     The disconnectx() function call appeared in Darwin 15.0.0

Darwin                          April 10, 2015                          Darwin

Mac OS X 10.12.6 - Generated Sun Oct 29 12:46:24 CDT 2017
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.