On Tue, Jan 13, 2015 at 11:23:08AM +0000, Stuart Henderson wrote: > 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? >
ok by me. your fix has the benefit of removing another issue, which was the section header is EXAMPLE, not EXAMPLES, and the section is in a crazy place. jmc > 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. >
