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