pfSense

<?php

/*

	pfSense-utils.inc

	Utilities specific to pfSense

	part of pfSense (www.pfSense.com)

	Copyright (C) 2005 Scott Ullrich (sullrich@gmail.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:

	1. Redistributions of source code must retain the above copyright notice,

	   this list of conditions and the following disclaimer.

	2. Redistributions in binary form must reproduce the above copyright

	   notice, this list of conditions and the following disclaimer in the

	   documentation and/or other materials provided with the distribution.

	THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,

	INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY

	AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE

	AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,

	OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF

	SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS

	INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN

	CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

	ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

	POSSIBILITY OF SUCH DAMAGE.

*/

 * log_error: send string to syslog

}

 * return_dir_as_array($dir): returns $dir contents as an array

 */

function return_dir_as_array($dir) {

		if($file == ".") $canadd = 1;

		if($file == "..") $canadd = 1;

		if($canadd == 0)

		    array_push($dir_array, $file);

	    closedir($dh);

	}

    }

    return $dir_array;

}

 * enable_hardware_offloading() enables hardware features of nics if they are supported

 */

function enable_hardware_offloading($interface) {

    global $g;

    if($g['booting']) {

	$supported_ints = array('fxp');

	foreach($supported_ints as $int) {

	    if(stristr($interface,$int) != false) {

		mwexec("/sbin/ifconfig $interface link0");

	    }

 */

function return_filename_as_array($filename) {

    $file = array();

        $text = return_filename_as_string($filename);

        $text_split = split("\n", $text);

        /* Strip out comments */

        while (($line = array_shift($text_split)) != NULL) {

            if(strpos($line, "#") !== 0)

                array_push($file, $line);

        }

/*

 * return_dir_as_array($filename): returns $filename contents as a string

function return_filename_as_string($filename) {

    $tmp = "";

	log_error("Could not open {$filename}");

	return;

    }

	$tmp .= fread($fd,49);

    }

    fclose($fd);

    return $tmp;

}

 * is_carp_defined: returns true if carp is detected in kernel

 */

function is_carp_defined() {

    $command = "/sbin/sysctl -a | grep carp";

    $fd = popen($command . " 2>&1 ", "r");

    if(!$fd) {

	return 0;

    while(!feof($fd)) {

    fclose($fd);

 * find_number_of_created_carp_interfaces() returns the number of currently created carp interfaces

 */

function find_number_of_created_carp_interfaces() {

    $fd = popen($command . " 2>&1 ", "r");

    if(!$fd) {

	return 0;

    while(!feof($fd)) {

    fclose($fd);

    $tmp = intval($tmp);

    return $tmp;

 * link_ip_to_carp_interface($ip): finds where a carp interface links to.

*/

function link_ip_to_carp_interface($ip) {

    if($ip == "") return;

    $i = 0;

    for ($j = 1; isset($config['interfaces']['opt' . $j]); $j++) {

    $ft_ip = $ft[0] . "." . $ft[1] . "." . $ft[2] . ".";

    $carp_ints = "";

    $num_carp_ints = find_number_of_created_carp_interfaces();

    foreach ($ifdescrs as $ifdescr => $ifname) {

	    $carp_int = "carp{$x}";

	    $carp_ip = find_interface_ip($carp_int);

	    $carp_ft = split("\.", $carp_ip);

	    $carp_ft_ip = $carp_ft[0] . "." . $carp_ft[1] . "." . $carp_ft[2] . ".";

	    $result = does_interface_exist($carp_int);

	    if($result <> true) break;

	    $interface = filter_opt_interface_to_real($ifname);

	    if($ft_ip == $carp_ft_ip)

		if(stristr($carp_ints,$carp_int) == false)

		    $carp_ints .= " " . $carp_int;

	}

    return $carp_ints;

 * exec_command($command): execute command return string of result

 */

function exec_command($command) {

    $tmp = "";

    $fd = popen($command . " 2>&1 ", "r");

    while(!feof($fd)) {

    fclose($fd);

    return $tmp;

 * does_interface_exist($interface): return true or false if a interface is detected.

 */

function does_interface_exist($interface) {

    $ints = exec_command("/sbin/ifconfig -l");

    else

	return false;

}

 * convert_ip_to_network_format($ip, $subnet): converts an ip address to network form

 */

function convert_ip_to_network_format($ip, $subnet) {

    $ipsplit = split('[.]', $ip);

    $string = $ipsplit[0] . "." . $ipsplit[1] . "." . $ipsplit[2] . ".0/" . $subnet;

    return $string;

}

 * find_interface_ip($interface): return the interface ip (first found)

 */

function find_interface_ip($interface) {

}

    return $config['interfaces'][$opt]['if'];

function filter_get_opt_interface_descr($opt) {

    return $config['interfaces'][$opt]['descr'];

    $ints = array();

    $i = 0;

    $ifdescrs = array('wan', 'lan');

    for ($j = 1; isset($config['interfaces']['opt' . $j]); $j++) {

    $ifdescrs = get_interface_list();

    foreach ($ifdescrs as $ifdescr => $ifname) {

	array_push($ints,$ifdescr);

    }

    return $ints;

 * find_ip_interface($ip): return the interface where an ip is defined

 */

function find_ip_interface($ip) {

    $i = 0;

    $ifdescrs = array('wan', 'lan');

    for ($j = 1; isset($config['interfaces']['opt' . $j]); $j++) {

    foreach ($ifdescrs as $ifdescr => $ifname) {

	$int = filter_translate_type_to_real_interface($ifname);

	$ifconfig = exec_command("/sbin/ifconfig {$int}");

	if(stristr($ifconfig,$ip) <> false)

	    return $int;

    }

    return false;

 *  filter_translate_type_to_real_interface($interface): returns the real interface name

 *                                                       for a friendly interface.  ie: wan

 */

function filter_translate_type_to_real_interface($interface) {

    return $config['interfaces'][$interface]['if'];

 * get_carp_interface_status($carpinterface): returns the status of a carp ip

 */

function get_carp_interface_status($carpinterface) {

}

 * get_pfsync_interface_status($pfsyncinterface): returns the status of a pfsync

 */

function get_pfsync_interface_status($pfsyncinterface) {

}

 * find_carp_interface($ip): return the carp interface where an ip is defined

 */

function find_carp_interface($ip) {

    for($x=0; $x<$num_carp_ints; $x++) {

	if($result <> true) return;

	if(stristr($ifconfig,$ip))

    }

}

/*

 * add_rule_to_anchor($anchor, $rule): adds the specified rule to an anchor

 */

 * remove_text_from_file

 * remove $text from file $file

 */

function remove_text_from_file($file, $text) {

    global $fd_log;

    fwrite($fd_log, "Adding needed text items:\n");

    $filecontents = exec_command_and_return_text("cat " . $file);

    $textTMP = str_replace($text, "", $filecontents);

    $text .= $textTMP;

    fwrite($fd_log, $text . "\n");

    $fd = fopen($file, "w");

    fwrite($fd, $text);

    fclose($fd);

}

function is_package_installed($packagename) {

    global $config;

	foreach ($config['installedpackages']['package'] as $pkg) {

	    if($pkg['name'] == $packagename) return 1;

	}

}

 * lookup pkg array id#

 */

function get_pkg_id($pkg_name) {

    global $pkg_config;

    $i=0;

    foreach ($config['installedpackages']['package'] as $pkg) {

	$i++;

    return -1;

function get_latest_package_version($pkg_name) {

    $pkg_config = parse_xml_config_pkg("{$g['tmp_path']}/pkg_config.xml", "pfsensepkgs");

	    return $pkg['version'];

    }

/*

 * Lookup pkg_id in pkg_config.xml

 */

function get_available_pkg_id($pkg_name) {

    fetch_latest_pkg_config();

    $pkg_config = parse_xml_config_pkg("{$g['tmp_path']}/pkg_config.xml", "pfsensepkgs");

    $id = 0;

    foreach($pkg_config as $pkg) {

	if($pkg_config['name'] == $pkg_name) {

	    return $id;

	}

	$id++;

    }

    return;

}

/*

 * fetch_latest_pkg_config: download the latest pkg_config.xml to /tmp/ directory

 */

function fetch_latest_pkg_config() {

	$pkg_config_base_url = $g['pkg_config_base_url'];

	if(isset($config['system']['alt_pkgconfig_url']['enabled'])) {

	    $pkg_config_location = $config['system']['alt_pkgconfig_url']['pkgconfig_base_url'] . $config['system']['alt_pkgconfig_url']['pkgconfig_filename'];

	    $pkg_config_base_url = $config['system']['alt_pkgconfig_url']['pkgconfig_base_url'];

    return;

}

 * add_text_to_file($file, $text): adds $text to $file.

 * replaces the text if it already exists.

 */

function add_text_to_file($file, $text) {

    global $fd_log;

    fwrite($fd_log, "Adding needed text items:\n");

    $filecontents = exec_command_and_return_text("cat " . $file);

    $filecontents = str_replace($text, "", $filecontents);

    $text = $filecontents . $text;

    fwrite($fd_log, $text . "\n");

    $fd = fopen($file, "w");

    fwrite($fd, $text . "\n");

    fclose($fd);

}

/*

 * get_filename_from_url($url): converts a url to its filename.

 */

function get_filename_from_url($url) {

    foreach($filenamesplit as $fn) $filename = $fn;

    return $filename;

/*

 *   update_output_window: update bottom textarea dynamically.

 */

function update_output_window($text) {

    echo "\n<script language=\"JavaScript\">this.document.forms[0].output.value = \"" . $log . "\";</script>";

/*

 *   get_dir: return an array of $dir

 */

function get_dir($dir) {

    $d = dir($dir);

    while (false !== ($entry = $d->read())) {

    $d->close();

    return $dir_array;

/*

 *   update_output_window: update top textarea dynamically.

 */

function update_status($status) {

/*

 *   exec_command_and_return_text_array: execute command and return output

 */

function exec_command_and_return_text_array($command) {

    $fd = popen($command . " 2>&1 ", "r");

    while(!feof($fd)) {

    fclose($fd);

    $temp_array = split("\n", $tmp);

    return $tmp_array;

/*

 *   exec_command_and_return_text: execute command and return output

 */

function exec_command_and_return_text($command) {

/*

 *   exec_command_and_return_text: execute command and update output window dynamically

 */

function execute_command_return_output($command) {

    global $fd_log;

    $fd = popen($command . " 2>&1 ", "r");

    echo "\n<script language=\"JavaScript\">this.document.forms[0].output.value = \"\";</script>";

    $counter = 0;

    $counter2 = 0;

    while(!feof($fd)) {

	$tmp = fread($fd, 50);

	$tmp1 = ereg_replace("\n","\\n", $tmp);

	$text = ereg_replace("\"","'", $tmp1);

	if($lasttext == "..") {

	    $text = "";

	    $lasttext = "";

	    $counter=$counter-2;

	} else {

	    $lasttext .= $text;

	}

	if($counter > 51) {

	    $counter = 0;

	    $extrabreak = "\\n";

	} else {

	    $extrabreak = "";

	    $counter++;

	}

	if($counter2 > 600) {

	    echo "\n<script language=\"JavaScript\">this.document.forms[0].output.value = \"\";</script>";

	    $counter2 = 0;

	} else

	    $counter2++;

	echo "\n<script language=\"JavaScript\">this.document.forms[0].output.value = this.document.forms[0].output.value + \"" . $text . $extrabreak .  "\"; f('output'); </script>";

    }

    fclose($fd);

}

 * convert_friendly_interface_to_real_interface_name($interface): convert WAN to FXP0

 */

function convert_friendly_interface_to_real_interface_name($interface) {

    if($lc_interface == "wan") return $config['interfaces']['wan']['if'];

    for ($j = 1; isset($config['interfaces']['opt' . $j]); $j++)

	$ifdescrs['opt' . $j] = "opt" . $j;

	    return $config['interfaces'][$ifname]['if'];

	if(strtolower($config['interfaces'][$ifname]['descr']) == $lc_interface)

    }

    return $interface;

 * convert_real_interface_to_friendly_interface_name($interface): convert fxp0 -> wan, etc.

 */

function convert_real_interface_to_friendly_interface_name($interface) {

    $i = 0;

    $ifdescrs = array('wan', 'lan');

    for ($j = 1; isset($config['interfaces']['opt' . $j]); $j++)

	$ifdescrs['opt' . $j] = "opt" . $j;

    foreach ($ifdescrs as $ifdescr => $ifname) {

	$int = filter_translate_type_to_real_interface($ifname);

	if($ifname == $interface) return $ifname;

	if($int == $interface) return $ifname;

    }

    return $interface;

 * update_progress_bar($percent): updates the javascript driven progress bar.

 */

function update_progress_bar($percent) {

    echo "\n<script type=\"text/javascript\" language=\"javascript\">";

    echo "\ndocument.progressbar.style.width='" . $percent . "%';";

    echo "\n</script>";

 * This function may also print output to the terminal indicating progress.

    $i = 0;

    log_error("Resyncing configuration for all packages.");

    if(!$config['installedpackages']['package']) return;

    if($show_message == true) print "Syncing packages:";

    foreach($config['installedpackages']['package'] as $package) {

	sync_package($i, true, true);

	$i++;

    if($show_message == true) print ".\n";

 *			      that may still be running (a server that does not automatically timeout, for example)

function sweep_package_processes() {

    global $config;

    if(!$config['installedpackages']['package']) return;

    foreach($config['installedpackages']['package'] as $package) {

        $pkg_config = parse_xml_config_pkg("/usr/local/pkg/" . $package['configurationfile'], "packagegui");

        if($pkg_config['swept_processes'] <> "") {

            log_error("Killed " . $package['name'] . "'s unnecessary processes.");

    $queue_stats = array();

    foreach ($stats_array as $stats_line) {

        if (preg_match_all("/queue\s+(\w+)\s+/",$stats_line,$match_array))

            $queue_name = $match_array[1][0];

            $speed = $match_array[1][0];

            $borrows = $match_array[1][0];

            $suspends = $match_array[1][0];

            $drops = $match_array[1][0];

            $measured = $match_array[1][0];

		if(stristr($queue_name,"root_") == false)

    }

    return $queue_stats;

}

 */

function reverse_strrchr($haystack, $needle) {

    if($post === false) {

    return substr($haystack, 0, $post + 1);

/*

 * $filetype = "all" || ".xml", ".tgz", etc.