vm: fix sanity checks on arm
[minix.git] / man / man8 / rarpd.8
blob32a9bdd1759063401c943984b16159c223285003
1 .TH RARPD 8
2 .SH NAME
3 rarpd \- reverse address resolution protocol daemon
4 .SH SYNOPSIS
5 .B rarpd
6 .RB [ \-d [\fIlevel\fR]]
7 .I network-name
8 \&...
9 .SH DESCRIPTION
10 .de SP
11 .if t .sp 0.4
12 .if n .sp
14 .B Rarpd
15 listens on the given networks for broadcast packets asking for reverse address
16 resolution.  These packets are sent by hosts at boot time to find out their
17 IP address.
18 .B Rarpd
19 looks up the six octet ethernet number in the
20 .B /etc/ethers
21 file finding a host name.  This name is translated to the IP address of the
22 host by a DNS lookup.  The IP address is then sent to the host.
23 .PP
24 Under MINIX 3 the program forks as needed to give each network its own server.
25 Under Minix-vmd all networks are handled in the same program using async I/O.
26 .SS "Private Ethernet Addresses"
27 For VU practical work, where students have to create their own IP stack
28 starting at the bottom with RARP, this implementation recognizes Ethernet
29 addresses starting with octet 0x76 as special.  The next octet is used as a
30 additional host number and the next and last four octets as an IP address
31 that this Ethernet address is additional for.  The IP address is translated
32 back to a name, and the first component of that name gets a dash and the
33 additional host number added to it.  That hostname is then looked up and its
34 IP address returned in a RARP reply.  Example:
35 .PP
36 .RS
37 .ta +\w'flotsam-3.example.commmm'u
38 76:3:c0:a8:e7:fa        Additional 3, IP 192.168.231.250
39 .SP
40 flotsam.example.com     Reverse lookup on 192.168.231.250
41 .SP
42 flotsam-3.example.com   Splicing in additional number
43 .SP
44 192.168.231.42          Forward lookup
45 .RE
46 .PP
47 In this example a RARP query for 76:3:c0:a8:e7:fa gets 192.168.231.42 as reply.
48 .SH OPTIONS
49 .TP
50 .BR \-d [\fIlevel\fP]
51 Turns on debugging messages at the given level, by default 1.  At level 1 you
52 will be shown what answers are sent, and at level 2 or higher you will be told
53 about queries from unknown hosts or host on the wrong network.
54 The debug level can also be increased by 1 at runtime by sending signal
55 .B SIGUSR1
56 or turned off (set to 0) with
57 .BR SIGUSR2 .
58 .SH "SEE ALSO"
59 .BR ifconfig (8),
60 .BR ethers (5),
61 .BR hosts (5),
62 .BR inet (8),
63 .BR boot (8),
64 .BR dhcpd (8),
65 .BR irdpd (8),
66 .BR inetd (8),
67 .BR nonamed (8).
68 .SH NOTES
69 A "network name" is the device name of the IP device of a network, i.e.
70 .BR ip0 ,
71 .BR ip1 ", ..."
72 .PP
73 The RARP protocol has gone out of fashion in favour of DHCP.
74 .SH AUTHOR
75 Kees J. Bot (kjb@cs.vu.nl)