| resolvconf.8.in (302408) | resolvconf.8.in (304515) |
|---|---|
| 1.\" Copyright (c) 2007-2015 Roy Marples | 1.\" Copyright (c) 2007-2016 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. 9.\" 2. Redistributions in binary form must reproduce the above copyright --- 7 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.\" | 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. 9.\" 2. Redistributions in binary form must reproduce the above copyright --- 7 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 April 27, 2015 | 25.Dd May 7, 2016 |
| 26.Dt RESOLVCONF 8 27.Os 28.Sh NAME 29.Nm resolvconf 30.Nd a framework for managing multiple DNS configurations 31.Sh SYNOPSIS 32.Nm 33.Fl I --- 25 unchanged lines hidden (view full) --- 59.Pa /etc/resolv.conf . 60.Pp 61.Nm 62solves this by letting the daemon send their 63.Xr resolv.conf 5 64file to 65.Nm 66via | 26.Dt RESOLVCONF 8 27.Os 28.Sh NAME 29.Nm resolvconf 30.Nd a framework for managing multiple DNS configurations 31.Sh SYNOPSIS 32.Nm 33.Fl I --- 25 unchanged lines hidden (view full) --- 59.Pa /etc/resolv.conf . 60.Pp 61.Nm 62solves this by letting the daemon send their 63.Xr resolv.conf 5 64file to 65.Nm 66via |
| 67.Xr stdin 3 | 67.Xr stdin 4 |
| 68with the argument 69.Fl a Ar interface Ns Op Ar .protocol 70instead of the filesystem. 71.Nm 72then updates 73.Pa /etc/resolv.conf 74as it thinks best. 75When a local resolver other than libc is installed, such as --- 20 unchanged lines hidden (view full) --- 96.Pp 97.Nm 98can mark an interfaces 99.Pa resolv.conf 100as private. 101This means that the name servers listed in that 102.Pa resolv.conf 103are only used for queries against the domain/search listed in the same file. | 68with the argument 69.Fl a Ar interface Ns Op Ar .protocol 70instead of the filesystem. 71.Nm 72then updates 73.Pa /etc/resolv.conf 74as it thinks best. 75When a local resolver other than libc is installed, such as --- 20 unchanged lines hidden (view full) --- 96.Pp 97.Nm 98can mark an interfaces 99.Pa resolv.conf 100as private. 101This means that the name servers listed in that 102.Pa resolv.conf 103are only used for queries against the domain/search listed in the same file. |
| 104This only works when a local resolver other than libc is installed. | 104This only works when a local resolver other than libc is installed. |
| 105See 106.Xr resolvconf.conf 5 107for how to configure 108.Nm 109to use a local name server. 110.Pp 111.Nm 112can mark an interfaces --- 7 unchanged lines hidden (view full) --- 120.Fl d Ar interface.* 121arguments to delete the 122.Pa resolv.conf 123file(s) for all the 124.Ar protocols 125on the 126.Ar interface . 127.Pp | 105See 106.Xr resolvconf.conf 5 107for how to configure 108.Nm 109to use a local name server. 110.Pp 111.Nm 112can mark an interfaces --- 7 unchanged lines hidden (view full) --- 120.Fl d Ar interface.* 121arguments to delete the 122.Pa resolv.conf 123file(s) for all the 124.Ar protocols 125on the 126.Ar interface . 127.Pp |
| 128Here are some more options that 129.Nm 130has:- | 128Here are some options for the above commands:- |
| 131.Bl -tag -width indent | 129.Bl -tag -width indent |
| 132.It Fl I 133Initialise the state directory 134.Pa @VARDIR@ . 135This only needs to be called if the initial system boot sequence does not 136automatically clean it out; for example the state directory is moved 137somewhere other than 138.Pa /var/run . 139If used, it should only be called once as early in the system boot sequence 140as possible and before 141.Nm 142is used to add interfaces. | |
| 143.It Fl f | 130.It Fl f |
| 144Ignore non existant interfaces. | 131Ignore non existent interfaces. |
| 145Only really useful for deleting interfaces. | 132Only really useful for deleting interfaces. |
| 133.It Fl m Ar metric 134Set the metric of the interface when adding it, default of 0. 135Lower metrics take precedence. 136This affects the default order of interfaces when listed. 137.It Fl p 138Marks the interface 139.Pa resolv.conf 140as private. 141.It Fl x 142Mark the interface 143.Pa resolv.conf 144as exclusive when adding, otherwise only use the latest exclusive interface. 145.El 146.Pp 147.Nm 148has some more commands for general usage:- 149.Bl -tag -width indent |
|
| 146.It Fl i Ar pattern 147List the interfaces and protocols, optionally matching 148.Ar pattern , 149we have 150.Pa resolv.conf 151files for. 152.It Fl l Ar pattern 153List the 154.Pa resolv.conf 155files we have. 156If 157.Ar pattern 158is specified then we list the files for the interfaces and protocols 159that match it. | 150.It Fl i Ar pattern 151List the interfaces and protocols, optionally matching 152.Ar pattern , 153we have 154.Pa resolv.conf 155files for. 156.It Fl l Ar pattern 157List the 158.Pa resolv.conf 159files we have. 160If 161.Ar pattern 162is specified then we list the files for the interfaces and protocols 163that match it. |
| 160.It Fl m Ar metric 161Set the metric of the interface when adding it, default of 0. 162Lower metrics take precedence. 163This affects the default order of interfaces when listed. 164.It Fl p 165Marks the interface 166.Pa resolv.conf 167as private. | |
| 168.It Fl u 169Force 170.Nm 171to update all its subscribers. 172.Nm 173does not update the subscribers when adding a resolv.conf that matches 174what it already has for that interface. | 164.It Fl u 165Force 166.Nm 167to update all its subscribers. 168.Nm 169does not update the subscribers when adding a resolv.conf that matches 170what it already has for that interface. |
| 175.It Fl x 176Mark the interface 177.Pa resolv.conf 178as exclusive when adding, otherwise only use the latest exclusive interface. | |
| 179.El 180.Pp 181.Nm | 171.El 172.Pp 173.Nm |
| 182also has some options designed to be used by its subscribers:- | 174also has some commands designed to be used by it's subscribers and 175system startup:- |
| 183.Bl -tag -width indent | 176.Bl -tag -width indent |
| 177.It Fl I 178Initialise the state directory 179.Pa @VARDIR@ . 180This only needs to be called if the initial system boot sequence does not 181automatically clean it out; for example the state directory is moved 182somewhere other than 183.Pa /var/run . 184If used, it should only be called once as early in the system boot sequence 185as possible and before 186.Nm 187is used to add interfaces. 188.It Fl R 189Echo the command used to restart a service. 190.It Fl r Ar service 191If the 192.Ar service 193is running then restart it. 194If the service does not exist or is not running then zero is returned, 195otherwise the result of restarting the service. |
|
| 184.It Fl v 185Echo variables DOMAINS, SEARCH and NAMESERVERS so that the subscriber can 186configure the resolver easily. 187.It Fl V 188Same as 189.Fl v 190except that only the information configured in 191.Xr resolvconf.conf 5 --- 81 unchanged lines hidden (view full) --- 273.Nm 274adds, deletes or updates. 275.It Pa @LIBEXECDIR@/libc.d 276Directory of subscribers which are run after the libc subscriber is run. 277.It Pa @VARDIR@ 278State directory for 279.Nm . 280.El | 196.It Fl v 197Echo variables DOMAINS, SEARCH and NAMESERVERS so that the subscriber can 198configure the resolver easily. 199.It Fl V 200Same as 201.Fl v 202except that only the information configured in 203.Xr resolvconf.conf 5 --- 81 unchanged lines hidden (view full) --- 285.Nm 286adds, deletes or updates. 287.It Pa @LIBEXECDIR@/libc.d 288Directory of subscribers which are run after the libc subscriber is run. 289.It Pa @VARDIR@ 290State directory for 291.Nm . 292.El |
| 293.Sh SEE ALSO 294.Xr resolver 3 , 295.Xr stdin 4 , 296.Xr resolv.conf 5 , 297.Xr resolvconf.conf 5 |
|
| 281.Sh HISTORY 282This implementation of 283.Nm 284is called openresolv and is fully command line compatible with Debian's 285resolvconf, as written by Thomas Hood. | 298.Sh HISTORY 299This implementation of 300.Nm 301is called openresolv and is fully command line compatible with Debian's 302resolvconf, as written by Thomas Hood. |
| 286.Sh SEE ALSO 287.Xr resolv.conf 5 , 288.Xr resolvconf.conf 5 , 289.Xr resolver 3 , 290.Xr stdin 3 | |
| 291.Sh AUTHORS 292.An Roy Marples Aq Mt roy@marples.name 293.Sh BUGS 294Please report them to 295.Lk http://roy.marples.name/projects/openresolv 296.Pp 297.Nm 298does not validate any of the files given to it. 299.Pp 300When running a local resolver other than libc, you will need to configure it 301to include files that 302.Nm 303will generate. 304You should consult 305.Xr resolvconf.conf 5 306for instructions on how to configure your resolver. | 303.Sh AUTHORS 304.An Roy Marples Aq Mt roy@marples.name 305.Sh BUGS 306Please report them to 307.Lk http://roy.marples.name/projects/openresolv 308.Pp 309.Nm 310does not validate any of the files given to it. 311.Pp 312When running a local resolver other than libc, you will need to configure it 313to include files that 314.Nm 315will generate. 316You should consult 317.Xr resolvconf.conf 5 318for instructions on how to configure your resolver. |