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