shutdown Subroutine

Purpose

Shuts down all socket send and receive operations.

Library

Standard C Library (libc.a)

Syntax

#include <sys/socket.h> int shutdown ( Socket, How) int Socket, How;

Description

The shutdown subroutine disables all receive and send operations on the specified socket.

All applications containing the shutdown subroutine must be compiled with the _BSD macro set to a specific value. Acceptable values are 43 and 44. In addition, all socket applications must include the BSD libbsd.a library.

Parameters

Item	Description
Socket	Specifies the unique name of the socket.
How	Specifies the type of subroutine shutdown. Use the following values: 0 Disables further receive operations. 1 Disables further send operations. 2 Disables further send operations and receive operations.

Return Values

Upon successful completion, a value of 0 is returned.

If the shutdown subroutine is unsuccessful, the subroutine handler performs the following functions:

Returns a value of -1 to the calling program.
Moves an error code, indicating the specific error, into the errno global variable. For further explanation of the errno variable see Error Notification Object Class in AIX® Version 7.1 General Programming Concepts: Writing and Debugging Programs.

Error Codes

The shutdown subroutine is unsuccessful if any of the following errors occurs:

Error	Description
EBADF	The Socket parameter is not valid.
EINVAL	The How parameter is invalid.
ENOTCONN	The socket is not connected.
ENOTSOCK	The Socket parameter refers to a file, not a socket.

Files

Item	Description
/usr/include/sys/socket.h	Contains socket definitions.
/usr/include/sys/types.h	Contains definitions of unsigned data types.