Difference between revisions of "2.0/Modules/m dns"

From AnopeWiki
Jump to: navigation, search
(Created page with "{{Language|2.0/Modules/m_dns}} {{Header|m_dns|Extras|Anope}} == <div class="moduleheader">Description</div> == Adds support for the DNS protocol. By itself this module does ...")
 
m (Azander moved page 2.0/Moduules/m dns to 2.0/Modules/m dns without leaving a redirect: typo in url)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{Language|2.0/Modules/m_dns}}
 
{{Language|2.0/Modules/m_dns}}
{{Header|m_dns|Extras|Anope}}
+
{{Header|m_dns|Extra_Modules|Anope}}
  
  
Line 6: Line 6:
 
Adds support for the DNS protocol. By itself this module does nothing useful, but other modules such as m_dnsbl and os_dns require this.
 
Adds support for the DNS protocol. By itself this module does nothing useful, but other modules such as m_dnsbl and os_dns require this.
  
;'''name=''' :The name of this module, referenced by other modules.  Do not change.
+
;'''name=''' :The name of this module, referenced by other modules.  ''Do not change''.
 
;'''nameserver=''' :The nameserver to query.  Use either the IP address of the name server or use the local machine's /etc/resolv.conf configuration file (on linux/unix) to use the system's default name server(s).
 
;'''nameserver=''' :The nameserver to query.  Use either the IP address of the name server or use the local machine's /etc/resolv.conf configuration file (on linux/unix) to use the system's default name server(s).
 
;'''timeout=''' :Timeout before the name server request fails.  Do not set this too high or you will lag out services if you get a lot of DNS lookup queries.
 
;'''timeout=''' :Timeout before the name server request fails.  Do not set this too high or you will lag out services if you get a lot of DNS lookup queries.

Latest revision as of 21:58, 12 May 2014

Language

English

Section Extra_Modules
Module m_dns
Author Anope


Description

Adds support for the DNS protocol. By itself this module does nothing useful, but other modules such as m_dnsbl and os_dns require this.

name= 
The name of this module, referenced by other modules. Do not change.
nameserver= 
The nameserver to query. Use either the IP address of the name server or use the local machine's /etc/resolv.conf configuration file (on linux/unix) to use the system's default name server(s).
timeout= 
Timeout before the name server request fails. Do not set this too high or you will lag out services if you get a lot of DNS lookup queries.
ip= 
The IP address to listen on for queries. Leave it 0.0.0.0 unless you know what you are doing, or are using the os_DNS module.
port= 
The port to listen on. The default (aka standard) DNS port is 53. Do not change this unless you really know what you are doing.
'admin= 
This should be your DNS contact person.
nameservers= 
This is where your zone files reside and are served out to others.
refresh= 
Time, in seconds, that a server beyond your direct control can keep a local copy of your DNS looked up reconrd before having to re-request them from your name servers. Set this too low, your name servers will see a large increase in traffic, set it too high and changes can take a long time to be seen.
notify {...} 
What other name servers should be told, directly, or changes you have made.
ip= 
What IP address of the name server to notify.
port= 
What port should you do this notification on.


Default Configuration

/*
 * m_dns
 *
 * Adds support for the DNS protocol. By itself this module does nothing useful,
 * but other modules such as m_dnsbl and os_dns require this.
 */
#module
{
        name = "m_dns"
 
        /*
         * The nameserver to use for resolving hostnames, must be an IP or a resolver configuration file.
         * The below should work fine on all unix like systems. Windows users will have to find their nameservers
         * from ipconfig /all and put the IP here.
         */
        nameserver = "/etc/resolv.conf"
        #nameserver = "127.0.0.1"
 
        /*
         * How long to wait in seconds before a DNS query has timed out.
         */
        timeout = 5
 
 
        /* Only edit below if you are expecting to use os_dns or otherwise answer DNS queries. */
 
        /*
         * The IP and port services use to listen for DNS queries.
         * Note that ports less than 1024 are privileged on UNIX/Linux systems, and
         * require Anope to be started as root. If you do this, it is recommended you
         * set options:user and options:group so Anope can change users after binding
         * to this port.
         */
        ip = "0.0.0.0"
        port = 53
 
        /*
         * SOA record information.
         */
 
        /* E-mail address of the DNS administrator. */
        admin = "admin@example.com"
 
        /* This should be the names of the public facing nameservers serving the records. */
        nameservers = "ns1.example.com ns2.example.com"
 
        /* The time slave servers are allowed to cache. This should be reasonably low
         * if you want your records to be updated without much delay.
         */
        refresh = 3600
 
        /* A notify block. There should probably be one per nameserver listed in 'nameservers'.
         */
        notify
        {
                ip = "192.0.2.0"
                port = 53
        }
}