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