doc/html/ref/net-common-tcpip-manpages-iso-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 >iso_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="ipx"
  26 HREF="net-common-tcpip-manpages-ipx.html"><LINK
  27 REL="NEXT"
  28 TITLE="link_addr"
  29 HREF="net-common-tcpip-manpages-link-addr.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-ipx.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-link-addr.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-ISO-ADDR">iso_addr</H1
  86 ><TABLE
  87 BORDER="5"
  88 BGCOLOR="#E0E0F0"
  89 WIDTH="70%"
  90 ><TR
  91 ><TD
  92 ><PRE
  93 CLASS="SCREEN"
  94 >ISO_ADDR(3)             System Library Functions Manual            ISO_ADDR(3)
  95
  96 NAME
  97      iso_addr, iso_ntoa - network address conversion routines for Open System
  98      Interconnection
  99
 100 SYNOPSIS
 101      #include &lt;sys/types.h&#62;
 102      #include &lt;netiso/iso.h&#62;
 103
 104      struct iso_addr *
 105      iso_addr(char *cp);
 106
 107      char *
 108      iso_ntoa(struct iso_addr *isoa);
 109
 110 DESCRIPTION
 111      The routine iso_addr() interprets character strings representing OSI
 112      addresses, returning binary information suitable for use in system calls.
 113      The routine iso_ntoa() takes OSI addresses and returns ASCII strings rep-
 114      resenting NSAPs (network service access points) in a notation inverse to
 115      that accepted by iso_addr().
 116
 117      Unfortunately, no universal standard exists for representing OSI network
 118      addresses.
 119
 120      The format employed by iso_addr() is a sequence of hexadecimal ``digits''
 121      (optionally separated by periods), of the form:
 122
 123            &lt;hex digits&#62;.&lt;hex digits&#62;.&lt;hex digits&#62;
 124
 125      Each pair of hexadecimal digits represents a byte with the leading digit
 126      indicating the higher-ordered bits.  A period following an even number of
 127      bytes has no effect (but may be used to increase legibility).  A period
 128      following an odd number of bytes has the effect of causing the byte of
 129      address being translated to have its higher order bits filled with zeros.
 130
 131 RETURN VALUES
 132      iso_ntoa() always returns a null terminated string.  iso_addr() always
 133      returns a pointer to a struct iso_addr.  (See BUGS.)
 134
 135 SEE ALSO
 136      iso(4)
 137
 138 HISTORY
 139      The iso_addr() and iso_ntoa() functions appeared in 4.3BSD-Reno.
 140
 141 BUGS
 142      The returned values reside in a static memory area.
 143
 144      The function iso_addr() should diagnose improperly formed input, and
 145      there should be an unambiguous way to recognize this.
 146
 147 BSD                              June 4, 1993                              BSD
 148     </PRE
 149 ></TD
 150 ></TR
 151 ></TABLE
 152 ></DIV
 153 ><DIV
 154 CLASS="NAVFOOTER"
 155 ><HR
 156 ALIGN="LEFT"
 157 WIDTH="100%"><TABLE
 158 SUMMARY="Footer navigation table"
 159 WIDTH="100%"
 160 BORDER="0"
 161 CELLPADDING="0"
 162 CELLSPACING="0"
 163 ><TR
 164 ><TD
 165 WIDTH="33%"
 166 ALIGN="left"
 167 VALIGN="top"
 168 ><A
 169 HREF="net-common-tcpip-manpages-ipx.html"
 170 ACCESSKEY="P"
 171 >Prev</A
 172 ></TD
 173 ><TD
 174 WIDTH="34%"
 175 ALIGN="center"
 176 VALIGN="top"
 177 ><A
 178 HREF="ecos-ref.html"
 179 ACCESSKEY="H"
 180 >Home</A
 181 ></TD
 182 ><TD
 183 WIDTH="33%"
 184 ALIGN="right"
 185 VALIGN="top"
 186 ><A
 187 HREF="net-common-tcpip-manpages-link-addr.html"
 188 ACCESSKEY="N"
 189 >Next</A
 190 ></TD
 191 ></TR
 192 ><TR
 193 ><TD
 194 WIDTH="33%"
 195 ALIGN="left"
 196 VALIGN="top"
 197 >ipx</TD
 198 ><TD
 199 WIDTH="34%"
 200 ALIGN="center"
 201 VALIGN="top"
 202 ><A
 203 HREF="tcpip-library-reference.html"
 204 ACCESSKEY="U"
 205 >Up</A
 206 ></TD
 207 ><TD
 208 WIDTH="33%"
 209 ALIGN="right"
 210 VALIGN="top"
 211 >link_addr</TD
 212 ></TR
 213 ></TABLE
 214 ></DIV
 215 ></BODY
 216 ></HTML
 217 >