Mirrors/coredns
1
0
Fork 0
mirror of https://github.com/coredns/coredns.git synced 2025-10-28 08:44:17 -04:00
Code Issues Packages Projects Releases Wiki Activity

Small doc style updates in the host middleware

Browse Source
This commit is contained in:
Miek Gieben
2017-07-23 21:15:16 +01:00
parent df137d971c
commit 1e6f134783
1 changed files with 6 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
middleware/hosts/README.md
View File

@@ -2,7 +2,7 @@
*hosts* enables serving zone data from a /etc/hosts style file. *hosts* enables serving zone data from a /etc/hosts style file.
The hosts middleware is useful for serving zones from a /etc/hosts file. It serves from a preloaded The hosts middleware is useful for serving zones from a /etc/hosts file. It serves from a preloaded
file that exists on disk. It checks the file for changes and updates the zones accordingly. This file that exists on disk. It checks the file for changes and updates the zones accordingly. This
middleware only supports A, AAAA, and PTR records. The hosts middleware can be used with readily middleware only supports A, AAAA, and PTR records. The hosts middleware can be used with readily
available hosts files that block access to advertising servers. available hosts files that block access to advertising servers.
@@ -10,7 +10,7 @@ available hosts files that block access to advertising servers.
## Syntax ## Syntax
~~~ ~~~
hosts FILE [ZONES...] { hosts [FILE [ZONES...]] {
fallthrough fallthrough
} }
~~~ ~~~
@@ -18,25 +18,25 @@ hosts FILE [ZONES...] {
* **FILE** the hosts file to read and parse. If the path is relative the path from the *root* * **FILE** the hosts file to read and parse. If the path is relative the path from the *root*
directive will be prepended to it. Defaults to /etc/hosts if omitted directive will be prepended to it. Defaults to /etc/hosts if omitted
* **ZONES** zones it should be authoritative for. If empty, the zones from the configuration block * **ZONES** zones it should be authoritative for. If empty, the zones from the configuration block
are used. are used.
* `fallthrough` If zone matches and no record can be generated, pass request to the next middleware. * `fallthrough` If zone matches and no record can be generated, pass request to the next middleware.
## Examples ## Examples
Load /etc/hosts file Load `/etc/hosts` file.
~~~ ~~~
hosts hosts
~~~ ~~~
Load example.hosts file Load `example.hosts` file in the current directory.
~~~ ~~~
hosts example.hosts hosts example.hosts
~~~ ~~~
Load example.hosts file and only serve example.org and example.net from it and fall through to the Load example.hosts file and only serve example.org and example.net from it and fall through to the
next middleware if query doesn't match next middleware if query doesn't match.
~~~ ~~~
hosts example.hosts example.org example.net { hosts example.hosts example.org example.net {