phpipam / phpipam

functions/classes/class.Log.php

Doc Comments +5 added lines, -5 removed lines

@@ -311,8 +311,8 @@ 
 	 * write log function
 	 *
 	 * @access public
-	 * @param mixed $command
-	 * @param mixed $details (default: NULL)
+	 * @param string $command
+	 * @param string $details (default: NULL)
 	 * @param int $severity (default: 0)
 	 * @param mixed $username (default: NULL)
 	 * @return void
@@ -452,7 +452,7 @@ 
 	 * Writes changelog to syslog
 	 *
 	 * @access private
-	 * @param mixed $changelog
+	 * @param string[] $changelog
 	 * @return void
 	 */
 	private function syslog_write_changelog ($changelog) {
@@ -691,8 +691,8 @@ 
 	 * Writes changelog to database
 	 *
 	 * @access private
-	 * @param mixed $changelog
-	 * @return void
+	 * @param string[] $changelog
+	 * @return boolean
 	 */
 	private function changelog_write_to_db ($changelog) {
 		# log to array

functions/classes/class.PowerDNS.php

Doc Comments +16 added lines, -16 removed lines

@@ -207,7 +207,7 @@ 
      * Sets default values for database connection and othern parameters
      *
      * @access private
-     * @return void
+     * @return string
      */
     private function db_set_db_settings () {
         // init
@@ -349,7 +349,7 @@ 
      * set_query_values function.
      *
      * @access public
-     * @param int|string $limit (default: 1000000)
+     * @param integer $limit (default: 1000000)
      * @param string $orderby (default: "id")
      * @param string $orderdir (default: "asc")
      */
@@ -584,7 +584,7 @@ 
      * Fetches domain details by name
      *
      * @access public
-     * @param mixed $name
+     * @param string $name
      * @return void
      */
     public function fetch_domain_by_name ($name) {
@@ -675,7 +675,7 @@ 
      *
      * @access public
      * @param mixed $domain_id
-     * @param mixed $type
+     * @param string $type
      * @return void
      */
     public function fetch_domain_records_by_type ($domain_id, $type) {
@@ -941,7 +941,7 @@ 
      * @access public
      * @param mixed $hostname
      * @param mixed $ip
-     * @return void
+     * @return boolean
      */
     public function pdns_remove_ip_and_hostname_records ($hostname, $ip) {
          // set query
@@ -984,7 +984,7 @@ 
      * @access private
      * @param int|string $domain_id
      * @param mixed $serial
-     * @return void
+     * @return false|null
      */
     private function update_soa_serial ($domain_id, $serial = false) {
         // fetch record
@@ -1014,7 +1014,7 @@ 
      * Updates all SOA serials if it changes from autoserial false to true
      *
      * @access public
-     * @param bool $autoserial (Default : No)
+     * @param string|boolean $autoserial (Default : No)
      * @return void
      */
     public function update_all_soa_serials ($autoserial = "No") {
@@ -1085,11 +1085,11 @@ 
      * @access public
      * @param mixed $domain_id
      * @param mixed $name (default: null)
-     * @param mixed $type
+     * @param string $type
      * @param mixed $content
      * @param mixed $ttl
      * @param mixed $prio (default: null)
-     * @param int|string $disabled (default: 0)
+     * @param integer $disabled (default: 0)
      * @return array
      */
     public function formulate_new_record ($domain_id, $name=null, $type, $content, $ttl, $prio=null, $disabled = 0) {
@@ -1281,7 +1281,7 @@ 
      *    - 2015032701
      *
      * @access private
-     * @return void
+     * @return string
      */
     private function set_default_change_date () {
         return date("Ymd")."00";
@@ -1313,7 +1313,7 @@ 
      * @param mixed $domain_id
      * @param mixed $old_name
      * @param mixed $name
-     * @return void
+     * @return boolean
      */
     public function update_all_records ($domain_id, $old_name, $name) {
         // execute
@@ -1367,7 +1367,7 @@ 
      *
      * @access public
      * @param mixed $ip
-     * @return void
+     * @return string
      */
     public function get_ptr_zone_name ($ip, $mask) {
         return $this->identify_address ($ip)=="IPv4" ? $this->get_ptr_zone_name_v4 ($ip, $mask) : $this->get_ptr_zone_name_v6 ($ip, $mask);
@@ -1378,7 +1378,7 @@ 
      *
      * @access public
      * @param mixed $ip
-     * @return void
+     * @return string
      */
     public function get_ptr_zone_name_v4 ($ip, $mask) {
         // check mask to see how many IP bits to remove
@@ -1397,7 +1397,7 @@ 
      *
      * @access public
      * @param mixed $ip
-     * @return void
+     * @return string
      */
     public function get_ptr_zone_name_v6 ($ip, $mask) {
         // PEAR for IPv6
@@ -1426,7 +1426,7 @@ 
      *
      * @access public
      * @param mixed $ip
-     * @return void
+     * @return string
      */
     public function get_ip_ptr_name ($ip) {
         // set zone prefix and reverse content
@@ -1482,7 +1482,7 @@ 
      * Checks if record exists by id
      *
      * @access private
-     * @param mixed $ptr_id (default: 0)
+     * @param integer $ptr_id (default: 0)
      * @return bool
      */
     public function record_id_exists ($ptr_id = 0) {

api/controllers/Common.php

Doc Comments +2 added lines, -2 removed lines

@@ -97,7 +97,7 @@ 
 	 * Initializes new Object.
 	 *
 	 * @access protected
-	 * @param mixed $Object_name		// object name
+	 * @param string $Object_name		// object name
 	 * @param mixed $Database	       // Database object
 	 */
 	protected function init_object ($Object_name, $Database) {
@@ -340,7 +340,7 @@ 
 	 * Defines links for controller
 	 *
 	 * @access private
-	 * @param mixed $controller
+	 * @param string $controller
 	 * @return void
 	 */
 	private function define_links ($controller) {

functions/classes/class.Admin.php

Doc Comments +4 added lines, -5 removed lines

@@ -185,7 +185,6 @@ 
 	 *
 	 * @param string $table
 	 * @param string $action
-	 * @param string $id
 	 * @param mixed $values
 	 * @return void
 	 */
@@ -207,7 +206,7 @@ 
 	 *		$values are all values that should be passed to create object
 	 *
 	 * @access private
-	 * @param mixed $table
+	 * @param string $table
 	 * @param mixed $values
 	 * @return boolean
 	 */
@@ -236,7 +235,7 @@ 
 	 *		id will be used to match field to update.
 	 *
 	 * @access private
-	 * @param mixed $table			//name of table to update
+	 * @param string $table			//name of table to update
 	 * @param array $values			//update variables
 	 * @return boolean
 	 */
@@ -265,7 +264,7 @@ 
 	 *		ids will be used to match fields to update.
 	 *
 	 * @access private
-	 * @param mixed $table			//name of table to update
+	 * @param string $table			//name of table to update
 	 * @param array $values			//update variables
 	 * @param string $ids
 	 * @return boolean
@@ -292,7 +291,7 @@ 
 	 * Delete object in table by specified object id
 	 *
 	 * @access private
-	 * @param mixed $table		//table to update
+	 * @param string $table		//table to update
 	 * @param string $field		//field selection (where $field = $id)
 	 * @param mixed $id			//field identifier
 	 * @return boolean

functions/classes/class.DNS.php

Doc Comments +2 added lines, -2 removed lines

@@ -70,8 +70,8 @@
 	 * Sets array of nameservers to use
 	 *
 	 * @access private
-	 * @param mixed $nsid (default: null)
-	 * @return void
+	 * @param integer $nsid (default: null)
+	 * @return false|null
 	 */
 	private function set_nameservers ($nsid = null) {
 		// null ?

functions/classes/class.Sections.php

Doc Comments +6 added lines, -6 removed lines

@@ -117,7 +117,7 @@ 
 	 *
 	 * @access private
 	 * @param mixed $values
-	 * @return void
+	 * @return boolean
 	 */
 	private function section_add ($values) {
 		# null empty values
@@ -149,7 +149,7 @@ 
 	 *
 	 * @access private
 	 * @param mixed $values
-	 * @return void
+	 * @return boolean
 	 */
 	private function section_edit ($values) {
 		# null empty values
@@ -188,7 +188,7 @@ 
 	 *
 	 * @access private
 	 * @param mixed $values
-	 * @return void
+	 * @return boolean
 	 */
 	private function section_delete ($values) {
 		# subnets class
@@ -230,7 +230,7 @@ 
 	 *
 	 * @access private
 	 * @param mixed $order
-	 * @return void
+	 * @return boolean
 	 */
 	private function section_reorder ($order) {
 		# update each section
@@ -327,7 +327,7 @@ 
 	 * Fetch subsections for specified sectionid
 	 *
 	 * @access public
-	 * @param mixed $sectionId
+	 * @param integer $sectionId
 	 * @return void
 	 */
 	public function fetch_subsections ($sectionId) {
@@ -584,7 +584,7 @@ 
 	 * @access private
 	 * @param mixed $sectionId
 	 * @param mixed $permissions
-	 * @return void
+	 * @return boolean
 	 */
 	private function delegate_section_permissions ($sectionId, $permissions) {
 		try { $this->Database->updateObject("subnets", array("permissions"=>$permissions, "sectionId"=>$sectionId), "sectionId"); }

functions/classes/class.Tools.php

Doc Comments +21 added lines, -21 removed lines

@@ -271,7 +271,6 @@ 
 	 * Search inside subnets if host address is provided!
 	 *
 	 * @access private
-	 * @param mixed $search_term
 	 * @param number $high
 	 * @param number $low
 	 * @return array
@@ -322,7 +321,7 @@ 
 	 * Search inside subnets if host address is provided! ipv6
 	 *
 	 * @access private
-	 * @param mixed $search_term
+	 * @param mixed $search_req
 	 * @param number $high
 	 * @param number $low
 	 * @return array
@@ -672,7 +671,7 @@ 
 	 * Fetches standard tables from SCHEMA.sql file
 	 *
 	 * @access private
-	 * @return void
+	 * @return string[]
 	 */
 	private function fetch_standard_tables () {
 		# get SCHEMA.SQL file
@@ -760,7 +759,7 @@ 
 	 * Verify that widget file exists
 	 *
 	 * @access public
-	 * @return void
+	 * @return boolean
 	 */
 	public function verify_widget ($file) {
 		return file_exists("app/dashboard/widgets/$file.php")==false ? false : true;
@@ -832,7 +831,7 @@ 
 	 * @access public
 	 * @param string $action (default: "new")
 	 * @param mixed $values
-	 * @return void
+	 * @return boolean
 	 */
 	public function ip_request_send_mail ($action="new", $values) {
 
@@ -923,7 +922,7 @@ 
 	 * Returns list of recipients to get new
 	 *
 	 * @access private
-	 * @return void
+	 * @return false|null
 	 */
 	private function ip_request_get_mail_recipients () {
 		// get all admins and check who to end mail to
@@ -1107,7 +1106,7 @@ 
 	 *	false = doesnt exist
 	 *
 	 * @access public
-	 * @param mixed $tablename
+	 * @param string $tablename
 	 * @param bool $quit
 	 * @return bool
 	 */
@@ -1128,6 +1127,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $fieldname
+	 * @param string $tablename
 	 * @return bool
 	 */
 	public function field_exists ($tablename, $fieldname) {
@@ -1160,7 +1160,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $table
-	 * @return void
+	 * @return false|string
 	 */
 	public function get_table_fix ($table) {
 		$res = fopen(dirname(__FILE__) . "/../../db/SCHEMA.sql", "r");
@@ -1181,7 +1181,7 @@ 
 	 * @access public
 	 * @param mixed $table
 	 * @param mixed $field
-	 * @return void
+	 * @return string|false
 	 */
 	public function get_field_fix ($table, $field) {
 		$res = fopen(dirname(__FILE__) . "/../../db/SCHEMA.sql", "r");
@@ -1214,7 +1214,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $table
-	 * @return void
+	 * @return boolean
 	 */
 	public function fix_table ($table) {
 		# first fetch fix query
@@ -1234,7 +1234,7 @@ 
 	 * @access public
 	 * @param mixed $table
 	 * @param mixed $field
-	 * @return void
+	 * @return boolean
 	 */
 	public function fix_field ($table, $field) {
 
@@ -1271,7 +1271,7 @@ 
 	 * Check for latest version
 	 *
 	 * @access public
-	 * @return void
+	 * @return string|false
 	 */
 	public function check_latest_phpipam_version () {
 		# fetch settings
@@ -1284,7 +1284,7 @@ 
 	 * Checks for latest phpipam version from phpipam webpage
 	 *
 	 * @access public
-	 * @return void
+	 * @return string|false
 	 */
 	public function check_latest_phpipam_version_phpipamnet () {
 		# fetch webpage
@@ -1434,7 +1434,7 @@ 
 	 * @access private
 	 * @param $network
 	 * @param $broadcast
-	 * @return void
+	 * @return string|false
 	 */
 	private function get_ipv4_address_type ($network, $broadcast) {
 		# get all possible classes
@@ -1537,7 +1537,7 @@ 
 	 * @access public
 	 * @param mixed $addresses
 	 * @param int $pflen (default: 128)
-	 * @return void
+	 * @return string
 	 */
 	public function reverse_IPv6 ($addresses, $pflen=128) {
 		# Initialize PEAR NET object
@@ -1562,7 +1562,7 @@ 
 	 *
 	 * @access private
 	 * @param CIDR $cidr
-	 * @return void
+	 * @return string|false
 	 */
 	private function get_ipv6_address_type ($cidr) {
 		# Initialize PEAR NET object
@@ -1579,7 +1579,7 @@ 
 	 * Defines all IPv6 address types
 	 *
 	 * @access private
-	 * @return array
+	 * @return string[]
 	 */
 	private function define_ipv6_address_types () {
         $all_types[10] = "NET_IPV6_NO_NETMASK";
@@ -1695,7 +1695,7 @@ 
 	 * @access private
 	 * @param object $subnet
 	 * @param array $custom_address_fields
-	 * @return void
+	 * @return string[]
 	 */
 	private function parse_import_file_xls ($subnet, $custom_address_fields) {
      	# get excel object
@@ -1916,7 +1916,7 @@ 
 	 * Sets valid actions
 	 *
 	 * @access private
-	 * @return void
+	 * @return string[]
 	 */
 	private function get_valid_actions () {
 		return array("add", "all-add", "edit", "all-edit", "delete", "truncate", "split", "resize", "move");
@@ -1941,7 +1941,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $code		//lang code
-	 * @return void
+	 * @return boolean
 	 */
 	public function verify_translation ($code) {
 		//verify that proper files exist
@@ -1953,7 +1953,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $code		//lang code
-	 * @return void
+	 * @return string
 	 */
 	public function get_translation_version ($code) {
 		//check for version

functions/classes/class.Addresses.php

Doc Comments +21 added lines, -21 removed lines

@@ -162,7 +162,7 @@ 
 	 *
 	 * @access public
 	 * @param int $state
-	 * @return mixed tag
+	 * @return string|null tag
 	 */
 	public function address_type_format_tag ($state) {
 		# fetch address states
@@ -516,7 +516,7 @@ 
 	 *
 	 * @access private
 	 * @param mixed $address
-	 * @return void
+	 * @return null|boolean
 	 */
 	private function threshold_check ($address) {
     	$address = (object) $address;
@@ -614,7 +614,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $subnetId
-	 * @return void
+	 * @return null|false
 	 */
 	public function remove_gateway ($subnetId) {
 		try { $this->Database->updateObject("ipaddresses", array("subnetId"=>$subnetId, "is_gateway"=>0), "subnetId"); }
@@ -671,7 +671,7 @@ 
 	 * @access public
 	 * @param int $ip1
 	 * @param int $ip2
-	 * @return void
+	 * @return string
 	 */
 	public function calculate_address_diff ($ip1, $ip2) {
 		return gmp_strval(gmp_sub($ip2, $ip1));
@@ -753,7 +753,7 @@ 
 	 * Modifes powerDNS PTR record
 	 *
 	 * @access public
-	 * @param mixed $action
+	 * @param string $action
 	 * @param mixed $address
 	 * @param bool $print_error (default: true)
 	 * @return void
@@ -858,9 +858,9 @@ 
 	 *
 	 * @access public
 	 * @param mixed $address
-	 * @param mixed $print_error (default: true)
+	 * @param boolean $print_error (default: true)
 	 * @param mixed $id (default: NULL)
-	 * @return void
+	 * @return boolean
 	 */
 	public function ptr_add ($address, $print_error = true, $id = null) {
 		// decode values
@@ -896,8 +896,8 @@ 
 	 *
 	 * @access public
 	 * @param mixed $address
-	 * @param mixed $print_error (default: true)
-	 * @return void
+	 * @param boolean $print_error (default: true)
+	 * @return false|null
 	 */
 	public function ptr_edit ($address, $print_error = true) {
 		// validate hostname
@@ -966,7 +966,7 @@ 
 	 * @access public
 	 * @param mixed $address_id
 	 * @param mixed $ptr_id
-	 * @return void
+	 * @return null|false
 	 */
 	public function ptr_link ($address_id, $ptr_id) {
 		# execute
@@ -982,7 +982,7 @@ 
 	 *
 	 * @access private
 	 * @param mixed $address_id
-	 * @return void
+	 * @return null|false
 	 */
 	private function ptr_unlink ($address_id) {
 		# execute
@@ -998,7 +998,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $subnet_id
-	 * @return void
+	 * @return boolean
 	 */
 	public function ptr_unlink_subnet_addresses ($subnet_id) {
 		try { $this->Database->runQuery("update `ipaddresses` set `PTR` = 0 where `subnetId` = ?;", array($subnet_id)); }
@@ -1014,7 +1014,7 @@ 
 	 * Checks if PTR record exists
 	 *
 	 * @access private
-	 * @param mixed $ptr_id (default: 0)
+	 * @param integer $ptr_id (default: 0)
 	 * @return void
 	 */
 	private function ptr_exists ($ptr_id = 0) {
@@ -1072,7 +1072,7 @@ 
 	 * @access public
 	 * @param array $address
 	 * @param int $subnetId
-	 * @return void
+	 * @return string|boolean
 	 */
 	public function import_address_from_csv ($address, $subnetId) {
 		# Subnets object
@@ -1146,8 +1146,8 @@ 
 	 *
 	 * @access public
 	 * @param int $subnetId
-	 * @param mixed $order
-	 * @param mixed $order_direction
+	 * @param string $order
+	 * @param string $order_direction
 	 * @return objects addresses
 	 */
 	public function fetch_subnet_addresses ($subnetId, $order=null, $order_direction=null) {
@@ -1428,7 +1428,7 @@ 
 	 *
 	 * @access public
 	 * @param int $address
-	 * @param mixed $subnet (CIDR)
+	 * @param string $subnet (CIDR)
 	 * @param bool $no_strict (default: false)
 	 * @param bool $die (default: false)
 	 * @return boolean
@@ -1501,7 +1501,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $address
-	 * @return void
+	 * @return boolean
 	 */
 	public function validate_address ($address) {
 		# Initialize PEAR NET object
@@ -1524,7 +1524,7 @@ 
 	 * Checks if address is subnet for IPv4 addresses
 	 *
 	 * @access public
-	 * @param mixed $address
+	 * @param integer $address
 	 * @param int $netmask
 	 * @return boolean
 	 */
@@ -1538,7 +1538,7 @@ 
 	 * Checks if address is broadcast for IPv4 addresses
 	 *
 	 * @access public
-	 * @param mixed $address
+	 * @param integer $address
 	 * @param int $netmask
 	 * @return boolean
 	 */
@@ -1815,7 +1815,7 @@ 
 	 * Present numbers in pow 10, only for IPv6
 	 *
 	 * @access public
-	 * @param mixed $number
+	 * @param string $number
 	 * @return void
 	 */
 	public function reformat_number ($number) {

functions/classes/class.Common.php

Doc Comments +28 added lines, -28 removed lines

@@ -121,8 +121,8 @@ 
 	 * Fetch all objects from specified table in database
 	 *
 	 * @access public
-	 * @param mixed $table
-	 * @param mixed $sortField (default:id)
+	 * @param string $table
+	 * @param string $sortField (default:id)
 	 * @param mixed bool (default:true)
 	 * @return void
 	 */
@@ -149,8 +149,8 @@ 
 	 * Fetches specified object specified table in database
 	 *
 	 * @access public
-	 * @param mixed $table
-	 * @param mixed $method (default: null)
+	 * @param string $table
+	 * @param string $method (default: null)
 	 * @param mixed $value
 	 * @return void
 	 */
@@ -199,8 +199,8 @@ 
 	 *	doesnt cache
 	 *
 	 * @access public
-	 * @param mixed $table
-	 * @param mixed $field
+	 * @param string $table
+	 * @param string $field
 	 * @param mixed $value
 	 * @param string $sortField (default: 'id')
 	 * @param bool $sortAsc (default: true)
@@ -231,7 +231,7 @@ 
 	 * Count objects in database.
 	 *
 	 * @access public
-	 * @param mixed $table
+	 * @param string $table
 	 * @param mixed $field
 	 * @param mixed $val (default: null)
 	 * @param bool $like (default: false)
@@ -317,7 +317,7 @@ 
      *
      * @access protected
      * @param mixed $table
-     * @return void
+     * @return boolean
      */
     protected function cache_check_exceptions ($table) {
         // define
@@ -331,7 +331,7 @@ 
      *
      * @access protected
      * @param mixed $table
-     * @return void
+     * @return string|false
      */
     protected function cache_check_add_ip ($table) {
         // define
@@ -345,7 +345,7 @@ 
      *
      * @access protected
      * @param mixed $table
-     * @return void
+     * @return string
      */
     protected function cache_set_identifier ($table) {
         // vlan and subnets have different identifiers
@@ -510,7 +510,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $address
-	 * @return mixed IP version
+	 * @return string IP version
 	 */
 	public function identify_address ($address) {
 	    # dotted representation
@@ -530,7 +530,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $address
-	 * @return void
+	 * @return string
 	 */
 	public function get_ip_version ($address) {
 		return $this->identify_address ($address);
@@ -542,7 +542,7 @@ 
 	 * @access public
 	 * @param mixed $logs
 	 * @param bool $changelog
-	 * @return void
+	 * @return string
 	 */
 	public function array_to_log ($logs, $changelog = false) {
 		$result = "";
@@ -574,7 +574,7 @@ 
 	 * @access public
 	 * @param mixed $sec
 	 * @param bool $padHours (default: false)
-	 * @return void
+	 * @return string
 	 */
 	public function sec2hms($sec, $padHours = false) {
 	    // holds formatted string
@@ -610,7 +610,7 @@ 
 	 * @access public
 	 * @param mixed $text
 	 * @param int $chars (default: 25)
-	 * @return void
+	 * @return string
 	 */
 	public function shorten_text($text, $chars = 25) {
 		//count input text size
@@ -633,12 +633,12 @@ 
 	 *
 	 * @access public
 	 * @param mixed $mac
-	 * @param string $format (default: 1)
+	 * @param integer $format (default: 1)
 	 *      1 : 00:66:23:33:55:66
 	 *      2 : 00-66-23-33-55-66
 	 *      3 : 0066.2333.5566
 	 *      4 : 006623335566
-	 * @return void
+	 * @return string
 	 */
 	public function reformat_mac_address ($mac, $format = 1) {
     	// strip al tags first
@@ -718,7 +718,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $email
-	 * @return void
+	 * @return boolean
 	 */
 	public function validate_email($email) {
 	    return preg_match("/([\w\-]+\@[\w\-]+\.[\w\-]+)/",$email) ? true : false;
@@ -730,7 +730,7 @@ 
 	 * @access public
 	 * @param mixed $hostname
 	 * @param bool $permit_root_domain
-	 * @return void
+	 * @return boolean
 	 */
 	public function validate_hostname($hostname, $permit_root_domain=true) {
     	// first validate hostname
@@ -756,7 +756,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $ip
-	 * @return void
+	 * @return boolean
 	 */
 	public function validate_ip ($ip) {
     	if(filter_var($ip, FILTER_VALIDATE_IP)===false) { return false; }
@@ -768,7 +768,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $mac
-	 * @return void
+	 * @return boolean
 	 */
 	public function validate_mac ($mac) {
     	// first put it to common format (1)
@@ -784,7 +784,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $ipv6
-	 * @return void
+	 * @return false|string
 	 */
 	public function ip2long6 ($ipv6) {
 		if($ipv6 == ".255.255.255") {
@@ -808,7 +808,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $ipv6long
-	 * @return void
+	 * @return string
 	 */
 	public function long2ip6($ipv6long) {
 	    $bin = gmp_strval(gmp_init($ipv6long,10),2);
@@ -840,7 +840,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $address
-	 * @return mixed decimal or dotted
+	 * @return string decimal or dotted
 	 */
 	public function identify_address_format ($address) {
 		return is_numeric($address) ? "decimal" : "dotted";
@@ -870,7 +870,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $address
-	 * @return mixed dotted format
+	 * @return string dotted format
 	 */
 	public function transform_to_dotted ($address) {
 	    if ($this->identify_address ($address) == "IPv4" ) 				{ return(long2ip($address)); }
@@ -882,7 +882,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $address
-	 * @return int IP address
+	 * @return string|false IP address
 	 */
 	public function transform_to_decimal ($address) {
 	    if ($this->identify_address ($address) == "IPv4" ) 				{ return( sprintf("%u", ip2long($address)) ); }
@@ -894,7 +894,7 @@ 
 	 *
 	 * @access public
 	 * @param mixed $error_int
-	 * @return void
+	 * @return string
 	 */
 	public function json_error_decode ($error_int) {
     	// init
@@ -917,7 +917,7 @@ 
 	 * @access public
 	 * @param bool $rackId (default: false)
 	 * @param bool $deviceId (default: false)
-	 * @return void
+	 * @return false|string
 	 */
 	public function create_rack_link ($rackId = false, $deviceId = false) {
     	if($rackId===false) {