xref: /freebsd/libexec/bootpd/tools/bootptest/bootptest.8 (revision bdd1243df58e60e85101c09001d9812a789b6bc4)
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
18The
19.Nm
20utility sends 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 RFC951
52.%T "BOOTSTRAP PROTOCOL (BOOTP)"
53.Re
54.Rs
55.%O RFC1048
56.%T "BOOTP Vendor Information Extensions"
57.Re
58.Sh AUTHORS
59The
60.Nm
61utility 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 Mt 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