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