Manpage of GETNSAPBYNAME

GETNSAPBYNAME

Section: OpenSS7 ISO Stack Library Calls (3)
Updated: 2008-10-31
Index Return to Main Contents

NAME

getnsapbyname - get the NSAP that corresponds to a host name

SYNOPSIS

#include <tiuser.h>
#include <osi.h>

int getnsapbynam(int nsap_maxlen, char *hostname, char *nsap);

ARGUMENTS

nsap_maxlen: the maximum length of the buffer pointed to by nsap.
hostname: the (null terminated) host name to translate to an NSAP.
nsap: a pointer to a buffer of maximum length nsap_maxlen that is to receive the NSAP corresponding to hostname.

DESCRIPTION

The libosi user library provides a mechanism for setting local and remote addresses using the host name of the machine. This avoids the need for users of applications to deal with NSAPs and TSAPs. The library usese the file /etc/net/oclt/host for host name to NSAP conversion, and the fie /etc/net/oclt/services for hostname to TSEL conversion.

getnsapbyname () translates a host name in the string pointed to by the hostname
argumentintoanNSAPthatistransferredintothebufferpointedtobythe nsap argument of maximum length nsap_maxlen.

RETURN

When successful, getnsapbyname() returns the positive length of the NSAP in octets; when unsuccessful, minus one (-1).

ERRORS

When unsuccessful, getnsapbyname() returns minus one, (-1) and sets errno(3) to an appropriate error number.

EXAMPLES

The following example demonstrates placing the NSAP in a netbuf and using it to connect a /dev/otpi Stream:

FILES

/etc/net/oclt/host: configuration file for host name to NSAP conversion.
/etc/net/oclt/services: configuration file for Service Name to TSEL conversion.
/usr/lib/libosi.a, /usr/lib/libosi.so: the OSI library containing the getnsapbyname() function.

COMPATIBILITY

getnsapbyname() is compatible with SunLink OSI with the following portability considerations:

---: This function is a Solaris®-specific function that is implemented by OpenSS7 ISO Stack to assist with porting SunLink OSI applications programs to OpenSS7 ISO Stack.
: getnsapbyname() will not be used by portable programs.
---: Although not POSIX, the Sun TI-RPC function netdir_getbyname(3) with only a host name is probably more portable.
: getnsapbyname() will not be used by portable programs.

See libosi(3), for additional compatibility information.

CONFORMANCE

SunLink OSI documentation[1].

HISTORY

getnsapbyname() first appeared in SunLink OSI[1].

REFERENCES

[1]: Solaris® SunLink OSI, SunLink® OSI 8.1 TLI Programmer's Reference, Revision A, March 1995, (Mountain View, California), Sun Microsystems, Inc., Sun. [Part No: 801-7170-12] <http://docs.sun.com/>

TRADEMARKS

OpenSS7tm: is a trademark of OpenSS7 Corporation.
Linux®: is a registered trademark of Linus Torvalds.
UNIX®: is a registered trademark of The Open Group.
Solaris®: is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

OpenSS7 ISO Stack: Package striso version 0.9.2.4 released 2008-10-31.

This document was created by man2html, using the manual pages.
Time: 01:49:15 GMT, May 23, 2013