Next: Socket Pairs, Previous: Creating a Socket, Up: Opening and Closing Sockets [Contents][Index]
When you have finished using a socket, you can simply close its
file descriptor with
close; see Opening and Closing Files.
If there is still data waiting to be transmitted over the connection,
close tries to complete this transmission. You
can control this behavior using the
SO_LINGER socket option to
specify a timeout period; see Socket Options.
You can also shut down only reception or transmission on a
connection by calling
shutdown, which is declared in
Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.
shutdown function shuts down the connection of socket
socket. The argument how specifies what action to
Stop receiving data for this socket. If further data arrives, reject it.
Stop trying to transmit data from this socket. Discard any data waiting to be sent. Stop looking for acknowledgement of data already sent; don’t retransmit it if it is lost.
Stop both reception and transmission.
The return value is
0 on success and
-1 on failure. The
errno error conditions are defined for this function:
socket is not a valid file descriptor.
socket is not a socket.
socket is not connected.