| resolvconf.conf.5.in (416ba5c74546f32a993436a99516d35008e9f384) | resolvconf.conf.5.in (2d004dd5bc51eaef924f55d1e2407e80a9b4bcb5) |
|---|---|
| 1.\" Copyright (c) 2009-2015 Roy Marples 2.\" All rights reserved 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" | 1.\" Copyright (c) 2009-2015 Roy Marples 2.\" All rights reserved 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" |
| 25.Dd March 20, 2015 | 25.Dd May 14, 2015 |
| 26.Dt RESOLVCONF.CONF 5 27.Os 28.Sh NAME 29.Nm resolvconf.conf 30.Nd resolvconf configuration file 31.Sh DESCRIPTION 32.Nm 33is the configuration file for --- 52 unchanged lines hidden (view full) --- 86.It Sy name_server_blacklist 87A list of name servers to be removed from consideration. 88The default is 0.0.0.0 as some faulty routers send it via DHCP. 89To remove a block, you can use 192.168.* 90.It Sy private_interfaces 91These interfaces name servers will only be queried for the domains listed 92in their resolv.conf. 93Useful for VPN domains. | 26.Dt RESOLVCONF.CONF 5 27.Os 28.Sh NAME 29.Nm resolvconf.conf 30.Nd resolvconf configuration file 31.Sh DESCRIPTION 32.Nm 33is the configuration file for --- 52 unchanged lines hidden (view full) --- 86.It Sy name_server_blacklist 87A list of name servers to be removed from consideration. 88The default is 0.0.0.0 as some faulty routers send it via DHCP. 89To remove a block, you can use 192.168.* 90.It Sy private_interfaces 91These interfaces name servers will only be queried for the domains listed 92in their resolv.conf. 93Useful for VPN domains. |
| 94Setting 95.Sy private_interfaces Ns ="*" 96will stop the forwarding of the root zone and allows the local resolver to 97recursively query the root servers directly. 98Requires a local nameserver other than libc. |
|
| 94This is equivalent to the 95.Nm resolvconf -p 96option. 97.It Sy replace 98Is a space separated list of replacement keywords. The syntax is this: 99.Va $keyword Ns / Ns Va $match Ns / Ns Va $replacement 100.Pp 101Example, given this resolv.conf: --- 42 unchanged lines hidden (view full) --- 144.It Sy resolv_conf_passthrough 145When set to YES the latest resolv.conf is written to 146.Sy resolv_conf 147without any alteration. 148When set to /dev/null or NULL, 149.Sy resolv_conf_local_only 150is defaulted to NO, 151.Sy local_nameservers | 99This is equivalent to the 100.Nm resolvconf -p 101option. 102.It Sy replace 103Is a space separated list of replacement keywords. The syntax is this: 104.Va $keyword Ns / Ns Va $match Ns / Ns Va $replacement 105.Pp 106Example, given this resolv.conf: --- 42 unchanged lines hidden (view full) --- 149.It Sy resolv_conf_passthrough 150When set to YES the latest resolv.conf is written to 151.Sy resolv_conf 152without any alteration. 153When set to /dev/null or NULL, 154.Sy resolv_conf_local_only 155is defaulted to NO, 156.Sy local_nameservers |
| 152is unset unless overriden and only the information set in | 157is unset unless overridden and only the information set in |
| 153.Nm 154is written to 155.Sy resolv_conf . 156.It Sy resolv_conf_sortlist 157A libc resolver sortlist, as specified in 158.Xr resolv.conf 5 . 159.It Sy resolv_conf_local_only 160If a local name server is configured then the default is just to specify that --- 105 unchanged lines hidden (view full) --- 266locations. 267For example, named service scripts have been called named, bind and rc.bind 268and they could be located in a directory called /etc/rc.d, /etc/init.d or 269similar. 270Each subscriber attempts to automatically configure itself, but not every 271distribution has been catered for. 272Also, users could equally want to use a different version from the one 273installed by default, such as bind8 and bind9. | 158.Nm 159is written to 160.Sy resolv_conf . 161.It Sy resolv_conf_sortlist 162A libc resolver sortlist, as specified in 163.Xr resolv.conf 5 . 164.It Sy resolv_conf_local_only 165If a local name server is configured then the default is just to specify that --- 105 unchanged lines hidden (view full) --- 271locations. 272For example, named service scripts have been called named, bind and rc.bind 273and they could be located in a directory called /etc/rc.d, /etc/init.d or 274similar. 275Each subscriber attempts to automatically configure itself, but not every 276distribution has been catered for. 277Also, users could equally want to use a different version from the one 278installed by default, such as bind8 and bind9. |
| 274To accomodate this, the subscribers have these files in configurable | 279To accommodate this, the subscribers have these files in configurable |
| 275variables, documented below. 276.Pp 277.Bl -tag -width indent 278.It Sy dnsmasq_service 279Location of the dnsmasq service. 280.It Sy dnsmasq_restart 281Command to restart the dnsmasq service. 282.It Sy dnsmasq_pid --- 31 unchanged lines hidden --- | 280variables, documented below. 281.Pp 282.Bl -tag -width indent 283.It Sy dnsmasq_service 284Location of the dnsmasq service. 285.It Sy dnsmasq_restart 286Command to restart the dnsmasq service. 287.It Sy dnsmasq_pid --- 31 unchanged lines hidden --- |