f2e366a105
of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
196 lines
6.2 KiB
Groff
196 lines
6.2 KiB
Groff
.\" Copyright (c) 1986, 1991, 1993
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" Copyright (c) 1995 John Hay. 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.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd Oct 11, 1995
|
|
.Dt IPXROUTED 8
|
|
.Os FreeBSD
|
|
.Sh NAME
|
|
.Nm IPXrouted
|
|
.Nd IPX Routing Information Protocol daemon
|
|
.Sh SYNOPSIS
|
|
.Nm IPXrouted
|
|
.Op Fl N
|
|
.Op Fl q
|
|
.Op Fl s
|
|
.Op Fl S
|
|
.Op Fl t
|
|
.Op Ar logfile
|
|
.Sh DESCRIPTION
|
|
.Nm IPXrouted
|
|
is invoked at boot time to manage the IPX routing tables.
|
|
The IPX routing daemon uses the Novell IPX Routing
|
|
Information Protocol in maintaining up to date kernel routing
|
|
table entries.
|
|
.Pp
|
|
Available options:
|
|
.Bl -tag -width logfile
|
|
.It Fl N
|
|
Do not reply on GetNearestServer SAP request.
|
|
.It Fl q
|
|
Do not supply routing information (opposite of
|
|
.Fl s
|
|
option below).
|
|
.It Fl s
|
|
Forces
|
|
.Nm IPXrouted
|
|
to supply routing information whether it is acting as an internetwork
|
|
router or not.
|
|
.It Fl S
|
|
Do not supply Service Advertizing Protocol
|
|
.Nm (SAP)
|
|
information.
|
|
The default is to supply
|
|
.Nm SAP
|
|
information.
|
|
.It Fl t
|
|
All packets sent or received are
|
|
printed on the standard output. In addition,
|
|
.Nm IPXrouted
|
|
will not divorce itself from the controlling terminal
|
|
so that interrupts from the keyboard will kill the process.
|
|
.It Ar logfile
|
|
Name of file in which
|
|
.Nm IPXrouted Ns 's
|
|
actions should be logged. This log contains information
|
|
about any changes to the routing tables and a history of
|
|
recent messages sent and received which are related to
|
|
the changed route.
|
|
.El
|
|
.Pp
|
|
In normal operation
|
|
.Nm IPXrouted
|
|
listens
|
|
for routing information packets. If the host is connected to
|
|
multiple IPX networks, it periodically supplies copies
|
|
of its routing tables to any directly connected hosts
|
|
and networks.
|
|
.Pp
|
|
When
|
|
.Nm IPXrouted
|
|
is started, it uses the
|
|
.Dv SIOCGIFCONF
|
|
.Xr ioctl 2
|
|
to find those
|
|
directly connected interfaces configured into the
|
|
system and marked
|
|
.Dq up
|
|
(the software loopback interface
|
|
is ignored). If multiple interfaces
|
|
are present, it is assumed the host will forward packets
|
|
between networks.
|
|
.Nm IPXrouted
|
|
then transmits a
|
|
.Em request
|
|
packet on each interface (using a broadcast packet if
|
|
the interface supports it) and enters a loop, listening
|
|
for
|
|
.Em request
|
|
and
|
|
.Em response
|
|
packets from other hosts.
|
|
.Pp
|
|
When a
|
|
.Em request
|
|
packet is received,
|
|
.Nm IPXrouted
|
|
formulates a reply based on the information maintained in its
|
|
internal tables. The
|
|
.Em response
|
|
packet generated contains a list of known routes, each marked
|
|
with a
|
|
.Dq hop count
|
|
metric (a count of 16, or greater, is
|
|
considered
|
|
.Dq infinite ) .
|
|
The metric associated with each
|
|
route returned provides a metric
|
|
.Em relative to the sender .
|
|
.Pp
|
|
.Em Response
|
|
packets received by
|
|
.Nm IPXrouted
|
|
are used to update the routing tables if one of the following
|
|
conditions is satisfied:
|
|
.Bl -bullet
|
|
.It
|
|
No routing table entry exists for the destination network
|
|
or host, and the metric indicates the destination is ``reachable''
|
|
(i.e. the hop count is not infinite).
|
|
.It
|
|
The source host of the packet is the same as the router in the
|
|
existing routing table entry. That is, updated information is
|
|
being received from the very internetwork router through which
|
|
packets for the destination are being routed.
|
|
.It
|
|
The existing entry in the routing table has not been updated for
|
|
some time (defined to be 90 seconds) and the route is at least
|
|
as cost effective as the current route.
|
|
.It
|
|
The new route describes a shorter route to the destination than
|
|
the one currently stored in the routing tables; the metric of
|
|
the new route is compared against the one stored in the table
|
|
to decide this.
|
|
.El
|
|
.Pp
|
|
When an update is applied,
|
|
.Nm IPXrouted
|
|
records the change in its internal tables and generates a
|
|
.Em response
|
|
packet to all directly connected hosts and networks.
|
|
.Xr Routed 8
|
|
waits a short period
|
|
of time (no more than 30 seconds) before modifying the kernel's
|
|
routing tables to allow possible unstable situations to settle.
|
|
.Pp
|
|
In addition to processing incoming packets,
|
|
.Nm IPXrouted
|
|
also periodically checks the routing table entries.
|
|
If an entry has not been updated for 3 minutes, the entry's metric
|
|
is set to infinity and marked for deletion. Deletions are delayed
|
|
an additional 60 seconds to insure the invalidation is propagated
|
|
to other routers.
|
|
.Pp
|
|
Hosts acting as internetwork routers gratuitously supply their
|
|
routing tables every 30 seconds to all directly connected hosts
|
|
and networks.
|
|
.Pp
|
|
If
|
|
.Nm IPXrouted
|
|
receives a SIGINFO signal the current contents of the RIP and SAP
|
|
tables are appended to the file /var/log/ipxrouted.dmp.
|
|
.Sh SEE ALSO
|
|
.Xr ipx 3
|
|
.Sh HISTORY
|