1.\" Copyright (c) 1993 The Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)iso_addr.3 5.2 (Berkeley) 01/29/93 7.\" 8.Dd 9.Dt ISO_ADDR 3 10.Os BSD 4.4 11.Sh NAME 12.Nm iso_addr , 13.Nm iso_ntoa 14.Nd Elementary 15network address conversion routines for Open System Interconnection. 16.Sh SYNOPSIS 17.Fd #include <sys/types.h> 18.Fd #include <netiso/iso.h> 19.Ft struct iso_addr * 20.Fn iso_addr "char *cp" 21.Ft char * 22.Fn iso_ntoa "struct iso_addr *isoa" 23.Sh DESCRIPTION 24The routine 25.Fn iso_addr 26interprets character strings representing 27.Tn OSI 28addresses, returning binary information suitable 29for use in system calls. 30The routine 31.Fn iso_ntoa 32takes 33.Tn OSI 34addresses and returns 35.Tn ASCII 36strings representing NSAPs (network service 37access points) in a 38notation inverse to that accepted by 39.Fn iso_addr . 40.Pp 41Unfortunately, no universal standard exists for representing 42.Tn OSI 43network addresses. 44.Pp 45The format employed by 46.Fn iso_addr 47is a sequence of hexadecimal 48.Dq digits 49(optionally separated by periods), 50of the form: 51.Bd -filled -offset indent 52<hex digits>.<hex digits>.<hex digits> 53.Ed 54.Pp 55Each pair of hexadecimal digits represents a byte 56with the leading digit indicating the higher-ordered bits. 57A period following an even number of bytes has no 58effect (but may be used to increase legitibility). 59A period following an odd number of bytes has the 60effective of filling the byte of address being translated 61to have its higher order bits filled with zeros. 62.Sh RETURN VALUES 63.Fn iso_ntoa 64always returns a null terminated string. 65.Fn iso_addr 66always returns a pointer to a struct iso_addr. 67(See 68.Sx BUGS . ) 69.Sh SEE ALSO 70.Xr iso 4 , 71.Sh HISTORY 72The 73.Fn iso_addr 74and 75.Fn iso_ntoa 76functions appeared in 77.Bx 4.3 Reno . 78.Sh BUGS 79The returned values 80reside in a static memory area. 81The function 82.Fn iso_addr 83should diagnose improperly formed input, and there should be an unambiguous 84way to recognize this. 85