1
2
3
4
5
6
7
8dnscache(8)                 System Manager's Manual                dnscache(8)
9
10
11

NAME

13       dnscache - djbdns DNS cache daemon.
14
15

SYNOPSIS

17       dnscache [OPTIONS]
18
19

DESCRIPTION

21       dnscache is used to map a domain name to its IP address and vice versa.
22       Upon invocation, dnscache reads from its configuration file and listens
23       on  TCP/UDP  port  53 for incoming requests. Typically dnscache accepts
24       incoming requests only from localhost(127.0.0.1).  To  accept  requests
25       from  external  machine  or  subnet,  create a file, named after the IP
26       address of a machine or subnet from which to accept requests, under the
27       `ip/'  directory.   Ie.  dnscache would accept requests from IP address
28       1.2.3.4, if there is a file named 1.2.3.4 OR 1.2.3 OR 1.2 OR  1.  under
29       the `ip/' directory.
30
31       To  resolve a domain name, dnscache contacts the name servers listed in
32       files under the `servers/' directory. File `roots' lists the root  name
33       servers.     dnscache    would    contact   servers   listed   in   the
34       `servers/mydomain.com' file, to resolve  domain  names  that  end  with
35       mydomain.com,  like  say:  mail.mydomain.com  or  irc.mydomain.com etc.
36       Note: these files list IP addresses of name servers one on each line.
37
38       From version 1.05.9, dnscache introduced support for the DNS(or Domain)
39       Block  List.  DNS  Block List is a list of domain names which are to be
40       blocked by the resolver. Client requests querying for such domain names
41       are  dropped  by  the  resolver.  This would add an additional layer of
42       security for DNS clients and also help to reduce malicious traffic.
43
44       DNS block list is a 'cdb' database created using tinydns-data(1)  tool.
45       List  the  malicious  domain names into a 'data' file as generic domain
46       records, one on each line, as:
47
48           :bad.domain.com:284::::
49
50       Number '284' is not used, it can be  any  number  between  256...65535.
51       tinydns-data(1)  would  create  a  'data.cdb' database from this 'data'
52       file.  Rename data.cdb to dnsbl.cdb, because that is the file  read  by
53       dnscache server.
54
55           $ mv data.cdb dnsbl.cdb
56
57       dnscache  would  read  'dnsbl.cdb'  from  its  working($ROOT) directory
58       defined in the 'dnscache.conf' file.
59
60

OPTIONS

62       -d <value>
63               print debug messages as per the debug level 1, 2 or 3.
64
65       -D
66               run as a daemon.
67
68       -h --help
69               print this help.
70
71       -v --version
72               print version information.
73
74

FILES

76        /etc/ndjbdns/ip/
77        /etc/ndjbdns/servers/
78        /etc/ndjbdns/dnscache.conf
79
80        /var/log/dnscached.log
81
82

BUGS

84       Report bugs to <pj.pandit@yahoo.co.in>
85
86

AUTHOR

88       Prasad J Pandit
89
90
91
92                                                                   dnscache(8)
Impressum