157740Ssklower.\" Copyright (c) 1993 The Regents of the University of California. 257740Ssklower.\" All rights reserved. 357740Ssklower.\" 457740Ssklower.\" %sccs.include.redist.man% 557740Ssklower.\" 6*57742Ssklower.\" @(#)iso_addr.3 5.2 (Berkeley) 01/29/93 757740Ssklower.\" 857740Ssklower.Dd 957740Ssklower.Dt ISO_ADDR 3 1057740Ssklower.Os BSD 4.4 1157740Ssklower.Sh NAME 1257740Ssklower.Nm iso_addr , 1357740Ssklower.Nm iso_ntoa 1457740Ssklower.Nd Elementary 1557740Ssklowernetwork address conversion routines for Open System Interconnection. 1657740Ssklower.Sh SYNOPSIS 1757740Ssklower.Fd #include <sys/types.h> 1857740Ssklower.Fd #include <netiso/iso.h> 1957740Ssklower.Ft struct iso_addr * 2057740Ssklower.Fn iso_addr "char *cp" 2157740Ssklower.Ft char * 2257740Ssklower.Fn iso_ntoa "struct iso_addr *isoa" 2357740Ssklower.Sh DESCRIPTION 2457740SsklowerThe routine 2557740Ssklower.Fn iso_addr 2657740Ssklowerinterprets character strings representing 2757740Ssklower.Tn OSI 2857740Sskloweraddresses, returning binary information suitable 2957740Ssklowerfor use in system calls. 3057740SsklowerThe routine 3157740Ssklower.Fn iso_ntoa 3257740Ssklowertakes 3357740Ssklower.Tn OSI 3457740Sskloweraddresses and returns 3557740Ssklower.Tn ASCII 3657740Ssklowerstrings representing NSAPs (network service 3757740Sskloweraccess points) in a 3857740Ssklowernotation inverse to that accepted by 3957740Ssklower.Fn iso_addr . 4057740Ssklower.Pp 4157740SsklowerUnfortunately, no universal standard exists for representing 4257740Ssklower.Tn OSI 4357740Ssklowernetwork addresses. 4457740Ssklower.Pp 4557740SsklowerThe format employed by 4657740Ssklower.Fn iso_addr 4757740Sskloweris a sequence of hexadecimal 4857740Ssklower.Dq digits 4957740Ssklower(optionally separated by periods), 5057740Ssklowerof the form: 5157740Ssklower.Bd -filled -offset indent 5257740Ssklower<hex digits>.<hex digits>.<hex digits> 5357740Ssklower.Ed 5457740Ssklower.Pp 5557740SsklowerEach pair of hexadecimal digits represents a byte 5657740Ssklowerwith the leading digit indicating the higher-ordered bits. 5757740SsklowerA period following an even number of bytes has no 5857740Ssklowereffect (but may be used to increase legitibility). 5957740SsklowerA period following an odd number of bytes has the 6057740Ssklowereffective of filling the byte of address being translated 6157740Ssklowerto have its higher order bits filled with zeros. 6257740Ssklower.Sh RETURN VALUES 6357740Ssklower.Fn iso_ntoa 6457740Sskloweralways returns a null terminated string. 6557740Ssklower.Fn iso_addr 6657740Sskloweralways returns a pointer to a struct iso_addr. 6757740Ssklower(See 6857740Ssklower.Sx BUGS . ) 6957740Ssklower.Sh SEE ALSO 7057740Ssklower.Xr iso 4 , 7157740Ssklower.Sh HISTORY 7257740SsklowerThe 7357740Ssklower.Fn iso_addr 7457740Ssklowerand 75*57742Ssklower.Fn iso_ntoa 7657740Ssklowerfunctions appeared in 7757740Ssklower.Bx 4.3 Reno . 7857740Ssklower.Sh BUGS 7957740SsklowerThe returned values 8057740Ssklowerreside in a static memory area. 8157740SsklowerThe function 8257740Ssklower.Fn iso_addr 8357740Ssklowershould diagnose improperly formed input, and there should be an unambiguous 8457740Ssklowerway to recognize this. 85