eui64_ntohost man page on PC-BSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
PC-BSD logo
[printable version]

EUI64(3)		 BSD Library Functions Manual		      EUI64(3)

NAME
     eui64, eui64_aton, eui64_ntoa, eui64_ntohost, eui64_hostton — IEEE EUI-64
     conversion and lookup routines

LIBRARY
     Standard C Library (libc, -lc)

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 eui64 structure, which
     is defined in the header file <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 eui64 structure.  Likewise, eui64_ntoa() converts an EUI-64 spec‐
     ified as an 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 sup‐
     plied eui64 structure, it returns a NULL pointer.	Likewise, eui64_aton()
     returns a pointer to an 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.

SEE ALSO
     firewire(4), eui64(5), yp(8)

HISTORY
     These functions first appears in FreeBSD 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.

BSD				 March 4, 2004				   BSD
[top]

List of man pages available for PC-BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net