shutdown(2) [freebsd man page]

SHUTDOWN(2)						      BSD System Calls Manual						       SHUTDOWN(2)

NAME

     shutdown -- disable sends and/or receives on a socket

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <sys/types.h>
     #include <sys/socket.h>

     int
     shutdown(int s, int how);

DESCRIPTION

     The shutdown() system call disables sends or receives on a socket.  The how argument specifies the type of shutdown.  Possible values are:

     SHUT_RD	Further receives will be disallowed.

     SHUT_WR	Further sends will be disallowed.  This may cause actions specific to the protocol family of the socket s to happen; see
		IMPLEMENTATION NOTES.

     SHUT_RDWR	Further sends and receives will be disallowed.	Implies SHUT_WR.

     If the file descriptor s is associated with a SOCK_STREAM socket, all or part of the full-duplex connection will be shut down.

IMPLEMENTATION NOTES

     The following protocol specific actions apply to the use of SHUT_WR (and potentially also SHUT_RDWR), based on the properties of the socket
     associated with the file descriptor s.

     Domain	 Type		Protocol	Return value and action
     PF_INET	 SOCK_DGRAM	IPPROTO_SCTP	Return -1.  The global variable errno will be set to EOPNOTSUPP.
     PF_INET	 SOCK_DGRAM	IPPROTO_UDP	Return 0.  ICMP messages will not be generated.
     PF_INET	 SOCK_STREAM	IPPROTO_SCTP	Return 0.  Send queued data and tear down association.
     PF_INET	 SOCK_STREAM	IPPROTO_TCP	Return 0.  Send queued data, wait for ACK, then send FIN.
     PF_INET6	 SOCK_DGRAM	IPPROTO_SCTP	Return -1.  The global variable errno will be set to EOPNOTSUPP.
     PF_INET6	 SOCK_DGRAM	IPPROTO_UDP	Return 0.  ICMP messages will not be generated.
     PF_INET6	 SOCK_STREAM	IPPROTO_SCTP	Return 0.  Send queued data and tear down association.
     PF_INET6	 SOCK_STREAM	IPPROTO_TCP	Return 0.  Send queued data, wait for ACK, then send FIN.

RETURN VALUES

     The shutdown() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indi-
     cate the error.

ERRORS

     The shutdown() system call fails if:

     [EBADF]		The s argument is not a valid file descriptor.

     [EINVAL]		The how argument is invalid.

     [EOPNOTSUPP]	The socket associated with the file descriptor s does not support this operation.

     [ENOTCONN] 	The s argument specifies a SOCK_STREAM socket which is not connected.

     [ENOTSOCK] 	The s argument does not refer to a socket.

SEE ALSO

     connect(2), socket(2), inet(4), inet6(4)

STANDARDS

     The shutdown() system call is expected to comply with IEEE Std 1003.1g-2000 (``POSIX.1''), when finalized.

HISTORY

     The shutdown() system call appeared in 4.2BSD.  The SHUT_RD, SHUT_WR, and SHUT_RDWR constants appeared in IEEE Std 1003.1g-2000
     (``POSIX.1'').

AUTHORS

     This manual page was updated by Bruce M. Simpson <bms@FreeBSD.org> to reflect how shutdown() behaves with PF_INET and PF_INET6 sockets.

BUGS

     The ICMP ``port unreachable'' message should be generated in response to datagrams received on a local port to which s is bound after
     shutdown() is called.

BSD
								   March 5, 2007							       BSD

Check Out this Related Man Page

shutdown(3XNET) 				   X/Open Networking Services Library Functions 				   shutdown(3XNET)

NAME

       shutdown - shut down socket send and receive operations

SYNOPSIS

       cc [ flag ... ] file ... -lxnet [ library ... ]
       #include <sys/socket.h>

       int shutdown(int socket, int how);

DESCRIPTION

       The shutdown() function disables subsequent send() and receive() operations on a socket, depending on the value of the how argument.

PARAMETERS

       how	       Specifies the type of shutdown.	The values are as follows:

		       SHUT_RD	       Disables further receive operations.

		       SHUT_WR	       Disables further send operations.

		       SHUT_RDWR       Disables further send and receive operations.

       socket	       Specifies the file descriptor of the socket.

RETURN VALUES

       Upon successful completion, shutdown() returns 0.  Otherwise, -1 is returned and errno is set to indicate the error.

ERRORS

       The shutdown() function will fail if:

       EBADF		       The socket argument is not a valid file descriptor.

       EINVAL		       The how argument is invalid.

       ENOTCONN 	       The socket is not connected.

       ENOTSOCK 	       The socket argument does not refer to a socket.

       The shutdown() function may fail if:

       ENOBUFS		       Insufficient resources were available in the system to perform the operation.

       ENOSR		       There were insufficient STREAMS resources available for the operation to complete.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	     ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       getsockopt(3XNET),  recv(3XNET), recvfrom(3XNET), recvmsg(3XNET), select(3C), send(3XNET), sendto(3XNET), setsockopt(3XNET), socket(3XNET),
       attributes(5), standards(5)

SunOS 5.10							    10 Jun 2002 						   shutdown(3XNET)

Linux and UNIX Man Pages

shutdown(2) [freebsd man page]

Check Out this Related Man Page