0ace4398df
to parse by an automated script (say one that just might want to generate webpage summaries of available drivers :)
236 lines
6.8 KiB
Groff
236 lines
6.8 KiB
Groff
.\" $NetBSD: esis.4,v 1.6 1999/12/15 22:07:31 abs 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. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 4. 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
|
|
.Fd #include <sys/types.h>
|
|
.Fd #include <netiso/esis.h>
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm 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
|
|
.Pa Aq 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
|
|
.Pp
|
|
To facilitate communications with systems which do not use
|
|
.Nm 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 un 4 ,
|
|
.Xr iso 4 ,
|
|
.Xr route 8 ,
|
|
.Xr ifconfig 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 .
|