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