$field_array) { /* loop through each sub-field that we are going to check for variables */ foreach ($check_fields as $field_to_check) { if (isset($field_array[$field_to_check]) && is_array($form_array[$field_name][$field_to_check])) { /* if the field/sub-field combination is an array, resolve it recursively */ $form_array[$field_name][$field_to_check] = inject_form_variables($form_array[$field_name][$field_to_check], $arg1); } elseif (isset($field_array[$field_to_check]) && !is_array($field_array[$field_to_check])) { $count = 0; /* loop through the $field_to_check and replace up to three times * for each arg1:arg2:arg3 variables. */ while (true) { $matches = array(); //if (preg_match('/\|(arg[123]):([a-zA-Z0-9_]*)\|/', $form_array[$field_name][$field_to_check], $matches)) { if (preg_match('/\|(arg[123]):([a-zA-Z0-9_]*)\|/', $field_array[$field_to_check], $matches)) { $string = $field_array[$field_to_check]; $matches0 = $matches[0]; $matches1 = $matches[1]; $matches2 = $matches[2]; /* an empty field name in the variable means don't treat this as an array */ if ($matches2 == '') { if (is_array($$matches1)) { /* the existing value is already an array, leave it alone */ $form_array[$field_name][$field_to_check] = $$matches1; } else { /* the existing value is probably a single variable */ $form_array[$field_name][$field_to_check] = str_replace($matches0, $$matches1, $field_array[$field_to_check]); } } else { /* copy the value down from the array/key specified in the variable * replace up to three times for arg1:arg2:arg3 variables */ if (isset($$matches1)) { if (is_array($$matches1)) { $array = $$matches1; if (is_array($array) && isset($array[$matches2]) && $array[$matches2] != '') { $string = str_replace($matches0, $array[$matches2], $string); } else { $string = str_replace($matches0, '', $string); } } } // Double check to see if the replacement went as planned $matches = array(); preg_match('/\|(arg[123]):([a-zA-Z0-9_]*)\|/', $string, $matches); if (!cacti_sizeof($matches)) { $form_array[$field_name][$field_to_check] = $string; // No more arg[123] break; } else { if ($field_to_check == 'sql') { // Update the form value with the modified string // Then update the field array string value to recheck $form_array[$field_name][$field_to_check] = $string; $field_array[$field_to_check] = $string; } elseif (isset($form_array[$field_name]['default'])) { // We did not find a match for this field value, use the default $form_array[$field_name][$field_to_check] = $form_array[$field_name]['default']; } else { // We found no value, found no default, set to empty string $form_array[$field_name][$field_to_check] = ''; } } } /* if there are no more arg's, break. Since some arg's * might not ever be replaced, continue counting till 3 as * in the special case of 'sql' for example. */ $additional = preg_match('/\|(arg[123]):([a-zA-Z0-9_]*)\|/', $string); if (empty($additional)) { break; } elseif ($count >= 3) { break; } else { $count++; } } else { // No arg[123] found break; } } } } } } return $form_array; } /* form_alternate_row_color - starts an HTML row with an alternating color scheme @arg $row_color1 - the first color to use @arg $row_color2 - the second color to use @arg $row_value - the value of the row which will be used to evaluate which color to display for this particular row. must be an integer @arg $row_id - used to allow js and ajax actions on this object @returns - the background color used for this particular row */ function form_alternate_row_color($row_color1, $row_color2, $row_value, $row_id = '') { if ($row_value % 2 == 1) { $class='odd'; $current_color = $row_color1; } else { if ($row_color2 == '' || $row_color2 == 'E5E5E5') { $class = 'even'; } else { $class = 'even-alternate'; } $current_color = $row_color1; } if ($row_id != '') { print "\n"; } else { print "\n"; } return $current_color; } /* form_alternate_row - starts an HTML row with an alternating color scheme @arg $light - Alternate odd style @arg $row_id - The id of the row @arg $reset - Reset to top of table */ function form_alternate_row($row_id = '', $light = false, $disabled = false) { static $i = 1; if ($i % 2 == 1) { $class = 'odd'; } elseif ($light) { $class = 'even-alternate'; } else { $class = 'even'; } $i++; if ($row_id != '' && !$disabled && substr($row_id, 0, 4) != 'row_') { print "\n"; } elseif (substr($row_id, 0, 4) == 'row_') { print "\n"; } elseif ($row_id != '') { print "\n"; } else { print "\n"; } } /* form_selectable_ecell - a wrapper to form_selectable_cell that escapes the contents @arg $contents - the readable portion of the @arg $id - the id of the object that will be highlighted @arg $width - the width of the table element @arg $style_or_class - the style or class to apply to the table element @arg $title - optional title for the column */ function form_selectable_ecell($contents, $id, $width = '', $style_or_class = '', $title = '') { form_selectable_cell(html_escape($contents), $id, $width, $style_or_class, $title); } /* form_selectable_cell - format's a table row such that it can be highlighted using cacti's js actions @arg $contents - the readable portion of the @arg $id - the id of the object that will be highlighted @arg $width - the width of the table element @arg $style_or_class - the style or class to apply to the table element @arg $title - optional title for the column */ function form_selectable_cell($contents, $id, $width = '', $style_or_class = '', $title = '') { $output = ''; if ($style_or_class != '') { if (strpos($style_or_class, ':') === false) { $output = "class='nowrap " . $style_or_class . "'"; if ($width != '') { $output .= " style='width:$width;'"; } } else { $output = "class='nowrap' style='" . $style_or_class; if ($width != '') { $output .= ";width:$width;"; } $output .= "'"; } } else { $output = 'class="nowrap"'; if ($width != '') { $output .= " style='width:$width;'"; } } if ($title != '') { $wrapper = "" . $contents . ""; } else { $wrapper = $contents; } print "\t" . $wrapper . "\n"; } /* form_checkbox_cell - format's a tables checkbox form element so that the cacti js actions work on it @arg $title - the text that will be displayed if your hover over the checkbox */ function form_checkbox_cell($title, $id, $disabled = false) { print "\t\n"; print "\t\t\n"; print "\t\n"; } /* form_end_row - ends a table row that is started with form_alternate_row */ function form_end_row() { print "\n"; } /* html_boolean - returns the boolean equivalent of an HTML checkbox value @arg $html_boolean - the value of the HTML checkbox @returns - true or false based on the value of the HTML checkbox */ function html_boolean($html_boolean) { return ($html_boolean == 'on'); } /* html_boolean_friendly - returns the natural language equivalent of an HTML checkbox value @arg $html_boolean - the value of the HTML checkbox @returns - 'Selected' or 'Not Selected' based on the value of the HTML checkbox */ function html_boolean_friendly($html_boolean) { if ($html_boolean == 'on') { return __('Selected'); } else { return __('Not Selected'); } } /* get_checkbox_style - finds the proper CSS padding to apply based on the current client browser in use @returns - a CSS style string which should be used with an HTML checkbox control */ function get_checkbox_style() { return ''; } /* set_default_action - sets the required 'action' request variable @arg $default - The default action is not set @returns - null */ function set_default_action($default = '') { if (!isset_request_var('action')) { set_request_var('action', $default); } elseif (is_array(get_nfilter_request_var('action'))) { if (read_config_option('log_validation') == 'on') { cacti_log('WARNING: Request variable \'action\' was passed as array in ' . $_SERVER['SCRIPT_NAME'] . '.', false, 'WEBUI'); } set_request_var('action', $_REQUEST['action'][0]); } else { set_request_var('action', $_REQUEST['action']); } } /* unset_request_var - unsets the request variable @arg $variable - The variable to unset @returns - null */ function unset_request_var($variable) { global $_CACTI_REQUEST; if (isset($_CACTI_REQUEST[$variable])) { unset($_CACTI_REQUEST[$variable]); } if (isset($_REQUEST[$variable])) { unset($_REQUEST[$variable]); } } /* isset_request_var - checks to see if the $_REQUEST variable is set. Returns true or false. @arg $variable - The variable to check @returns - true or false */ function isset_request_var($variable) { return isset($_REQUEST[$variable]); } /* isempty_request_var - checks to see if the $_REQUEST variable is empty. Returns true or false. @arg $variable - The variable to check @returns - true or false */ function isempty_request_var($variable) { if (isset_request_var($variable)) { $value = $_REQUEST[$variable]; if (!empty($value)) { return false; } } return true; } /* set_request_var - sets a given $_REQUEST variable and Cacti global. @arg $variable - The variable to set @arg $value - The value to set the variable to @returns - null */ function set_request_var($variable, $value) { global $_CACTI_REQUEST; $_CACTI_REQUEST[$variable] = $value; $_REQUEST[$variable] = $value; $_POST[$variable] = $value; $_GET[$variable] = $value; } /* get_request_var - returns the current value of a PHP $_REQUEST variable, optionally returning a default value if the request variable does not exist. When Cacti has 'log_validation' set on, it will log all instances where a request variable has not first been filtered. @arg $name - the name of the request variable. this should be a valid key in the $_REQUEST array @arg $default - the value to return if the specified name does not exist in the $_REQUEST array @returns - the value of the request variable */ function get_request_var($name, $default = '') { global $_CACTI_REQUEST; $log_validation = read_config_option('log_validation'); if (isset($_CACTI_REQUEST[$name])) { return $_CACTI_REQUEST[$name]; } elseif (isset_request_var($name)) { if ($log_validation == 'on') { html_log_input_error($name); } set_request_var($name, $_REQUEST[$name]); return $_REQUEST[$name]; } else { return $default; } } /* get_request_var_request - deprecated - alias of get_request_var() returning a default value if the request variable does not exist @arg $name - the name of the request variable. this should be a valid key in the $_GET array @arg $default - the value to return if the specified name does not exist in the $_GET array @returns - the value of the request variable */ function get_request_var_request($name, $default = '') { return get_request_var($name, $default); } /* get_filter_request_var - returns the current value of a PHP $_REQUEST variable and also sanitizing the value using the filter. It will also optionally return a default value if the request variable does not exist @arg $name - the name of the request variable. this should be a valid key in the $_REQUEST array @arg $default - the value to return if the specified name does not exist in the $_REQUEST array @returns - the value of the request variable */ function get_filter_request_var($name, $filter = FILTER_VALIDATE_INT, $options = array()) { if (isset_request_var($name)) { if (isempty_request_var($name)) { set_request_var($name, get_nfilter_request_var($name)); return get_request_var($name); } elseif (get_nfilter_request_var($name) == 'undefined') { if (isset($options['default'])) { set_request_var($name, $options['default']); return $options['default']; } else { set_request_var($name, ''); return ''; } } else { if (get_nfilter_request_var($name) == '0') { $value = '0'; } elseif (get_nfilter_request_var($name) == 'undefined') { if (isset($options['default'])) { $value = $options['default']; } else { $value = ''; } } elseif (isempty_request_var($name)) { $value = ''; } elseif ($filter == FILTER_VALIDATE_IS_REGEX) { if (is_base64_encoded($_REQUEST[$name])) { $_REQUEST[$name] = base64_decode($_REQUEST[$name]); } $valid = validate_is_regex($_REQUEST[$name]); if ($valid === true) { $value = $_REQUEST[$name]; } else { $value = false; $custom_error = $valid; } } elseif ($filter == FILTER_VALIDATE_IS_NUMERIC_ARRAY) { $valid = true; if (is_array($_REQUEST[$name])) { foreach($_REQUEST[$name] AS $number) { if (!is_numeric($number)) { $valid = false; break; } } } else { $valid = false; } if ($valid == true) { $value = $_REQUEST[$name]; } else { $value = false; } } elseif ($filter == FILTER_VALIDATE_IS_NUMERIC_LIST) { $valid = true; $values = preg_split('/,/', $_REQUEST[$name], -1, PREG_SPLIT_NO_EMPTY); foreach($values AS $number) { if (!is_numeric($number)) { $valid = false; break; } } if ($valid == true) { $value = $_REQUEST[$name]; } else { $value = false; } } elseif (!cacti_sizeof($options)) { $value = filter_var($_REQUEST[$name], $filter); } else { $value = filter_var($_REQUEST[$name], $filter, $options); } } if ($value === false) { if ($filter == FILTER_VALIDATE_IS_REGEX) { raise_message('custom', __('The regular expression "%s" is not valid. Error is %s', html_escape(get_nfilter_request_var($name)), html_escape($custom_error)), MESSAGE_LEVEL_ERROR); set_request_var($name, ''); } else { die_html_input_error($name, get_nfilter_request_var($name)); } } else { set_request_var($name, $value); return $value; } } else { if (isset($options['default'])) { set_request_var($name, $options['default']); return $options['default']; } else { return; } } } /* get_nfilter_request_var - returns the value of the request variable deferring any filtering. @arg $name - the name of the request variable. this should be a valid key in the $_POST array @arg $default - the value to return if the specified name does not exist in the $_POST array @returns - the value of the request variable */ function get_nfilter_request_var($name, $default = '') { global $_CACTI_REQUEST; if (isset($_CACTI_REQUEST[$name])) { return $_CACTI_REQUEST[$name]; } elseif (isset($_REQUEST[$name])) { return $_REQUEST[$name]; } else { return $default; } } /* get_request_var_post - depricated - returns the current value of a PHP $_POST variable, optionally returning a default value if the request variable does not exist. @arg $name - the name of the request variable. this should be a valid key in the $_POST array @arg $default - the value to return if the specified name does not exist in the $_POST array @returns - the value of the request variable */ function get_request_var_post($name, $default = '') { return get_nfilter_request_var($name, $default); } /* validate_store_request_vars - validate, sanitize, and store request variables into the custom $_CACTI_REQUEST and desired session variables for Cacti filtering. @arg $filters - an array keyed with the filter methods. @arg $session_prefix - the prefix for the session variable Valid filter include those from PHP filter_var() function syntax. The format of the array is: array( 'varA' => array( 'filter' => value, 'pageset' => true, (optional) 'session' => sess_name, (optional) 'options' => mixed, 'default' => value), 'varB' => array( 'filter' => value, 'pageset' => true, (optional) 'session' => sess_name, (optional) 'options' => mixed, 'default' => value), ... ); The 'pageset' attribute is optional, and when set, any changes between what the page returns and what is set in the session result in the page number being returned to 1. The 'session' attribute is also optional, and when set, all changes will be stored to the session variable defined and not to session_prefix . '_' . $variable as the default. This allows for the concept of global session variables such as 'sess_default_rows'. Validation 'filter' follow PHP conventions including: FILTER_VALIDATE_BOOLEAN - Validate that the variable is boolean FILTER_VALIDATE_EMAIL - Validate that the variable is an email FILTER_VALIDATE_FLOAT - Validate that the variable is a float FILTER_VALIDATE_INT - Validate that the variable is an integer FILTER_VALIDATE_IP - Validate that the variable is an IP address FILTER_VALIDATE_MAC - Validate that the variable is a MAC Address FILTER_VALIDATE_REGEXP - Validate against a REGEX FILTER_VALIDATE_URL - Validate that the variable is a valid URL FILTER_VALIDATE_IS_REGEX - Validate if a filter variable is a valid regex FILTER_VALIDATE_IS_NUMERIC_ARRAY - Validate if a filter variable is a numeric array FILTER_VALIDATE_IS_NUMERIC_LIST - Validate if a filter variable is a comma delimited list of numbers Sanitization 'filters' follow PHP conventions including: FILTER_SANITIZE_EMAIL - Sanitize the email address FILTER_SANITIZE_ENCODED - URL-encode string FILTER_SANITIZE_MAGIC_QUOTES - Apply addslashes() FILTER_SANITIZE_NUMBER_FLOAT - Remove all non float values FILTER_SANITIZE_NUMBER_INT - Remove everything non int FILTER_SANITIZE_SPECIAL_CHARS - Escape special chars FILTER_SANITIZE_FULL_SPECIAL_CHARS - Equivalent to htmlspecialchars adding ENT_QUOTES FILTER_SANITIZE_STRING - Strip tags, optionally strip or encode special chars FILTER_SANITIZE_URL - Remove all characters except letters, digits, etc. FILTER_UNSAFE_RAW - Nothing and optional strip or encode @returns - the $_REQUEST variable validated and sanitized. */ function validate_store_request_vars($filters, $sess_prefix = '') { global $_CACTI_REQUEST; $changed = 0; $custom_error = ''; if (cacti_sizeof($filters)) { foreach($filters as $variable => $options) { // Establish the session variable first if ($sess_prefix != '') { if (isset($options['session'])) { $session_variable = $options['session']; } elseif ($variable != 'rows') { $session_variable = $sess_prefix . '_' . $variable; } else { $session_variable = 'sess_default_rows'; } // Check for special cases 'clear' and 'reset' if (isset_request_var('clear')) { kill_session_var($session_variable); unset_request_var($variable); } elseif (isset_request_var('reset')) { kill_session_var($session_variable); } elseif (isset($options['pageset']) && $options['pageset'] == true) { $changed += check_changed($variable, $session_variable); } } if (!isset_request_var($variable)) { if ($sess_prefix != '' && isset($_SESSION[$session_variable])) { set_request_var($variable, $_SESSION[$session_variable]); } elseif (isset($options['default'])) { set_request_var($variable, $options['default']); } else { cacti_log("Filter Variable: $variable, Must have a default and none is set", false); set_request_var($variable, ''); } } else { if (get_nfilter_request_var($variable) == '0') { $value = '0'; } elseif (get_nfilter_request_var($variable) == 'undefined') { if (isset($options['default'])) { $value = $options['default']; } else { $value = ''; } } elseif (isempty_request_var($variable)) { $value = ''; } elseif ($options['filter'] == FILTER_VALIDATE_IS_REGEX) { if (is_base64_encoded($_REQUEST[$variable])) { $_REQUEST[$variable] = base64_decode($_REQUEST[$variable]); } $valid = validate_is_regex($_REQUEST[$variable]); if ($valid === true) { $value = $_REQUEST[$variable]; } else { $value = false; $custom_error = $valid; } } elseif ($options['filter'] == FILTER_VALIDATE_IS_NUMERIC_ARRAY) { $valid = true; if (is_array($_REQUEST[$variable])) { foreach($_REQUEST[$variable] AS $number) { if (!is_numeric($number)) { $valid = false; break; } } } else { $valid = false; } if ($valid == true) { $value = $_REQUEST[$variable]; } else { $value = false; } } elseif ($options['filter'] == FILTER_VALIDATE_IS_NUMERIC_LIST) { $valid = true; $values = preg_split('/,/', $_REQUEST[$variable], -1, PREG_SPLIT_NO_EMPTY); foreach($values AS $number) { if (!is_numeric($number)) { $valid = false; break; } } if ($valid == true) { $value = $_REQUEST[$variable]; } else { $value = false; } } elseif (!isset($options['options'])) { $value = filter_var($_REQUEST[$variable], $options['filter']); } else { $value = filter_var($_REQUEST[$variable], $options['filter'], $options['options']); } if ($value === false) { if ($options['filter'] == FILTER_VALIDATE_IS_REGEX) { raise_message('custom', __('The regular expression "%s" is not valid. Error is %s', html_escape(get_nfilter_request_var($variable)), html_escape($custom_error)), MESSAGE_LEVEL_ERROR); set_request_var($variable, ''); } else { die_html_input_error($variable, get_nfilter_request_var($variable), html_escape($custom_error)); } } else { set_request_var($variable, $value); } } if ($sess_prefix != '') { if (isset_request_var($variable)) { $_SESSION[$session_variable] = get_request_var($variable); } elseif (isset($_SESSION[$session_variable])) { set_request_var($variable, $_SESSION[$session_variable]); } } } update_order_string(); } if ($changed) { set_request_var('page', 1); set_request_var('changed', 1); $_SESSION[$sess_prefix . '_page'] = 1; } elseif (!isset_request_var('page') && isset($_SESSION[$sess_prefix . '_page'])) { set_request_var('page', $_SESSION[$sess_prefix . '_page']); } } /* update_order_string - creates a sort string for standard Cacti tables @returns - null */ function update_order_string($inplace = false) { $page = get_order_string_page(); $order = ''; if (strpos(get_request_var('sort_column'), '(') === false && strpos(get_request_var('sort_column'), '`') === false) { $del = '`'; } else { $del = ''; } if ($inplace) { $_SESSION['sort_string'][$page] = 'ORDER BY '; foreach($_SESSION['sort_data'][$page] as $column => $direction) { if ($column == 'hostname' || $column == 'ip' || $column == 'ip_address') { $order .= ($order != '' ? ', ':'') . 'INET_ATON(' . $column . ') ' . $direction; } else { $order .= ($order != '' ? ', ':'') . $column . ' ' . $direction; } } $_SESSION['sort_string'][$page] .= $order; } else { if (isset_request_var('clear')) { unset($_SESSION['sort_data'][$page]); unset($_SESSION['sort_string'][$page]); } elseif (isset_request_var('add') && get_nfilter_request_var('add') == 'reset') { unset($_SESSION['sort_data'][$page]); unset($_SESSION['sort_string'][$page]); $_SESSION['sort_data'][$page][get_request_var('sort_column')] = get_request_var('sort_direction'); $column = get_request_var('sort_column'); $direction = get_request_var('sort_direction'); if ($column == 'hostname' || $column == 'ip' || $column == 'ip_address') { $_SESSION['sort_string'][$page] ='ORDER BY INET_ATON(' . $column . ") " . $direction; } else { $_SESSION['sort_string'][$page] = 'ORDER BY ' . $del . implode($del . '.'. $del, explode('.', get_request_var('sort_column'))) . $del . ' ' . get_request_var('sort_direction'); } } elseif (isset_request_var('sort_column')) { if (isset_request_var('reset')) { unset($_SESSION['sort_data'][$page]); unset($_SESSION['sort_string'][$page]); } $_SESSION['sort_data'][$page][get_request_var('sort_column')] = get_nfilter_request_var('sort_direction'); $_SESSION['sort_string'][$page] = 'ORDER BY '; foreach($_SESSION['sort_data'][$page] as $column => $direction) { if (strpos($column, '(') === false && strpos($column, '`') === false) { $del = '`'; } else { $del = ''; break; } } foreach($_SESSION['sort_data'][$page] as $column => $direction) { if ($column == 'hostname' || $column == 'ip' || $column == 'ip_address') { $order .= ($order != '' ? ', ':'') . 'INET_ATON(' . $column . ") " . $direction; } else { $order .= ($order != '' ? ', ' . $del:$del) . implode($del . '.' . $del, explode('.', $column)) . $del . ' ' . $direction; } } $_SESSION['sort_string'][$page] .= $order; } else { unset($_SESSION['sort_data'][$page]); unset($_SESSION['sort_string'][$page]); } } } /* get_order_string - returns a valid order string for a table @returns - the order string */ function get_order_string() { $page = get_order_string_page(); if (strpos(get_request_var('sort_column'), '(') === false && strpos(get_request_var('sort_column'), '`') === false) { $del = '`'; } else { $del = ''; } if (isset($_SESSION['sort_string'][$page])) { return $_SESSION['sort_string'][$page]; } else { return 'ORDER BY ' . $del . implode($del . '.' . $del, explode('.', get_request_var('sort_column'))) . $del . ' ' . get_request_var('sort_direction'); } } function remove_column_from_order_string($column) { $page = get_order_string_page(); if (isset($_SESSION['sort_data'][$page][$column])) { unset($_SESSION['sort_data'][$page][$column]); update_order_string(true); } } function get_order_string_page() { $page = str_replace('.php', '', get_current_page()); if (isset_request_var('action')) { $page .= '_' . get_nfilter_request_var('action'); } if (isset_request_var('tab')) { $page .= '_' . get_nfilter_request_var('tab'); } return $page; } function validate_is_regex($regex) { if ($regex == '') { return true; } /** * Prevent exploits from encoded Regular expressions that can cause * injections in MariaDB and MySQL. We do this by limiting the * length of the regular expression to 50 bytes or less. */ if (strlen($regex) > 50) { return __('Cacti regular expressions are limited to 50 characters only for security reasons.'); } if (strpos($regex, ';') !== false) { return __('Cacti regular expressions can not includes the semi-color character.'); } restore_error_handler(); $track_errors = ini_get('track_errors'); ini_set('track_errors', 1); if (@preg_match("'" . $regex . "'", NULL) !== false) { ini_set('track_errors', $track_errors); return true; } $last_error = error_get_last(); $php_error = trim(str_replace('preg_match():', '', $last_error['message'])); ini_set('track_errors', $track_errors); $errors = array( PREG_INTERNAL_ERROR => __('There was an internal error!'), PREG_BACKTRACK_LIMIT_ERROR => __('Backtrack limit was exhausted!'), PREG_RECURSION_LIMIT_ERROR => __('Recursion limit was exhausted!'), PREG_BAD_UTF8_ERROR => __('Bad UTF-8 error!'), PREG_BAD_UTF8_OFFSET_ERROR => __('Bad UTF-8 offset error!'), ); $error = preg_last_error(); if (!defined('IN_CACTI_INSTALL')) { set_error_handler('CactiErrorHandler'); } if (empty($error)) { return $php_error; } else { return $errors[$error]; } } /* load_current_session_value - finds the correct value of a variable that is being cached as a session variable on an HTML form @arg $request_var_name - the array index name for the request variable @arg $session_var_name - the array index name for the session variable @arg $default_value - the default value to use if values cannot be obtained using the session or request array */ function load_current_session_value($request_var_name, $session_var_name, $default_value) { if (isset_request_var($request_var_name)) { $_SESSION[$session_var_name] = get_request_var($request_var_name); } elseif (isset($_SESSION[$session_var_name])) { set_request_var($request_var_name, $_SESSION[$session_var_name]); } else { set_request_var($request_var_name, $default_value); } } /* get_colored_device_status - given a device's status, return the colored text in HTML format suitable for display @arg $disabled (bool) - true if the device is disabled, false is it is not @arg $status - the status type of the device as defined in global_constants.php @returns - a string containing html that represents the device's current status */ function get_colored_device_status($disabled, $status) { if ($disabled) { return "" . __('Disabled') . ""; } else { switch ($status) { case HOST_DOWN: return "" . __('Down') . ""; break; case HOST_RECOVERING: return "" . __('Recovering') . ""; break; case HOST_UP: return "" . __('Up') . ""; break; case HOST_ERROR: return "" . __('Error') . ""; break; default: return "" . __('Unknown') . ""; break; } } } /* get_current_graph_start - determine the correct graph start time selected using the timespan selector @returns - the number of seconds relative to now where the graph should begin */ function get_current_graph_start() { if (isset($_SESSION['sess_current_timespan_begin_now']) && is_numeric($_SESSION['sess_current_timespan_begin_now'])) { return $_SESSION['sess_current_timespan_begin_now']; } else { return '-' . DEFAULT_TIMESPAN; } } /* get_current_graph_end - determine the correct graph end time selected using the timespan selector @returns - the number of seconds relative to now where the graph should end */ function get_current_graph_end() { if (isset($_SESSION['sess_current_timespan_end_now']) && is_numeric($_SESSION['sess_current_timespan_end_now'])) { return $_SESSION['sess_current_timespan_end_now']; } else { return '0'; } } /* display_tooltip - display the text passed to the function as a tooltip @arg $text - the text to display in the tooltip @returns - null */ function display_tooltip($text) { if ($text != '') { return '
' . $text . "
\n"; } else { return ''; } } /* get_page_list - generates the html necessary to present the user with a list of pages limited in length and number of rows per page @arg $current_page - the current page number @arg $pages_per_screen - the maximum number of pages allowed on a single screen. odd numbered values for this argument are prefered for equality reasons @arg $current_page - the current page number @arg $total_rows - the total number of available rows @arg $url - the url string to prepend to each page click @returns - a string containing html that represents the a page list */ function get_page_list($current_page, $pages_per_screen, $rows_per_page, $total_rows, $url, $page_var = 'page', $return_to = '') { // By current design, $pages_per_screen means number of page no in mid of nav bar // when $total_pages is larger than $pages_per_screen + 2(first and last) // So actual $pages_per_screen should be $pages_per_screen+2 $pages_per_screen += 2; $url_page_select = "'; if ($return_to != '') { $url_page_select .= ""; } else { $url_page_select .= ""; } return $url_page_select; }