You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
169 lines
4.4 KiB
Groff
169 lines
4.4 KiB
Groff
.\" $KAME: dhcp6s.8,v 1.34 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 DHCP6S 8
|
|
.Os KAME
|
|
.Sh NAME
|
|
.Nm dhcp6s
|
|
.Nd DHCPv6 server
|
|
.\"
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl c Ar configfile
|
|
.Op Fl Ddf
|
|
.Op Fl k Ar ctlkeyfile
|
|
.Op Fl p Ar ctlport
|
|
.Op Fl P Ar pid-file
|
|
.Ar interface
|
|
.\"
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
replies to DHCPv6 client as DHCPv6 server.
|
|
.Nm
|
|
can give the following information to clients.
|
|
.Bl -bullet -compact
|
|
.It
|
|
IPv6 prefixes for the requesting site
|
|
.It
|
|
Non-temporary IPv6 addresses
|
|
.It
|
|
A list of the DNS server addresses
|
|
.It
|
|
DNS Domain Search List
|
|
.It
|
|
A list of the NTP server addresses
|
|
.It
|
|
A list of the SIP server addresses
|
|
.It
|
|
SIP Server domain name
|
|
.It
|
|
A list of the NIS server addresses
|
|
.It
|
|
NIS domain name
|
|
.It
|
|
A list of the NIS+ server addresses
|
|
.It
|
|
NIS+ domain name
|
|
.It
|
|
A list of the BCMCS server addresses
|
|
.It
|
|
BCMCS Server domain name
|
|
.El
|
|
.Pp
|
|
Command line options are as below:
|
|
.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 k Ar ctlkeyfile
|
|
Use
|
|
.Ar ctlkeyfile
|
|
to store the shared secret to authenticate the communication with
|
|
.Nm dhcp6ctl .
|
|
The default file name used when unspecified is
|
|
.Pa /etc/wide-dhcpv6/dhcp6sctlkey .
|
|
The default name is intentionally same as that for
|
|
.Nm dhcp6ctl
|
|
so that the server and the control command can share the file when
|
|
.Nm dhcp6ctl
|
|
controls the server on the same node,
|
|
which should be the typical case.
|
|
.It Fl p Ar ctlport
|
|
Use
|
|
.Ar ctlport
|
|
as the port number listening on to communicate with
|
|
.Nm dhcp6ctl .
|
|
.It Fl P Ar pid-file
|
|
Use
|
|
.Ar pid-file
|
|
to dump the process ID of
|
|
.Nm .
|
|
.El
|
|
.\"
|
|
.Sh FILES
|
|
.Bl -tag -width /etc/wide-dhcpv6/dhcp6s.conf -compact
|
|
.It Pa /etc/wide-dhcpv6/dhcp6s.conf
|
|
is the default configuration file.
|
|
.It Pa /var/lib/dhcpv6/dhcp6s_duid
|
|
is the default file to store the server's DUID.
|
|
.It Pa /etc/wide-dhcpv6/dhcp6sctlkey
|
|
is the default key file to communicate with the control command.
|
|
See
|
|
.Xr dhcp6ctl 8
|
|
for the file format.
|
|
.It Pa /var/run/dhcp6s.pid
|
|
is the default file that contains pid of the currently running
|
|
.Nm .
|
|
.El
|
|
.\"
|
|
.Sh SEE ALSO
|
|
.Xr dhcp6s.conf 5 ,
|
|
.Xr dhcp6ctl 8 ,
|
|
.Xr dhcp6c 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.
|
|
.Pp
|
|
The
|
|
.Fl n Ar dnsserv
|
|
command-line option was obsoleted by introducing a configuration file.
|
|
.\"
|
|
.Sh BUGS
|
|
.Nm
|
|
is incomplete and violates DHCPv6 protocol spec, in several aspects.
|
|
To name a few:
|
|
.Bl -enum
|
|
.It
|
|
it does not assign temporary IPv6 addresses
|
|
.Pq nor will .
|
|
.El
|