From f2c49875c1ce6e1d3c51968f7b058b1b0c55428c Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 20:43:02 +0200 Subject: Adding upstream version 20080615. Signed-off-by: Daniel Baumann --- dhcp6c.8 | 208 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 208 insertions(+) create mode 100644 dhcp6c.8 (limited to 'dhcp6c.8') diff --git a/dhcp6c.8 b/dhcp6c.8 new file mode 100644 index 0000000..6824ae0 --- /dev/null +++ b/dhcp6c.8 @@ -0,0 +1,208 @@ +.\" $KAME: dhcp6c.8,v 1.36 2005/03/17 05:27:01 suz Exp $ +.\" +.\" Copyright (C) 1998 and 1999 WIDE Project. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. Neither the name of the project 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 BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.Dd Sep 12, 1999 +.Dt DHCP6C 8 +.Os KAME +.Sh NAME +.Nm dhcp6c +.Nd DHCPv6 client daemon +.\" +.Sh SYNOPSIS +.Nm +.Op Fl c Ar configfile +.Op Fl Ddfi +.Op Fl p Ar pid-file +.Ar interface +.Op Ar interfaces... +.\" +.Sh DESCRIPTION +.Nm +works as a DHCPv6 client and gets information from DHCPv6 servers +to configure the specified +.Ar interface . +Multiple +.Ar interfaces +can be specified separated by spaces or tabs, +in which case +.Nm +will work on all the interfaces simultaneously. +.Pp +The command line options are: +.Bl -tag -width indent +.\" +.It Fl c Ar configfile +Use +.Ar configfile +as the configuration file. +.It Fl d +Print debugging messages. +.It Fl D +Even more debugging information is printed. +.It Fl f +Foreground mode (useful when debugging). +Although +.Nm +usually prints warning, debugging, or error messages to +.Xr syslog 8 , +it prints the messages to standard error if this option is +specified. +.It Fl i +Info-req mode. In this mode, stateless DHCPv6 is executed with the folllowing configuration, and the obtained info is written to stdout. After this output, +.Nm +is terminated. (suits for a use in shell-script etc). +.Bd -literal -offset + interface (interface given in the argument) { + information-only; + script (a script which displays the received information to stdout); + }; +.Ed +.Pp +Since the configuration is internally generated, you cannot provide a configuration in this mode. If you want to have different actions for the stateless DHCPv6 information, you should write an appropriate configuration and invoke +.Nm +without this option. +.It Fl p Ar pid-file +Use +.Ar pid-file +to dump the process ID of +.Nm . +.El +.Pp +The program will daemonize itself on invocation unless the +.Fl f +or +.Fl i +option is specified. +.Pp +Upon receipt of the +.Dv SIGHUP +or +.Dv SIGTERM +signals, +.Nm +will remove all stateful resources from the system. +In the former case the daemon will then reinvoke itself, +while it will stop running in the latter case. +In either case, +.Nm +will send DHCPv6 Release messages to release resources assigned from servers. +.\" +.Sh FILES +.Bl -tag -width /usr/local/etc/dhcp6c.conf -compact +.It Pa /var/run/dhcp6c.pid +is the default file that contains pid of the currently running +.Nm dhcp6c . +.It Pa /usr/local/etc/dhcp6c.conf +is the default configuration file. +.It Pa /var/db/dhcp6c_duid +is the file to store the client's DUID. +.El +.Sh Configuration Script +When +.Nm +receives a reply message, +it will invoke a supplementary configuration script specified in the +.Xr dhcp6c.conf 5 +file. +The daemon will provide the script with configuration parameters as +environment variables, +which include: +.Pp +.Bl -tag -width Ds -compact +.It Ic REASON +The reason why the script is invoked. +As of this writing, +the value is always +\(dqNBI\(dq +and thus meaningless. +.It Ic new_domain_name_servers +A list of available DNS servers, +each of which is an IPv6 numeric address and is separated by a white +space character. +.It Ic new_domain_name +A list of DNS names, +which provides DNS name search path. +.It Ic new_ntp_servers +A list of available NTP servers, +each of which is an IPv6 numeric address and is separated by a white +space character. +.It Ic new_sip_servers +A list of available SIP server addresses, +each of which is an IPv6 numeric address and is separated by a white +space character. +.It Ic new_sip_name +A list of SIP server domain names. +.It Ic new_nis_servers +A list of available NIS server addresses, +each of which is an IPv6 numeric address and is separated by a white +space character. +.It Ic new_nis_name +A list of NIS domain names. +.It Ic new_nisp_servers +A list of available NIS+ server addresses, +each of which is an IPv6 numeric address and is separated by a white +space character. +.It Ic new_nisp_name +A list of NIS+ domain names. +.It Ic new_bcmcs_servers +A list of available BCMCS server addresses, +each of which is an IPv6 numeric address and is separated by a white +space character. +.It Ic new_bcmcs_name +A list of BCMCS server domain names. +.El +.Pp +Note that the daemon does not always provide all the parameters. +It sets an environment variable only when the corresponding +configuration parameter is provided by the DHCPv6 server. +.\" +.Sh SEE ALSO +.Xr daemon 3 , +.Xr dhcp6c.conf 5 , +.Xr dhcp6s 8 +.Rs +.%A Ralph Droms, Editor +.%D 2003 +.%T Dynamic Host Configuration Protocol for IPv6 (DHCPv6) +.%R RFC 3315 +.Re +.\" +.Sh HISTORY +The +.Nm +command first appeared in WIDE/KAME IPv6 protocol stack kit. +.\" +.Sh BUGS +.Nm +is incomplete and violates DHCPv6 protocol spec, in several aspects. +In particular, temporary address assignment is intentionally omitted. +.Pp +Information Refresh Time Option is not recognied in Info-req mode, since +.Nm +terminates after it receives a REPLY message. -- cgit v1.2.3