kernel, libc: signals fixes
[minix.git] / man / man8 / irdpd.8
blob46caa09cc204341c9898e49cd26222fb686637f1
1 .TH IRDPD 8
2 .SH NAME
3 irdpd \- internet router discovery protocol daemon
4 .SH SYNOPSIS
5 .B irdpd
6 .RB [ \-bd ]
7 .RB [ \-U
8 .IR udp-device ]
9 .RB [ \-I
10 .IR ip-device ]
11 .RB [ \-o
12 .IR priority-offset ]
13 .SH DESCRIPTION
14 .B Irdpd
15 looks for routers.  This should be a simple task, but some routers are hard
16 to find because they do not implement the router discovery protocol.  This
17 daemon collects information that routers do send out and makes it available.
18 .PP
19 At startup
20 .B irdpd
21 sends out several router solicitation broadcasts.  A good router should
22 respond to this with a router advertisement.
23 .PP
24 If a router advertisement arrives then no more solicitations are sent.  The
25 TCP/IP server has filled its routing table with the info from the
26 advertisement, so it now has at least one router.  If the advertisement is
27 sent by a genuine router (the sender is in the table) then the
28 .B irdpd
29 daemon goes dormant for the time the advert is valid.  Routers send new
30 adverts periodically, keeping the daemon silent.
31 .PP
32 Otherwise
33 .B irdpd
34 will listen for RIP (Router Information Protocol) packets.  These packets
35 are sent between routers to exchange routing information.
36 .B Irdpd
37 uses this information to build a routing table.
38 .PP
39 Every now and then a router advertisement is sent to the local host to give
40 it router information build from the RIP packets.
41 .SH OPTIONS
42 .TP
43 .B \-b
44 Broadcast advertisements instead of sending them to the local host only.
45 This may be used to keep (non-Minix) hosts alive on a net without adverts.
46 .TP
47 .B \-d
48 Debug mode, tell where info is coming from and where it is sent.  Debugging
49 can also be turned on at runtime by sending signal
50 .B SIGUSR1
51 or turned off with
52 .BR SIGUSR2 .
53 .TP
54 .BI \-o " priority-offset
55 Offset used to make the gateway's preferences collected from RIP packets look
56 worse than those found in genuine router adverts.  By default
57 .BR -1024 .
58 .SH "SEE ALSO"
59 .BR inet (8),
60 .BR boot (8),
61 .BR dhcpd (8),
62 .BR inetd (8),
63 .BR nonamed (8).
64 .SH BUGS
65 This daemon has gone out of favour thanks to
66 .BR dhcpd ,
67 that also does router solicitations among other things.
68 .PP
69 Under standard MINIX 3 this daemon can't listen to both IRDP and RIP
70 at the same time, so it starts out with IRDP.  It switches over to RIP
71 if it can't find a router, or if it threatens to lose its router.  It
72 does not switch back.
73 .SH AUTHOR
74 Kees J. Bot (kjb@cs.vu.nl)