Blame


1 d1b726c9 2011-02-13 pbug .\" Copyright (c) 2005-2011 Peter J. Philipp
2 c45084ea 2005-11-29 pbug .\" All rights reserved.
3 c45084ea 2005-11-29 pbug .\"
4 c45084ea 2005-11-29 pbug .\" Redistribution and use in source and binary forms, with or without
5 c45084ea 2005-11-29 pbug .\" modification, are permitted provided that the following conditions
6 c45084ea 2005-11-29 pbug .\" are met:
7 c45084ea 2005-11-29 pbug .\" 1. Redistributions of source code must retain the above copyright
8 c45084ea 2005-11-29 pbug .\" notice, this list of conditions and the following disclaimer.
9 c45084ea 2005-11-29 pbug .\" 2. Redistributions in binary form must reproduce the above copyright
10 c45084ea 2005-11-29 pbug .\" notice, this list of conditions and the following disclaimer in the
11 c45084ea 2005-11-29 pbug .\" documentation and/or other materials provided with the distribution.
12 c45084ea 2005-11-29 pbug .\" 3. The name of the author may not be used to endorse or promote products
13 c45084ea 2005-11-29 pbug .\" derived from this software without specific prior written permission
14 c45084ea 2005-11-29 pbug .\"
15 c45084ea 2005-11-29 pbug .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16 c45084ea 2005-11-29 pbug .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 c45084ea 2005-11-29 pbug .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 c45084ea 2005-11-29 pbug .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19 c45084ea 2005-11-29 pbug .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 c45084ea 2005-11-29 pbug .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 c45084ea 2005-11-29 pbug .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 c45084ea 2005-11-29 pbug .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 c45084ea 2005-11-29 pbug .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 c45084ea 2005-11-29 pbug .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25 c45084ea 2005-11-29 pbug .\"
26 dd869383 2013-02-16 pjp .Dd February 16, 2013
27 c45084ea 2005-11-29 pbug .Dt WILDCARDDNSD 8
28 c45084ea 2005-11-29 pbug .Os
29 c45084ea 2005-11-29 pbug .Sh NAME
30 c45084ea 2005-11-29 pbug .Nm wildcarddnsd
31 c45084ea 2005-11-29 pbug .Nd the Wildcard DNS daemon
32 c45084ea 2005-11-29 pbug .Sh SYNOPSIS
33 c45084ea 2005-11-29 pbug .Nm wildcarddnsd
34 c45084ea 2005-11-29 pbug .Op Fl b Ar address
35 f98bb34d 2011-09-19 pbug .Op Fl c Ar size
36 dd869383 2013-02-16 pjp .Op Fl d
37 c45084ea 2005-11-29 pbug .Op Fl f Ar file
38 c45084ea 2005-11-29 pbug .Op Fl i Ar interface
39 87f793be 2009-02-16 pbug .Op Fl l
40 f98bb34d 2011-09-19 pbug .Op Fl n Ar instances
41 c45084ea 2005-11-29 pbug .Op Fl p Ar port
42 dd869383 2013-02-16 pjp .Op Fl r
43 dd869383 2013-02-16 pjp .Op Fl v
44 c45084ea 2005-11-29 pbug .Sh DESCRIPTION
45 c45084ea 2005-11-29 pbug .Nm
46 c45084ea 2005-11-29 pbug is the daemon that runs Wildcard DNS.
47 c45084ea 2005-11-29 pbug .Pp
48 c45084ea 2005-11-29 pbug The options are as follows:
49 c45084ea 2005-11-29 pbug .Pp
50 c45084ea 2005-11-29 pbug .Bl -tag -width Ds
51 c45084ea 2005-11-29 pbug .It Xo
52 c45084ea 2005-11-29 pbug .Fl b
53 c45084ea 2005-11-29 pbug .Ar address
54 c45084ea 2005-11-29 pbug .Xc
55 c45084ea 2005-11-29 pbug Adds an
56 c45084ea 2005-11-29 pbug .Ar address
57 c45084ea 2005-11-29 pbug that
58 c45084ea 2005-11-29 pbug .Nm
59 c45084ea 2005-11-29 pbug should
60 c45084ea 2005-11-29 pbug .Xr bind 2
61 c45084ea 2005-11-29 pbug to. This option can be repeated multiple times to add more. May
62 c45084ea 2005-11-29 pbug not be used in conjunction with
63 c45084ea 2005-11-29 pbug .Fl i .
64 c45084ea 2005-11-29 pbug .It Xo
65 f98bb34d 2011-09-19 pbug .Fl c
66 f98bb34d 2011-09-19 pbug .Ar size
67 f98bb34d 2011-09-19 pbug Specifies a size in bytes for the SYSV shared memory cache that DB4 is
68 f98bb34d 2011-09-19 pbug using.
69 f98bb34d 2011-09-19 pbug .It Xo
70 dd869383 2013-02-16 pjp .Fl d
71 dd869383 2013-02-16 pjp Turn on debug mode.
72 dd869383 2013-02-16 pjp .Nm
73 dd869383 2013-02-16 pjp does not fork into the background with this. Messages are printed in the
74 dd869383 2013-02-16 pjp foreground.
75 dd869383 2013-02-16 pjp .It Xo
76 c45084ea 2005-11-29 pbug .Fl f
77 c45084ea 2005-11-29 pbug .Ar file
78 c45084ea 2005-11-29 pbug .Xc
79 c45084ea 2005-11-29 pbug The configuration file to be used is found at
80 c45084ea 2005-11-29 pbug .Ar file .
81 c45084ea 2005-11-29 pbug .It Xo
82 c45084ea 2005-11-29 pbug .Fl i
83 c45084ea 2005-11-29 pbug .Ar interface
84 c45084ea 2005-11-29 pbug .Xc
85 c45084ea 2005-11-29 pbug The particular
86 c45084ea 2005-11-29 pbug .Ar interface
87 c45084ea 2005-11-29 pbug that
88 c45084ea 2005-11-29 pbug .Nm
89 c45084ea 2005-11-29 pbug should listen on. This option can be specified multiple times. May not be
90 c45084ea 2005-11-29 pbug used in conjunction with
91 c45084ea 2005-11-29 pbug .Fl b .
92 87f793be 2009-02-16 pbug .It Fl l
93 dd869383 2013-02-16 pjp Turn logging of queries on.
94 c45084ea 2005-11-29 pbug .It Xo
95 f98bb34d 2011-09-19 pbug .Fl n
96 f98bb34d 2011-09-19 pbug .Ar instances
97 f98bb34d 2011-09-19 pbug is the number of instances plus one that should be forked for
98 f98bb34d 2011-09-19 pbug .Nm .
99 f98bb34d 2011-09-19 pbug This may be good for multi-cpu/core boxes.
100 f98bb34d 2011-09-19 pbug .It Xo
101 c45084ea 2005-11-29 pbug .Fl p
102 c45084ea 2005-11-29 pbug .Ar port
103 c45084ea 2005-11-29 pbug .Xc
104 c45084ea 2005-11-29 pbug Specifies the
105 c45084ea 2005-11-29 pbug .Ar port
106 c45084ea 2005-11-29 pbug that
107 c45084ea 2005-11-29 pbug .Nm
108 c45084ea 2005-11-29 pbug should listen on. This can be useful when using
109 c45084ea 2005-11-29 pbug .Nm
110 c45084ea 2005-11-29 pbug with
111 dd869383 2013-02-16 pjp .Xr pf 4
112 dd869383 2013-02-16 pjp .It Xo
113 dd869383 2013-02-16 pjp .Fl r
114 dd869383 2013-02-16 pjp .Xc
115 dd869383 2013-02-16 pjp Go into recursive mode. This is broken, please don't use.
116 dd869383 2013-02-16 pjp .It Xo
117 dd869383 2013-02-16 pjp .Fl v
118 dd869383 2013-02-16 pjp .Xc
119 dd869383 2013-02-16 pjp Be more verbose in debug mode. This shows configfile parsing logic.
120 c45084ea 2005-11-29 pbug .El
121 c45084ea 2005-11-29 pbug .Sh FILES
122 c45084ea 2005-11-29 pbug .Pa /etc/wildcarddns.conf
123 c45084ea 2005-11-29 pbug .Sh SEE ALSO
124 caf3e650 2014-09-27 pjp .Xr wildcarddns.conf 5 ,
125 c45084ea 2005-11-29 pbug .Xr bind 2 ,
126 caf3e650 2014-09-27 pjp .Xr fork 2 ,
127 c45084ea 2005-11-29 pbug .Xr daemon 3 ,
128 caf3e650 2014-09-27 pjp .Xr pf 4
129 c45084ea 2005-11-29 pbug .Sh AUTHORS
130 c45084ea 2005-11-29 pbug This software was written by
131 d1b726c9 2011-02-13 pbug .An Peter J. Philipp Aq pjp@centroid.eu
132 c45084ea 2005-11-29 pbug