README revision 1.1
1 2This is an enhanced version of the CMU BOOTP server which was derived 3from the original BOOTP server created by Bill Croft at Stanford. 4This version merges all the enhancements and bug-fixes from the 5NetBSD, Columbia, and other versions. 6 7If you have problems or questions about this version, send email to: 8 gwr@mc.com (Gordon W. Ross) 9 10For general questions about BOOTP, send email to the list: 11 bootp@andrew.cmu.edu 12You can subscribe to this mailing list by sending mail to: 13 bootp-request@andrew.cmu.edu 14(The body of the message should contain: "Add <your-address>") 15 16[ From the NetBSD README file: ] 17 18BOOTPD is a useful adjunct to the nfs diskless boot EPROM code. 19 20The alternatives for initiating a boot of a kernel across a network 21are to use RARP protocol, or BOOTP protocol. BOOTP is more flexible; 22it allows additional items of information to be returned to the 23booting client; it also supports booting across gateways. 24 25[ From the CMU README file: ] 26 27Notes: 281) BOOTP was originally designed and implemented by Bill Croft at Stanford. 29 Much of the credit for the ideas and the code goes to him. We've added 30 code to support the vendor specific area of the packet as specified in 31 RFC1048. We've also improved the host lookup algorithm and added some 32 extra logging. 33 342) The server now uses syslog to do logging. Specifically it uses the 4.3bsd 35 version. I've #ifdef'd all of these calls. If you are running 4.2 you 36 should compile without the -DSYSLOG switch. 37 383) You must update your /etc/services file to contain the following two lines: 39 bootps 67/udp bootp # BOOTP Server 40 bootpc 68/udp # BOOTP Client 41 424) Edit the bootptab. It has some explanitory comments, and there 43 is a manual entry describing its format (bootptab.5) 44 If you have any questions, just let us know. 45 46Construction: 47 [ See the file Installation which is more up-to-date. -gwr ] 48 49 Make sure all of the files exist first. If anything is missing, 50 please contact either Walt Wimer or Drew Perkins by E-mail or phone. 51 Addresses and phone numbers are listed below. 52 53 Type 'make'. The options at present are: -DSYSLOG which enables logging 54 code, -DDEBUG which enables table dumping via signals, and -DVEND_CMU 55 which enables the CMU extensions for CMU PC/IP. 56 57 Edit the bootptab. The man page and the comments in the file should 58 explain how to go about doing so. If you have any problems, let me know. 59 60 Type 'make install'. This should put all of the files in the right place. 61 62 Edit your /etc/rc.local or /etc/inetd.conf file to start up bootpd upon 63 reboot. The following is a sample /etc/inetd.conf entry: 64 # BOOTP server 65 bootps dgram udp wait root /usr/etc/bootpd bootpd -i 66 67Care and feeding: 68 If you change the interface cards on your host or add new hosts you will 69 need to update /etc/bootptab. Just edit it as before. Once you write 70 it back out, bootpd will notice that there is a new copy and will 71 reread it the next time it gets a request. 72 73 If your bootp clients don't get a response then several things might be 74 wrong. Most often, the entry for that host is not in the database. 75 Check the hardware address and then check the entry and make sure 76 everything is right. Other problems include the server machine crashing, 77 bad cables, and the like. If your network is very congested you should 78 try making your bootp clients send additional requests before giving up. 79 80 81November 7, 1988 82 83 84Walter L. Wimer Drew D. Perkins 85ww0n@andrew.cmu.edu ddp@andrew.cmu.edu 86(412) 268-6252 (412) 268-8576 87 884910 Forbes Ave 89Pittsburgh, PA 15213 90 91[ Contents description by file: ] 92 93Announce* Text of release announcements 94Installation Instructions for building and installing 95Makefile* for "make" 96README This file 97bootp.h The protocol header file 98bootpd.8 Manual page for bootpd, boopgw 99bootpd.c BOOTP server main module 100bootpd.h header for above (and others) 101bootpef.8 Manual page for bootpef 102bootpef.c BOOTP extension file compiler 103bootpgw.c BOOTP gateway main module 104bootptab.5 A manual describing the bootptab format 105bootptab.cmu A sample database file for the server 106bootptab.mcs Another sample from <gwr@mc.com> 107bootptest.8 Manual page for bootptest 108bootptest.c BOOTP test program (fake client) 109bootptest.h header for above 110dovend.c Vendor Option builder (for bootpd, bootpef) 111dovend.h header for above 112dumptab.c Implements debugging dump for bootpd 113getether.c For bootptest (not used yet) 114getif.c Get network interface info. 115getif.h header for above 116hash.c The hash table module 117hash.h header for above 118hwaddr.c Hardware address support 119hwaddr.h header for above 120lookup.c Internet Protocol address lookup 121lookup.h header for above 122patchlevel.h Holds version numbers 123print-bootp.c Prints BOOTP packets (taken from BSD tcpdump) 124readfile.c The configuration file-reading routines 125readfile.h header for above 126report.c Does syslog-style messages 127report.h header for above 128strerror.c Library errno-to-string (for systems lacking it) 129syslog.conf Sample config file for syslogd(8) 130syslog.h For systems that lack syslog(3) 131try*.c Test programs (for debugging) 132tzone.c Get timezone offset 133tzone.h header for above 134