doc/html/ref/tcpip-library-reference.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 >TCP/IP Library Reference</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 Stack Support for eCos"
  23 HREF="net-common-tcpip.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="DHCP"
  26 HREF="net-common-dhcp.html"><LINK
  27 REL="NEXT"
  28 TITLE="gethostname"
  29 HREF="net-common-tcpip-manpages-gethostname.html"></HEAD
  30 ><BODY
  31 CLASS="CHAPTER"
  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-dhcp.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 ></TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="net-common-tcpip-manpages-gethostname.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="CHAPTER"
  82 ><H1
  83 ><A
  84 NAME="TCPIP-LIBRARY-REFERENCE">Chapter 38. TCP/IP Library Reference</H1
  85 ><DIV
  86 CLASS="TOC"
  87 ><DL
  88 ><DT
  89 ><B
  90 >Table of Contents</B
  91 ></DT
  92 ><DT
  93 ><A
  94 HREF="tcpip-library-reference.html#NET-COMMON-TCPIP-MANPAGES-GETDOMAINNAME"
  95 >getdomainname</A
  96 ></DT
  97 ><DT
  98 ><A
  99 HREF="net-common-tcpip-manpages-gethostname.html"
 100 >gethostname</A
 101 ></DT
 102 ><DT
 103 ><A
 104 HREF="net-common-tcpip-manpages-byteorder.html"
 105 >byteorder</A
 106 ></DT
 107 ><DT
 108 ><A
 109 HREF="net-common-tcpip-manpages-ethers.html"
 110 >ethers</A
 111 ></DT
 112 ><DT
 113 ><A
 114 HREF="net-common-tcpip-manpages-getaddrinfo.html"
 115 >getaddrinfo</A
 116 ></DT
 117 ><DT
 118 ><A
 119 HREF="net-common-tcpip-manpages-gethostbyname.html"
 120 >gethostbyname</A
 121 ></DT
 122 ><DT
 123 ><A
 124 HREF="net-common-tcpip-manpages-getifaddrs.html"
 125 >getifaddrs</A
 126 ></DT
 127 ><DT
 128 ><A
 129 HREF="net-common-tcpip-manpages-getnameinfo.html"
 130 >getnameinfo</A
 131 ></DT
 132 ><DT
 133 ><A
 134 HREF="net-common-tcpip-manpages-getnetent.html"
 135 >getnetent</A
 136 ></DT
 137 ><DT
 138 ><A
 139 HREF="net-common-tcpip-manpages-getprotoent.html"
 140 >getprotoent</A
 141 ></DT
 142 ><DT
 143 ><A
 144 HREF="net-common-tcpip-manpages-getrrsetbyname.html"
 145 >getrrsetbyname</A
 146 ></DT
 147 ><DT
 148 ><A
 149 HREF="net-common-tcpip-manpages-getservent.html"
 150 >getservent</A
 151 ></DT
 152 ><DT
 153 ><A
 154 HREF="net-common-tcpip-manpages-if-nametoindex.html"
 155 >if_nametoindex</A
 156 ></DT
 157 ><DT
 158 ><A
 159 HREF="net-common-tcpip-manpages-inet.html"
 160 >inet</A
 161 ></DT
 162 ><DT
 163 ><A
 164 HREF="net-common-tcpip-manpages-inet6-option-space.html"
 165 >inet6_option_space</A
 166 ></DT
 167 ><DT
 168 ><A
 169 HREF="net-common-tcpip-manpages-inet6-rthdr-space.html"
 170 >inet6_rthdr_space</A
 171 ></DT
 172 ><DT
 173 ><A
 174 HREF="net-common-tcpip-manpages-inet-net.html"
 175 >inet_net</A
 176 ></DT
 177 ><DT
 178 ><A
 179 HREF="net-common-tcpip-manpages-ipx.html"
 180 >ipx</A
 181 ></DT
 182 ><DT
 183 ><A
 184 HREF="net-common-tcpip-manpages-iso-addr.html"
 185 >iso_addr</A
 186 ></DT
 187 ><DT
 188 ><A
 189 HREF="net-common-tcpip-manpages-link-addr.html"
 190 >link_addr</A
 191 ></DT
 192 ><DT
 193 ><A
 194 HREF="net-common-tcpip-manpages-net-addrcmp.html"
 195 >net_addrcmp</A
 196 ></DT
 197 ><DT
 198 ><A
 199 HREF="net-common-tcpip-manpages-ns.html"
 200 >ns</A
 201 ></DT
 202 ><DT
 203 ><A
 204 HREF="net-common-tcpip-manpages-resolver.html"
 205 >resolver</A
 206 ></DT
 207 ><DT
 208 ><A
 209 HREF="net-common-tcpip-manpages-accept.html"
 210 >accept</A
 211 ></DT
 212 ><DT
 213 ><A
 214 HREF="net-common-tcpip-manpages-bind.html"
 215 >bind</A
 216 ></DT
 217 ><DT
 218 ><A
 219 HREF="net-common-tcpip-manpages-connect.html"
 220 >connect</A
 221 ></DT
 222 ><DT
 223 ><A
 224 HREF="net-common-tcpip-manpages-getpeername.html"
 225 >getpeername</A
 226 ></DT
 227 ><DT
 228 ><A
 229 HREF="net-common-tcpip-manpages-getsockname.html"
 230 >getsockname</A
 231 ></DT
 232 ><DT
 233 ><A
 234 HREF="net-common-tcpip-manpages-getsockopt.html"
 235 >getsockopt</A
 236 ></DT
 237 ><DT
 238 ><A
 239 HREF="net-common-tcpip-manpages-ioctl.html"
 240 >ioctl</A
 241 ></DT
 242 ><DT
 243 ><A
 244 HREF="net-common-tcpip-manpages-poll.html"
 245 >poll</A
 246 ></DT
 247 ><DT
 248 ><A
 249 HREF="net-common-tcpip-manpages-select.html"
 250 >select</A
 251 ></DT
 252 ><DT
 253 ><A
 254 HREF="net-common-tcpip-manpages-send.html"
 255 >send</A
 256 ></DT
 257 ><DT
 258 ><A
 259 HREF="net-common-tcpip-manpages-shutdown.html"
 260 >shutdown</A
 261 ></DT
 262 ><DT
 263 ><A
 264 HREF="net-common-tcpip-manpages-socket.html"
 265 >socket</A
 266 ></DT
 267 ><DT
 268 ><A
 269 HREF="net-common-tcpip-manpages-socketpair.html"
 270 >socketpair</A
 271 ></DT
 272 ></DL
 273 ></DIV
 274 ><DIV
 275 CLASS="SECT1"
 276 ><H1
 277 CLASS="SECT1"
 278 ><A
 279 NAME="NET-COMMON-TCPIP-MANPAGES-GETDOMAINNAME">getdomainname</H1
 280 ><TABLE
 281 BORDER="5"
 282 BGCOLOR="#E0E0F0"
 283 WIDTH="70%"
 284 ><TR
 285 ><TD
 286 ><PRE
 287 CLASS="SCREEN"
 288 >GETDOMAINNAME(3)        System Library Functions Manual       GETDOMAINNAME(3)
 289
 290 NAME
 291      getdomainname, setdomainname - get/set YP domain name of current host
 292
 293 SYNOPSIS
 294      #include &lt;unistd.h&#62;
 295
 296      int
 297      getdomainname(char *name, size_t namelen);
 298
 299      int
 300      setdomainname(const char *name, size_t namelen);
 301
 302 DESCRIPTION
 303      The getdomainname() function returns the YP domain name for the current
 304      processor, as previously set by setdomainname().  The parameter namelen
 305      specifies the size of the name array.  If insufficient space is provided,
 306      the returned name is truncated.  The returned name is always null termi-
 307      nated.
 308
 309      setdomainname() sets the domain name of the host machine to be name,
 310      which has length namelen.  This call is restricted to the superuser and
 311      is normally used only when the system is bootstrapped.
 312
 313 RETURN VALUES
 314      If the call succeeds a value of 0 is returned.  If the call fails, a
 315      value of -1 is returned and an error code is placed in the global vari-
 316      able errno.
 317
 318 ERRORS
 319      The following errors may be returned by these calls:
 320
 321      [EFAULT]           The name or namelen parameter gave an invalid address.
 322
 323      [EPERM]            The caller tried to set the domain name and was not
 324                         the superuser.
 325
 326 SEE ALSO
 327      domainname(1), gethostid(3), gethostname(3), sysctl(3), sysctl(8), yp(8)
 328
 329 BUGS
 330      Domain names are limited to MAXHOSTNAMELEN (from &lt;sys/param.h&#62;) charac-
 331      ters, currently 256.  This includes the terminating NUL character.
 332
 333      If the buffer passed to getdomainname() is too small, other operating
 334      systems may not guarantee termination with NUL.
 335
 336 HISTORY
 337      The getdomainname function call appeared in SunOS 3.x.
 338
 339 BSD                               May 6, 1994                              BSD
 340     </PRE
 341 ></TD
 342 ></TR
 343 ></TABLE
 344 ></DIV
 345 ></DIV
 346 ><DIV
 347 CLASS="NAVFOOTER"
 348 ><HR
 349 ALIGN="LEFT"
 350 WIDTH="100%"><TABLE
 351 SUMMARY="Footer navigation table"
 352 WIDTH="100%"
 353 BORDER="0"
 354 CELLPADDING="0"
 355 CELLSPACING="0"
 356 ><TR
 357 ><TD
 358 WIDTH="33%"
 359 ALIGN="left"
 360 VALIGN="top"
 361 ><A
 362 HREF="net-common-dhcp.html"
 363 ACCESSKEY="P"
 364 >Prev</A
 365 ></TD
 366 ><TD
 367 WIDTH="34%"
 368 ALIGN="center"
 369 VALIGN="top"
 370 ><A
 371 HREF="ecos-ref.html"
 372 ACCESSKEY="H"
 373 >Home</A
 374 ></TD
 375 ><TD
 376 WIDTH="33%"
 377 ALIGN="right"
 378 VALIGN="top"
 379 ><A
 380 HREF="net-common-tcpip-manpages-gethostname.html"
 381 ACCESSKEY="N"
 382 >Next</A
 383 ></TD
 384 ></TR
 385 ><TR
 386 ><TD
 387 WIDTH="33%"
 388 ALIGN="left"
 389 VALIGN="top"
 390 >DHCP</TD
 391 ><TD
 392 WIDTH="34%"
 393 ALIGN="center"
 394 VALIGN="top"
 395 ><A
 396 HREF="net-common-tcpip.html"
 397 ACCESSKEY="U"
 398 >Up</A
 399 ></TD
 400 ><TD
 401 WIDTH="33%"
 402 ALIGN="right"
 403 VALIGN="top"
 404 >gethostname</TD
 405 ></TR
 406 ></TABLE
 407 ></DIV
 408 ></BODY
 409 ></HTML
 410 >