4daeb143aec37863fdac20c8b3ed2c207c0d687c
[rpld.git] / doc / rpld.8
1
2 RPLD(8)                     System Manager's Manual                    RPLD(8)
3
4 NAME
5      rpld - an RPL/RIPL remote boot server
6
7 SYNOPSIS
8      rpld
9
10 WARRANTY
11      rpld DOES NOT come with ANY WARRANTY, NOT even an IMPLIED WARRANTY.
12
13 DESCRIPTION
14      rpld will net-boot IBM style RPL boot ROMs. Communication between the
15      client and the server is done in LLC-1 ui/C frames with the source and
16      destination SAP both being 0xfc. On booting the client transmits a FIND
17      frame containing the client's MAC address, adapter type and frame length.
18      The server replies with a FOUND frame containing the server's MAC address
19      and a possibly smaller frame length. The client issues a SEND.FILE.RE-
20      QUEST frame requesting the first block of the boot file. The server then
21      issues a sequence of FILE.DATA.RESPONSE frames with increasing block num-
22      bers. The FILE.DATA.RESPONSE frames contain a load address and an execute
23      address and a flag. If the client fails to receive a FILE.DATA.RESPONSE
24      frame within a certain period it sends another SEND.FILE.REQUEST frame
25      requesting the block which follows the last block that was successfully
26      received. On the last FILE.DATA.RESPONSE frame the server sets a special
27      value of the flags which cause the client to transfer execution to the
28      execute address specified in the frame.
29
30      The server starts by reading the configuration file in /etc/rpld.conf,
31      see rpld.conf(5), After the configuration file has been read, it opens
32      the system's default network interface and listens for RPL frames.  The
33      server recalculates the length of all the files to be downloaded every
34      time it receives a SEND.FILE.REQUEST frame.
35
36 BUGS
37        Solenopsis invicta Burens
38        rpld (probably) doesn't support the new bzImage format correctly.
39        rpld doesn't reload the first 512 octets of Linux kernels automatical-
40        ly.
41        There is no way to make rpld re-read its configuration file.
42        When concurrently serving multiple clients rpld will choose the pacing
43        value of the slowest one.
44        Partial ethernet addresses should be specified in bits not bytes.
45        rpld needs to meet more network adapters.
46
47 NOTES
48      IBM is a trademark of IBM Corp.
49
50 FILES
51      /usr/sbin/rpld
52      /etc/rpld.conf
53      /rplboot
54
55 SEE ALSO
56      rpld.conf(5),
57      bootpd(1),
58      dhcpd(1),
59      http://gimel.esc.cam.ac.uk/james/rpld;
60
61 AUTHORS AND COPYRIGHT
62      (c) 1999,2000 James McKenzie, and Christopher Lightfoot. All rights re-
63      served.
64
65  Linux                           Jun 16, 2000                                1