xref: /netbsd-src/usr.bin/rump_dhcpclient/rump.dhcpclient.1 (revision 72e44f84cb5b48f30b82cc15884a628bba6d3928)
1*72e44f84Sandvar.\"	$NetBSD: rump.dhcpclient.1,v 1.4 2021/09/16 21:29:42 andvar Exp $
2e9639606Spooka.\"
3e9639606Spooka.\" Copyright (c) 2011 Antti Kantee.  All rights reserved.
4e9639606Spooka.\"
5e9639606Spooka.\" Redistribution and use in source and binary forms, with or without
6e9639606Spooka.\" modification, are permitted provided that the following conditions
7e9639606Spooka.\" are met:
8e9639606Spooka.\" 1. Redistributions of source code must retain the above copyright
9e9639606Spooka.\"    notice, this list of conditions and the following disclaimer.
10e9639606Spooka.\" 2. Redistributions in binary form must reproduce the above copyright
11e9639606Spooka.\"    notice, this list of conditions and the following disclaimer in the
12e9639606Spooka.\"    documentation and/or other materials provided with the distribution.
13e9639606Spooka.\"
14e9639606Spooka.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND
15e9639606Spooka.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16e9639606Spooka.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17e9639606Spooka.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18e9639606Spooka.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19e9639606Spooka.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20e9639606Spooka.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21e9639606Spooka.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22e9639606Spooka.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23e9639606Spooka.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24e9639606Spooka.\" SUCH DAMAGE.
25e9639606Spooka.\"
26e9639606Spooka.Dd January 20, 2011
27e9639606Spooka.Dt RUMP.DHCPCLIENT 1
28e9639606Spooka.Os
29e9639606Spooka.Sh NAME
30e9639606Spooka.Nm rump.dhcpclient
31e9639606Spooka.Nd simple dhcp client for rump kernels
32e9639606Spooka.Sh SYNOPSIS
33e9639606Spooka.Nm
34e9639606Spooka.Ar ifname
35e9639606Spooka.Sh DESCRIPTION
36e9639606SpookaThe
37e9639606Spooka.Nm
38e9639606Spookautility is a very simple DHCP client which can be used to apply
396792460bSwiznetworking configuration on one interface in a rump kernel.
406792460bSwizUnlike full DHCP clients,
41e9639606Spooka.Nm
42e9639606Spookadoes not store leases or renew expired leases.
43e9639606SpookaThe reason for this is the typical transient nature of a rump kernel.
44e9639606SpookaAdditionally,
45e9639606Spooka.Nm
460d30d053Spookadoes not save DNS resolver information.
47e9639606Spooka.Pp
48*72e44f84SandvarAfter having successfully configured networking,
49e9639606Spooka.Nm
50e9639606Spookaprints out the networking configuration and lease time and exits.
51e9639606Spooka.Pp
52e9639606SpookaSince
53e9639606Spooka.Nm
54e9639606Spookauses
55e9639606Spooka.Xr bpf 4
56e9639606Spookato send and receive raw network packets, the server must include
57e9639606Spookasupport for bpf and vfs (for opening
58e9639606Spooka.Pa /dev/bpf ) .
59e9639606SpookaOtherwise, the following diagnostic message is printed:
60e9639606Spooka.Bd -literal -offset indent
61e9639606Spookarump.dhcpclient: bpf: Function not implemented
62e9639606Spooka.Ed
63e9639606Spooka.Sh SEE ALSO
64e9639606Spooka.Xr rump_server 1 ,
65e9639606Spooka.Xr bpf 4
66e9639606Spooka.Sh CAVEATS
67e9639606SpookaThere is no easy way to release a lease.
68