Pull request 175: imp-conf

Squashed commit of the following:

commit 861bf10a0b1ed49fc96ef9e3fdfe5f348a739b66
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Fri Jul 14 22:06:23 2023 +0300

    Configuration: imp docs
Ainar Garipov 2023-07-17 14:38:31 +03:00
parent 6414132741
commit 8a03388ec8

@ -151,9 +151,10 @@ a configuration like this:
sends queries for `*.host.com` to `1.2.3.4` except for queries for sends queries for `*.host.com` to `1.2.3.4` except for queries for
`*.www.host.com`, which are sent to `6.7.8.9`, which is the default upstream. `*.www.host.com`, which are sent to `6.7.8.9`, which is the default upstream.
Since **v0.108.0-b.8** the wildcard `*` has a special meaning of "any subdomain", Since **v0.108.0-b.8** the wildcard `*` has a special meaning of "any
so `--upstream=[/*.host.com/]1.2.3.4` will send queries for `*.host.com` to `1.2.3.4`, subdomain", so `--upstream=[/*.host.com/]1.2.3.4` will send queries for
but `host.com` will be forwarded to default upstreams. `*.host.com` to `1.2.3.4`, but `host.com` will be forwarded to default
upstreams.
#### Examples #### Examples
@ -514,8 +515,8 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
property within a container. property within a container.
- `blocked_hosts`: The list of domain names, wildcards or filtering rules to - `blocked_hosts`: The list of domain names, wildcards or filtering rules to
match requests that shouldn't be processed at all. These wiil be ignored match requests that shouldn't be processed at all. These are ignored by
by statistics and query log as well. statistics and query log as well.
See also the note in the [Docker wiki page][docker-conf] about using this See also the note in the [Docker wiki page][docker-conf] about using this
property within a container. property within a container.
@ -686,19 +687,18 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
- `log` (**since v0.107.34**): Log settings. - `log` (**since v0.107.34**): Log settings.
- `file` (**since v0.107.34**): Path to the log file. If empty, writes to - `file` (**since v0.107.34**): Path to the log file. If empty, writes to
stdout, if `syslog` writes system log (or eventlog on Windows). stdout, if `syslog` writes system log (or eventlog on Windows).
- `compress` (**since v0.107.34**): Compress determines if the rotated log - `compress` (**since v0.107.34**): If `true`, enabled GZIP compression of
files should be compressed using gzip (default: false). the log files.
- `local_time` (**since v0.107.34**): If the time used for formatting the - `local_time` (**since v0.107.34**): If `true`, the time used for
timestamps in is the computer's local time (default: false [UTC]). formatting the timestamps in is the computer's local time.
- `max_backups` (**since v0.107.34**): Maximum number of old log files to - `max_backups` (**since v0.107.34**): Maximum number of old log files to
retain (MaxAge may still cause them to get deleted) (default: 0, which retain. `0` means retain all old log files. Note that `max_age` may
retains all old log files). still cause them to be deleted.
- `max_size` (**since v0.107.34**): Maximum size in megabytes of the log - `max_size` (**since v0.107.34**): Maximum size of the log file before it
file before it gets rotated (default: 100 MB). gets rotated, in megabytes.
- `max_age` (**since v0.107.34**): MaxAge is the maximum number of days to - `max_age` (**since v0.107.34**): MaxAge is the maximum number of days to
retain old log files (default: 3). retain old log files.
- `verbose` (**since v0.107.34**): Enable our disables debug verbose output - `verbose` (**since v0.107.34**): If `true`, enables verbose debug output.
(default: false).
- `log_file` (**before v0.107.34**): See `log.file` above. - `log_file` (**before v0.107.34**): See `log.file` above.
- `log_compress` (**before v0.107.34**): See `log.compress` above. - `log_compress` (**before v0.107.34**): See `log.compress` above.
- `log_localtime` (**before v0.107.34**): See `log.local_time` above. - `log_localtime` (**before v0.107.34**): See `log.local_time` above.