xref: /freebsd/libexec/bootpd/tools/bootptest/bootptest.8 (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
1.\"
2.\" bootptest.8
3.Dd June 10, 1993
4.Dt BOOTPTEST 8
5.Os
6.Sh NAME
7.Nm bootptest
8.Nd "send BOOTP queries and print responses"
9.Sh SYNOPSIS
10.Nm
11.Op Fl f Ar bootfile
12.Op Fl h
13.Op Fl m Ar magic_number
14.Ar server\-name
15.Op Ar template\-file
16.Sh DESCRIPTION
17The
18.Nm
19utility sends 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 RFC951
51.%T "BOOTSTRAP PROTOCOL (BOOTP)"
52.Re
53.Rs
54.%O RFC1048
55.%T "BOOTP Vendor Information Extensions"
56.Re
57.Sh AUTHORS
58The
59.Nm
60utility 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