xref: /freebsd/share/man/man5/eui64.5 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
17387768eSBrooks Davis.\" Copyright (c) 1995
27387768eSBrooks Davis.\"	Bill Paul <wpaul@ctr.columbia.edu>.  All rights reserved.
37387768eSBrooks Davis.\"
47387768eSBrooks Davis.\" Redistribution and use in source and binary forms, with or without
57387768eSBrooks Davis.\" modification, are permitted provided that the following conditions
67387768eSBrooks Davis.\" are met:
77387768eSBrooks Davis.\" 1. Redistributions of source code must retain the above copyright
87387768eSBrooks Davis.\"    notice, this list of conditions and the following disclaimer.
97387768eSBrooks Davis.\" 2. Redistributions in binary form must reproduce the above copyright
107387768eSBrooks Davis.\"    notice, this list of conditions and the following disclaimer in the
117387768eSBrooks Davis.\"    documentation and/or other materials provided with the distribution.
127387768eSBrooks Davis.\" 3. All advertising materials mentioning features or use of this software
137387768eSBrooks Davis.\"    must display the following acknowledgement:
147387768eSBrooks Davis.\"	This product includes software developed by Bill Paul.
157387768eSBrooks Davis.\" 4. Neither the name of the author nor the names of any co-contributors
167387768eSBrooks Davis.\"    may be used to endorse or promote products derived from this software
177387768eSBrooks Davis.\"    without specific prior written permission.
187387768eSBrooks Davis.\"
197387768eSBrooks Davis.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
207387768eSBrooks Davis.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
217387768eSBrooks Davis.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
227387768eSBrooks Davis.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
237387768eSBrooks Davis.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
247387768eSBrooks Davis.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
257387768eSBrooks Davis.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
267387768eSBrooks Davis.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
277387768eSBrooks Davis.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
287387768eSBrooks Davis.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
297387768eSBrooks Davis.\" SUCH DAMAGE.
307387768eSBrooks Davis.\"
317387768eSBrooks Davis.Dd May 11, 2004
327387768eSBrooks Davis.Dt EUI64 5
337387768eSBrooks Davis.Os
347387768eSBrooks Davis.Sh NAME
357387768eSBrooks Davis.Nm eui64
367387768eSBrooks Davis.Nd IEEE EUI-64 address database
377387768eSBrooks Davis.Sh DESCRIPTION
387387768eSBrooks DavisThe
397387768eSBrooks Davis.Nm
407387768eSBrooks Davisdatabase contains information regarding known IEEE EUI-64s of hosts.
417387768eSBrooks DavisThe data is stored in a file called
427387768eSBrooks Davis.Pa /etc/eui64
437387768eSBrooks Davisin the following format:
44412dd679SRuslan Ermilov.Bd -ragged -offset indent
45412dd679SRuslan Ermilov.Em EUI-64 host-name
467387768eSBrooks Davis.Ed
477387768eSBrooks Davis.Pp
487387768eSBrooks DavisItems are separated by any number of blanks and/or
497387768eSBrooks Davistab characters.
507387768eSBrooks DavisA
51412dd679SRuslan Ermilov.Ql #
527387768eSBrooks Davisat the start of a line indicates the
537387768eSBrooks Davisbeginning of a comment that extends to the end of the line.
547387768eSBrooks DavisValid lines may also contain comments.
557387768eSBrooks DavisA
56412dd679SRuslan Ermilov.Ql +
577387768eSBrooks Davisat the start of a line will cause the
587387768eSBrooks Davis.Xr eui64 3
597387768eSBrooks Davislibrary functions to use data stored in the
60412dd679SRuslan ErmilovNIS
617387768eSBrooks Davis.Pa eui64.byname
627387768eSBrooks Davisand
637387768eSBrooks Davis.Pa eui64.byid
647387768eSBrooks Davismaps in addition to the data in the
657387768eSBrooks Davis.Pa /etc/eui64
667387768eSBrooks Davisfile.
677387768eSBrooks Davis.Pp
687387768eSBrooks DavisAn EUI-64 is expressed in
697387768eSBrooks Davis.Tn ASCII
70412dd679SRuslan Ermilovform as
71412dd679SRuslan Ermilov.Qq x-x-x-x-x-x-x-x
72412dd679SRuslan Ermilovwhere
737387768eSBrooks Davis.Ar x
747387768eSBrooks Davisis a hexadecimal value between 0x00 and 0xFF.
757387768eSBrooks DavisThe address values
767387768eSBrooks Davisshould be in network order.
777387768eSBrooks DavisHostnames specified in the
787387768eSBrooks Davis.Pa /etc/eui64
797387768eSBrooks Davisdatabase should correspond to entries in the
807387768eSBrooks Davis.Xr hosts 5
817387768eSBrooks Davisfile.
82412dd679SRuslan Ermilov.\" .Pp
83412dd679SRuslan Ermilov.\" The
84412dd679SRuslan Ermilov.\" .Fn eui64_line
85412dd679SRuslan Ermilov.\" function in the standard C library can be used to break individual
86412dd679SRuslan Ermilov.\" lines in the
87412dd679SRuslan Ermilov.\" .Pa /etc/eui64
88412dd679SRuslan Ermilov.\" database into their individual components: a binary EUI-64 is
89412dd679SRuslan Ermilov.\" stored as an
90412dd679SRuslan Ermilov.\" .Pa eui64_addr
91412dd679SRuslan Ermilov.\" structure, and a hostname stored as a character string.
927387768eSBrooks Davis.Sh FILES
93412dd679SRuslan Ermilov.Bl -tag -width ".Pa /etc/eui64" -compact
947387768eSBrooks Davis.It Pa /etc/eui64
957387768eSBrooks DavisThe
967387768eSBrooks Davis.Nm
977387768eSBrooks Davisfile resides in
987387768eSBrooks Davis.Pa /etc .
997387768eSBrooks Davis.El
1007387768eSBrooks Davis.Sh SEE ALSO
1017387768eSBrooks Davis.Xr eui64 3 ,
1027387768eSBrooks Davis.Xr yp 8
1037387768eSBrooks Davis.Sh HISTORY
1047387768eSBrooks DavisThe
1057387768eSBrooks Davis.Nm
1067387768eSBrooks Davisformat is based on the
1077387768eSBrooks Davis.Xr ethers 5
1087387768eSBrooks Davisformat.
109