.\"	$NetBSD: esis.4,v 1.13 2003/08/07 10:31:01 agc Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)esis.4	8.2 (Berkeley) 11/30/93
.\"
.Dd November 30, 1993
.Dt ESIS 4
.Os
.Sh NAME
.Nm esis
.Nd End System to Intermediate System Routing Protocol
.Sh SYNOPSIS
.In sys/types.h
.In netiso/esis.h
.Sh DESCRIPTION
The
.Tn ES-IS
routing protocol is used to dynamically map between
.Tn ISO NSAP
addresses and
.Tn ISO SNPA
addresses; to permit End Systems (ES) and Intermediate Systems (IS)
to learn of each other's existence; and to allow Intermediate Systems
to inform End Systems of (potentially) better routes to use when forwarding
Network Protocol Data Units
.Pq Tn NPDU Ns s
to a particular destination.
.Pp
The mapping between
.Tn NSAP
addresses and
.Tn SNPA
addresses is accomplished by transmitting
.Qq hello
Protocol Data Units
.Pq Tn PDU Ns s
between the cooperating Systems.
These
.Tn PDU Ns s
are transmitted whenever the
.Em configuration
timer expires.
When a
.Qq hello
.Tn PDU
is received, the
.Tn SNPA
address that it conveys is stored in the routing table for as long as the
.Em holding time
in the
.Tn PDU
suggests.
The default
.Em holding time
(120 seconds) placed in the
.Qq hello
.Tn PDU ,
the configuration timer value, and the system type (End System or
Intermediate System) may be changed by issuing an
.Dv SIOCSSTYPE
.Xr ioctl 2 ,
which is defined in
.Aq Pa sys/netiso/iso_snpac.h .
.Pp
The protocol behaves differently depending on whether the System is
configured as an End System or an Intermediate System.
.Sh END SYSTEM OPERATION
When an interface requests a mapping for an address not in the cache, the
.Tn SNPA
of any known Intermediate System is returned.
If an Intermediate System is not known, then the
.Em all end systems
multicast address is returned.
It is assumed that the intended recipient of the
.Tn NPDU
will immediately transmit a
.Qq hello
.Tn PDU
back to the originator of the
.Tn NPDU .
.Pp
If an
.Tn NPDU
is forwarded by the End System, a redirect
.Tn PDU
will not be generated.
However, redirect
.Tn PDU Ns s
received will be processed.
This processing consists of adding an entry in the routing table.
If the redirect is towards an Intermediate System, then an entry
is made in the routing table as well.
The entry in the routing table will mark the
.Tn NSAP
address contained in the redirect
.Tn PDU
as the gateway for the destination
system (if an NET is supplied), or will create a route with
the
.Tn NSAP
address as the destination and the
.Tn SNPA
address (embodied as a link-level struct sockaddr) as the
gateway.
.Pp
If the System is configured as an End System, it will report all the
.Tn NSAP Ns s
that have been configured using the
.Xr ifconfig 8
command, and no others.
It is possible to have more than one
.Tn NSAP
assigned to a given interface,
and it is also possible to have the same
.Tn NSAP
assigned to multiple
interfaces.
However, any
.Tn NSAP
containing an
.Tn NSEL
that is consistent with the
.Em nsellength
option (default one) of any interface will be accepted as an
.Tn NSAP
for this System.
.Sh INTERMEDIATE SYSTEM OPERATION
When an interface requests a mapping for an address not in the routing table,
an error is returned.
.Pp
When an
.Tn NPDU
is forwarded out on the same interface that the
.Tn NPDU
arrived upon, a redirect
.Tn PDU
is generated.
.Sh MANUAL ROUTING TABLE MODIFICATION
To facilitate communications with systems which do not use
.Tn ES-IS ,
one may add a route whose destination is a struct sockaddr_iso containing the
.Tn NSAP
in question, and the gateway being a link-level struct sockaddr,
either by writing a special purpose program, or using the
.Xr route 8
command e.g.:
.Bd -literal
route add -iface -osi 49.0.4.8.0.2b.b.83.bf \
	-link qe0:8.0.2b.b.83.bf
.Ed
.Pp
If the System is configured as an End System and has a single
network interface which does not support multicast reception, it
is necessary to manually configure the location of an
.Tn IS ,
using the route command in a similar way.
There, the destination address should be
.Dq default
(spelled out literally as 7
.Tn ASCII
characters), and the gateway should be once again be a link-level
struct sockaddr specifying the
.Tn SNPA
of the
.Tn IS .
.Sh SEE ALSO
.Xr iso 4 ,
.\" .Xr un 4 ,
.Xr ifconfig 8 ,
.Xr route 8
.Rs
.%T "End system to Intermediate system routing exchange protocol for use in conjunction with the Protocol for providing the connectionless-mode network service"
.%R ISO
.%N 9542
.Re
.Sh BUGS
Redirect
.Tn PDU Ns s
do not contain options from the forwarded
.Tn NPDU
which generated the redirect.
The multicast address used on the
.Tn IEEE 802.3
.Pq Tn Ethernet
network is taken from the
National Bureau of Standards
.Pq Tn NBS
December 1987 agreements.
This multicast address is not compatible with the
.Tn IEEE 802.5
.Pq Tn Token Ring
multicast addresses format.
Therefore, broadcast addresses are used on the
.Tn IEEE 802.5
subnetwork.
.Pp
Researchers at the University of Wisconsin are constructing an implementation
of the
.Tn IS-IS
routing protocol.
.Pp
.Tn NBS
is now known as the National Institute for Standards and Technology
.Pq Tn NIST .