freebsd-dev/libexec/bootpd/tools/bootptest/bootptest.8

78 lines
1.7 KiB
Groff
Raw Normal View History

.\" $FreeBSD$
.\"
1994-09-30 05:45:07 +00:00
.\" bootptest.8
2001-01-16 13:12:21 +00:00
.Dd June 10, 1993
.Dt BOOTPTEST 8
.Os
.Sh NAME
.Nm bootptest
.Nd "send BOOTP queries and print responses"
.Sh SYNOPSIS
.Nm
.Op Fl f Ar bootfile
.Op Fl h
.Op Fl m Ar magic_number
.Ar server\-name
.Op Ar template\-file
.Sh DESCRIPTION
2002-07-06 19:19:48 +00:00
The
2001-01-16 13:12:21 +00:00
.Nm
2002-07-06 19:19:48 +00:00
utility sends BOOTP requests to the host specified as
2001-01-16 13:12:21 +00:00
.Ar server\-name
1994-09-30 05:45:07 +00:00
at one\-second intervals until either a response is received,
or until ten requests have gone unanswered.
After a response is received,
2001-01-16 13:12:21 +00:00
.Nm
1994-09-30 05:45:07 +00:00
will wait one more second listening for additional responses.
2001-01-16 13:12:21 +00:00
.Sh OPTIONS
.Bl -tag -width indent
.It Fl f Ar bootfile
1994-09-30 05:45:07 +00:00
Fill in the boot file field of the request with
2001-01-16 13:12:21 +00:00
.Ar bootfile .
.It Fl h
1994-09-30 05:45:07 +00:00
Use the hardware (Ethernet) address to identify the client.
By default, the IP address is copied into the request
indicating that this client already knows its IP address.
2001-01-16 13:12:21 +00:00
.It Fl m Ar magic_number
1994-09-30 05:45:07 +00:00
Initialize the first word of the vendor options field with
2001-01-16 13:12:21 +00:00
.Ar magic_number .
.El
.Pp
1994-09-30 05:45:07 +00:00
A
2001-01-16 13:12:21 +00:00
.Ar template\-file
1994-09-30 05:45:07 +00:00
may be specified, in which case
2001-01-16 13:12:21 +00:00
.Nm
1994-09-30 05:45:07 +00:00
uses the (binary) contents of this file to initialize the
2001-01-16 13:12:21 +00:00
.Em options
1994-09-30 05:45:07 +00:00
area of the request packet.
2005-01-18 09:29:40 +00:00
.Sh SEE ALSO
.Xr bootpd 8
.Rs
.%O RFC951
.%T "BOOTSTRAP PROTOCOL (BOOTP)"
.Re
.Rs
.%O RFC1048
.%T "BOOTP Vendor Information Extensions"
.Re
2001-01-16 13:12:21 +00:00
.Sh AUTHORS
The
.Nm
2002-07-06 19:19:48 +00:00
utility is a combination of original and derived works.
2001-01-16 13:12:21 +00:00
The main program module
.Pq Pa bootptest.c
is original work by
.An Gordon W. Ross Aq Mt gwr@mc.com .
2001-01-16 13:12:21 +00:00
The packet printing module
.Pq Pa print\-bootp.c
is a slightly modified
version of a file from the
.Bx
.Xr tcpdump 1
program.
.Pp
1994-09-30 05:45:07 +00:00
This program includes software developed by the University of
California, Lawrence Berkeley Laboratory and its contributors.
2001-01-16 13:12:21 +00:00
(See the copyright notice in
.Pa print\-bootp.c . )