xref: /dflybsd-src/share/man/man5/eui64.5 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
1*86d7f5d3SJohn Marino.\" Copyright (c) 1995
2*86d7f5d3SJohn Marino.\"	Bill Paul <wpaul@ctr.columbia.edu>.  All rights reserved.
3*86d7f5d3SJohn Marino.\"
4*86d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
5*86d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
6*86d7f5d3SJohn Marino.\" are met:
7*86d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
8*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
9*86d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
10*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
11*86d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
12*86d7f5d3SJohn Marino.\" 3. All advertising materials mentioning features or use of this software
13*86d7f5d3SJohn Marino.\"    must display the following acknowledgement:
14*86d7f5d3SJohn Marino.\"	This product includes software developed by Bill Paul.
15*86d7f5d3SJohn Marino.\" 4. Neither the name of the author nor the names of any co-contributors
16*86d7f5d3SJohn Marino.\"    may be used to endorse or promote products derived from this software
17*86d7f5d3SJohn Marino.\"    without specific prior written permission.
18*86d7f5d3SJohn Marino.\"
19*86d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
20*86d7f5d3SJohn Marino.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21*86d7f5d3SJohn Marino.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22*86d7f5d3SJohn Marino.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23*86d7f5d3SJohn Marino.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24*86d7f5d3SJohn Marino.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25*86d7f5d3SJohn Marino.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26*86d7f5d3SJohn Marino.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27*86d7f5d3SJohn Marino.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28*86d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29*86d7f5d3SJohn Marino.\" SUCH DAMAGE.
30*86d7f5d3SJohn Marino.\"
31*86d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man5/eui64.5,v 1.2 2004/07/07 20:32:33 ru Exp $
32*86d7f5d3SJohn Marino.\" $DragonFly: src/share/man/man5/eui64.5,v 1.1 2004/09/23 06:33:04 simokawa Exp $
33*86d7f5d3SJohn Marino.\"
34*86d7f5d3SJohn Marino.Dd May 11, 2004
35*86d7f5d3SJohn Marino.Dt EUI64 5
36*86d7f5d3SJohn Marino.Os
37*86d7f5d3SJohn Marino.Sh NAME
38*86d7f5d3SJohn Marino.Nm eui64
39*86d7f5d3SJohn Marino.Nd IEEE EUI-64 address database
40*86d7f5d3SJohn Marino.Sh DESCRIPTION
41*86d7f5d3SJohn MarinoThe
42*86d7f5d3SJohn Marino.Nm
43*86d7f5d3SJohn Marinodatabase contains information regarding known IEEE EUI-64s of hosts.
44*86d7f5d3SJohn MarinoThe data is stored in a file called
45*86d7f5d3SJohn Marino.Pa /etc/eui64
46*86d7f5d3SJohn Marinoin the following format:
47*86d7f5d3SJohn Marino.Bd -ragged -offset indent
48*86d7f5d3SJohn Marino.Em EUI-64 host-name
49*86d7f5d3SJohn Marino.Ed
50*86d7f5d3SJohn Marino.Pp
51*86d7f5d3SJohn MarinoItems are separated by any number of blanks and/or
52*86d7f5d3SJohn Marinotab characters.
53*86d7f5d3SJohn MarinoA
54*86d7f5d3SJohn Marino.Ql #
55*86d7f5d3SJohn Marinoat the start of a line indicates the
56*86d7f5d3SJohn Marinobeginning of a comment that extends to the end of the line.
57*86d7f5d3SJohn MarinoValid lines may also contain comments.
58*86d7f5d3SJohn MarinoA
59*86d7f5d3SJohn Marino.Ql +
60*86d7f5d3SJohn Marinoat the start of a line will cause the
61*86d7f5d3SJohn Marino.Xr eui64 3
62*86d7f5d3SJohn Marinolibrary functions to use data stored in the
63*86d7f5d3SJohn MarinoNIS
64*86d7f5d3SJohn Marino.Pa eui64.byname
65*86d7f5d3SJohn Marinoand
66*86d7f5d3SJohn Marino.Pa eui64.byid
67*86d7f5d3SJohn Marinomaps in addition to the data in the
68*86d7f5d3SJohn Marino.Pa /etc/eui64
69*86d7f5d3SJohn Marinofile.
70*86d7f5d3SJohn Marino.Pp
71*86d7f5d3SJohn MarinoAn EUI-64 is expressed in
72*86d7f5d3SJohn Marino.Tn ASCII
73*86d7f5d3SJohn Marinoform as
74*86d7f5d3SJohn Marino.Qq x-x-x-x-x-x-x-x
75*86d7f5d3SJohn Marinowhere
76*86d7f5d3SJohn Marino.Ar x
77*86d7f5d3SJohn Marinois a hexadecimal value between 0x00 and 0xFF.
78*86d7f5d3SJohn MarinoThe address values
79*86d7f5d3SJohn Marinoshould be in network order.
80*86d7f5d3SJohn MarinoHostnames specified in the
81*86d7f5d3SJohn Marino.Pa /etc/eui64
82*86d7f5d3SJohn Marinodatabase should correspond to entries in the
83*86d7f5d3SJohn Marino.Xr hosts 5
84*86d7f5d3SJohn Marinofile.
85*86d7f5d3SJohn Marino.\" .Pp
86*86d7f5d3SJohn Marino.\" The
87*86d7f5d3SJohn Marino.\" .Fn eui64_line
88*86d7f5d3SJohn Marino.\" function in the standard C library can be used to break individual
89*86d7f5d3SJohn Marino.\" lines in the
90*86d7f5d3SJohn Marino.\" .Pa /etc/eui64
91*86d7f5d3SJohn Marino.\" database into their individual components: a binary EUI-64 is
92*86d7f5d3SJohn Marino.\" stored as an
93*86d7f5d3SJohn Marino.\" .Pa eui64_addr
94*86d7f5d3SJohn Marino.\" structure, and a hostname stored as a character string.
95*86d7f5d3SJohn Marino.Sh FILES
96*86d7f5d3SJohn Marino.Bl -tag -width ".Pa /etc/eui64" -compact
97*86d7f5d3SJohn Marino.It Pa /etc/eui64
98*86d7f5d3SJohn MarinoThe
99*86d7f5d3SJohn Marino.Nm
100*86d7f5d3SJohn Marinofile resides in
101*86d7f5d3SJohn Marino.Pa /etc .
102*86d7f5d3SJohn Marino.El
103*86d7f5d3SJohn Marino.Sh SEE ALSO
104*86d7f5d3SJohn Marino.Xr eui64 3 ,
105*86d7f5d3SJohn Marino.Xr yp 8
106*86d7f5d3SJohn Marino.Sh HISTORY
107*86d7f5d3SJohn MarinoThe
108*86d7f5d3SJohn Marino.Nm
109*86d7f5d3SJohn Marinoformat is based on the
110*86d7f5d3SJohn Marino.Xr ethers 5
111*86d7f5d3SJohn Marinoformat.
112