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