Add a README with simple example config for dhcpcd showing DHCPv6-PD use

over pppoe, fetching prefixes from upstream and assigning them to a couple
of local interfaces.
This commit is contained in:
sthen 2015-09-24 15:14:11 +00:00
parent c02167037d
commit 07aec21fa4
3 changed files with 38 additions and 4 deletions

View File

@ -1,8 +1,8 @@
# $OpenBSD: Makefile,v 1.5 2015/09/11 15:05:46 sthen Exp $
# $OpenBSD: Makefile,v 1.6 2015/09/24 15:14:11 sthen Exp $
COMMENT= DHCPv4/IPv4LL/IPv6RS/DHCPv6 quad stack client
DISTNAME= dhcpcd-6.9.3
REVISION= 0
REVISION= 1
CATEGORIES= net
EXTRACT_SUFX= .tar.xz
@ -11,7 +11,7 @@ HOMEPAGE= http://roy.marples.name/projects/dhcpcd/
# BSD-2
PERMIT_PACKAGE_CDROM= Yes
WANTLIB= c
WANTLIB += c
MASTER_SITES= http://roy.marples.name/downloads/dhcpcd/ \
ftp://roy.marples.name/pub/dhcpcd/

View File

@ -1,4 +1,4 @@
@comment $OpenBSD: PLIST,v 1.2 2015/09/08 19:10:19 sthen Exp $
@comment $OpenBSD: PLIST,v 1.3 2015/09/24 15:14:11 sthen Exp $
libexec/dhcpcd-hooks/
libexec/dhcpcd-hooks/01-test
libexec/dhcpcd-hooks/02-dump
@ -14,6 +14,7 @@ libexec/dhcpcd-run-hooks
@man man/man8/dhcpcd-run-hooks.8
@man man/man8/dhcpcd.8
@bin sbin/dhcpcd
share/doc/pkg-readmes/${FULLPKGNAME}
share/examples/dhcpcd/
share/examples/dhcpcd/dhcpcd.conf
@sample ${SYSCONFDIR}/dhcpcd.conf

33
net/dhcpcd/pkg/README Normal file
View File

@ -0,0 +1,33 @@
$OpenBSD: README,v 1.1 2015/09/24 15:14:11 sthen Exp $
+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------
DHCPv6-PD (Prefix Delegation)
=============================
As OpenBSD doesn't yet support DHCPv6 in the base OS, one common use of
this package is to request Prefix Delegation from an ISP, which hands you
one or more routable IPv6 subnet that can be assigned to interfaces
facing your local network.
Here is a sample configuration achieving this, fetching addresses over the
pppoe0 interface and assigning it to multiple local networks. In this example,
dhcpcd's router solicitation support is disabled (noipv6rs) - the kernel's
support should be used instead ("rtsol" in /etc/hostname.pppoe0). It fetches
addresses over pppoe0 and assigns them to "downstream" interfaces em0, vlan3
and vlan5. These interfaces are listed explicitly so that dhcpcd doesn't
touch other interfaces at all.
noipv6rs
ipv6only
duid
persistent
option rapid_commit
require dhcp_server_identifier
nohook lookup-hostname
allowinterfaces pppoe0 em0 vlan3 vlan5
interface pppoe0
iaid 1
ia_pd 2 em0/1 vlan3/2 vlan5/3