doc/html/ref/net-common-tcpip-manpages-link-addr.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 >link_addr</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="iso_addr"
  26 HREF="net-common-tcpip-manpages-iso-addr.html"><LINK
  27 REL="NEXT"
  28 TITLE="net_addrcmp"
  29 HREF="net-common-tcpip-manpages-net-addrcmp.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-iso-addr.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-net-addrcmp.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-LINK-ADDR">link_addr</H1
  86 ><TABLE
  87 BORDER="5"
  88 BGCOLOR="#E0E0F0"
  89 WIDTH="70%"
  90 ><TR
  91 ><TD
  92 ><PRE
  93 CLASS="SCREEN"
  94 >LINK_ADDR(3)            System Library Functions Manual           LINK_ADDR(3)
  95
  96 NAME
  97      link_addr, link_ntoa - elementary address specification routines for link
  98      level access
  99
 100 SYNOPSIS
 101      #include &lt;sys/types.h&#62;
 102      #include &lt;sys/socket.h&#62;
 103      #include &lt;net/if_dl.h&#62;
 104
 105      void
 106      link_addr(const char *addr, struct sockaddr_dl *sdl);
 107
 108      char *
 109      link_ntoa(const struct sockaddr_dl *sdl);
 110
 111 DESCRIPTION
 112      The link_addr() function interprets character strings representing link-
 113      level addresses, returning binary information suitable for use in system
 114      calls.  link_ntoa() takes a link-level address and returns an ASCII
 115      string representing some of the information present, including the link
 116      level address itself, and the interface name or number, if present.  This
 117      facility is experimental and is still subject to change.
 118
 119      For link_addr(), the string addr may contain an optional network inter-
 120      face identifier of the form ``name unit-number'', suitable for the first
 121      argument to ifconfig(8), followed in all cases by a colon and an inter-
 122      face address in the form of groups of hexadecimal digits separated by
 123      periods.  Each group represents a byte of address; address bytes are
 124      filled left to right from low order bytes through high order bytes.
 125
 126      Thus le0:8.0.9.13.d.30 represents an Ethernet address to be transmitted
 127      on the first Lance Ethernet interface.
 128
 129 RETURN VALUES
 130      link_ntoa() always returns a null-terminated string.  link_addr() has no
 131      return value.  (See BUGS.)
 132
 133 SEE ALSO
 134      iso(4), ifconfig(8)
 135
 136 HISTORY
 137      The link_addr() and link_ntoa() functions appeared in 4.3BSD-Reno.
 138
 139 BUGS
 140      The returned values for link_ntoa reside in a static memory area.
 141
 142      The function link_addr() should diagnose improperly formed input, and
 143      there should be an unambiguous way to recognize this.
 144
 145      If the sdl_len field of the link socket address sdl is 0, link_ntoa()
 146      will not insert a colon before the interface address bytes.  If this
 147      translated address is given to link_addr() without inserting an initial
 148      colon, the latter will not interpret it correctly.
 149
 150 BSD                              July 28, 1993                             BSD
 151     </PRE
 152 ></TD
 153 ></TR
 154 ></TABLE
 155 ></DIV
 156 ><DIV
 157 CLASS="NAVFOOTER"
 158 ><HR
 159 ALIGN="LEFT"
 160 WIDTH="100%"><TABLE
 161 SUMMARY="Footer navigation table"
 162 WIDTH="100%"
 163 BORDER="0"
 164 CELLPADDING="0"
 165 CELLSPACING="0"
 166 ><TR
 167 ><TD
 168 WIDTH="33%"
 169 ALIGN="left"
 170 VALIGN="top"
 171 ><A
 172 HREF="net-common-tcpip-manpages-iso-addr.html"
 173 ACCESSKEY="P"
 174 >Prev</A
 175 ></TD
 176 ><TD
 177 WIDTH="34%"
 178 ALIGN="center"
 179 VALIGN="top"
 180 ><A
 181 HREF="ecos-ref.html"
 182 ACCESSKEY="H"
 183 >Home</A
 184 ></TD
 185 ><TD
 186 WIDTH="33%"
 187 ALIGN="right"
 188 VALIGN="top"
 189 ><A
 190 HREF="net-common-tcpip-manpages-net-addrcmp.html"
 191 ACCESSKEY="N"
 192 >Next</A
 193 ></TD
 194 ></TR
 195 ><TR
 196 ><TD
 197 WIDTH="33%"
 198 ALIGN="left"
 199 VALIGN="top"
 200 >iso_addr</TD
 201 ><TD
 202 WIDTH="34%"
 203 ALIGN="center"
 204 VALIGN="top"
 205 ><A
 206 HREF="tcpip-library-reference.html"
 207 ACCESSKEY="U"
 208 >Up</A
 209 ></TD
 210 ><TD
 211 WIDTH="33%"
 212 ALIGN="right"
 213 VALIGN="top"
 214 >net_addrcmp</TD
 215 ></TR
 216 ></TABLE
 217 ></DIV
 218 ></BODY
 219 ></HTML
 220 >