usr.sbin/bootp/bootptest/bootptest.8

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