Add support for the unbound nameserver - http://www.unbound.net/
[openresolv] / resolvconf.conf.5.in
index a652c3a37b8128abef352a691c59e40406d875c0..bef8f41fa369918592cb02ca438342c2aa26c797 100644 (file)
@@ -1,4 +1,4 @@
-.\" Copyright 2009 Roy Marples
+.\" Copyright (c) 2009 Roy Marples
 .\" All rights reserved
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd April 22, 2009
+.Dd November 15, 2009
 .Dt RESOLVCONF.CONF 5 SMM
 .Os
 .Sh NAME
@@ -52,6 +52,12 @@ in their resolv.conf.
 This is equivalent to the
 .Nm resolvconf -p
 option.
+.It Sy state_dir
+Override the default state directory of
+.Pa @VARDIR@ .
+This should not be changed once
+.Nm resolvconf
+is in use unless the old directory is copied to the new one.
 .El
 .Sh LIBC OPTIONS
 The following variables affect
@@ -62,6 +68,9 @@ directly:-
 Defaults to
 .Pa /etc/resolv.conf
 if not set.
+.It Sy resolv_conf_options
+A list of libc resolver options, as specified in
+.Xr resolv.conf 5 .
 .It Sy search_domains
 Prepend search domains to the dynamically generated list.
 .It Sy name_servers
@@ -75,29 +84,37 @@ without any alteration.
 .El
 .Sh SUBSCRIBER OPTIONS
 openresolv ships with subscribers for the name servers
-.Xr dnsmasq 8
+.Xr dnsmasq 8 ,
+.Xr named 8
 and
-.Xr named 8 .
-These subscribers take two options each which instruct openresolv where
+.Xr unbound 8 .
+These subscribers have options which instruct openresolv where
 to write the configuration files for the name server to include.
 .Bl -tag -width indent
 .It Sy dnsmasq_conf
 Set this to the same file that the dnsmasq configuaration option
 .Sy conf-file
 points to.
+This file tells dnsmasq which nameservers to use for specific domains.
 .It Sy dnsmasq_resolv
 Set this to the same file that the dnsmasq configuaration option
 .Sy resolv-file
 points to.
+This file tells dnsmasq which nameservers to use for global lookups.
 .It Sy named_options
 Include this file in the named options block.
+This file tells named which nameservers to use for global lookups.
 .It Sy named_zones
 Include this file in the named global scope, after the options block.
+This file tells named which nameservers to use for specific domains.
+.It Sy unbound_conf
+Include this file anywhere in the unbound configuration.
+This file tells unbound about specific and global nameservers.
 .El
 .Sh SEE ALSO
-.Xr resolv.conf 5 ,
-.Xr resolvconf 8 ,
-.Xr named.conf 5
+.Xr resolv.conf 5
+and
+.Xr resolvconf 8 .
 .Sh AUTHORS
 .An Roy Marples Aq roy@marples.name
 .Sh BUGS