aboutsummaryrefslogtreecommitdiffstats
path: root/dhcpcd-run-hooks.8.in
diff options
context:
space:
mode:
Diffstat (limited to 'dhcpcd-run-hooks.8.in')
-rw-r--r--dhcpcd-run-hooks.8.in21
1 files changed, 16 insertions, 5 deletions
diff --git a/dhcpcd-run-hooks.8.in b/dhcpcd-run-hooks.8.in
index bcfc81d..c0dc081 100644
--- a/dhcpcd-run-hooks.8.in
+++ b/dhcpcd-run-hooks.8.in
@@ -1,4 +1,4 @@
-.\" Copyright (c) 2006-2010 Roy Marples
+.\" Copyright (c) 2006-2012 Roy Marples
.\" All rights reserved
.\"
.\" Redistribution and use in source and binary forms, with or without
@@ -22,8 +22,8 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd August 24, 2010
-.Dt DHCPCD-RUN-HOOKS 8 SMM
+.Dd March 19, 2012
+.Dt DHCPCD-RUN-HOOKS 8
.Os
.Sh NAME
.Nm dhcpcd-run-hooks
@@ -69,7 +69,7 @@ argument.
Here's a list of reasons why
.Nm
could be invoked:
-.Bl -tag -width PREINIT
+.Bl -tag -width ROUTERADVERT
.It Dv PREINIT
dhcpcd is starting up and any pre-initialisation should be done.
.It Dv CARRIER
@@ -119,6 +119,8 @@ dhcpcd received an OFFER from a DHCP server but will not configure the
interface.
This is primarily used to test the variables are filled correctly for the
script to process them.
+.It Dv ROUTERADVERT
+dhcpcd has received an IPv6 Router Advertisment, or one has expired.
.El
.Sh FILES
When
@@ -134,4 +136,13 @@ in a lexical order and then finally
.Sh AUTHORS
.An Roy Marples Aq roy@marples.name
.Sh BUGS
-Please report them to http://roy.marples.name/projects/dhcpcd
+Please report them to
+.Lk http://roy.marples.name/projects/dhcpcd
+.Sh SECURITY CONSIDERATIONS
+Little validation of DHCP options is done in dhcpcd itself.
+Instead, it is up to the hooks to handle any validation needed.
+To this end, some helper functions are provided, such as valid_domainname as
+used by the
+.Pa 20-resolv.conf
+hook to ensure that the hostname is not set to an invalid value.
+valid_path is also provided, but is currently unused by a stock hook script.