libexec/bootpd/tools/bootptest/bootptest.8

   1 .\" $FreeBSD$
   2 .\"
   3 .\" bootptest.8
   4 .TH BOOTPTEST 8 "10 June 1993" "MAINTENANCE COMMANDS"
   5 .SH NAME
   6 bootptest \- send BOOTP queries and print responses
   7 .SH SYNOPSIS
   8 .LP
   9 .B bootptest
  10 [
  11 .B \-f
  12 .I bootfile
  13 ]
  14 [
  15 .B \-h
  16 ]
  17 [
  18 .B \-m
  19 .I magic_number
  20 ]
  21 .I server\-name
  22 .RI [ template-file ]
  23 .SH DESCRIPTION
  24 .B bootptest
  25 sends BOOTP requests to the host specified as
  26 .I server\-name
  27 at one\-second intervals until either a response is received,
  28 or until ten requests have gone unanswered.
  29 After a response is received,
  30 .B bootptest
  31 will wait one more second listening for additional responses.
  32 .SH OPTIONS
  33 .TP
  34 .B \-f
  35 .I bootfile
  36 Fill in the boot file field of the request with
  37 .IR bootfile .
  38 .TP
  39 .B \-h
  40 Use the hardware (Ethernet) address to identify the client.
  41 By default, the IP address is copied into the request
  42 indicating that this client already knows its IP address.
  43 .TP
  44 .B \-m
  45 .I magic_number
  46 Initialize the first word of the vendor options field with
  47 .IR magic_number .
  48 .LP
  49 A
  50 .I template-file
  51 may be specified, in which case
  52 .B bootptest
  53 uses the (binary) contents of this file to initialize the
  54 .I options
  55 area of the request packet.
  56 .SH CREDITS
  57 .LP
  58 The bootptest program is a combination of original and derived works.
  59 The main program module (bootptest.c) is original work by
  60 Gordon W. Ross <gwr@mc.com>.
  61 The packet printing module (print-bootp.c) is a slightly modified
  62 version of a file from the BSD tcpdump program.
  63 .LP
  64 This program includes software developed by the University of
  65 California, Lawrence Berkeley Laboratory and its contributors.
  66 (See the copyright notice in print-bootp.c)
  67 .SH "SEE ALSO"
  68 .LP
  69 bootpd(8)
  70 .SH REFERENCES
  71 .TP
  72 RFC951
  73 BOOTSTRAP PROTOCOL (BOOTP)
  74 .TP
  75 RFC1048
  76 BOOTP Vendor Information Extensions