Проект OpenNet: MAN eui64_ntohost (3) Библиотечные вызовы (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

eui64_ntohost (3)

>> eui64_ntohost (3) ( FreeBSD man: Библиотечные вызовы )

BSD mandoc

NAME



eui64

 

eui64_aton

 
eui64_ntoa

 
eui64_ntohost

 
eui64_hostton

 - IEEE EUI-64 conversion and lookup routines

LIBRARY

Lb libc

SYNOPSIS

#include <sys/types.h>
#include <sys/eui64.h>
int eui64_aton (const char *a struct eui64 *e);
int eui64_ntoa (const struct eui64 *id char *a size_t len);
int eui64_ntohost (char *hostname size_t len const struct eui64 *id);
int eui64_hostton (const char *hostname struct eui64 *id);

DESCRIPTION

These functions operate on IEEE EUI-64s using an Vt eui64 structure, which is defined in the header file In sys/eui64.h :

/*
 * The number of bytes in an EUI-64.
 */
#define EUI64_LEN               8

/*
 * Structure of an IEEE EUI-64.
 */
struct  eui64 {
        u_char octet[EUI64_LEN];
};

The eui64_aton ();
function converts an ASCII representation of an EUI-64 into an Vt eui64 structure. Likewise, eui64_ntoa ();
converts an EUI-64 specified as an Vt eui64 structure into an ASCII string.

The eui64_ntohost ();
and eui64_hostton ();
functions map EUI-64s to their corresponding hostnames as specified in the /etc/eui64 database. The eui64_ntohost ();
function converts from EUI-64 to hostname, and eui64_hostton ();
converts from hostname to EUI-64.

RETURN VALUES

On success, eui64_ntoa ();
returns a pointer to a string containing an ASCII representation of an EUI-64. If it is unable to convert the supplied Vt eui64 structure, it returns a NULL pointer. Likewise, eui64_aton ();
returns a pointer to an Vt eui64 structure on success and a NULL pointer on failure.

The eui64_ntohost ();
and eui64_hostton ();
functions both return zero on success or non-zero if they were unable to find a match in the /etc/eui64 database.

NOTES

The user must insure that the hostname strings passed to the eui64_ntohost ();
and eui64_hostton ();
functions are large enough to contain the returned hostnames.

NIS INTERACTION

If the /etc/eui64 contains a line with a single `+' in it, the eui64_ntohost ();
and eui64_hostton ();
functions will attempt to consult the NIS eui64.byname and eui64.byid maps in addition to the data in the /etc/eui64 file.

HISTORY

These functions first appears in Fx 5.3 . They are derived from the ethers(3) family of functions.

BUGS

The eui64_aton ();
and eui64_ntoa ();
functions returns values that are stored in static memory areas which may be overwritten the next time they are called.