libexec/bootpd/tools/bootptest/bootptest.8

   1 .\" $FreeBSD: src/libexec/bootpd/tools/bootptest/bootptest.8,v 1.2.2.1 2001/01/16 13:14:38 ru Exp $
   2 .\"
   3 .\" bootptest.8
   4 .Dd June 10, 1993
   5 .Dt BOOTPTEST 8
   6 .Os
   7 .Sh NAME
   8 .Nm bootptest
   9 .Nd "send BOOTP queries and print responses"
  10 .Sh SYNOPSIS
  11 .Nm
  12 .Op Fl f Ar bootfile
  13 .Op Fl h
  14 .Op Fl m Ar magic_number
  15 .Ar server\-name
  16 .Op Ar template\-file
  17 .Sh DESCRIPTION
  18 .Nm
  19 sends BOOTP requests to the host specified as
  20 .Ar server\-name
  21 at one\-second intervals until either a response is received,
  22 or until ten requests have gone unanswered.
  23 After a response is received,
  24 .Nm
  25 will wait one more second listening for additional responses.
  26 .Sh OPTIONS
  27 .Bl -tag -width indent
  28 .It Fl f Ar bootfile
  29 Fill in the boot file field of the request with
  30 .Ar bootfile .
  31 .It Fl h
  32 Use the hardware (Ethernet) address to identify the client.
  33 By default, the IP address is copied into the request
  34 indicating that this client already knows its IP address.
  35 .It Fl m Ar magic_number
  36 Initialize the first word of the vendor options field with
  37 .Ar magic_number .
  38 .El
  39 .Pp
  40 A
  41 .Ar template\-file
  42 may be specified, in which case
  43 .Nm
  44 uses the (binary) contents of this file to initialize the
  45 .Em options
  46 area of the request packet.
  47 .Sh SEE ALSO
  48 .Xr bootpd 8
  49 .Rs
  50 .%O RFC 951
  51 .%T "BOOTSTRAP PROTOCOL (BOOTP)"
  52 .Re
  53 .Rs
  54 .%O RFC 1048
  55 .%T "BOOTP Vendor Information Extensions"
  56 .Re
  57 .Sh AUTHORS
  58 The
  59 .Nm
  60 program is a combination of original and derived works.
  61 The main program module
  62 .Pq Pa bootptest.c
  63 is original work by
  64 .An Gordon W. Ross Aq Mt gwr@mc.com .
  65 The packet printing module
  66 .Pq Pa print\-bootp.c
  67 is a slightly modified
  68 version of a file from the
  69 .Bx
  70 .Xr tcpdump 1
  71 program.
  72 .Pp
  73 This program includes software developed by the University of
  74 California, Lawrence Berkeley Laboratory and its contributors.
  75 (See the copyright notice in
  76 .Pa print\-bootp.c . )