Manpage of SHUTDOWN

Description: Manual Page

Keywords: ss7 ss7/ip ss7 over ip ss7 mtp ss7 sccp ss7 tcap sigtran mtp sccp tcap openss7 acb56 linux telephony pstn linux telephony linux nebs linux compactpci

---

SHUTDOWN

Section: OpenSS7 STREAMS Sockets Library Calls (3)
Updated: 2008-10-31
Index Return to Main Contents

---

NAME

shutdown - shut down socket send and receive operations

SYNOPSIS

#include <sys/socket.h>

int shutdown(int socket, int how);

ARGUMENTS

The function takes the following arguments:

socket

Specifies the file descriptor of the socket.

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.

DESCRIPTION

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

CAVEATS

This system call is implemented as a SIOCSOCKSYS IOCTL. See socksys(4) for more information.

RETURN VALUE

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(4) resources available for the operation to complete.

SEE ALSO

getsockopt(3), read(2), recv(3), recvfrom(3), recvmsg(3), select(2), send(3), sendto(3), setsockopt(3), socket(3), write(2), <sys/socket.h>.

COMPATIBILITY

This function and sockets implementation is compatible to SVR 4.2[1], and implementations based on SVR 4.2, including Solaris®[2], with the following portability considerations:

---

Where 4BSD differs from POSIX, this function follows POSIX[3].

See sockets(3) and socklib(3) for more compatibility information.

CONFORMING TO

The Open Group XNS Issue 5.2[4].

HISTORY

Most sockets functions first appeared in 4BSD.

REFERENCES

[1]

SVR 4.2, UNIX® System V Release 4.2 Programmer's Manual, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.

[2]

Solaris® 8, Solaris 8 Docmentation, 2001, (Santa Clara, California), Sun Microsystems, Inc., Sun. <http://docs.sun.com/>

[3]

SUS Version 3, Single UNIX Specification, OpenGroup, Open Group Publication. <http://www.opengroup.org/onlinepubs/>

[4]

XNS, Open Group CAE Specification: Technical Standard: Network Services (XNS), Issue 5.2, Draft 2, 1999, (Berkshire, UK), OpenGroup, Open Group Publication. [ISBN 1-85912-241-8] <http://www.opengroup.org/onlinepubs/>

TRADEMARKS

OpenSS7tm

is a trademark of OpenSS7 Corporation.

Linux®

is a registered trademark of Linus Torvalds.

UNIX®

is a registered trademark of The Open Group.

Solaris®

is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

OpenSS7 STREAMS Sockets: Package strsock version 0.9.2.4 released 2008-10-31.

Copyright©1997-2008OpenSS7 Corp. All Rights Reserved.
(See roff source for permission notice.)

---

Index

NAME

SYNOPSIS

ARGUMENTS

DESCRIPTION

CAVEATS

RETURN VALUE

ERRORS

SEE ALSO

COMPATIBILITY

CONFORMING TO

HISTORY

REFERENCES

TRADEMARKS

IDENTIFICATION

---

This document was created by man2html, using the manual pages.
Time: 04:26:43 GMT, May 21, 2013