On 2015/01/13 07:08, Jason McIntyre wrote: > On Sun, Jan 11, 2015 at 12:13:09AM -0700, Shane Manjarres wrote: > > http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man5/unbound.conf.5?query=unbound%2econf&sec=5 > > > > uncounf.conf(5) > > > > > > In Openbsd the default directory for unbound.conf file is /var/unbound/etc/ > > > > but in the man page in the example it shows the directory as /etc/unbound/ > > > > I believe this to be an error in the documentation. > > > > > > > > it does look like the example is geared towards an /etc-based > configuration. but since unbound is 3rd party, i'm not sure if it's this > way by accident or that it's troublesome to change. > > since it's an example, it may just be that there's no need to change it > - an example is an example, right? > > anyone want to comment?
I think that for OpenBSD manuals, we could probably just get rid of that EXAMPLE section, we already provide a default configuration file which is directly usable for a local resolver and isn't too complex, and the filenames and instructions aren't useful for the way we've set it up. OK? Index: doc/unbound.conf.5.in =================================================================== RCS file: /cvs/src/usr.sbin/unbound/doc/unbound.conf.5.in,v retrieving revision 1.1.1.7 diff -u -p -r1.1.1.7 unbound.conf.5.in --- doc/unbound.conf.5.in 11 Dec 2014 16:18:03 -0000 1.1.1.7 +++ doc/unbound.conf.5.in 13 Jan 2015 11:22:04 -0000 @@ -25,42 +25,6 @@ ignored as is whitespace at the beginnin The utility \fIunbound\-checkconf\fR(8) can be used to check unbound.conf prior to usage. -.SH "EXAMPLE" -An example config file is shown below. Copy this to /etc/unbound/unbound.conf -and start the server with: -.P -.nf - $ unbound \-c /etc/unbound/unbound.conf -.fi -.P -Most settings are the defaults. Stop the server with: -.P -.nf - $ kill `cat /etc/unbound/unbound.pid` -.fi -.P -Below is a minimal config file. The source distribution contains an extensive -example.conf file with all the options. -.P -.nf -# unbound.conf(5) config file for unbound(8). -server: - directory: "/etc/unbound" - username: unbound - # make sure unbound can access entropy from inside the chroot. - # e.g. on linux the use these commands (on BSD, devfs(8) is used): - # mount \-\-bind \-n /dev/random /etc/unbound/dev/random - # and mount \-\-bind \-n /dev/log /etc/unbound/dev/log - chroot: "/etc/unbound" - # logfile: "/etc/unbound/unbound.log" #uncomment to use logfile. - pidfile: "/etc/unbound/unbound.pid" - # verbosity: 1 # uncomment and increase to get more logging. - # listen on all interfaces, answer queries from the local subnet. - interface: 0.0.0.0 - interface: ::0 - access\-control: 10.0.0.0/8 allow - access\-control: 2001:DB8::/64 allow -.fi .SH "FILE FORMAT" There must be whitespace between keywords. Attribute keywords end with a colon ':'. An attribute is followed by its containing attributes, or a value.
