[BACK]Return to bootptest.8 CVS log [TXT][DIR] Up to [local] / src / usr.sbin / bootpd

File: [local] / src / usr.sbin / bootpd / Attic / bootptest.8 (download)

Revision 1.10, Thu Jun 12 12:59:49 2003 UTC (20 years, 11 months ago) by jmc
Branch: MAIN
CVS Tags: OPENBSD_3_5_BASE, OPENBSD_3_5, OPENBSD_3_4_BASE, OPENBSD_3_4
Changes since 1.9: +2 -2 lines

- section reorder
- macro fixes
- kill whitespace at EOL
- new sentence, new line

.\"	$OpenBSD: bootptest.8,v 1.10 2003/06/12 12:59:49 jmc Exp $
.\"
.\" Copyright (c) 1988-1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that: (1) source code distributions
.\" retain the above copyright notice and this paragraph in its entirety, (2)
.\" distributions including binary code include the above copyright notice and
.\" this paragraph in its entirety in the documentation or other materials
.\" provided with the distribution, and (3) all advertising materials mentioning
.\" features or use of this software display the following acknowledgement:
.\" ``This product includes software developed by the University of California,
.\" Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
.\" the University nor the names of its contributors may be used to endorse
.\" or promote products derived from this software without specific prior
.\" written permission.
.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
.\"
.Dd June 12, 1999
.Dt BOOTPTEST 8
.Os
.Sh NAME
.Nm bootptest
.Nd send BOOTP queries and print responses
.Sh SYNOPSIS
.Nm bootptest
.Op Fl f Ar bootfile
.Op Fl h
.Op Fl m Ar magic_number
.Ar server-name
.Op Ar template-file
.Sh DESCRIPTION
.Nm
sends BOOTP requests to the host specified as
.Ar server-name
at one-second intervals until either a response is received,
or until ten requests have gone unanswered.
After a response is received,
.Nm
will wait one more second listening for additional responses.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl f Ar bootfile
Fill in the boot file field of the request with
.Ar bootfile .
.It Fl h
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.
.It Fl m Ar magic_number
Initialize the first word of the vendor options field with
.Ar magic_number .
.El
.Pp
A
.Ar template-file
may be specified, in which case
.Nm
uses the (binary) contents of this file to initialize the
.Fa options
area of the request packet.
.Sh CREDITS
The bootptest program is a combination of original and derived works.
The main program module (bootptest.c) is original work by
.An Gordon W. Ross Aq gwr@mc.com .
The packet printing module (print-bootp.c) is a slightly modified
version of a file from the BSD tcpdump program.
.Pp
This program includes software developed by the University of
California, Lawrence Berkeley Laboratory and its contributors.
(See the copyright notice in print-bootp.c)
.Sh SEE ALSO
.Xr bootpd 8
.Pp
.Bl -tag -width "RFC 2132" -compact
.It Tn RFC 951
Bootstrap Protocol (BOOTP)
.It RFC 2132
DHCP Options and BOOTP Vendor Extensions
.El