doc/html/ref/net-common-tcpip-manpages-shutdown.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >shutdown</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="TCP/IP Library Reference"
  23 HREF="tcpip-library-reference.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="send"
  26 HREF="net-common-tcpip-manpages-send.html"><LINK
  27 REL="NEXT"
  28 TITLE="socket"
  29 HREF="net-common-tcpip-manpages-socket.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="net-common-tcpip-manpages-send.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 38. TCP/IP Library Reference</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="net-common-tcpip-manpages-socket.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="NET-COMMON-TCPIP-MANPAGES-SHUTDOWN">shutdown</H1
  86 ><TABLE
  87 BORDER="5"
  88 BGCOLOR="#E0E0F0"
  89 WIDTH="70%"
  90 ><TR
  91 ><TD
  92 ><PRE
  93 CLASS="SCREEN"
  94 >SHUTDOWN(2)                   System Calls Manual                  SHUTDOWN(2)
  95
  96 NAME
  97      shutdown - shut down part of a full-duplex connection
  98
  99 SYNOPSIS
 100      #include &lt;sys/types.h&#62;
 101      #include &lt;sys/socket.h&#62;
 102
 103      int
 104      shutdown(int s, int how);
 105
 106 DESCRIPTION
 107      The shutdown() call causes all or part of a full-duplex connection on the
 108      socket associated with s to be shut down.  If how is SHUT_RD, further
 109      receives will be disallowed.  If how is SHUT_WR, further sends will be
 110      disallowed.  If how is SHUT_RDWR, further sends and receives will be dis-
 111      allowed.
 112
 113 RETURN VALUES
 114      A 0 is returned if the call succeeds, -1 if it fails.
 115
 116 ERRORS
 117      The call succeeds unless:
 118
 119      [EINVAL]           how is not SHUT_RD, SHUT_WR, or SHUT_RDWR.
 120
 121      [EBADF]            s is not a valid descriptor.
 122
 123      [ENOTSOCK]         s is a file, not a socket.
 124
 125      [ENOTCONN]         The specified socket is not connected.
 126
 127 SEE ALSO
 128      connect(2), socket(2)
 129
 130 HISTORY
 131      The shutdown() function call appeared in 4.2BSD.  The how arguments used
 132      to be simply 0, 1, and 2, but now have named values as specified by
 133      X/Open Portability Guide Issue 4 (``XPG4'').
 134
 135 BSD                              June 4, 1993                              BSD
 136     </PRE
 137 ></TD
 138 ></TR
 139 ></TABLE
 140 ></DIV
 141 ><DIV
 142 CLASS="NAVFOOTER"
 143 ><HR
 144 ALIGN="LEFT"
 145 WIDTH="100%"><TABLE
 146 SUMMARY="Footer navigation table"
 147 WIDTH="100%"
 148 BORDER="0"
 149 CELLPADDING="0"
 150 CELLSPACING="0"
 151 ><TR
 152 ><TD
 153 WIDTH="33%"
 154 ALIGN="left"
 155 VALIGN="top"
 156 ><A
 157 HREF="net-common-tcpip-manpages-send.html"
 158 ACCESSKEY="P"
 159 >Prev</A
 160 ></TD
 161 ><TD
 162 WIDTH="34%"
 163 ALIGN="center"
 164 VALIGN="top"
 165 ><A
 166 HREF="ecos-ref.html"
 167 ACCESSKEY="H"
 168 >Home</A
 169 ></TD
 170 ><TD
 171 WIDTH="33%"
 172 ALIGN="right"
 173 VALIGN="top"
 174 ><A
 175 HREF="net-common-tcpip-manpages-socket.html"
 176 ACCESSKEY="N"
 177 >Next</A
 178 ></TD
 179 ></TR
 180 ><TR
 181 ><TD
 182 WIDTH="33%"
 183 ALIGN="left"
 184 VALIGN="top"
 185 >send</TD
 186 ><TD
 187 WIDTH="34%"
 188 ALIGN="center"
 189 VALIGN="top"
 190 ><A
 191 HREF="tcpip-library-reference.html"
 192 ACCESSKEY="U"
 193 >Up</A
 194 ></TD
 195 ><TD
 196 WIDTH="33%"
 197 ALIGN="right"
 198 VALIGN="top"
 199 >socket</TD
 200 ></TR
 201 ></TABLE
 202 ></DIV
 203 ></BODY
 204 ></HTML
 205 >