Release 2.3.0

Signed-off-by: Thomas Hochstein <thh@inter.net>

.gitignore

@@ -1,6 +1,13 @@
+# application stuff
 uploads/*
 templates_c/*
 serendipity_config_local.inc.php
+plugins/additional_plugins*
+
+# php stuff
+composer.lock
+
+# ide / dev stuff
 .cvsignore
 .htaccess*
 *.db
@@ -8,8 +15,10 @@ private/*
 archives/*
 *~
 DEADJOE
-plugins/additional_plugins*
 /.settings
 /.buildpath
 /.project
 .DS_Store
+.editorconfig
+*.git
+tests/phpunit.xml

CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at `serendipity {at} supergarv (dot) de`. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

CONTRIBUTING.md

@@ -0,0 +1 @@
+Please see [Contributing/support](https://docs.s9y.org/docs/contributing/index.html).

LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2003-2019, Jannis Hermanns (on behalf the Serendipity Developer Team)
+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.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 COPYRIGHT HOLDER OR CONTRIBUTORS 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.

README.markdown

@@ -1,9 +1,3 @@
-# Serendipity - a PHP Weblog/Blog software
+# Serendipity - A reliable, secure & extensible PHP blog
 
-[Serendipity](http://s9y.org) is a PHP-powered weblog application which gives the user an easy way to maintain an online diary, weblog or even a complete homepage. While the default package is designed for the casual blogger, Serendipity offers a flexible, expandable and easy-to-use framework with the power for professional applications.
-
-This is a testing branch to mainly support the new backend smartification.
-
-Use with care!
-
-https://github.com/ophian/s9y-admin-tpl forked from https://github.com/yellowled/s9y-admin-tpl 
+[Serendipity](https://s9y.org) is a PHP-powered weblog engine which gives the user an easy way to maintain a blog. While the default package is designed for the casual blogger, Serendipity offers an expandable framework with the power for professional applications.

bundled-libs/.current_version

@@ -1,11 +1,15 @@
-Cache_Lite		1.5.1
-HTTP_Request		1.2.4
-Net_CheckIP          	1.1
-Net_Socket           	1.0.6
-Net_URL              	1.0.14
-PEAR			1.3.5
-Text_Wiki		0.25.0
-XML_RPC 		1.4.0
-Onyx                    1.0 (customized)
-Smarty                  2.6.9
-Net_DNSBL               1.0.0
+Cache_Lite              1.5.1 (CVS 1.54)
+HTTP_Request            1.2.4 (CVS 1.43)
+HTTP_Request2           2.2.1 (CVS 2.2.1)
+Net_CheckIP             1.1   (CVS 1.5)
+Net_DNSBL               1.0.0 (CVS 1.4)
+Net_Socket              1.0.6 (CVS 1.24)
+Net_URL                 1.0.4 (CVS 1.36)
+Net_SURBL               1.4
+Onyx (customized)       1.0
+PEAR                    1.9.5 (CVS 1.83)
+SimplePie               1.2.1
+Smarty                  3.1.18
+Text_Wiki               0.25.0 (CVS 1.27)
+XML_RPC                 1.4.0 (1.5.5)
+

bundled-libs/Cache/Lite.php

@@ -19,8 +19,8 @@
 *
 * @package Cache_Lite
 * @category Caching
-* @version $Id: Lite.php,v 1.54 2009/07/07 05:34:37 tacker Exp $
 * @author Fabien MARTY <fab@php.net>
+* @author Markus Tacker <tacker@php.net>
 */
 
 define('CACHE_LITE_ERROR_RETURN', 1);
@@ -247,6 +247,12 @@ class Cache_Lite
      * @var boolean
      */
     var $_errorHandlingAPIBreak = false;
+	
+	var $_hashedDirectoryGroup = NULL;
+	
+	var $_cacheFileMode = NULL;
+	
+	var $_cacheFileGroup = NULL;
     
     // --- Public methods ---
 
@@ -272,16 +278,30 @@ class Cache_Lite
     *     'hashedDirectoryLevel' => level of the hashed directory system (int),
     *     'hashedDirectoryUmask' => umask for hashed directory structure (int),
     *     'errorHandlingAPIBreak' => API break for better error handling ? (boolean)
+	*     'hashedDirectoryGroup' => group of hashed directory structure (int | string) (see function chgrp)
+	*     'cacheFileMode' => filesystem mode of newly created cache files (int)
+	*     'cacheFileGroup' => group of newly created cache files (int | string) (see function chgrp)
     * );
+    * 
+    * If sys_get_temp_dir() is available and the 
+    * 'cacheDir' option is not provided in the 
+    * constructor options array its output is used 
+    * to determine the suitable temporary directory.
+    * 
+    * @see http://de.php.net/sys_get_temp_dir
+    * @see http://pear.php.net/bugs/bug.php?id=18328
     *
     * @param array $options options
     * @access public
     */
-    function Cache_Lite($options = array(NULL))
+    function __construct($options = array(NULL))
     {
         foreach($options as $key => $value) {
             $this->setOption($key, $value);
         }
+        if (!isset($options['cacheDir']) && function_exists('sys_get_temp_dir')) {
+        	$this->setOption('cacheDir', sys_get_temp_dir() . DIRECTORY_SEPARATOR);
+        }
     }
     
     /**
@@ -295,7 +315,7 @@ class Cache_Lite
     */
     function setOption($name, $value) 
     {
-        $availableOptions = array('errorHandlingAPIBreak', 'hashedDirectoryUmask', 'hashedDirectoryLevel', 'automaticCleaningFactor', 'automaticSerialization', 'fileNameProtection', 'memoryCaching', 'onlyMemoryCaching', 'memoryCachingLimit', 'cacheDir', 'caching', 'lifeTime', 'fileLocking', 'writeControl', 'readControl', 'readControlType', 'pearErrorMode');
+        $availableOptions = array('errorHandlingAPIBreak', 'hashedDirectoryUmask', 'hashedDirectoryLevel', 'automaticCleaningFactor', 'automaticSerialization', 'fileNameProtection', 'memoryCaching', 'onlyMemoryCaching', 'memoryCachingLimit', 'cacheDir', 'caching', 'lifeTime', 'fileLocking', 'writeControl', 'readControl', 'readControlType', 'pearErrorMode', 'hashedDirectoryGroup', 'cacheFileMode', 'cacheFileGroup');
         if (in_array($name, $availableOptions)) {
             $property = '_'.$name;
             $this->$property = $value;
@@ -534,7 +554,7 @@ class Cache_Lite
     */
     function raiseError($msg, $code)
     {
-        include_once dirname(__FILE__) . '/../PEAR.php';
+        include_once('PEAR.php');
         return PEAR::raiseError($msg, $code, $this->_pearErrorMode);
     }
     
@@ -613,7 +633,7 @@ class Cache_Lite
             return $this->raiseError('Cache_Lite : Unable to open cache directory !', -4);
         }
         $result = true;
-        while ($file = readdir($dh)) {
+        while (($file = readdir($dh)) !== false) {
             if (($file != '.') && ($file != '..')) {
                 if (substr($file, 0, 6)=='cache_') {
                     $file2 = $dir . $file;
@@ -654,7 +674,19 @@ class Cache_Lite
         }
         return $result;
     }
-      
+
+    /**
+    * Touch the cache file while are recreating it to avoid
+    * launch this task more then once when necessary
+    * When the cache recreated and Added in Cache Memory
+    * @return void
+    * @access private
+    */
+    function _touchCacheFile(){
+        if (file_exists($this->_file)) {
+            @touch($this->_file);
+        }
+    }
     /**
     * Add some date in the memory caching array
     *
@@ -663,6 +695,7 @@ class Cache_Lite
     */
     function _memoryCacheAdd($data)
     {
+        $this->_touchCacheFile();
         $this->_memoryCachingArray[$this->_file] = $data;
         if ($this->_memoryCachingCounter >= $this->_memoryCachingLimit) {
             list($key, ) = each($this->_memoryCachingArray);
@@ -707,8 +740,8 @@ class Cache_Lite
     function _read()
     {
         $fp = @fopen($this->_file, "rb");
-        if ($this->_fileLocking) @flock($fp, LOCK_SH);
         if ($fp) {
+	    if ($this->_fileLocking) @flock($fp, LOCK_SH);
             clearstatcache();
             $length = @filesize($this->_file);
             $mqr = get_magic_quotes_runtime();
@@ -718,9 +751,13 @@ class Cache_Lite
             if ($this->_readControl) {
                 $hashControl = @fread($fp, 32);
                 $length = $length - 32;
-            } 
+            }
+
             if ($length) {
-                $data = @fread($fp, $length);
+                $data = '';
+                // See https://bugs.php.net/bug.php?id=30936
+                // The 8192 magic number is the chunk size used internally by PHP.
+                while(!feof($fp)) $data .= fread($fp, 8192);
             } else {
                 $data = '';
             }
@@ -760,13 +797,29 @@ class Cache_Lite
             for ($i=0 ; $i<$this->_hashedDirectoryLevel ; $i++) {
                 $root = $root . 'cache_' . substr($hash, 0, $i + 1) . '/';
                 if (!(@is_dir($root))) {
-                    @mkdir($root, $this->_hashedDirectoryUmask);
+					if (@mkdir($root))
+					{
+						@chmod($root, $this->_hashedDirectoryUmask);
+						if (! is_null($this->_hashedDirectoryGroup))
+							@chgrp($root, $this->_hashedDirectoryGroup);
+					}
                 }
             }
         }
+		// if both _cacheFileMode and _cacheFileGroup is null, then we don't need to call
+		// file_exists (see below: if ($is_newfile) ...)
+		$is_newfile = (! is_null($this->_cacheFileMode) || !is_null($this->_cacheFileGroup)) 
+			&& ! @file_exists($this->_file);
         $fp = @fopen($this->_file, "wb");
         if ($fp) {
             if ($this->_fileLocking) @flock($fp, LOCK_EX);
+			if ($is_newfile)
+			{
+				if (! is_null($this->_cacheFileMode))
+					@chmod($this->_file, $this->_cacheFileMode);
+				if (! is_null($this->_cacheFileGroup))
+					@chgrp($this->_file, $this->_cacheFileGroup);
+			}
             if ($this->_readControl) {
                 @fwrite($fp, $this->_hash($data, $this->_readControlType), 32);
             }
@@ -831,5 +884,3 @@ class Cache_Lite
     }
     
 } 
-
-?>

bundled-libs/Cache/Lite/File.php

@@ -0,0 +1,90 @@
+<?php
+
+/**
+* This class extends Cache_Lite and offers a cache system driven by a master file
+*
+* With this class, cache validity is only dependent of a given file. Cache files
+* are valid only if they are older than the master file. It's a perfect way for
+* caching templates results (if the template file is newer than the cache, cache
+* must be rebuild...) or for config classes...
+* There are some examples in the 'docs/examples' file
+* Technical choices are described in the 'docs/technical' file
+*
+* @package Cache_Lite
+* @author Fabien MARTY <fab@php.net>
+*/
+ 
+require_once('Cache/Lite.php');
+
+class Cache_Lite_File extends Cache_Lite
+{
+
+    // --- Private properties ---
+    
+    /**
+    * Complete path of the file used for controlling the cache lifetime
+    *
+    * @var string $_masterFile
+    */
+    var $_masterFile = '';
+    
+    /**
+    * Masterfile mtime
+    *
+    * @var int $_masterFile_mtime
+    */
+    var $_masterFile_mtime = 0;
+    
+    // --- Public methods ----
+    
+    /**
+    * Constructor
+    *
+    * $options is an assoc. To have a look at availables options,
+    * see the constructor of the Cache_Lite class in 'Cache_Lite.php'
+    *
+    * Comparing to Cache_Lite constructor, there is another option :
+    * $options = array(
+    *     (...) see Cache_Lite constructor
+    *     'masterFile' => complete path of the file used for controlling the cache lifetime(string)
+    * );
+    *
+    * @param array $options options
+    * @access public
+    */
+    function __construct($options = array(NULL))
+    {   
+        $options['lifetime'] = 0;
+        parent::__construct($options);
+        if (isset($options['masterFile'])) {
+            $this->_masterFile = $options['masterFile'];
+        } else {
+            return $this->raiseError('Cache_Lite_File : masterFile option must be set !');
+        }
+        if (!($this->_masterFile_mtime = @filemtime($this->_masterFile))) {
+            return $this->raiseError('Cache_Lite_File : Unable to read masterFile : '.$this->_masterFile, -3);
+        }
+    }
+    
+    /**
+    * Test if a cache is available and (if yes) return it
+    *
+    * @param string $id cache id
+    * @param string $group name of the cache group
+    * @param boolean $doNotTestCacheValidity if set to true, the cache validity won't be tested
+    * @return string data of the cache (else : false)
+    * @access public
+    */
+    function get($id, $group = 'default', $doNotTestCacheValidity = false)
+    {
+        if ($data = parent::get($id, $group, true)) {
+            if ($filemtime = $this->lastModified()) {
+                if ($filemtime > $this->_masterFile_mtime) {
+                    return $data;
+                }
+            }
+        }
+        return false;
+    }
+
+}

bundled-libs/Cache/Lite/Function.php

@@ -11,12 +11,11 @@
 * Technical choices are described in the 'docs/technical' file
 *
 * @package Cache_Lite
-* @version $Id: Function.php,v 1.11 2006/12/14 12:59:43 cweiske Exp $
 * @author Sebastian BERGMANN <sb@sebastian-bergmann.de>
 * @author Fabien MARTY <fab@php.net>
 */
 
-require_once dirname(__FILE__) . '/../Lite.php';
+require_once('Cache/Lite.php');
 
 class Cache_Lite_Function extends Cache_Lite
 {
@@ -82,7 +81,7 @@ class Cache_Lite_Function extends Cache_Lite
     * @param array $options options
     * @access public
     */
-    function Cache_Lite_Function($options = array(NULL))
+    function __construct($options = array(NULL))
     {
         $availableOptions = array('debugCacheLiteFunction', 'defaultGroup', 'dontCacheWhenTheOutputContainsNOCACHE', 'dontCacheWhenTheResultIsFalse', 'dontCacheWhenTheResultIsNull');
         while (list($name, $value) = each($options)) {
@@ -92,7 +91,7 @@ class Cache_Lite_Function extends Cache_Lite
             }
         }
         reset($options);
-        $this->Cache_Lite($options);
+        parent::__construct($options);
     }
 
     /**
@@ -207,5 +206,3 @@ class Cache_Lite_Function extends Cache_Lite
     }
 
 }
-
-?>

bundled-libs/Cache/Lite/NestedOutput.php

@@ -0,0 +1,56 @@
+<?php
+
+/**
+* This class extends Cache_Lite and uses output buffering to get the data to cache.
+* It supports nesting of caches
+*
+* @package Cache_Lite
+* @author Markus Tacker <tacker@php.net>
+*/
+
+require_once('Cache/Lite/Output.php');
+
+class Cache_Lite_NestedOutput extends Cache_Lite_Output
+{
+	private $nestedIds = array();
+	private $nestedGroups = array();
+
+    /**
+    * Start the cache
+    *
+    * @param string $id cache id
+    * @param string $group name of the cache group
+    * @param boolean $doNotTestCacheValidity if set to true, the cache validity won't be tested
+    * @return boolean|string false if the cache is not hit else the data
+    * @access public
+    */
+    function start($id, $group = 'default', $doNotTestCacheValidity = false)
+    {
+    	$this->nestedIds[] = $id;
+    	$this->nestedGroups[] = $group;
+    	$data = $this->get($id, $group, $doNotTestCacheValidity);
+        if ($data !== false) {
+            return $data;
+        }
+        ob_start();
+        ob_implicit_flush(false);
+        return false;
+    }
+
+    /**
+    * Stop the cache
+    *
+    * @param boolen
+    * @return string return contents of cache
+    */
+    function end()
+    {
+        $data = ob_get_contents();
+        ob_end_clean();
+        $id = array_pop($this->nestedIds);
+        $group = array_pop($this->nestedGroups);
+        $this->save($data, $id, $group);
+		return $data;
+    }
+
+}

bundled-libs/Cache/Lite/Output.php

@@ -7,11 +7,10 @@
 * Technical choices are described in the 'docs/technical' file
 *
 * @package Cache_Lite
-* @version $Id: Output.php,v 1.4 2006/01/29 00:22:07 fab Exp $
 * @author Fabien MARTY <fab@php.net>
 */
 
-require_once dirname(__FILE__) . '/../Lite.php';
+require_once('Cache/Lite.php');
 
 class Cache_Lite_Output extends Cache_Lite
 {
@@ -27,9 +26,9 @@ class Cache_Lite_Output extends Cache_Lite
     * @param array $options options
     * @access public
     */
-    function Cache_Lite_Output($options)
+    function __construct($options)
     {
-        $this->Cache_Lite($options);
+        parent::__construct($options);
     }
 
     /**
@@ -67,6 +66,3 @@ class Cache_Lite_Output extends Cache_Lite
     }
 
 }
-
-
-?>

bundled-libs/HTTP/Request.php

@@ -89,7 +89,7 @@ class HTTP_Request {
     * @var string
     */
     var $_user;
-    
+
     /**
     * Basic Auth Password
     * @var string
@@ -101,25 +101,25 @@ class HTTP_Request {
     * @var object Net_Socket
     */
     var $_sock;
-    
+
     /**
     * Proxy server
     * @var string
     */
     var $_proxy_host;
-    
+
     /**
     * Proxy port
     * @var integer
     */
     var $_proxy_port;
-    
+
     /**
     * Proxy username
     * @var string
     */
     var $_proxy_user;
-    
+
     /**
     * Proxy password
     * @var string
@@ -133,7 +133,7 @@ class HTTP_Request {
     var $_postData;
 
    /**
-    * Request body  
+    * Request body
     * @var string
     */
     var $_body;
@@ -145,7 +145,7 @@ class HTTP_Request {
     var $_bodyDisallowed = array('TRACE');
 
    /**
-    * Files to post 
+    * Files to post
     * @var array
     */
     var $_postFiles = array();
@@ -155,25 +155,25 @@ class HTTP_Request {
     * @var float
     */
     var $_timeout;
-    
+
     /**
     * HTTP_Response object
     * @var object HTTP_Response
     */
     var $_response;
-    
+
     /**
     * Whether to allow redirects
     * @var boolean
     */
     var $_allowRedirects;
-    
+
     /**
     * Maximum redirects allowed
     * @var integer
     */
     var $_maxRedirects;
-    
+
     /**
     * Current number of redirects
     * @var integer
@@ -193,7 +193,7 @@ class HTTP_Request {
     var $_listeners = array();
 
    /**
-    * Whether to save response body in response object property  
+    * Whether to save response body in response object property
     * @var bool
     */
     var $_saveBody = true;
@@ -286,7 +286,7 @@ class HTTP_Request {
             $this->addHeader('Accept-Encoding', 'gzip');
         }
     }
-    
+
     /**
     * Generates a Host header for HTTP/1.1 requests
     *
@@ -303,14 +303,14 @@ class HTTP_Request {
 
         } elseif ($this->_url->port == 443 AND strcasecmp($this->_url->protocol, 'https') == 0 AND strpos($this->_url->url, ':443') !== false) {
             $host = $this->_url->host . ':' . $this->_url->port;
-        
+
         } else {
             $host = $this->_url->host;
         }
 
         return $host;
     }
-    
+
     /**
     * Resets the object to its initial state (DEPRECATED).
     * Takes the same parameters as the constructor.
@@ -344,7 +344,7 @@ class HTTP_Request {
             $this->addHeader('Host', $this->_generateHostHeader());
         }
     }
-    
+
     /**
     * Sets a proxy to be used
     *
@@ -438,8 +438,8 @@ class HTTP_Request {
     function addQueryString($name, $value, $preencoded = false)
     {
         $this->_url->addQueryString($name, $value, $preencoded);
-    }    
-    
+    }
+
     /**
     * Sets the querystring to literally what you supply
     *
@@ -546,7 +546,7 @@ class HTTP_Request {
     }
 
     /**
-    * Clears any postdata that has been added (DEPRECATED). 
+    * Clears any postdata that has been added (DEPRECATED).
     * 
     * Useful for multiple request scenarios.
     *
@@ -570,9 +570,9 @@ class HTTP_Request {
         $cookies = isset($this->_requestHeaders['cookie']) ? $this->_requestHeaders['cookie']. '; ' : '';
         $this->addHeader('Cookie', $cookies . $name . '=' . $value);
     }
-    
+
     /**
-    * Clears any cookies that have been added (DEPRECATED). 
+    * Clears any cookies that have been added (DEPRECATED).
     * 
     * Useful for multiple request scenarios
     *
@@ -645,7 +645,7 @@ class HTTP_Request {
             AND $this->getResponseCode() < 399
             AND !empty($this->_response->_headers['location'])) {
 
-            
+
             $redirect = $this->_response->_headers['location'];
 
             // Absolute URL
@@ -655,7 +655,7 @@ class HTTP_Request {
             // Absolute path
             } elseif ($redirect[0] == '/') {
                 $this->_url->path = $redirect;
-            
+
             // Relative path
             } elseif (substr($redirect, 0, 3) == '../' OR substr($redirect, 0, 2) == './') {
                 if (substr($this->_url->path, -1) == '/') {
@@ -665,7 +665,7 @@ class HTTP_Request {
                 }
                 $redirect = Net_URL::resolvePath($redirect);
                 $this->_url->path = $redirect;
-                
+
             // Filename, no path
             } else {
                 if (substr($this->_url->path, -1) == '/') {
@@ -842,7 +842,7 @@ class HTTP_Request {
             $request .= 'Content-Length: ' . strlen($this->_body) . "\r\n\r\n";
             $request .= $this->_body;
         }
-        
+
         return $request;
     }
 
@@ -894,7 +894,7 @@ class HTTP_Request {
 
 
    /**
-    * Removes a Listener from the list of listeners 
+    * Removes a Listener from the list of listeners
     * 
     * @param    object   HTTP_Request_Listener instance to detach
     * @return   boolean  whether the listener was successfully detached
@@ -951,13 +951,13 @@ class HTTP_Response
     * @var string
     */
     var $_protocol;
-    
+
     /**
     * Return code
     * @var string
     */
     var $_code;
-    
+
     /**
     * Response headers
     * @var array
@@ -965,7 +965,7 @@ class HTTP_Response
     var $_headers;
 
     /**
-    * Cookies set in response  
+    * Cookies set in response
     * @var array
     */
     var $_cookies;
@@ -1078,7 +1078,7 @@ class HTTP_Response
         list($headername, $headervalue) = explode(':', $header, 2);
         $headername  = strtolower($headername);
         $headervalue = ltrim($headervalue);
-        
+
         if ('set-cookie' != $headername) {
             if (isset($this->_headers[$headername])) {
                 $this->_headers[$headername] .= ',' . $headervalue;
@@ -1154,7 +1154,7 @@ class HTTP_Response
         if (0 == $this->_chunkLength) {
             $line = $this->_sock->readLine();
             if (preg_match('/^([0-9a-f]+)/i', $line, $matches)) {
-                $this->_chunkLength = hexdec($matches[1]); 
+                $this->_chunkLength = hexdec($matches[1]);
                 // Chunk with zero length indicates the end
                 if (0 == $this->_chunkLength) {
                     $this->_sock->readLine(); // make this an eof()

bundled-libs/HTTP/Request2/Adapter.php

@@ -0,0 +1,137 @@
+<?php
+/**
+ * Base class for HTTP_Request2 adapters
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/**
+ * Class representing a HTTP response
+ */
+require_once 'HTTP/Request2/Response.php';
+
+/**
+ * Base class for HTTP_Request2 adapters
+ *
+ * HTTP_Request2 class itself only defines methods for aggregating the request
+ * data, all actual work of sending the request to the remote server and
+ * receiving its response is performed by adapters.
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+abstract class HTTP_Request2_Adapter
+{
+    /**
+     * A list of methods that MUST NOT have a request body, per RFC 2616
+     * @var  array
+     */
+    protected static $bodyDisallowed = array('TRACE');
+
+    /**
+     * Methods having defined semantics for request body
+     *
+     * Content-Length header (indicating that the body follows, section 4.3 of
+     * RFC 2616) will be sent for these methods even if no body was added
+     *
+     * @var  array
+     * @link http://pear.php.net/bugs/bug.php?id=12900
+     * @link http://pear.php.net/bugs/bug.php?id=14740
+     */
+    protected static $bodyRequired = array('POST', 'PUT');
+
+    /**
+     * Request being sent
+     * @var  HTTP_Request2
+     */
+    protected $request;
+
+    /**
+     * Request body
+     * @var  string|resource|HTTP_Request2_MultipartBody
+     * @see  HTTP_Request2::getBody()
+     */
+    protected $requestBody;
+
+    /**
+     * Length of the request body
+     * @var  integer
+     */
+    protected $contentLength;
+
+    /**
+     * Sends request to the remote server and returns its response
+     *
+     * @param HTTP_Request2 $request HTTP request message
+     *
+     * @return   HTTP_Request2_Response
+     * @throws   HTTP_Request2_Exception
+     */
+    abstract public function sendRequest(HTTP_Request2 $request);
+
+    /**
+     * Calculates length of the request body, adds proper headers
+     *
+     * @param array &$headers associative array of request headers, this method
+     *                        will add proper 'Content-Length' and 'Content-Type'
+     *                        headers to this array (or remove them if not needed)
+     */
+    protected function calculateRequestLength(&$headers)
+    {
+        $this->requestBody = $this->request->getBody();
+
+        if (is_string($this->requestBody)) {
+            $this->contentLength = strlen($this->requestBody);
+        } elseif (is_resource($this->requestBody)) {
+            $stat = fstat($this->requestBody);
+            $this->contentLength = $stat['size'];
+            rewind($this->requestBody);
+        } else {
+            $this->contentLength = $this->requestBody->getLength();
+            $headers['content-type'] = 'multipart/form-data; boundary=' .
+                                       $this->requestBody->getBoundary();
+            $this->requestBody->rewind();
+        }
+
+        if (in_array($this->request->getMethod(), self::$bodyDisallowed)
+            || 0 == $this->contentLength
+        ) {
+            // No body: send a Content-Length header nonetheless (request #12900),
+            // but do that only for methods that require a body (bug #14740)
+            if (in_array($this->request->getMethod(), self::$bodyRequired)) {
+                $headers['content-length'] = 0;
+            } else {
+                unset($headers['content-length']);
+                // if the method doesn't require a body and doesn't have a
+                // body, don't send a Content-Type header. (request #16799)
+                unset($headers['content-type']);
+            }
+        } else {
+            if (empty($headers['content-type'])) {
+                $headers['content-type'] = 'application/x-www-form-urlencoded';
+            }
+            // Content-Length should not be sent for chunked Transfer-Encoding (bug #20125)
+            if (!isset($headers['transfer-encoding'])) {
+                $headers['content-length'] = $this->contentLength;
+            }
+        }
+    }
+}
+?>

bundled-libs/HTTP/Request2/Adapter/Curl.php

@@ -0,0 +1,577 @@
+<?php
+/**
+ * Adapter for HTTP_Request2 wrapping around cURL extension
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/**
+ * Base class for HTTP_Request2 adapters
+ */
+require_once 'HTTP/Request2/Adapter.php';
+
+/**
+ * Adapter for HTTP_Request2 wrapping around cURL extension
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+class HTTP_Request2_Adapter_Curl extends HTTP_Request2_Adapter
+{
+    /**
+     * Mapping of header names to cURL options
+     * @var  array
+     */
+    protected static $headerMap = array(
+        'accept-encoding' => CURLOPT_ENCODING,
+        'cookie'          => CURLOPT_COOKIE,
+        'referer'         => CURLOPT_REFERER,
+        'user-agent'      => CURLOPT_USERAGENT
+    );
+
+    /**
+     * Mapping of SSL context options to cURL options
+     * @var  array
+     */
+    protected static $sslContextMap = array(
+        'ssl_verify_peer' => CURLOPT_SSL_VERIFYPEER,
+        'ssl_cafile'      => CURLOPT_CAINFO,
+        'ssl_capath'      => CURLOPT_CAPATH,
+        'ssl_local_cert'  => CURLOPT_SSLCERT,
+        'ssl_passphrase'  => CURLOPT_SSLCERTPASSWD
+    );
+
+    /**
+     * Mapping of CURLE_* constants to Exception subclasses and error codes
+     * @var  array
+     */
+    protected static $errorMap = array(
+        CURLE_UNSUPPORTED_PROTOCOL  => array('HTTP_Request2_MessageException',
+                                             HTTP_Request2_Exception::NON_HTTP_REDIRECT),
+        CURLE_COULDNT_RESOLVE_PROXY => array('HTTP_Request2_ConnectionException'),
+        CURLE_COULDNT_RESOLVE_HOST  => array('HTTP_Request2_ConnectionException'),
+        CURLE_COULDNT_CONNECT       => array('HTTP_Request2_ConnectionException'),
+        // error returned from write callback
+        CURLE_WRITE_ERROR           => array('HTTP_Request2_MessageException',
+                                             HTTP_Request2_Exception::NON_HTTP_REDIRECT),
+        CURLE_OPERATION_TIMEOUTED   => array('HTTP_Request2_MessageException',
+                                             HTTP_Request2_Exception::TIMEOUT),
+        CURLE_HTTP_RANGE_ERROR      => array('HTTP_Request2_MessageException'),
+        CURLE_SSL_CONNECT_ERROR     => array('HTTP_Request2_ConnectionException'),
+        CURLE_LIBRARY_NOT_FOUND     => array('HTTP_Request2_LogicException',
+                                             HTTP_Request2_Exception::MISCONFIGURATION),
+        CURLE_FUNCTION_NOT_FOUND    => array('HTTP_Request2_LogicException',
+                                             HTTP_Request2_Exception::MISCONFIGURATION),
+        CURLE_ABORTED_BY_CALLBACK   => array('HTTP_Request2_MessageException',
+                                             HTTP_Request2_Exception::NON_HTTP_REDIRECT),
+        CURLE_TOO_MANY_REDIRECTS    => array('HTTP_Request2_MessageException',
+                                             HTTP_Request2_Exception::TOO_MANY_REDIRECTS),
+        CURLE_SSL_PEER_CERTIFICATE  => array('HTTP_Request2_ConnectionException'),
+        CURLE_GOT_NOTHING           => array('HTTP_Request2_MessageException'),
+        CURLE_SSL_ENGINE_NOTFOUND   => array('HTTP_Request2_LogicException',
+                                             HTTP_Request2_Exception::MISCONFIGURATION),
+        CURLE_SSL_ENGINE_SETFAILED  => array('HTTP_Request2_LogicException',
+                                             HTTP_Request2_Exception::MISCONFIGURATION),
+        CURLE_SEND_ERROR            => array('HTTP_Request2_MessageException'),
+        CURLE_RECV_ERROR            => array('HTTP_Request2_MessageException'),
+        CURLE_SSL_CERTPROBLEM       => array('HTTP_Request2_LogicException',
+                                             HTTP_Request2_Exception::INVALID_ARGUMENT),
+        CURLE_SSL_CIPHER            => array('HTTP_Request2_ConnectionException'),
+        CURLE_SSL_CACERT            => array('HTTP_Request2_ConnectionException'),
+        CURLE_BAD_CONTENT_ENCODING  => array('HTTP_Request2_MessageException'),
+    );
+
+    /**
+     * Response being received
+     * @var  HTTP_Request2_Response
+     */
+    protected $response;
+
+    /**
+     * Whether 'sentHeaders' event was sent to observers
+     * @var  boolean
+     */
+    protected $eventSentHeaders = false;
+
+    /**
+     * Whether 'receivedHeaders' event was sent to observers
+     * @var boolean
+     */
+    protected $eventReceivedHeaders = false;
+
+    /**
+     * Whether 'sentBoody' event was sent to observers
+     * @var boolean
+     */
+    protected $eventSentBody = false;
+
+    /**
+     * Position within request body
+     * @var  integer
+     * @see  callbackReadBody()
+     */
+    protected $position = 0;
+
+    /**
+     * Information about last transfer, as returned by curl_getinfo()
+     * @var  array
+     */
+    protected $lastInfo;
+
+    /**
+     * Creates a subclass of HTTP_Request2_Exception from curl error data
+     *
+     * @param resource $ch curl handle
+     *
+     * @return HTTP_Request2_Exception
+     */
+    protected static function wrapCurlError($ch)
+    {
+        $nativeCode = curl_errno($ch);
+        $message    = 'Curl error: ' . curl_error($ch);
+        if (!isset(self::$errorMap[$nativeCode])) {
+            return new HTTP_Request2_Exception($message, 0, $nativeCode);
+        } else {
+            $class = self::$errorMap[$nativeCode][0];
+            $code  = empty(self::$errorMap[$nativeCode][1])
+                     ? 0 : self::$errorMap[$nativeCode][1];
+            return new $class($message, $code, $nativeCode);
+        }
+    }
+
+    /**
+     * Sends request to the remote server and returns its response
+     *
+     * @param HTTP_Request2 $request HTTP request message
+     *
+     * @return   HTTP_Request2_Response
+     * @throws   HTTP_Request2_Exception
+     */
+    public function sendRequest(HTTP_Request2 $request)
+    {
+        if (!extension_loaded('curl')) {
+            throw new HTTP_Request2_LogicException(
+                'cURL extension not available', HTTP_Request2_Exception::MISCONFIGURATION
+            );
+        }
+
+        $this->request              = $request;
+        $this->response             = null;
+        $this->position             = 0;
+        $this->eventSentHeaders     = false;
+        $this->eventReceivedHeaders = false;
+        $this->eventSentBody        = false;
+
+        try {
+            if (false === curl_exec($ch = $this->createCurlHandle())) {
+                $e = self::wrapCurlError($ch);
+            }
+        } catch (Exception $e) {
+        }
+        if (isset($ch)) {
+            $this->lastInfo = curl_getinfo($ch);
+            if (CURLE_OK !== curl_errno($ch)) {
+                $this->request->setLastEvent('warning', curl_error($ch));
+            }
+            curl_close($ch);
+        }
+
+        $response = $this->response;
+        unset($this->request, $this->requestBody, $this->response);
+
+        if (!empty($e)) {
+            throw $e;
+        }
+
+        if ($jar = $request->getCookieJar()) {
+            $jar->addCookiesFromResponse($response);
+        }
+
+        if (0 < $this->lastInfo['size_download']) {
+            $request->setLastEvent('receivedBody', $response);
+        }
+        return $response;
+    }
+
+    /**
+     * Returns information about last transfer
+     *
+     * @return   array   associative array as returned by curl_getinfo()
+     */
+    public function getInfo()
+    {
+        return $this->lastInfo;
+    }
+
+    /**
+     * Creates a new cURL handle and populates it with data from the request
+     *
+     * @return   resource    a cURL handle, as created by curl_init()
+     * @throws   HTTP_Request2_LogicException
+     * @throws   HTTP_Request2_NotImplementedException
+     */
+    protected function createCurlHandle()
+    {
+        $ch = curl_init();
+
+        curl_setopt_array($ch, array(
+            // setup write callbacks
+            CURLOPT_HEADERFUNCTION => array($this, 'callbackWriteHeader'),
+            CURLOPT_WRITEFUNCTION  => array($this, 'callbackWriteBody'),
+            // buffer size
+            CURLOPT_BUFFERSIZE     => $this->request->getConfig('buffer_size'),
+            // connection timeout
+            CURLOPT_CONNECTTIMEOUT => $this->request->getConfig('connect_timeout'),
+            // save full outgoing headers, in case someone is interested
+            CURLINFO_HEADER_OUT    => true,
+            // request url
+            CURLOPT_URL            => $this->request->getUrl()->getUrl()
+        ));
+
+        // set up redirects
+        if (!$this->request->getConfig('follow_redirects')) {
+            curl_setopt($ch, CURLOPT_FOLLOWLOCATION, false);
+        } else {
+            if (!@curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true)) {
+                throw new HTTP_Request2_LogicException(
+                    'Redirect support in curl is unavailable due to open_basedir or safe_mode setting',
+                    HTTP_Request2_Exception::MISCONFIGURATION
+                );
+            }
+            curl_setopt($ch, CURLOPT_MAXREDIRS, $this->request->getConfig('max_redirects'));
+            // limit redirects to http(s), works in 5.2.10+
+            if (defined('CURLOPT_REDIR_PROTOCOLS')) {
+                curl_setopt($ch, CURLOPT_REDIR_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS);
+            }
+            // works in 5.3.2+, http://bugs.php.net/bug.php?id=49571
+            if ($this->request->getConfig('strict_redirects') && defined('CURLOPT_POSTREDIR')) {
+                curl_setopt($ch, CURLOPT_POSTREDIR, 3);
+            }
+        }
+
+        // set local IP via CURLOPT_INTERFACE (request #19515)
+        if ($ip = $this->request->getConfig('local_ip')) {
+            curl_setopt($ch, CURLOPT_INTERFACE, $ip);
+        }
+
+        // request timeout
+        if ($timeout = $this->request->getConfig('timeout')) {
+            curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
+        }
+
+        // set HTTP version
+        switch ($this->request->getConfig('protocol_version')) {
+        case '1.0':
+            curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0);
+            break;
+        case '1.1':
+            curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
+        }
+
+        // set request method
+        switch ($this->request->getMethod()) {
+        case HTTP_Request2::METHOD_GET:
+            curl_setopt($ch, CURLOPT_HTTPGET, true);
+            break;
+        case HTTP_Request2::METHOD_POST:
+            curl_setopt($ch, CURLOPT_POST, true);
+            break;
+        case HTTP_Request2::METHOD_HEAD:
+            curl_setopt($ch, CURLOPT_NOBODY, true);
+            break;
+        case HTTP_Request2::METHOD_PUT:
+            curl_setopt($ch, CURLOPT_UPLOAD, true);
+            break;
+        default:
+            curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $this->request->getMethod());
+        }
+
+        // set proxy, if needed
+        if ($host = $this->request->getConfig('proxy_host')) {
+            if (!($port = $this->request->getConfig('proxy_port'))) {
+                throw new HTTP_Request2_LogicException(
+                    'Proxy port not provided', HTTP_Request2_Exception::MISSING_VALUE
+                );
+            }
+            curl_setopt($ch, CURLOPT_PROXY, $host . ':' . $port);
+            if ($user = $this->request->getConfig('proxy_user')) {
+                curl_setopt(
+                    $ch, CURLOPT_PROXYUSERPWD,
+                    $user . ':' . $this->request->getConfig('proxy_password')
+                );
+                switch ($this->request->getConfig('proxy_auth_scheme')) {
+                case HTTP_Request2::AUTH_BASIC:
+                    curl_setopt($ch, CURLOPT_PROXYAUTH, CURLAUTH_BASIC);
+                    break;
+                case HTTP_Request2::AUTH_DIGEST:
+                    curl_setopt($ch, CURLOPT_PROXYAUTH, CURLAUTH_DIGEST);
+                }
+            }
+            if ($type = $this->request->getConfig('proxy_type')) {
+                switch ($type) {
+                case 'http':
+                    curl_setopt($ch, CURLOPT_PROXYTYPE, CURLPROXY_HTTP);
+                    break;
+                case 'socks5':
+                    curl_setopt($ch, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS5);
+                    break;
+                default:
+                    throw new HTTP_Request2_NotImplementedException(
+                        "Proxy type '{$type}' is not supported"
+                    );
+                }
+            }
+        }
+
+        // set authentication data
+        if ($auth = $this->request->getAuth()) {
+            curl_setopt($ch, CURLOPT_USERPWD, $auth['user'] . ':' . $auth['password']);
+            switch ($auth['scheme']) {
+            case HTTP_Request2::AUTH_BASIC:
+                curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
+                break;
+            case HTTP_Request2::AUTH_DIGEST:
+                curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST);
+            }
+        }
+
+        // set SSL options
+        foreach ($this->request->getConfig() as $name => $value) {
+            if ('ssl_verify_host' == $name && null !== $value) {
+                curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, $value? 2: 0);
+            } elseif (isset(self::$sslContextMap[$name]) && null !== $value) {
+                curl_setopt($ch, self::$sslContextMap[$name], $value);
+            }
+        }
+
+        $headers = $this->request->getHeaders();
+        // make cURL automagically send proper header
+        if (!isset($headers['accept-encoding'])) {
+            $headers['accept-encoding'] = '';
+        }
+
+        if (($jar = $this->request->getCookieJar())
+            && ($cookies = $jar->getMatching($this->request->getUrl(), true))
+        ) {
+            $headers['cookie'] = (empty($headers['cookie'])? '': $headers['cookie'] . '; ') . $cookies;
+        }
+
+        // set headers having special cURL keys
+        foreach (self::$headerMap as $name => $option) {
+            if (isset($headers[$name])) {
+                curl_setopt($ch, $option, $headers[$name]);
+                unset($headers[$name]);
+            }
+        }
+
+        $this->calculateRequestLength($headers);
+        if (isset($headers['content-length']) || isset($headers['transfer-encoding'])) {
+            $this->workaroundPhpBug47204($ch, $headers);
+        }
+
+        // set headers not having special keys
+        $headersFmt = array();
+        foreach ($headers as $name => $value) {
+            $canonicalName = implode('-', array_map('ucfirst', explode('-', $name)));
+            $headersFmt[]  = $canonicalName . ': ' . $value;
+        }
+        curl_setopt($ch, CURLOPT_HTTPHEADER, $headersFmt);
+
+        return $ch;
+    }
+
+    /**
+     * Workaround for PHP bug #47204 that prevents rewinding request body
+     *
+     * The workaround consists of reading the entire request body into memory
+     * and setting it as CURLOPT_POSTFIELDS, so it isn't recommended for large
+     * file uploads, use Socket adapter instead.
+     *
+     * @param resource $ch       cURL handle
+     * @param array    &$headers Request headers
+     */
+    protected function workaroundPhpBug47204($ch, &$headers)
+    {
+        // no redirects, no digest auth -> probably no rewind needed
+        // also apply workaround only for POSTs, othrerwise we get
+        // https://pear.php.net/bugs/bug.php?id=20440 for PUTs
+        if (!$this->request->getConfig('follow_redirects')
+            && (!($auth = $this->request->getAuth())
+                || HTTP_Request2::AUTH_DIGEST != $auth['scheme'])
+            || HTTP_Request2::METHOD_POST !== $this->request->getMethod()
+        ) {
+            curl_setopt($ch, CURLOPT_READFUNCTION, array($this, 'callbackReadBody'));
+
+        } else {
+            // rewind may be needed, read the whole body into memory
+            if ($this->requestBody instanceof HTTP_Request2_MultipartBody) {
+                $this->requestBody = $this->requestBody->__toString();
+
+            } elseif (is_resource($this->requestBody)) {
+                $fp = $this->requestBody;
+                $this->requestBody = '';
+                while (!feof($fp)) {
+                    $this->requestBody .= fread($fp, 16384);
+                }
+            }
+            // curl hangs up if content-length is present
+            unset($headers['content-length']);
+            curl_setopt($ch, CURLOPT_POSTFIELDS, $this->requestBody);
+        }
+    }
+
+    /**
+     * Callback function called by cURL for reading the request body
+     *
+     * @param resource $ch     cURL handle
+     * @param resource $fd     file descriptor (not used)
+     * @param integer  $length maximum length of data to return
+     *
+     * @return   string      part of the request body, up to $length bytes
+     */
+    protected function callbackReadBody($ch, $fd, $length)
+    {
+        if (!$this->eventSentHeaders) {
+            $this->request->setLastEvent(
+                'sentHeaders', curl_getinfo($ch, CURLINFO_HEADER_OUT)
+            );
+            $this->eventSentHeaders = true;
+        }
+        if (in_array($this->request->getMethod(), self::$bodyDisallowed)
+            || 0 == $this->contentLength || $this->position >= $this->contentLength
+        ) {
+            return '';
+        }
+        if (is_string($this->requestBody)) {
+            $string = substr($this->requestBody, $this->position, $length);
+        } elseif (is_resource($this->requestBody)) {
+            $string = fread($this->requestBody, $length);
+        } else {
+            $string = $this->requestBody->read($length);
+        }
+        $this->request->setLastEvent('sentBodyPart', strlen($string));
+        $this->position += strlen($string);
+        return $string;
+    }
+
+    /**
+     * Callback function called by cURL for saving the response headers
+     *
+     * @param resource $ch     cURL handle
+     * @param string   $string response header (with trailing CRLF)
+     *
+     * @return   integer     number of bytes saved
+     * @see      HTTP_Request2_Response::parseHeaderLine()
+     */
+    protected function callbackWriteHeader($ch, $string)
+    {
+        if (!$this->eventSentHeaders
+            // we may receive a second set of headers if doing e.g. digest auth
+            // but don't bother with 100-Continue responses (bug #15785)
+            || $this->eventReceivedHeaders && $this->response->getStatus() >= 200
+        ) {
+            $this->request->setLastEvent(
+                'sentHeaders', curl_getinfo($ch, CURLINFO_HEADER_OUT)
+            );
+        }
+        if (!$this->eventSentBody) {
+            $upload = curl_getinfo($ch, CURLINFO_SIZE_UPLOAD);
+            // if body wasn't read by the callback, send event with total body size
+            if ($upload > $this->position) {
+                $this->request->setLastEvent(
+                    'sentBodyPart', $upload - $this->position
+                );
+            }
+            if ($upload > 0) {
+                $this->request->setLastEvent('sentBody', $upload);
+            }
+        }
+        $this->eventSentHeaders = true;
+        $this->eventSentBody    = true;
+
+        if ($this->eventReceivedHeaders || empty($this->response)) {
+            $this->eventReceivedHeaders = false;
+            $this->response             = new HTTP_Request2_Response(
+                $string, false, curl_getinfo($ch, CURLINFO_EFFECTIVE_URL)
+            );
+
+        } else {
+            $this->response->parseHeaderLine($string);
+            if ('' == trim($string)) {
+                // don't bother with 100-Continue responses (bug #15785)
+                if (200 <= $this->response->getStatus()) {
+                    $this->request->setLastEvent('receivedHeaders', $this->response);
+                }
+
+                if ($this->request->getConfig('follow_redirects') && $this->response->isRedirect()) {
+                    $redirectUrl = new Net_URL2($this->response->getHeader('location'));
+
+                    // for versions lower than 5.2.10, check the redirection URL protocol
+                    if (!defined('CURLOPT_REDIR_PROTOCOLS') && $redirectUrl->isAbsolute()
+                        && !in_array($redirectUrl->getScheme(), array('http', 'https'))
+                    ) {
+                        return -1;
+                    }
+
+                    if ($jar = $this->request->getCookieJar()) {
+                        $jar->addCookiesFromResponse($this->response);
+                        if (!$redirectUrl->isAbsolute()) {
+                            $redirectUrl = $this->request->getUrl()->resolve($redirectUrl);
+                        }
+                        if ($cookies = $jar->getMatching($redirectUrl, true)) {
+                            curl_setopt($ch, CURLOPT_COOKIE, $cookies);
+                        }
+                    }
+                }
+                $this->eventReceivedHeaders = true;
+                $this->eventSentBody        = false;
+            }
+        }
+        return strlen($string);
+    }
+
+    /**
+     * Callback function called by cURL for saving the response body
+     *
+     * @param resource $ch     cURL handle (not used)
+     * @param string   $string part of the response body
+     *
+     * @return   integer     number of bytes saved
+     * @throws   HTTP_Request2_MessageException
+     * @see      HTTP_Request2_Response::appendBody()
+     */
+    protected function callbackWriteBody($ch, $string)
+    {
+        // cURL calls WRITEFUNCTION callback without calling HEADERFUNCTION if
+        // response doesn't start with proper HTTP status line (see bug #15716)
+        if (empty($this->response)) {
+            throw new HTTP_Request2_MessageException(
+                "Malformed response: {$string}",
+                HTTP_Request2_Exception::MALFORMED_RESPONSE
+            );
+        }
+        if ($this->request->getConfig('store_body')) {
+            $this->response->appendBody($string);
+        }
+        $this->request->setLastEvent('receivedBodyPart', $string);
+        return strlen($string);
+    }
+}
+?>

bundled-libs/HTTP/Request2/Adapter/Mock.php

@@ -0,0 +1,166 @@
+<?php
+/**
+ * Mock adapter intended for testing
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/**
+ * Base class for HTTP_Request2 adapters
+ */
+require_once 'HTTP/Request2/Adapter.php';
+
+/**
+ * Mock adapter intended for testing
+ *
+ * Can be used to test applications depending on HTTP_Request2 package without
+ * actually performing any HTTP requests. This adapter will return responses
+ * previously added via addResponse()
+ * <code>
+ * $mock = new HTTP_Request2_Adapter_Mock();
+ * $mock->addResponse("HTTP/1.1 ... ");
+ *
+ * $request = new HTTP_Request2();
+ * $request->setAdapter($mock);
+ *
+ * // This will return the response set above
+ * $response = $req->send();
+ * </code>
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+class HTTP_Request2_Adapter_Mock extends HTTP_Request2_Adapter
+{
+    /**
+     * A queue of responses to be returned by sendRequest()
+     * @var  array
+     */
+    protected $responses = array();
+
+    /**
+     * Returns the next response from the queue built by addResponse()
+     *
+     * Only responses without explicit URLs or with URLs equal to request URL
+     * will be considered. If matching response is not found or the queue is
+     * empty then default empty response with status 400 will be returned,
+     * if an Exception object was added to the queue it will be thrown.
+     *
+     * @param HTTP_Request2 $request HTTP request message
+     *
+     * @return   HTTP_Request2_Response
+     * @throws   Exception
+     */
+    public function sendRequest(HTTP_Request2 $request)
+    {
+        $requestUrl = (string)$request->getUrl();
+        $response   = null;
+        foreach ($this->responses as $k => $v) {
+            if (!$v[1] || $requestUrl == $v[1]) {
+                $response = $v[0];
+                array_splice($this->responses, $k, 1);
+                break;
+            }
+        }
+        if (!$response) {
+            return self::createResponseFromString("HTTP/1.1 400 Bad Request\r\n\r\n");
+
+        } elseif ($response instanceof HTTP_Request2_Response) {
+            return $response;
+
+        } else {
+            // rethrow the exception
+            $class   = get_class($response);
+            $message = $response->getMessage();
+            $code    = $response->getCode();
+            throw new $class($message, $code);
+        }
+    }
+
+    /**
+     * Adds response to the queue
+     *
+     * @param mixed  $response either a string, a pointer to an open file,
+     *                         an instance of HTTP_Request2_Response or Exception
+     * @param string $url      A request URL this response should be valid for
+     *                         (see {@link http://pear.php.net/bugs/bug.php?id=19276})
+     *
+     * @throws   HTTP_Request2_Exception
+     */
+    public function addResponse($response, $url = null)
+    {
+        if (is_string($response)) {
+            $response = self::createResponseFromString($response);
+        } elseif (is_resource($response)) {
+            $response = self::createResponseFromFile($response);
+        } elseif (!$response instanceof HTTP_Request2_Response &&
+                  !$response instanceof Exception
+        ) {
+            throw new HTTP_Request2_Exception('Parameter is not a valid response');
+        }
+        $this->responses[] = array($response, $url);
+    }
+
+    /**
+     * Creates a new HTTP_Request2_Response object from a string
+     *
+     * @param string $str string containing HTTP response message
+     *
+     * @return   HTTP_Request2_Response
+     * @throws   HTTP_Request2_Exception
+     */
+    public static function createResponseFromString($str)
+    {
+        $parts       = preg_split('!(\r?\n){2}!m', $str, 2);
+        $headerLines = explode("\n", $parts[0]);
+        $response    = new HTTP_Request2_Response(array_shift($headerLines));
+        foreach ($headerLines as $headerLine) {
+            $response->parseHeaderLine($headerLine);
+        }
+        $response->parseHeaderLine('');
+        if (isset($parts[1])) {
+            $response->appendBody($parts[1]);
+        }
+        return $response;
+    }
+
+    /**
+     * Creates a new HTTP_Request2_Response object from a file
+     *
+     * @param resource $fp file pointer returned by fopen()
+     *
+     * @return   HTTP_Request2_Response
+     * @throws   HTTP_Request2_Exception
+     */
+    public static function createResponseFromFile($fp)
+    {
+        $response = new HTTP_Request2_Response(fgets($fp));
+        do {
+            $headerLine = fgets($fp);
+            $response->parseHeaderLine($headerLine);
+        } while ('' != trim($headerLine));
+
+        while (!feof($fp)) {
+            $response->appendBody(fread($fp, 8192));
+        }
+        return $response;
+    }
+}
+?>

bundled-libs/HTTP/Request2/CookieJar.php

@@ -0,0 +1,547 @@
+<?php
+/**
+ * Stores cookies and passes them between HTTP requests
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/** Class representing a HTTP request message */
+require_once 'HTTP/Request2.php';
+
+/**
+ * Stores cookies and passes them between HTTP requests
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: @package_version@
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+class HTTP_Request2_CookieJar implements Serializable
+{
+    /**
+     * Array of stored cookies
+     *
+     * The array is indexed by domain, path and cookie name
+     *   .example.com
+     *     /
+     *       some_cookie => cookie data
+     *     /subdir
+     *       other_cookie => cookie data
+     *   .example.org
+     *     ...
+     *
+     * @var array
+     */
+    protected $cookies = array();
+
+    /**
+     * Whether session cookies should be serialized when serializing the jar
+     * @var bool
+     */
+    protected $serializeSession = false;
+
+    /**
+     * Whether Public Suffix List should be used for domain matching
+     * @var bool
+     */
+    protected $useList = true;
+
+    /**
+     * Whether an attempt to store an invalid cookie should be ignored, rather than cause an Exception
+     * @var bool
+     */
+    protected $ignoreInvalid = false;
+
+    /**
+     * Array with Public Suffix List data
+     * @var  array
+     * @link http://publicsuffix.org/
+     */
+    protected static $psl = array();
+
+    /**
+     * Class constructor, sets various options
+     *
+     * @param bool $serializeSessionCookies Controls serializing session cookies,
+     *                                      see {@link serializeSessionCookies()}
+     * @param bool $usePublicSuffixList     Controls using Public Suffix List,
+     *                                      see {@link usePublicSuffixList()}
+     * @param bool $ignoreInvalidCookies    Whether invalid cookies should be ignored,
+     *                                      see {@link ignoreInvalidCookies()}
+     */
+    public function __construct(
+        $serializeSessionCookies = false, $usePublicSuffixList = true,
+        $ignoreInvalidCookies = false
+    ) {
+        $this->serializeSessionCookies($serializeSessionCookies);
+        $this->usePublicSuffixList($usePublicSuffixList);
+        $this->ignoreInvalidCookies($ignoreInvalidCookies);
+    }
+
+    /**
+     * Returns current time formatted in ISO-8601 at UTC timezone
+     *
+     * @return string
+     */
+    protected function now()
+    {
+        $dt = new DateTime();
+        $dt->setTimezone(new DateTimeZone('UTC'));
+        return $dt->format(DateTime::ISO8601);
+    }
+
+    /**
+     * Checks cookie array for correctness, possibly updating its 'domain', 'path' and 'expires' fields
+     *
+     * The checks are as follows:
+     *   - cookie array should contain 'name' and 'value' fields;
+     *   - name and value should not contain disallowed symbols;
+     *   - 'expires' should be either empty parseable by DateTime;
+     *   - 'domain' and 'path' should be either not empty or an URL where
+     *     cookie was set should be provided.
+     *   - if $setter is provided, then document at that URL should be allowed
+     *     to set a cookie for that 'domain'. If $setter is not provided,
+     *     then no domain checks will be made.
+     *
+     * 'expires' field will be converted to ISO8601 format from COOKIE format,
+     * 'domain' and 'path' will be set from setter URL if empty.
+     *
+     * @param array    $cookie cookie data, as returned by
+     *                         {@link HTTP_Request2_Response::getCookies()}
+     * @param Net_URL2 $setter URL of the document that sent Set-Cookie header
+     *
+     * @return   array    Updated cookie array
+     * @throws   HTTP_Request2_LogicException
+     * @throws   HTTP_Request2_MessageException
+     */
+    protected function checkAndUpdateFields(array $cookie, Net_URL2 $setter = null)
+    {
+        if ($missing = array_diff(array('name', 'value'), array_keys($cookie))) {
+            throw new HTTP_Request2_LogicException(
+                "Cookie array should contain 'name' and 'value' fields",
+                HTTP_Request2_Exception::MISSING_VALUE
+            );
+        }
+        if (preg_match(HTTP_Request2::REGEXP_INVALID_COOKIE, $cookie['name'])) {
+            throw new HTTP_Request2_LogicException(
+                "Invalid cookie name: '{$cookie['name']}'",
+                HTTP_Request2_Exception::INVALID_ARGUMENT
+            );
+        }
+        if (preg_match(HTTP_Request2::REGEXP_INVALID_COOKIE, $cookie['value'])) {
+            throw new HTTP_Request2_LogicException(
+                "Invalid cookie value: '{$cookie['value']}'",
+                HTTP_Request2_Exception::INVALID_ARGUMENT
+            );
+        }
+        $cookie += array('domain' => '', 'path' => '', 'expires' => null, 'secure' => false);
+
+        // Need ISO-8601 date @ UTC timezone
+        if (!empty($cookie['expires'])
+            && !preg_match('/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\+0000$/', $cookie['expires'])
+        ) {
+            try {
+                $dt = new DateTime($cookie['expires']);
+                $dt->setTimezone(new DateTimeZone('UTC'));
+                $cookie['expires'] = $dt->format(DateTime::ISO8601);
+            } catch (Exception $e) {
+                throw new HTTP_Request2_LogicException($e->getMessage());
+            }
+        }
+
+        if (empty($cookie['domain']) || empty($cookie['path'])) {
+            if (!$setter) {
+                throw new HTTP_Request2_LogicException(
+                    'Cookie misses domain and/or path component, cookie setter URL needed',
+                    HTTP_Request2_Exception::MISSING_VALUE
+                );
+            }
+            if (empty($cookie['domain'])) {
+                if ($host = $setter->getHost()) {
+                    $cookie['domain'] = $host;
+                } else {
+                    throw new HTTP_Request2_LogicException(
+                        'Setter URL does not contain host part, can\'t set cookie domain',
+                        HTTP_Request2_Exception::MISSING_VALUE
+                    );
+                }
+            }
+            if (empty($cookie['path'])) {
+                $path = $setter->getPath();
+                $cookie['path'] = empty($path)? '/': substr($path, 0, strrpos($path, '/') + 1);
+            }
+        }
+
+        if ($setter && !$this->domainMatch($setter->getHost(), $cookie['domain'])) {
+            throw new HTTP_Request2_MessageException(
+                "Domain " . $setter->getHost() . " cannot set cookies for "
+                . $cookie['domain']
+            );
+        }
+
+        return $cookie;
+    }
+
+    /**
+     * Stores a cookie in the jar
+     *
+     * @param array    $cookie cookie data, as returned by
+     *                         {@link HTTP_Request2_Response::getCookies()}
+     * @param Net_URL2 $setter URL of the document that sent Set-Cookie header
+     *
+     * @return bool whether the cookie was successfully stored
+     * @throws HTTP_Request2_Exception
+     */
+    public function store(array $cookie, Net_URL2 $setter = null)
+    {
+        try {
+            $cookie = $this->checkAndUpdateFields($cookie, $setter);
+        } catch (HTTP_Request2_Exception $e) {
+            if ($this->ignoreInvalid) {
+                return false;
+            } else {
+                throw $e;
+            }
+        }
+
+        if (strlen($cookie['value'])
+            && (is_null($cookie['expires']) || $cookie['expires'] > $this->now())
+        ) {
+            if (!isset($this->cookies[$cookie['domain']])) {
+                $this->cookies[$cookie['domain']] = array();
+            }
+            if (!isset($this->cookies[$cookie['domain']][$cookie['path']])) {
+                $this->cookies[$cookie['domain']][$cookie['path']] = array();
+            }
+            $this->cookies[$cookie['domain']][$cookie['path']][$cookie['name']] = $cookie;
+
+        } elseif (isset($this->cookies[$cookie['domain']][$cookie['path']][$cookie['name']])) {
+            unset($this->cookies[$cookie['domain']][$cookie['path']][$cookie['name']]);
+        }
+
+        return true;
+    }
+
+    /**
+     * Adds cookies set in HTTP response to the jar
+     *
+     * @param HTTP_Request2_Response $response HTTP response message
+     * @param Net_URL2               $setter   original request URL, needed for
+     *                               setting default domain/path. If not given,
+     *                               effective URL from response will be used.
+     *
+     * @return bool whether all cookies were successfully stored
+     * @throws HTTP_Request2_LogicException
+     */
+    public function addCookiesFromResponse(HTTP_Request2_Response $response, Net_URL2 $setter = null)
+    {
+        if (null === $setter) {
+            if (!($effectiveUrl = $response->getEffectiveUrl())) {
+                throw new HTTP_Request2_LogicException(
+                    'Response URL required for adding cookies from response',
+                    HTTP_Request2_Exception::MISSING_VALUE
+                );
+            }
+            $setter = new Net_URL2($effectiveUrl);
+        }
+
+        $success = true;
+        foreach ($response->getCookies() as $cookie) {
+            $success = $this->store($cookie, $setter) && $success;
+        }
+        return $success;
+    }
+
+    /**
+     * Returns all cookies matching a given request URL
+     *
+     * The following checks are made:
+     *   - cookie domain should match request host
+     *   - cookie path should be a prefix for request path
+     *   - 'secure' cookies will only be sent for HTTPS requests
+     *
+     * @param Net_URL2 $url      Request url
+     * @param bool     $asString Whether to return cookies as string for "Cookie: " header
+     *
+     * @return array|string Matching cookies
+     */
+    public function getMatching(Net_URL2 $url, $asString = false)
+    {
+        $host   = $url->getHost();
+        $path   = $url->getPath();
+        $secure = 0 == strcasecmp($url->getScheme(), 'https');
+
+        $matched = $ret = array();
+        foreach (array_keys($this->cookies) as $domain) {
+            if ($this->domainMatch($host, $domain)) {
+                foreach (array_keys($this->cookies[$domain]) as $cPath) {
+                    if (0 === strpos($path, $cPath)) {
+                        foreach ($this->cookies[$domain][$cPath] as $name => $cookie) {
+                            if (!$cookie['secure'] || $secure) {
+                                $matched[$name][strlen($cookie['path'])] = $cookie;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        foreach ($matched as $cookies) {
+            krsort($cookies);
+            $ret = array_merge($ret, $cookies);
+        }
+        if (!$asString) {
+            return $ret;
+        } else {
+            $str = '';
+            foreach ($ret as $c) {
+                $str .= (empty($str)? '': '; ') . $c['name'] . '=' . $c['value'];
+            }
+            return $str;
+        }
+    }
+
+    /**
+     * Returns all cookies stored in a jar
+     *
+     * @return array
+     */
+    public function getAll()
+    {
+        $cookies = array();
+        foreach (array_keys($this->cookies) as $domain) {
+            foreach (array_keys($this->cookies[$domain]) as $path) {
+                foreach ($this->cookies[$domain][$path] as $name => $cookie) {
+                    $cookies[] = $cookie;
+                }
+            }
+        }
+        return $cookies;
+    }
+
+    /**
+     * Sets whether session cookies should be serialized when serializing the jar
+     *
+     * @param boolean $serialize serialize?
+     */
+    public function serializeSessionCookies($serialize)
+    {
+        $this->serializeSession = (bool)$serialize;
+    }
+
+    /**
+     * Sets whether invalid cookies should be silently ignored or cause an Exception
+     *
+     * @param boolean $ignore ignore?
+     * @link http://pear.php.net/bugs/bug.php?id=19937
+     * @link http://pear.php.net/bugs/bug.php?id=20401
+     */
+    public function ignoreInvalidCookies($ignore)
+    {
+        $this->ignoreInvalid = (bool)$ignore;
+    }
+
+    /**
+     * Sets whether Public Suffix List should be used for restricting cookie-setting
+     *
+     * Without PSL {@link domainMatch()} will only prevent setting cookies for
+     * top-level domains like '.com' or '.org'. However, it will not prevent
+     * setting a cookie for '.co.uk' even though only third-level registrations
+     * are possible in .uk domain.
+     *
+     * With the List it is possible to find the highest level at which a domain
+     * may be registered for a particular top-level domain and consequently
+     * prevent cookies set for '.co.uk' or '.msk.ru'. The same list is used by
+     * Firefox, Chrome and Opera browsers to restrict cookie setting.
+     *
+     * Note that PSL is licensed differently to HTTP_Request2 package (refer to
+     * the license information in public-suffix-list.php), so you can disable
+     * its use if this is an issue for you.
+     *
+     * @param boolean $useList use the list?
+     *
+     * @link     http://publicsuffix.org/learn/
+     */
+    public function usePublicSuffixList($useList)
+    {
+        $this->useList = (bool)$useList;
+    }
+
+    /**
+     * Returns string representation of object
+     *
+     * @return string
+     *
+     * @see    Serializable::serialize()
+     */
+    public function serialize()
+    {
+        $cookies = $this->getAll();
+        if (!$this->serializeSession) {
+            for ($i = count($cookies) - 1; $i >= 0; $i--) {
+                if (empty($cookies[$i]['expires'])) {
+                    unset($cookies[$i]);
+                }
+            }
+        }
+        return serialize(array(
+            'cookies'          => $cookies,
+            'serializeSession' => $this->serializeSession,
+            'useList'          => $this->useList,
+            'ignoreInvalid'    => $this->ignoreInvalid
+        ));
+    }
+
+    /**
+     * Constructs the object from serialized string
+     *
+     * @param string $serialized string representation
+     *
+     * @see   Serializable::unserialize()
+     */
+    public function unserialize($serialized)
+    {
+        $data = unserialize($serialized);
+        $now  = $this->now();
+        $this->serializeSessionCookies($data['serializeSession']);
+        $this->usePublicSuffixList($data['useList']);
+        if (array_key_exists('ignoreInvalid', $data)) {
+            $this->ignoreInvalidCookies($data['ignoreInvalid']);
+        }
+        foreach ($data['cookies'] as $cookie) {
+            if (!empty($cookie['expires']) && $cookie['expires'] <= $now) {
+                continue;
+            }
+            if (!isset($this->cookies[$cookie['domain']])) {
+                $this->cookies[$cookie['domain']] = array();
+            }
+            if (!isset($this->cookies[$cookie['domain']][$cookie['path']])) {
+                $this->cookies[$cookie['domain']][$cookie['path']] = array();
+            }
+            $this->cookies[$cookie['domain']][$cookie['path']][$cookie['name']] = $cookie;
+        }
+    }
+
+    /**
+     * Checks whether a cookie domain matches a request host.
+     *
+     * The method is used by {@link store()} to check for whether a document
+     * at given URL can set a cookie with a given domain attribute and by
+     * {@link getMatching()} to find cookies matching the request URL.
+     *
+     * @param string $requestHost  request host
+     * @param string $cookieDomain cookie domain
+     *
+     * @return   bool    match success
+     */
+    public function domainMatch($requestHost, $cookieDomain)
+    {
+        if ($requestHost == $cookieDomain) {
+            return true;
+        }
+        // IP address, we require exact match
+        if (preg_match('/^(?:\d{1,3}\.){3}\d{1,3}$/', $requestHost)) {
+            return false;
+        }
+        if ('.' != $cookieDomain[0]) {
+            $cookieDomain = '.' . $cookieDomain;
+        }
+        // prevents setting cookies for '.com' and similar domains
+        if (!$this->useList && substr_count($cookieDomain, '.') < 2
+            || $this->useList && !self::getRegisteredDomain($cookieDomain)
+        ) {
+            return false;
+        }
+        return substr('.' . $requestHost, -strlen($cookieDomain)) == $cookieDomain;
+    }
+
+    /**
+     * Removes subdomains to get the registered domain (the first after top-level)
+     *
+     * The method will check Public Suffix List to find out where top-level
+     * domain ends and registered domain starts. It will remove domain parts
+     * to the left of registered one.
+     *
+     * @param string $domain domain name
+     *
+     * @return string|bool   registered domain, will return false if $domain is
+     *                       either invalid or a TLD itself
+     */
+    public static function getRegisteredDomain($domain)
+    {
+        $domainParts = explode('.', ltrim($domain, '.'));
+
+        // load the list if needed
+        if (empty(self::$psl)) {
+            $path = '@data_dir@' . DIRECTORY_SEPARATOR . 'HTTP_Request2';
+            if (0 === strpos($path, '@' . 'data_dir@')) {
+                $path = realpath(
+                    dirname(__FILE__) . DIRECTORY_SEPARATOR . '..'
+                    . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'data'
+                );
+            }
+            self::$psl = include_once $path . DIRECTORY_SEPARATOR . 'public-suffix-list.php';
+        }
+
+        if (!($result = self::checkDomainsList($domainParts, self::$psl))) {
+            // known TLD, invalid domain name
+            return false;
+        }
+
+        // unknown TLD
+        if (!strpos($result, '.')) {
+            // fallback to checking that domain "has at least two dots"
+            if (2 > ($count = count($domainParts))) {
+                return false;
+            }
+            return $domainParts[$count - 2] . '.' . $domainParts[$count - 1];
+        }
+        return $result;
+    }
+
+    /**
+     * Recursive helper method for {@link getRegisteredDomain()}
+     *
+     * @param array $domainParts remaining domain parts
+     * @param mixed $listNode    node in {@link HTTP_Request2_CookieJar::$psl} to check
+     *
+     * @return string|null   concatenated domain parts, null in case of error
+     */
+    protected static function checkDomainsList(array $domainParts, $listNode)
+    {
+        $sub    = array_pop($domainParts);
+        $result = null;
+
+        if (!is_array($listNode) || is_null($sub)
+            || array_key_exists('!' . $sub, $listNode)
+        ) {
+            return $sub;
+
+        } elseif (array_key_exists($sub, $listNode)) {
+            $result = self::checkDomainsList($domainParts, $listNode[$sub]);
+
+        } elseif (array_key_exists('*', $listNode)) {
+            $result = self::checkDomainsList($domainParts, $listNode['*']);
+
+        } else {
+            return $sub;
+        }
+
+        return (strlen($result) > 0) ? ($result . '.' . $sub) : null;
+    }
+}
+?>

bundled-libs/HTTP/Request2/Exception.php

@@ -0,0 +1,160 @@
+<?php
+/**
+ * Exception classes for HTTP_Request2 package
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/**
+ * Base class for exceptions in PEAR
+ */
+require_once 'PEAR/Exception.php';
+
+/**
+ * Base exception class for HTTP_Request2 package
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ * @link     http://pear.php.net/pepr/pepr-proposal-show.php?id=132
+ */
+class HTTP_Request2_Exception extends PEAR_Exception
+{
+    /** An invalid argument was passed to a method */
+    const INVALID_ARGUMENT   = 1;
+    /** Some required value was not available */
+    const MISSING_VALUE      = 2;
+    /** Request cannot be processed due to errors in PHP configuration */
+    const MISCONFIGURATION   = 3;
+    /** Error reading the local file */
+    const READ_ERROR         = 4;
+
+    /** Server returned a response that does not conform to HTTP protocol */
+    const MALFORMED_RESPONSE = 10;
+    /** Failure decoding Content-Encoding or Transfer-Encoding of response */
+    const DECODE_ERROR       = 20;
+    /** Operation timed out */
+    const TIMEOUT            = 30;
+    /** Number of redirects exceeded 'max_redirects' configuration parameter */
+    const TOO_MANY_REDIRECTS = 40;
+    /** Redirect to a protocol other than http(s):// */
+    const NON_HTTP_REDIRECT  = 50;
+
+    /**
+     * Native error code
+     * @var int
+     */
+    private $_nativeCode;
+
+    /**
+     * Constructor, can set package error code and native error code
+     *
+     * @param string $message    exception message
+     * @param int    $code       package error code, one of class constants
+     * @param int    $nativeCode error code from underlying PHP extension
+     */
+    public function __construct($message = null, $code = null, $nativeCode = null)
+    {
+        parent::__construct($message, $code);
+        $this->_nativeCode = $nativeCode;
+    }
+
+    /**
+     * Returns error code produced by underlying PHP extension
+     *
+     * For Socket Adapter this may contain error number returned by
+     * stream_socket_client(), for Curl Adapter this will contain error number
+     * returned by curl_errno()
+     *
+     * @return integer
+     */
+    public function getNativeCode()
+    {
+        return $this->_nativeCode;
+    }
+}
+
+/**
+ * Exception thrown in case of missing features
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+class HTTP_Request2_NotImplementedException extends HTTP_Request2_Exception
+{
+}
+
+/**
+ * Exception that represents error in the program logic
+ *
+ * This exception usually implies a programmer's error, like passing invalid
+ * data to methods or trying to use PHP extensions that weren't installed or
+ * enabled. Usually exceptions of this kind will be thrown before request even
+ * starts.
+ *
+ * The exception will usually contain a package error code.
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+class HTTP_Request2_LogicException extends HTTP_Request2_Exception
+{
+}
+
+/**
+ * Exception thrown when connection to a web or proxy server fails
+ *
+ * The exception will not contain a package error code, but will contain
+ * native error code, as returned by stream_socket_client() or curl_errno().
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+class HTTP_Request2_ConnectionException extends HTTP_Request2_Exception
+{
+}
+
+/**
+ * Exception thrown when sending or receiving HTTP message fails
+ *
+ * The exception may contain both package error code and native error code.
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+class HTTP_Request2_MessageException extends HTTP_Request2_Exception
+{
+}
+?>

bundled-libs/HTTP/Request2/MultipartBody.php

@@ -0,0 +1,268 @@
+<?php
+/**
+ * Helper class for building multipart/form-data request body
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/** Exception class for HTTP_Request2 package */
+require_once 'HTTP/Request2/Exception.php';
+
+/**
+ * Class for building multipart/form-data request body
+ *
+ * The class helps to reduce memory consumption by streaming large file uploads
+ * from disk, it also allows monitoring of upload progress (see request #7630)
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ * @link     http://tools.ietf.org/html/rfc1867
+ */
+class HTTP_Request2_MultipartBody
+{
+    /**
+     * MIME boundary
+     * @var  string
+     */
+    private $_boundary;
+
+    /**
+     * Form parameters added via {@link HTTP_Request2::addPostParameter()}
+     * @var  array
+     */
+    private $_params = array();
+
+    /**
+     * File uploads added via {@link HTTP_Request2::addUpload()}
+     * @var  array
+     */
+    private $_uploads = array();
+
+    /**
+     * Header for parts with parameters
+     * @var  string
+     */
+    private $_headerParam = "--%s\r\nContent-Disposition: form-data; name=\"%s\"\r\n\r\n";
+
+    /**
+     * Header for parts with uploads
+     * @var  string
+     */
+    private $_headerUpload = "--%s\r\nContent-Disposition: form-data; name=\"%s\"; filename=\"%s\"\r\nContent-Type: %s\r\n\r\n";
+
+    /**
+     * Current position in parameter and upload arrays
+     *
+     * First number is index of "current" part, second number is position within
+     * "current" part
+     *
+     * @var  array
+     */
+    private $_pos = array(0, 0);
+
+
+    /**
+     * Constructor. Sets the arrays with POST data.
+     *
+     * @param array $params      values of form fields set via
+     *                           {@link HTTP_Request2::addPostParameter()}
+     * @param array $uploads     file uploads set via
+     *                           {@link HTTP_Request2::addUpload()}
+     * @param bool  $useBrackets whether to append brackets to array variable names
+     */
+    public function __construct(array $params, array $uploads, $useBrackets = true)
+    {
+        $this->_params = self::_flattenArray('', $params, $useBrackets);
+        foreach ($uploads as $fieldName => $f) {
+            if (!is_array($f['fp'])) {
+                $this->_uploads[] = $f + array('name' => $fieldName);
+            } else {
+                for ($i = 0; $i < count($f['fp']); $i++) {
+                    $upload = array(
+                        'name' => ($useBrackets? $fieldName . '[' . $i . ']': $fieldName)
+                    );
+                    foreach (array('fp', 'filename', 'size', 'type') as $key) {
+                        $upload[$key] = $f[$key][$i];
+                    }
+                    $this->_uploads[] = $upload;
+                }
+            }
+        }
+    }
+
+    /**
+     * Returns the length of the body to use in Content-Length header
+     *
+     * @return   integer
+     */
+    public function getLength()
+    {
+        $boundaryLength     = strlen($this->getBoundary());
+        $headerParamLength  = strlen($this->_headerParam) - 4 + $boundaryLength;
+        $headerUploadLength = strlen($this->_headerUpload) - 8 + $boundaryLength;
+        $length             = $boundaryLength + 6;
+        foreach ($this->_params as $p) {
+            $length += $headerParamLength + strlen($p[0]) + strlen($p[1]) + 2;
+        }
+        foreach ($this->_uploads as $u) {
+            $length += $headerUploadLength + strlen($u['name']) + strlen($u['type']) +
+                       strlen($u['filename']) + $u['size'] + 2;
+        }
+        return $length;
+    }
+
+    /**
+     * Returns the boundary to use in Content-Type header
+     *
+     * @return   string
+     */
+    public function getBoundary()
+    {
+        if (empty($this->_boundary)) {
+            $this->_boundary = '--' . md5('PEAR-HTTP_Request2-' . microtime());
+        }
+        return $this->_boundary;
+    }
+
+    /**
+     * Returns next chunk of request body
+     *
+     * @param integer $length Number of bytes to read
+     *
+     * @return   string  Up to $length bytes of data, empty string if at end
+     * @throws   HTTP_Request2_LogicException
+     */
+    public function read($length)
+    {
+        $ret         = '';
+        $boundary    = $this->getBoundary();
+        $paramCount  = count($this->_params);
+        $uploadCount = count($this->_uploads);
+        while ($length > 0 && $this->_pos[0] <= $paramCount + $uploadCount) {
+            $oldLength = $length;
+            if ($this->_pos[0] < $paramCount) {
+                $param = sprintf(
+                    $this->_headerParam, $boundary, $this->_params[$this->_pos[0]][0]
+                ) . $this->_params[$this->_pos[0]][1] . "\r\n";
+                $ret    .= substr($param, $this->_pos[1], $length);
+                $length -= min(strlen($param) - $this->_pos[1], $length);
+
+            } elseif ($this->_pos[0] < $paramCount + $uploadCount) {
+                $pos    = $this->_pos[0] - $paramCount;
+                $header = sprintf(
+                    $this->_headerUpload, $boundary, $this->_uploads[$pos]['name'],
+                    $this->_uploads[$pos]['filename'], $this->_uploads[$pos]['type']
+                );
+                if ($this->_pos[1] < strlen($header)) {
+                    $ret    .= substr($header, $this->_pos[1], $length);
+                    $length -= min(strlen($header) - $this->_pos[1], $length);
+                }
+                $filePos  = max(0, $this->_pos[1] - strlen($header));
+                if ($filePos < $this->_uploads[$pos]['size']) {
+                    while ($length > 0 && !feof($this->_uploads[$pos]['fp'])) {
+                        if (false === ($chunk = fread($this->_uploads[$pos]['fp'], $length))) {
+                            throw new HTTP_Request2_LogicException(
+                                'Failed reading file upload', HTTP_Request2_Exception::READ_ERROR
+                            );
+                        }
+                        $ret    .= $chunk;
+                        $length -= strlen($chunk);
+                    }
+                }
+                if ($length > 0) {
+                    $start   = $this->_pos[1] + ($oldLength - $length) -
+                               strlen($header) - $this->_uploads[$pos]['size'];
+                    $ret    .= substr("\r\n", $start, $length);
+                    $length -= min(2 - $start, $length);
+                }
+
+            } else {
+                $closing  = '--' . $boundary . "--\r\n";
+                $ret     .= substr($closing, $this->_pos[1], $length);
+                $length  -= min(strlen($closing) - $this->_pos[1], $length);
+            }
+            if ($length > 0) {
+                $this->_pos     = array($this->_pos[0] + 1, 0);
+            } else {
+                $this->_pos[1] += $oldLength;
+            }
+        }
+        return $ret;
+    }
+
+    /**
+     * Sets the current position to the start of the body
+     *
+     * This allows reusing the same body in another request
+     */
+    public function rewind()
+    {
+        $this->_pos = array(0, 0);
+        foreach ($this->_uploads as $u) {
+            rewind($u['fp']);
+        }
+    }
+
+    /**
+     * Returns the body as string
+     *
+     * Note that it reads all file uploads into memory so it is a good idea not
+     * to use this method with large file uploads and rely on read() instead.
+     *
+     * @return   string
+     */
+    public function __toString()
+    {
+        $this->rewind();
+        return $this->read($this->getLength());
+    }
+
+
+    /**
+     * Helper function to change the (probably multidimensional) associative array
+     * into the simple one.
+     *
+     * @param string $name        name for item
+     * @param mixed  $values      item's values
+     * @param bool   $useBrackets whether to append [] to array variables' names
+     *
+     * @return   array   array with the following items: array('item name', 'item value');
+     */
+    private static function _flattenArray($name, $values, $useBrackets)
+    {
+        if (!is_array($values)) {
+            return array(array($name, $values));
+        } else {
+            $ret = array();
+            foreach ($values as $k => $v) {
+                if (empty($name)) {
+                    $newName = $k;
+                } elseif ($useBrackets) {
+                    $newName = $name . '[' . $k . ']';
+                } else {
+                    $newName = $name;
+                }
+                $ret = array_merge($ret, self::_flattenArray($newName, $v, $useBrackets));
+            }
+            return $ret;
+        }
+    }
+}
+?>

bundled-libs/HTTP/Request2/Observer/Log.php

@@ -0,0 +1,192 @@
+<?php
+/**
+ * An observer useful for debugging / testing.
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    David Jean Louis <izi@php.net>
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/**
+ * Exception class for HTTP_Request2 package
+ */
+require_once 'HTTP/Request2/Exception.php';
+
+/**
+ * A debug observer useful for debugging / testing.
+ *
+ * This observer logs to a log target data corresponding to the various request
+ * and response events, it logs by default to php://output but can be configured
+ * to log to a file or via the PEAR Log package.
+ *
+ * A simple example:
+ * <code>
+ * require_once 'HTTP/Request2.php';
+ * require_once 'HTTP/Request2/Observer/Log.php';
+ *
+ * $request  = new HTTP_Request2('http://www.example.com');
+ * $observer = new HTTP_Request2_Observer_Log();
+ * $request->attach($observer);
+ * $request->send();
+ * </code>
+ *
+ * A more complex example with PEAR Log:
+ * <code>
+ * require_once 'HTTP/Request2.php';
+ * require_once 'HTTP/Request2/Observer/Log.php';
+ * require_once 'Log.php';
+ *
+ * $request  = new HTTP_Request2('http://www.example.com');
+ * // we want to log with PEAR log
+ * $observer = new HTTP_Request2_Observer_Log(Log::factory('console'));
+ *
+ * // we only want to log received headers
+ * $observer->events = array('receivedHeaders');
+ *
+ * $request->attach($observer);
+ * $request->send();
+ * </code>
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   David Jean Louis <izi@php.net>
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+class HTTP_Request2_Observer_Log implements SplObserver
+{
+    // properties {{{
+
+    /**
+     * The log target, it can be a a resource or a PEAR Log instance.
+     *
+     * @var resource|Log $target
+     */
+    protected $target = null;
+
+    /**
+     * The events to log.
+     *
+     * @var array $events
+     */
+    public $events = array(
+        'connect',
+        'sentHeaders',
+        'sentBody',
+        'receivedHeaders',
+        'receivedBody',
+        'disconnect',
+    );
+
+    // }}}
+    // __construct() {{{
+
+    /**
+     * Constructor.
+     *
+     * @param mixed $target Can be a file path (default: php://output), a resource,
+     *                      or an instance of the PEAR Log class.
+     * @param array $events Array of events to listen to (default: all events)
+     *
+     * @return void
+     */
+    public function __construct($target = 'php://output', array $events = array())
+    {
+        if (!empty($events)) {
+            $this->events = $events;
+        }
+        if (is_resource($target) || $target instanceof Log) {
+            $this->target = $target;
+        } elseif (false === ($this->target = @fopen($target, 'ab'))) {
+            throw new HTTP_Request2_Exception("Unable to open '{$target}'");
+        }
+    }
+
+    // }}}
+    // update() {{{
+
+    /**
+     * Called when the request notifies us of an event.
+     *
+     * @param HTTP_Request2 $subject The HTTP_Request2 instance
+     *
+     * @return void
+     */
+    public function update(SplSubject $subject)
+    {
+        $event = $subject->getLastEvent();
+        if (!in_array($event['name'], $this->events)) {
+            return;
+        }
+
+        switch ($event['name']) {
+        case 'connect':
+            $this->log('* Connected to ' . $event['data']);
+            break;
+        case 'sentHeaders':
+            $headers = explode("\r\n", $event['data']);
+            array_pop($headers);
+            foreach ($headers as $header) {
+                $this->log('> ' . $header);
+            }
+            break;
+        case 'sentBody':
+            $this->log('> ' . $event['data'] . ' byte(s) sent');
+            break;
+        case 'receivedHeaders':
+            $this->log(sprintf(
+                '< HTTP/%s %s %s', $event['data']->getVersion(),
+                $event['data']->getStatus(), $event['data']->getReasonPhrase()
+            ));
+            $headers = $event['data']->getHeader();
+            foreach ($headers as $key => $val) {
+                $this->log('< ' . $key . ': ' . $val);
+            }
+            $this->log('< ');
+            break;
+        case 'receivedBody':
+            $this->log($event['data']->getBody());
+            break;
+        case 'disconnect':
+            $this->log('* Disconnected');
+            break;
+        }
+    }
+
+    // }}}
+    // log() {{{
+
+    /**
+     * Logs the given message to the configured target.
+     *
+     * @param string $message Message to display
+     *
+     * @return void
+     */
+    protected function log($message)
+    {
+        if ($this->target instanceof Log) {
+            $this->target->debug($message);
+        } elseif (is_resource($this->target)) {
+            fwrite($this->target, $message . "\r\n");
+        }
+    }
+
+    // }}}
+}
+
+?>

bundled-libs/HTTP/Request2/Observer/UncompressingDownload.php

@@ -0,0 +1,265 @@
+<?php
+/**
+ * An observer that saves response body to stream, possibly uncompressing it
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Delian Krustev <krustev@krustev.net>
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+require_once 'HTTP/Request2/Response.php';
+
+/**
+ * An observer that saves response body to stream, possibly uncompressing it
+ *
+ * This Observer is written in compliment to pear's HTTP_Request2 in order to
+ * avoid reading the whole response body in memory. Instead it writes the body
+ * to a stream. If the body is transferred with content-encoding set to
+ * "deflate" or "gzip" it is decoded on the fly.
+ *
+ * The constructor accepts an already opened (for write) stream (file_descriptor).
+ * If the response is deflate/gzip encoded a "zlib.inflate" filter is applied
+ * to the stream. When the body has been read from the request and written to
+ * the stream ("receivedBody" event) the filter is removed from the stream.
+ *
+ * The "zlib.inflate" filter works fine with pure "deflate" encoding. It does
+ * not understand the "deflate+zlib" and "gzip" headers though, so they have to
+ * be removed prior to being passed to the stream. This is done in the "update"
+ * method.
+ *
+ * It is also possible to limit the size of written extracted bytes by passing
+ * "max_bytes" to the constructor. This is important because e.g. 1GB of
+ * zeroes take about a MB when compressed.
+ *
+ * Exceptions are being thrown if data could not be written to the stream or
+ * the written bytes have already exceeded the requested maximum. If the "gzip"
+ * header is malformed or could not be parsed an exception will be thrown too.
+ *
+ * Example usage follows:
+ *
+ * <code>
+ * require_once 'HTTP/Request2.php';
+ * require_once 'HTTP/Request2/Observer/UncompressingDownload.php';
+ *
+ * #$inPath = 'http://carsten.codimi.de/gzip.yaws/daniels.html';
+ * #$inPath = 'http://carsten.codimi.de/gzip.yaws/daniels.html?deflate=on';
+ * $inPath = 'http://carsten.codimi.de/gzip.yaws/daniels.html?deflate=on&zlib=on';
+ * #$outPath = "/dev/null";
+ * $outPath = "delme";
+ *
+ * $stream = fopen($outPath, 'wb');
+ * if (!$stream) {
+ *     throw new Exception('fopen failed');
+ * }
+ *
+ * $request = new HTTP_Request2(
+ *     $inPath,
+ *     HTTP_Request2::METHOD_GET,
+ *     array(
+ *         'store_body'        => false,
+ *         'connect_timeout'   => 5,
+ *         'timeout'           => 10,
+ *         'ssl_verify_peer'   => true,
+ *         'ssl_verify_host'   => true,
+ *         'ssl_cafile'        => null,
+ *         'ssl_capath'        => '/etc/ssl/certs',
+ *         'max_redirects'     => 10,
+ *         'follow_redirects'  => true,
+ *         'strict_redirects'  => false
+ *     )
+ * );
+ *
+ * $observer = new HTTP_Request2_Observer_UncompressingDownload($stream, 9999999);
+ * $request->attach($observer);
+ *
+ * $response = $request->send();
+ *
+ * fclose($stream);
+ * echo "OK\n";
+ * </code>
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Delian Krustev <krustev@krustev.net>
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ */
+class HTTP_Request2_Observer_UncompressingDownload implements SplObserver
+{
+    /**
+     * The stream to write response body to
+     * @var resource
+     */
+    private $_stream;
+
+    /**
+     * zlib.inflate filter possibly added to stream
+     * @var resource
+     */
+    private $_streamFilter;
+
+    /**
+     * The value of response's Content-Encoding header
+     * @var string
+     */
+    private $_encoding;
+
+    /**
+     * Whether the observer is still waiting for gzip/deflate header
+     * @var bool
+     */
+    private $_processingHeader = true;
+
+    /**
+     * Starting position in the stream observer writes to
+     * @var int
+     */
+    private $_startPosition = 0;
+
+    /**
+     * Maximum bytes to write
+     * @var int|null
+     */
+    private $_maxDownloadSize;
+
+    /**
+     * Whether response being received is a redirect
+     * @var bool
+     */
+    private $_redirect = false;
+
+    /**
+     * Accumulated body chunks that may contain (gzip) header
+     * @var string
+     */
+    private $_possibleHeader = '';
+
+    /**
+     * Class constructor
+     *
+     * Note that there might be problems with max_bytes and files bigger
+     * than 2 GB on 32bit platforms
+     *
+     * @param resource $stream          a stream (or file descriptor) opened for writing.
+     * @param int      $maxDownloadSize maximum bytes to write
+     */
+    public function __construct($stream, $maxDownloadSize = null)
+    {
+        $this->_stream = $stream;
+        if ($maxDownloadSize) {
+            $this->_maxDownloadSize = $maxDownloadSize;
+            $this->_startPosition   = ftell($this->_stream);
+        }
+    }
+
+    /**
+     * Called when the request notifies us of an event.
+     *
+     * @param SplSubject $request The HTTP_Request2 instance
+     *
+     * @return void
+     * @throws HTTP_Request2_MessageException
+     */
+    public function update(SplSubject $request)
+    {
+        /* @var $request HTTP_Request2 */
+        $event   = $request->getLastEvent();
+        $encoded = false;
+
+        /* @var $event['data'] HTTP_Request2_Response */
+        switch ($event['name']) {
+        case 'receivedHeaders':
+            $this->_processingHeader = true;
+            $this->_redirect = $event['data']->isRedirect();
+            $this->_encoding = strtolower($event['data']->getHeader('content-encoding'));
+            $this->_possibleHeader = '';
+            break;
+
+        case 'receivedEncodedBodyPart':
+            if (!$this->_streamFilter
+                && ($this->_encoding === 'deflate' || $this->_encoding === 'gzip')
+            ) {
+                $this->_streamFilter = stream_filter_append(
+                    $this->_stream, 'zlib.inflate', STREAM_FILTER_WRITE
+                );
+            }
+            $encoded = true;
+            // fall-through is intentional
+
+        case 'receivedBodyPart':
+            if ($this->_redirect) {
+                break;
+            }
+
+            if (!$encoded || !$this->_processingHeader) {
+                $bytes = fwrite($this->_stream, $event['data']);
+
+            } else {
+                $offset = 0;
+                $this->_possibleHeader .= $event['data'];
+                if ('deflate' === $this->_encoding) {
+                    if (2 > strlen($this->_possibleHeader)) {
+                        break;
+                    }
+                    $header = unpack('n', substr($this->_possibleHeader, 0, 2));
+                    if (0 == $header[1] % 31) {
+                        $offset = 2;
+                    }
+
+                } elseif ('gzip' === $this->_encoding) {
+                    if (10 > strlen($this->_possibleHeader)) {
+                        break;
+                    }
+                    try {
+                        $offset = HTTP_Request2_Response::parseGzipHeader($this->_possibleHeader, false);
+
+                    } catch (HTTP_Request2_MessageException $e) {
+                        // need more data?
+                        if (false !== strpos($e->getMessage(), 'data too short')) {
+                            break;
+                        }
+                        throw $e;
+                    }
+                }
+
+                $this->_processingHeader = false;
+                $bytes = fwrite($this->_stream, substr($this->_possibleHeader, $offset));
+            }
+
+            if (false === $bytes) {
+                throw new HTTP_Request2_MessageException('fwrite failed.');
+            }
+
+            if ($this->_maxDownloadSize
+                && ftell($this->_stream) - $this->_startPosition > $this->_maxDownloadSize
+            ) {
+                throw new HTTP_Request2_MessageException(sprintf(
+                    'Body length limit (%d bytes) reached',
+                    $this->_maxDownloadSize
+                ));
+            }
+            break;
+
+        case 'receivedBody':
+            if ($this->_streamFilter) {
+                stream_filter_remove($this->_streamFilter);
+                $this->_streamFilter = null;
+            }
+            break;
+        }
+    }
+}

bundled-libs/HTTP/Request2/Response.php

@@ -0,0 +1,680 @@
+<?php
+/**
+ * Class representing a HTTP response
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/**
+ * Exception class for HTTP_Request2 package
+ */
+require_once 'HTTP/Request2/Exception.php';
+
+/**
+ * Class representing a HTTP response
+ *
+ * The class is designed to be used in "streaming" scenario, building the
+ * response as it is being received:
+ * <code>
+ * $statusLine = read_status_line();
+ * $response = new HTTP_Request2_Response($statusLine);
+ * do {
+ *     $headerLine = read_header_line();
+ *     $response->parseHeaderLine($headerLine);
+ * } while ($headerLine != '');
+ *
+ * while ($chunk = read_body()) {
+ *     $response->appendBody($chunk);
+ * }
+ *
+ * var_dump($response->getHeader(), $response->getCookies(), $response->getBody());
+ * </code>
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ * @link     http://tools.ietf.org/html/rfc2616#section-6
+ */
+class HTTP_Request2_Response
+{
+    /**
+     * HTTP protocol version (e.g. 1.0, 1.1)
+     * @var  string
+     */
+    protected $version;
+
+    /**
+     * Status code
+     * @var  integer
+     * @link http://tools.ietf.org/html/rfc2616#section-6.1.1
+     */
+    protected $code;
+
+    /**
+     * Reason phrase
+     * @var  string
+     * @link http://tools.ietf.org/html/rfc2616#section-6.1.1
+     */
+    protected $reasonPhrase;
+
+    /**
+     * Effective URL (may be different from original request URL in case of redirects)
+     * @var  string
+     */
+    protected $effectiveUrl;
+
+    /**
+     * Associative array of response headers
+     * @var  array
+     */
+    protected $headers = array();
+
+    /**
+     * Cookies set in the response
+     * @var  array
+     */
+    protected $cookies = array();
+
+    /**
+     * Name of last header processed by parseHederLine()
+     *
+     * Used to handle the headers that span multiple lines
+     *
+     * @var  string
+     */
+    protected $lastHeader = null;
+
+    /**
+     * Response body
+     * @var  string
+     */
+    protected $body = '';
+
+    /**
+     * Whether the body is still encoded by Content-Encoding
+     *
+     * cURL provides the decoded body to the callback; if we are reading from
+     * socket the body is still gzipped / deflated
+     *
+     * @var  bool
+     */
+    protected $bodyEncoded;
+
+    /**
+     * Associative array of HTTP status code / reason phrase.
+     *
+     * @var  array
+     * @link http://tools.ietf.org/html/rfc2616#section-10
+     */
+    protected static $phrases = array(
+
+        // 1xx: Informational - Request received, continuing process
+        100 => 'Continue',
+        101 => 'Switching Protocols',
+
+        // 2xx: Success - The action was successfully received, understood and
+        // accepted
+        200 => 'OK',
+        201 => 'Created',
+        202 => 'Accepted',
+        203 => 'Non-Authoritative Information',
+        204 => 'No Content',
+        205 => 'Reset Content',
+        206 => 'Partial Content',
+
+        // 3xx: Redirection - Further action must be taken in order to complete
+        // the request
+        300 => 'Multiple Choices',
+        301 => 'Moved Permanently',
+        302 => 'Found',  // 1.1
+        303 => 'See Other',
+        304 => 'Not Modified',
+        305 => 'Use Proxy',
+        307 => 'Temporary Redirect',
+
+        // 4xx: Client Error - The request contains bad syntax or cannot be
+        // fulfilled
+        400 => 'Bad Request',
+        401 => 'Unauthorized',
+        402 => 'Payment Required',
+        403 => 'Forbidden',
+        404 => 'Not Found',
+        405 => 'Method Not Allowed',
+        406 => 'Not Acceptable',
+        407 => 'Proxy Authentication Required',
+        408 => 'Request Timeout',
+        409 => 'Conflict',
+        410 => 'Gone',
+        411 => 'Length Required',
+        412 => 'Precondition Failed',
+        413 => 'Request Entity Too Large',
+        414 => 'Request-URI Too Long',
+        415 => 'Unsupported Media Type',
+        416 => 'Requested Range Not Satisfiable',
+        417 => 'Expectation Failed',
+
+        // 5xx: Server Error - The server failed to fulfill an apparently
+        // valid request
+        500 => 'Internal Server Error',
+        501 => 'Not Implemented',
+        502 => 'Bad Gateway',
+        503 => 'Service Unavailable',
+        504 => 'Gateway Timeout',
+        505 => 'HTTP Version Not Supported',
+        509 => 'Bandwidth Limit Exceeded',
+
+    );
+
+    /**
+     * Returns the default reason phrase for the given code or all reason phrases
+     *
+     * @param int $code Response code
+     *
+     * @return string|array|null Default reason phrase for $code if $code is given
+     *                           (null if no phrase is available), array of all
+     *                           reason phrases if $code is null
+     * @link   http://pear.php.net/bugs/18716
+     */
+    public static function getDefaultReasonPhrase($code = null)
+    {
+        if (null === $code) {
+            return self::$phrases;
+        } else {
+            return isset(self::$phrases[$code]) ? self::$phrases[$code] : null;
+        }
+    }
+
+    /**
+     * Constructor, parses the response status line
+     *
+     * @param string $statusLine   Response status line (e.g. "HTTP/1.1 200 OK")
+     * @param bool   $bodyEncoded  Whether body is still encoded by Content-Encoding
+     * @param string $effectiveUrl Effective URL of the response
+     *
+     * @throws   HTTP_Request2_MessageException if status line is invalid according to spec
+     */
+    public function __construct($statusLine, $bodyEncoded = true, $effectiveUrl = null)
+    {
+        if (!preg_match('!^HTTP/(\d\.\d) (\d{3})(?: (.+))?!', $statusLine, $m)) {
+            throw new HTTP_Request2_MessageException(
+                "Malformed response: {$statusLine}",
+                HTTP_Request2_Exception::MALFORMED_RESPONSE
+            );
+        }
+        $this->version      = $m[1];
+        $this->code         = intval($m[2]);
+        $this->reasonPhrase = !empty($m[3]) ? trim($m[3]) : self::getDefaultReasonPhrase($this->code);
+        $this->bodyEncoded  = (bool)$bodyEncoded;
+        $this->effectiveUrl = (string)$effectiveUrl;
+    }
+
+    /**
+     * Parses the line from HTTP response filling $headers array
+     *
+     * The method should be called after reading the line from socket or receiving
+     * it into cURL callback. Passing an empty string here indicates the end of
+     * response headers and triggers additional processing, so be sure to pass an
+     * empty string in the end.
+     *
+     * @param string $headerLine Line from HTTP response
+     */
+    public function parseHeaderLine($headerLine)
+    {
+        $headerLine = trim($headerLine, "\r\n");
+
+        if ('' == $headerLine) {
+            // empty string signals the end of headers, process the received ones
+            if (!empty($this->headers['set-cookie'])) {
+                $cookies = is_array($this->headers['set-cookie'])?
+                           $this->headers['set-cookie']:
+                           array($this->headers['set-cookie']);
+                foreach ($cookies as $cookieString) {
+                    $this->parseCookie($cookieString);
+                }
+                unset($this->headers['set-cookie']);
+            }
+            foreach (array_keys($this->headers) as $k) {
+                if (is_array($this->headers[$k])) {
+                    $this->headers[$k] = implode(', ', $this->headers[$k]);
+                }
+            }
+
+        } elseif (preg_match('!^([^\x00-\x1f\x7f-\xff()<>@,;:\\\\"/\[\]?={}\s]+):(.+)$!', $headerLine, $m)) {
+            // string of the form header-name: header value
+            $name  = strtolower($m[1]);
+            $value = trim($m[2]);
+            if (empty($this->headers[$name])) {
+                $this->headers[$name] = $value;
+            } else {
+                if (!is_array($this->headers[$name])) {
+                    $this->headers[$name] = array($this->headers[$name]);
+                }
+                $this->headers[$name][] = $value;
+            }
+            $this->lastHeader = $name;
+
+        } elseif (preg_match('!^\s+(.+)$!', $headerLine, $m) && $this->lastHeader) {
+            // continuation of a previous header
+            if (!is_array($this->headers[$this->lastHeader])) {
+                $this->headers[$this->lastHeader] .= ' ' . trim($m[1]);
+            } else {
+                $key = count($this->headers[$this->lastHeader]) - 1;
+                $this->headers[$this->lastHeader][$key] .= ' ' . trim($m[1]);
+            }
+        }
+    }
+
+    /**
+     * Parses a Set-Cookie header to fill $cookies array
+     *
+     * @param string $cookieString value of Set-Cookie header
+     *
+     * @link     http://web.archive.org/web/20080331104521/http://cgi.netscape.com/newsref/std/cookie_spec.html
+     */
+    protected function parseCookie($cookieString)
+    {
+        $cookie = array(
+            'expires' => null,
+            'domain'  => null,
+            'path'    => null,
+            'secure'  => false
+        );
+
+        if (!strpos($cookieString, ';')) {
+            // Only a name=value pair
+            $pos = strpos($cookieString, '=');
+            $cookie['name']  = trim(substr($cookieString, 0, $pos));
+            $cookie['value'] = trim(substr($cookieString, $pos + 1));
+
+        } else {
+            // Some optional parameters are supplied
+            $elements = explode(';', $cookieString);
+            $pos = strpos($elements[0], '=');
+            $cookie['name']  = trim(substr($elements[0], 0, $pos));
+            $cookie['value'] = trim(substr($elements[0], $pos + 1));
+
+            for ($i = 1; $i < count($elements); $i++) {
+                if (false === strpos($elements[$i], '=')) {
+                    $elName  = trim($elements[$i]);
+                    $elValue = null;
+                } else {
+                    list ($elName, $elValue) = array_map('trim', explode('=', $elements[$i]));
+                }
+                $elName = strtolower($elName);
+                if ('secure' == $elName) {
+                    $cookie['secure'] = true;
+                } elseif ('expires' == $elName) {
+                    $cookie['expires'] = str_replace('"', '', $elValue);
+                } elseif ('path' == $elName || 'domain' == $elName) {
+                    $cookie[$elName] = urldecode($elValue);
+                } else {
+                    $cookie[$elName] = $elValue;
+                }
+            }
+        }
+        $this->cookies[] = $cookie;
+    }
+
+    /**
+     * Appends a string to the response body
+     *
+     * @param string $bodyChunk part of response body
+     */
+    public function appendBody($bodyChunk)
+    {
+        $this->body .= $bodyChunk;
+    }
+
+    /**
+     * Returns the effective URL of the response
+     *
+     * This may be different from the request URL if redirects were followed.
+     *
+     * @return string
+     * @link   http://pear.php.net/bugs/bug.php?id=18412
+     */
+    public function getEffectiveUrl()
+    {
+        return $this->effectiveUrl;
+    }
+
+    /**
+     * Returns the status code
+     *
+     * @return   integer
+     */
+    public function getStatus()
+    {
+        return $this->code;
+    }
+
+    /**
+     * Returns the reason phrase
+     *
+     * @return   string
+     */
+    public function getReasonPhrase()
+    {
+        return $this->reasonPhrase;
+    }
+
+    /**
+     * Whether response is a redirect that can be automatically handled by HTTP_Request2
+     *
+     * @return   bool
+     */
+    public function isRedirect()
+    {
+        return in_array($this->code, array(300, 301, 302, 303, 307))
+               && isset($this->headers['location']);
+    }
+
+    /**
+     * Returns either the named header or all response headers
+     *
+     * @param string $headerName Name of header to return
+     *
+     * @return   string|array    Value of $headerName header (null if header is
+     *                           not present), array of all response headers if
+     *                           $headerName is null
+     */
+    public function getHeader($headerName = null)
+    {
+        if (null === $headerName) {
+            return $this->headers;
+        } else {
+            $headerName = strtolower($headerName);
+            return isset($this->headers[$headerName])? $this->headers[$headerName]: null;
+        }
+    }
+
+    /**
+     * Returns cookies set in response
+     *
+     * @return   array
+     */
+    public function getCookies()
+    {
+        return $this->cookies;
+    }
+
+    /**
+     * Returns the body of the response
+     *
+     * @return   string
+     * @throws   HTTP_Request2_Exception if body cannot be decoded
+     */
+    public function getBody()
+    {
+        if (0 == strlen($this->body) || !$this->bodyEncoded
+            || !in_array(strtolower($this->getHeader('content-encoding')), array('gzip', 'deflate'))
+        ) {
+            return $this->body;
+
+        } else {
+            if (extension_loaded('mbstring') && (2 & ini_get('mbstring.func_overload'))) {
+                $oldEncoding = mb_internal_encoding();
+                mb_internal_encoding('8bit');
+            }
+
+            try {
+                switch (strtolower($this->getHeader('content-encoding'))) {
+                case 'gzip':
+                    $decoded = self::decodeGzip($this->body);
+                    break;
+                case 'deflate':
+                    $decoded = self::decodeDeflate($this->body);
+                }
+            } catch (Exception $e) {
+            }
+
+            if (!empty($oldEncoding)) {
+                mb_internal_encoding($oldEncoding);
+            }
+            if (!empty($e)) {
+                throw $e;
+            }
+            return $decoded;
+        }
+    }
+
+    /**
+     * Get the HTTP version of the response
+     *
+     * @return   string
+     */
+    public function getVersion()
+    {
+        return $this->version;
+    }
+
+    /**
+     * Checks whether data starts with GZIP format identification bytes from RFC 1952
+     *
+     * @param string $data gzip-encoded (presumably) data
+     *
+     * @return bool
+     */
+    public static function hasGzipIdentification($data)
+    {
+        return 0 === strcmp(substr($data, 0, 2), "\x1f\x8b");
+    }
+
+    /**
+     * Tries to parse GZIP format header in the given string
+     *
+     * If the header conforms to RFC 1952, its length is returned. If any
+     * sanity check fails, HTTP_Request2_MessageException is thrown.
+     *
+     * Note: This function might be usable outside of HTTP_Request2 so it might
+     * be good idea to be moved to some common package. (Delian Krustev)
+     *
+     * @param string  $data         Either the complete response body or
+     *                              the leading part of it
+     * @param boolean $dataComplete Whether $data contains complete response body
+     *
+     * @return int  gzip header length in bytes
+     * @throws HTTP_Request2_MessageException
+     * @link   http://tools.ietf.org/html/rfc1952
+     */
+    public static function parseGzipHeader($data, $dataComplete = false)
+    {
+        // if data is complete, trailing 8 bytes should be present for size and crc32
+        $length = strlen($data) - ($dataComplete ? 8 : 0);
+
+        if ($length < 10 || !self::hasGzipIdentification($data)) {
+            throw new HTTP_Request2_MessageException(
+                'The data does not seem to contain a valid gzip header',
+                HTTP_Request2_Exception::DECODE_ERROR
+            );
+        }
+
+        $method = ord(substr($data, 2, 1));
+        if (8 != $method) {
+            throw new HTTP_Request2_MessageException(
+                'Error parsing gzip header: unknown compression method',
+                HTTP_Request2_Exception::DECODE_ERROR
+            );
+        }
+        $flags = ord(substr($data, 3, 1));
+        if ($flags & 224) {
+            throw new HTTP_Request2_MessageException(
+                'Error parsing gzip header: reserved bits are set',
+                HTTP_Request2_Exception::DECODE_ERROR
+            );
+        }
+
+        // header is 10 bytes minimum. may be longer, though.
+        $headerLength = 10;
+        // extra fields, need to skip 'em
+        if ($flags & 4) {
+            if ($length - $headerLength - 2 < 0) {
+                throw new HTTP_Request2_MessageException(
+                    'Error parsing gzip header: data too short',
+                    HTTP_Request2_Exception::DECODE_ERROR
+                );
+            }
+            $extraLength = unpack('v', substr($data, 10, 2));
+            if ($length - $headerLength - 2 - $extraLength[1] < 0) {
+                throw new HTTP_Request2_MessageException(
+                    'Error parsing gzip header: data too short',
+                    HTTP_Request2_Exception::DECODE_ERROR
+                );
+            }
+            $headerLength += $extraLength[1] + 2;
+        }
+        // file name, need to skip that
+        if ($flags & 8) {
+            if ($length - $headerLength - 1 < 0) {
+                throw new HTTP_Request2_MessageException(
+                    'Error parsing gzip header: data too short',
+                    HTTP_Request2_Exception::DECODE_ERROR
+                );
+            }
+            $filenameLength = strpos(substr($data, $headerLength), chr(0));
+            if (false === $filenameLength
+                || $length - $headerLength - $filenameLength - 1 < 0
+            ) {
+                throw new HTTP_Request2_MessageException(
+                    'Error parsing gzip header: data too short',
+                    HTTP_Request2_Exception::DECODE_ERROR
+                );
+            }
+            $headerLength += $filenameLength + 1;
+        }
+        // comment, need to skip that also
+        if ($flags & 16) {
+            if ($length - $headerLength - 1 < 0) {
+                throw new HTTP_Request2_MessageException(
+                    'Error parsing gzip header: data too short',
+                    HTTP_Request2_Exception::DECODE_ERROR
+                );
+            }
+            $commentLength = strpos(substr($data, $headerLength), chr(0));
+            if (false === $commentLength
+                || $length - $headerLength - $commentLength - 1 < 0
+            ) {
+                throw new HTTP_Request2_MessageException(
+                    'Error parsing gzip header: data too short',
+                    HTTP_Request2_Exception::DECODE_ERROR
+                );
+            }
+            $headerLength += $commentLength + 1;
+        }
+        // have a CRC for header. let's check
+        if ($flags & 2) {
+            if ($length - $headerLength - 2 < 0) {
+                throw new HTTP_Request2_MessageException(
+                    'Error parsing gzip header: data too short',
+                    HTTP_Request2_Exception::DECODE_ERROR
+                );
+            }
+            $crcReal   = 0xffff & crc32(substr($data, 0, $headerLength));
+            $crcStored = unpack('v', substr($data, $headerLength, 2));
+            if ($crcReal != $crcStored[1]) {
+                throw new HTTP_Request2_MessageException(
+                    'Header CRC check failed',
+                    HTTP_Request2_Exception::DECODE_ERROR
+                );
+            }
+            $headerLength += 2;
+        }
+        return $headerLength;
+    }
+
+    /**
+     * Decodes the message-body encoded by gzip
+     *
+     * The real decoding work is done by gzinflate() built-in function, this
+     * method only parses the header and checks data for compliance with
+     * RFC 1952
+     *
+     * @param string $data gzip-encoded data
+     *
+     * @return   string  decoded data
+     * @throws   HTTP_Request2_LogicException
+     * @throws   HTTP_Request2_MessageException
+     * @link     http://tools.ietf.org/html/rfc1952
+     */
+    public static function decodeGzip($data)
+    {
+        // If it doesn't look like gzip-encoded data, don't bother
+        if (!self::hasGzipIdentification($data)) {
+            return $data;
+        }
+        if (!function_exists('gzinflate')) {
+            throw new HTTP_Request2_LogicException(
+                'Unable to decode body: gzip extension not available',
+                HTTP_Request2_Exception::MISCONFIGURATION
+            );
+        }
+
+        // unpacked data CRC and size at the end of encoded data
+        $tmp = unpack('V2', substr($data, -8));
+        $dataCrc  = $tmp[1];
+        $dataSize = $tmp[2];
+
+        $headerLength = self::parseGzipHeader($data, true);
+
+        // don't pass $dataSize to gzinflate, see bugs #13135, #14370
+        $unpacked = gzinflate(substr($data, $headerLength, -8));
+        if (false === $unpacked) {
+            throw new HTTP_Request2_MessageException(
+                'gzinflate() call failed',
+                HTTP_Request2_Exception::DECODE_ERROR
+            );
+        } elseif ($dataSize != strlen($unpacked)) {
+            throw new HTTP_Request2_MessageException(
+                'Data size check failed',
+                HTTP_Request2_Exception::DECODE_ERROR
+            );
+        } elseif ((0xffffffff & $dataCrc) != (0xffffffff & crc32($unpacked))) {
+            throw new HTTP_Request2_MessageException(
+                'Data CRC check failed',
+                HTTP_Request2_Exception::DECODE_ERROR
+            );
+        }
+        return $unpacked;
+    }
+
+    /**
+     * Decodes the message-body encoded by deflate
+     *
+     * @param string $data deflate-encoded data
+     *
+     * @return   string  decoded data
+     * @throws   HTTP_Request2_LogicException
+     */
+    public static function decodeDeflate($data)
+    {
+        if (!function_exists('gzuncompress')) {
+            throw new HTTP_Request2_LogicException(
+                'Unable to decode body: gzip extension not available',
+                HTTP_Request2_Exception::MISCONFIGURATION
+            );
+        }
+        // RFC 2616 defines 'deflate' encoding as zlib format from RFC 1950,
+        // while many applications send raw deflate stream from RFC 1951.
+        // We should check for presence of zlib header and use gzuncompress() or
+        // gzinflate() as needed. See bug #15305
+        $header = unpack('n', substr($data, 0, 2));
+        return (0 == $header[1] % 31)? gzuncompress($data): gzinflate($data);
+    }
+}
+?>

bundled-libs/HTTP/Request2/SOCKS5.php

@@ -0,0 +1,135 @@
+<?php
+/**
+ * SOCKS5 proxy connection class
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/** Socket wrapper class used by Socket Adapter */
+require_once 'HTTP/Request2/SocketWrapper.php';
+
+/**
+ * SOCKS5 proxy connection class (used by Socket Adapter)
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ * @link     http://pear.php.net/bugs/bug.php?id=19332
+ * @link     http://tools.ietf.org/html/rfc1928
+ */
+class HTTP_Request2_SOCKS5 extends HTTP_Request2_SocketWrapper
+{
+    /**
+     * Constructor, tries to connect and authenticate to a SOCKS5 proxy
+     *
+     * @param string $address        Proxy address, e.g. 'tcp://localhost:1080'
+     * @param int    $timeout        Connection timeout (seconds)
+     * @param array  $contextOptions Stream context options
+     * @param string $username       Proxy user name
+     * @param string $password       Proxy password
+     *
+     * @throws HTTP_Request2_LogicException
+     * @throws HTTP_Request2_ConnectionException
+     * @throws HTTP_Request2_MessageException
+     */
+    public function __construct(
+        $address, $timeout = 10, array $contextOptions = array(),
+        $username = null, $password = null
+    ) {
+        parent::__construct($address, $timeout, $contextOptions);
+
+        if (strlen($username)) {
+            $request = pack('C4', 5, 2, 0, 2);
+        } else {
+            $request = pack('C3', 5, 1, 0);
+        }
+        $this->write($request);
+        $response = unpack('Cversion/Cmethod', $this->read(3));
+        if (5 != $response['version']) {
+            throw new HTTP_Request2_MessageException(
+                'Invalid version received from SOCKS5 proxy: ' . $response['version'],
+                HTTP_Request2_Exception::MALFORMED_RESPONSE
+            );
+        }
+        switch ($response['method']) {
+        case 2:
+            $this->performAuthentication($username, $password);
+        case 0:
+            break;
+        default:
+            throw new HTTP_Request2_ConnectionException(
+                "Connection rejected by proxy due to unsupported auth method"
+            );
+        }
+    }
+
+    /**
+     * Performs username/password authentication for SOCKS5
+     *
+     * @param string $username Proxy user name
+     * @param string $password Proxy password
+     *
+     * @throws HTTP_Request2_ConnectionException
+     * @throws HTTP_Request2_MessageException
+     * @link http://tools.ietf.org/html/rfc1929
+     */
+    protected function performAuthentication($username, $password)
+    {
+        $request  = pack('C2', 1, strlen($username)) . $username
+                    . pack('C', strlen($password)) . $password;
+
+        $this->write($request);
+        $response = unpack('Cvn/Cstatus', $this->read(3));
+        if (1 != $response['vn'] || 0 != $response['status']) {
+            throw new HTTP_Request2_ConnectionException(
+                'Connection rejected by proxy due to invalid username and/or password'
+            );
+        }
+    }
+
+    /**
+     * Connects to a remote host via proxy
+     *
+     * @param string $remoteHost Remote host
+     * @param int    $remotePort Remote port
+     *
+     * @throws HTTP_Request2_ConnectionException
+     * @throws HTTP_Request2_MessageException
+     */
+    public function connect($remoteHost, $remotePort)
+    {
+        $request = pack('C5', 0x05, 0x01, 0x00, 0x03, strlen($remoteHost))
+                   . $remoteHost . pack('n', $remotePort);
+
+        $this->write($request);
+        $response = unpack('Cversion/Creply/Creserved', $this->read(1024));
+        if (5 != $response['version'] || 0 != $response['reserved']) {
+            throw new HTTP_Request2_MessageException(
+                'Invalid response received from SOCKS5 proxy',
+                HTTP_Request2_Exception::MALFORMED_RESPONSE
+            );
+        } elseif (0 != $response['reply']) {
+            throw new HTTP_Request2_ConnectionException(
+                "Unable to connect to {$remoteHost}:{$remotePort} through SOCKS5 proxy",
+                0, $response['reply']
+            );
+        }
+    }
+}
+?>

bundled-libs/HTTP/Request2/SocketWrapper.php

@@ -0,0 +1,320 @@
+<?php
+/**
+ * Socket wrapper class used by Socket Adapter
+ *
+ * PHP version 5
+ *
+ * LICENSE
+ *
+ * This source file is subject to BSD 3-Clause License that is bundled
+ * with this package in the file LICENSE and available at the URL
+ * https://raw.github.com/pear/HTTP_Request2/trunk/docs/LICENSE
+ *
+ * @category  HTTP
+ * @package   HTTP_Request2
+ * @author    Alexey Borzov <avb@php.net>
+ * @copyright 2008-2016 Alexey Borzov <avb@php.net>
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @link      http://pear.php.net/package/HTTP_Request2
+ */
+
+/** Exception classes for HTTP_Request2 package */
+require_once 'HTTP/Request2/Exception.php';
+
+/**
+ * Socket wrapper class used by Socket Adapter
+ *
+ * Needed to properly handle connection errors, global timeout support and
+ * similar things. Loosely based on Net_Socket used by older HTTP_Request.
+ *
+ * @category HTTP
+ * @package  HTTP_Request2
+ * @author   Alexey Borzov <avb@php.net>
+ * @license  http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
+ * @version  Release: 2.3.0
+ * @link     http://pear.php.net/package/HTTP_Request2
+ * @link     http://pear.php.net/bugs/bug.php?id=19332
+ * @link     http://tools.ietf.org/html/rfc1928
+ */
+class HTTP_Request2_SocketWrapper
+{
+    /**
+     * PHP warning messages raised during stream_socket_client() call
+     * @var array
+     */
+    protected $connectionWarnings = array();
+
+    /**
+     * Connected socket
+     * @var resource
+     */
+    protected $socket;
+
+    /**
+     * Sum of start time and global timeout, exception will be thrown if request continues past this time
+     * @var  integer
+     */
+    protected $deadline;
+
+    /**
+     * Global timeout value, mostly for exception messages
+     * @var integer
+     */
+    protected $timeout;
+
+    /**
+     * Class constructor, tries to establish connection
+     *
+     * @param string $address        Address for stream_socket_client() call,
+     *                               e.g. 'tcp://localhost:80'
+     * @param int    $timeout        Connection timeout (seconds)
+     * @param array  $contextOptions Context options
+     *
+     * @throws HTTP_Request2_LogicException
+     * @throws HTTP_Request2_ConnectionException
+     */
+    public function __construct($address, $timeout, array $contextOptions = array())
+    {
+        if (!empty($contextOptions)
+            && !isset($contextOptions['socket']) && !isset($contextOptions['ssl'])
+        ) {
+            // Backwards compatibility with 2.1.0 and 2.1.1 releases
+            $contextOptions = array('ssl' => $contextOptions);
+        }
+        if (isset($contextOptions['ssl'])) {
+            $contextOptions['ssl'] += array(
+                // Using "Intermediate compatibility" cipher bundle from
+                // https://wiki.mozilla.org/Security/Server_Side_TLS
+                'ciphers' => 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:'
+                             . 'ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:'
+                             . 'DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:'
+                             . 'ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:'
+                             . 'ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:'
+                             . 'ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:'
+                             . 'ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:'
+                             . 'DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:'
+                             . 'DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:'
+                             . 'ECDHE-RSA-DES-CBC3-SHA:ECDHE-ECDSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:'
+                             . 'AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:'
+                             . 'AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:'
+                             . '!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA'
+            );
+            if (version_compare(phpversion(), '5.4.13', '>=')) {
+                $contextOptions['ssl']['disable_compression'] = true;
+                if (version_compare(phpversion(), '5.6', '>=')) {
+                    $contextOptions['ssl']['crypto_method'] = STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT
+                                                              | STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT;
+                }
+            }
+        }
+        $context = stream_context_create();
+        foreach ($contextOptions as $wrapper => $options) {
+            foreach ($options as $name => $value) {
+                if (!stream_context_set_option($context, $wrapper, $name, $value)) {
+                    throw new HTTP_Request2_LogicException(
+                        "Error setting '{$wrapper}' wrapper context option '{$name}'"
+                    );
+                }
+            }
+        }
+        set_error_handler(array($this, 'connectionWarningsHandler'));
+        $this->socket = stream_socket_client(
+            $address, $errno, $errstr, $timeout, STREAM_CLIENT_CONNECT, $context
+        );
+        restore_error_handler();
+        // if we fail to bind to a specified local address (see request #19515),
+        // connection still succeeds, albeit with a warning. Throw an Exception
+        // with the warning text in this case as that connection is unlikely
+        // to be what user wants and as Curl throws an error in similar case.
+        if ($this->connectionWarnings) {
+            if ($this->socket) {
+                fclose($this->socket);
+            }
+            $error = $errstr ? $errstr : implode("\n", $this->connectionWarnings);
+            throw new HTTP_Request2_ConnectionException(
+                "Unable to connect to {$address}. Error: {$error}", 0, $errno
+            );
+        }
+    }
+
+    /**
+     * Destructor, disconnects socket
+     */
+    public function __destruct()
+    {
+        fclose($this->socket);
+    }
+
+    /**
+     * Wrapper around fread(), handles global request timeout
+     *
+     * @param int $length Reads up to this number of bytes
+     *
+     * @return   string Data read from socket
+     * @throws   HTTP_Request2_MessageException     In case of timeout
+     */
+    public function read($length)
+    {
+        if ($this->deadline) {
+            stream_set_timeout($this->socket, max($this->deadline - time(), 1));
+        }
+        $data = fread($this->socket, $length);
+        $this->checkTimeout();
+        return $data;
+    }
+
+    /**
+     * Reads until either the end of the socket or a newline, whichever comes first
+     *
+     * Strips the trailing newline from the returned data, handles global
+     * request timeout. Method idea borrowed from Net_Socket PEAR package.
+     *
+     * @param int $bufferSize   buffer size to use for reading
+     * @param int $localTimeout timeout value to use just for this call
+     *                          (used when waiting for "100 Continue" response)
+     *
+     * @return   string Available data up to the newline (not including newline)
+     * @throws   HTTP_Request2_MessageException     In case of timeout
+     */
+    public function readLine($bufferSize, $localTimeout = null)
+    {
+        $line = '';
+        while (!feof($this->socket)) {
+            if (null !== $localTimeout) {
+                stream_set_timeout($this->socket, $localTimeout);
+            } elseif ($this->deadline) {
+                stream_set_timeout($this->socket, max($this->deadline - time(), 1));
+            }
+
+            $line .= @fgets($this->socket, $bufferSize);
+
+            if (null === $localTimeout) {
+                $this->checkTimeout();
+
+            } else {
+                $info = stream_get_meta_data($this->socket);
+                // reset socket timeout if we don't have request timeout specified,
+                // prevents further calls failing with a bogus Exception
+                if (!$this->deadline) {
+                    $default = (int)@ini_get('default_socket_timeout');
+                    stream_set_timeout($this->socket, $default > 0 ? $default : PHP_INT_MAX);
+                }
+                if ($info['timed_out']) {
+                    throw new HTTP_Request2_MessageException(
+                        "readLine() call timed out", HTTP_Request2_Exception::TIMEOUT
+                    );
+                }
+            }
+            if (substr($line, -1) == "\n") {
+                return rtrim($line, "\r\n");
+            }
+        }
+        return $line;
+    }
+
+    /**
+     * Wrapper around fwrite(), handles global request timeout
+     *
+     * @param string $data String to be written
+     *
+     * @return int
+     * @throws HTTP_Request2_MessageException
+     */
+    public function write($data)
+    {
+        if ($this->deadline) {
+            stream_set_timeout($this->socket, max($this->deadline - time(), 1));
+        }
+        $written = fwrite($this->socket, $data);
+        $this->checkTimeout();
+        // http://www.php.net/manual/en/function.fwrite.php#96951
+        if ($written < strlen($data)) {
+            throw new HTTP_Request2_MessageException('Error writing request');
+        }
+        return $written;
+    }
+
+    /**
+     * Tests for end-of-file on a socket
+     *
+     * @return bool
+     */
+    public function eof()
+    {
+        return feof($this->socket);
+    }
+
+    /**
+     * Sets request deadline
+     *
+     * @param int $deadline Exception will be thrown if request continues
+     *                      past this time
+     * @param int $timeout  Original request timeout value, to use in
+     *                      Exception message
+     */
+    public function setDeadline($deadline, $timeout)
+    {
+        $this->deadline = $deadline;
+        $this->timeout  = $timeout;
+    }
+
+    /**
+     * Turns on encryption on a socket
+     *
+     * @throws HTTP_Request2_ConnectionException
+     */
+    public function enableCrypto()
+    {
+        if (version_compare(phpversion(), '5.6', '<')) {
+            $cryptoMethod = STREAM_CRYPTO_METHOD_TLS_CLIENT;
+        } else {
+            $cryptoMethod = STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT
+                            | STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT;
+        }
+
+        if (!stream_socket_enable_crypto($this->socket, true, $cryptoMethod)) {
+            throw new HTTP_Request2_ConnectionException(
+                'Failed to enable secure connection when connecting through proxy'
+            );
+        }
+    }
+
+    /**
+     * Throws an Exception if stream timed out
+     *
+     * @throws HTTP_Request2_MessageException
+     */
+    protected function checkTimeout()
+    {
+        $info = stream_get_meta_data($this->socket);
+        if ($info['timed_out'] || $this->deadline && time() > $this->deadline) {
+            $reason = $this->deadline
+                ? "after {$this->timeout} second(s)"
+                : 'due to default_socket_timeout php.ini setting';
+            throw new HTTP_Request2_MessageException(
+                "Request timed out {$reason}", HTTP_Request2_Exception::TIMEOUT
+            );
+        }
+    }
+
+    /**
+     * Error handler to use during stream_socket_client() call
+     *
+     * One stream_socket_client() call may produce *multiple* PHP warnings
+     * (especially OpenSSL-related), we keep them in an array to later use for
+     * the message of HTTP_Request2_ConnectionException
+     *
+     * @param int    $errno  error level
+     * @param string $errstr error message
+     *
+     * @return bool
+     */
+    protected function connectionWarningsHandler($errno, $errstr)
+    {
+        if ($errno & E_WARNING) {
+            array_unshift($this->connectionWarnings, $errstr);
+        }
+        return true;
+    }
+}
+?>

bundled-libs/Net/DNS2/BitMap.php

@@ -0,0 +1,254 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * a class to handle converting RR bitmaps to arrays and back; used on NSEC
+ * and NSEC3 RR's
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_Packet
+ *
+ */
+class Net_DNS2_BitMap
+{
+    /**
+     * parses a RR bitmap field defined in RFC3845, into an array of RR names.
+     *
+     * Type Bit Map(s) Field = ( Window Block # | Bitmap Length | Bitmap ) +
+     *
+     * @param string $data a bitmap stringto parse
+     *
+     * @return array
+     * @access public
+     *
+     */
+    public static function bitMapToArray($data)
+    {
+        if (strlen($data) == 0) {
+            return null;
+        }
+
+        $output = array();
+        $offset = 0;
+        $length = strlen($data);
+
+        while ($offset < $length) {
+            
+            //
+            // unpack the window and length values
+            //
+            $x = unpack('@' . $offset . '/Cwindow/Clength', $data);
+            $offset += 2;
+
+            //
+            // copy out the bitmap value
+            //
+            $bitmap = unpack('C*', substr($data, $offset, $x['length']));
+            $offset += $x['length'];
+
+            //
+            // I'm not sure if there's a better way of doing this, but PHP doesn't
+            // have a 'B' flag for unpack()
+            //
+            $bitstr = '';
+            foreach ($bitmap as $r) {
+                
+                $bitstr .= sprintf('%08b', $r);
+            }
+
+            $blen = strlen($bitstr);
+            for ($i=0; $i<$blen; $i++) {
+
+                if ($bitstr[$i] == '1') {
+                
+                    $type = $x['window'] * 256 + $i;
+
+                    if (isset(Net_DNS2_Lookups::$rr_types_by_id[$type])) {
+
+                        $output[] = Net_DNS2_Lookups::$rr_types_by_id[$type];
+                    } else {
+
+                        $output[] = 'TYPE' . $type;
+                    }
+                }
+            }
+        }
+
+        return $output;
+    }
+
+    /**
+     * builds a RR Bit map from an array of RR type names
+     *
+     * @param array $data a list of RR names
+     *
+     * @return string
+     * @access public
+     *
+     */
+    public static function arrayToBitMap(array $data)
+    {
+        if (count($data) == 0) {
+            return null;
+        }
+
+        $current_window = 0;
+
+        //
+        // go through each RR
+        //
+        $max = 0;
+        $bm = array();
+
+        foreach ($data as $rr) {
+        
+            $rr = strtoupper($rr);
+
+            //
+            // get the type id for the RR
+            //
+            $type = @Net_DNS2_Lookups::$rr_types_by_name[$rr];
+            if (isset($type)) {
+
+                //
+                // skip meta types or qtypes
+                //  
+                if ( (isset(Net_DNS2_Lookups::$rr_qtypes_by_id[$type]))
+                    || (isset(Net_DNS2_Lookups::$rr_metatypes_by_id[$type]))
+                ) {
+                    continue;
+                }
+
+            } else {
+
+                //
+                // if it's not found, then it must be defined as TYPE<id>, per
+                // RFC3845 section 2.2, if it's not, we ignore it.
+                //
+                list($name, $type) = explode('TYPE', $rr);
+                if (!isset($type)) {
+
+                    continue;
+                }
+            }
+
+            //
+            // build the current window
+            //
+            $current_window = (int)($type / 256);
+            
+            $val = $type - $current_window * 256.0;
+            if ($val > $max) {
+                $max = $val;
+            }
+
+            $bm[$current_window][$val] = 1;
+            $bm[$current_window]['length'] = ceil(($max + 1) / 8);
+        }
+
+        $output = '';
+
+        foreach ($bm as $window => $bitdata) {
+
+            $bitstr = '';
+
+            for ($i=0; $i<$bm[$window]['length'] * 8; $i++) {
+                if (isset($bm[$window][$i])) {
+                    $bitstr .= '1';
+                } else {
+                    $bitstr .= '0';
+                }
+            }
+
+            $output .= pack('CC', $window, $bm[$window]['length']);
+            $output .= pack('H*', self::bigBaseConvert($bitstr));
+        }
+
+        return $output;
+    }
+
+    /**
+     * a base_convert that handles large numbers; forced to 2/16
+     *
+     * @param string $number a bit string
+     *
+     * @return string
+     * @access public
+     *
+     */
+    public static function bigBaseConvert($number)
+    {
+        $result = '';
+
+        $bin = substr(chunk_split(strrev($number), 4, '-'), 0, -1);
+        $temp = preg_split('[-]', $bin, -1, PREG_SPLIT_DELIM_CAPTURE);
+        
+        for ($i = count($temp)-1;$i >= 0;$i--) {
+            
+            $result = $result . base_convert(strrev($temp[$i]), 2, 16);
+        }
+        
+        return strtoupper($result);
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Cache.php

@@ -0,0 +1,311 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.1.0
+ *
+ */
+
+/**
+ * A class to provide simple dns lookup caching.
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_Packet
+ *
+ */
+class Net_DNS2_Cache
+{
+    /*
+     * the filename of the cache file
+     */
+    protected $cache_file = '';
+
+    /*
+     * the local data store for the cache
+     */
+    protected $cache_data = array();
+
+    /*
+     * the size of the cache to use
+     */
+    protected $cache_size = 0;
+
+    /*
+     * the cache serializer
+     */
+    protected $cache_serializer;
+
+    /*
+     * an internal flag to make sure we don't load the cache content more
+     * than once per instance.
+     */ 
+    protected $cache_opened = false;
+
+    /**
+     * returns true/false if the provided key is defined in the cache
+     * 
+     * @param string $key the key to lookup in the local cache
+     *
+     * @return boolean
+     * @access public
+     *
+     */
+    public function has($key)
+    {
+        return isset($this->cache_data[$key]);
+    }
+
+    /**
+     * returns the value for the given key
+     * 
+     * @param string $key the key to lookup in the local cache
+     *
+     * @return mixed returns the cache data on sucess, false on error
+     * @access public
+     *
+     */
+    public function get($key)
+    {
+        if (isset($this->cache_data[$key])) {
+
+            if ($this->cache_serializer == 'json') {
+                return json_decode($this->cache_data[$key]['object']);
+            } else {
+                return unserialize($this->cache_data[$key]['object']);
+            }
+        } else {
+
+            return false;
+        }
+    }
+
+    /**
+     * adds a new key/value pair to the cache
+     * 
+     * @param string $key  the key for the new cache entry
+     * @param mixed  $data the data to store in cache
+     *
+     * @return void
+     * @access public
+     *
+     */
+    public function put($key, $data)
+    {
+        $ttl = 86400 * 365;
+
+        //
+        // clear the rdata values
+        //
+        $data->rdata = '';
+        $data->rdlength = 0;
+
+        //
+        // find the lowest TTL, and use that as the TTL for the whole cached 
+        // object. The downside to using one TTL for the whole object, is that
+        // we'll invalidate entries before they actuall expire, causing a
+        // real lookup to happen.
+        //
+        // The upside is that we don't need to require() each RR type in the
+        // cache, so we can look at their individual TTL's on each run- we only
+        // unserialize the actual RR object when it's get() from the cache.
+        //
+        foreach ($data->answer as $index => $rr) {
+                    
+            if ($rr->ttl < $ttl) {
+                $ttl = $rr->ttl;
+            }
+
+            $rr->rdata = '';
+            $rr->rdlength = 0;
+        }
+        foreach ($data->authority as $index => $rr) {
+                    
+            if ($rr->ttl < $ttl) {
+                $ttl = $rr->ttl;
+            }
+
+            $rr->rdata = '';
+            $rr->rdlength = 0;
+        }
+        foreach ($data->additional as $index => $rr) {
+                    
+            if ($rr->ttl < $ttl) {
+                $ttl = $rr->ttl;
+            }
+
+            $rr->rdata = '';
+            $rr->rdlength = 0;
+        }
+
+        $this->cache_data[$key] = array(
+
+            'cache_date'    => time(),
+            'ttl'           => $ttl
+        );
+
+        if ($this->cache_serializer == 'json') {
+            $this->cache_data[$key]['object'] = json_encode($data);
+        } else {
+            $this->cache_data[$key]['object'] = serialize($data);
+        }
+    }
+
+    /**
+     * runs a clean up process on the cache data
+     *
+     * @return void
+     * @access protected
+     *
+     */
+    protected function clean()
+    {
+        if (count($this->cache_data) > 0) {
+
+            //
+            // go through each entry and adjust their TTL, and remove entries that 
+            // have expired
+            //
+            $now = time();
+
+            foreach ($this->cache_data as $key => $data) {
+
+                $diff = $now - $data['cache_date'];
+
+                if ($data['ttl'] <= $diff) {
+
+                    unset($this->cache_data[$key]);
+                } else {
+
+                    $this->cache_data[$key]['ttl'] -= $diff;
+                    $this->cache_data[$key]['cache_date'] = $now;
+                }
+            }
+        }
+    }
+
+    /**
+     * runs a clean up process on the cache data
+     *
+     * @return mixed
+     * @access protected
+     *
+     */
+    protected function resize()
+    {
+        if (count($this->cache_data) > 0) {
+        
+            //
+            // serialize the cache data
+            //
+            if ($this->cache_serializer == 'json') {
+                $cache = json_encode($this->cache_data);
+            } else {
+                $cache = serialize($this->cache_data);
+            }
+
+            //
+            // only do this part if the size allocated to the cache storage
+            // is smaller than the actual cache data
+            //
+            if (strlen($cache) > $this->cache_size) {
+
+                while (strlen($cache) > $this->cache_size) {
+
+                    //
+                    // go through the data, and remove the entries closed to
+                    // their expiration date.
+                    //
+                    $smallest_ttl = time();
+                    $smallest_key = null;
+
+                    foreach ($this->cache_data as $key => $data) {
+
+                        if ($data['ttl'] < $smallest_ttl) {
+
+                            $smallest_ttl = $data['ttl'];
+                            $smallest_key = $key;
+                        }
+                    }
+
+                    //
+                    // unset the key with the smallest TTL
+                    //
+                    unset($this->cache_data[$smallest_key]);
+
+                    //
+                    // re-serialize
+                    //
+                    if ($this->cache_serializer == 'json') {
+                        $cache = json_encode($this->cache_data);
+                    } else {
+                        $cache = serialize($this->cache_data);
+                    }
+                }
+            }
+
+            if ( ($cache == 'a:0:{}') || ($cache == '{}') ) {
+                return null;
+            } else {
+                return $cache;
+            }
+        }
+
+        return null;
+    }
+};
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Cache/File.php

@@ -0,0 +1,247 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.1.0
+ *
+ */
+
+/**
+ * File-based caching for the Net_DNS2_Cache class
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_Packet
+ *
+ */
+class Net_DNS2_Cache_File extends Net_DNS2_Cache
+{
+    /**
+     * open a cache object
+     *
+     * @param string  $cache_file path to a file to use for cache storage
+     * @param integer $size       the size of the shared memory segment to create
+     * @param string  $serializer the name of the cache serialize to use
+     *
+     * @throws Net_DNS2_Exception
+     * @access public
+     * @return void
+     *
+     */
+    public function open($cache_file, $size, $serializer)
+    {
+        $this->cache_size       = $size;
+        $this->cache_file       = $cache_file;
+        $this->cache_serializer = $serializer;
+
+        //
+        // check that the file exists first
+        //
+        if ( ($this->cache_opened == false) 
+            && (file_exists($this->cache_file) == true) 
+            && (filesize($this->cache_file) > 0)
+        ) {
+            //
+            // open the file for reading
+            //
+            $fp = @fopen($this->cache_file, 'r');
+            if ($fp !== false) {
+                
+                //
+                // lock the file just in case
+                //
+                flock($fp, LOCK_EX);
+
+                //
+                // read the file contents
+                //
+                $data = fread($fp, filesize($this->cache_file));
+
+                $decoded = null;
+                    
+                if ($this->cache_serializer == 'json') {
+
+                    $decoded = json_decode($data, true);         
+                } else {
+
+                    $decoded = unserialize($data);                
+                }
+
+                if (is_array($decoded) == true) {
+
+                    $this->cache_data = $decoded;
+                } else {
+
+                    $this->cache_data = array();
+                }
+
+                //
+                // unlock
+                //
+                flock($fp, LOCK_UN);
+
+                //
+                // close the file
+                //
+                fclose($fp);
+
+                //
+                // clean up the data
+                //
+                $this->clean();
+
+                //
+                // mark this so we don't read this contents more than once per instance.
+                //
+                $this->cache_opened = true;
+            }
+        }
+    }
+
+    /**
+     * Destructor
+     *
+     * @access public
+     *
+     */
+    public function __destruct()
+    {
+        //
+        // if there's no cache file set, then there's nothing to do
+        //
+        if (strlen($this->cache_file) == 0) {
+            return;
+        }
+
+        //
+        // open the file for reading/writing
+        //
+        $fp = fopen($this->cache_file, 'a+');
+        if ($fp !== false) {
+                
+            //
+            // lock the file just in case
+            //
+            flock($fp, LOCK_EX);
+        
+            //
+            // seek to the start of the file to read
+            //
+            fseek($fp, 0, SEEK_SET);
+
+            //
+            // read the file contents
+            //
+            $data = @fread($fp, filesize($this->cache_file));
+            if ( ($data !== false) && (strlen($data) > 0) ) {
+
+                //
+                // unserialize and store the data
+                //
+                $c = $this->cache_data;
+
+                $decoded = null;
+
+                if ($this->cache_serializer == 'json') {
+
+                    $decoded = json_decode($data, true);
+                } else {
+
+                    $decoded = unserialize($data);
+                }
+                
+                if (is_array($decoded) == true) {
+
+                    $this->cache_data = array_merge($c, $decoded);
+                }
+            }
+
+            //
+            // trucate the file
+            //
+            ftruncate($fp, 0);
+
+            //
+            // clean the data
+            //
+            $this->clean();
+
+            //
+            // resize the data
+            //
+            $data = $this->resize();
+            if (!is_null($data)) {
+
+                //
+                // write the file contents
+                //
+                fwrite($fp, $data);
+            }
+
+            //
+            // unlock
+            //
+            flock($fp, LOCK_UN);
+
+            //
+            // close the file
+            //
+            fclose($fp);
+        }
+    }
+};
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Cache/Shm.php

@@ -0,0 +1,318 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.1.0
+ *
+ */
+
+/**
+ * Shared Memory-based caching for the Net_DNS2_Cache class
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_Packet
+ *
+ */
+class Net_DNS2_Cache_Shm extends Net_DNS2_Cache
+{
+    /*
+     * resource id of the shared memory cache
+     */
+    private $_cache_id = false;
+
+    /*
+     * the IPC key
+     */
+    private $_cache_file_tok = -1;
+
+    /**
+     * open a cache object
+     *
+     * @param string  $cache_file path to a file to use for cache storage
+     * @param integer $size       the size of the shared memory segment to create
+     * @param string  $serializer the name of the cache serialize to use
+     *
+     * @throws Net_DNS2_Exception
+     * @access public
+     * @return void
+     *
+     */
+    public function open($cache_file, $size, $serializer)
+    {
+        $this->cache_size       = $size;
+        $this->cache_file       = $cache_file;
+        $this->cache_serializer = $serializer;
+
+        //
+        // if we've already loaded the cache data, then just return right away
+        //
+        if ($this->cache_opened == true)
+        {
+            return;
+        }
+
+        //
+        // make sure the file exists first
+        //
+        if (!file_exists($cache_file)) {
+
+            if (file_put_contents($cache_file, '') === false) {
+        
+                throw new Net_DNS2_Exception(
+                    'failed to create empty SHM file: ' . $cache_file,
+                    Net_DNS2_Lookups::E_CACHE_SHM_FILE
+                );
+            }
+        }
+
+        //
+        // convert the filename to a IPC key
+        //
+        $this->_cache_file_tok = ftok($cache_file, 't');
+        if ($this->_cache_file_tok == -1) {
+
+            throw new Net_DNS2_Exception(
+                'failed on ftok() file: ' . $this->_cache_file_tok,
+                Net_DNS2_Lookups::E_CACHE_SHM_FILE
+            );
+        }
+
+        //
+        // try to open an existing cache; if it doesn't exist, then there's no
+        // cache, and nothing to do.
+        //
+        $this->_cache_id = @shmop_open($this->_cache_file_tok, 'w', 0, 0);
+        if ($this->_cache_id !== false) {
+
+            //
+            // this returns the size allocated, and not the size used, but it's
+            // still a good check to make sure there's space allocated.
+            //
+            $allocated = shmop_size($this->_cache_id);
+            if ($allocated > 0) {
+            
+                //
+                // read the data from the shared memory segment
+                //
+                $data = trim(shmop_read($this->_cache_id, 0, $allocated));
+                if ( ($data !== false) && (strlen($data) > 0) ) {
+
+                    //
+                    // unserialize and store the data
+                    //
+                    $decoded = null;
+
+                    if ($this->cache_serializer == 'json') {
+
+                        $decoded = json_decode($data, true);
+                    } else {
+
+                        $decoded = unserialize($data);
+                    }
+
+                    if (is_array($decoded) == true) {
+
+                        $this->cache_data = $decoded;
+                    } else {
+
+                        $this->cache_data = array();
+                    }
+
+                    //
+                    // call clean to clean up old entries
+                    //
+                    $this->clean();
+
+                    //
+                    // mark the cache as loaded, so we don't load it more than once
+                    //
+                    $this->cache_opened = true;
+                }
+            }
+        }
+    }
+
+    /**
+     * Destructor
+     *
+     * @access public
+     *
+     */
+    public function __destruct()
+    {
+        //
+        // if there's no cache file set, then there's nothing to do
+        //
+        if (strlen($this->cache_file) == 0) {
+            return;
+        }
+
+        $fp = fopen($this->cache_file, 'r');
+        if ($fp !== false) {
+
+            //
+            // lock the file
+            //
+            flock($fp, LOCK_EX);
+
+            //
+            // check to see if we have an open shm segment
+            //
+            if ($this->_cache_id === false) {
+
+                //
+                // try opening it again, incase it was created by another
+                // process in the mean time
+                //
+                $this->_cache_id = @shmop_open(
+                    $this->_cache_file_tok, 'w', 0, 0
+                );
+                if ($this->_cache_id === false) {
+
+                    //
+                    // otherwise, create it.
+                    //
+                    $this->_cache_id = @shmop_open(
+                        $this->_cache_file_tok, 'c', 0, $this->cache_size
+                    );
+                }
+            }
+
+            //
+            // get the size allocated to the segment
+            //
+            $allocated = shmop_size($this->_cache_id);
+
+            //
+            // read the contents
+            //
+            $data = trim(shmop_read($this->_cache_id, 0, $allocated));
+
+            //
+            // if there was some data
+            //    
+            if ( ($data !== false) && (strlen($data) > 0) ) {
+
+                //
+                // unserialize and store the data
+                //
+                $c = $this->cache_data;
+
+                $decoded = null;
+  
+                if ($this->cache_serializer == 'json') {
+                
+                    $decoded = json_decode($data, true);
+                } else {
+                        
+                    $decoded = unserialize($data);
+                }   
+                         
+                if (is_array($decoded) == true) {
+                
+                    $this->cache_data = array_merge($c, $decoded);
+                }
+            }
+
+            //
+            // delete the segment
+            //
+            shmop_delete($this->_cache_id);
+
+            //
+            // clean the data
+            //
+            $this->clean();
+
+            //
+            // clean up and write the data
+            //
+            $data = $this->resize();
+            if (!is_null($data)) {
+
+                //
+                // re-create segment
+                //
+                $this->_cache_id = @shmop_open(
+                    $this->_cache_file_tok, 'c', 0644, $this->cache_size
+                );
+                if ($this->_cache_id === false) {
+                    return;
+                }
+
+                $o = shmop_write($this->_cache_id, $data, 0);
+            }
+
+            //
+            // close the segment
+            //
+            shmop_close($this->_cache_id);
+
+            //
+            // unlock
+            //
+            flock($fp, LOCK_UN);
+
+            //
+            // close the file
+            //
+            fclose($fp);
+        }
+    }
+};
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Exception.php

@@ -0,0 +1,142 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ */
+
+/**
+ * Exception handler used by Net_DNS2
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * 
+ */
+class Net_DNS2_Exception extends Exception
+{
+    private $_request;
+    private $_response;
+
+    /**
+     * Constructor - overload the constructor so we can pass in the request
+     *               and response object (when it's available)
+     *
+     * @param string $message  the exception message
+     * @param int    $code     the exception code
+     * @param object $previous the previous Exception object
+     * @param object $request  the Net_DNS2_Packet_Request object for this request
+     * @param object $response the Net_DNS2_Packet_Response object for this request
+     *
+     * @access public
+     *
+     */
+    public function __construct(
+        $message = '', 
+        $code = 0, 
+        $previous = null, 
+        Net_DNS2_Packet_Request $request = null,
+        Net_DNS2_Packet_Response $response = null
+    ) {
+        //
+        // store the request/response objects (if passed)
+        //
+        $this->_request = $request;
+        $this->_response = $response;
+
+        //
+        // call the parent constructor
+        //
+        // the "previous" argument was added in PHP 5.3.0
+        //
+        //      https://code.google.com/p/netdns2/issues/detail?id=25
+        //
+        if (version_compare(PHP_VERSION, '5.3.0', '>=') == true) {
+
+            parent::__construct($message, $code, $previous);
+        } else {
+
+            parent::__construct($message, $code);
+        }
+    }
+
+    /**
+     * returns the Net_DNS2_Packet_Request object (if available)
+     *
+     * @return Net_DNS2_Packet_Request object
+     * @access public
+     * @since  function available since release 1.3.1
+     *
+     */
+    public function getRequest()
+    {
+        return $this->_request;
+    }
+
+    /**
+     * returns the Net_DNS2_Packet_Response object (if available)
+     *
+     * @return Net_DNS2_Packet_Response object
+     * @access public
+     * @since  function available since release 1.3.1
+     *
+     */
+    public function getResponse()
+    {
+        return $this->_response;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Header.php

@@ -0,0 +1,277 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+
+/**
+ * DNS Packet Header class
+ *
+ * This class handles parsing and constructing DNS Packet Headers as defined
+ * by section 4.1.1 of RFC1035.
+ * 
+ *  DNS header format - RFC1035 section 4.1.1
+ *  DNS header format - RFC4035 section 3.2
+ *
+ *      0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                      ID                       |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |QR|   Opcode  |AA|TC|RD|RA| Z|AD|CD|   RCODE   |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    QDCOUNT                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    ANCOUNT                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    NSCOUNT                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    ARCOUNT                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ *
+ */
+class Net_DNS2_Header
+{
+    public $id;         // 16 bit - identifier
+    public $qr;         //  1 bit - 0 = query, 1 = response
+    public $opcode;     //  4 bit - op code
+    public $aa;         //  1 bit - Authoritative Answer
+    public $tc;         //  1 bit - TrunCation
+    public $rd;         //  1 bit - Recursion Desired
+    public $ra;         //  1 bit - Recursion Available
+    public $z;          //  1 bit - Reserved
+    public $ad;         //  1 bit - Authentic Data (RFC4035)
+    public $cd;         //  1 bit - Checking Disabled (RFC4035)
+    public $rcode;      //  4 bit - Response code
+    public $qdcount;    // 16 bit - entries in the question section
+    public $ancount;    // 16 bit - resource records in the answer section
+    public $nscount;    // 16 bit - name server rr in the authority records section
+    public $arcount;    // 16 bit - rr's in the additional records section
+
+    /**
+     * Constructor - builds a new Net_DNS2_Header object
+     *
+     * @param mixed &$packet either a Net_DNS2_Packet object or null
+     *
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function __construct(Net_DNS2_Packet &$packet = null)
+    {
+        if (!is_null($packet)) {
+
+            $this->set($packet);
+        } else {
+
+            $this->id       = $this->nextPacketId();
+            $this->qr       = Net_DNS2_Lookups::QR_QUERY;
+            $this->opcode   = Net_DNS2_Lookups::OPCODE_QUERY;
+            $this->aa       = 0;
+            $this->tc       = 0;
+            $this->rd       = 1;
+            $this->ra       = 0;
+            $this->z        = 0;
+            $this->ad       = 0;
+            $this->cd       = 0;
+            $this->rcode    = Net_DNS2_Lookups::RCODE_NOERROR;
+            $this->qdcount  = 1;
+            $this->ancount  = 0;
+            $this->nscount  = 0;
+            $this->arcount  = 0;
+        }
+    }
+
+    /**
+     * returns the next available packet id
+     *
+     * @return    integer
+     * @access    public
+     *
+     */
+    public function nextPacketId()
+    {
+        if (++Net_DNS2_Lookups::$next_packet_id > 65535) {
+
+            Net_DNS2_Lookups::$next_packet_id = 1;
+        }
+
+        return Net_DNS2_Lookups::$next_packet_id;
+    }
+
+    /**
+     * magic __toString() method to return the header as a string
+     *
+     * @return    string
+     * @access    public
+     *
+     */
+    public function __toString()
+    {
+        $output = ";;\n;; Header:\n";
+
+        $output .= ";;\t id         = " . $this->id . "\n";
+        $output .= ";;\t qr         = " . $this->qr . "\n";
+        $output .= ";;\t opcode     = " . $this->opcode . "\n";
+        $output .= ";;\t aa         = " . $this->aa . "\n";
+        $output .= ";;\t tc         = " . $this->tc . "\n";
+        $output .= ";;\t rd         = " . $this->rd . "\n";
+        $output .= ";;\t ra         = " . $this->ra . "\n";
+        $output .= ";;\t z          = " . $this->z . "\n";
+        $output .= ";;\t ad         = " . $this->ad . "\n";
+        $output .= ";;\t cd         = " . $this->cd . "\n";
+        $output .= ";;\t rcode      = " . $this->rcode . "\n";
+        $output .= ";;\t qdcount    = " . $this->qdcount . "\n";
+        $output .= ";;\t ancount    = " . $this->ancount . "\n";
+        $output .= ";;\t nscount    = " . $this->nscount . "\n";
+        $output .= ";;\t arcount    = " . $this->arcount . "\n";
+
+        return $output;
+    }
+
+    /**
+     * constructs a Net_DNS2_Header from a Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet Object
+     *
+     * @return boolean
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function set(Net_DNS2_Packet &$packet)
+    {
+        //
+        // the header must be at least 12 bytes long.
+        //
+        if ($packet->rdlength < Net_DNS2_Lookups::DNS_HEADER_SIZE) {
+
+            throw new Net_DNS2_Exception(
+                'invalid header data provided; to small',
+                Net_DNS2_Lookups::E_HEADER_INVALID
+            );
+        }
+
+        $offset = 0;
+
+        //
+        // parse the values
+        //
+        $this->id       = ord($packet->rdata[$offset]) << 8 | 
+            ord($packet->rdata[++$offset]);
+
+        ++$offset;
+        $this->qr       = (ord($packet->rdata[$offset]) >> 7) & 0x1;
+        $this->opcode   = (ord($packet->rdata[$offset]) >> 3) & 0xf;
+        $this->aa       = (ord($packet->rdata[$offset]) >> 2) & 0x1;
+        $this->tc       = (ord($packet->rdata[$offset]) >> 1) & 0x1;
+        $this->rd       = ord($packet->rdata[$offset]) & 0x1;
+
+        ++$offset;
+        $this->ra       = (ord($packet->rdata[$offset]) >> 7) & 0x1;
+        $this->z        = (ord($packet->rdata[$offset]) >> 6) & 0x1;
+        $this->ad       = (ord($packet->rdata[$offset]) >> 5) & 0x1;
+        $this->cd       = (ord($packet->rdata[$offset]) >> 4) & 0x1;
+        $this->rcode    = ord($packet->rdata[$offset]) & 0xf;
+            
+        $this->qdcount  = ord($packet->rdata[++$offset]) << 8 | 
+            ord($packet->rdata[++$offset]);
+        $this->ancount  = ord($packet->rdata[++$offset]) << 8 | 
+            ord($packet->rdata[++$offset]);
+        $this->nscount  = ord($packet->rdata[++$offset]) << 8 | 
+            ord($packet->rdata[++$offset]);
+        $this->arcount  = ord($packet->rdata[++$offset]) << 8 | 
+            ord($packet->rdata[++$offset]);
+
+        //
+        // increment the internal offset
+        //
+        $packet->offset += Net_DNS2_Lookups::DNS_HEADER_SIZE;
+
+        return true;
+    }
+
+    /**
+     * returns a binary packed DNS Header
+     *
+     * @param Net_DNS2_Packet &$packet Object
+     *
+     * @return    string
+     * @access    public
+     *
+     */
+    public function get(Net_DNS2_Packet &$packet)
+    {
+        $packet->offset += Net_DNS2_Lookups::DNS_HEADER_SIZE;
+
+        return pack('n', $this->id) . 
+            chr(
+                ($this->qr << 7) | ($this->opcode << 3) | 
+                ($this->aa << 2) | ($this->tc << 1) | ($this->rd)
+            ) .
+            chr(
+                ($this->ra << 7) | ($this->ad << 5) | ($this->cd << 4) | $this->rcode
+            ) .
+            pack('n4', $this->qdcount, $this->ancount, $this->nscount, $this->arcount);
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Lookups.php

@@ -0,0 +1,578 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+//
+// initalize the packet id value
+//
+Net_DNS2_Lookups::$next_packet_id   = mt_rand(0, 65535);
+
+//
+// build the reverse lookup tables; this is just so we don't have to
+// have duplicate static content laying around.
+//
+Net_DNS2_Lookups::$rr_types_by_id       = array_flip(Net_DNS2_Lookups::$rr_types_by_name);
+Net_DNS2_Lookups::$classes_by_id        = array_flip(Net_DNS2_Lookups::$classes_by_name);
+Net_DNS2_Lookups::$rr_types_class_to_id = array_flip(Net_DNS2_Lookups::$rr_types_id_to_class);
+Net_DNS2_Lookups::$algorithm_name_to_id = array_flip(Net_DNS2_Lookups::$algorithm_id_to_name);
+Net_DNS2_Lookups::$digest_name_to_id    = array_flip(Net_DNS2_Lookups::$digest_id_to_name);
+Net_DNS2_Lookups::$rr_qtypes_by_id      = array_flip(Net_DNS2_Lookups::$rr_qtypes_by_name);
+Net_DNS2_Lookups::$rr_metatypes_by_id   = array_flip(Net_DNS2_Lookups::$rr_metatypes_by_name);
+Net_DNS2_Lookups::$protocol_by_id       = array_flip(Net_DNS2_Lookups::$protocol_by_name);
+
+/**
+ * This class provides simple lookups used througout the Net_DNS2 code
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * 
+ */
+class Net_DNS2_Lookups
+{
+    /*
+     * size (in bytes) of a header in a standard DNS packet
+     */
+    const DNS_HEADER_SIZE       = 12;
+
+    /*
+     * max size of a UDP packet
+     */
+    const DNS_MAX_UDP_SIZE      = 512;
+    
+    /*
+     * Query/Response flag
+     */
+    const QR_QUERY              = 0;        // RFC 1035
+    const QR_RESPONSE           = 1;        // RFC 1035
+
+    /*
+     * DNS Op Codes
+     */
+    const OPCODE_QUERY          = 0;        // RFC 1035
+    const OPCODE_IQUERY         = 1;        // RFC 1035, RFC 3425
+    const OPCODE_STATUS         = 2;        // RFC 1035
+    const OPCODE_NOTIFY         = 4;        // RFC 1996
+    const OPCODE_UPDATE         = 5;        // RFC 2136
+
+    /*
+     * Resource Record Classes
+     */
+    const RR_CLASS_IN           = 1;        // RFC 1035
+    const RR_CLASS_CH           = 3;        // RFC 1035
+    const RR_CLASS_HS           = 4;        // RFC 1035
+    const RR_CLASS_NONE         = 254;      // RFC 2136
+    const RR_CLASS_ANY          = 255;      // RFC 1035
+
+    /*
+     * DNS Response Codes
+     */
+    const RCODE_NOERROR         = 0;        // RFC 1035
+    const RCODE_FORMERR         = 1;        // RFC 1035
+    const RCODE_SERVFAIL        = 2;        // RFC 1035
+    const RCODE_NXDOMAIN        = 3;        // RFC 1035
+    const RCODE_NOTIMP          = 4;        // RFC 1035
+    const RCODE_REFUSED         = 5;        // RFC 1035
+    const RCODE_YXDOMAIN        = 6;        // RFC 2136
+    const RCODE_YXRRSET         = 7;        // RFC 2136
+    const RCODE_NXRRSET         = 8;        // RFC 2136
+    const RCODE_NOTAUTH         = 9;        // RFC 2136
+    const RCODE_NOTZONE         = 10;       // RFC 2136
+
+    // 11-15 reserved
+
+    const RCODE_BADSIG          = 16;       // RFC 2845
+    const RCODE_BADVERS         = 16;       // RFC 6891    
+    const RCODE_BADKEY          = 17;       // RFC 2845
+    const RCODE_BADTIME         = 18;       // RFC 2845
+    const RCODE_BADMODE         = 19;       // RFC 2930
+    const RCODE_BADNAME         = 20;       // RFC 2930
+    const RCODE_BADALG          = 21;       // RFC 2930
+    const RCODE_BADTRUNC        = 22;       // RFC 4635
+    const RCODE_BADCOOKIE       = 23;       // RFC 7873
+
+    /*
+     * internal errors codes returned by the exceptions class
+     */
+    const E_NONE                = 0;
+    const E_DNS_FORMERR         = self::RCODE_FORMERR;
+    const E_DNS_SERVFAIL        = self::RCODE_SERVFAIL;
+    const E_DNS_NXDOMAIN        = self::RCODE_NXDOMAIN;
+    const E_DNS_NOTIMP          = self::RCODE_NOTIMP;
+    const E_DNS_REFUSED         = self::RCODE_REFUSED;
+    const E_DNS_YXDOMAIN        = self::RCODE_YXDOMAIN;
+    const E_DNS_YXRRSET         = self::RCODE_YXRRSET;
+    const E_DNS_NXRRSET         = self::RCODE_NXRRSET;
+    const E_DNS_NOTAUTH         = self::RCODE_NOTAUTH;
+    const E_DNS_NOTZONE         = self::RCODE_NOTZONE;
+
+    // 11-15 reserved
+
+    const E_DNS_BADSIG          = self::RCODE_BADSIG;
+    const E_DNS_BADKEY          = self::RCODE_BADKEY;
+    const E_DNS_BADTIME         = self::RCODE_BADTIME;
+    const E_DNS_BADMODE         = self::RCODE_BADMODE;
+    const E_DNS_BADNAME         = self::RCODE_BADNAME;
+    const E_DNS_BADALG          = self::RCODE_BADALG;
+    const E_DNS_BADTRUNC        = self::RCODE_BADTRUNC;    
+    const E_DNS_BADCOOKIE       = self::RCODE_BADCOOKIE;
+
+    // other error conditions
+
+    const E_NS_INVALID_FILE     = 200;
+    const E_NS_INVALID_ENTRY    = 201;
+    const E_NS_FAILED           = 202;
+    const E_NS_SOCKET_FAILED    = 203;
+    const E_NS_INVALID_SOCKET   = 204;
+
+    const E_PACKET_INVALID      = 300;
+    const E_PARSE_ERROR         = 301;
+    const E_HEADER_INVALID      = 302;
+    const E_QUESTION_INVALID    = 303;
+    const E_RR_INVALID          = 304;
+
+    const E_OPENSSL_ERROR       = 400;
+    const E_OPENSSL_UNAVAIL     = 401;
+    const E_OPENSSL_INV_PKEY    = 402;
+    const E_OPENSSL_INV_ALGO    = 403;
+
+    const E_CACHE_UNSUPPORTED   = 500;
+    const E_CACHE_SHM_FILE      = 501;
+    const E_CACHE_SHM_UNAVAIL   = 502;
+
+    /*
+     * EDNS0 Option Codes (OPT)
+     */
+    // 0 - Reserved
+    const EDNS0_OPT_LLQ             = 1;
+    const EDNS0_OPT_UL              = 2;
+    const EDNS0_OPT_NSID            = 3;
+    // 4 - Reserved
+    const EDNS0_OPT_DAU             = 5;
+    const EDNS0_OPT_DHU             = 6;
+    const EDNS0_OPT_N3U             = 7;
+    const EDNS0_OPT_CLIENT_SUBNET   = 8;
+    const EDNS0_OPT_EXPIRE          = 9;
+    const EDNS0_OPT_COOKIE          = 10;
+    const EDNS0_OPT_TCP_KEEPALIVE   = 11;
+    const EDNS0_OPT_PADDING         = 12;
+    const EDNS0_OPT_CHAIN           = 13;
+
+    /*
+     * DNSSEC Algorithms
+     */
+    const DNSSEC_ALGORITHM_RES                  = 0;
+    const DNSSEC_ALGORITHM_RSAMD5               = 1;
+    const DNSSEC_ALGORITHM_DH                   = 2;
+    const DNSSEC_ALGORITHM_DSA                  = 3;
+    const DNSSEC_ALGORITHM_ECC                  = 4;
+    const DNSSEC_ALGORITHM_RSASHA1              = 5;
+    const DNSSEC_ALGORITHM_DSANSEC3SHA1         = 6;
+    const DSNSEC_ALGORITHM_RSASHA1NSEC3SHA1     = 7;
+    const DNSSEC_ALGORITHM_RSASHA256	        = 8;
+    const DNSSEC_ALGORITHM_RSASHA512            = 10;
+    const DNSSEC_ALGORITHM_ECCGOST              = 12;
+    const DNSSEC_ALGORITHM_INDIRECT             = 252;
+    const DNSSEC_ALGORITHM_PRIVATEDNS           = 253;
+    const DNSSEC_ALGORITHM_PRIVATEOID           = 254;
+
+    /*
+     * DNSSEC Digest Types
+     */
+    const DNSSEC_DIGEST_RES                     = 0;
+    const DNSSEC_DIGEST_SHA1                    = 1;
+
+    /*
+     * The packet id used when sending requests
+     */
+    public static $next_packet_id;
+
+    /*
+     * Used to map resource record types to their id's, and back
+     */
+    public static $rr_types_by_id = array();
+    public static $rr_types_by_name = array(
+
+        'SIG0'          => 0,       // RFC 2931 pseudo type
+        'A'             => 1,       // RFC 1035
+        'NS'            => 2,       // RFC 1035
+        'MD'            => 3,       // RFC 1035 - obsolete, Not implemented
+        'MF'            => 4,       // RFC 1035 - obsolete, Not implemented
+        'CNAME'         => 5,       // RFC 1035
+        'SOA'           => 6,       // RFC 1035
+        'MB'            => 7,       // RFC 1035 - obsolete, Not implemented
+        'MG'            => 8,       // RFC 1035 - obsolete, Not implemented
+        'MR'            => 9,       // RFC 1035 - obsolete, Not implemented
+        'NULL'          => 10,      // RFC 1035 - obsolete, Not implemented
+        'WKS'           => 11,      // RFC 1035
+        'PTR'           => 12,      // RFC 1035
+        'HINFO'         => 13,      // RFC 1035
+        'MINFO'         => 14,      // RFC 1035 - obsolete, Not implemented
+        'MX'            => 15,      // RFC 1035
+        'TXT'           => 16,      // RFC 1035
+        'RP'            => 17,      // RFC 1183
+        'AFSDB'         => 18,      // RFC 1183
+        'X25'           => 19,      // RFC 1183
+        'ISDN'          => 20,      // RFC 1183
+        'RT'            => 21,      // RFC 1183
+        'NSAP'          => 22,      // RFC 1706
+        'NSAP_PTR'      => 23,      // RFC 1348 - obsolete, Not implemented
+        'SIG'           => 24,      // RFC 2535
+        'KEY'           => 25,      // RFC 2535, RFC 2930
+        'PX'            => 26,      // RFC 2163
+        'GPOS'          => 27,      // RFC 1712 - Not implemented
+        'AAAA'          => 28,      // RFC 3596
+        'LOC'           => 29,      // RFC 1876
+        'NXT'           => 30,      // RFC 2065, obsoleted by by RFC 3755
+        'EID'           => 31,      // [Patton][Patton1995]
+        'NIMLOC'        => 32,      // [Patton][Patton1995]
+        'SRV'           => 33,      // RFC 2782
+        'ATMA'          => 34,      // Windows only
+        'NAPTR'         => 35,      // RFC 2915
+        'KX'            => 36,      // RFC 2230
+        'CERT'          => 37,      // RFC 4398
+        'A6'            => 38,      // downgraded to experimental by RFC 3363
+        'DNAME'         => 39,      // RFC 2672
+        'SINK'          => 40,      // Not implemented
+        'OPT'           => 41,      // RFC 2671
+        'APL'           => 42,      // RFC 3123
+        'DS'            => 43,      // RFC 4034
+        'SSHFP'         => 44,      // RFC 4255
+        'IPSECKEY'      => 45,      // RFC 4025
+        'RRSIG'         => 46,      // RFC 4034
+        'NSEC'          => 47,      // RFC 4034
+        'DNSKEY'        => 48,      // RFC 4034
+        'DHCID'         => 49,      // RFC 4701
+        'NSEC3'         => 50,      // RFC 5155
+        'NSEC3PARAM'    => 51,      // RFC 5155
+        'TLSA'          => 52,      // RFC 6698
+        'SMIMEA'        => 53,      // draft-ietf-dane-smime-10
+
+                                    // 54 unassigned
+
+        'HIP'           => 55,      // RFC 5205
+        'NINFO'         => 56,      // Not implemented
+        'RKEY'          => 57,      // Not implemented
+        'TALINK'        => 58,      // 
+        'CDS'           => 59,      // RFC 7344
+        'CDNSKEY'       => 60,      // RFC 7344
+        'OPENPGPKEY'    => 61,      // RFC 7929
+        'CSYNC'         => 62,      // RFC 7477
+
+                                    // 63 - 98 unassigned
+
+        'SPF'           => 99,      // RFC 4408
+        'UINFO'         => 100,     // no RFC, Not implemented
+        'UID'           => 101,     // no RFC, Not implemented
+        'GID'           => 102,     // no RFC, Not implemented
+        'UNSPEC'        => 103,     // no RFC, Not implemented
+        'NID'           => 104,     // RFC 6742
+        'L32'           => 105,     // RFC 6742
+        'L64'           => 106,     // RFC 6742
+        'LP'            => 107,     // RFC 6742
+        'EUI48'         => 108,     // RFC 7043
+        'EUI64'         => 109,     // RFC 7043
+
+                                    // 110 - 248 unassigned
+
+        'TKEY'          => 249,     // RFC 2930
+        'TSIG'          => 250,     // RFC 2845
+        'IXFR'          => 251,     // RFC 1995 - only a full (AXFR) is supported
+        'AXFR'          => 252,     // RFC 1035
+        'MAILB'         => 253,     // RFC 883, Not implemented
+        'MAILA'         => 254,     // RFC 973, Not implemented
+        'ANY'           => 255,     // RFC 1035 - we support both 'ANY' and '*'
+        'URI'           => 256,     // tools.ietf.org/html/draft-faltstrom-uri-06
+        'CAA'           => 257,     // tools.ietf.org/html/draft-ietf-pkix-caa-03
+        'AVC'           => 258,     // Application Visibility and Control
+
+                                    // 259 - 32767 unassigned
+
+        'TA'            => 32768,   // same as DS
+        'DLV'           => 32769    // RFC 4431
+    );
+
+    /*
+     * Qtypes and Metatypes - defined in RFC2929 section 3.1
+     */
+    public static $rr_qtypes_by_id = array();
+    public static $rr_qtypes_by_name = array(
+
+        'IXFR'          => 251,     // RFC 1995 - only a full (AXFR) is supported
+        'AXFR'          => 252,     // RFC 1035
+        'MAILB'         => 253,     // RFC 883, Not implemented
+        'MAILA'         => 254,     // RFC 973, Not implemented
+        'ANY'           => 255      // RFC 1035 - we support both 'ANY' and '*'
+    );
+    
+    public static $rr_metatypes_by_id = array();
+    public static $rr_metatypes_by_name = array(
+
+        'OPT'           => 41,      // RFC 2671
+        'TKEY'          => 249,     // RFC 2930
+        'TSIG'          => 250      // RFC 2845
+    );
+
+    /*
+     * used to map resource record id's to RR class names
+     */
+    public static $rr_types_class_to_id = array();
+    public static $rr_types_id_to_class = array(
+
+        1           => 'Net_DNS2_RR_A',
+        2           => 'Net_DNS2_RR_NS',
+        5           => 'Net_DNS2_RR_CNAME',
+        6           => 'Net_DNS2_RR_SOA',
+        11          => 'Net_DNS2_RR_WKS',
+        12          => 'Net_DNS2_RR_PTR',
+        13          => 'Net_DNS2_RR_HINFO',
+        15          => 'Net_DNS2_RR_MX',
+        16          => 'Net_DNS2_RR_TXT',
+        17          => 'Net_DNS2_RR_RP',
+        18          => 'Net_DNS2_RR_AFSDB',
+        19          => 'Net_DNS2_RR_X25',
+        20          => 'Net_DNS2_RR_ISDN',
+        21          => 'Net_DNS2_RR_RT',
+        22          => 'Net_DNS2_RR_NSAP',
+        24          => 'Net_DNS2_RR_SIG',
+        25          => 'Net_DNS2_RR_KEY',
+        26          => 'Net_DNS2_RR_PX',
+        28          => 'Net_DNS2_RR_AAAA',
+        29          => 'Net_DNS2_RR_LOC',
+        31          => 'Net_DNS2_RR_EID',
+        32          => 'Net_DNS2_RR_NIMLOC',
+        33          => 'Net_DNS2_RR_SRV',
+        34          => 'Net_DNS2_RR_ATMA',
+        35          => 'Net_DNS2_RR_NAPTR',
+        36          => 'Net_DNS2_RR_KX',
+        37          => 'Net_DNS2_RR_CERT',
+        39          => 'Net_DNS2_RR_DNAME',
+        41          => 'Net_DNS2_RR_OPT',
+        42          => 'Net_DNS2_RR_APL',
+        43          => 'Net_DNS2_RR_DS',
+        44          => 'Net_DNS2_RR_SSHFP',
+        45          => 'Net_DNS2_RR_IPSECKEY',
+        46          => 'Net_DNS2_RR_RRSIG',
+        47          => 'Net_DNS2_RR_NSEC',
+        48          => 'Net_DNS2_RR_DNSKEY',
+        49          => 'Net_DNS2_RR_DHCID',
+        50          => 'Net_DNS2_RR_NSEC3',
+        51          => 'Net_DNS2_RR_NSEC3PARAM',
+        52          => 'Net_DNS2_RR_TLSA',
+        53          => 'Net_DNS2_RR_SMIMEA',
+        55          => 'Net_DNS2_RR_HIP',
+        58          => 'Net_DNS2_RR_TALINK',
+        59          => 'Net_DNS2_RR_CDS',
+        60          => 'Net_DNS2_RR_CDNSKEY',
+        61          => 'Net_DNS2_RR_OPENPGPKEY',
+        62          => 'Net_DNS2_RR_CSYNC',
+        99          => 'Net_DNS2_RR_SPF',
+        104         => 'Net_DNS2_RR_NID',
+        105         => 'Net_DNS2_RR_L32',
+        106         => 'Net_DNS2_RR_L64',
+        107         => 'Net_DNS2_RR_LP',
+        108         => 'Net_DNS2_RR_EUI48',
+        109         => 'Net_DNS2_RR_EUI64',
+
+        249         => 'Net_DNS2_RR_TKEY',
+        250         => 'Net_DNS2_RR_TSIG',
+
+    //    251            - IXFR - handled as a full zone transfer (252)
+    //    252            - AXFR - handled as a function call
+
+        255         => 'Net_DNS2_RR_ANY',
+        256         => 'Net_DNS2_RR_URI',
+        257         => 'Net_DNS2_RR_CAA',
+        258         => 'Net_DNS2_RR_AVC',
+        32768       => 'Net_DNS2_RR_TA',
+        32769       => 'Net_DNS2_RR_DLV'
+    );
+
+    /*
+     * used to map resource record class names to their id's, and back
+     */
+    public static $classes_by_id = array();
+    public static $classes_by_name = array(
+
+        'IN'    => self::RR_CLASS_IN,        // RFC 1035
+        'CH'    => self::RR_CLASS_CH,        // RFC 1035
+        'HS'    => self::RR_CLASS_HS,        // RFC 1035
+        'NONE'  => self::RR_CLASS_NONE,      // RFC 2136
+        'ANY'   => self::RR_CLASS_ANY        // RFC 1035
+    );
+
+    /*
+     * maps response codes to error messages
+     */
+    public static $result_code_messages = array(
+
+        self::RCODE_NOERROR     => 'The request completed successfully.',
+        self::RCODE_FORMERR     => 'The name server was unable to interpret the query.',
+        self::RCODE_SERVFAIL    => 'The name server was unable to process this query due to a problem with the name server.',
+        self::RCODE_NXDOMAIN    => 'The domain name referenced in the query does not exist.',
+        self::RCODE_NOTIMP      => 'The name server does not support the requested kind of query.',
+        self::RCODE_REFUSED     => 'The name server refuses to perform the specified operation for policy reasons.',
+        self::RCODE_YXDOMAIN    => 'Name Exists when it should not.',
+        self::RCODE_YXRRSET     => 'RR Set Exists when it should not.',
+        self::RCODE_NXRRSET     => 'RR Set that should exist does not.',
+        self::RCODE_NOTAUTH     => 'Server Not Authoritative for zone.',
+        self::RCODE_NOTZONE     => 'Name not contained in zone.',
+
+        self::RCODE_BADSIG      => 'TSIG Signature Failure.',
+        self::RCODE_BADKEY      => 'Key not recognized.',
+        self::RCODE_BADTIME     => 'Signature out of time window.',
+        self::RCODE_BADMODE     => 'Bad TKEY Mode.',
+        self::RCODE_BADNAME     => 'Duplicate key name.',
+        self::RCODE_BADALG      => 'Algorithm not supported.',
+        self::RCODE_BADTRUNC    => 'Bad truncation.'
+    );
+
+    /*
+     * maps DNS SEC alrorithms to their mnemonics
+     */
+    public static $algorithm_name_to_id = array();
+    public static $algorithm_id_to_name = array(
+    
+        self::DNSSEC_ALGORITHM_RES                  => 'RES',
+        self::DNSSEC_ALGORITHM_RSAMD5               => 'RSAMD5',
+        self::DNSSEC_ALGORITHM_DH                   => 'DH',
+        self::DNSSEC_ALGORITHM_DSA                  => 'DSA',
+        self::DNSSEC_ALGORITHM_ECC                  => 'ECC',
+        self::DNSSEC_ALGORITHM_RSASHA1              => 'RSASHA1',
+        self::DNSSEC_ALGORITHM_DSANSEC3SHA1         => 'DSA-NSEC3-SHA1',
+        self::DSNSEC_ALGORITHM_RSASHA1NSEC3SHA1     => 'RSASHA1-NSEC3-SHA1',
+        self::DNSSEC_ALGORITHM_RSASHA256            => 'RSASHA256',
+        self::DNSSEC_ALGORITHM_RSASHA512            => 'RSASHA512',
+        self::DNSSEC_ALGORITHM_ECCGOST              => 'ECC-GOST',
+        self::DNSSEC_ALGORITHM_INDIRECT             => 'INDIRECT',
+        self::DNSSEC_ALGORITHM_PRIVATEDNS           => 'PRIVATEDNS',
+        self::DNSSEC_ALGORITHM_PRIVATEOID           => 'PRIVATEOID'
+    );
+
+    /*
+     * maps DNSSEC digest types to their mnemonics
+     */
+    public static $digest_name_to_id = array();
+    public static $digest_id_to_name = array(
+
+        self::DNSSEC_DIGEST_RES         => 'RES',
+        self::DNSSEC_DIGEST_SHA1        => 'SHA-1'
+    );
+
+    /*
+     * Protocols names - RFC 1010
+     */
+    public static $protocol_by_id = array();
+    public static $protocol_by_name = array(
+
+        'ICMP'          => 1,
+        'IGMP'          => 2,
+        'GGP'           => 3,
+        'ST'            => 5,
+        'TCP'           => 6,
+        'UCL'           => 7,
+        'EGP'           => 8,
+        'IGP'           => 9,
+        'BBN-RCC-MON'   => 10,
+        'NVP-II'        => 11,
+        'PUP'           => 12,
+        'ARGUS'         => 13,
+        'EMCON'         => 14,
+        'XNET'          => 15,
+        'CHAOS'         => 16,
+        'UDP'           => 17,
+        'MUX'           => 18,
+        'DCN-MEAS'      => 19,
+        'HMP'           => 20,
+        'PRM'           => 21,
+        'XNS-IDP'       => 22,
+        'TRUNK-1'       => 23,
+        'TRUNK-2'       => 24,
+        'LEAF-1'        => 25,
+        'LEAF-2'        => 26,
+        'RDP'           => 27,
+        'IRTP'          => 28,
+        'ISO-TP4'       => 29,
+        'NETBLT'        => 30,
+        'MFE-NSP'       => 31,
+        'MERIT-INP'     => 32,
+        'SEP'           => 33,
+        // 34 - 60      - Unassigned
+        // 61           - any host internal protocol
+        'CFTP'          => 62,
+        // 63           - any local network
+        'SAT-EXPAK'     => 64,
+        'MIT-SUBNET'    => 65,
+        'RVD'           => 66,
+        'IPPC'          => 67,
+        // 68           - any distributed file system
+        'SAT-MON'       => 69,
+        // 70           - Unassigned
+        'IPCV'          => 71,
+        // 72 - 75      - Unassigned
+        'BR-SAT-MON'    => 76,
+        // 77           - Unassigned
+        'WB-MON'        => 78,
+        'WB-EXPAK'      => 79
+        // 80 - 254     - Unassigned
+        // 255          - Reserved
+    );
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Packet.php

@@ -0,0 +1,434 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ * This file contains code based off the Net::DNS Perl module by
+ * Michael Fuhr.
+ *
+ * This is the copyright notice from the PERL Net::DNS module:
+ *
+ * Copyright (c) 1997-2000 Michael Fuhr.  All rights reserved.  This
+ * program is free software; you can redistribute it and/or modify it
+ * under the same terms as Perl itself.
+ *
+ */
+
+/**
+ * This is the base class that holds a standard DNS packet.
+ *
+ * The Net_DNS2_Packet_Request and Net_DNS2_Packet_Response classes extend this
+ * class.
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_Packet_Request, Net_DNS2_Packet_Response
+ *
+ */
+class Net_DNS2_Packet
+{
+    /*
+     * the full binary data and length for this packet
+     */
+    public $rdata;
+    public $rdlength;
+
+    /*
+     * the offset pointer used when building/parsing packets
+     */
+    public $offset = 0;
+
+    /*
+     * Net_DNS2_Header object with the DNS packet header
+     */
+    public $header;
+
+    /*
+     * array of Net_DNS2_Question objects
+     *
+     * used as "zone" for updates per RFC2136
+     *
+     */
+    public $question = array();
+
+    /*
+     * array of Net_DNS2_RR Objects for Answers
+     * 
+     * used as "prerequisite" for updates per RFC2136
+     *
+     */
+    public $answer = array();
+
+    /*
+     * array of Net_DNS2_RR Objects for Authority
+     *
+     * used as "update" for updates per RFC2136
+     *
+     */
+    public $authority = array();
+
+    /*
+     * array of Net_DNS2_RR Objects for Addtitional
+     */
+    public $additional = array();
+
+    /*
+     * array of compressed labeles
+     */
+    private $_compressed = array();
+
+    /**
+     * magic __toString() method to return the Net_DNS2_Packet as a string
+     *
+     * @return string
+     * @access public
+     *
+     */
+    public function __toString()
+    {
+        $output = $this->header->__toString();
+
+        foreach ($this->question as $x) {
+
+            $output .= $x->__toString() . "\n";
+        }
+        foreach ($this->answer as $x) {
+
+            $output .= $x->__toString() . "\n";
+        }
+        foreach ($this->authority as $x) {
+
+            $output .= $x->__toString() . "\n";
+        }
+        foreach ($this->additional as $x) {
+
+            $output .= $x->__toString() . "\n";
+        }
+
+        return $output;
+    }
+
+    /**
+     * returns a full binary DNS packet
+     *
+     * @return string
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function get()
+    {
+        $data = $this->header->get($this);
+
+        foreach ($this->question as $x) {
+
+            $data .= $x->get($this);
+        }
+        foreach ($this->answer as $x) {
+
+            $data .= $x->get($this);
+        }
+        foreach ($this->authority as $x) {
+
+            $data .= $x->get($this);
+        }
+        foreach ($this->additional as $x) {
+
+            $data .= $x->get($this);
+        }
+
+        return $data;
+    }
+
+    /**
+     * applies a standard DNS name compression on the given name/offset
+     *
+     * This logic was based on the Net::DNS::Packet::dn_comp() function 
+     * by Michanel Fuhr
+     *
+     * @param string  $name    the name to be compressed
+     * @param integer &$offset the offset into the given packet object
+     *
+     * @return string
+     * @access public
+     *
+     */
+    public function compress($name, &$offset)
+    {
+        $names    = explode('.', $name);
+        $compname = '';
+
+        while (!empty($names)) {
+
+            $dname = join('.', $names);
+
+            if (isset($this->_compressed[$dname])) {
+
+                $compname .= pack('n', 0xc000 | $this->_compressed[$dname]);
+                $offset += 2;
+
+                break;
+            }
+
+            $this->_compressed[$dname] = $offset;
+            $first = array_shift($names);
+
+            $length = strlen($first);
+            if ($length <= 0) {
+                continue;
+            }
+        
+            //
+            // truncate see RFC1035 2.3.1
+            //
+            if ($length > 63) {
+
+                $length = 63;
+                $first = substr($first, 0, $length);
+            }
+
+            $compname .= pack('Ca*', $length, $first);
+            $offset += $length + 1;
+        }
+
+        if (empty($names)) {
+
+            $compname .= pack('C', 0);
+            $offset++;
+        }
+
+        return $compname;
+    }
+
+    /**
+     * applies a standard DNS name compression on the given name/offset
+     *
+     * This logic was based on the Net::DNS::Packet::dn_comp() function 
+     * by Michanel Fuhr
+     *
+     * @param string $name the name to be compressed
+     *
+     * @return string
+     * @access public
+     *
+     */
+    public static function pack($name)
+    {
+        $offset = 0;
+        $names = explode('.', $name);
+        $compname = '';
+
+        while (!empty($names)) {
+
+            $first = array_shift($names);
+            $length = strlen($first);
+
+            $compname .= pack('Ca*', $length, $first);
+            $offset += $length + 1;
+        }
+
+        $compname .= "\0";
+        $offset++;
+
+        return $compname;
+    }
+
+    /**
+     * expands the domain name stored at a given offset in a DNS Packet
+     *
+     * This logic was based on the Net::DNS::Packet::dn_expand() function
+     * by Michanel Fuhr
+     *
+     * @param Net_DNS2_Packet &$packet the DNS packet to look in for the domain name
+     * @param integer         &$offset the offset into the given packet object
+     *
+     * @return mixed either the domain name or null if it's not found.
+     * @access public
+     *
+     */
+    public static function expand(Net_DNS2_Packet &$packet, &$offset)
+    {
+        $name = '';
+
+        while (1) {
+            if ($packet->rdlength < ($offset + 1)) {
+                return null;
+            }
+            
+            $xlen = ord($packet->rdata[$offset]);
+            if ($xlen == 0) {
+
+                ++$offset;
+                break;
+
+            } else if (($xlen & 0xc0) == 0xc0) {
+                if ($packet->rdlength < ($offset + 2)) {
+
+                    return null;
+                }
+
+                $ptr = ord($packet->rdata[$offset]) << 8 | 
+                    ord($packet->rdata[$offset+1]);
+                $ptr = $ptr & 0x3fff;
+
+                $name2 = Net_DNS2_Packet::expand($packet, $ptr);
+                if (is_null($name2)) {
+
+                    return null;
+                }
+
+                $name .= $name2;
+                $offset += 2;
+    
+                break;
+            } else {
+                ++$offset;
+
+                if ($packet->rdlength < ($offset + $xlen)) {
+
+                    return null;
+                }
+
+                $elem = '';
+                $elem = substr($packet->rdata, $offset, $xlen);
+                $name .= $elem . '.';
+                $offset += $xlen;
+            }
+        }
+
+        return trim($name, '.');
+    }
+
+    /**
+     * parses a domain label from a DNS Packet at the given offset
+     *
+     * @param Net_DNS2_Packet &$packet the DNS packet to look in for the domain name
+     * @param integer         &$offset the offset into the given packet object
+     *
+     * @return mixed either the domain name or null if it's not found.
+     * @access public
+     *
+     */
+    public static function label(Net_DNS2_Packet &$packet, &$offset)
+    {
+        $name = '';
+
+        if ($packet->rdlength < ($offset + 1)) {
+
+            return null;
+        }
+
+        $xlen = ord($packet->rdata[$offset]);
+        ++$offset;
+
+        if (($xlen + $offset) > $packet->rdlength) {
+
+            $name = substr($packet->rdata, $offset);
+            $offset = $packet->rdlength;
+        } else {
+
+            $name = substr($packet->rdata, $offset, $xlen);
+            $offset += $xlen;
+        }
+
+        return $name;
+    }
+
+    /**
+     * copies the contents of the given packet, to the local packet object. this
+     * function intentionally ignores some of the packet data.
+     *
+     * @param Net_DNS2_Packet $packet the DNS packet to copy the data from
+     *
+     * @return boolean
+     * @access public
+     *
+     */
+    public function copy(Net_DNS2_Packet $packet)
+    {
+        $this->header       = $packet->header;
+        $this->question     = $packet->question;
+        $this->answer       = $packet->answer;
+        $this->authority    = $packet->authority;
+        $this->additional   = $packet->additional;
+
+        return true;
+    }
+
+    /**
+     * resets the values in the current packet object
+     *
+     * @return boolean
+     * @access public
+     *
+     */
+    public function reset()
+    {
+        $this->header->id   = $this->header->nextPacketId();
+        $this->rdata        = '';
+        $this->rdlength     = 0;
+        $this->offset       = 0;
+        $this->answer       = array();
+        $this->authority    = array();
+        $this->additional   = array();
+        $this->_compressed  = array();
+    
+        return true;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Packet/Request.php

@@ -0,0 +1,217 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+
+/**
+ * This class handles building new DNS request packets; packets used for DNS
+ * queries and updates.
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_Packet
+ *   
+ */
+class Net_DNS2_Packet_Request extends Net_DNS2_Packet
+{
+    /**
+     * Constructor - builds a new Net_DNS2_Packet_Request object
+     *
+     * @param string $name  the domain name for the packet
+     * @param string $type  the DNS RR type for the packet
+     * @param string $class the DNS class for the packet
+     *
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function __construct($name, $type = null, $class = null)
+    {
+        $this->set($name, $type, $class);
+    }
+
+    /**
+     * builds a new Net_DNS2_Packet_Request object
+     *
+     * @param string $name  the domain name for the packet
+     * @param string $type  the DNS RR type for the packet
+     * @param string $class the DNS class for the packet
+     *
+     * @return boolean
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function set($name, $type = 'A', $class = 'IN')
+    {
+        //
+        // generate a new header
+        //
+        $this->header = new Net_DNS2_Header;
+
+        //
+        // add a new question
+        //
+        $q = new Net_DNS2_Question();
+
+        //
+        // allow queries directly to . for the root name servers
+        //
+        if ($name != '.') {
+            $name = trim(strtolower($name), " \t\n\r\0\x0B.");
+        }
+
+        $type = strtoupper(trim($type));
+        $class = strtoupper(trim($class));
+
+        //
+        // check that the input string has some data in it
+        //
+        if (empty($name)) {
+
+            throw new Net_DNS2_Exception(
+                'empty query string provided',
+                Net_DNS2_Lookups::E_PACKET_INVALID
+            );
+        }
+
+        //
+        // if the type is "*", rename it to "ANY"- both are acceptable.
+        //
+        if ($type == '*') {
+
+            $type = 'ANY';
+        }
+
+        //
+        // check that the type and class are valid
+        //    
+        if (   (!isset(Net_DNS2_Lookups::$rr_types_by_name[$type])) 
+            || (!isset(Net_DNS2_Lookups::$classes_by_name[$class])) 
+        ) {
+            throw new Net_DNS2_Exception(
+                'invalid type (' . $type . ') or class (' . $class . ') specified.',
+                Net_DNS2_Lookups::E_PACKET_INVALID
+            );
+        }
+
+        if ($type == 'PTR') {
+
+            //
+            // if it's a PTR request for an IP address, then make sure we tack on
+            // the arpa domain.
+            //
+            // there are other types of PTR requests, so if an IP adress doesn't match,
+            // then just let it flow through and assume it's a hostname
+            //
+            if (Net_DNS2::isIPv4($name) == true) {
+
+                //
+                // IPv4
+                //
+                $name = implode('.', array_reverse(explode('.', $name)));
+                $name .= '.in-addr.arpa';
+
+            } else if (Net_DNS2::isIPv6($name) == true) {
+
+                //
+                // IPv6
+                //
+                $e = Net_DNS2::expandIPv6($name);
+                if ($e !== false) {
+
+                    $name = implode(
+                        '.', array_reverse(str_split(str_replace(':', '', $e)))
+                    );
+
+                    $name .= '.ip6.arpa';
+
+                } else {
+
+                    throw new Net_DNS2_Exception(
+                        'unsupported PTR value: ' . $name,
+                        Net_DNS2_Lookups::E_PACKET_INVALID
+                    );
+                }
+            }
+        }
+
+        //
+        // store the data
+        //
+        $q->qname           = $name;
+        $q->qtype           = $type;
+        $q->qclass          = $class;        
+
+        $this->question[]   = $q;
+
+        //
+        // the answer, authority and additional are empty; they can be modified
+        // after the request is created for UPDATE requests if needed.
+        //
+        $this->answer       = array();
+        $this->authority    = array();
+        $this->additional   = array();
+
+        return true;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Packet/Response.php

@@ -0,0 +1,194 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+
+/**
+ * This class handles building new DNS response packets; it parses binary packed
+ * packets that come off the wire
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_Packet
+ * 
+ */
+class Net_DNS2_Packet_Response extends Net_DNS2_Packet
+{
+    /*
+     * The name servers that this response came from
+     */
+    public $answer_from;
+
+    /*
+     * The socket type the answer came from (TCP/UDP)
+     */
+    public $answer_socket_type;
+
+    /*
+     * The query response time in microseconds
+     */
+    public $response_time = 0;
+
+    /**
+     * Constructor - builds a new Net_DNS2_Packet_Response object
+     *
+     * @param string  $data binary DNS packet
+     * @param integer $size the length of the DNS packet
+     *
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function __construct($data, $size)
+    {
+        $this->set($data, $size);
+    }
+
+    /**
+     * builds a new Net_DNS2_Packet_Response object
+     *
+     * @param string  $data binary DNS packet
+     * @param integer $size the length of the DNS packet
+     *
+     * @return boolean
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function set($data, $size)
+    {
+        //
+        // store the full packet
+        //
+        $this->rdata    = $data;
+        $this->rdlength = $size;
+
+        //
+        // parse the header
+        // 
+        // we don't bother checking the size earlier, because the first thing the
+        // header class does, is check the size and throw and exception if it's
+        // invalid.
+        //
+        $this->header = new Net_DNS2_Header($this);
+
+        //
+        // if the truncation bit is set, then just return right here, because the
+        // rest of the packet is probably empty; and there's no point in processing
+        // anything else.
+        //
+        // we also don't need to worry about checking to see if the the header is 
+        // null or not, since the Net_DNS2_Header() constructor will throw an 
+        // exception if the packet is invalid.
+        //
+        if ($this->header->tc == 1) {
+
+            return false;
+        }
+
+        //
+        // parse the questions
+        //
+        for ($x = 0; $x < $this->header->qdcount; ++$x) {
+
+            $this->question[$x] = new Net_DNS2_Question($this);
+        }
+
+        //
+        // parse the answers
+        //
+        for ($x = 0; $x < $this->header->ancount; ++$x) {
+
+            $o = Net_DNS2_RR::parse($this);
+            if (!is_null($o)) {
+
+                $this->answer[] = $o;
+            }
+        } 
+
+        //
+        // parse the authority section
+        //
+        for ($x = 0; $x < $this->header->nscount; ++$x) {
+
+            $o = Net_DNS2_RR::parse($this);
+            if (!is_null($o)) {
+
+                $this->authority[] = $o;  
+            }
+        }
+
+        //
+        // parse the additional section
+        //
+        for ($x = 0; $x < $this->header->arcount; ++$x) {
+
+            $o = Net_DNS2_RR::parse($this);
+            if (!is_null($o)) {
+
+                $this->additional[] = $o; 
+            }
+        }
+
+        return true;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/PrivateKey.php

@@ -0,0 +1,424 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2011 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.1.0
+ *
+ */
+
+/**
+ * SSL Private Key container class
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * 
+ */
+class Net_DNS2_PrivateKey
+{
+    /*
+     * the filename that was loaded; stored for reference
+     */
+    public $filename;
+
+    /*
+     * the keytag for the signature
+     */
+    public $keytag;
+
+    /*
+     * the sign name for the signature
+     */
+    public $signname;
+
+    /*
+     * the algorithm used for the signature
+     */
+    public $algorithm;
+
+    /*
+     * the key format fo the signature
+     */
+    public $key_format;
+
+    /*
+     * the openssl private key id
+     */
+    public $instance;
+
+    /*
+     * RSA: modulus
+     */
+    private $_modulus;
+
+    /*
+     * RSA: public exponent
+     */
+    private $_public_exponent;
+
+    /*
+     * RSA: rivate exponent
+     */
+    private $_private_exponent;
+
+    /*
+     * RSA: prime1
+     */
+    private $_prime1;
+
+    /*
+     * RSA: prime2
+     */
+    private $_prime2;
+
+    /*
+     * RSA: exponent 1
+     */
+    private $_exponent1;
+
+    /*
+     * RSA: exponent 2
+     */
+    private $_exponent2;
+
+    /*
+     * RSA: coefficient
+     */
+    private $_coefficient;
+
+    /*
+     * DSA: prime
+     */
+    public $prime;
+    
+    /*
+     * DSA: subprime
+     */
+    public $subprime;
+
+    /*
+     * DSA: base
+     */
+    public $base;
+
+    /*
+     * DSA: private value
+     */
+    public $private_value;
+
+    /*
+     * DSA: public value
+     */
+    public $public_value;
+
+    /**
+     * Constructor - base constructor the private key container class
+     * 
+     * @param string $file path to a private-key file to parse and load
+     *
+     * @throws Net_DNS2_Exception
+     * @access public
+     * 
+     */
+    public function __construct($file = null)
+    {
+        if (isset($file)) {
+            $this->parseFile($file);
+        }
+    }
+
+    /**
+     * parses a private key file generated by dnssec-keygen
+     * 
+     * @param string $file path to a private-key file to parse and load
+     *
+     * @return boolean
+     * @throws Net_DNS2_Exception
+     * @access public
+     * 
+     */
+    public function parseFile($file)
+    {
+        //
+        // check for OpenSSL
+        //
+        if (extension_loaded('openssl') === false) {
+
+            throw new Net_DNS2_Exception(
+                'the OpenSSL extension is required to use parse private key.',
+                Net_DNS2_Lookups::E_OPENSSL_UNAVAIL
+            );
+        }
+
+        //
+        // check to make sure the file exists
+        //
+        if (is_readable($file) == false) {
+
+            throw new Net_DNS2_Exception(
+                'invalid private key file: ' . $file,
+                Net_DNS2_Lookups::E_OPENSSL_INV_PKEY
+            );
+        }
+
+        //
+        // get the base filename, and parse it for the local value
+        //
+        $keyname = basename($file);
+        if (strlen($keyname) == 0) {
+
+            throw new Net_DNS2_Exception(
+                'failed to get basename() for: ' . $file,
+                Net_DNS2_Lookups::E_OPENSSL_INV_PKEY
+            );
+        }
+
+        //
+        // parse the keyname
+        //
+        if (preg_match("/K(.*)\.\+(\d{3})\+(\d*)\.private/", $keyname, $matches)) {
+            
+            $this->signname    = $matches[1];
+            $this->algorithm   = intval($matches[2]);
+            $this->keytag      = intval($matches[3]);
+
+        } else {
+
+            throw new Net_DNS2_Exception(
+                'file ' . $keyname . ' does not look like a private key file!',
+                Net_DNS2_Lookups::E_OPENSSL_INV_PKEY
+            );
+        }
+
+        //
+        // read all the data from the
+        //
+        $data = file($file, FILE_IGNORE_NEW_LINES|FILE_SKIP_EMPTY_LINES);
+        if (count($data) == 0) {
+            
+            throw new Net_DNS2_Exception(
+                'file ' . $keyname . ' is empty!',
+                Net_DNS2_Lookups::E_OPENSSL_INV_PKEY
+            );
+        }
+
+        foreach ($data as $line) {
+
+            list($key, $value) = explode(':', $line);
+
+            $key    = trim($key);
+            $value  = trim($value);
+
+            switch(strtolower($key)) {
+
+            case 'private-key-format':
+                $this->_key_format = $value;
+                break;
+
+            case 'algorithm':
+                if ($this->algorithm != $value) {
+                    throw new Net_DNS2_Exception(
+                        'Algorithm mis-match! filename is ' . $this->algorithm . 
+                        ', contents say ' . $value,
+                        Net_DNS2_Lookups::E_OPENSSL_INV_ALGO
+                    );
+                }
+                break;
+
+            //
+            // RSA
+            //
+            case 'modulus':
+                $this->_modulus = $value;
+                break;
+
+            case 'publicexponent':
+                $this->_public_exponent = $value;
+                break;
+
+            case 'privateexponent':
+                $this->_private_exponent = $value;
+                break;
+        
+            case 'prime1':
+                $this->_prime1 = $value;
+                break;
+
+            case 'prime2':
+                $this->_prime2 = $value;
+                break;
+
+            case 'exponent1':
+                $this->_exponent1 = $value;
+                break;
+
+            case 'exponent2':
+                $this->_exponent2 = $value;
+                break;
+
+            case 'coefficient':
+                $this->_coefficient = $value;
+                break;
+
+            //
+            // DSA - this won't work in PHP until the OpenSSL extension is better
+            //
+            case 'prime(p)':
+                $this->prime = $value;
+                break;
+
+            case 'subprime(q)':
+                $this->subprime = $value;
+                break;
+
+            case 'base(g)':
+                $this->base = $value;
+                break;
+
+            case 'private_value(x)':
+                $this->private_value = $value;
+                break;
+
+            case 'public_value(y)':
+                $this->public_value = $value;
+                break;
+
+            default:
+                throw new Net_DNS2_Exception(
+                    'unknown private key data: ' . $key . ': ' . $value,
+                    Net_DNS2_Lookups::E_OPENSSL_INV_PKEY
+                );
+            }
+        }
+
+        //
+        // generate the private key
+        //
+        $args = array();
+
+        switch($this->algorithm) {
+        
+        //
+        // RSA
+        //
+        case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSAMD5:
+        case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSASHA1:
+        case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSASHA256:
+        case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSASHA512:
+
+            $args = array(
+
+                'rsa' => array(
+
+                    'n'                 => base64_decode($this->_modulus),
+                    'e'                 => base64_decode($this->_public_exponent),
+                    'd'                 => base64_decode($this->_private_exponent),
+                    'p'                 => base64_decode($this->_prime1),
+                    'q'                 => base64_decode($this->_prime2),
+                    'dmp1'              => base64_decode($this->_exponent1),
+                    'dmq1'              => base64_decode($this->_exponent2),
+                    'iqmp'              => base64_decode($this->_coefficient)
+                )
+            );
+
+            break;
+
+        //
+        // DSA - this won't work in PHP until the OpenSSL extension is better
+        //
+        case Net_DNS2_Lookups::DNSSEC_ALGORITHM_DSA:
+
+            $args = array(
+
+                'dsa' => array(
+
+                    'p'                 => base64_decode($this->prime),
+                    'q'                 => base64_decode($this->subprime),
+                    'g'                 => base64_decode($this->base),
+                    'priv_key'          => base64_decode($this->private_value),
+                    'pub_key'           => base64_decode($this->public_value)
+                )
+            );
+
+            break;
+
+        default:
+            throw new Net_DNS2_Exception(
+                'we only currently support RSAMD5 and RSASHA1 encryption.',
+                Net_DNS2_Lookups::E_OPENSSL_INV_PKEY
+            );
+        }
+
+        //
+        // generate and store the key
+        //
+        $this->instance = openssl_pkey_new($args);
+        if ($this->instance === false) {
+            throw new Net_DNS2_Exception(
+                openssl_error_string(),
+                Net_DNS2_Lookups::E_OPENSSL_ERROR
+            );
+        }
+
+        //
+        // store the filename incase we need it for something
+        //
+        $this->filename = $file;
+
+        return true;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/Question.php

@@ -0,0 +1,244 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * This class handles parsing and constructing the question sectino of DNS
+ * packets.
+ *
+ * This is referred to as the "zone" for update per RFC2136
+ *
+ * DNS question format - RFC1035 section 4.1.2
+ *
+ *      0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                                               |
+ *    /                     QNAME                     /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                     QTYPE                     |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                     QCLASS                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_Packet
+ *
+ */
+class Net_DNS2_Question
+{
+    /*
+     * The name of the question
+     *
+     * referred to as "zname" for updates per RFC2136
+     *
+     */
+    public $qname;
+
+    /*
+     * The RR type for the questino
+     *
+     * referred to as "ztype" for updates per RFC2136
+     *
+     */
+    public $qtype;
+    
+    /*
+     * The RR class for the questino
+     *
+     * referred to as "zclass" for updates per RFC2136
+     *
+     */
+    public $qclass;
+
+    /**
+     * Constructor - builds a new Net_DNS2_Question object
+     *
+     * @param mixed &$packet either a Net_DNS2_Packet object, or null to 
+     *                       build an empty object
+     *
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function __construct(Net_DNS2_Packet &$packet = null)
+    {
+        if (!is_null($packet)) {
+
+            $this->set($packet);
+        } else {
+
+            $this->qname    = '';
+            $this->qtype    = 'A';
+            $this->qclass   = 'IN';
+        }
+    }
+
+    /**
+     * magic __toString() function to return the Net_DNS2_Question object as a string
+     *
+     * @return string
+     * @access public
+     *
+     */
+    public function __toString()
+    {
+        return ";;\n;; Question:\n;;\t " . $this->qname . '. ' . 
+            $this->qtype . ' ' . $this->qclass . "\n";
+    }
+
+    /**
+     * builds a new Net_DNS2_Header object from a Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet object
+     *
+     * @return boolean
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function set(Net_DNS2_Packet &$packet)
+    {
+        //
+        // expand the name
+        //
+        $this->qname = $packet->expand($packet, $packet->offset);
+        if ($packet->rdlength < ($packet->offset + 4)) {
+
+            throw new Net_DNS2_Exception(
+                'invalid question section: to small',
+                Net_DNS2_Lookups::E_QUESTION_INVALID
+            );
+        }
+
+        //
+        // unpack the type and class
+        //
+        $type   = ord($packet->rdata[$packet->offset++]) << 8 | 
+            ord($packet->rdata[$packet->offset++]);
+        $class  = ord($packet->rdata[$packet->offset++]) << 8 | 
+            ord($packet->rdata[$packet->offset++]);
+
+        //
+        // validate it
+        //
+        $type_name  = Net_DNS2_Lookups::$rr_types_by_id[$type];
+        $class_name = Net_DNS2_Lookups::$classes_by_id[$class];
+
+        if ( (!isset($type_name)) || (!isset($class_name)) ) {
+
+            throw new Net_DNS2_Exception(
+                'invalid question section: invalid type (' . $type . 
+                ') or class (' . $class . ') specified.',
+                Net_DNS2_Lookups::E_QUESTION_INVALID
+            );
+        }
+
+        //
+        // store it
+        //
+        $this->qtype     = $type_name;
+        $this->qclass    = $class_name;
+
+        return true;
+    }
+
+    /**
+     * returns a binary packed Net_DNS2_Question object
+     *
+     * @param Net_DNS2_Packet &$packet the Net_DNS2_Packet object this question is 
+     *                                 part of. This needs to be passed in so that
+     *                                 the compressed qname value can be packed in
+     *                                 with the names of the other parts of the 
+     *                                 packet.
+     *
+     * @return string
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function get(Net_DNS2_Packet &$packet)
+    {
+        //
+        // validate the type and class
+        //
+        $type  = Net_DNS2_Lookups::$rr_types_by_name[$this->qtype];
+        $class = Net_DNS2_Lookups::$classes_by_name[$this->qclass];
+
+        if ( (!isset($type)) || (!isset($class)) ) {
+
+            throw new Net_DNS2_Exception(
+                'invalid question section: invalid type (' . $this->qtype . 
+                ') or class (' . $this->qclass . ') specified.',
+                Net_DNS2_Lookups::E_QUESTION_INVALID
+            );
+        }
+
+        $data = $packet->compress($this->qname, $packet->offset);
+
+        $data .= chr($type >> 8) . chr($type) . chr($class >> 8) . chr($class);
+        $packet->offset += 4;
+
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR.php

@@ -0,0 +1,644 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+
+/**
+ * This is the base class for DNS Resource Records
+ *
+ * Each resource record type (defined in RR/*.php) extends this class for
+ * base functionality.
+ *
+ * This class handles parsing and constructing the common parts of the DNS
+ * resource records, while the RR specific functionality is handled in each
+ * child class.
+ *
+ * DNS resource record format - RFC1035 section 4.1.3
+ *
+ *      0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                                               |
+ *    /                                               /
+ *    /                      NAME                     /
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                      TYPE                     |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                     CLASS                     |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                      TTL                      |
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                   RDLENGTH                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--|
+ *    /                     RDATA                     /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ *
+ */
+abstract class Net_DNS2_RR
+{
+    /*
+     * The name of the resource record
+     */
+    public $name;
+
+    /*
+     * The resource record type
+     */
+    public $type;
+
+    /*
+     * The resouce record class
+     */
+    public $class;
+
+    /*
+     * The time to live for this resource record
+     */
+    public $ttl;
+
+    /*
+     * The length of the rdata field
+     */
+    public $rdlength;
+
+    /*
+     * The resource record specific data as a packed binary string
+     */
+    public $rdata;
+
+    /**
+     * abstract definition - method to return a RR as a string; not to 
+     * be confused with the __toString() magic method.
+     *
+     * @return string
+     * @access protected
+     *
+     */
+    abstract protected function rrToString();
+
+    /**
+     * abstract definition - parses a RR from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    abstract protected function rrFromString(array $rdata);
+
+    /**
+     * abstract definition - sets a Net_DNS2_RR from a Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    abstract protected function rrSet(Net_DNS2_Packet &$packet);
+
+    /**
+     * abstract definition - returns a binary packet DNS RR object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for 
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed string or 
+     *                                 null on failure
+     * @access protected
+     *
+     */
+    abstract protected function rrGet(Net_DNS2_Packet &$packet);
+
+    /**
+     * Constructor - builds a new Net_DNS2_RR object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet or null to create 
+     *                                 an empty object
+     * @param array           $rr      an array with RR parse values or null to 
+     *                                 create an empty object
+     *
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function __construct(Net_DNS2_Packet &$packet = null, array $rr = null)
+    {
+        if ( (!is_null($packet)) && (!is_null($rr)) ) {
+
+            if ($this->set($packet, $rr) == false) {
+
+                throw new Net_DNS2_Exception(
+                    'failed to generate resource record',
+                    Net_DNS2_Lookups::E_RR_INVALID
+                );
+            }
+        } else {
+
+            $class = Net_DNS2_Lookups::$rr_types_class_to_id[get_class($this)];
+            if (isset($class)) {
+
+                $this->type = Net_DNS2_Lookups::$rr_types_by_id[$class];
+            }
+
+            $this->class    = 'IN';
+            $this->ttl      = 86400;
+        }
+    }
+
+    /**
+     * magic __toString() method to return the Net_DNS2_RR object object as a string
+     *
+     * @return string
+     * @access public
+     *
+     */
+    public function __toString()
+    {
+        return $this->name . '. ' . $this->ttl . ' ' . $this->class . 
+            ' ' . $this->type . ' ' . $this->rrToString();
+    }
+
+    /**
+     * return a formatted string; if a string has spaces in it, then return 
+     * it with double quotes around it, otherwise, return it as it was passed in.
+     *
+     * @param string $string the string to format
+     *
+     * @return string
+     * @access protected
+     *
+     */
+    protected function formatString($string)
+    {
+        return '"' . str_replace('"', '\"', trim($string, '"')) . '"';
+    }
+    
+    /**
+     * builds an array of strings from an array of chunks of text split by spaces
+     *
+     * @param array $chunks an array of chunks of text split by spaces
+     *
+     * @return array
+     * @access protected
+     *
+     */
+    protected function buildString(array $chunks)
+    {
+        $data = array();
+        $c = 0;
+        $in = false;
+
+        foreach ($chunks as $r) {
+
+            $r = trim($r);
+            if (strlen($r) == 0) {
+                continue;
+            }
+
+            if ( ($r[0] == '"')
+                && ($r[strlen($r) - 1] == '"')
+                && ($r[strlen($r) - 2] != '\\')
+            ) {
+
+                $data[$c] = $r;
+                ++$c;
+                $in = false;
+
+            } else if ($r[0] == '"') {
+
+                $data[$c] = $r;
+                $in = true;
+
+            } else if ( ($r[strlen($r) - 1] == '"')
+                && ($r[strlen($r) - 2] != '\\')
+            ) {
+            
+                $data[$c] .= ' ' . $r;
+                ++$c;  
+                $in = false;
+
+            } else {
+
+                if ($in == true) {
+                    $data[$c] .= ' ' . $r;
+                } else {
+                    $data[$c++] = $r;
+                }
+            }
+        }        
+
+        foreach ($data as $index => $string) {
+            
+            $data[$index] = str_replace('\"', '"', trim($string, '"'));
+        }
+
+        return $data;
+    }
+
+    /**
+     * builds a new Net_DNS2_RR object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet or null to create
+     *                                 an empty object
+     * @param array           $rr      an array with RR parse values or null to 
+     *                                 create an empty object
+     *
+     * @return boolean
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function set(Net_DNS2_Packet &$packet, array $rr)
+    {
+        $this->name     = $rr['name'];
+        $this->type     = Net_DNS2_Lookups::$rr_types_by_id[$rr['type']];
+
+        //
+        // for RR OPT (41), the class value includes the requestors UDP payload size,
+        // and not a class value
+        //
+        if ($this->type == 'OPT') {
+            $this->class = $rr['class'];
+        } else {
+            $this->class = Net_DNS2_Lookups::$classes_by_id[$rr['class']];
+        }
+
+        $this->ttl      = $rr['ttl'];
+        $this->rdlength = $rr['rdlength'];
+        $this->rdata    = substr($packet->rdata, $packet->offset, $rr['rdlength']);
+
+        return $this->rrSet($packet);
+    }
+
+    /**
+     * returns a binary packed DNS RR object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet used for 
+     *                                 compressing names
+     *
+     * @return string
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function get(Net_DNS2_Packet &$packet)
+    {
+        $data  = '';
+        $rdata = '';
+
+        //
+        // pack the name
+        //
+        $data = $packet->compress($this->name, $packet->offset);
+
+        //
+        // pack the main values
+        //
+        if ($this->type == 'OPT') {
+
+            //
+            // pre-build the TTL value
+            //
+            $this->preBuild();
+
+            //
+            // the class value is different for OPT types
+            //
+            $data .= pack(
+                'nnN', 
+                Net_DNS2_Lookups::$rr_types_by_name[$this->type],
+                $this->class,
+                $this->ttl
+            );
+        } else {
+
+            $data .= pack(
+                'nnN', 
+                Net_DNS2_Lookups::$rr_types_by_name[$this->type],
+                Net_DNS2_Lookups::$classes_by_name[$this->class],
+                $this->ttl
+            );
+        }
+
+        //
+        // increase the offset, and allow for the rdlength
+        //
+        $packet->offset += 10;
+
+        //
+        // get the RR specific details
+        //
+        if ($this->rdlength != -1) {
+
+            $rdata = $this->rrGet($packet);
+        }
+
+        //
+        // add the RR
+        //
+        $data .= pack('n', strlen($rdata)) . $rdata;
+
+        return $data;
+    }
+
+    /**
+     * parses a binary packet, and returns the appropriate Net_DNS2_RR object, 
+     * based on the RR type of the binary content.
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet used for 
+     *                                 decompressing names
+     *
+     * @return mixed                   returns a new Net_DNS2_RR_* object for
+     *                                 the given RR
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public static function parse(Net_DNS2_Packet &$packet)
+    {
+        $object = array();
+
+        //
+        // expand the name
+        //
+        $object['name'] = $packet->expand($packet, $packet->offset);
+        if (is_null($object['name'])) {
+
+            throw new Net_DNS2_Exception(
+                'failed to parse resource record: failed to expand name.',
+                Net_DNS2_Lookups::E_PARSE_ERROR
+            );
+        }
+        if ($packet->rdlength < ($packet->offset + 10)) {
+
+            throw new Net_DNS2_Exception(
+                'failed to parse resource record: packet too small.',
+                Net_DNS2_Lookups::E_PARSE_ERROR
+            );
+        }
+
+        //
+        // unpack the RR details
+        //
+        $object['type']     = ord($packet->rdata[$packet->offset++]) << 8 | 
+                                ord($packet->rdata[$packet->offset++]);
+        $object['class']    = ord($packet->rdata[$packet->offset++]) << 8 | 
+                                ord($packet->rdata[$packet->offset++]);
+
+        $object['ttl']      = ord($packet->rdata[$packet->offset++]) << 24 | 
+                                ord($packet->rdata[$packet->offset++]) << 16 | 
+                                ord($packet->rdata[$packet->offset++]) << 8 | 
+                                ord($packet->rdata[$packet->offset++]);
+
+        $object['rdlength'] = ord($packet->rdata[$packet->offset++]) << 8 | 
+                                ord($packet->rdata[$packet->offset++]);
+
+        if ($packet->rdlength < ($packet->offset + $object['rdlength'])) {
+            return null;
+        }
+
+        //
+        // lookup the class to use
+        //
+        $o      = null;
+        $class  = Net_DNS2_Lookups::$rr_types_id_to_class[$object['type']];
+
+        if (isset($class)) {
+
+            $o = new $class($packet, $object);
+            if ($o) {
+
+                $packet->offset += $object['rdlength'];
+            }
+        } else {
+
+            throw new Net_DNS2_Exception(
+                'un-implemented resource record type: ' . $object['type'],
+                Net_DNS2_Lookups::E_RR_INVALID
+            );
+        }
+
+        return $o;
+    }
+
+    /**
+     * cleans up some RR data
+     * 
+     * @param string $data the text string to clean
+     *
+     * @return string returns the cleaned string
+     *
+     * @access public
+     *
+     */
+    public function cleanString($data)
+    {
+        return strtolower(rtrim($data, '.'));
+    }
+
+    /**
+     * parses a standard RR format lines, as defined by rfc1035 (kinda)
+     *
+     * In our implementation, the domain *must* be specified- format must be
+     *
+     *        <name> [<ttl>] [<class>] <type> <rdata>
+     * or
+     *        <name> [<class>] [<ttl>] <type> <rdata>
+     *
+     * name, title, class and type are parsed by this function, rdata is passed
+     * to the RR specific classes for parsing.
+     *
+     * @param string $line a standard DNS config line 
+     *
+     * @return mixed       returns a new Net_DNS2_RR_* object for the given RR
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public static function fromString($line)
+    {
+        if (strlen($line) == 0) {
+            throw new Net_DNS2_Exception(
+                'empty config line provided.',
+                Net_DNS2_Lookups::E_PARSE_ERROR
+            );
+        }
+
+        $name   = '';
+        $type   = '';
+        $class  = 'IN';
+        $ttl    = 86400;
+
+        //
+        // split the line by spaces
+        //
+        $values = preg_split('/[\s]+/', $line);
+        if (count($values) < 3) {
+
+            throw new Net_DNS2_Exception(
+                'failed to parse config: minimum of name, type and rdata required.',
+                Net_DNS2_Lookups::E_PARSE_ERROR
+            );
+        }
+
+        //
+        // assume the first value is the name
+        //
+        $name = trim(strtolower(array_shift($values)), '.');
+
+        //
+        // The next value is either a TTL, Class or Type
+        //
+        foreach ($values as $value) {
+
+            switch(true) {
+            case is_numeric($value):
+
+                $ttl = array_shift($values);
+                break;
+
+            //
+            // this is here because of a bug in is_numeric() in certain versions of
+            // PHP on windows.
+            //
+            case ($value === 0):
+                
+                $ttl = array_shift($values);
+                break;
+
+            case isset(Net_DNS2_Lookups::$classes_by_name[strtoupper($value)]):
+
+                $class = strtoupper(array_shift($values));
+                break;
+
+            case isset(Net_DNS2_Lookups::$rr_types_by_name[strtoupper($value)]):
+
+                $type = strtoupper(array_shift($values));
+                break 2;
+                break;
+
+            default:
+
+                throw new Net_DNS2_Exception(
+                    'invalid config line provided: unknown file: ' . $value,
+                    Net_DNS2_Lookups::E_PARSE_ERROR
+                );
+            }
+        }
+
+        //
+        // lookup the class to use
+        //
+        $o = null;
+        $class_name = Net_DNS2_Lookups::$rr_types_id_to_class[
+            Net_DNS2_Lookups::$rr_types_by_name[$type]
+        ];
+
+        if (isset($class_name)) {
+
+            $o = new $class_name;
+            if (!is_null($o)) {
+
+                //
+                // set the parsed values
+                //
+                $o->name    = $name;
+                $o->class   = $class;
+                $o->ttl     = $ttl;
+
+                //
+                // parse the rdata
+                //
+                if ($o->rrFromString($values) === false) {
+
+                    throw new Net_DNS2_Exception(
+                        'failed to parse rdata for config: ' . $line,
+                        Net_DNS2_Lookups::E_PARSE_ERROR
+                    );
+                }
+
+            } else {
+
+                throw new Net_DNS2_Exception(
+                    'failed to create new RR record for type: ' . $type,
+                    Net_DNS2_Lookups::E_RR_INVALID
+                );
+            }
+
+        } else {
+
+            throw new Net_DNS2_Exception(
+                'un-implemented resource record type: '. $type,
+                Net_DNS2_Lookups::E_RR_INVALID
+            );
+        }
+
+        return $o;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/A.php

@@ -0,0 +1,156 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * A Resource Record - RFC1035 section 3.4.1
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    ADDRESS                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_A extends Net_DNS2_RR
+{
+    /*
+     * The IPv4 address in quad-dotted notation
+     */
+    public $address;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->address;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $value = array_shift($rdata);
+
+        if (Net_DNS2::isIPv4($value) == true) {
+            
+            $this->address = $value;
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     * 
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $this->address = inet_ntop($this->rdata);
+            if ($this->address !== false) {
+            
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     * 
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed 
+     *                                 string or null on failure
+     * @access protected
+     * 
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        $packet->offset += 4;
+        return inet_pton($this->address);
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/AAAA.php

@@ -0,0 +1,177 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * A Resource Record - RFC1035 section 3.4.1
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                                               |       
+ *    |                                               |       
+ *    |                                               |       
+ *    |                    ADDRESS                    |       
+ *    |                                               |       
+ *    |                   (128 bit)                   |       
+ *    |                                               |       
+ *    |                                               |       
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_AAAA extends Net_DNS2_RR
+{
+    /*
+     * the IPv6 address in the preferred hexadecimal values of the eight 
+     * 16-bit pieces 
+     * per RFC1884
+     *
+     */
+    public $address;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->address;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        //
+        // expand out compressed formats
+        //
+        $value = array_shift($rdata);
+        if (Net_DNS2::isIPv6($value) == true) {
+
+            $this->address = $value;
+            return true;
+        }
+            
+        return false;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        //
+        // must be 8 x 16bit chunks, or 16 x 8bit
+        //
+        if ($this->rdlength == 16) {
+
+            //
+            // PHP's inet_ntop returns IPv6 addresses in their compressed form,
+            // but we want to keep with the preferred standard, so we'll parse
+            // it manually.
+            //
+            $x = unpack('n8', $this->rdata);
+            if (count($x) == 8) {
+
+                $this->address = vsprintf('%x:%x:%x:%x:%x:%x:%x:%x', $x);
+                return true;
+            }
+        }
+        
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        $packet->offset += 16;
+        return inet_pton($this->address);
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/AFSDB.php

@@ -0,0 +1,174 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * AFSDB Resource Record - RFC1183 section 1
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    SUBTYPE                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                    HOSTNAME                   /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_AFSDB extends Net_DNS2_RR
+{
+    /*
+     * The AFSDB sub type
+     */
+    public $subtype;
+
+    /*
+     * The AFSDB hostname
+     */
+    public $hostname;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->subtype . ' ' . $this->cleanString($this->hostname) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->subtype  = array_shift($rdata);
+        $this->hostname = $this->cleanString(array_shift($rdata));
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+            
+            //
+            // unpack the subtype
+            //
+            $x = unpack('nsubtype', $this->rdata);
+
+            $this->subtype  = $x['subtype'];
+            $offset         = $packet->offset + 2;
+
+            $this->hostname = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->hostname) > 0) {
+            
+            $data = pack('n', $this->subtype);
+            $packet->offset += 2;
+            
+            $data .= $packet->compress($this->hostname, $packet->offset);
+
+            return $data;
+        }
+        
+        return null; 
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/ANY.php

@@ -0,0 +1,129 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * This is only used for generating an empty ANY RR.
+ *
+ * @category Networking
+ * @package  Net_DNS2   
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2     
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_ANY extends Net_DNS2_RR
+{
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return '';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        return true;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        return '';
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/APL.php

@@ -0,0 +1,343 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.0.0
+ *
+ */
+
+/**
+ * APL Resource Record - RFC3123
+ *
+ *     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ *     |                          ADDRESSFAMILY                        |
+ *     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ *     |             PREFIX            | N |         AFDLENGTH         |
+ *     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ *     /                            AFDPART                            /
+ *     |                                                               |
+ *     +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_APL extends Net_DNS2_RR
+{
+    /*
+     * a list of all the address prefix list items
+     */
+    public $apl_items = array();
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $out = '';
+
+        foreach ($this->apl_items as $item) {
+
+            if ($item['n'] == 1) {
+
+                $out .= '!';
+            }
+
+            $out .= $item['address_family'] . ':' . 
+                $item['afd_part'] . '/' . $item['prefix'] . ' ';
+        }
+
+        return trim($out);
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        foreach ($rdata as $item) {
+
+            if (preg_match('/^(!?)([1|2])\:([^\/]*)\/([0-9]{1,3})$/', $item, $m)) {
+
+                $i = array(
+
+                    'address_family'    => $m[2],
+                    'prefix'            => $m[4],
+                    'n'                 => ($m[1] == '!') ? 1 : 0,
+                    'afd_part'          => strtolower($m[3])
+                );
+
+                $address = $this->_trimZeros(
+                    $i['address_family'], $i['afd_part']
+                );
+                    
+                $i['afd_length'] = count(explode('.', $address));
+
+                $this->apl_items[] = $i;
+            }
+        }
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $offset = 0;
+
+            while ($offset < $this->rdlength) {
+
+                //
+                // unpack the family, prefix, negate and length values
+                //   
+                $x = unpack(
+                    'naddress_family/Cprefix/Cextra', substr($this->rdata, $offset)
+                );
+
+                $item = array(
+            
+                    'address_family'    => $x['address_family'],
+                    'prefix'            => $x['prefix'],
+                    'n'                 => ($x['extra'] >> 7) & 0x1,
+                    'afd_length'        => $x['extra'] & 0xf
+                );
+
+                switch($item['address_family']) {
+
+                case 1:
+                    $r = unpack(
+                        'C*', substr($this->rdata, $offset + 4, $item['afd_length'])
+                    );
+                    if (count($r) < 4) {
+
+                        for ($c=count($r)+1; $c<4+1; $c++) {
+
+                            $r[$c] = 0;
+                        }
+                    }
+
+                    $item['afd_part'] = implode('.', $r);
+
+                    break;
+                case 2:
+                    $r = unpack(
+                        'C*', substr($this->rdata, $offset + 4, $item['afd_length'])
+                    );
+                    if (count($r) < 8) {
+
+                        for ($c=count($r)+1; $c<8+1; $c++) {
+
+                            $r[$c] = 0;
+                        }
+                    }
+
+                    $item['afd_part'] = sprintf(
+                        '%x:%x:%x:%x:%x:%x:%x:%x', 
+                        $r[1], $r[2], $r[3], $r[4], $r[5], $r[6], $r[7], $r[8]
+                    );
+
+                    break;
+                default:
+                    return false;
+                }
+
+                $this->apl_items[] = $item;
+
+                $offset += 4 + $item['afd_length'];
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (count($this->apl_items) > 0) {
+
+            $data = '';
+
+            foreach ($this->apl_items as $item) {
+
+                //
+                // pack the address_family and prefix values
+                //
+                $data .= pack(
+                    'nCC', 
+                    $item['address_family'], 
+                    $item['prefix'],
+                    ($item['n'] << 7) | $item['afd_length']
+                );
+
+                switch($item['address_family']) {
+                case 1:
+                    $address = explode(
+                        '.', 
+                        $this->_trimZeros($item['address_family'], $item['afd_part'])
+                    );
+
+                    foreach ($address as $b) {
+                        $data .= chr($b);
+                    }
+                    break;
+                case 2:
+                    $address = explode(
+                        ':', 
+                        $this->_trimZeros($item['address_family'], $item['afd_part'])
+                    );
+
+                    foreach ($address as $b) {
+                        $data .= pack('H', $b);
+                    }
+                    break;
+                default:
+                    return null;
+                }
+            }
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+
+    /**
+     * returns an IP address with the right-hand zero's trimmed
+     *
+     * @param integer $family  the IP address family from the rdata
+     * @param string  $address the IP address
+     *
+     * @return string the trimmed IP addresss.
+     *
+     * @access private
+     *
+     */
+    private function _trimZeros($family, $address)
+    {
+        $a = array();
+
+        switch($family) {
+        case 1:
+            $a = array_reverse(explode('.', $address));
+            break;
+        case 2:
+            $a = array_reverse(explode(':', $address));
+            break;
+        default:
+            return '';
+        }
+
+        foreach ($a as $value) {
+
+            if ($value === '0') {
+
+                array_shift($a);
+            }
+        }
+
+        $out = '';
+
+        switch($family) {
+        case 1:
+            $out = implode('.', array_reverse($a));
+            break;
+        case 2:
+            $out = implode(':', array_reverse($a));
+            break;
+        default:
+            return '';
+        }
+
+        return $out;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/ATMA.php

@@ -0,0 +1,210 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.1.0
+ *
+ */
+
+/**
+ * ATMA Resource Record
+ *
+ *   0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * |          FORMAT       |                       |
+ * |                       +--+--+--+--+--+--+--+--+
+ * /                    ADDRESS                    /
+ * |                                               |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_ATMA extends Net_DNS2_RR
+{
+    /*
+     * One octet that indicates the format of ADDRESS. The two possible values 
+     * for FORMAT are value 0 indicating ATM End System Address (AESA) format
+     * and value 1 indicating E.164 format
+     */
+    public $format;
+
+    /*
+     * The IPv4 address in quad-dotted notation
+     */
+    public $address;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->address;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $value = array_shift($rdata);
+
+        if (ctype_xdigit($value) == true) {
+            
+            $this->format   = 0;
+            $this->address  = $value;
+
+        } else if (is_numeric($value) == true) {
+
+            $this->format   = 1;
+            $this->address  = $value;
+
+        } else {
+
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     * 
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the format
+            //
+            $x = unpack('Cformat/N*address', $this->rdata);
+
+            $this->format = $x['format'];
+
+            if ($this->format == 0) {
+
+                $a = unpack('@1/H*address', $this->rdata);
+
+                $this->address = $a['address'];
+
+            } else if ($this->format == 1) {
+
+                $this->address = substr($this->rdata, 1, $this->rdlength - 1);
+
+            } else {
+
+                return false;
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     * 
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed 
+     *                                 string or null on failure
+     * @access protected
+     * 
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        $data = chr($this->format);
+
+        if ($this->format == 0) {
+
+            $data .= pack('H*', $this->address);
+
+        } else if ($this->format == 1) {
+
+            $data .= $this->address;
+
+        } else {
+
+            return null;
+        }
+
+        $packet->offset += strlen($data);
+        
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/AVC.php

@@ -0,0 +1,75 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2016, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2016 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.4.2
+ *
+ */
+
+/**
+ * The AVC RR is implemented exactly like the TXT record, so
+ * for now we just extend the TXT RR and use it.
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_AVC extends Net_DNS2_RR_TXT
+{
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/CAA.php

@@ -0,0 +1,179 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates.
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2011, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors
+ *     may be used to endorse or promote products derived from this
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2011 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.2.0
+ *
+ */
+
+/**
+ * CAA Resource Record - http://tools.ietf.org/html/draft-ietf-pkix-caa-03
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |          FLAGS        |      TAG LENGTH       |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                      TAG                      /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                      DATA                     /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_CAA extends Net_DNS2_RR
+{
+    /*
+     * The critcal flag
+     */
+    public $flags;
+
+    /*
+     * The property identifier
+     */
+    public $tag;
+
+    /*
+      * The property value
+     */
+    public $value;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->flags . ' ' . $this->tag . ' "' . 
+            trim($this->cleanString($this->value), '"') . '"';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->flags    = array_shift($rdata);
+        $this->tag      = array_shift($rdata);
+
+        $this->value    = trim($this->cleanString(implode($rdata, ' ')), '"');
+        
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+            
+            //
+            // unpack the flags and tag length
+            //
+            $x = unpack('Cflags/Ctag_length', $this->rdata);
+
+            $this->flags    = $x['flags'];
+            $offset         = 2;
+
+            $this->tag      = substr($this->rdata, $offset, $x['tag_length']);
+            $offset         += $x['tag_length'];
+
+            $this->value    = substr($this->rdata, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->value) > 0) {
+
+            $data  = chr($this->flags);
+            $data .= chr(strlen($this->tag)) . $this->tag . $this->value;
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+?>

bundled-libs/Net/DNS2/RR/CDNSKEY.php

@@ -0,0 +1,77 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2014, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2014 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.4.0
+ *
+ */
+
+/**
+ * The CDNSKEY RR is implemented exactly like the DNSKEY record, so
+ * for now we just extend the DNSKEY RR and use it.
+ *
+ * http://www.rfc-editor.org/rfc/rfc7344.txt
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_CDNSKEY extends Net_DNS2_RR_DNSKEY
+{
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/CDS.php

@@ -0,0 +1,77 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2011, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2011 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.2.0
+ *
+ */
+
+/**
+ * The CDS RR is implemented exactly like the DS record, so
+ * for now we just extend the DS RR and use it.
+ *
+ * http://www.rfc-editor.org/rfc/rfc7344.txt
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_CDS extends Net_DNS2_RR_DS
+{
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/CERT.php

@@ -0,0 +1,292 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * CERT Resource Record - RFC4398 section 2
+ *
+ *  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |            format             |             key tag           |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |   algorithm   |                                               /
+ *  +---------------+            certificate or CRL                 /
+ *  /                                                               /
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_CERT extends Net_DNS2_RR
+{
+    /*
+     * format's allowed for certificates
+     */
+    const CERT_FORMAT_RES       = 0;
+    const CERT_FORMAT_PKIX      = 1;
+    const CERT_FORMAT_SPKI      = 2;
+    const CERT_FORMAT_PGP       = 3;
+    const CERT_FORMAT_IPKIX     = 4;
+    const CERT_FORMAT_ISPKI     = 5;
+    const CERT_FORMAT_IPGP      = 6;
+    const CERT_FORMAT_ACPKIX    = 7;
+    const CERT_FORMAT_IACPKIX   = 8;
+    const CERT_FORMAT_URI       = 253;
+    const CERT_FORMAT_OID       = 254;
+
+    public $cert_format_name_to_id = array();
+    public $cert_format_id_to_name = array(
+
+        self::CERT_FORMAT_RES       => 'Reserved',
+        self::CERT_FORMAT_PKIX      => 'PKIX',
+        self::CERT_FORMAT_SPKI      => 'SPKI',
+        self::CERT_FORMAT_PGP       => 'PGP',
+        self::CERT_FORMAT_IPKIX     => 'IPKIX',
+        self::CERT_FORMAT_ISPKI     => 'ISPKI',
+        self::CERT_FORMAT_IPGP      => 'IPGP',
+        self::CERT_FORMAT_ACPKIX    => 'ACPKIX',
+        self::CERT_FORMAT_IACPKIX   => 'IACPKIX',
+        self::CERT_FORMAT_URI       => 'URI',
+        self::CERT_FORMAT_OID       => 'OID'
+    );
+
+    /*
+      * certificate format
+     */
+    public $format;
+
+    /*
+     * key tag
+     */
+    public $keytag;
+
+    /*
+     * The algorithm used for the CERt
+     */
+    public $algorithm;
+
+    /*
+     * certificate
+     */
+    public $certificate;
+
+    /**
+     * we have our own constructor so that we can load our certificate
+     * information for parsing.
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     * @param array           $rr      a array with parsed RR values
+     *
+     * @return
+     *
+     */
+    public function __construct(Net_DNS2_Packet &$packet = null, array $rr = null)
+    {
+        parent::__construct($packet, $rr);
+    
+        //
+        // load the lookup values
+        //
+        $this->cert_format_name_to_id = array_flip($this->cert_format_id_to_name);
+    }
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->format . ' ' . $this->keytag . ' ' . $this->algorithm . 
+            ' ' . base64_encode($this->certificate);
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        //
+        // load and check the format; can be an int, or a mnemonic symbol
+        //
+        $this->format = array_shift($rdata);
+        if (!is_numeric($this->format)) {
+
+            $mnemonic = strtoupper(trim($this->format));
+            if (!isset($this->cert_format_name_to_id[$mnemonic])) {
+
+                return false;
+            }
+
+            $this->format = $this->cert_format_name_to_id[$mnemonic];
+        } else {
+
+            if (!isset($this->cert_format_id_to_name[$this->format])) {
+
+                return false;
+            }
+        }
+    
+        $this->keytag = array_shift($rdata);
+
+        //
+        // parse and check the algorithm; can be an int, or a mnemonic symbol
+        //
+        $this->algorithm = array_shift($rdata);
+        if (!is_numeric($this->algorithm)) {
+
+            $mnemonic = strtoupper(trim($this->algorithm));
+            if (!isset(Net_DNS2_Lookups::$algorithm_name_to_id[$mnemonic])) {
+
+                return false;
+            }
+
+            $this->algorithm = Net_DNS2_Lookups::$algorithm_name_to_id[
+                $mnemonic
+            ];
+        } else {
+
+            if (!isset(Net_DNS2_Lookups::$algorithm_id_to_name[$this->algorithm])) {
+                return false;
+            }
+        }
+
+        //
+        // parse and base64 decode the certificate
+        //
+        // certificates MUST be provided base64 encoded, if not, everything will
+        // be broken after this point, as we assume it's base64 encoded.
+        //
+        $this->certificate = base64_decode(implode(' ', $rdata));
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the format, keytag and algorithm
+            //
+            $x = unpack('nformat/nkeytag/Calgorithm', $this->rdata);
+
+            $this->format       = $x['format'];
+            $this->keytag       = $x['keytag'];
+            $this->algorithm    = $x['algorithm'];
+
+            //
+            // copy the certificate
+            //
+            $this->certificate  = substr($this->rdata, 5, $this->rdlength - 5);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->certificate) > 0) {
+
+            $data = pack('nnC', $this->format, $this->keytag, $this->algorithm) . 
+                $this->certificate;
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/CNAME.php

@@ -0,0 +1,153 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * CNAME Resource Record - RFC1035 section 3.3.1
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                     CNAME                     /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_CNAME extends Net_DNS2_RR
+{
+    /*
+     * The canonical name 
+     */
+    public $cname;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->cleanString($this->cname) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->cname = $this->cleanString(array_shift($rdata));
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $offset = $packet->offset;
+            $this->cname = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->cname) > 0) {
+
+            return $packet->compress($this->cname, $packet->offset);
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/CSYNC.php

@@ -0,0 +1,203 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2015, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2015 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.4.1
+ *
+ */
+
+/**
+ * CSYNC Resource Record - RFC 7477 seciond 2.1.1
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                  SOA Serial                   |
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    Flags                      |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                 Type Bit Map                  /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_CSYNC extends Net_DNS2_RR
+{
+    /*
+     * serial number
+     */
+    public $serial;
+
+    /*
+     * flags
+     */
+    public $flags;
+
+    /*
+     * array of RR type names
+     */
+    public $type_bit_maps = array();
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $out = $this->serial . ' ' . $this->flags;
+
+        //
+        // show the RR's
+        //
+        foreach ($this->type_bit_maps as $rr) {
+
+            $out .= ' ' . strtoupper($rr);
+        }
+
+        return $out;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->serial   = array_shift($rdata);
+        $this->flags    = array_shift($rdata);
+
+        $this->type_bit_maps = $rdata;
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the serial and flags values
+            //
+            $x = unpack('@' . $packet->offset . '/Nserial/nflags', $packet->rdata);
+
+            $this->serial   = Net_DNS2::expandUint32($x['serial']);
+            $this->flags    = $x['flags'];
+
+            //
+            // parse out the RR bitmap                 
+            //
+            $this->type_bit_maps = Net_DNS2_BitMap::bitMapToArray(
+                substr($this->rdata, 6)
+            );
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        //
+        // pack the serial and flags values
+        //
+        $data = pack('Nn', $this->serial, $this->flags);
+
+        //
+        // convert the array of RR names to a type bitmap
+        //
+        $data .= Net_DNS2_BitMap::arrayToBitMap($this->type_bit_maps);
+
+        //
+        // advance the offset
+        //
+        $packet->offset += strlen($data);
+
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/DHCID.php

@@ -0,0 +1,207 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * DHCID Resource Record - RFC4701 section 3.1
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                  ID Type Code                 |       
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |       Digest Type     |                       /       
+ *    +--+--+--+--+--+--+--+--+                       /
+ *    /                                               /       
+ *    /                    Digest                     /       
+ *    /                                               /       
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_DHCID extends Net_DNS2_RR
+{
+    /*
+     * Identifier type
+     */
+    public $id_type;
+
+    /*
+     * Digest Type
+     */
+    public $digest_type;
+
+    /*
+     * The digest
+     */
+    public $digest;
+
+    
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $out = pack('nC', $this->id_type, $this->digest_type);
+        $out .= base64_decode($this->digest);
+
+        return base64_encode($out);
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $data = base64_decode(array_shift($rdata));
+        if (strlen($data) > 0) {
+
+            //
+            // unpack the id type and digest type
+            //
+            $x = unpack('nid_type/Cdigest_type', $data);
+
+            $this->id_type      = $x['id_type'];
+            $this->digest_type  = $x['digest_type'];
+
+            //
+            // copy out the digest
+            //
+            $this->digest = base64_encode(substr($data, 3, strlen($data) - 3));
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the id type and digest type
+            //
+            $x = unpack('nid_type/Cdigest_type', $this->rdata);
+
+            $this->id_type      = $x['id_type'];
+            $this->digest_type  = $x['digest_type'];
+
+            //
+            // copy out the digest
+            //
+            $this->digest = base64_encode(
+                substr($this->rdata, 3, $this->rdlength - 3)
+            );
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->digest) > 0) {
+
+            $data = pack('nC', $this->id_type, $this->digest_type) . 
+                base64_decode($this->digest);
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+    
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/DLV.php

@@ -0,0 +1,75 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * The DLV RR is implemented exactly like the DS RR; so we just extend that
+ * class, and use all of it's methods
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_DLV extends Net_DNS2_RR_DS
+{
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/DNAME.php

@@ -0,0 +1,153 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * DNAME Resource Record - RFC2672 section 3
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                     DNAME                     /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_DNAME extends Net_DNS2_RR
+{
+    /*
+     * The target name 
+     */
+    public $dname;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->cleanString($this->dname) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->dname = $this->cleanString(array_shift($rdata));
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $offset = $packet->offset;
+            $this->dname = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->dname) > 0) {
+
+            return $packet->compress($this->dname, $packet->offset);
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/DNSKEY.php

@@ -0,0 +1,198 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * DNSKEY Resource Record - RFC4034 sction 2.1
+ *
+ *    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |              Flags            |    Protocol   |   Algorithm   |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   /                                                               /
+ *   /                            Public Key                         /
+ *   /                                                               /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_DNSKEY extends Net_DNS2_RR
+{
+    /*
+     * flags
+     */
+    public $flags;
+
+    /*
+     * protocol
+     */
+    public $protocol;
+
+    /*
+     * algorithm used
+     */
+    public $algorithm;
+
+    /*
+     * the public key
+     */
+    public $key;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->flags . ' ' . $this->protocol . ' ' . 
+            $this->algorithm . ' ' . $this->key;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->flags        = array_shift($rdata);
+        $this->protocol     = array_shift($rdata);
+        $this->algorithm    = array_shift($rdata);
+        $this->key          = implode(' ', $rdata);
+    
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the flags, protocol and algorithm
+            //
+            $x = unpack('nflags/Cprotocol/Calgorithm', $this->rdata);
+
+            //
+            // TODO: right now we're just displaying what's in DNS; we really 
+            // should be parsing bit 7 and bit 15 of the flags field, and store
+            // those separately.
+            //
+            // right now the DNSSEC implementation is really just for display,
+            // we don't validate or handle any of the keys
+            //
+            $this->flags        = $x['flags'];
+            $this->protocol     = $x['protocol'];
+            $this->algorithm    = $x['algorithm'];
+
+            $this->key          = base64_encode(substr($this->rdata, 4));
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->key) > 0) {
+
+            $data = pack('nCC', $this->flags, $this->protocol, $this->algorithm);
+            $data .= base64_decode($this->key);
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+        
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/DS.php

@@ -0,0 +1,209 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * DS Resource Record - RFC4034 sction 5.1
+ *
+ *    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |           Key Tag             |  Algorithm    |  Digest Type  |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   /                                                               /
+ *   /                            Digest                             /
+ *   /                                                               /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_DS extends Net_DNS2_RR
+{
+    /*
+     * key tag
+     */
+    public $keytag;
+
+    /*
+     * algorithm number
+     */
+    public $algorithm;
+
+    /*
+     * algorithm used to construct the digest
+     */
+    public $digesttype;
+
+    /*
+     * the digest data
+     */
+    public $digest;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->keytag . ' ' . $this->algorithm . ' ' . 
+            $this->digesttype . ' ' . $this->digest;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->keytag       = array_shift($rdata);
+        $this->algorithm    = array_shift($rdata);
+        $this->digesttype   = array_shift($rdata);
+        $this->digest       = implode('', $rdata);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the keytag, algorithm and digesttype
+            //
+            $x = unpack('nkeytag/Calgorithm/Cdigesttype', $this->rdata);
+
+            $this->keytag       = $x['keytag'];
+            $this->algorithm    = $x['algorithm'];
+            $this->digesttype   = $x['digesttype'];
+
+            //
+            // figure out the digest size
+            //
+            $digest_size = 0;
+            if ($this->digesttype == 1) {
+
+                $digest_size = 20; // SHA1
+
+            } else if ($this->digesttype == 2) {
+
+                $digest_size = 32; // SHA256
+            }
+
+            //
+            // copy the digest
+            //
+            $x = unpack('H*', substr($this->rdata, 4, $digest_size));
+            $this->digest = $x[1];
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->digest) > 0) {
+
+            $data = pack(
+                'nCCH*', 
+                $this->keytag, $this->algorithm, $this->digesttype, $this->digest
+            );
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+        
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/EID.php

@@ -0,0 +1,130 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * EID Resource Record - undefined; the rdata is simply used as-is in it's
+ *                          binary format, so not process has to be done.
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_EID extends Net_DNS2_RR
+{
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return '';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        return true;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        return $this->rdata;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/EUI48.php

@@ -0,0 +1,187 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2013, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2013 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.3.2
+ *
+ */
+
+/**
+ * EUI48 Resource Record - RFC7043 section 3.1
+ *
+ *  0                   1                   2                   3
+ *  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ * |                          EUI-48 Address                       |
+ * |                               +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ * |                               |
+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_EUI48 extends Net_DNS2_RR
+{
+    /*
+     * The EUI48 address, in hex format
+     */
+    public $address;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->address;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $value = array_shift($rdata);
+
+        //
+        // re: RFC 7043, the field must be represented as six two-digit hex numbers
+        // separated by hyphens.
+        //
+        $a = explode('-', $value);
+        if (count($a) != 6) {
+
+            return false;
+        }
+
+        //
+        // make sure they're all hex values
+        //
+        foreach ($a as $i) {
+            if (ctype_xdigit($i) == false) {
+                return false;
+            }
+        }
+
+        //
+        // store it
+        //
+        $this->address = strtolower($value);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     * 
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $x = unpack('C6', $this->rdata);
+            if (count($x) == 6) {
+            
+                $this->address = vsprintf('%02x-%02x-%02x-%02x-%02x-%02x', $x);
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     * 
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed 
+     *                                 string or null on failure
+     * @access protected
+     * 
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        $data = '';
+
+        $a = explode('-', $this->address);
+        foreach ($a as $b) {
+
+            $data .= chr(hexdec($b));
+        }
+
+        $packet->offset += 6;
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/EUI64.php

@@ -0,0 +1,188 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2013, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2013 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.3.2
+ *
+ */
+
+/**
+ * EUI64 Resource Record - RFC7043 section 4.1
+ *
+ *  0                   1                   2                   3
+ *  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ * |                          EUI-48 Address                       |
+ * |                                                               |
+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_EUI64 extends Net_DNS2_RR
+{
+    /*
+     * The EUI64 address, in hex format
+     */
+    public $address;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->address;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $value = array_shift($rdata);
+
+        //
+        // re: RFC 7043, the field must be represented as 8 two-digit hex numbers
+        // separated by hyphens.
+        //
+        $a = explode('-', $value);
+        if (count($a) != 8) {
+
+            return false;
+        }
+
+        //
+        // make sure they're all hex values
+        //
+        foreach ($a as $i) {
+            if (ctype_xdigit($i) == false) {
+                return false;
+            }
+        }
+
+        //
+        // store it
+        //
+        $this->address = strtolower($value);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     * 
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $x = unpack('C8', $this->rdata);
+            if (count($x) == 8) {
+            
+                $this->address = vsprintf(
+                    '%02x-%02x-%02x-%02x-%02x-%02x-%02x-%02x', $x
+                );
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     * 
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed 
+     *                                 string or null on failure
+     * @access protected
+     * 
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        $data = '';
+
+        $a = explode('-', $this->address);
+        foreach ($a as $b) {
+
+            $data .= chr(hexdec($b));
+        }
+
+        $packet->offset += 8;
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/HINFO.php

@@ -0,0 +1,175 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * HINFO Resource Record - RFC1035 section 3.3.2
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                      CPU                      /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                       OS                      /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_HINFO extends Net_DNS2_RR
+{
+    /*
+     * computer informatino
+     */
+    public $cpu;
+
+    /*
+     * operataing system
+     */
+    public $os;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->formatString($this->cpu) . ' ' . 
+            $this->formatString($this->os);
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $data = $this->buildString($rdata);
+        if (count($data) == 2) {
+
+            $this->cpu  = $data[0];
+            $this->os   = $data[1];
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $offset = $packet->offset;
+    
+            $this->cpu  = trim(Net_DNS2_Packet::label($packet, $offset), '"');
+            $this->os   = trim(Net_DNS2_Packet::label($packet, $offset), '"');
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->cpu) > 0) {
+
+            $data  = chr(strlen($this->cpu)) . $this->cpu;
+            $data .= chr(strlen($this->os)) . $this->os;
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/HIP.php

@@ -0,0 +1,287 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.0.0
+ *
+ */
+
+/**
+ * HIP Resource Record - RFC5205 section 5
+ *
+ *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |  HIT length   | PK algorithm  |          PK length            |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |                                                               |
+ *  ~                           HIT                                 ~
+ *  |                                                               |
+ *  +                     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |                     |                                         |
+ *  +-+-+-+-+-+-+-+-+-+-+-+                                         +
+ *  |                           Public Key                          |
+ *  ~                                                               ~
+ *  |                                                               |
+ *  +                               +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |                               |                               |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               +
+ *  |                                                               |
+ *  ~                       Rendezvous Servers                      ~
+ *  |                                                               |
+ *  +             +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |             |
+ *  +-+-+-+-+-+-+-+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_HIP extends Net_DNS2_RR
+{
+    /*
+     * The length of the HIT field
+     */
+    public $hit_length;
+
+    /*
+     * the public key cryptographic algorithm
+     */
+    public $pk_algorithm;
+
+    /*
+     * the length of the public key field
+     */
+    public $pk_length;
+    
+    /*
+     * The HIT is stored as a binary value in network byte order.
+     */
+    public $hit;
+
+    /*
+     * The public key
+     */
+    public $public_key;
+
+    /*
+     * a list of rendezvous servers
+     */
+    public $rendezvous_servers = array();
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $out = $this->pk_algorithm . ' ' . 
+            $this->hit . ' ' . $this->public_key . ' ';
+
+        foreach ($this->rendezvous_servers as $index => $server) {
+        
+            $out .= $server . '. ';
+        }
+
+        return trim($out);
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->pk_algorithm     = array_shift($rdata);
+        $this->hit              = strtoupper(array_shift($rdata));
+        $this->public_key       = array_shift($rdata);
+
+        //
+        // anything left on the array, must be one or more rendezevous servers. add
+        // them and strip off the trailing dot
+        //
+        if (count($rdata) > 0) {
+
+            $this->rendezvous_servers = preg_replace('/\.$/', '', $rdata);
+        }
+
+        //
+        // store the lengths; 
+        //
+        $this->hit_length       = strlen(pack('H*', $this->hit));
+        $this->pk_length        = strlen(base64_decode($this->public_key));        
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the algorithm and length values
+            //
+            $x = unpack('Chit_length/Cpk_algorithm/npk_length', $this->rdata);
+
+            $this->hit_length   = $x['hit_length'];
+            $this->pk_algorithm = $x['pk_algorithm'];
+            $this->pk_length    = $x['pk_length'];
+
+            $offset = 4;
+
+            //
+            // copy out the HIT value
+            //
+            $hit = unpack('H*', substr($this->rdata, $offset, $this->hit_length));
+            
+            $this->hit = strtoupper($hit[1]);
+            $offset += $this->hit_length;
+
+            //
+            // copy out the public key
+            //
+            $this->public_key = base64_encode(
+                substr($this->rdata, $offset, $this->pk_length)
+            );
+            $offset += $this->pk_length;
+
+            //
+            // copy out any possible rendezvous servers
+            //
+            $offset = $packet->offset + $offset;
+
+            while ( ($offset - $packet->offset) < $this->rdlength) {
+
+                $this->rendezvous_servers[] = Net_DNS2_Packet::expand(
+                    $packet, $offset
+                );
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if ( (strlen($this->hit) > 0) && (strlen($this->public_key) > 0) ) {
+
+            //
+            // pack the length, algorithm and HIT values
+            //
+            $data = pack(
+                'CCnH*', 
+                $this->hit_length, 
+                $this->pk_algorithm, 
+                $this->pk_length,
+                $this->hit                
+            );
+            
+            //
+            // add the public key
+            //
+            $data .= base64_decode($this->public_key);
+
+            //
+            // add the offset
+            //
+            $packet->offset += strlen($data);
+
+            //
+            // add each rendezvous server
+            //
+            foreach ($this->rendezvous_servers as $index => $server) {
+
+                $data .= $packet->compress($server, $packet->offset);
+            }
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/IPSECKEY.php

@@ -0,0 +1,386 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * IPSECKEY Resource Record - RFC4025 section 2.1
+ *
+ *       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *     |  precedence   | gateway type  |  algorithm  |     gateway     |
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-------------+                 +
+ *     ~                            gateway                            ~
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *     |                                                               /
+ *     /                          public key                           /
+ *     /                                                               /
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_IPSECKEY extends Net_DNS2_RR
+{
+    const GATEWAY_TYPE_NONE     = 0;
+    const GATEWAY_TYPE_IPV4     = 1;
+    const GATEWAY_TYPE_IPV6     = 2;
+    const GATEWAY_TYPE_DOMAIN   = 3;
+
+    const ALGORITHM_NONE        = 0;
+    const ALGORITHM_DSA         = 1;
+    const ALGORITHM_RSA         = 2;
+
+    /*
+     * Precedence (used the same was as a preference field)
+     */
+    public $precedence;
+
+    /*
+     * Gateway type - specifies the format of the gataway information
+     * This can be either:
+     *
+     *  0    No Gateway
+     *  1    IPv4 address
+     *  2    IPV6 address
+     *  3    wire-encoded domain name (not compressed)
+     *
+     */
+    public $gateway_type;
+
+    /*
+     * The algorithm used
+     *
+     * This can be:
+     *
+     *  0    No key is present
+     *  1    DSA key is present
+     *  2    RSA key is present
+     *
+     */
+    public $algorithm;
+
+    /*
+     * The gatway information 
+     */
+    public $gateway;
+
+    /*
+     * the public key
+     */
+    public $key;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $out = $this->precedence . ' ' . $this->gateway_type . ' ' . 
+            $this->algorithm . ' ';
+        
+        switch($this->gateway_type) {
+        case self::GATEWAY_TYPE_NONE:
+            $out .= '. ';
+            break;
+
+        case self::GATEWAY_TYPE_IPV4:
+        case self::GATEWAY_TYPE_IPV6:
+            $out .= $this->gateway . ' ';
+            break;
+
+        case self::GATEWAY_TYPE_DOMAIN:
+            $out .= $this->gateway . '. ';
+            break;
+        }
+
+        $out .= $this->key;
+        return $out;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        //
+        // load the data
+        //
+        $precedence     = array_shift($rdata);
+        $gateway_type   = array_shift($rdata);
+        $algorithm      = array_shift($rdata);
+        $gateway        = strtolower(trim(array_shift($rdata)));
+        $key            = array_shift($rdata);
+        
+        //
+        // validate it
+        //
+        switch($gateway_type) {
+        case self::GATEWAY_TYPE_NONE:
+            $gateway = '';
+            break;
+
+        case self::GATEWAY_TYPE_IPV4:
+            if (Net_DNS2::isIPv4($gateway) == false) {
+                return false;
+            }
+            break;
+
+        case self::GATEWAY_TYPE_IPV6:
+            if (Net_DNS2::isIPv6($gateway) == false) {
+                return false;
+            }
+            break;
+
+        case self::GATEWAY_TYPE_DOMAIN:
+            ; // do nothing
+            break;
+
+        default:
+            return false;
+        }
+        
+        //
+        // check the algorithm and key
+        //
+        switch($algorithm) {
+        case self::ALGORITHM_NONE:
+            $key = '';
+            break;
+
+        case self::ALGORITHM_DSA:
+        case self::ALGORITHM_RSA:
+            ; // do nothing        
+            break;
+
+        default:
+            return false;
+        }
+
+        //
+        // store the values
+        //
+        $this->precedence   = $precedence;
+        $this->gateway_type = $gateway_type;
+        $this->algorithm    = $algorithm;
+        $this->gateway      = $gateway;
+        $this->key          = $key;
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // parse off the precedence, gateway type and algorithm
+            //
+            $x = unpack('Cprecedence/Cgateway_type/Calgorithm', $this->rdata);
+
+            $this->precedence   = $x['precedence'];
+            $this->gateway_type = $x['gateway_type'];
+            $this->algorithm    = $x['algorithm'];
+
+            $offset = 3;
+
+            //
+            // extract the gatway based on the type
+            //
+            switch($this->gateway_type) {
+            case self::GATEWAY_TYPE_NONE:
+                $this->gateway = '';
+                break;
+
+            case self::GATEWAY_TYPE_IPV4:
+                $this->gateway = inet_ntop(substr($this->rdata, $offset, 4));
+                $offset += 4;
+                break;
+
+            case self::GATEWAY_TYPE_IPV6:
+                $ip = unpack('n8', substr($this->rdata, $offset, 16));
+                if (count($ip) == 8) {
+
+                    $this->gateway = vsprintf('%x:%x:%x:%x:%x:%x:%x:%x', $ip);
+                    $offset += 16;
+                } else {
+
+                    return false;
+                }
+                break;
+
+            case self::GATEWAY_TYPE_DOMAIN:
+
+                $doffset = $offset + $packet->offset;
+                $this->gateway = Net_DNS2_Packet::expand($packet, $doffset);
+                $offset = ($doffset - $packet->offset);
+                break;
+
+            default:
+                return false;
+            }
+
+            //
+            // extract the key
+            //
+            switch($this->algorithm) {
+            case self::ALGORITHM_NONE:
+                $this->key = '';
+                break;
+                
+            case self::ALGORITHM_DSA:
+            case self::ALGORITHM_RSA:
+                $this->key = base64_encode(substr($this->rdata, $offset));
+                break;
+             
+            default:
+                return false;
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        //
+        // pack the precedence, gateway type and algorithm
+        //
+        $data = pack(
+            'CCC', $this->precedence, $this->gateway_type, $this->algorithm
+        );
+
+        //
+        // add the gateway based on the type
+        //
+        switch($this->gateway_type) {
+        case self::GATEWAY_TYPE_NONE:
+            ; // add nothing
+            break;
+        
+        case self::GATEWAY_TYPE_IPV4:
+        case self::GATEWAY_TYPE_IPV6:
+            $data .= inet_pton($this->gateway);
+            break;
+            
+        case self::GATEWAY_TYPE_DOMAIN:
+            $data .= chr(strlen($this->gateway))  . $this->gateway;
+            break;
+            
+        default:
+            return null;
+        }
+
+        //
+        // add the key if there's one specified
+        //
+        switch($this->algorithm) {
+        case self::ALGORITHM_NONE:
+            ; // add nothing
+            break;
+            
+        case self::ALGORITHM_DSA:
+        case self::ALGORITHM_RSA:
+            $data .= base64_decode($this->key);
+            break;
+            
+        default:
+            return null;
+        }
+
+        $packet->offset += strlen($data);
+        
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/ISDN.php

@@ -0,0 +1,190 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * ISDN Resource Record - RFC1183 section 3.2
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                    ISDN-address               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                    SA                         /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_ISDN extends Net_DNS2_RR
+{
+    /*
+     * ISDN Number
+     */
+    public $isdnaddress;
+    
+    /*
+     * Sub-Address
+     */
+    public $sa;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->formatString($this->isdnaddress) . ' ' . 
+            $this->formatString($this->sa);
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $data = $this->buildString($rdata);
+        if (count($data) >= 1) {
+
+            $this->isdnaddress = $data[0];
+            if (isset($data[1])) {
+                
+                $this->sa = $data[1];
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $this->isdnaddress = Net_DNS2_Packet::label($packet, $packet->offset);
+
+            //
+            // look for a SA (sub address) - it's optional
+            //
+            if ( (strlen($this->isdnaddress) + 1) < $this->rdlength) {
+
+                $this->sa = Net_DNS2_Packet::label($packet, $packet->offset);
+            } else {
+            
+                $this->sa = '';
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->isdnaddress) > 0) {
+
+            $data = chr(strlen($this->isdnaddress)) . $this->isdnaddress;
+            if (!empty($this->sa)) {
+
+                $data .= chr(strlen($this->sa));
+                $data .= $this->sa;
+            }
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+        
+        return null; 
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/KEY.php

@@ -0,0 +1,85 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * the KEY RR is implemented the same as the DNSKEY RR, the only difference
+ * is how the flags data is parsed.
+ *
+ *     0   1   2   3   4   5   6   7   8   9   0   1   2   3   4   5
+ *   +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ *   |  A/C  | Z | XT| Z | Z | NAMTYP| Z | Z | Z | Z |      SIG      |
+ *   +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ *
+ * DNSKEY only uses bits 7 and 15
+ *
+ * We're not doing anything with these flags right now, so duplicating the
+ * class like this is fine.
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_KEY extends Net_DNS2_RR_DNSKEY
+{
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/KX.php

@@ -0,0 +1,179 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * KX Resource Record - RFC2230 section 3.1
+ *
+ * This class is almost identical to MX, except that the the exchanger
+ * domain is not compressed, it's added as a label
+ *
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *   |                  PREFERENCE                   |
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *   /                   EXCHANGER                   /
+ *   /                                               /
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_KX extends Net_DNS2_RR
+{
+    /*
+     * the preference for this mail exchanger
+     */    
+    public $preference;
+ 
+    /*
+     * the hostname of the mail exchanger
+     */
+    public $exchange;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->preference . ' ' . $this->cleanString($this->exchange) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->preference   = array_shift($rdata);
+        $this->exchange     = $this->cleanString(array_shift($rdata));
+ 
+        return true;        
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+   
+            //
+            // parse the preference
+            //
+            $x = unpack('npreference', $this->rdata);
+            $this->preference = $x['preference'];
+
+            //
+            // get the exchange entry server)
+            //
+            $offset = $packet->offset + 2;
+            $this->exchange = Net_DNS2_Packet::label($packet, $offset);
+
+            return true;
+        }
+      
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->exchange) > 0) {
+     
+            $data = pack('nC', $this->preference, strlen($this->exchange)) . 
+                $this->exchange;
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+    
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/L32.php

@@ -0,0 +1,180 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2013, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2013 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.3.1
+ *
+ */
+
+/**
+ * L32 Resource Record - RFC6742 section 2.2
+ *
+ *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |          Preference           |      Locator32 (16 MSBs)      |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |     Locator32 (16 LSBs)       |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_L32 extends Net_DNS2_RR
+{
+    /*
+     * The preference
+     */
+    public $preference;
+
+    /*
+     * The locator32 field
+     */
+    public $locator32;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->preference . ' ' . $this->locator32;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->preference = array_shift($rdata);
+        $this->locator32 = array_shift($rdata);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     * 
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the values
+            //
+            $x = unpack('npreference/C4locator', $this->rdata);
+
+            $this->preference = $x['preference'];
+
+            //
+            // build the locator value
+            //
+            $this->locator32 = $x['locator1'] . '.' . $x['locator2'] . '.' .
+                $x['locator3'] . '.' . $x['locator4'];
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     * 
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed 
+     *                                 string or null on failure
+     * @access protected
+     * 
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->locator32) > 0) {
+
+            //
+            // break out the locator value
+            //
+            $n = explode('.', $this->locator32);
+
+            //
+            // pack the data
+            //
+            return pack('nC4', $this->preference, $n[0], $n[1], $n[2], $n[3]);
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/L64.php

@@ -0,0 +1,187 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2013, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2013 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.3.1
+ *
+ */
+
+/**
+ * L64 Resource Record - RFC6742 section 2.3
+ *
+ *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |          Preference           |                               |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               +
+ *  |                          Locator64                            |
+ *  +                               +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |                               |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_L64 extends Net_DNS2_RR
+{
+    /*
+     * The preference
+     */
+    public $preference;
+
+    /*
+     * The locator64 field
+     */
+    public $locator64;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->preference . ' ' . $this->locator64;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->preference = array_shift($rdata);
+        $this->locator64 = array_shift($rdata);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     * 
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+ 
+            //
+            // unpack the values
+            //
+            $x = unpack('npreference/n4locator', $this->rdata);
+   
+            $this->preference = $x['preference'];
+ 
+            //
+            // build the locator64
+            //
+            $this->locator64 = dechex($x['locator1']) . ':' . 
+                dechex($x['locator2']) . ':' .
+                dechex($x['locator3']) . ':' . 
+                dechex($x['locator4']);
+      
+            return true;
+        }
+    
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     * 
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed 
+     *                                 string or null on failure
+     * @access protected
+     * 
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->locator64) > 0) {
+      
+            //
+            // break out the locator64
+            //
+            $n = explode(':', $this->locator64);
+    
+            //
+            // pack the data
+            //
+            return pack(
+                'n5', $this->preference, hexdec($n[0]), hexdec($n[1]),
+                hexdec($n[2]), hexdec($n[3])
+            );
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/LOC.php

@@ -0,0 +1,440 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * LOC Resource Record - RFC1876 section 2
+ *
+ *      +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *      |        VERSION        |         SIZE          |
+ *      +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *      |       HORIZ PRE       |       VERT PRE        |
+ *      +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *      |                   LATITUDE                    |
+ *      |                                               |
+ *      +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *      |                   LONGITUDE                   |
+ *      |                                               |
+ *      +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *      |                   ALTITUDE                    |
+ *      |                                               |
+ *      +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_LOC extends Net_DNS2_RR
+{
+    /*
+     * the LOC version- should only ever be 0
+     */
+    public $version;
+
+    /*
+     * The diameter of a sphere enclosing the described entity
+     */
+    public $size;
+
+    /*
+     * The horizontal precision of the data
+     */
+    public $horiz_pre;
+
+    /*
+     * The vertical precision of the data
+     */
+    public $vert_pre;
+
+    /*
+     * The latitude - stored in decimal degrees
+     */
+    public $latitude;
+
+    /* 
+     * The longitude - stored in decimal degrees
+     */
+    public $longitude;
+
+    /*
+     * The altitude - stored in decimal
+     */
+    public $altitude;
+
+    /*
+     * used for quick power-of-ten lookups
+     */
+    private $_powerOfTen = array(1, 10, 100, 1000, 10000, 100000, 
+                                 1000000,10000000,100000000,1000000000);
+
+    /*
+     * some conversion values
+     */
+    const CONV_SEC          = 1000;
+    const CONV_MIN          = 60000;
+    const CONV_DEG          = 3600000;
+
+    const REFERENCE_ALT     = 10000000;
+    const REFERENCE_LATLON  = 2147483648;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        if ($this->version == 0) {
+
+            return $this->_d2Dms($this->latitude, 'LAT') . ' ' . 
+                $this->_d2Dms($this->longitude, 'LNG') . ' ' . 
+                sprintf('%.2fm', $this->altitude) . ' ' .
+                sprintf('%.2fm', $this->size) . ' ' .
+                sprintf('%.2fm', $this->horiz_pre) . ' ' .
+                sprintf('%.2fm', $this->vert_pre);
+        }
+        
+        return '';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        //
+        // format as defined by RFC1876 section 3
+        //
+        // d1 [m1 [s1]] {"N"|"S"} d2 [m2 [s2]] {"E"|"W"} alt["m"] 
+        //      [siz["m"] [hp["m"] [vp["m"]]]]
+        //
+        $res = preg_match(
+            '/^(\d+) \s+((\d+) \s+)?(([\d.]+) \s+)?(N|S) \s+(\d+) ' .
+            '\s+((\d+) \s+)?(([\d.]+) \s+)?(E|W) \s+(-?[\d.]+) m?(\s+ ' .
+            '([\d.]+) m?)?(\s+ ([\d.]+) m?)?(\s+ ([\d.]+) m?)?/ix', 
+            implode(' ', $rdata), $x
+        );
+
+        if ($res) {
+
+            //
+            // latitude
+            //
+            $latdeg     = $x[1];
+            $latmin     = (isset($x[3])) ? $x[3] : 0;
+            $latsec     = (isset($x[5])) ? $x[5] : 0;
+            $lathem     = strtoupper($x[6]);
+
+            $this->latitude = $this->_dms2d($latdeg, $latmin, $latsec, $lathem);
+
+            //
+            // longitude
+            //
+            $londeg     = $x[7];
+            $lonmin     = (isset($x[9])) ? $x[9] : 0;
+            $lonsec     = (isset($x[11])) ? $x[11] : 0;
+            $lonhem     = strtoupper($x[12]);
+
+            $this->longitude = $this->_dms2d($londeg, $lonmin, $lonsec, $lonhem);
+
+            //
+            // the rest of teh values
+            //
+            $version            = 0;
+
+            $this->size         = (isset($x[15])) ? $x[15] : 1;
+            $this->horiz_pre    = ((isset($x[17])) ? $x[17] : 10000);
+            $this->vert_pre     = ((isset($x[19])) ? $x[19] : 10);
+            $this->altitude     = $x[13];
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack all the values
+            //
+            $x = unpack(
+                'Cver/Csize/Choriz_pre/Cvert_pre/Nlatitude/Nlongitude/Naltitude', 
+                $this->rdata
+            );
+
+            //
+            // version must be 0 per RFC 1876 section 2
+            //
+            $this->version = $x['ver'];
+            if ($this->version == 0) {
+
+                $this->size         = $this->_precsizeNtoA($x['size']);
+                $this->horiz_pre    = $this->_precsizeNtoA($x['horiz_pre']);
+                $this->vert_pre     = $this->_precsizeNtoA($x['vert_pre']);
+
+                //
+                // convert the latitude and longitude to degress in decimal
+                //
+                if ($x['latitude'] < 0) {
+
+                    $this->latitude = ($x['latitude'] + 
+                        self::REFERENCE_LATLON) / self::CONV_DEG;
+                } else {
+
+                    $this->latitude = ($x['latitude'] - 
+                        self::REFERENCE_LATLON) / self::CONV_DEG;
+                }
+
+                if ($x['longitude'] < 0) {
+ 
+                    $this->longitude = ($x['longitude'] + 
+                        self::REFERENCE_LATLON) / self::CONV_DEG;
+                } else {
+
+                    $this->longitude = ($x['longitude'] - 
+                        self::REFERENCE_LATLON) / self::CONV_DEG;
+                }
+
+                //
+                // convert down the altitude
+                //
+                $this->altitude = ($x['altitude'] - self::REFERENCE_ALT) / 100;
+
+                return true;
+
+            } else {
+
+                return false;
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->version == 0) {
+
+            $lat = 0;
+            $lng = 0;
+
+            if ($this->latitude < 0) {
+
+                $lat = ($this->latitude * self::CONV_DEG) - self::REFERENCE_LATLON;
+            } else {
+
+                $lat = ($this->latitude * self::CONV_DEG) + self::REFERENCE_LATLON;
+            }
+
+            if ($this->longitude < 0) {
+
+                $lng = ($this->longitude * self::CONV_DEG) - self::REFERENCE_LATLON;
+            } else {
+
+                $lng = ($this->longitude * self::CONV_DEG) + self::REFERENCE_LATLON;
+            }
+
+            $packet->offset += 16;
+
+            return pack(
+                'CCCCNNN', 
+                $this->version,
+                $this->_precsizeAtoN($this->size),
+                $this->_precsizeAtoN($this->horiz_pre),
+                $this->_precsizeAtoN($this->vert_pre),
+                $lat, $lng,
+                ($this->altitude * 100) + self::REFERENCE_ALT
+            );
+        }
+
+        return null;
+    }
+
+    /**
+     * takes an XeY precision/size value, returns a string representation.
+     * shamlessly stolen from RFC1876 Appendix A
+     *
+     * @param integer $prec the value to convert
+     *
+     * @return string
+     * @access private
+     *
+     */
+    private function _precsizeNtoA($prec)
+    {
+        $mantissa = (($prec >> 4) & 0x0f) % 10;
+        $exponent = (($prec >> 0) & 0x0f) % 10;
+
+        return $mantissa * $this->_powerOfTen[$exponent];
+    }
+
+    /**
+     * converts ascii size/precision X * 10**Y(cm) to 0xXY.
+     * shamlessly stolen from RFC1876 Appendix A
+     *
+     * @param string $prec the value to convert
+     *
+     * @return integer
+     * @access private
+     *
+     */
+    private function _precsizeAtoN($prec)
+    {
+        $exponent = 0;
+        while ($prec >= 10) {
+
+            $prec /= 10;
+            ++$exponent;
+        }
+
+        return ($prec << 4) | ($exponent & 0x0f);
+    }
+
+    /**
+     * convert lat/lng in deg/min/sec/hem to decimal value
+     *
+     * @param integer $deg the degree value
+     * @param integer $min the minutes value
+     * @param integer $sec the seconds value
+     * @param string  $hem the hemisphere (N/E/S/W)
+     *
+     * @return float the decinmal value
+     * @access private
+     *
+     */
+    private function _dms2d($deg, $min, $sec, $hem)
+    {
+        $deg = $deg - 0;
+        $min = $min - 0;
+
+        $sign = ($hem == 'W' || $hem == 'S') ? -1 : 1;
+        return ((($sec/60+$min)/60)+$deg) * $sign;
+    }
+
+    /**
+     * convert lat/lng in decimal to deg/min/sec/hem
+     *
+     * @param float  $data   the decimal value
+     * @param string $latlng either LAT or LNG so we can determine the HEM value
+     *
+     * @return string
+     * @access private
+     *
+     */
+    private function _d2Dms($data, $latlng)
+    {
+        $deg = 0;
+        $min = 0;
+        $sec = 0;
+        $msec = 0;
+        $hem = '';
+
+        if ($latlng == 'LAT') {
+            $hem = ($data > 0) ? 'N' : 'S';
+        } else {
+            $hem = ($data > 0) ? 'E' : 'W';
+        }
+
+        $data = abs($data);
+
+        $deg = (int)$data;
+        $min = (int)(($data - $deg) * 60);
+        $sec = (int)(((($data - $deg) * 60) - $min) * 60);
+        $msec = round((((((($data - $deg) * 60) - $min) * 60) - $sec) * 1000));
+
+        return sprintf('%d %02d %02d.%03d %s', $deg, $min, $sec, round($msec), $hem);
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/LP.php

@@ -0,0 +1,177 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2013, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2013 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.3.1
+ *
+ */
+
+/**
+ * LP Resource Record - RFC6742 section 2.4
+ *
+ *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |          Preference           |                               /
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               /
+ *  /                                                               /
+ *  /                              FQDN                             /
+ *  /                                                               /
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_LP extends Net_DNS2_RR
+{
+    /*
+     * The preference
+     */
+    public $preference;
+
+    /*
+     * The fdqn field
+     */
+    public $fqdn;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->preference . ' ' . $this->fqdn . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->preference = array_shift($rdata);
+        $this->fqdn = trim(array_shift($rdata), '.');
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     * 
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+ 
+            //
+            // parse the preference
+            //
+            $x = unpack('npreference', $this->rdata);
+            $this->preference = $x['preference'];
+            $offset = $packet->offset + 2;
+
+            //
+            // get the hostname
+            //
+            $this->fqdn = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+       
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     * 
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed 
+     *                                 string or null on failure
+     * @access protected
+     * 
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->fqdn) > 0) {
+     
+            $data = pack('n', $this->preference);
+            $packet->offset += 2;
+
+            $data .= $packet->compress($this->fqdn, $packet->offset);
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/MX.php

@@ -0,0 +1,175 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * MX Resource Record - RFC1035 section 3.3.9
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                  PREFERENCE                   |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   EXCHANGE                    /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_MX extends Net_DNS2_RR
+{
+    /*
+     * the preference for this mail exchanger
+     */
+    public $preference;
+
+    /*
+     * the hostname of the mail exchanger
+     */
+    public $exchange;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->preference . ' ' . $this->cleanString($this->exchange) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->preference   = array_shift($rdata);
+        $this->exchange     = $this->cleanString(array_shift($rdata));
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // parse the preference
+            //
+            $x = unpack('npreference', $this->rdata);
+            $this->preference = $x['preference'];
+
+            //
+            // get the exchange entry server)
+            //
+            $offset = $packet->offset + 2;
+            $this->exchange = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->exchange) > 0) {
+
+            $data = pack('n', $this->preference);
+            $packet->offset += 2;
+
+            $data .= $packet->compress($this->exchange, $packet->offset);
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/NAPTR.php

@@ -0,0 +1,231 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * NAPTR Resource Record - RFC2915
+ *
+ *      0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *   |                     ORDER                     |
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *   |                   PREFERENCE                  |
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *   /                     FLAGS                     /
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *   /                   SERVICES                    /
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *   /                    REGEXP                     /
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *   /                  REPLACEMENT                  /
+ *   /                                               /
+ *   +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_NAPTR extends Net_DNS2_RR
+{
+    /*
+     * the order in which the NAPTR records MUST be processed
+     */
+    public $order;
+
+    /*
+     * specifies the order in which NAPTR records with equal "order"
+     * values SHOULD be processed
+     */
+    public $preference;
+
+    /*
+     * rewrite flags
+     */
+    public $flags;
+
+    /* 
+     * Specifies the service(s) available down this rewrite path
+     */
+    public $services;
+
+    /*
+     * regular expression
+     */
+    public $regexp;
+
+    /* 
+     * The next NAME to query for NAPTR, SRV, or address records
+     * depending on the value of the flags field
+     */
+    public $replacement;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->order . ' ' . $this->preference . ' ' . 
+            $this->formatString($this->flags) . ' ' . 
+            $this->formatString($this->services) . ' ' . 
+            $this->formatString($this->regexp) . ' ' . 
+            $this->cleanString($this->replacement) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->order        = array_shift($rdata);
+        $this->preference   = array_shift($rdata);
+
+        $data = $this->buildString($rdata);
+        if (count($data) == 4) {
+
+            $this->flags        = $data[0];
+            $this->services     = $data[1];
+            $this->regexp       = $data[2];
+            $this->replacement  = $this->cleanString($data[3]);
+        
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+            
+            //
+            // unpack the order and preference
+            //
+            $x = unpack('norder/npreference', $this->rdata);
+            
+            $this->order        = $x['order'];
+            $this->preference   = $x['preference'];
+
+            $offset             = $packet->offset + 4;
+
+            $this->flags        = Net_DNS2_Packet::label($packet, $offset);
+            $this->services     = Net_DNS2_Packet::label($packet, $offset);
+            $this->regexp       = Net_DNS2_Packet::label($packet, $offset);
+
+            $this->replacement  = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if ( (isset($this->order)) && (strlen($this->services) > 0) ) {
+            
+            $data = pack('nn', $this->order, $this->preference);
+
+            $data .= chr(strlen($this->flags)) . $this->flags;
+            $data .= chr(strlen($this->services)) . $this->services;
+            $data .= chr(strlen($this->regexp)) . $this->regexp;
+
+            $packet->offset += strlen($data);
+
+            $data .= $packet->compress($this->replacement, $packet->offset);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/NID.php

@@ -0,0 +1,187 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2013, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2013 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.3.1
+ *
+ */
+
+/**
+ * NID Resource Record - RFC6742 section 2.1
+ *
+ *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |          Preference           |                               |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               +
+ *  |                             NodeID                            |
+ *  +                               +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |                               |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_NID extends Net_DNS2_RR
+{
+    /*
+     * The preference
+     */
+    public $preference;
+
+    /*
+     * The node ID field
+     */
+    public $nodeid;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->preference . ' ' . $this->nodeid;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->preference = array_shift($rdata);
+        $this->nodeid = array_shift($rdata);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     * 
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+        
+            //
+            // unpack the values
+            //
+            $x = unpack('npreference/n4nodeid', $this->rdata);
+
+            $this->preference = $x['preference'];
+
+            //
+            // build the node id
+            //
+            $this->nodeid = dechex($x['nodeid1']) . ':' . 
+                dechex($x['nodeid2']) . ':' .
+                dechex($x['nodeid3']) . ':' . 
+                dechex($x['nodeid4']);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     * 
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed 
+     *                                 string or null on failure
+     * @access protected
+     * 
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->nodeid) > 0) {
+
+            //
+            // break out the node id
+            //
+            $n = explode(':', $this->nodeid);
+
+            //
+            // pack the data
+            //
+            return pack(
+                'n5', $this->preference, hexdec($n[0]), hexdec($n[1]), 
+                hexdec($n[2]), hexdec($n[3])
+            );
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/NIMLOC.php

@@ -0,0 +1,130 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * NIMLOCK Resource Record - undefined; the rdata is simply used as-is in it's
+ *                              binary format, so not process has to be done.
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_NIMLOCK extends Net_DNS2_RR
+{
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return '';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        return true;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        return $this->rdata;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/NS.php

@@ -0,0 +1,153 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * NS Resource Record - RFC1035 section 3.3.11
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   NSDNAME                     /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_NS extends Net_DNS2_RR
+{
+    /*
+     * the hostname of the DNS server
+     */
+    public $nsdname;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->cleanString($this->nsdname) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->nsdname = $this->cleanString(array_shift($rdata));
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $offset = $packet->offset;
+            $this->nsdname = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->nsdname) > 0) {
+
+            return $packet->compress($this->nsdname, $packet->offset);
+        }
+        
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/NSAP.php

@@ -0,0 +1,262 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * NSAP Resource Record - RFC1706
+ *
+ *             |--------------|
+ *             | <-- IDP -->  |
+ *             |--------------|-------------------------------------|
+ *             | AFI |  IDI   |            <-- DSP -->              |
+ *             |-----|--------|-------------------------------------|
+ *             | 47  |  0005  | DFI | AA |Rsvd | RD |Area | ID |Sel |
+ *             |-----|--------|-----|----|-----|----|-----|----|----|
+ *      octets |  1  |   2    |  1  | 3  |  2  | 2  |  2  | 6  | 1  |
+ *             |-----|--------|-----|----|-----|----|-----|----|----|
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_NSAP extends Net_DNS2_RR
+{
+    public $afi;
+    public $idi;
+    public $dfi;
+    public $aa;
+    public $rsvd;
+    public $rd;
+    public $area;
+    public $id;
+    public $sel;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->cleanString($this->afi) . '.' . 
+            $this->cleanString($this->idi) . '.' . 
+            $this->cleanString($this->dfi) . '.' . 
+            $this->cleanString($this->aa) . '.' . 
+            $this->cleanString($this->rsvd) . '.' . 
+            $this->cleanString($this->rd) . '.' . 
+            $this->cleanString($this->area) . '.' . 
+            $this->cleanString($this->id) . '.' . 
+            $this->sel;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $data = strtolower(trim(array_shift($rdata)));
+
+        //
+        // there is no real standard for format, so we can't rely on the fact that
+        // the value will come in with periods separating the values- so strip 
+        // them out if they're included, and parse without them.
+        //    
+        $data = str_replace(array('.', '0x'), '', $data);
+
+        //
+        // unpack it as ascii characters
+        //
+        $x = unpack('A2afi/A4idi/A2dfi/A6aa/A4rsvd/A4rd/A4area/A12id/A2sel', $data);
+        
+        //
+        // make sure the afi value is 47
+        //
+        if ($x['afi'] == '47') {
+
+            $this->afi  = '0x' . $x['afi'];
+            $this->idi  = $x['idi'];
+            $this->dfi  = $x['dfi'];
+            $this->aa   = $x['aa'];
+            $this->rsvd = $x['rsvd'];
+            $this->rd   = $x['rd'];
+            $this->area = $x['area'];
+            $this->id   = $x['id'];
+            $this->sel  = $x['sel'];
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength == 20) {
+
+            //
+            // get the AFI value
+            //
+            $this->afi = dechex(ord($this->rdata[0]));
+
+            //
+            // we only support AFI 47- there arent' any others defined.
+            //
+            if ($this->afi == '47') {
+
+                //
+                // unpack the rest of the values
+                //
+                $x = unpack(
+                    'Cafi/nidi/Cdfi/C3aa/nrsvd/nrd/narea/Nidh/nidl/Csel', 
+                    $this->rdata
+                );
+
+                $this->afi  = sprintf('0x%02x', $x['afi']);
+                $this->idi  = sprintf('%04x', $x['idi']);
+                $this->dfi  = sprintf('%02x', $x['dfi']);
+                $this->aa   = sprintf(
+                    '%06x', $x['aa1'] << 16 | $x['aa2'] << 8 | $x['aa3']
+                );
+                $this->rsvd = sprintf('%04x', $x['rsvd']);
+                $this->rd   = sprintf('%04x', $x['rd']);
+                $this->area = sprintf('%04x', $x['area']);
+                $this->id   = sprintf('%08x', $x['idh']) . 
+                    sprintf('%04x', $x['idl']);
+                $this->sel  = sprintf('%02x', $x['sel']);
+
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->afi == '0x47') {
+
+            //
+            // build the aa field
+            //
+            $aa = unpack('A2x/A2y/A2z', $this->aa);
+
+            //
+            // build the id field
+            //
+            $id = unpack('A8a/A4b', $this->id);
+
+            //
+            $data = pack(
+                'CnCCCCnnnNnC', 
+                hexdec($this->afi), 
+                hexdec($this->idi),
+                hexdec($this->dfi),
+                hexdec($aa['x']),
+                hexdec($aa['y']),
+                hexdec($aa['z']),
+                hexdec($this->rsvd),
+                hexdec($this->rd),
+                hexdec($this->area),
+                hexdec($id['a']),
+                hexdec($id['b']),
+                hexdec($this->sel)
+            );
+
+            if (strlen($data) == 20) {
+                
+                $packet->offset += 20;
+                return $data;
+            }
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/NSEC.php

@@ -0,0 +1,184 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * NSEC Resource Record - RFC3845 section 2.1
+ *
+ *    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   /                      Next Domain Name                         /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   /                   List of Type Bit Map(s)                     /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_NSEC extends Net_DNS2_RR
+{
+    /*
+     * The next owner name
+     */
+    public $next_domain_name;
+
+    /*
+     * identifies the RRset types that exist at the NSEC RR's owner name.
+     */
+    public $type_bit_maps = array();
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $data = $this->cleanString($this->next_domain_name) . '.';
+
+        foreach ($this->type_bit_maps as $rr) {
+
+            $data .= ' ' . $rr;
+        }
+
+        return $data;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->next_domain_name = $this->cleanString(array_shift($rdata));
+        $this->type_bit_maps = $rdata;
+        
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // expand the next domain name
+            //
+            $offset = $packet->offset;
+            $this->next_domain_name = Net_DNS2_Packet::expand($packet, $offset);
+
+            //
+            // parse out the RR's from the bitmap
+            //
+            $this->type_bit_maps = Net_DNS2_BitMap::bitMapToArray(
+                substr($this->rdata, $offset - $packet->offset)
+            );
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->next_domain_name) > 0) {
+
+            $data = $packet->compress($this->next_domain_name, $packet->offset);
+            $bitmap = Net_DNS2_BitMap::arrayToBitMap($this->type_bit_maps);
+    
+            $packet->offset += strlen($bitmap);
+
+            return $data . $bitmap;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/NSEC3.php

@@ -0,0 +1,310 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * NSEC3 Resource Record - RFC5155 section 3.2
+ *
+ *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |   Hash Alg.   |     Flags     |          Iterations           |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |  Salt Length  |                     Salt                      /
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |  Hash Length  |             Next Hashed Owner Name            /
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  /                         Type Bit Maps                         /
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_NSEC3 extends Net_DNS2_RR
+{
+    /*
+     * Algorithm to use
+     */
+    public $algorithm;
+ 
+    /*
+     * flags
+     */
+    public $flags;
+ 
+    /*
+     *  defines the number of additional times the hash is performed.
+     */
+    public $iterations;
+ 
+    /*
+     * the length of the salt- not displayed
+     */
+    public $salt_length;
+ 
+    /*
+     * the salt
+     */
+    public $salt;
+
+    /*
+     * the length of the hash value
+     */
+    public $hash_length;
+
+    /*
+     * the hashed value of the owner name
+     */
+    public $hashed_owner_name;
+
+    /*
+     * array of RR type names
+     */
+    public $type_bit_maps = array();
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $out = $this->algorithm . ' ' . $this->flags . ' ' . $this->iterations . ' ';
+ 
+        //
+        // per RFC5155, the salt_length value isn't displayed, and if the salt
+        // is empty, the salt is displayed as '-'
+        //
+        if ($this->salt_length > 0) {
+  
+            $out .= $this->salt;
+        } else {     
+ 
+            $out .= '-';
+        }
+
+        //
+        // per RFC5255 the hash length isn't shown
+        //
+        $out .= ' ' . $this->hashed_owner_name;
+ 
+        //
+        // show the RR's
+        //
+        foreach ($this->type_bit_maps as $rr) {
+    
+            $out .= ' ' . strtoupper($rr);
+        }
+
+        return $out;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->algorithm    = array_shift($rdata);
+        $this->flags        = array_shift($rdata);
+        $this->iterations   = array_shift($rdata);
+     
+        //
+        // an empty salt is represented as '-' per RFC5155 section 3.3
+        //
+        $salt = array_shift($rdata);
+        if ($salt == '-') {
+
+            $this->salt_length = 0;
+            $this->salt = '';
+        } else {
+    
+            $this->salt_length = strlen(pack('H*', $salt));
+            $this->salt = strtoupper($salt);
+        }
+
+        $this->hashed_owner_name = array_shift($rdata);
+        $this->hash_length = strlen(base64_decode($this->hashed_owner_name));
+
+        $this->type_bit_maps = $rdata;
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+        
+            //
+            // unpack the first values
+            //
+            $x = unpack('Calgorithm/Cflags/niterations/Csalt_length', $this->rdata);
+        
+            $this->algorithm    = $x['algorithm'];
+            $this->flags        = $x['flags'];
+            $this->iterations   = $x['iterations'];
+            $this->salt_length  = $x['salt_length'];
+
+            $offset = 5;
+
+            if ($this->salt_length > 0) {
+ 
+                $x = unpack('H*', substr($this->rdata, $offset, $this->salt_length));
+                $this->salt = strtoupper($x[1]);
+                $offset += $this->salt_length;
+            }
+
+            //
+            // unpack the hash length
+            //
+            $x = unpack('@' . $offset . '/Chash_length', $this->rdata);
+            $offset++;
+
+            //
+            // copy out the hash
+            //
+            $this->hash_length  = $x['hash_length'];
+            if ($this->hash_length > 0) {
+
+                $this->hashed_owner_name = base64_encode(
+                    substr($this->rdata, $offset, $this->hash_length)
+                );
+                $offset += $this->hash_length;
+            }
+
+            //
+            // parse out the RR bitmap
+            //
+            $this->type_bit_maps = Net_DNS2_BitMap::bitMapToArray(
+                substr($this->rdata, $offset)
+            );
+
+            return true;
+        }
+     
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        //
+        // pull the salt and build the length
+        //
+        $salt = pack('H*', $this->salt);
+        $this->salt_length = strlen($salt);
+            
+        //
+        // pack the algorithm, flags, iterations and salt length
+        //
+        $data = pack(
+            'CCnC',
+            $this->algorithm, $this->flags, $this->iterations, $this->salt_length
+        );
+        $data .= $salt;
+
+        //
+        // add the hash length and hash
+        //
+        $data .= chr($this->hash_length);
+        if ($this->hash_length > 0) {
+
+            $data .= base64_decode($this->hashed_owner_name);
+        }
+
+        //
+        // conver the array of RR names to a type bitmap
+        //
+        $data .= Net_DNS2_BitMap::arrayToBitMap($this->type_bit_maps);
+
+        $packet->offset += strlen($data);
+     
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/NSEC3PARAM.php

@@ -0,0 +1,220 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * NSEC3PARAM Resource Record - RFC5155 section 4.2
+ *
+ *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |   Hash Alg.   |     Flags     |          Iterations           |
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |  Salt Length  |                     Salt                      /
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_NSEC3PARAM extends Net_DNS2_RR
+{
+    /*
+     * Algorithm to use
+     *
+     * TODO: same as the NSEC3
+     */
+    public $algorithm;
+
+    /*
+     * flags
+     */
+    public $flags;
+
+    /*
+     *  defines the number of additional times the hash is performed.
+     */
+    public $iterations;
+
+    /*
+     * the length of the salt- not displayed
+     */
+    public $salt_length;
+
+    /*
+     * the salt
+     */
+    public $salt;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $out = $this->algorithm . ' ' . $this->flags . ' ' . $this->iterations . ' ';
+
+        //
+        // per RFC5155, the salt_length value isn't displayed, and if the salt 
+        // is empty, the salt is displayed as "-"
+        //        
+        if ($this->salt_length > 0) {
+
+            $out .= $this->salt;
+        } else {
+            
+            $out .= '-';
+        }
+    
+        return $out;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->algorithm    = array_shift($rdata);
+        $this->flags        = array_shift($rdata);
+        $this->iterations   = array_shift($rdata);
+
+        $salt = array_shift($rdata);
+        if ($salt == '-') {
+
+            $this->salt_length = 0;
+            $this->salt = '';
+        } else {
+
+            $this->salt_length = strlen(pack('H*', $salt));
+            $this->salt = strtoupper($salt);
+        }
+        
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $x = unpack('Calgorithm/Cflags/niterations/Csalt_length', $this->rdata);
+
+            $this->algorithm    = $x['algorithm'];
+            $this->flags        = $x['flags'];
+            $this->iterations   = $x['iterations'];
+            $this->salt_length  = $x['salt_length'];
+
+            if ($this->salt_length > 0) {
+
+                $x = unpack('H*', substr($this->rdata, 5, $this->salt_length));
+                $this->salt = strtoupper($x[1]);
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        $salt = pack('H*', $this->salt);
+        $this->salt_length = strlen($salt);
+
+        $data = pack(
+            'CCnC', 
+            $this->algorithm, $this->flags, $this->iterations, $this->salt_length
+        ) . $salt;
+
+        $packet->offset += strlen($data);
+
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/OPENPGPKEY.php

@@ -0,0 +1,159 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2014, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2014 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.4.0
+ *
+ */
+
+/**
+ * OPENPGPKEY Resource Record - https://tools.ietf.org/html/draft-ietf-dane-openpgpkey-01
+ *
+ *    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   /                                                               /
+ *   /                  OpenPGP Public KeyRing                       /
+ *   /                                                               /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_OPENPGPKEY extends Net_DNS2_RR
+{
+    /*
+     * the public key
+     */
+    public $key;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->key;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->key = array_shift($rdata);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $this->key = base64_encode(substr($this->rdata, 0, $this->rdlength));
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->key) > 0) {
+
+            $data = base64_decode($this->key);
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+        
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/OPT.php

@@ -0,0 +1,292 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.0.0
+ *
+ */
+
+/**
+ * OPT Resource Record - RFC2929 section 3.1
+ *
+ *    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ *    |                          OPTION-CODE                          |
+ *    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ *    |                         OPTION-LENGTH                         |
+ *    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ *    |                                                               |
+ *    /                          OPTION-DATA                          /
+ *    /                                                               /
+ *    +---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_OPT extends Net_DNS2_RR
+{
+    /*
+     * option code - assigned by IANA
+     */
+    public $option_code;
+
+    /*
+     * the length of the option data
+     */
+    public $option_length;
+
+    /*
+     * the option data
+     */
+    public $option_data;
+
+    /*
+     * the extended response code stored in the TTL
+     */
+    public $extended_rcode;
+
+    /*
+     * the implementation level
+     */
+    public $version;
+
+    /*
+     * the DO bit used for DNSSEC - RFC3225
+     */
+    public $do;
+
+    /*
+     * the extended flags
+     */
+    public $z;
+
+    /**
+     * Constructor - builds a new Net_DNS2_RR_OPT object; normally you wouldn't call
+     * this directly, but OPT RR's are a little different
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet or null to create
+     *                                 an empty object
+     * @param array           $rr      an array with RR parse values or null to
+     *                                 create an empty object
+     *
+     * @throws Net_DNS2_Exception
+     * @access public
+     *
+     */
+    public function __construct(Net_DNS2_Packet &$packet = null, array $rr = null)
+    {
+        //
+        // this is for when we're manually building an OPT RR object; we aren't
+        // passing in binary data to parse, we just want a clean/empty object.
+        //
+        $this->type             = 'OPT';
+        $this->rdlength         = 0;
+
+        $this->option_length    = 0;
+        $this->extended_rcode   = 0;
+        $this->version          = 0;
+        $this->do               = 0;
+        $this->z                = 0;
+
+        //
+        // everthing else gets passed through to the parent.
+        //
+        if ( (!is_null($packet)) && (!is_null($rr)) ) {
+
+            parent::__construct($packet, $rr);
+        }
+    }
+
+    /**
+     * method to return the rdata portion of the packet as a string. There is no
+     * defintion for returning an OPT RR by string- this is just here to validate
+     * the binary parsing / building routines.
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->option_code . ' ' . $this->option_data;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line. There is no 
+     * definition for parsing a OPT RR by string- this is just here to validate
+     * the binary parsing / building routines.
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->option_code      = array_shift($rdata);
+        $this->option_data      = array_shift($rdata);
+        $this->option_length    = strlen($this->option_data);
+
+        $x = unpack('Cextended/Cversion/Cdo/Cz', pack('N', $this->ttl));
+
+        $this->extended_rcode   = $x['extended'];
+        $this->version          = $x['version'];
+        $this->do               = ($x['do'] >> 7);
+        $this->z                = $x['z'];
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        //
+        // parse out the TTL value
+        //
+        $x = unpack('Cextended/Cversion/Cdo/Cz', pack('N', $this->ttl));
+
+        $this->extended_rcode   = $x['extended'];
+        $this->version          = $x['version'];
+        $this->do               = ($x['do'] >> 7);
+        $this->z                = $x['z'];
+
+        //
+        // parse the data, if there is any
+        //
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the code and length
+            //
+            $x = unpack('noption_code/noption_length', $this->rdata);
+
+            $this->option_code      = $x['option_code'];
+            $this->option_length    = $x['option_length'];
+
+            //
+            // copy out the data based on the length
+            //
+            $this->option_data      = substr($this->rdata, 4);
+        }
+
+        return true;
+    }
+
+    /**
+     * pre-builds the TTL value for this record; we needed to separate this out
+     * from the rrGet() function, as the logic in the Net_DNS2_RR packs the TTL
+     * value before it builds the rdata value.
+     *
+     * @return void
+     * @access protected
+     *
+     */
+    protected function preBuild()
+    {
+        //
+        // build the TTL value based on the local values
+        //
+        $ttl = unpack(
+            'N', 
+            pack('CCCC', $this->extended_rcode, $this->version, ($this->do << 7), 0)
+        );
+
+        $this->ttl = $ttl[1];
+
+        return;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        //
+        // if there is an option code, then pack that data too
+        //
+        if ($this->option_code) {
+
+            $data = pack('nn', $this->option_code, $this->option_length) . 
+                $this->option_data;
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/PTR.php

@@ -0,0 +1,152 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * PTR Resource Record - RFC1035 section 3.3.12
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   PTRDNAME                    /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_PTR extends Net_DNS2_RR
+{
+    /*
+     * the hostname of the PTR entry
+     */
+    public $ptrdname;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return rtrim($this->ptrdname, '.') . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->ptrdname = rtrim(implode(' ', $rdata), '.');
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $offset = $packet->offset;
+            $this->ptrdname = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->ptrdname) > 0) {
+
+            return $packet->compress($this->ptrdname, $packet->offset);
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/PX.php

@@ -0,0 +1,186 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * PX Resource Record - RFC2163 section 4
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                  PREFERENCE                   |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                    MAP822                     /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                    MAPX400                    /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_PX extends Net_DNS2_RR
+{
+    /*
+     * preference
+     */
+    public $preference;
+
+    /* 
+     * the RFC822 part of the MCGAM
+     */
+    public $map822;
+
+    /*
+     * the X.400 part of the MCGAM
+     */
+    public $mapx400;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->preference . ' ' . $this->cleanString($this->map822) . '. ' . 
+            $this->cleanString($this->mapx400) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->preference   = $rdata[0];
+        $this->map822       = $this->cleanString($rdata[1]);
+        $this->mapx400      = $this->cleanString($rdata[2]);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // parse the preference
+            //
+            $x = unpack('npreference', $this->rdata);
+            $this->preference = $x['preference'];
+
+            $offset         = $packet->offset + 2;
+
+            $this->map822   = Net_DNS2_Packet::expand($packet, $offset);
+            $this->mapx400  = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->map822) > 0) {
+            
+            $data = pack('n', $this->preference);
+            $packet->offset += 2;
+
+            $data .= $packet->compress($this->map822, $packet->offset);
+            $data .= $packet->compress($this->mapx400, $packet->offset);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/RP.php

@@ -0,0 +1,167 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * RP Resource Record - RFC1183 section 2.2
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   mboxdname                   /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   txtdname                    /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_RP extends Net_DNS2_RR
+{
+    /*
+     * mailbox for the responsible person
+     */
+    public $mboxdname;
+
+    /*
+     * is a domain name for which TXT RR's exists
+     */
+    public $txtdname;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->cleanString($this->mboxdname) . '. ' . 
+            $this->cleanString($this->txtdname) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->mboxdname    = $this->cleanString($rdata[0]);
+        $this->txtdname     = $this->cleanString($rdata[1]);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $offset             = $packet->offset;
+
+            $this->mboxdname    = Net_DNS2_Packet::expand($packet, $offset);
+            $this->txtdname     = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->mboxdname) > 0) {
+
+            return $packet->compress($this->mboxdname, $packet->offset) .
+                $packet->compress($this->txtdname, $packet->offset);
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/RRSIG.php

@@ -0,0 +1,329 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ * This file contains code based off the Net::DNS::SEC Perl module by
+ * Olaf M. Kolkman
+ *
+ * This is the copyright notice from the PERL Net::DNS::SEC module:
+ *
+ * Copyright (c) 2001 - 2005  RIPE NCC.  Author Olaf M. Kolkman 
+ * Copyright (c) 2007 - 2008  NLnet Labs.  Author Olaf M. Kolkman 
+ * <olaf@net-dns.org>
+ *
+ * All Rights Reserved
+ *
+ * Permission to use, copy, modify, and distribute this software and its
+ * documentation for any purpose and without fee is hereby granted,
+ * provided that the above copyright notice appear in all copies and that
+ * both that copyright notice and this permission notice appear in
+ * supporting documentation, and that the name of the author not be
+ * used in advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ *
+ * THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
+ * ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS; IN NO EVENT SHALL
+ * AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
+ * DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
+ * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ *
+ */
+
+/**
+ * RRSIG Resource Record - RFC4034 sction 3.1
+ *
+ *    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |        Type Covered           |  Algorithm    |     Labels    |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |                         Original TTL                          |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |                      Signature Expiration                     |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |                      Signature Inception                      |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |            Key Tag            |                               /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+         Signer's Name         /
+ *   /                                                               /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   /                                                               /
+ *   /                            Signature                          /
+ *   /                                                               /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_RRSIG extends Net_DNS2_RR
+{
+    /*
+     * the RR type covered by this signature
+     */
+    public $typecovered;
+
+    /*
+     * the algorithm used for the signature
+     */
+    public $algorithm;
+    
+    /*
+     * the number of labels in the name
+     */
+    public $labels;
+
+    /*
+     * the original TTL
+     */
+    public $origttl;
+
+    /*
+     * the signature expiration
+     */
+    public $sigexp;
+
+    /*
+     * the inception of the signature
+    */
+    public $sigincep;
+
+    /*
+     * the keytag used
+     */
+    public $keytag;
+
+    /*
+     * the signer's name
+     */
+    public $signname;
+
+    /*
+     * the signature
+     */
+    public $signature;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->typecovered . ' ' . $this->algorithm . ' ' . 
+            $this->labels . ' ' . $this->origttl . ' ' .
+            $this->sigexp . ' ' . $this->sigincep . ' ' . 
+            $this->keytag . ' ' . $this->cleanString($this->signname) . '. ' . 
+            $this->signature;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->typecovered  = strtoupper(array_shift($rdata));
+        $this->algorithm    = array_shift($rdata);
+        $this->labels       = array_shift($rdata);
+        $this->origttl      = array_shift($rdata);
+        $this->sigexp       = array_shift($rdata);
+        $this->sigincep     = array_shift($rdata);
+        $this->keytag       = array_shift($rdata);
+        $this->signname     = $this->cleanString(array_shift($rdata));
+
+        foreach ($rdata as $line) {
+
+            $this->signature .= $line;
+        }
+
+        $this->signature = trim($this->signature);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack 
+            //
+            $x = unpack(
+                'ntc/Calgorithm/Clabels/Norigttl/Nsigexp/Nsigincep/nkeytag', 
+                $this->rdata
+            );
+
+            $this->typecovered  = Net_DNS2_Lookups::$rr_types_by_id[$x['tc']];
+            $this->algorithm    = $x['algorithm'];
+            $this->labels       = $x['labels'];
+            $this->origttl      = Net_DNS2::expandUint32($x['origttl']);
+
+            //
+            // the dates are in GM time
+            //
+            $this->sigexp       = gmdate('YmdHis', $x['sigexp']);
+            $this->sigincep     = gmdate('YmdHis', $x['sigincep']);
+
+            //
+            // get the keytag
+            //
+            $this->keytag       = $x['keytag'];
+
+            //
+            // get teh signers name and signature
+            //
+            $offset             = $packet->offset + 18;
+            $sigoffset          = $offset;
+
+            $this->signname     = strtolower(
+                Net_DNS2_Packet::expand($packet, $sigoffset)
+            );
+            $this->signature    = base64_encode(
+                substr($this->rdata, 18 + ($sigoffset - $offset))
+            );
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->signature) > 0) {
+
+            //
+            // parse the values out of the dates
+            //
+            preg_match(
+                '/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/', $this->sigexp, $e
+            );
+            preg_match(
+                '/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/', $this->sigincep, $i
+            );
+
+            //
+            // pack the value
+            //
+            $data = pack(
+                'nCCNNNn', 
+                Net_DNS2_Lookups::$rr_types_by_name[$this->typecovered],
+                $this->algorithm,
+                $this->labels,
+                $this->origttl,
+                gmmktime($e[4], $e[5], $e[6], $e[2], $e[3], $e[1]),
+                gmmktime($i[4], $i[5], $i[6], $i[2], $i[3], $i[1]),
+                $this->keytag
+            );
+
+            //
+            // the signer name is special; it's not allowed to be compressed 
+            // (see section 3.1.7)
+            //
+            $names = explode('.', strtolower($this->signname));
+            foreach ($names as $name) {
+    
+                $data .= chr(strlen($name));
+                $data .= $name;
+            }
+            $data .= "\0";
+
+            //
+            // add the signature
+            //
+            $data .= base64_decode($this->signature);
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+        
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/RT.php

@@ -0,0 +1,175 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * RT Resource Record - RFC1183 section 3.3
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                preference                     |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /             intermediate-host                 /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_RT extends Net_DNS2_RR
+{
+    /*
+     * the preference of this route
+     */
+    public $preference;
+
+    /*
+      * host which will servce as an intermediate in reaching the owner host
+     */
+    public $intermediatehost;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->preference . ' ' . 
+            $this->cleanString($this->intermediatehost) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->preference       = $rdata[0];
+        $this->intermediatehost = $this->cleanString($rdata[1]);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the preference
+            //
+            $x = unpack('npreference', $this->rdata);
+
+            $this->preference       = $x['preference'];
+            $offset                 = $packet->offset + 2;
+
+            $this->intermediatehost =  Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->intermediatehost) > 0) {
+
+            $data = pack('n', $this->preference);
+            $packet->offset += 2;
+
+            $data .= $packet->compress($this->intermediatehost, $packet->offset);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/SIG.php

@@ -0,0 +1,459 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ * This file contains code based off the Net::DNS::SEC Perl module by
+ * Olaf M. Kolkman
+ *
+ * This is the copyright notice from the PERL Net::DNS::SEC module:
+ *
+ * Copyright (c) 2001 - 2005  RIPE NCC.  Author Olaf M. Kolkman 
+ * Copyright (c) 2007 - 2008  NLnet Labs.  Author Olaf M. Kolkman 
+ * <olaf@net-dns.org>
+ *
+ * All Rights Reserved
+ *
+ * Permission to use, copy, modify, and distribute this software and its
+ * documentation for any purpose and without fee is hereby granted,
+ * provided that the above copyright notice appear in all copies and that
+ * both that copyright notice and this permission notice appear in
+ * supporting documentation, and that the name of the author not be
+ * used in advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ *
+ * THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
+ * ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS; IN NO EVENT SHALL
+ * AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
+ * DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
+ * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ *
+ */
+
+/**
+ * SIG Resource Record - RFC2535 section 4.1
+ *
+ *    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |        Type Covered           |  Algorithm    |     Labels    |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |                         Original TTL                          |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |                      Signature Expiration                     |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |                      Signature Inception                      |
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   |            Key Tag            |                               /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+         Signer's Name         /
+ *   /                                                               /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *   /                                                               /
+ *   /                            Signature                          /
+ *   /                                                               /
+ *   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_SIG extends Net_DNS2_RR
+{
+    /*
+     * and instance of a Net_DNS2_PrivateKey object
+     */
+    public $private_key = null;
+
+    /*
+     * the RR type covered by this signature
+     */
+    public $typecovered;
+
+    /*
+     * the algorithm used for the signature
+     */
+    public $algorithm;
+    
+    /*
+     * the number of labels in the name
+     */
+    public $labels;
+
+    /*
+     * the original TTL
+     */
+    public $origttl;
+
+    /*
+     * the signature expiration
+     */
+    public $sigexp;
+
+    /*
+     * the inception of the signature
+    */
+    public $sigincep;
+
+    /*
+     * the keytag used
+     */
+    public $keytag;
+
+    /*
+     * the signer's name
+     */
+    public $signname;
+
+    /*
+     * the signature
+     */
+    public $signature;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->typecovered . ' ' . $this->algorithm . ' ' . 
+            $this->labels . ' ' . $this->origttl . ' ' .
+            $this->sigexp . ' ' . $this->sigincep . ' ' . 
+            $this->keytag . ' ' . $this->cleanString($this->signname) . '. ' . 
+            $this->signature;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->typecovered  = strtoupper(array_shift($rdata));
+        $this->algorithm    = array_shift($rdata);
+        $this->labels       = array_shift($rdata);
+        $this->origttl      = array_shift($rdata);
+        $this->sigexp       = array_shift($rdata);
+        $this->sigincep     = array_shift($rdata);
+        $this->keytag       = array_shift($rdata);
+        $this->signname     = $this->cleanString(array_shift($rdata));
+
+        foreach ($rdata as $line) {
+
+            $this->signature .= $line;
+        }
+
+        $this->signature = trim($this->signature);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack 
+            //
+            $x = unpack(
+                'ntc/Calgorithm/Clabels/Norigttl/Nsigexp/Nsigincep/nkeytag', 
+                $this->rdata
+            );
+
+            $this->typecovered  = Net_DNS2_Lookups::$rr_types_by_id[$x['tc']];
+            $this->algorithm    = $x['algorithm'];
+            $this->labels       = $x['labels'];
+            $this->origttl      = Net_DNS2::expandUint32($x['origttl']);
+
+            //
+            // the dates are in GM time
+            //
+            $this->sigexp       = gmdate('YmdHis', $x['sigexp']);
+            $this->sigincep     = gmdate('YmdHis', $x['sigincep']);
+
+            //
+            // get the keytag
+            //
+            $this->keytag       = $x['keytag'];
+
+            //
+            // get teh signers name and signature
+            //
+            $offset             = $packet->offset + 18;
+            $sigoffset          = $offset;
+
+            $this->signname     = strtolower(
+                Net_DNS2_Packet::expand($packet, $sigoffset)
+            );
+            $this->signature    = base64_encode(
+                substr($this->rdata, 18 + ($sigoffset - $offset))
+            );
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        //
+        // parse the values out of the dates
+        //
+        preg_match(
+            '/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/', $this->sigexp, $e
+        );
+        preg_match(
+            '/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/', $this->sigincep, $i
+        );
+
+        //
+        // pack the value
+        //
+        $data = pack(
+            'nCCNNNn', 
+            Net_DNS2_Lookups::$rr_types_by_name[$this->typecovered],
+            $this->algorithm,
+            $this->labels,
+            $this->origttl,
+            gmmktime($e[4], $e[5], $e[6], $e[2], $e[3], $e[1]),
+            gmmktime($i[4], $i[5], $i[6], $i[2], $i[3], $i[1]),
+            $this->keytag
+        );
+
+        //
+        // the signer name is special; it's not allowed to be compressed 
+        // (see section 3.1.7)
+        //
+        $names = explode('.', strtolower($this->signname));
+        foreach ($names as $name) {
+
+            $data .= chr(strlen($name));
+            $data .= $name;
+        }
+
+        $data .= chr('0');
+
+        //
+        // if the signature is empty, and $this->private_key is an instance of a 
+        // private key object, and we have access to openssl, then assume this
+        // is a SIG(0), and generate a new signature
+        //
+        if ( (strlen($this->signature) == 0)
+            && ($this->private_key instanceof Net_DNS2_PrivateKey)
+            && (extension_loaded('openssl') === true)
+        ) {
+
+            //
+            // create a new packet for the signature-
+            //
+            $new_packet = new Net_DNS2_Packet_Request('example.com', 'SOA', 'IN');
+
+            //
+            // copy the packet data over
+            //
+            $new_packet->copy($packet);
+
+            //
+            // remove the SIG object from the additional list
+            //
+            array_pop($new_packet->additional);
+            $new_packet->header->arcount = count($new_packet->additional);
+
+            //
+            // copy out the data
+            //
+            $sigdata = $data . $new_packet->get();
+
+            //
+            // based on the algorithm
+            //
+            $algorithm = 0;
+
+            switch($this->algorithm) {
+
+            //
+            // MD5
+            //
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSAMD5:
+
+                $algorithm = OPENSSL_ALGO_MD5;
+                break;
+
+            //
+            // SHA1
+            //
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSASHA1:
+
+                $algorithm = OPENSSL_ALGO_SHA1;
+                break;
+
+            //
+            // SHA256 (PHP 5.4.8 or higher)
+            //
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSASHA256:
+
+                if (version_compare(PHP_VERSION, '5.4.8', '<') == true) {
+
+                    throw new Net_DNS2_Exception(
+                        'SHA256 support is only available in PHP >= 5.4.8',
+                        Net_DNS2_Lookups::E_OPENSSL_INV_ALGO
+                    );
+                }
+
+                $algorithm = OPENSSL_ALGO_SHA256;
+                break;
+
+            //
+            // SHA512 (PHP 5.4.8 or higher)
+            //
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSASHA512:
+
+                if (version_compare(PHP_VERSION, '5.4.8', '<') == true) {
+
+                    throw new Net_DNS2_Exception(
+                        'SHA512 support is only available in PHP >= 5.4.8',
+                        Net_DNS2_Lookups::E_OPENSSL_INV_ALGO
+                    );
+                }
+
+                $algorithm = OPENSSL_ALGO_SHA512;
+                break;
+        
+            //
+            // unsupported at the moment
+            //
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_DSA:
+            case Net_DNS2_Lookups::DSNSEC_ALGORITHM_RSASHA1NSEC3SHA1:
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_DSANSEC3SHA1:            
+            default:
+                throw new Net_DNS2_Exception(
+                    'invalid or unsupported algorithm',
+                    Net_DNS2_Lookups::E_OPENSSL_INV_ALGO
+                );
+                break;
+            }
+
+            //
+            // sign the data
+            //
+            if (openssl_sign($sigdata, $this->signature, $this->private_key->instance, $algorithm) == false) {
+
+                throw new Net_DNS2_Exception(
+                    openssl_error_string(), 
+                    Net_DNS2_Lookups::E_OPENSSL_ERROR
+                );
+            }
+
+            //
+            // build the signature value based
+            //
+            switch($this->algorithm) {
+
+            //
+            // RSA- add it directly
+            //
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSAMD5:
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSASHA1:
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSASHA256:
+            case Net_DNS2_Lookups::DNSSEC_ALGORITHM_RSASHA512:
+
+                $this->signature = base64_encode($this->signature);
+                break;
+            }
+        }
+
+        //
+        // add the signature
+        //
+        $data .= base64_decode($this->signature);
+
+        $packet->offset += strlen($data);
+
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/SMIMEA.php

@@ -0,0 +1,75 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2016, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2016 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.4.2
+ *
+ */
+
+/**
+ * The SMIMEA RR is implemented exactly like the TLSA record, so
+ * for now we just extend the TLSA RR and use it.
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_SMIMEA extends Net_DNS2_RR_TLSA
+{
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/SOA.php

@@ -0,0 +1,240 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * SOA Resource Record - RFC1035 section 3.3.13
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                     MNAME                     /
+ *    /                                               /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                     RNAME                     /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    SERIAL                     |
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    REFRESH                    |
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                     RETRY                     |
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    EXPIRE                     |
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    MINIMUM                    |
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_SOA extends Net_DNS2_RR
+{
+    /*
+     * The master DNS server
+     */
+    public $mname;
+
+    /*
+     * mailbox of the responsible person
+     */
+    public $rname;
+
+    /*
+     * serial number
+      */
+    public $serial;
+
+    /*
+      * refresh time
+      */
+    public $refresh;
+
+    /*
+      * retry interval
+     */
+    public $retry;
+
+    /*
+     * expire time
+      */
+    public $expire;
+
+    /*
+     * minimum TTL for any RR in this zone
+      */
+    public $minimum;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->cleanString($this->mname) . '. ' . 
+            $this->cleanString($this->rname) . '. ' . 
+            $this->serial . ' ' . $this->refresh . ' ' . $this->retry . ' ' . 
+            $this->expire . ' ' . $this->minimum;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->mname    = $this->cleanString($rdata[0]);
+        $this->rname    = $this->cleanString($rdata[1]);
+
+        $this->serial   = $rdata[2];
+        $this->refresh  = $rdata[3];
+        $this->retry    = $rdata[4];
+        $this->expire   = $rdata[5];
+        $this->minimum  = $rdata[6];
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // parse the 
+            //
+            $offset = $packet->offset;
+
+            $this->mname = Net_DNS2_Packet::expand($packet, $offset);
+            $this->rname = Net_DNS2_Packet::expand($packet, $offset);
+
+            //
+            // get the SOA values
+            //
+            $x = unpack(
+                '@' . $offset . '/Nserial/Nrefresh/Nretry/Nexpire/Nminimum/', 
+                $packet->rdata
+            );
+
+            $this->serial   = Net_DNS2::expandUint32($x['serial']);
+            $this->refresh  = Net_DNS2::expandUint32($x['refresh']);
+            $this->retry    = Net_DNS2::expandUint32($x['retry']);
+            $this->expire   = Net_DNS2::expandUint32($x['expire']);
+            $this->minimum  = Net_DNS2::expandUint32($x['minimum']);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->mname) > 0) {
+    
+            $data = $packet->compress($this->mname, $packet->offset);
+            $data .= $packet->compress($this->rname, $packet->offset);
+
+            $data .= pack(
+                'N5', $this->serial, $this->refresh, $this->retry, 
+                $this->expire, $this->minimum
+            );
+
+            $packet->offset += 20;
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/SPF.php

@@ -0,0 +1,75 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * The SPF RR is implemented exactly like the TXT record, so
+ * for now we just extend the TXT RR and use it.
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_SPF extends Net_DNS2_RR_TXT
+{
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/SRV.php

@@ -0,0 +1,186 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates.
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors
+ *     may be used to endorse or promote products derived from this
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * SRV Resource Record - RFC2782
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                   PRIORITY                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    WEIGHT                     |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                     PORT                      |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                    TARGET                     /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_SRV extends Net_DNS2_RR
+{
+    /*
+     * The priority of this target host.
+     */
+    public $priority;
+
+    /*
+     * a relative weight for entries with the same priority
+     */
+    public $weight;
+
+    /*
+      * The port on this target host of this service.
+     */
+    public $port;
+
+    /*
+      * The domain name of the target host
+     */
+    public $target;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->priority . ' ' . $this->weight . ' ' . 
+            $this->port . ' ' . $this->cleanString($this->target) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->priority = $rdata[0];
+        $this->weight   = $rdata[1];
+        $this->port     = $rdata[2];
+
+        $this->target   = $this->cleanString($rdata[3]);
+        
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+            
+            //
+            // unpack the priority, weight and port
+            //
+            $x = unpack('npriority/nweight/nport', $this->rdata);
+
+            $this->priority = $x['priority'];
+            $this->weight   = $x['weight'];
+            $this->port     = $x['port'];
+
+            $offset         = $packet->offset + 6;
+            $this->target   = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+        
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->target) > 0) {
+
+            $data = pack('nnn', $this->priority, $this->weight, $this->port);
+            $packet->offset += 6;
+
+            $data .= $packet->compress($this->target, $packet->offset);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+?>

bundled-libs/Net/DNS2/RR/SSHFP.php

@@ -0,0 +1,250 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * SSHFP Resource Record - RFC4255 section 3.1
+ *
+ *       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *      |   algorithm   |    fp type    |                               /
+ *      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               /
+ *      /                                                               /
+ *      /                          fingerprint                          /
+ *      /                                                               /
+ *      +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_SSHFP extends Net_DNS2_RR
+{
+    /*
+     * the algorithm used
+     */
+    public $algorithm;
+
+    /*
+     * The finger print type
+     */
+    public $fp_type;
+
+    /*
+     * the finger print data
+     */
+    public $fingerprint;
+
+    /*
+     * Algorithms
+     */
+    const SSHFP_ALGORITHM_RES   = 0;
+    const SSHFP_ALGORITHM_RSA   = 1;
+    const SSHFP_ALGORITHM_DSS   = 2;
+    const SSHFP_ALGORITHM_ECDSA = 3;
+
+    /*
+     * Fingerprint Types
+     */
+    const SSHFP_FPTYPE_RES      = 0;
+    const SSHFP_FPTYPE_SHA1     = 1;
+    const SSHFP_FPTYPE_SHA256   = 2;
+
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->algorithm . ' ' . $this->fp_type . ' ' . $this->fingerprint;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        //
+        // "The use of mnemonics instead of numbers is not allowed."
+        // 
+        // RFC4255 section 3.2
+        //
+        $algorithm      = array_shift($rdata);
+        $fp_type        = array_shift($rdata);
+        $fingerprint    = strtolower(implode('', $rdata));
+
+        //
+        // There are only two algorithm's defined 
+        //
+        if ( ($algorithm != self::SSHFP_ALGORITHM_RSA) 
+            && ($algorithm != self::SSHFP_ALGORITHM_DSS) 
+            && ($algorithm != self::SSHFP_ALGORITHM_ECDSA) 
+        ) {
+            return false;
+        }
+
+        //
+        // there are only two fingerprints defined
+        //
+        if ( ($fp_type != self::SSHFP_FPTYPE_SHA1)
+            && ($fp_type != self::SSHFP_FPTYPE_SHA256) 
+        ) {
+            return false;
+        }
+
+        $this->algorithm    = $algorithm;
+        $this->fp_type      = $fp_type;
+        $this->fingerprint  = $fingerprint;
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the algorithm and finger print type
+            //
+            $x = unpack('Calgorithm/Cfp_type', $this->rdata);
+
+            $this->algorithm    = $x['algorithm'];
+            $this->fp_type      = $x['fp_type'];
+
+            //
+            // There are only three algorithm's defined 
+            //
+            if ( ($this->algorithm != self::SSHFP_ALGORITHM_RSA) 
+                && ($this->algorithm != self::SSHFP_ALGORITHM_DSS)
+                && ($this->algorithm != self::SSHFP_ALGORITHM_ECDSA)
+            ) {
+                return false;
+            }
+
+            //
+            // there are only two fingerprints defined
+            //
+            if ( ($this->fp_type != self::SSHFP_FPTYPE_SHA1)
+                && ($this->fp_type != self::SSHFP_FPTYPE_SHA256)
+            ) {
+                return false;
+            }
+            
+            //
+            // parse the finger print; this assumes SHA-1
+            //
+            $fp = unpack('H*a', substr($this->rdata, 2));
+            $this->fingerprint = strtolower($fp['a']);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->fingerprint) > 0) {
+
+            $data = pack(
+                'CCH*', $this->algorithm, $this->fp_type, $this->fingerprint
+            );
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/TA.php

@@ -0,0 +1,75 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2011, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2011 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.2.0
+ *
+ */
+
+/**
+ * The TA RR is implemented exactly like the DS record, so
+ * for now we just extend the DS RR and use it.
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_TA extends Net_DNS2_RR_DS
+{
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/TALINK.php

@@ -0,0 +1,171 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2011, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2011 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.2.0
+ *
+ */
+
+/**
+ * TALINK Resource Record - DNSSEC Trust Anchor
+ *
+ * http://tools.ietf.org/id/draft-ietf-dnsop-dnssec-trust-history-00.txt
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   PREVIOUS                    /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                     NEXT                      /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_TALINK extends Net_DNS2_RR
+{
+    /*
+     * the previous domain name
+     */
+    public $previous;
+
+    /*
+     * the next domain name
+     */
+    public $next;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->cleanString($this->previous) . '. ' . 
+            $this->cleanString($this->next) . '.';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->previous = $this->cleanString($rdata[0]);
+        $this->next     = $this->cleanString($rdata[1]);
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            $offset         = $packet->offset;
+
+            $this->previous = Net_DNS2_Packet::label($packet, $offset);
+            $this->next     = Net_DNS2_Packet::label($packet, $offset);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if ( (strlen($this->previous) > 0) || (strlen($this->next) > 0) ) {
+
+            $data = chr(strlen($this->previous)) . $this->previous . 
+                chr(strlen($this->next)) . $this->next;
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/TKEY.php

@@ -0,0 +1,307 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * TKEY Resource Record - RFC 2930 section 2
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   ALGORITHM                   / 
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                   INCEPTION                   |
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                   EXPIRATION                  |
+ *    |                                               |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                   MODE                        |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                   ERROR                       |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                   KEY SIZE                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   KEY DATA                    /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                   OTHER SIZE                  |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   OTHER DATA                  /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_TKEY extends Net_DNS2_RR
+{
+    public $algorithm;
+    public $inception;
+    public $expiration;
+    public $mode;
+    public $error;
+    public $key_size;
+    public $key_data;
+    public $other_size;
+    public $other_data;
+
+    /*
+     * TSIG Modes
+     */
+    const TSIG_MODE_RES           = 0;
+    const TSIG_MODE_SERV_ASSIGN   = 1;
+    const TSIG_MODE_DH            = 2;
+    const TSIG_MODE_GSS_API       = 3;
+    const TSIG_MODE_RESV_ASSIGN   = 4;
+    const TSIG_MODE_KEY_DELE      = 5;
+
+    /*
+     * map the mod id's to names so we can validate
+     */
+    public $tsgi_mode_id_to_name = array(
+
+        self::TSIG_MODE_RES           => 'Reserved',
+        self::TSIG_MODE_SERV_ASSIGN   => 'Server Assignment',
+        self::TSIG_MODE_DH            => 'Diffie-Hellman',
+        self::TSIG_MODE_GSS_API       => 'GSS-API',
+        self::TSIG_MODE_RESV_ASSIGN   => 'Resolver Assignment',
+        self::TSIG_MODE_KEY_DELE      => 'Key Deletion'
+    );
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $out = $this->cleanString($this->algorithm) . '. ' . $this->mode;
+        if ($this->key_size > 0) {
+
+            $out .= ' ' . trim($this->key_data, '.') . '.';
+        } else {
+
+            $out .= ' .';
+        }
+
+        return $out;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        //
+        // data passed in is assumed: <algorithm> <mode> <key>
+        //
+        $this->algorithm    = $this->cleanString(array_shift($rdata));
+        $this->mode         = array_shift($rdata);
+        $this->key_data     = trim(array_shift($rdata), '.');
+
+        //
+        // the rest of the data is set manually
+        //
+        $this->inception    = time();
+        $this->expiration   = time() + 86400; // 1 day
+        $this->error        = 0;
+        $this->key_size     = strlen($this->key_data);
+        $this->other_size   = 0;
+        $this->other_data   = '';
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+        
+            //
+            // expand the algorithm
+            //
+            $offset = $packet->offset;
+            $this->algorithm = Net_DNS2_Packet::expand($packet, $offset);
+            
+            //
+            // unpack inception, expiration, mode, error and key size
+            //
+            $x = unpack(
+                '@' . $offset . '/Ninception/Nexpiration/nmode/nerror/nkey_size', 
+                $packet->rdata
+            );
+
+            $this->inception    = Net_DNS2::expandUint32($x['inception']);
+            $this->expiration   = Net_DNS2::expandUint32($x['expiration']);
+            $this->mode         = $x['mode'];
+            $this->error        = $x['error'];
+            $this->key_size     = $x['key_size'];
+
+            $offset += 14;
+
+            //
+            // if key_size > 0, then copy out the key
+            //
+            if ($this->key_size > 0) {
+
+                $this->key_data = substr($packet->rdata, $offset, $this->key_size);
+                $offset += $this->key_size;
+            }
+
+            //
+            // unpack the other length
+            //
+            $x = unpack('@' . $offset . '/nother_size', $packet->rdata);
+            
+            $this->other_size = $x['other_size'];
+            $offset += 2;
+
+            //
+            // if other_size > 0, then copy out the data
+            //
+            if ($this->other_size > 0) {
+
+                $this->other_data = substr(
+                    $packet->rdata, $offset, $this->other_size
+                );
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->algorithm) > 0) {
+
+            //
+            // make sure the size values are correct
+            //
+            $this->key_size     = strlen($this->key_data);
+            $this->other_size   = strlen($this->other_data);
+
+            //
+            // add the algorithm without compression
+            //
+            $data = Net_DNS2_Packet::pack($this->algorithm);
+
+            //
+            // pack in the inception, expiration, mode, error and key size
+            //
+            $data .= pack(
+                'NNnnn', $this->inception, $this->expiration, 
+                $this->mode, 0, $this->key_size
+            );
+
+            //
+            // if the key_size > 0, then add the key
+            //
+            if ($this->key_size > 0) {
+            
+                $data .= $this->key_data;
+            }
+
+            //
+            // pack in the other size
+            //
+            $data .= pack('n', $this->other_size);
+            if ($this->other_size > 0) {
+
+                $data .= $this->other_data;
+            }
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/TLSA.php

@@ -0,0 +1,194 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2012, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2012 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.2.5
+ *
+ */
+
+/**
+ * TLSA Resource Record - RFC 6698
+ *
+ *   0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *  |  Cert. Usage  |   Selector    | Matching Type |               /
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+               /
+ *  /                                                               /
+ *  /                 Certificate Association Data                  /
+ *  /                                                               /
+ *  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ * 
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_TLSA extends Net_DNS2_RR
+{
+    /*
+     * The Certificate Usage Field
+     */
+    public $cert_usage;
+
+    /*
+     * The Selector Field
+     */
+    public $selector;
+
+    /*
+     * The Matching Type Field
+     */
+    public $matching_type;
+
+    /*
+     * The Certificate Association Data Field
+     */
+    public $certificate;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        return $this->cert_usage . ' ' . $this->selector . ' ' . 
+            $this->matching_type . ' ' . base64_encode($this->certificate);
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->cert_usage       = array_shift($rdata);
+        $this->selector         = array_shift($rdata);
+        $this->matching_type    = array_shift($rdata);
+        $this->certificate      = base64_decode(implode('', $rdata));
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // unpack the format, keytag and algorithm
+            //
+            $x = unpack('Cusage/Cselector/Ctype', $this->rdata);
+
+            $this->cert_usage       = $x['usage'];
+            $this->selector         = $x['selector'];
+            $this->matching_type    = $x['type'];
+
+            //
+            // copy the certificate
+            //
+            $this->certificate  = substr($this->rdata, 3, $this->rdlength - 3);
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->certificate) > 0) {
+
+            $data = pack(
+                'CCC', $this->cert_usage, $this->selector, $this->matching_type
+            ) . $this->certificate;
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/TSIG.php

@@ -0,0 +1,504 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * TSIG Resource Record - RFC 2845
+ *
+ *      0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7 0 1 2 3 4 5 6 7
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *     /                          algorithm                            /
+ *     /                                                               /
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *     |                          time signed                          |
+ *     |                               +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *     |                               |              fudge            |
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *     |            mac size           |                               /
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               /
+ *     /                              mac                              /
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *     |           original id         |              error            |
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *     |          other length         |                               /
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               /
+ *     /                          other data                           /
+ *     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_TSIG extends Net_DNS2_RR
+{
+    /*
+     * TSIG Algorithm Identifiers
+     */
+    const HMAC_MD5      = 'hmac-md5.sig-alg.reg.int';   // RFC 2845, required
+    const GSS_TSIG      = 'gss-tsig';                   // unsupported, optional
+    const HMAC_SHA1     = 'hmac-sha1';                  // RFC 4635, required
+    const HMAC_SHA224   = 'hmac-sha224';                // RFC 4635, optional
+    const HMAC_SHA256   = 'hmac-sha256';                // RFC 4635, required
+    const HMAC_SHA384   = 'hmac-sha384';                // RFC 4635, optional
+    const HMAC_SHA512   = 'hmac-sha512';                // RFC 4635, optional
+
+    /*
+     * the map of hash values to names
+     */
+    public static $hash_algorithms = array(
+
+        self::HMAC_MD5      => 'md5',
+        self::HMAC_SHA1     => 'sha1',
+        self::HMAC_SHA224   => 'sha224',
+        self::HMAC_SHA256   => 'sha256',
+        self::HMAC_SHA384   => 'sha384',
+        self::HMAC_SHA512   => 'sha512'
+    );
+
+    /*
+     * algorithm used; only supports HMAC-MD5
+     */
+    public $algorithm;
+
+    /*
+     * The time it was signed
+     */
+    public $time_signed;
+
+    /*
+     * fudge- allowed offset from the time signed
+     */
+    public $fudge;
+
+    /*
+     * size of the digest
+     */
+    public $mac_size;
+
+    /*
+     * the digest data
+     */
+    public $mac;
+
+    /*
+     * the original id of the request
+     */
+    public $original_id;
+
+    /*
+     * additional error code
+     */
+    public $error;
+
+    /*
+     * length of the "other" data, should only ever be 0 when there is
+     * no error, or 6 when there is the error RCODE_BADTIME
+     */
+    public $other_length;
+
+    /*
+     * the other data; should only ever be a timestamp when there is the
+     * error RCODE_BADTIME
+     */
+    public $other_data;
+
+    /*
+     * the key to use for signing - passed in, not included in the rdata
+     */
+    public $key;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        $out = $this->cleanString($this->algorithm) . '. ' . 
+            $this->time_signed . ' ' . 
+            $this->fudge . ' ' . $this->mac_size . ' ' .
+            base64_encode($this->mac) . ' ' . $this->original_id . ' ' . 
+            $this->error . ' '. $this->other_length;
+
+        if ($this->other_length > 0) {
+
+            $out .= ' ' . $this->other_data;
+        }
+
+        return $out;
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        //
+        // the only value passed in is the key-
+        //
+        // this assumes it's passed in base64 encoded.
+        //
+        $this->key = preg_replace('/\s+/', '', array_shift($rdata));
+
+        //
+        // the rest of the data is set to default
+        //
+        $this->algorithm    = self::HMAC_MD5;
+        $this->time_signed  = time();
+        $this->fudge        = 300;
+        $this->mac_size     = 0;
+        $this->mac          = '';
+        $this->original_id  = 0;
+        $this->error        = 0;
+        $this->other_length = 0;
+        $this->other_data   = '';
+
+        //
+        // per RFC 2845 section 2.3
+        //
+        $this->class        = 'ANY';
+        $this->ttl          = 0;
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+
+            //
+            // expand the algorithm
+            //
+            $newoffset          = $packet->offset;
+            $this->algorithm    = Net_DNS2_Packet::expand($packet, $newoffset);
+            $offset             = $newoffset - $packet->offset;
+
+            //
+            // unpack time, fudge and mac_size
+            //
+            $x = unpack(
+                '@' . $offset . '/ntime_high/Ntime_low/nfudge/nmac_size', 
+                $this->rdata
+            );
+
+            $this->time_signed  = Net_DNS2::expandUint32($x['time_low']);
+            $this->fudge        = $x['fudge'];
+            $this->mac_size     = $x['mac_size'];
+
+            $offset += 10;
+
+            //
+            // copy out the mac
+            //
+            if ($this->mac_size > 0) {
+            
+                $this->mac = substr($this->rdata, $offset, $this->mac_size);
+                $offset += $this->mac_size;
+            }
+
+            //
+            // unpack the original id, error, and other_length values
+            //
+            $x = unpack(
+                '@' . $offset . '/noriginal_id/nerror/nother_length', 
+                $this->rdata
+            );
+        
+            $this->original_id  = $x['original_id'];
+            $this->error        = $x['error'];
+            $this->other_length = $x['other_length'];
+
+            //
+            // the only time there is actually any "other data", is when there's
+            // a BADTIME error code.
+            //
+            // The other length should be 6, and the other data field includes the
+            // servers current time - per RFC 2845 section 4.5.2
+            //
+            if ($this->error == Net_DNS2_Lookups::RCODE_BADTIME) {
+
+                if ($this->other_length != 6) {
+
+                    return false;
+                }
+
+                //
+                // other data is a 48bit timestamp
+                //
+                $x = unpack(
+                    'nhigh/nlow', 
+                    substr($this->rdata, $offset + 6, $this->other_length)
+                );
+                $this->other_data = $x['low'];
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->key) > 0) {
+
+            //
+            // create a new packet for the signature-
+            //
+            $new_packet = new Net_DNS2_Packet_Request('example.com', 'SOA', 'IN');
+
+            //
+            // copy the packet data over
+            //
+            $new_packet->copy($packet);
+
+            //
+            // remove the TSIG object from the additional list
+            //
+            array_pop($new_packet->additional);
+            $new_packet->header->arcount = count($new_packet->additional);
+
+            //
+            // copy out the data
+            //
+            $sig_data = $new_packet->get();
+
+            //
+            // add the name without compressing
+            //
+            $sig_data .= Net_DNS2_Packet::pack($this->name);
+
+            //
+            // add the class and TTL
+            //
+            $sig_data .= pack(
+                'nN', Net_DNS2_Lookups::$classes_by_name[$this->class], $this->ttl
+            );
+
+            //
+            // add the algorithm name without compression
+            //
+            $sig_data .= Net_DNS2_Packet::pack(strtolower($this->algorithm));
+
+            //
+            // add the rest of the values
+            //
+            $sig_data .= pack(
+                'nNnnn', 0, $this->time_signed, $this->fudge, 
+                $this->error, $this->other_length
+            );
+            if ($this->other_length > 0) {
+
+                $sig_data .= pack('nN', 0, $this->other_data);
+            }
+
+            //
+            // sign the data
+            //
+            $this->mac = $this->_signHMAC(
+                $sig_data, base64_decode($this->key), $this->algorithm
+            );
+            $this->mac_size = strlen($this->mac);
+
+            //
+            // compress the algorithm
+            //
+            $data = Net_DNS2_Packet::pack(strtolower($this->algorithm));
+
+            //
+            // pack the time, fudge and mac size
+            //
+            $data .= pack(
+                'nNnn', 0, $this->time_signed, $this->fudge, $this->mac_size
+            );
+            $data .= $this->mac;
+
+            //
+            // check the error and other_length
+            //
+            if ($this->error == Net_DNS2_Lookups::RCODE_BADTIME) {
+
+                $this->other_length = strlen($this->other_data);
+                if ($this->other_length != 6) {
+
+                    return null;
+                }
+            } else {
+
+                $this->other_length = 0;
+                $this->other_data = '';
+            }
+
+            //
+            // pack the id, error and other_length
+            //
+            $data .= pack(
+                'nnn', $packet->header->id, $this->error, $this->other_length
+            );
+            if ($this->other_length > 0) {
+
+                $data .= pack('nN', 0, $this->other_data);
+            }
+
+            $packet->offset += strlen($data);
+
+            return $data;
+        }
+
+        return null;
+    }
+
+    /**
+     * signs the given data with the given key, and returns the result
+     *
+     * @param string $data      the data to sign
+     * @param string $key       key to use for signing
+     * @param string $algorithm the algorithm to use; defaults to MD5
+     *
+     * @return string the signed digest
+     * @throws Net_DNS2_Exception
+     * @access private
+     *
+     */
+    private function _signHMAC($data, $key = null, $algorithm = self::HMAC_MD5)
+    {
+        //
+        // use the hash extension; this is included by default in >= 5.1.2 which
+        // is our dependent version anyway- so it's easy to switch to it.
+        //
+        if (extension_loaded('hash')) {
+
+            if (!isset(self::$hash_algorithms[$algorithm])) {
+
+                throw new Net_DNS2_Exception(
+                    'invalid or unsupported algorithm',
+                    Net_DNS2_Lookups::E_PARSE_ERROR
+                );
+            }
+
+            return hash_hmac(self::$hash_algorithms[$algorithm], $data, $key, true);
+        }
+
+        //
+        // if the hash extension isn't loaded, and they selected something other
+        // than MD5, throw an exception
+        //
+        if ($algorithm != self::HMAC_MD5) {
+
+            throw new Net_DNS2_Exception(
+                'only HMAC-MD5 supported. please install the php-extension ' .
+                '"hash" in order to use the sha-family',
+                Net_DNS2_Lookups::E_PARSE_ERROR
+            );
+        }
+
+        //
+        // otherwise, do it ourselves
+        //
+        if (is_null($key)) {
+
+            return pack('H*', md5($data));
+        }
+
+        $key = str_pad($key, 64, chr(0x00));
+        if (strlen($key) > 64) {
+    
+            $key = pack('H*', md5($key));
+        }
+
+        $k_ipad = $key ^ str_repeat(chr(0x36), 64);
+        $k_opad = $key ^ str_repeat(chr(0x5c), 64);
+
+        return $this->_signHMAC(
+            $k_opad . pack('H*', md5($k_ipad . $data)), null, $algorithm
+        );
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/TXT.php

@@ -0,0 +1,177 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates. 
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2010, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors 
+ *     may be used to endorse or promote products derived from this 
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2010 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 0.6.0
+ *
+ */
+
+/**
+ * TXT Resource Record - RFC1035 section 3.3.14
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                   TXT-DATA                    /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_TXT extends Net_DNS2_RR
+{
+    /*
+     * an array of the text strings
+     */
+    public $text = array();
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        if (count($this->text) == 0) {
+            return '""';
+        }
+
+        $data = '';
+
+        foreach ($this->text as $t) {
+
+            $data .= $this->formatString($t) . ' ';
+        }
+
+        return trim($data);
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $data = $this->buildString($rdata);
+        if (count($data) > 0) {
+
+            $this->text = $data;
+        }
+
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+            
+            $length = $packet->offset + $this->rdlength;
+            $offset = $packet->offset;
+
+            while ($length > $offset) {
+
+                $this->text[] = Net_DNS2_Packet::label($packet, $offset);
+            }
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        $data = null;
+
+        foreach ($this->text as $t) {
+
+            $data .= chr(strlen($t)) . $t;
+        }
+
+        $packet->offset += strlen($data);
+
+        return $data;
+    }
+}
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * c-hanging-comment-ender-p: nil
+ * End:
+ */
+?>

bundled-libs/Net/DNS2/RR/URI.php

@@ -0,0 +1,183 @@
+<?php
+/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
+
+/**
+ * DNS Library for handling lookups and updates.
+ *
+ * PHP Version 5
+ *
+ * Copyright (c) 2011, Mike Pultz <mike@mikepultz.com>.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ *   * Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *   * 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.
+ *
+ *   * Neither the name of Mike Pultz nor the names of his contributors
+ *     may be used to endorse or promote products derived from this
+ *     software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "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
+ * COPYRIGHT OWNER OR CONTRIBUTORS 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, STRIC
+ * 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.
+ *
+ * @category  Networking
+ * @package   Net_DNS2
+ * @author    Mike Pultz <mike@mikepultz.com>
+ * @copyright 2011 Mike Pultz <mike@mikepultz.com>
+ * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @version   SVN: $Id$
+ * @link      http://pear.php.net/package/Net_DNS2
+ * @since     File available since Release 1.2.0
+ *
+ */
+
+/**
+ * URI Resource Record - http://tools.ietf.org/html/draft-faltstrom-uri-06
+ *
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                   PRIORITY                    |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    |                    WEIGHT                     |
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *    /                    TARGET                     /
+ *    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * @category Networking
+ * @package  Net_DNS2
+ * @author   Mike Pultz <mike@mikepultz.com>
+ * @license  http://www.opensource.org/licenses/bsd-license.php  BSD License
+ * @link     http://pear.php.net/package/Net_DNS2
+ * @see      Net_DNS2_RR
+ *
+ */
+class Net_DNS2_RR_URI extends Net_DNS2_RR
+{
+    /*
+     * The priority of this target host.
+     */
+    public $priority;
+
+    /*
+     * a relative weight for entries with the same priority
+     */
+    public $weight;
+
+    /*
+      * The domain name of the target host
+     */
+    public $target;
+
+    /**
+     * method to return the rdata portion of the packet as a string
+     *
+     * @return  string
+     * @access  protected
+     *
+     */
+    protected function rrToString()
+    {
+        //
+        // presentation format has double quotes (") around the target.
+        //
+        return $this->priority . ' ' . $this->weight . ' "' . 
+            $this->cleanString($this->target) . '"';
+    }
+
+    /**
+     * parses the rdata portion from a standard DNS config line
+     *
+     * @param array $rdata a string split line of values for the rdata
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrFromString(array $rdata)
+    {
+        $this->priority = $rdata[0];
+        $this->weight   = $rdata[1];
+
+        //
+        // make sure to trim the lead/trailing double quote if it's there.
+        //
+        $this->target   = trim($this->cleanString($rdata[2]), '"');
+        
+        return true;
+    }
+
+    /**
+     * parses the rdata of the Net_DNS2_Packet object
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet to parse the RR from
+     *
+     * @return boolean
+     * @access protected
+     *
+     */
+    protected function rrSet(Net_DNS2_Packet &$packet)
+    {
+        if ($this->rdlength > 0) {
+            
+            //
+            // unpack the priority and weight
+            //
+            $x = unpack('npriority/nweight', $this->rdata);
+
+            $this->priority = $x['priority'];
+            $this->weight   = $x['weight'];
+
+            $offset         = $packet->offset + 4;
+            $this->target   = Net_DNS2_Packet::expand($packet, $offset);
+
+            return true;
+        }
+        
+        return false;
+    }
+
+    /**
+     * returns the rdata portion of the DNS packet
+     *
+     * @param Net_DNS2_Packet &$packet a Net_DNS2_Packet packet use for
+     *                                 compressed names
+     *
+     * @return mixed                   either returns a binary packed
+     *                                 string or null on failure
+     * @access protected
+     *
+     */
+    protected function rrGet(Net_DNS2_Packet &$packet)
+    {
+        if (strlen($this->target) > 0) {
+
+            $data = pack('nn', $this->priority, $this->weight);
+            $packet->offset += 4;
+
+            $data .= $packet->compress(trim($this->target, '"'), $packet->offset);
+
+            return $data;
+        }
+
+        return null;
+    }
+}
+
+?>