<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE packagegui SYSTEM "../schema/packages.dtd">
<?xml-stylesheet type="text/xsl" href="../xsl/package.xsl"?>
<packagegui>
	<copyright>
		<![CDATA[
		/*
		    unbound.xml
		    part of the Unbound package for pfSense (http://www.pfSense.com)
		    Copyright (C) 2011 Warren Baker
		    All rights reserved.
		*/
		/* ========================================================================== */
		/*
		    Redistribution and use in source and binary forms, with or without
		    modification, are permitted provided that the following conditions are met:

		     1. Redistributions of source code must retain the above copyright notice,
		        this list of conditions and the following disclaimer.

		     2. Redistributions in binary form must reproduce the above copyright
		        notice, this list of conditions and the following disclaimer in the
		        documentation and/or other materials provided with the distribution.

		    THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
		    INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
		    AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
		    AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
		    OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
		    SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
		    INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
		    CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
		    ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
		    POSSIBILITY OF SUCH DAMAGE.
		                                                                              */
		/* ========================================================================== */
		]]>
	</copyright>
	<description>Unbound is a validating, recursive, and caching DNS resolver.</description>
	<requirements/>
	<faq/>
	<name>unbound</name>
	<version>1.4.20_5</version>
	<title>Services: Unbound DNS Forwarder: Basic Settings</title>
	<include_file>/usr/local/pkg/unbound.inc</include_file>
	<menu>
		<name>Unbound DNS</name>
		<tooltiptext>Setup Unbound specific settings</tooltiptext>
		<section>Services</section>
		<url>/pkg_edit.php?xml=unbound.xml&amp;id=0</url>
	</menu>
	<service>
		<name>unbound</name>
		<rcfile>unbound.sh</rcfile>
		<executable>unbound</executable>
		<description>Unbound is a validating, recursive, and caching DNS resolver.</description>
	</service>
	<additional_files_needed>
		<prefix>/usr/local/pkg/</prefix>
		<chmod>0644</chmod>
		<item>https://packages.pfsense.org/packages/config/unbound/unbound.inc</item>
	</additional_files_needed>
	<additional_files_needed>
		<prefix>/usr/local/www/</prefix>
		<chmod>0644</chmod>
		<item>https://packages.pfsense.org/packages/config/unbound/unbound_status.php</item>
	</additional_files_needed>
	<additional_files_needed>
		<prefix>/usr/local/www/</prefix>
		<chmod>0644</chmod>
		<item>https://packages.pfsense.org/packages/config/unbound/unbound_acls.php</item>
	</additional_files_needed>
	<additional_files_needed>
		<prefix>/usr/local/pkg/</prefix>
		<chmod>0644</chmod>
		<item>https://packages.pfsense.org/packages/config/unbound/unbound_advanced.xml</item>
	</additional_files_needed>
	<additional_files_needed>
		<prefix>/usr/local/bin/</prefix>
		<chmod>0755</chmod>
		<item>https://packages.pfsense.org/packages/config/unbound/unbound_monitor.sh</item>
	</additional_files_needed>
	<system_services>
		<dns/>
	</system_services>
	<tabs>
		<tab>
			<text>Unbound DNS Settings</text>
			<url>/pkg_edit.php?xml=unbound.xml&amp;id=0</url>
			<active/>
			<no_drop_down/>
		</tab>
		<tab>
			<text>Unbound DNS Advanced Settings</text>
			<url>/pkg_edit.php?xml=unbound_advanced.xml&amp;id=0</url>
		</tab>
		<tab>
			<text>Unbound DNS ACLs</text>
			<url>/unbound_acls.php</url>
		</tab>
		<tab>
			<text>Unbound DNS Status</text>
			<url>/unbound_status.php</url>
		</tab>
	</tabs>
	<fields>
		<field>
			<name>Settings</name>
			<type>listtopic</type>
		</field>
		<field>
			<fieldname>enable</fieldname>
			<fielddescr>Enable Unbound</fielddescr>
			<description>Enable the use of Unbound as your DNS forwarder.</description>
			<type>checkbox</type>
		</field>
		<field>
			<fielddescr>Network interface</fielddescr>
			<fieldname>active_interface</fieldname>
			<description>The network interface(s) the Unbound DNS server will listen on.</description>
			<type>interfaces_selection</type>
			<required/>
			<default_value>wan</default_value>
			<multiple/>
		</field>
		<field>
			<fielddescr>Query interfaces</fielddescr>
			<fieldname>query_interface</fieldname>
			<description>Utilize different network interface(s) that Unbound DNS server will use to send queries to authoritative servers and receive their replies. &lt;br/&gt;
				&lt;b&gt;Note:&lt;/b&gt; If a query interface is not selected then the default of all interfaces will be used.
				</description>
			<type>interfaces_selection</type>
			<default_value>wan</default_value>
			<multiple/>
		</field>
		<field>
			<fieldname>dnssec_status</fieldname>
			<fielddescr>Enable DNSSEC</fielddescr>
			<description>Enable the use of DNSSEC. &lt;br/&gt;
				&lt;b&gt;Note:&lt;/b&gt; It is recommended that when enabling DNSSEC you disable the use of forwarding mode and allow Unbound to do the resolving. This is to ensure that DNS replies are valid and authentic.</description>
			<type>checkbox</type>
			<default_value>on</default_value>
		</field>
		<field>
			<fieldname>forwarding_mode</fieldname>
			<fielddescr>Enable forwarding mode</fielddescr>
			<description>Configure the server to make use of the DNS servers configured in &lt;a href="system.php"&gt;System: General setup&lt;/a&gt;. &lt;br/&gt;
						&lt;b&gt;Note:&lt;/b&gt; Disabling this will cause Unbound to perform DNS queries without
						using the upstream configured DNS servers.</description>
			<type>checkbox</type>
			<default_value>on</default_value>
		</field>
		<field>
			<fieldname>private_address</fieldname>
			<fielddescr>Private Address support</fielddescr>
			<description>With this option enabled &lt;a href="http://tools.ietf.org/html/rfc1918"&gt;RFC1918&lt;/a&gt; addresses are stripped away from DNS answers. Additionally, the DNSSEC validator may mark the answers bogus. This protects against &lt;a href="http://en.wikipedia.org/wiki/DNS_rebinding"&gt;DNS Rebinding&lt;/a&gt;. &lt;br/&gt; &lt;b&gt;Note:&lt;/b&gt; Domain Overrides and Host entries will be allowed to return answers if this option is enabled.</description>
			<type>checkbox</type>
			<default_value>on</default_value>
		</field>
		<!--<field>
			<fieldname>regdhcp</fieldname>
			<fielddescr>Register DHCP leases</fielddescr>
			<description>If this option is set, then machines that specify their hostname when requesting a DHCP lease will be registered in the DNS forwarder, so that their name can be resolved. You should also set the domain in &lt;a href="system.php"&gt;System: General setup&lt;/a&gt; to the proper value.</description>
			<type>checkbox</type>
		</field>-->
		<field>
			<fieldname>regdhcpstatic</fieldname>
			<fielddescr>Register DHCP static mappings</fielddescr>
			<description>If this option is set, then DHCP static mappings will be registered in the DNS forwarder, so that their name can be resolved. You should also set the domain in &lt;a href="system.php"&gt;System: General setup&lt;/a&gt; to the proper value.</description>
			<type>checkbox</type>
		</field>
		<field>
			<fieldname>txtsupport</fieldname>
			<fielddescr>TXT Comment Support</fielddescr>
			<description>If this option is set, then any descriptions associated with Host entries and DHCP Static mappings will create a corresponding &lt;a href="http://en.wikipedia.org/wiki/List_of_DNS_record_types"&gt;TXT record&lt;/a&gt;.</description>
			<type>checkbox</type>
			<default_value>on</default_value>
		</field>
		<field>
			<fieldname>dumpcache</fieldname>
			<fielddescr>Cache Restoration Support</fielddescr>
			<description>This option allows the restoration of the current Unbound cache, so that in the event of a reboot or shutdown the cache is restored instantly. This helps speed up DNS resolving.</description>
			<type>checkbox</type>
		</field>
		<field>
			<name>Statistics</name>
			<type>listtopic</type>
		</field>
		<field>
			<fieldname>stats</fieldname>
			<fielddescr>Enable Statistics</fielddescr>
			<description>Unbound will log the number of queries that the resolver handles.</description>
			<type>checkbox</type>
			<enablefields>stats_interval,cumulative_stats,extended_stats</enablefields>
		</field>
		<field>
			<fieldname>stats_interval</fieldname>
			<fielddescr>Statistics Interval</fielddescr>
			<description>Select the time as to when statistics will be written to the Unbound log file.</description>
			<type>select</type>
			<default_value>3600</default_value>
			<options>
				<option><name>5 minutes</name><value>300</value></option>
				<option><name>10 minutes</name><value>600</value></option>
				<option><name>20 minutes</name><value>1200</value></option>
				<option><name>30 minutes</name><value>2400</value></option>
				<option><name>1 hour</name><value>3600</value></option>
				<option><name>2 hours</name><value>7200</value></option>
			</options>
		</field>
		<field>
			<fieldname>cumulative_stats</fieldname>
			<fielddescr>Enable Cumulative Statistics</fielddescr>
			<description>Once unbound is started, the statistics collected are cumulative and are not cleared after each report has been logged.</description>
			<type>select</type>
			<default_value>no</default_value>
			<options>
				<option><name>No</name><value>no</value></option>
				<option><name>Yes</name><value>yes</value></option>
			</options>
		</field>
		<field>
			<fieldname>extended_stats</fieldname>
			<fielddescr>Enable Extended Statistics</fielddescr>
			<description>In addition to collecting the total number of queries also collect what type of queries are handled by the resolver.</description>
			<type>checkbox</type>
		</field>
	</fields>
	<custom_add_php_command>
	</custom_add_php_command>
	<custom_php_command_before_form/>
	<custom_php_validation_command>
		unbound_validate($_POST, "basic");
	</custom_php_validation_command>
	<custom_php_resync_config_command>
		unbound_reconfigure();
	</custom_php_resync_config_command>
	<custom_php_install_command>
		unbound_install();
	</custom_php_install_command>
	<custom_php_deinstall_command>
		unbound_uninstall();
	</custom_php_deinstall_command>
</packagegui>