doc/html/ref/net-common-tcpip-manpages-ipx.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 >ipx</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="inet_net"
  26 HREF="net-common-tcpip-manpages-inet-net.html"><LINK
  27 REL="NEXT"
  28 TITLE="iso_addr"
  29 HREF="net-common-tcpip-manpages-iso-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-inet-net.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-iso-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-IPX">ipx</H1
  86 ><TABLE
  87 BORDER="5"
  88 BGCOLOR="#E0E0F0"
  89 WIDTH="70%"
  90 ><TR
  91 ><TD
  92 ><PRE
  93 CLASS="SCREEN"
  94 >IPX(3)                  System Library Functions Manual                 IPX(3)
  95
  96 NAME
  97      ipx_addr, ipx_ntoa - IPX address conversion routines
  98
  99 SYNOPSIS
 100      #include &lt;sys/types.h&#62;
 101      #include &lt;netipx/ipx.h&#62;
 102
 103      struct ipx_addr
 104      ipx_addr(const char *cp);
 105
 106      char *
 107      ipx_ntoa(struct ipx_addr ipx);
 108
 109 DESCRIPTION
 110      The routine ipx_addr() interprets character strings representing IPX
 111      addresses, returning binary information suitable for use in system calls.
 112      The routine ipx_ntoa() takes IPX addresses and returns ASCII strings rep-
 113      resenting the address in a notation in common use:
 114
 115            &lt;network number&#62;.&lt;host number&#62;.&lt;port number&#62;
 116
 117      Trailing zero fields are suppressed, and each number is printed in hex-
 118      adecimal, in a format suitable for input to ipx_addr().  Any fields lack-
 119      ing super-decimal digits will have a trailing `H' appended.
 120
 121      An effort has been made to ensure that ipx_addr() be compatible with most
 122      formats in common use.  It will first separate an address into 1 to 3
 123      fields using a single delimiter chosen from period (`.'), colon (`:'), or
 124      pound-sign (`#').  Each field is then examined for byte separators (colon
 125      or period).  If there are byte separators, each subfield separated is
 126      taken to be a small hexadecimal number, and the entirety is taken as a
 127      network-byte-ordered quantity to be zero extended in the high-network-
 128      order bytes.  Next, the field is inspected for hyphens, in which case the
 129      field is assumed to be a number in decimal notation with hyphens separat-
 130      ing the millenia.  Next, the field is assumed to be a number: It is
 131      interpreted as hexadecimal if there is a leading `0x' (as in C), a trail-
 132      ing `H' (as in Mesa), or there are any super-decimal digits present.  It
 133      is interpreted as octal is there is a leading `0' and there are no super-
 134      octal digits.  Otherwise, it is converted as a decimal number.
 135
 136 RETURN VALUES
 137      None.  (See BUGS.)
 138
 139 SEE ALSO
 140      ns(4), hosts(5), networks(5)
 141
 142 HISTORY
 143      The precursor ns_addr() and ns_ntoa() functions appeared in 4.3BSD.
 144
 145 BUGS
 146      The string returned by ipx_ntoa() resides in a static memory area.  The
 147      function ipx_addr() should diagnose improperly formed input, and there
 148      should be an unambiguous way to recognize this.
 149
 150 BSD                              June 4, 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-inet-net.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-iso-addr.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 >inet_net</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 >iso_addr</TD
 215 ></TR
 216 ></TABLE
 217 ></DIV
 218 ></BODY
 219 ></HTML
 220 >