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
19sends BOOTP requests to the host specified as
20.Ar server\-name
21at one\-second intervals until either a response is received,
22or until ten requests have gone unanswered.
23After a response is received,
24.Nm
25will wait one more second listening for additional responses.
26.Sh OPTIONS
27.Bl -tag -width indent
28.It Fl f Ar bootfile
29Fill in the boot file field of the request with
30.Ar bootfile .
31.It Fl h
32Use the hardware (Ethernet) address to identify the client.
33By default, the IP address is copied into the request
34indicating that this client already knows its IP address.
35.It Fl m Ar magic_number
36Initialize the first word of the vendor options field with
37.Ar magic_number .
38.El
39.Pp
40A
41.Ar template\-file
42may be specified, in which case
43.Nm
44uses the (binary) contents of this file to initialize the
45.Em options
46area 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
58The
59.Nm
60program is a combination of original and derived works.
61The main program module
62.Pq Pa bootptest.c
63is original work by
64.An Gordon W. Ross Aq Mt gwr@mc.com .
65The packet printing module
66.Pq Pa print\-bootp.c
67is a slightly modified
68version of a file from the
69.Bx
70.Xr tcpdump 1
71program.
72.Pp
73This program includes software developed by the University of
74California, Lawrence Berkeley Laboratory and its contributors.
75(See the copyright notice in
76.Pa print\-bootp.c . )
77