summaryrefslogtreecommitdiffstats
path: root/sbin/routed/routed.8
diff options
context:
space:
mode:
authorcharnier <charnier@FreeBSD.org>1998-07-28 06:36:31 +0000
committercharnier <charnier@FreeBSD.org>1998-07-28 06:36:31 +0000
commitcd64002d5da7c3bacf30747f3a6af5baca8676a6 (patch)
tree083e700ad435744b33aa1ed531c4da6bb11f49b8 /sbin/routed/routed.8
parent6999d30e2ecf654e56794fbef703e59c1826883a (diff)
downloadFreeBSD-src-cd64002d5da7c3bacf30747f3a6af5baca8676a6.zip
FreeBSD-src-cd64002d5da7c3bacf30747f3a6af5baca8676a6.tar.gz
Spelling, add rcsid, remove unused #includes.
Convert 1000000 usec to 1 sec 0 usec. Use provided safe malloc (rtmalloc()) instead of malloc(): exit on allocation failure. Correct use of .Nm Add usage() and use errx().
Diffstat (limited to 'sbin/routed/routed.8')
-rw-r--r--sbin/routed/routed.865
1 files changed, 32 insertions, 33 deletions
diff --git a/sbin/routed/routed.8 b/sbin/routed/routed.8
index 4076c9c..36a1705 100644
--- a/sbin/routed/routed.8
+++ b/sbin/routed/routed.8
@@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)routed.8 8.2 (Berkeley) 12/11/93
-.\" $Id: routed.8,v 1.9 1997/03/12 13:22:17 mpp Exp $
+.\" $Id: routed.8,v 1.10 1998/06/17 13:13:41 jkoshy Exp $
.\"
.Dd June 1, 1996
.Dt ROUTED 8
@@ -39,7 +39,7 @@
.Nm routed
.Nd network RIP and router discovery routing daemon
.Sh SYNOPSIS
-.Nm
+.Nm routed
.Op Fl sqdghmAt
.Op Fl T Ar tracefile
.Oo
@@ -49,7 +49,7 @@
.Op Fl P Ar parms
.Sh DESCRIPTION
.Nm Routed
-is a dameon invoked at boot time to manage the network
+is a daemon invoked at boot time to manage the network
routing tables.
It uses Routing Information Protocol, RIPv1 (RFC\ 1058),
RIPv2 (RFC\ 1723),
@@ -152,7 +152,7 @@ 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 until the route has been advertised with
an infinite metric to insure the invalidation
-is propagated throughout the local internet.
+is propagated throughout the local Internet.
This is a form of
.Em poison reverse .
.Pp
@@ -161,7 +161,7 @@ of ICMP Redirect messages are deleted after a while to minimize
.Em black-holes .
When a TCP connection suffers a timeout,
the kernel tells
-.Nm routed ,
+.Nm Ns ,
which deletes all redirected routes
through the gateway involved, advances the age of all RIP routes through
the gateway to allow an alternate to be chosen, and advances of the
@@ -232,21 +232,20 @@ By default, neither Router Discovery advertisements nor solicitations
are sent over point to point links (e.g. PPP).
The netmask associated with point-to-point links (such as SLIP
or PPP, with the IFF_POINTOPOINT flag) is used by
-.Nm routed
+.Nm
to infer the netmask used by the remote system when RIPv1 is used.
.Pp
-Options supported by
-.Nm routed :
-.Bl -tag -width Ds
+The following options are available:
+.Bl -tag -width indent
.It Fl s
-this option forces
+Force
.Nm
to supply routing information.
This is the default if multiple network interfaces are present on which
RIP or Router Discovery have not been disabled, and if the kernel switch
ipforwarding=1.
.It Fl q
-is the opposite of the
+Is the opposite of the
.Fl s
option.
This is the default when only one interface is present.
@@ -254,7 +253,7 @@ This is the default when only one interface is present.
Do not run in the background.
This option is meant for interactive use.
.It Fl g
-This flag is used on internetwork routers to offer a route
+Used on internetwork routers to offer a route
to the "default" destination.
It is equivalent to
.Fl F
@@ -267,7 +266,7 @@ on the command line or
in the
.Pa /etc/gateways
file.
-since a larger metric
+Since a larger metric
will be used, reducing the spread of the potentially dangerous
default route.
This is typically used on a gateway to the Internet,
@@ -277,13 +276,13 @@ Notice that because a metric of 1 is used, this feature is
dangerous. It is more commonly accidentally used to create chaos with routing
loop than to solve problems.
.It Fl h
-This causes host or point-to-point routes to not be advertised,
+Cause host or point-to-point routes to not be advertised,
provided there is a network route going the same direction.
That is a limited kind of aggregation.
-This option is useful on gateways to ethernets that have other gateway
+This option is useful on gateways to Ethernets that have other gateway
machines connected with point-to-point links such as SLIP.
.It Fl m
-This causes the machine to advertise a host or point-to-point route to
+Cause the machine to advertise a host or point-to-point route to
its primary interface.
It is useful on multi-homed machines such as NFS servers.
This option should not be used except when the cost of
@@ -297,20 +296,20 @@ option overrides the
.Fl q
option to the limited extent of advertising the host route.
.It Fl A
-do not ignore RIPv2 authentication if we do not care about RIPv2
+Do not ignore RIPv2 authentication if we do not care about RIPv2
authentication.
This option is required for conformance with RFC 1723.
However, it makes no sense and breaks using RIP as a discovery protocol
to ignore all RIPv2 packets that carry authentication when this machine
does not care about authentication.
.It Fl T Ar tracefile
-increases the debugging level to at least 1 and
+Increase the debugging level to at least 1 and
causes debugging information to be appended to the trace file.
Note that because of security concerns, it is wisest to not run
-.Nm routed
+.Nm
routinely with tracing directed to a file.
.It Fl t
-increases the debugging level, which causes more information to be logged
+Increase the debugging level, which causes more information to be logged
on the tracefile specified with
.Fl T
or standard out.
@@ -323,7 +322,7 @@ signals or with the
.Xr rtquery 8
command.
.It Fl F Ar net[/mask][,metric]
-minimize routes in transmissions via interfaces with addresses that match
+Minimize routes in transmissions via interfaces with addresses that match
.Em net/mask ,
and synthesizes a default route to this machine with the
.Em metric .
@@ -342,7 +341,7 @@ number and mask.
See also
.Fl g .
.It Fl P Ar parms
-is equivalent to adding the parameter
+Is equivalent to adding the parameter
line
.Em parms
to the
@@ -359,7 +358,7 @@ It is better to use
instead of
appending the name of the trace file to the command.
.Pp
-.Nm
+.Nm Routed
also supports the notion of
"distant"
.Em passive
@@ -412,7 +411,7 @@ that another routing process
will install such a route if necessary,
and that alternate routes to that destination should not be installed
by
-.Nm routed .
+.Nm Ns .
Such entries are only required when both routers may learn of routes
to the same destination.
.Pp
@@ -458,9 +457,9 @@ or
or
.Xr named 8 ,
must have been started before
-.Nm routed Ns .)
+.Nm Ns .)
.Pp
-.Ar mask
+.Ar Mask
is an optional number between 1 and 32 indicating the netmask associated
with
.Ar Nname .
@@ -471,7 +470,7 @@ be forwarded.
.Pp
.Ar Value
is the hop count to the destination host or network.
-.Ar " host hname "
+.Ar " Host hname "
is equivalent to
.Ar " net nname/32 ".
.Pp
@@ -535,7 +534,7 @@ no password is output.
Incoming packets can carry any password that is valid, will
be valid within 24 hours, or that was valid within 24 hours.
.It Cm md5_passwd Ns \&= Ns Ar XXX1|KeyID[start|stop]
-specifes a RIPv2 MD5 password.
+specifies a RIPv2 MD5 password.
Except that a
.Cm KeyID
is required, this keyword is similar to
@@ -562,7 +561,7 @@ discovery advertisements with
or
.Fl s
causes
-.Nm routed
+.Nm
to act as a client router discovery daemon, not advertising.
.It Cm no_ripv1_in
causes RIPv1 received responses to be ignored.
@@ -585,11 +584,11 @@ specifies that Router Discovery solicitations should be sent,
even on point-to-point links,
which by default only listen to Router Discovery messages.
.It Cm no_rdisc_adv
-disables the transmission of Router Discovery Advertisements
+disables the transmission of Router Discovery Advertisements.
.It Cm rdisc_adv
specifies that Router Discovery Advertisements should be sent,
even on point-to-point links,
-which by default only listen to Router Discovery messages
+which by default only listen to Router Discovery messages.
.It Cm bcast_rdisc
specifies that Router Discovery packets should be broadcast instead of
multicast.
@@ -602,7 +601,7 @@ are transmitted to N seconds and their lifetime to 3*N.
.It Cm fake_default Ns \&= Ns Ar metric
has an identical effect to
.Fl F Ar net[/mask][=metric]
-with the network and mask coming from the sepcified interface.
+with the network and mask coming from the specified interface.
.It Cm pm_rdisc
is similar to
.Cm fake_default .
@@ -633,7 +632,7 @@ for distant gateways
.Xr icmp 4 ,
.Xr udp 4 ,
.Xr gated 8 ,
-.Xr rtquery 8 .
+.Xr rtquery 8
.Rs
.%T Internet Transport Protocols
.%R XSIS 028112
OpenPOWER on IntegriCloud