Azander at 20:07, 8 May 2014

2014-05-08T20:07:03Z

Azander: Created page with "{{Language|2.0/Modules/os_dns}} {{Syntax|os_dns|OperServ|Anope}} ==
Description
== This command allows managing DNS zones used for controlling..."

2014-05-08T20:06:40Z

Created page with "{{Language|2.0/Modules/os_dns}} {{Syntax|os_dns|OperServ|Anope}} == <div class="moduleheader">Description</div> == This command allows managing DNS zones used for controlling..."

New page

{{Language|2.0/Modules/os_dns}}
{{Syntax|os_dns|OperServ|Anope}}

== <div class="moduleheader">Description</div> ==
This command allows managing DNS zones used for controlling what servers users are directed to when connecting. Omitting all parameters prints out the status of the DNS zone.

;ADDZONE, DELZONE :adds/removes a zone, eg us.yournetwork.tld. Servers can then be added to this zone with the '''ADDSERVER''' command.

;ADDSERVER, DELSERVER :adds/removes a server to the given zone. When a query is done, the zone in question is served if it exists, else all servers in all zones are served. A server may be in more than one zone.

;ADDIP,DELIP :associates/disassociates an IP with a server.

;POOL, DEPOOL :adds or remove servers to their given zones.

'''NOTE''': This module is disabled by default.

== <div class="moduleheader">Commands</div> ==
;ADDZONE zone.name
;DELZONE zone.name
;ADDSERVER server.name [zone.name]
;DELSERVER server.name [zone.name]
;ADDIP server.name ip.address
;DELIP server.name ip.address
;SET server.name option value
;POOL server.name
;DEPOOL server.name

== <div class="moduleheader">Examples</div> ==
/msg OperServ DNS ADDZONE fred.com

/msg OperServ DNS ADDSERVER server1.fred.com fred.com

/msg OperServ DNS ADDIP server1.fred.com 192.168.1.2

/msg OperServ DNS POOL server1.fred.com

/msg OperServ DNS SET LIMIT server1.fred.com 200

/msg OperServ DNS

== <div class="moduleheader">Default Configuration</div> ==

<div class="code">
<syntaxhighlight lang="cpp">
/*
* os_dns
*
* Provides the command operserv/dns.
*
* This module requires that m_dns is loaded.
*
* This module allows controlling a DNS zone. This is useful for
* controlling what servers users are placed on for load balancing,
* and to automatically remove split servers.
*
* To use this module you must set a nameserver record for services
* so that DNS queries go to services.
*
* Alternatively, you may use a slave DNS server to hide service's IP,
* provide query caching, and provide better fault tolerance.
*
* To do this using BIND, configure similar to:
*
* options { max-refresh-time 60; };
* zone "irc.example.com" IN {
* type slave;
* masters { 127.0.0.1 port 5353; };
* };
*
* Where 127.0.0.1:5353 is the IP and port services are listening on.
* We recommend you externally firewall both UDP and TCP to the port
* Anope is listening on.
*
* Finally set a NS record for irc.example.com. to BIND or services.
*/
#module
{
name = "os_dns"

/* TTL for records. This should be very low if your records change often. */
ttl = 1m

/* If a server drops this many users the server is automatically removed from the DNS zone.
* This directive is optional.
*/
user_drop_mark = 50

/* The time used for user_drop_mark. */
user_drop_time = 1m

/* When a server is removed from the zone for dropping users, it is readded after this time.
* This directive is optional.
*/
user_drop_readd_time = 5m

/* If set, when a server splits, it is automatically removed from the zone. */
remove_split_servers = yes

/* If set, when a server connects to the network, it will be automatically added to
* the zone if it is a known server.
*/
readd_connected_servers = no
}
#command { service = "OperServ"; name = "DNS"; command = "operserv/dns"; permission = "operserv/dns"; }
</syntaxhighlight></div>

@@ Line 13: / Line 13: @@
 ;POOL, DEPOOL :adds or remove servers to their given zones.
-'''NOTE''': This module is disabled by default.
+*'''NOTE''': This module is disabled by default.
 == <div class="moduleheader">Commands</div> ==

2.0/Modules/os dns - Revision history

Azander at 20:07, 8 May 2014

Azander: Created page with "{{Language|2.0/Modules/os_dns}} {{Syntax|os_dns|OperServ|Anope}} == Description == This command allows managing DNS zones used for controlling..."

Azander: Created page with "{{Language|2.0/Modules/os_dns}} {{Syntax|os_dns|OperServ|Anope}} ==
Description
== This command allows managing DNS zones used for controlling..."