README: added documentations for the newly added resolver.conf parsing feature.

Signed-off-by: Yichun Zhang (agentzh) <agentzh@gmail.com>
This commit is contained in:
Datong Sun 2018-03-23 12:36:08 -07:00 committed by Yichun Zhang (agentzh)
parent 4a85469797
commit 8d3ce00348
1 changed files with 29 additions and 0 deletions

View File

@ -10,6 +10,8 @@ Table of Contents
* [Description](#description)
* [For Users](#for-users)
* [For Bundle Maintainers](#for-bundle-maintainers)
* [Additional Features](#additional-features)
* [resolve.conf parsing](#resolveconf-parsing)
* [Mailing List](#mailing-list)
* [Report Bugs](#report-bugs)
* [Copyright & License](#copyright--license)
@ -61,6 +63,33 @@ sudo dnf install perl dos2unix mercurial
[Back to TOC](#table-of-contents)
Additional Features
===================
In additional to the standard nginx core features, this bundle also supports the following:
[Back to TOC](#table-of-contents)
resolve.conf parsing
--------------------
**syntax:** *resolver address ... [valid=time] [ipv6=on|off] [local=on|off|path]*
**default:** *-*
**context:** *http, stream, server, location*
Similar to the [`resolver` directive](https://nginx.org/en/docs/http/ngx_http_core_module.html#resolver)
in standard nginx core with additional support for parsing additional resolvers from the `resolve.conf` file
format.
When `local=on`, the standard path of `/etc/resolver.conf` will be used. You may also specify arbitrary
path to be used for parsing, for example: `local=/tmp/test.conf`.
When `local=off`, parsing will be disabled (this is the default).
[Back to TOC](#table-of-contents)
Mailing List
============