pfSense

<?php

/****h* pfSense/notices

 * NAME

 *   notices.inc - pfSense notice utilities

 * DESCRIPTION

 *   This include contains the pfSense notice facilities.

 * HISTORY

 *   $Id$

 ******

 *

 * 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)

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

 * POSSIBILITY OF SUCH DAMAGE.

 *

 */

	pfSense_BUILDER_BINARIES:	/bin/echo

	pfSense_MODULE:	notifications

*/

$notice_path = $g['tmp_path'] . '/notices';

 * NAME

 *   file_notice

 * INPUTS

 *	 $id, $notice, $category, $url, $priority

 * RESULT

 *   Files a notice and kicks off the various alerts, smtp, growl, system log, LED's, etc.

 ******/

	 * $category - Category that this notice should be displayed under. This can be arbitrary,

	 * 	       but a page must be set to receive this messages for it to be displayed.

	 *

	 * $priority - A notice's priority. Higher numbers indicate greater severity.

	 *	       0 = informational, 1 = warning, 2 = error, etc. This may also be arbitrary,

	 */

	if(!$queue = get_notices()) $queue = array();

	$queuekey = time();

	$toqueue = array(

				'id'		=> $id,

				'notice'	=> $notice,

				'url'		=> $url,

				'category'	=> $category,

				'priority'	=> $priority,

			);

	$queue[$queuekey] = $toqueue;

	$queueout = fopen($notice_path, "w");

	}

	fclose($queueout);

 * NAME

 *   get_notices

 * INPUTS

 *	 $category

 * RESULT

 *   Returns a specific notices text

 ******/

	if(file_exists("{$g['tmp_path']}/notices")) {

		$queue = unserialize(file_get_contents("{$g['tmp_path']}/notices"));

			foreach($queue as $time => $notice) {

				if(strtolower($notice['category']) == strtolower($category))

					$toreturn[$time] = $notice;

			}

			return $toreturn;

		} else {

			return $queue;

		}

	} else {

		return false;

	}

}

 * NAME

 *   close_notice

 * INPUTS

 *	 $id

 * RESULT

 *   Removes a notice from the list

 ******/

	global $notice_path;

	require_once("util.inc");

	if(file_exists("/dev/led/error"))

		exec("/bin/echo 0 > /dev/led/error");

	led_normalize();

	if($id == "all") {

		unlink_if_exists($notice_path);

		return;

	}

	foreach(array_keys($notices) as $time) {

		if($id == $time) {

			unset($notices[$id]);

			break;

		}

	}

	foreach($notices as $key => $notice) {

		$ids[$key] = $notice['id'];

	}

	foreach($ids as $time => $tocheck) {

		if($id == $tocheck) {

			unset($notices[$time]);

			break;

		}

	}

	} else {

		unlink_if_exists($notice_path);

	}

 * NAME

 *   dump_xml_notices

 * INPUTS

 *	 NONE

 * RESULT

 *   Outputs notices in XML formatted text

 ******/

		require_once("xmlreader.inc");

	else

		require_once("xmlparse.inc");

	$listtags[] = 'notice';

	if(!$notices = get_notices()) return;

	foreach($notices as $time => $notice) {

		$notice['time'] = $time;

		$toput['notice'][] = $notice;

	}

	$xml = dump_xml_config($toput, 'notices');

	return $xml;

}

 * NAME

 *   print_notices

 * INPUTS

 *	 $notices, $category

 * RESULT

 *   prints notices to the GUI

 ******/

	foreach($notices as $notice) {

		if($category != "all") {

			if(in_array($notice['category'], $category)) $categories[] = $notice['category'];

		} else {

			$categories[] = $notice['category'];

		}

	}

	$categories = array_unique($categories);

	sort($categories);

	foreach($categories as $category) {

		$toreturn .= "<ul><li>{$category}<ul>";

		foreach($notices as $notice) {

					if($notice['url'] != "") {

						$toreturn .= "<li><a href={$notice['url']}>{$notice['id']}</a> - {$notice['notice']}</li>";

					} else {

						$toreturn .= "<li>{$notice['id']} - {$notice['notice']}</li>";

					}

				}

			}

		}

		$toreturn .= "</ul></li></ul>";

	}

	return $toreturn;

}

 * NAME

 *   print_notice_box

 * INPUTS

 *	 $category

 * RESULT

 *   prints an info box to the GUI

 ******/

	$notices = get_notices();

	if(!$notices) return;

	print_info_box_np(print_notices($notices, $category));

	return;

}

 * NAME

 *   are_notices_pending

 * INPUTS

 *	 $category to check

 * RESULT

 *   returns true if notices are pending, false if they are not

 ******/

	global $notice_path;

	if(file_exists($notice_path)) {

		return true;

	}

	return false;

 *   notify_via_smtp

 * INPUTS

 *	 notification string to send as an email

 * RESULT

 *   returns true if message was sent

 ******/

	if($g['booting'])

		return;

	if(!$config['notifications']['smtp']['ipaddress'])

		return;

		return;

		$lastmsg = trim(file_get_contents("/var/db/notices_lastmsg.txt"));

		if($lastmsg == $message)

			return;

	}

	$from = "pfsense@{$config['system']['hostname']}.{$config['system']['domain']}";

	$to = $config['notifications']['smtp']['notifyemailaddress'];

	$smtp->host_name = $config['notifications']['smtp']['ipaddress'];

	if($config['notifications']['smtp']['fromaddress'])

		$from = $config['notifications']['smtp']['fromaddress'];

	// Use SMTP Auth if fields are filled out

	if($config['notifications']['smtp']['username'] && 

	   $config['notifications']['smtp']['password']) {

		$smtp->authentication_mechanism = "PLAIN";

	}

	$headers = array(

		"From: {$from}",

		"To: {$to}",

		"Subject: {$config['system']['hostname']}.{$config['system']['domain']} - Notification",

		"Date: ".strftime("%a, %d %b %Y %H:%M:%S %Z")

	);

	$fd = fopen("/var/db/notices_lastmsg.txt", "w");

	fwrite($fd, $message);

	fclose($fd);

	} else {

		return(sprintf(gettext('Could not send the message to %1$s -- Error: %2$s'), $to, $smtp->error));

}

 *   notify_via_growl

 * INPUTS

 *	 notification string to send

 * RESULT

 *   returns true if message was sent

 ******/

function notify_via_growl($message) {

	require_once("growl.class");

	/* Do NOT send the same message twice */

	if(file_exists("/var/db/growlnotices_lastmsg.txt")) {

		$lastmsg = trim(file_get_contents("/var/db/growlnotices_lastmsg.txt"));

		if($lastmsg == $message)

			return;

	}

	$growl_password = $config['notifications']['growl']['password'];

	$growl_notification = $config['notifications']['growl']['notification_name'];

	/* Store last message sent to avoid spamming */

	$fd = fopen("/var/db/growlnotices_lastmsg.txt", "w");

	fwrite($fd, $message);

	fclose($fd);

 *   register_via_growl

 * INPUTS

 *	 none

 * RESULT

 *   none

 ******/

function register_via_growl() {

	require_once("growl.class");

	global $config;

	$growl_ip = $config['notifications']['growl']['ipaddress'];

	$growl_password = $config['notifications']['growl']['password'];

	$growl_notification = $config['notifications']['growl']['notification_name'];

		$growl->addNotification($growl_notification);

	}

}