Blob


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