xref: /freebsd/libexec/bootpd/tools/bootptest/bootptest.8 (revision 5521ff5a4d1929056e7ffc982fac3341ca54df7c)
1.\" $FreeBSD$
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 AUTHORS
48The
49.Nm
50program is a combination of original and derived works.
51The main program module
52.Pq Pa bootptest.c
53is original work by
54.An "Gordon W. Ross" Aq gwr@mc.com .
55The packet printing module
56.Pq Pa print\-bootp.c
57is a slightly modified
58version of a file from the
59.Bx
60.Xr tcpdump 1
61program.
62.Pp
63This program includes software developed by the University of
64California, Lawrence Berkeley Laboratory and its contributors.
65(See the copyright notice in
66.Pa print\-bootp.c . )
67.Sh SEE ALSO
68.Xr bootpd 8
69.Rs
70.%O RFC951
71.%T "BOOTSTRAP PROTOCOL (BOOTP)"
72.Re
73.Rs
74.%O RFC1048
75.%T "BOOTP Vendor Information Extensions"
76.Re
77