lib/libcr/net/iso_addr.3

   1 .\" Copyright (c) 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)iso_addr.3  8.1 (Berkeley) 6/4/93
  33 .\" $FreeBSD: src/lib/libc/net/iso_addr.3,v 1.3.2.4 2001/12/14 18:33:55 ru Exp $
  34 .\"
  35 .Dd June 4, 1993
  36 .Dt ISO_ADDR 3
  37 .Os
  38 .Sh NAME
  39 .Nm iso_addr ,
  40 .Nm iso_ntoa
  41 .Nd "elementary network address conversion routines for Open System Interconnection
  42 .Sh LIBRARY
  43 .Lb libc
  44 .Sh SYNOPSIS
  45 .In sys/types.h
  46 .In netiso/iso.h
  47 .Ft struct iso_addr *
  48 .Fn iso_addr "char *cp"
  49 .Ft char *
  50 .Fn iso_ntoa "struct iso_addr *isoa"
  51 .Sh DESCRIPTION
  52 The routine
  53 .Fn iso_addr
  54 interprets character strings representing
  55 .Tn OSI
  56 addresses, returning binary information suitable
  57 for use in system calls.
  58 The routine
  59 .Fn iso_ntoa
  60 takes
  61 .Tn OSI
  62 addresses and returns
  63 .Tn ASCII
  64 strings representing NSAPs (network service
  65 access points) in a
  66 notation inverse to that accepted by
  67 .Fn iso_addr .
  68 .Pp
  69 Unfortunately, no universal standard exists for representing
  70 .Tn OSI
  71 network addresses.
  72 .Pp
  73 The format employed by
  74 .Fn iso_addr
  75 is a sequence of hexadecimal
  76 .Dq digits
  77 (optionally separated by periods),
  78 of the form:
  79 .Bd -ragged -offset indent
  80 <hex digits>.<hex digits>.<hex digits>
  81 .Ed
  82 .Pp
  83 Each pair of hexadecimal digits represents a byte
  84 with the leading digit indicating the higher-ordered bits.
  85 A period following an even number of bytes has no
  86 effect (but may be used to increase legibility).
  87 A period following an odd number of bytes has the
  88 effect of causing the byte of address being translated
  89 to have its higher order bits filled with zeros.
  90 .Sh RETURN VALUES
  91 .Fn iso_ntoa
  92 always returns a null terminated string.
  93 .Fn iso_addr
  94 always returns a pointer to a struct iso_addr.
  95 (See
  96 .Sx BUGS . )
  97 .Sh SEE ALSO
  98 .Xr iso 4
  99 .Sh HISTORY
 100 The
 101 .Fn iso_addr
 102 and
 103 .Fn iso_ntoa
 104 functions appeared in
 105 .Bx 4.3 Reno .
 106 .Sh BUGS
 107 The returned values
 108 reside in a static memory area.
 109 .Pp
 110 The function
 111 .Fn iso_addr
 112 should diagnose improperly formed input, and there should be an unambiguous
 113 way to recognize this.