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
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 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
59The
60.Nm
61program is a combination of original and derived works.
62The main program module
63.Pq Pa bootptest.c
64is original work by
65.An "Gordon W. Ross" Aq gwr@mc.com .
66The packet printing module
67.Pq Pa print\-bootp.c
68is a slightly modified
69version of a file from the
70.Bx
71.Xr tcpdump 1
72program.
73.Pp
74This program includes software developed by the University of
75California, Lawrence Berkeley Laboratory and its contributors.
76(See the copyright notice in
77.Pa print\-bootp.c . )
78