xref: /dflybsd-src/share/man/man5/eui64.5 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino.\" Copyright (c) 1995
286d7f5d3SJohn Marino.\"	Bill Paul <wpaul@ctr.columbia.edu>.  All rights reserved.
386d7f5d3SJohn Marino.\"
486d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
586d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
686d7f5d3SJohn Marino.\" are met:
786d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
886d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
986d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
1086d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
1186d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
1286d7f5d3SJohn Marino.\" 3. All advertising materials mentioning features or use of this software
1386d7f5d3SJohn Marino.\"    must display the following acknowledgement:
1486d7f5d3SJohn Marino.\"	This product includes software developed by Bill Paul.
1586d7f5d3SJohn Marino.\" 4. Neither the name of the author nor the names of any co-contributors
1686d7f5d3SJohn Marino.\"    may be used to endorse or promote products derived from this software
1786d7f5d3SJohn Marino.\"    without specific prior written permission.
1886d7f5d3SJohn Marino.\"
1986d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
2086d7f5d3SJohn Marino.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2186d7f5d3SJohn Marino.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2286d7f5d3SJohn Marino.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2386d7f5d3SJohn Marino.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2486d7f5d3SJohn Marino.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2586d7f5d3SJohn Marino.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2686d7f5d3SJohn Marino.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2786d7f5d3SJohn Marino.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2886d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2986d7f5d3SJohn Marino.\" SUCH DAMAGE.
3086d7f5d3SJohn Marino.\"
3186d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man5/eui64.5,v 1.2 2004/07/07 20:32:33 ru Exp $
3286d7f5d3SJohn Marino.\" $DragonFly: src/share/man/man5/eui64.5,v 1.1 2004/09/23 06:33:04 simokawa Exp $
3386d7f5d3SJohn Marino.\"
3486d7f5d3SJohn Marino.Dd May 11, 2004
3586d7f5d3SJohn Marino.Dt EUI64 5
3686d7f5d3SJohn Marino.Os
3786d7f5d3SJohn Marino.Sh NAME
3886d7f5d3SJohn Marino.Nm eui64
3986d7f5d3SJohn Marino.Nd IEEE EUI-64 address database
4086d7f5d3SJohn Marino.Sh DESCRIPTION
4186d7f5d3SJohn MarinoThe
4286d7f5d3SJohn Marino.Nm
4386d7f5d3SJohn Marinodatabase contains information regarding known IEEE EUI-64s of hosts.
4486d7f5d3SJohn MarinoThe data is stored in a file called
4586d7f5d3SJohn Marino.Pa /etc/eui64
4686d7f5d3SJohn Marinoin the following format:
4786d7f5d3SJohn Marino.Bd -ragged -offset indent
4886d7f5d3SJohn Marino.Em EUI-64 host-name
4986d7f5d3SJohn Marino.Ed
5086d7f5d3SJohn Marino.Pp
5186d7f5d3SJohn MarinoItems are separated by any number of blanks and/or
5286d7f5d3SJohn Marinotab characters.
5386d7f5d3SJohn MarinoA
5486d7f5d3SJohn Marino.Ql #
5586d7f5d3SJohn Marinoat the start of a line indicates the
5686d7f5d3SJohn Marinobeginning of a comment that extends to the end of the line.
5786d7f5d3SJohn MarinoValid lines may also contain comments.
5886d7f5d3SJohn MarinoA
5986d7f5d3SJohn Marino.Ql +
6086d7f5d3SJohn Marinoat the start of a line will cause the
6186d7f5d3SJohn Marino.Xr eui64 3
6286d7f5d3SJohn Marinolibrary functions to use data stored in the
6386d7f5d3SJohn MarinoNIS
6486d7f5d3SJohn Marino.Pa eui64.byname
6586d7f5d3SJohn Marinoand
6686d7f5d3SJohn Marino.Pa eui64.byid
6786d7f5d3SJohn Marinomaps in addition to the data in the
6886d7f5d3SJohn Marino.Pa /etc/eui64
6986d7f5d3SJohn Marinofile.
7086d7f5d3SJohn Marino.Pp
7186d7f5d3SJohn MarinoAn EUI-64 is expressed in
7286d7f5d3SJohn Marino.Tn ASCII
7386d7f5d3SJohn Marinoform as
7486d7f5d3SJohn Marino.Qq x-x-x-x-x-x-x-x
7586d7f5d3SJohn Marinowhere
7686d7f5d3SJohn Marino.Ar x
7786d7f5d3SJohn Marinois a hexadecimal value between 0x00 and 0xFF.
7886d7f5d3SJohn MarinoThe address values
7986d7f5d3SJohn Marinoshould be in network order.
8086d7f5d3SJohn MarinoHostnames specified in the
8186d7f5d3SJohn Marino.Pa /etc/eui64
8286d7f5d3SJohn Marinodatabase should correspond to entries in the
8386d7f5d3SJohn Marino.Xr hosts 5
8486d7f5d3SJohn Marinofile.
8586d7f5d3SJohn Marino.\" .Pp
8686d7f5d3SJohn Marino.\" The
8786d7f5d3SJohn Marino.\" .Fn eui64_line
8886d7f5d3SJohn Marino.\" function in the standard C library can be used to break individual
8986d7f5d3SJohn Marino.\" lines in the
9086d7f5d3SJohn Marino.\" .Pa /etc/eui64
9186d7f5d3SJohn Marino.\" database into their individual components: a binary EUI-64 is
9286d7f5d3SJohn Marino.\" stored as an
9386d7f5d3SJohn Marino.\" .Pa eui64_addr
9486d7f5d3SJohn Marino.\" structure, and a hostname stored as a character string.
9586d7f5d3SJohn Marino.Sh FILES
9686d7f5d3SJohn Marino.Bl -tag -width ".Pa /etc/eui64" -compact
9786d7f5d3SJohn Marino.It Pa /etc/eui64
9886d7f5d3SJohn MarinoThe
9986d7f5d3SJohn Marino.Nm
10086d7f5d3SJohn Marinofile resides in
10186d7f5d3SJohn Marino.Pa /etc .
10286d7f5d3SJohn Marino.El
10386d7f5d3SJohn Marino.Sh SEE ALSO
10486d7f5d3SJohn Marino.Xr eui64 3 ,
10586d7f5d3SJohn Marino.Xr yp 8
10686d7f5d3SJohn Marino.Sh HISTORY
10786d7f5d3SJohn MarinoThe
10886d7f5d3SJohn Marino.Nm
10986d7f5d3SJohn Marinoformat is based on the
11086d7f5d3SJohn Marino.Xr ethers 5
11186d7f5d3SJohn Marinoformat.
112