host.php

<?php
/*
 +-------------------------------------------------------------------------+
 | Copyright (C) 2004-2026 The Cacti Group                                 |
 |                                                                         |
 | This program is free software; you can redistribute it and/or           |
 | modify it under the terms of the GNU General Public License             |
 | as published by the Free Software Foundation; either version 2          |
 | of the License, or (at your option) any later version.                  |
 |                                                                         |
 | This program is distributed in the hope that it will be useful,         |
 | but WITHOUT ANY WARRANTY; without even the implied warranty of          |
 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the           |
 | GNU General Public License for more details.                            |
 +-------------------------------------------------------------------------+
 | Cacti: The Complete RRDtool-based Graphing Solution                     |
 +-------------------------------------------------------------------------+
 | This code is designed, written, and maintained by the Cacti Group. See  |
 | about.php and/or the AUTHORS file for specific developer information.   |
 +-------------------------------------------------------------------------+
 | http://www.cacti.net/                                                   |
 +-------------------------------------------------------------------------+
*/

require('./include/auth.php');
require_once(CACTI_PATH_LIBRARY . '/api_automation.php');
require_once(CACTI_PATH_LIBRARY . '/api_data_source.php');
require_once(CACTI_PATH_LIBRARY . '/api_device.php');
require_once(CACTI_PATH_LIBRARY . '/api_graph.php');
require_once(CACTI_PATH_LIBRARY . '/api_tree.php');
require_once(CACTI_PATH_LIBRARY . '/data_query.php');
require_once(CACTI_PATH_LIBRARY . '/html_tree.php');
require_once(CACTI_PATH_LIBRARY . '/ping.php');
require_once(CACTI_PATH_LIBRARY . '/poller.php');
require_once(CACTI_PATH_LIBRARY . '/reports.php');
require_once(CACTI_PATH_LIBRARY . '/snmp.php');
require_once(CACTI_PATH_LIBRARY . '/template.php');
require_once(CACTI_PATH_LIBRARY . '/utility.php');

$actions = [
	1 => __('Delete'),
	2 => __('Enable'),
	3 => __('Disable'),
	4 => __('Change Device Settings'),
	5 => __('Clear Statistics'),
	6 => __('Apply Automation Rules'),
	7 => __('Sync to Device Template')
];

$reports = db_fetch_cell_prepared('SELECT COUNT(*)
	FROM reports
	WHERE user_id = ?
	ORDER BY name',
	[$_SESSION[SESS_USER_ID]]
);

if ($reports > 0) {
	$actions += [
		8 => __('Place Device on Report')
	];
}

$actions = api_plugin_hook_function('device_action_array', $actions);

// set default action
set_default_action();

api_plugin_hook('device_top');

switch (grv('action')) {
	case 'export':
		host_export();

		break;
	case 'save':
		form_save();

		break;
	case 'reindex':
		host_reindex();

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'actions':
		form_actions();

		break;
	case 'gt_add':
		gfrv('host_id');

		host_add_gt();

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'gt_remove':
		gfrv('host_id');

		host_remove_gt();

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'query_add':
		gfrv('host_id');

		host_add_query();

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'query_remove':
		gfrv('host_id');

		host_remove_query();

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'query_change':
		gfrv('host_id');

		host_change_query();

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'query_reload':
		gfrv('host_id');

		host_reload_query();
		raise_message('query_reloaded', __('Data Query Re-indexed.'), MESSAGE_LEVEL_INFO);

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'query_verbose':
		gfrv('host_id');

		host_reload_query();
		raise_message('query_reloaded', __('Device Data Query Re-indexed.  Verbose output displayed.'), MESSAGE_LEVEL_INFO);

		header('Location: host.php?action=edit&id=' . grv('host_id') . '&display_dq_details=true');

		break;
	case 'edit':
		top_header();

		host_edit();

		bottom_footer();

		break;
	case 'ping_host':
		$host_id = gfrv('id');
		api_device_ping_device($host_id);

		break;
	case 'enable_debug':
		enable_device_debug(gfrv('host_id'));
		raise_message('enable_debug', __('Device Debugging Enabled for Device.'), MESSAGE_LEVEL_INFO);

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'disable_debug':
		disable_device_debug(gfrv('host_id'));
		raise_message('disable_debug', __('Device Debugging Disabled for Device.'), MESSAGE_LEVEL_INFO);

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'repopulate':
		if (gfrv('host_id') > 0) {
			push_out_host(grv('host_id'));
			raise_message('repopulate_message', __('Poller Cache for Device Refreshed.'), MESSAGE_LEVEL_INFO);
		} else {
			raise_message('repopulate_error', __('ERROR: Invalid Device ID.'), MESSAGE_LEVEL_ERROR);
		}

		header('Location: host.php?action=edit&id=' . grv('host_id'));

		break;
	case 'ajax_locations':
		get_site_locations();

		break;
	default:
		top_header();

		host();

		bottom_footer();

		break;
}

function host_reindex() : void {
	$start = microtime(true);

	$host_id = gfrv('host_id');
	shell_exec(cacti_escapeshellcmd(read_config_option('path_php_binary')) . ' -q ' . cacti_escapeshellarg(CACTI_PATH_CLI . '/poller_reindex_hosts.php') . ' --qid=all --id=' . $host_id);

	$end = microtime(true);

	$total_time = $end - $start;

	$items = db_fetch_cell_prepared('SELECT COUNT(*)
		FROM host_snmp_cache
		WHERE host_id = ?',
		[$host_id]
	);

	raise_message('host_reindex', __('Device Reindex Completed in %0.2f seconds.  There were %d items updated.', $total_time, $items), MESSAGE_LEVEL_INFO);
}

function add_tree_names_to_actions_array() : void {
	global $actions;

	// add a list of tree names to the actions dropdown
	$trees = db_fetch_assoc('SELECT id, name FROM graph_tree ORDER BY name');

	if (cacti_sizeof($trees)) {
		foreach ($trees as $tree) {
			$actions['tr_' . $tree['id']] = __esc('Place on a Tree (%s)', $tree['name']);
		}
	}
}

function get_site_locations() : void {
	$return  = [];
	$term    = gnrv('term');
	$host_id = $_SESSION['cur_device_id'];

	$sql_params = ["%$term%"];
	$sql_where  = '';

	if (read_config_option('site_location_filter') && $_SESSION['cur_device_id']) {
		$site_id = db_fetch_cell_prepared('SELECT site_id
			FROM host
			WHERE id = ?',
			[$host_id]);

		$sql_params[] = $site_id;
		$sql_where    = 'AND site_id = ?';
	}

	$locations = db_fetch_assoc_prepared("SELECT DISTINCT location
		FROM host
		WHERE location LIKE ?
		AND location != ''
		AND location IS NOT NULL
		$sql_where
		ORDER BY location",
		$sql_params);

	if (cacti_sizeof($locations)) {
		foreach ($locations as $l) {
			$return[] = ['label' => $l['location'], 'value' => $l['location'], 'id' => $l['location']];
		}
	}

	if (!cacti_sizeof($return)) {
		$return[] = ['label' => __('None'), 'value' => '', 'id' => __('None')];
	}

	print json_encode($return);
}

function form_save() : void {
	if (isrv('save_component_host')) {
		if (gnrv('snmp_version') == 3 && (gnrv('snmp_password') != gnrv('snmp_password_confirm'))) {
			raise_message(14);
		} elseif (gnrv('snmp_version') == 3 && (gnrv('snmp_priv_passphrase') != gnrv('snmp_priv_passphrase_confirm'))) {
			raise_message(13);
		} else {
			gfrv('id');
			gfrv('host_template_id');

			$host_id = api_device_save(
				gnrv('id'),
				gnrv('host_template_id'),
				gnrv('description'),
				trim(gnrv('hostname')),
				gnrv('snmp_community'),
				gnrv('snmp_version'),
				gnrv('snmp_username'),
				gnrv('snmp_password'),
				gnrv('snmp_port'),
				gnrv('snmp_timeout'),
				(isrv('disabled') ? gnrv('disabled') : ''),
				gnrv('availability_method'),
				gnrv('ping_method'),
				gnrv('ping_port'),
				gnrv('ping_timeout'),
				gnrv('ping_retries'),
				gnrv('notes'),
				gnrv('snmp_auth_protocol'),
				gnrv('snmp_priv_passphrase'),
				gnrv('snmp_priv_protocol'),
				gnrv('snmp_context'),
				gnrv('snmp_engine_id'),
				gnrv('max_oids'),
				gnrv('device_threads'),
				gnrv('poller_id'),
				gnrv('site_id'),
				gnrv('external_id'),
				gnrv('location'),
				gnrv('bulk_walk_size'),
				gnrv('snmp_options'),
				gnrv('snmp_retries')
			);

			if ($host_id > 0) {
				api_plugin_hook_function('host_save', ['host_id' => $host_id]);
			}
		}

		header('Location: host.php?action=edit&id=' . (empty($host_id) ? gnrv('id') : $host_id));
	}
}

function form_actions() : void {
	global $actions, $device_change_fields, $fields_host_edit;
	global $alignment, $graph_timespans;

	// ================= input validation =================
	gfrv('drp_action', FILTER_VALIDATE_REGEXP, ['options' => ['regexp' => '/^([a-zA-Z0-9_]+)$/']]);
	// ====================================================

	// if we are to save this form, instead of display it
	if (isrv('selected_items')) {
		$selected_items = sanitize_unserialize_selected_items(gnrv('selected_items'));

		if ($selected_items != false) {
			if (grv('drp_action') == '2') { // Enable Selected Devices
				api_device_enable_devices($selected_items);
			} elseif (grv('drp_action') == '3') { // Disable Selected Devices
				api_device_disable_devices($selected_items);
			} elseif (grv('drp_action') == '4') { // change device options
				ini_set('max_execution_time', '-1');

				api_device_change_options($selected_items, $_POST);
			} elseif (grv('drp_action') == '5') { // Clear Statistics for Selected Devices
				api_device_clear_statistics($selected_items);
			} elseif (grv('drp_action') == '7') { // sync to device template
				ini_set('max_execution_time', '-1');

				api_device_sync_device_templates($selected_items);
			} elseif (grv('drp_action') == '8') { // place device on report
				if (!reports_add_devices(gfrv('report_id'), $selected_items, gfrv('timespan'), gfrv('align'))) {
					$name = db_fetch_cell_prepared('SELECT name
						FROM reports
						WHERE id = ?',
						[grv('report_id')]
					);

					raise_message('reports_add_error', __('Unable to add some Devices to Report \'%s\'', $name), MESSAGE_LEVEL_WARN);
				}
			} elseif (grv('drp_action') == '1') { // delete
				ini_set('max_execution_time', '-1');

				if (!isrv('delete_type')) {
					srv('delete_type', 2);
				}

				api_device_remove_multi($selected_items, gfrv('delete_type'));
			} elseif (preg_match('/^tr_([0-9]+)$/', grv('drp_action'), $matches)) { // place on tree
				gfrv('tree_id');
				gfrv('tree_item_id');

				foreach ($selected_items as $selected_item) {
					api_tree_item_save(0, gnrv('tree_id'), TREE_ITEM_TYPE_HOST, gnrv('tree_item_id'), '', 0, $selected_item, 0, 1, 1, false);
				}
			} elseif (grv('drp_action') == 6) { // automation
				automation_log(__FUNCTION__ . ' called, action: ' . grv('drp_action'), AUTOMATION_LOG_HIGH);

				automation_log(__FUNCTION__ . ', items: ' . gnrv('selected_items'), AUTOMATION_LOG_HIGH);

				// work on all selected hosts
				foreach ($selected_items as $host_id) {
					automation_update_device($host_id);
				}
			} else {
				api_plugin_hook_function('device_action_execute', gnrv('drp_action'));
			}
		}

		// update snmpcache
		snmpagent_device_action_bottom([gnrv('drp_action'), $selected_items]);

		api_plugin_hook_function('device_action_bottom', [gnrv('drp_action'), $selected_items]);

		header('Location: host.php');

		exit;
	} else {
		$ilist   = '';
		$iarray  = [];
		$footer  = '';
		$reports = [];

		add_tree_names_to_actions_array();

		// loop through each of the host templates selected on the previous page and get more info about them
		foreach ($_POST as $var => $val) {
			if (preg_match('/^chk_([0-9]+)$/', $var, $matches)) {
				// ================= input validation =================
				input_validate_input_number($matches[1], 'chk[1]');
				// ====================================================

				$ilist .= '<li>' . htmle(db_fetch_cell_prepared('SELECT description FROM host WHERE id = ?', [$matches[1]])) . '</li>';

				$iarray[] = $matches[1];
			}
		}

		if (gnrv('drp_action') == '4') { // Change Device options
			$form_array = [];

			foreach ($fields_host_edit as $field_name => $field_array) {
				if (api_device_change_field_match($field_name)) {
					$form_array += [$field_name => $fields_host_edit[$field_name]];

					$form_array[$field_name]['value'] = '';

					if (read_config_option('hide_form_description') == 'on') {
						$form_array[$field_name]['description'] = '';
					}

					$form_array[$field_name]['form_id']      = 0;
					$form_array[$field_name]['sub_checkbox'] = [
						'name'          => 't_' . $field_name,
						'friendly_name' => __('Update this Field'),
						'class'         => 'ui-state-disabled',
						'value'         => ''
					];
				}
			}

			ob_start();

			draw_edit_form(
				[
					'config' => ['no_form_tag' => true],
					'fields' => $form_array
				]
			);

			device_change_javascript();
			device_javascript();

			$footer = ob_get_clean();
		} elseif (grv('drp_action') == '8') { // Place on Report
			$reports = db_fetch_assoc_prepared('SELECT id, name
				FROM reports
				WHERE user_id = ?
				ORDER BY name',
				[$_SESSION[SESS_USER_ID]]
			);

			if (cacti_sizeof($reports)) {
				$reports = array_rekey($reports, 'id', 'name');
			}
		}

		$form_data = [
			'general' => [
				'page'       => 'host.php',
				'actions'    => $actions,
				'optvar'     => 'drp_action',
				'item_array' => $iarray,
				'item_list'  => $ilist
			],
			'options' => [
				1 => [
					'smessage' => __('Click \'Continue\' to Delete the following Device.'),
					'pmessage' => __('Click \'Continue\' to Delete the following Devices.'),
					'scont'    => __('Delete Device'),
					'pcont'    => __('Delete Devices'),
					'extra'    => [
						'delete_type' => [
							'method'  => 'radio',
							'title'   => __('Delete Method'),
							'default' => 2,
							'items'   => [
								'1' => [
									'radio_value'   => 2,
									'radio_caption' => __('Leave all Graph(s) and Data Source(s) untouched.  Data Source(s) will be disabled.')
								],
								'2' => [
									'radio_value'   => 2,
									'radio_caption' => __('Delete all associated Graph(s) and Data Source(s).')
								]
							]
						]
					]
				],
				2 => [
					'smessage' => __('Click \'Continue\' to Enable the following Device.'),
					'pmessage' => __('Click \'Continue\' to Enable the following Devices.'),
					'scont'    => __('Enable Device'),
					'pcont'    => __('Enable Devices')
				],
				3 => [
					'smessage' => __('Click \'Continue\' to Disable the following Device.'),
					'pmessage' => __('Click \'Continue\' to Disable the following Devices.'),
					'scont'    => __('Disable Device'),
					'pcont'    => __('Disable Devices')
				],
				4 => [
					'smessage' => __('Click \'Continue\' to Change settings for the following Device.'),
					'pmessage' => __('Click \'Continue\' to Change settings for the following Devices.'),
					'scont'    => __('Change Device'),
					'pcont'    => __('Change Devices'),
					'footer'   => $footer,
				],
				5 => [
					'smessage' => __('Click \'Continue\' to Clear Statistics the following Device.'),
					'pmessage' => __('Click \'Continue\' to Clear Statistics the following Devices.'),
					'scont'    => __('Clear Statistics for Device'),
					'pcont'    => __('Clear Statistics for Devices')
				],
				7 => [
					'smessage' => __('Click \'Continue\' to Synchronize Device to its Device Template.'),
					'pmessage' => __('Click \'Continue\' to Synchronize Devices to their Device Templates.'),
					'scont'    => __('Synchronize Device Template'),
					'pcont'    => __('Synchronize Devices Templates')
				],
				8 => [
					'smessage' => __('Click \'Continue\' to Place the following Device on a Report.'),
					'pmessage' => __('Click \'Continue\' to Place the following Devices on a Report.'),
					'scont'    => __('Place Device on Report'),
					'pcont'    => __('Place Devices on Report'),
					'extra'    => [
						'report_id' => [
							'method'  => 'drop_array',
							'title'   => __('Report Name'),
							'array'   => $reports,
							'default' => array_key_first($reports)
						],
						'timespan' => [
							'method'  => 'drop_array',
							'title'   => __('Timespan'),
							'array'   => $graph_timespans,
							'default' => read_user_setting('default_timespan')
						],
						'align' => [
							'method'  => 'drop_array',
							'title'   => __('Align'),
							'array'   => $alignment,
							'default' => REPORTS_ALIGN_CENTER
						]
					]
				],
			]
		];

		$trees = db_fetch_assoc('SELECT id, name FROM graph_tree ORDER BY name');

		if (cacti_sizeof($trees)) {
			foreach ($trees as $tree) {
				$branches = db_fetch_assoc_prepared('SELECT id, title
					FROM graph_tree_items
					WHERE graph_tree_id = ?
					AND host_id = 0
					AND local_graph_id = 0
					AND parent = 0
					ORDER BY parent, position',
					[$tree['id']]);

				if (cacti_sizeof($branches)) {
					$branches = array_rekey($branches, 'id', 'title');
				} else {
					$branches[0] = '[root]';
				}

				$form_data['options']['tr_' . $tree['id']] = [
					'smessage' => __esc('Click \'Continue\' to Place the following Device on Tree %s.', $tree['name']),
					'pmessage' => __esc('Click \'Continue\' to Place the following Devices on Tree %s.', $tree['name']),
					'scont'    => __('Place Device on Tree'),
					'pcont'    => __('Place Devices on Tree'),
					'extra'    => [
						'tree_item_id' => [
							'method'  => 'drop_array',
							'title'   => __('Destination Branch'),
							'array'   => $branches,
							'default' => array_key_first($branches),
						]
					],
					'eaction'   => 'tree_id',
					'eactionid' => $tree['id'],
				];
			}
		}

		// Legacy support for old version plugins
		if (!isset($form_data['options'][grv('drp_action')])) {
			$save['drp_action'] = grv('drp_action');
			$save['host_list']  = $ilist;
			$save['host_array'] = $iarray;
		} else {
			$save = [];
		}

		$form_data = api_plugin_hook_function('device_confirmation_form', $form_data);

		form_continue_confirmation($form_data, 'device_action_prepare', $save);
	}
}

function host_export() : void {
	draw_hosts_filter(false);

	$total_rows = 0;

	$hosts = get_device_records($total_rows, 9999999);

	$stdout = fopen('php://output', 'w');

	header('Content-type: application/excel');
	header('Content-Disposition: attachment; filename=cacti-devices-' . time() . '.csv');

	if (cacti_sizeof($hosts)) {
		$columns = array_keys($hosts[0]);

		fputcsv($stdout, $columns);

		foreach ($hosts as $h) {
			foreach (array_keys($h) as $hc) {
				if ($h[$hc] != '' && (str_contains($h[$hc], "\n") || str_contains($h[$hc], "\r"))) {
					$h[$hc] = str_replace(["\n", "\r"], ' ', $h[$hc]);
				}
			}

			fputcsv($stdout, $h);
		}
	}

	fclose($stdout);
}

function host_add_query() : void {
	// ================= input validation =================
	gfrv('host_id');
	gfrv('snmp_query_id');
	gfrv('reindex_method');
	// ====================================================

	api_device_dq_add(grv('host_id'), grv('snmp_query_id'), grv('reindex_method'));
}

function host_reload_query() : void {
	// ================= input validation =================
	gfrv('id');
	gfrv('host_id');
	// ====================================================

	run_data_query(grv('host_id'), grv('id'));
}

function host_remove_query() : void {
	// ================= input validation =================
	gfrv('id');
	gfrv('host_id');
	// ====================================================

	api_device_dq_remove(grv('host_id'), grv('id'));
}

function host_change_query() : void {
	// ================= input validation =================
	gfrv('data_query_id');
	gfrv('host_id');
	gfrv('reindex_method');
	// ====================================================

	api_device_dq_change(grv('host_id'), grv('data_query_id'), grv('reindex_method'));
}

function host_add_gt() : void {
	// ================= input validation =================
	gfrv('host_id');
	gfrv('graph_template_id');
	// ====================================================

	db_execute_prepared('REPLACE INTO host_graph
		(host_id, graph_template_id)
		VALUES (?, ?)',
		[gnrv('host_id'), gnrv('graph_template_id')]
	);

	if (grv('host_id') > 0) {
		object_cache_get_totals('device_state', grv('host_id'));
	}

	automation_hook_graph_template(gnrv('host_id'), gnrv('graph_template_id'));

	api_plugin_hook_function('add_graph_template_to_host', ['host_id' => gnrv('host_id'), 'graph_template_id' => gnrv('graph_template_id')]);

	if (grv('host_id') > 0) {
		object_cache_get_totals('device_state', grv('host_id'), true);
		object_cache_update_totals('diff');
	}
}

function host_remove_gt() : void {
	// ================= input validation =================
	gfrv('id');
	gfrv('host_id');
	// ====================================================

	api_device_gt_remove(grv('host_id'), grv('id'));
}

function create_host_edit_filter(array $host, string $content = '') : array {
	global $item_rows;

	$debug = is_device_debug_enabled($host['id']);

	$filters = [
		'rows' => [
			[
				'pingdata' => [
					'method'  => 'content',
					'filter'  => FILTER_DEFAULT,
					'content' => $content,
				],
				'id' => [
					'method'  => 'validate',
					'filter'  => FILTER_VALIDATE_INT,
					'default' => '',
				],
				'host_template_id' => [
					'method'  => 'validate',
					'filter'  => FILTER_VALIDATE_INT,
					'default' => '0'
				]
			]
		],
	];

	if ($host['id'] > 0) {
		$filters['links'] = [
			[
				'display' => __('Create New Device'),
				'url'     => 'host.php?action=edit',
				'class'   => 'ti ti-plus newDevice'
			],
			[
				'display' => __('Create New Graphs'),
				'url'     => 'graphs_new.php?reset=true&host_id=' . $host['id'],
				'class'   => 'ti ti-chart-area newGraph'
			],
			[
				'display' => __('Re-Index Device'),
				'url'     => 'host.php?action=reindex&host_id=' . $host['id'],
				'class'   => 'ti ti-refresh reindexDevice'
			],
			[
				'display' => ($debug ? __('Disable Device Debug') : __('Enable Device Debug')),
				'url'     => 'host.php?action=' . ($debug ? 'disable_debug' : 'enable_debug') . '&host_id=' . $host['id'],
				'class'   => ($debug ? 'ti ti-bug disableDebug' : 'ti ti-bug enableDebug')
			],
			[
				'display' => __('Repopulate Poller Cache'),
				'url'     => 'host.php?action=repopulate&host_id=' . $host['id'],
				'class'   => 'ti ti-hammer repopulateCache'
			],
			[
				'display' => __('View Poller Cache'),
				'url'     => 'utilities.php?poller_action=-1&action=view_poller_cache&host_id=' . $host['id'] . '&template_id=-1&filter=&rows=-1',
				'class'   => 'fa-solid fa-list-ul viewCache'
			],
			[
				'display' => __('View Data Source List'),
				'url'     => 'data_sources.php?reset=true&host_id=' . $host['id'] . '&ds_rows=30&filter=&template_id=-1&method_id=-1&page=1',
				'class'   => 'ti ti-brand-databricks viewSources'
			],
			[
				'display' => __('View Graphs List'),
				'url'     => 'graphs.php?reset=true&host_id=' . $host['id'] . '&graph_rows=30&filter=&template_id=-1&page=1',
				'class'   => 'ti ti-brand-databricks viewGraphs'
			],
		];
	}

	// process plugin links
	ob_start();

	/**
	 * Prototype - We will convert links into nice glyphs potentially
	 *
	 * <span class="linkMarker">*</span>
	 * <a
	 *   class="autocreate linkEditMain"
	 *   href="plugins/thold/thold.php?action=autocreate&host_id=99"
	 * >Auto-create Thresholds</a>
	 * <br>';
	 */
	api_plugin_hook('device_edit_top_links');

	$new_links = ob_get_clean();

	/**
	 * Now that we have anchors, let's add them to the
	 * filter array.
	 */
	if ($new_links != '') {
		$links = new DOMDocument();
		$links->loadHTML($new_links);
		$anchors = $links->getElementsByTagName('a');

		if (cacti_sizeof($anchors)) {
			foreach ($anchors as $a) {
				$name = $a->textContent;
				$href = $a->getAttribute('href');

				$filters['links'][] = [
					'display' => $name,
					'url'     => $href,
					'class'   => 'ti ti-plug'
				];
			}
		}
	}

	return $filters;
}

function host_edit() : void {
	global $fields_host_edit, $reindex_types;

	// ================= input validation =================
	gfrv('id');
	// ====================================================

	api_plugin_hook('host_edit_top');

	$header_label = __('Device [new]');

	$host = [];

	if (grv('id') > 0) {
		$host = db_fetch_row_prepared('SELECT *
			FROM host
			WHERE id = ?',
			[grv('id')]
		);

		if (cacti_sizeof($host)) {
			$header_label = __esc('Device [edit: %s]', $host['description']);
		}
	} else {
		$host['id']          = 0;
		$host['description'] = __('New Device');
	}

	if (cacti_sizeof($host)) {
		$content  = "<div class='pingRow'>";
		$content .= "<div id='ping_results'>" . __('Contacting Device') . "&nbsp;<i style='font-size:12px;' class='ti fa-spin ti-loader'></i></div>";
		$content .= '</div>';

		$filters = create_host_edit_filter($host, $content);

		$_SESSION['cur_device_id'] = grv('id');
	} else {
		$content = '';
		$filters = create_host_edit_filter($host, $content);

		$_SESSION['cur_device_id'] = 0;
	}

	// create the page filter
	$pageFilter = new CactiTableFilter($header_label, 'host.php', 'form_host', 'sess_host_edit', '', '', false);
	$pageFilter->set_filter_array($filters);
	$pageFilter->render();

	form_start('host.php', 'host_form');

	html_start_box('', '100%', true, 3, 'center', '');

	// preserve the host template id if passed in via a GET variable
	if (!ierv('host_template_id')) {
		$fields_host_edit['host_template_id']['value'] = gfrv('host_template_id');
	}

	draw_edit_form(
		[
			'config' => ['no_form_tag' => true],
			'fields' => inject_form_variables($fields_host_edit, $host)
		]
	);

	html_end_box(true, true);

	device_javascript($host['id'] > 0);

	if ($host['id'] > 0) {
		html_start_box(__('Associated Graph Templates'), '100%', false, 3, 'center', '');

		html_header(
			[
				['display' => __('Graph Template Name'), 'align' => 'left', 'nohide' => true],
				['display' => __('Status'), 'align' => 'left', 'nohide' => true]
			], 2, false
		);

		$selected_graph_templates = db_fetch_assoc_prepared('SELECT result.id, result.name, graph_local.id AS graph_local_id
			FROM (
				SELECT DISTINCT gt.id, gt.name
				FROM graph_templates AS gt
				INNER JOIN host_graph AS hg
				ON gt.id = hg.graph_template_id
				WHERE hg.host_id = ?
			) AS result
			LEFT JOIN graph_local
			ON graph_local.graph_template_id = result.id
			AND graph_local.host_id = ?
			ORDER BY result.name',
			[grv('id'), grv('id')]
		);

		$available_graph_templates = db_fetch_assoc_prepared('SELECT DISTINCT gt.id, gt.name
			FROM graph_templates AS gt
			LEFT JOIN snmp_query_graph AS sqg
			ON sqg.graph_template_id = gt.id
			INNER JOIN graph_templates_item AS gti
			ON gti.graph_template_id = gt.id
			INNER JOIN data_template_rrd AS dtr
			ON gti.task_item_id = dtr.id
			INNER JOIN data_template_data AS dtd
			ON dtd.data_template_id = dtr.data_template_id
			WHERE sqg.name IS NULL
			AND gti.local_graph_id = 0
			AND dtr.local_data_id = 0
			AND gt.id NOT IN (SELECT graph_template_id FROM host_graph WHERE host_id = ?)
			ORDER BY gt.name',
			[grv('id')]
		);

		$i                   = 0;
		$displayed_templates = [];

		if (cacti_sizeof($selected_graph_templates)) {
			foreach ($selected_graph_templates as $item) {
				if (isset($displayed_templates[$item['id']])) {
					continue;
				} else {
					$displayed_templates[$item['id']] = true;
				}

				$i++;

				form_alternate_row("gt$i", true);

				// get status information for this graph template
				$is_being_graphed = $item['graph_local_id'] > 0;
				?>
				<td class='nowrap' style="padding: 4px;">
					<strong><?php print $i; ?>)</strong> <?php print htmle($item['name']); ?>
				</td>
				<td class='nowrap'>
					<?php print(($is_being_graphed == true) ? "<span class='beingGraphed'>" . __('Is Being Graphed') . "</span> (<a class='linkEditMain' href='" . htmle('graphs.php?action=graph_edit&id=' . $item['graph_local_id']) . "'>" . __('Edit') . '</a>)' : "<span class='notBeingGraphed'>" . __('Not Being Graphed') . '</span>'); ?>
				</td>
				<td class='nowrap right'>
					<span title='<?php print __esc('Delete Graph Template Association'); ?>' class='deletequery ti ti-x' id='gtremove<?php print $item['id']; ?>' data-id='<?php print $item['id']; ?>'></span>
				</td>
		<?php

						form_end_row();
			}
		} else {
			print "<tr class='tableRow'><td colspan='3'><em>" . __('No associated graph templates.') . '</em></td></tr>';
		}

		?>
		<tr class='odd'>
			<td class='saveRow' colspan='3'>
				<table>
					<tr style='line-height:10px;'>
						<td class='nowrap templateAdd' style='padding-right:15px;'>
							<?php print __('Add Graph Template'); ?>
						</td>
						<td class='noHide'>
							<?php form_dropdown('graph_template_id', $available_graph_templates, 'name', 'id', '', '', ''); ?>
						</td>
						<td class='noHide'>
							<button type='button' class='ui-button ui-corner-all ui-widget' id='add_gt' title='<?php print __esc('Add Graph Template to Device'); ?>'><?php print __esc('Add'); ?></button>
						</td>
					</tr>
				</table>
			</td>
		</tr>

		<?php
		html_end_box();

		if ((isrv('display_dq_details')) && (isset($_SESSION['debug_log']['data_query']))) {
			$dbg_copy_uid = generate_hash();
			?>
			<div id='dqdebug' class='cactiTable'>
				<div class='cactiTableTitleRow' id='clipboardHeader<?php print $dbg_copy_uid; ?>'>
					<div class='cactiTableTitle'>
						<span style='padding:3px;'><?php print __('Data Query Debug Information'); ?></span>
					</div>
					<div class='cactiTableButton'>
						<span>
							<a class='linkCopyDark cactiTableCopy ti ti-copy' id='copyToClipboard<?php print $dbg_copy_uid; ?>' title='<?php print __('Copy All Data to Clipboard'); ?>'></a>
							<a id='dbghide' class='ti ti-trash' href='#' title='<?php print __('Remove Debug Output'); ?>'></a>
						</span>
					</div>
				</div>
				<table class='cactiTable' id='clipboardData<?php print $dbg_copy_uid; ?>'>
					<tr class='tableRow'>
						<td class='debug'>
							<span><?php print debug_log_return('data_query'); ?></span>
						</td>
					</tr>
				</table>
			</div>
			<?php
		}

		html_start_box(__('Associated Data Queries'), '100%', false, 3, 'center', '');

		html_header(
			[
				['display' => __('Data Query Name'), 'align' => 'left', 'nohide' => true],
				['display' => __('Re-Index Method'), 'align' => 'left', 'nohide' => true],
				['display' => __('Last Reindex'), 'align' => 'left'],
				['display' => __('Duration'), 'align' => 'left'],
				['display' => __('Status'), 'align' => 'left'],
				['display' => __('Actions'), 'align' => 'right']
			], 1, false
		);

		$sql_params2 = [];

		if ($host['snmp_version'] == 0) {
			$sql_where1 = ' AND snmp_query.data_input_id != 2';
			$sql_where2 = ' WHERE snmp_query.data_input_id != 2 AND';
		} else {
			$sql_where1 = '';
			$sql_where2 = ' WHERE';
		}

		$sql_where2 .= ' snmp_query.id NOT IN(SELECT snmp_query_id FROM host_snmp_query WHERE host_id = ?)';
		$sql_params2[] = grv('id');

		$selected_data_queries = db_fetch_assoc_prepared("SELECT snmp_query.id, host_snmp_query.reindex_last_runtime,
			ROUND(host_snmp_query.reindex_last_duration, 4) AS `reindex_last_duration`, snmp_query.name, host_snmp_query.reindex_method,
			IFNULL(`items`.`itemCount`, 0) AS itemCount, IFNULL(`rows`.`rowCount`, 0) AS rowCount
			FROM snmp_query
			INNER JOIN host_snmp_query
			ON snmp_query.id = host_snmp_query.snmp_query_id
			AND host_snmp_query.host_id = ?
			LEFT JOIN (
				SELECT snmp_query_id, COUNT(*) AS `itemCount`
				FROM host_snmp_cache
				WHERE host_id = ?
				GROUP BY snmp_query_id
			) AS `items`
			ON items.snmp_query_id = snmp_query.id
			LEFT JOIN (
				SELECT snmp_query_id, COUNT(DISTINCT snmp_index) AS `rowCount`
				FROM host_snmp_cache
				WHERE host_id = ?
				GROUP BY snmp_query_id
			) AS `rows`
			ON rows.snmp_query_id = snmp_query.id
			$sql_where1
			ORDER BY snmp_query.name",
			[grv('id'), grv('id'), grv('id')]
		);

		$available_data_queries = db_fetch_assoc_prepared("SELECT snmp_query.id, snmp_query.name
			FROM snmp_query
			$sql_where2
			ORDER BY snmp_query.name",
			$sql_params2);

		$i = 0;

		if (cacti_sizeof($selected_data_queries)) {
			foreach ($selected_data_queries as $item) {
				$i++;

				form_alternate_row("dg$i", true);

				$status = 'success';

				?>
				<td style='padding:4px;'>
					<strong><?php print $i; ?>)</strong> <?php print htmle($item['name']); ?>
				</td>
				<td class='nowrap'>
					<?php device_reindex_methods($item, $host); ?>
				</td>
				<td class='nowrap left'>
					<?php print $item['reindex_last_runtime']; ?>
				</td>
				<td class='nowrap left'>
					<?php print($item['reindex_last_duration'] == 0 ? '-' : __('%0.2f secs', $item['reindex_last_duration'])); ?>
				</td>
				<td>
					<?php print (($status == 'success') ? "<span class='success'>" . __('Success') . '</span>' : "<span class='failed'>" . __('Fail')) . '</span>' . __(' [%d Items, %d Rows]', $item['itemCount'], $item['rowCount']); ?>
				</td>
				<td class='nowrap right' style='vertical-align:middle;'>
					<span class='reloadquery ti ti-refresh' id='reload<?php print $item['id']; ?>' title='<?php print __esc('Reload Query'); ?>' data-id='<?php print $item['id']; ?>'></span>
					<span class='verbosequery ti ti-refresh' id='verbose<?php print $item['id']; ?>' title='<?php print __esc('Verbose Query'); ?>' data-id='<?php print $item['id']; ?>'></span>
					<span class='deletequery ti ti-x' id='remove<?php print $item['id']; ?>' title='<?php print __esc('Remove Query'); ?>' data-id='<?php print $item['id']; ?>'></span>
				</td>
		<?php
					form_end_row();
			}
		} else {
			print "<tr class='tableRow odd'><td colspan='6'><em>" . __('No Associated Data Queries.') . '</em></td></tr>';
		}

		if ($host['snmp_version'] == 0) {
			unset($reindex_types[1]);
			$default = 0;
		} else {
			$default = read_config_option('reindex_method');
		}

		?>
		<tr class='odd'>
			<td class='saveRow' colspan='6'>
				<table style='width:20%'>
					<tr style='line-height:10px;'>
						<td class='nowrap queryAdd' style='padding-right:15px;'>
							<?php print __('Add Data Query'); ?>
						</td>
						<td>
							<?php form_dropdown('snmp_query_id', $available_data_queries, 'name', 'id', '', '', ''); ?>
						</td>
						<td class='nowrap' style='padding-right:15px;'>
							<?php print __('Re-Index Method'); ?>
						</td>
						<td>
							<?php form_dropdown('reindex_method', $reindex_types, '', '', $default, '', ''); ?>
						</td>
						<td>
							<button type='button' class='ui-button ui-corner-all ui-widget' id='add_dq' title='<?php print __esc('Add Data Query to Device'); ?>'><?php print __esc('Add'); ?></button>
						</td>
					</tr>
				</table>
				<a style='display:none;' id='dqtop'></a>
			</td>
		</tr>

	<?php
		html_end_box();

		api_plugin_hook('device_edit_pre_bottom');
	}

	form_save_button('host.php', 'return');

	api_plugin_hook('host_edit_bottom');
}

function device_reindex_methods(array $item, array $host) : void {
	global $reindex_types, $reindex_types_tips;

	$selectedTheme = get_selected_theme();

	$i = 0;

	foreach ($reindex_types as $key => $type) {
		if ($i == 0) {
			print "<fieldset class='reindex_methods'>";
		}
		print "<input name='reindex_radio_" . $item['id'] . "' type='radio' data-device-id='" . $host['id'] . "' data-query-id='" . $item['id'] . "' data-reindex-method='" . $key . "' id='reindex_" . $item['id'] . '_' . $key . "'" . ($item['reindex_method'] == $key ? ' checked="checked"' : '') . ' />';
		print "<label title='" . htmle($reindex_types_tips[$key]) . "' for='reindex_" . $item['id'] . '_' . $key . "'>" . $type . '</label>';

		$i++;
	}

	print '</fieldset>';
}

function device_change_javascript() : void {
	?>
	<script type="text/javascript">
		function disableField(id) {
			$('#' + id).prop('disabled', true).addClass('ui-state-disabled');

			if (id == 'location') {
				$('#location_wrap').prop('disabled', true).addClass('ui-selectmenu-disabled ui-state-disabled');
			}

			if ($('#' + id).button('instance')) {
				$('#' + id).button('disable');
			} else if ($('#' + id).selectmenu('instance')) {
				$('#' + id).selectmenu('disable');
			}
		}

		function enableField(id) {
			$('#' + id).prop('disabled', false).removeClass('ui-state-disabled');

			if (id == 'location') {
				$('#location_wrap').prop('disabled', false).removeClass('ui-selectmenu-disabled ui-state-disabled');
			}

			if ($('#' + id).button('instance')) {
				$('#' + id).button('enable');
			} else if ($('#' + id).selectmenu('instance')) {
				$('#' + id).selectmenu('enable');
			}
		}

		$(function() {
			$('input[id^="t_"]').click(function() {
				id = $(this).attr('id').substring(2);
				if ($(this).is(':checked')) {
					enableField(id);
				} else {
					disableField(id);
				}
			});

			$('input[id^="t_"]').each(function() {
				id = $(this).attr('id').substring(2);
				disableField(id);
			});
		});
	</script>
	<?php

	api_plugin_hook('device_change_javascript');
}

function device_javascript(bool $hasHost = true) : void {
	?>
	<script type='text/javascript'>
		// default snmp information
		var snmp_community = $('#snmp_community').val();
		var snmp_username = $('#snmp_username').val();
		var snmp_password = $('#snmp_password').val();
		var snmp_auth_protocol = $('#snmp_auth_protocol').val();
		var snmp_priv_passphrase = $('#snmp_priv_passphrase').val();
		var snmp_priv_protocol = $('#snmp_priv_protocol').val();
		var snmp_context = $('#snmp_context').val();
		var snmp_engine_id = $('#snmp_engine_id').val();
		var snmp_port = $('#snmp_port').val();
		var snmp_timeout = $('#snmp_timeout').val();
		var max_oids = $('#max_oids').val();

		// default ping methods
		var ping_method = $('#ping_method').val();
		var ping_port = $('#ping_port').val();
		var ping_timeout = $('#ping_timeout').val();
		var ping_retries = $('#ping_retries').val();

		function changeHostForm() {
			setSNMP();
			setAvailability();
			setPing();
		}

		$(function() {
			// Need to set this for global snmpv3 functions to remain sane between edits
			snmp_security_initialized = false;

			$('#cdialog').remove();
			$('#main').append("<div id='cdialog' class='cdialog'></div>");

			$('.delete').click(function (event) {
				event.preventDefault();

				request = $(this).attr('href');
				$.get(request)
					.done(function(data) {
						$('#cdialog').html(data);

						applySkin();

						$('#cdialog').dialog({
							title: '<?php print __('Delete Item from Device Template'); ?>',
							close: function () { $('.delete').blur(); $('.selectable').removeClass('selected'); },
							minHeight: 80,
							minWidth: 500
						})
					})
					.fail(function(data) {
						getPresentHTTPError(data);
					});
			}).css('cursor', 'pointer');

			<?php if (!$hasHost) { ?>
			$('#row_created').hide();
			<?php } ?>
			if (typeof hostInfoHeight != 'undefined') {
				if ($(window).scrollTop() == 0) {
					$('.hostInfoHeader').css('height', '');
				} else {
					$('.hostInfoHeader').css('height', hostInfoHeight);
				}
			}

			if ($('#snmp_version').val() == '3') {
				if ($('#snmp_auth_protocol').val() == '[None]') {
					if ($('#snmp_priv_protocol').val() == '[None]') {
						$('#snmp_security_level').val('noAuthNoPriv');
						$('#snmp_priv_passphrase').val('');
						$('#snmp_priv_passphrase_confirm').val('');
						$('#snmp_password').val('');
						$('#snmp_password_confirm').val('');
					} else {
						$('#snmp_security_level').val('authNoPriv');
						$('#snmp_priv_passphrase').val('');
						$('#snmp_priv_passphrase_confirm').val('');
					}
				} else {
					$('#snmp_security_level').val('authPriv');
				}
			}

			if ($('#availability_method').val() != 7) {
				$('[id^="reload"]').click(function(data) {
					$(this).addClass('fa-spin');
					strURL = 'host.php?action=query_reload&id=' + $(this).attr('data-id') + '&host_id=' + $('#id').val();
					loadUrl({
						url: strURL,
						scroll: true,
						nostate: true
					});
				});

				$('[id^="verbose"]').click(function(data) {
					$(this).addClass('fa-spin');
					strURL = 'host.php?action=query_verbose&id=' + $(this).attr('data-id') + '&host_id=' + $('#id').val();
					loadUrl({
						url: strURL,
						scroll: true,
						nostate: true
					});
				});

				$('[id^="remove"]').click(function(data) {
					strURL = 'host.php?action=query_remove&id=' + $(this).attr('data-id') + '&host_id=' + $('#id').val();
					loadUrl({
						url: strURL,
						scroll: true,
						nostate: true
					});
				});

				$('[id^="gtremove"]').click(function(data) {
					strURL = 'host.php?action=gt_remove&id=' + $(this).attr('data-id') + '&host_id=' + $('#id').val();
					loadUrl({
						url: strURL,
						scroll: true,
						nostate: true
					});
				});

				$('#add_dq').click(function() {
					var options = {
						url: 'host.php?action=query_add',
						scrollTop: $(window).scrollTop()
					}

					var data = {
						host_id: $('#id').val(),
						snmp_query_id: $('#snmp_query_id').val(),
						reindex_method: $('#reindex_method').val(),
						__csrf_magic: csrfMagicToken
					}

					postUrl(options, data);
				});

				$('#add_gt').click(function() {
					var options = {
						url: 'host.php?action=gt_add',
						scrollTop: $(window).scrollTop()
					}

					var data = {
						host_id: $('#id').val(),
						graph_template_id: $('#graph_template_id').val(),
						__csrf_magic: csrfMagicToken
					}

					postUrl(options, data);
				});

				$('input[id^="reindex_"]').change(function() {
					strURL = urlPath + 'host.php?action=query_change';
					strURL += '&host_id=' + $(this).attr('data-device-id');
					strURL += '&data_query_id=' + $(this).attr('data-query-id');
					strURL += '&reindex_method=' + $(this).attr('data-reindex-method');

					height = $('.hostInfoHeader').height();

					loadUrl({
						url: strURL,
						noState: true,
						scroll: true
					})

					$('.hostInfoHeader').css('height', height);
				});
			} else {
				$('#add_gt, #add_dq').button('disable');
			}

			changeHostForm();
			$('#dbghide').click(function(data) {
				$('#dqdebug').empty().fadeOut('fast');
			});

			if ($('#dbghide').length) {
				var dbgloc = parseInt($('#dbghide').offset().top - $('.breadCrumbBar').outerHeight() - $('.cactiPageHead').outerHeight());
				$('.cactiConsoleContentArea').scrollTop(dbgloc);
			}

			$('[id$="spacer"]').click(function() {
				changeHostForm();
			});

			$('#snmp_version').change(function() {
				setAvailability();
				setPing();
			});

			$('#location_input').keyup(function() {
				$('#location').val($('#location_input').val());
			}).mouseup(function() {
				$('#location').val($('#location_input').val());
			});

			//ToDo: Load URL breaks dropdown's on the host page

			if ($('#id').val() > 0) {
				$.get(urlPath + 'host.php?action=ping_host&id=' + $('#id').val(), function(data) {
					$('#ping_results').html(data);
					hostInfoHeight = $('.hostInfoHeader').height();
				});
			} else {
					$('#ping_results').html('<?php print __('Device Status will appear once created'); ?>');
			}
		});

		function ping_results_finalize(options, html) {
			hostInfoHeight = $('.hostInfoHeader').height();
		}
	</script>
	<?php
}

function get_device_records(int &$total_rows, int $rows) : mixed {
	$sql_where     = '';
	$sql_params    = [];
	$maint_devices = [];

	// form the 'where' clause for our main sql query
	if (grv('filter') != '') {
		$sql_where = 'WHERE (deleted = ""
			AND (host.hostname LIKE ?
				OR host.description LIKE ?
				OR host.notes LIKE ?
				OR s.name LIKE ?
				OR host.external_id LIKE ?
				OR host.id = ?))';

		$sql_params[] = '%' . grv('filter') . '%';
		$sql_params[] = '%' . grv('filter') . '%';
		$sql_params[] = '%' . grv('filter') . '%';
		$sql_params[] = '%' . grv('filter') . '%';
		$sql_params[] = '%' . grv('filter') . '%';
		$sql_params[] = '%' . grv('filter') . '%';
	} else {
		$sql_where = "WHERE deleted = ''";
	}

	if (grv('location') == '' || grv('location') == '0') {
		$sql_where .= ($sql_where != '' ? ' AND' : ' WHERE') . ' IFNULL(host.location,"") = ""';
	} elseif (grv('location') != '-1') {
		$sql_where .= ($sql_where != '' ? ' AND' : ' WHERE') . ' host.location = ?';
		$sql_params[] = grv('location');
	}

	if (db_column_exists('sites', 'disabled')) {
		$host_where_disabled = "(IFNULL(TRIM(s.disabled), '') = 'on' OR IFNULL(TRIM(host.disabled),'') = 'on')";
	} else {
		$host_where_disabled = "(IFNULL(TRIM(host.disabled), '') = 'on')";
	}

	$status = grv('host_status');

	if (api_plugin_is_enabled('maint')) {
		$maint_devices = get_maint_hosts();
	}

	if ($status == '-2') {
		$sql_where .= ($sql_where === '' ? ' WHERE ' : ' AND ') . "$host_where_disabled";
	} elseif ($status == '-3') {
		$sql_where .= ($sql_where === '' ? ' WHERE ' : ' AND ') . "NOT $host_where_disabled";
	} elseif ($status == '-4') {
		if (db_column_exists('host', 'thold_failure_count')) {
			$sql_where .= ($sql_where === '' ? ' WHERE ' : ' AND ') .
				"(host.status != '3' OR $host_where_disabled OR (host.status != 2
					AND thold_failure_count > 0
					AND status_event_count >= thold_failure_count))";
		} else {
			$sql_where .= ($sql_where === '' ? ' WHERE ' : ' AND ') . " (host.status != '3' OR host.disabled = 'on')";
		}
	} elseif ($status == -5 && api_plugin_is_enabled('maint')) {
		if (cacti_sizeof($maint_devices)) {
			$sql_where .= ($sql_where === '' ? ' WHERE ' : ' AND ') . 'host.id in (' . implode(',', $maint_devices) . ')';
		}
	} elseif ($status != '-1') {
		if (db_column_exists('host', 'thold_failure_count')) {
			$sql_where .= ($sql_where === '' ? ' WHERE ' : ' AND ') .
				"(host.status = ? OR (status != 2
					AND thold_failure_count > 0
					AND status_event_count >= thold_failure_count)
					AND NOT $host_where_disabled)"; // @phpstan-ignore-line

			$sql_params[] = $status;
		} else {
			$sql_where .= ($sql_where === '' ? ' WHERE ' : ' AND ') . "(host.status = ? AND NOT $host_where_disabled)";

			$sql_params[] = $status;
		}
	}

	if (grv('availability_method') != '-1') {
		$sql_where .= ($sql_where === '' ? ' WHERE ' : ' AND ') . 'host.availability_method = ?';
		$sql_params[] = grv('availability_method');
	}

	if (grv('host_template_id') == 0) {
		$sql_where .= ($sql_where != '' ? ' AND ' : 'WHERE ') . ' host.host_template_id = 0';
	} elseif (grv('host_template_id') > 0) {
		$sql_where .= ($sql_where != '' ? ' AND ' : 'WHERE ') . 'host.host_template_id = ?';
		$sql_params[] = grv('host_template_id');
	}

	if (grv('site_id') == '0') {
		$sql_where .= ($sql_where != '' ? ' AND ' : 'WHERE ') . 'host.site_id = 0';
	} elseif (grv('site_id') > '0') {
		$sql_where .= ($sql_where != '' ? ' AND ' : 'WHERE ') . 'host.site_id = ?';
		$sql_params[] = grv('site_id');
	}

	if (grv('poller_id') != '-1') {
		$sql_where .= ($sql_where != '' ? ' AND ' : 'WHERE ') . ' host.poller_id = ?';
		$sql_params[] = grv('poller_id');
	}

	$sql_where = api_plugin_hook_function('device_sql_where', $sql_where);

	$sql = "SELECT COUNT(host.id)
		FROM host
		LEFT JOIN sites s
		ON s.id = host.site_id
		$sql_where";

	$total_rows = get_total_row_data($_SESSION[SESS_USER_ID], $sql, $sql_params, 'device');

	$poller_interval = read_config_option('poller_interval');

	$sql_order = get_order_string();
	$sql_limit = 'LIMIT ' . ($rows * (grv('page') - 1)) . ',' . $rows;

	$sql_query = "SELECT host.*,
		CAST(IF(availability_method = 0, '0',
			IF(status_event_count > 0 AND status IN (1, 2), status_event_count*$poller_interval,
			IF(UNIX_TIMESTAMP(status_rec_date) < 943916400 AND status IN (0, 3), total_polls*$poller_interval,
			IF(UNIX_TIMESTAMP(status_rec_date) > 943916400, UNIX_TIMESTAMP() - UNIX_TIMESTAMP(status_rec_date),
			IF(snmp_sysUptimeInstance>0 AND snmp_version > 0, snmp_sysUptimeInstance/100, UNIX_TIMESTAMP()
		))))) AS unsigned) AS instate, " .
		(cacti_sizeof($maint_devices) > 0 ? 'IF(host.id in(' . implode(',', $maint_devices) . '), 1,0) as maint, ' : '0 as maint, ') .
		"s.name as site_name,
		s.disabled as site_disabled
		FROM host
		LEFT JOIN sites AS s
		ON host.site_id = s.id
		$sql_where
		$sql_order
		$sql_limit";

	return db_fetch_assoc_prepared($sql_query, $sql_params);
}

function host() : void {
	global $actions, $item_rows, $availability_options;

	draw_hosts_filter(true);

	// if the number of rows is -1, set it to the default
	if (grv('rows') == -1) {
		$rows = read_config_option('num_rows_table');
	} else {
		$rows = grv('rows');
	}

	$display_text = [
		'description' => [
			'display' => __('Device Description'),
			'align'   => 'left',
			'sort'    => 'ASC',
			'tip'     => __('The name by which this Device will be referred to.')
		],
		'hostname' => [
			'display' => __('Hostname'),
			'align'   => 'left',
			'sort'    => 'ASC',
			'tip'     => __('Either an IP address, or hostname.  If a hostname, it must be resolvable by either DNS, or from your hosts file.')
		],
		'id' => [
			'display' => __('ID'),
			'align'   => 'right',
			'sort'    => 'ASC',
			'tip'     => __('The internal database ID for this Device.  Useful when performing automation or debugging.')
		],
		'device_threads' => [
			'display' => __('Threads'),
			'align'   => 'right',
			'sort'    => 'ASC',
			'tip'     => __('The number of threads to use to collect information for this Device.  Applies to spine only.')
		],
		'graphs' => [
			'display' => __('Graphs'),
			'align'   => 'right',
			'sort'    => 'DESC',
			'tip'     => __('The total number of Graphs generated from this Device.')
		],
		'data_sources' => [
			'display' => __('Data Sources'),
			'align'   => 'right',
			'sort'    => 'DESC',
			'tip'     => __('The total number of Data Sources generated from this Device.')
		],
		'current_errors' => [
			'display' => __('Errors'),
			'align'   => 'right',
			'sort'    => 'DESC',
			'tip'     => __('The total number current data collection errors on this Device.  Enable Device Debug to track them.')
		],
		'status' => [
			'display' => __('Status'),
			'align'   => 'center',
			'sort'    => 'ASC',
			'tip'     => __('The monitoring status of the Device based upon ping results.  If this Device is a special type Device, by using the hostname "localhost", or due to the setting to not perform an Availability Check, it will always remain Up.  When using cmd.php data collector, a Device with no Graphs, is not pinged by the data collector and will remain in an "Unknown" state.')
		],
		'site_name' => [
			'display' => __('Site'),
			'align'   => 'left',
			'sort'    => 'ASC',
			'tip'     => __('The site associated to this Device'),
		],
		'availability_method' => [
			'display' => __('Service Check'),
			'align'   => 'right',
			'sort'    => 'ASC',
			'tip'     => __('The Availability/Reachability method used to communicate with the device.  In some cases, the Availability/Reachability method will be \'none\', which is not uncommon for some devices'),
		],
		'instate' => [
			'display' => __('In State'),
			'align'   => 'right',
			'sort'    => 'ASC',
			'tip'     => __('The amount of time that this Device has been in its current state.')
		],
		'snmp_sysUpTimeInstance' => [
			'display' => __('Uptime'),
			'align'   => 'right',
			'sort'    => 'ASC',
			'tip'     => __('The current amount of time that the host has been up.')
		],
		'polling_time' => [
			'display' => __('Poll Time'),
			'align'   => 'right',
			'sort'    => 'DESC',
			'tip'     => __('The amount of time it takes to collect data from this Device.')
		],
		'cur_time' => [
			'display' => __('Current (ms)'),
			'align'   => 'right',
			'sort'    => 'DESC',
			'tip'     => __('The current ping time in milliseconds to reach the Device.')
		],
		'avg_time' => [
			'display' => __('Average (ms)'),
			'align'   => 'right',
			'sort'    => 'DESC',
			'tip'     => __('The average ping time in milliseconds to reach the Device since the counters were cleared for this Device.')
		],
		'availability' => [
			'display' => __('Availability'),
			'align'   => 'right',
			'sort'    => 'ASC',
			'tip'     => __('The availability percentage based upon ping results since the counters were cleared for this Device.')
		],
		'created' => [
			'display' => __('Create Date'),
			'align'   => 'right',
			'sort'    => 'ASC',
			'tip'     => __('The Date that the Device was added to Cacti.')
		]
	];

	$display_text_size = sizeof($display_text);
	$display_text      = api_plugin_hook_function('device_display_text', $display_text);
	$total_rows        = 0;

	$hosts = get_device_records($total_rows, $rows);

	$nav = html_nav_bar('host.php?filter=' . grv('filter'), MAX_DISPLAY_PAGES, grv('page'), $rows, $total_rows, cacti_sizeof($display_text) + 1, __('Devices'), 'page', 'main');

	form_start('host.php', 'chk');

	print $nav;

	html_start_box('', '100%', false, 3, 'center', '');

	html_header_sort_checkbox($display_text, grv('sort_column'), grv('sort_direction'), false);

	if (sizeof($display_text) != $display_text_size && cacti_sizeof($hosts)) { // display_text changed
		api_plugin_hook_function('device_table_replace', $hosts);
	} elseif (cacti_sizeof($hosts)) {
		foreach ($hosts as $host) {
			$disabled = ($host['disabled'] == 'on');

			if (isset($host['thold_failure_count'])) {
				$host_status = get_colored_device_status($disabled, $host['status'], $host['thold_failure_count'], $host['status_event_count']);
			} else {
				$host_status = get_colored_device_status($disabled, $host['status']);
			}

			if ($host['disabled'] == '' &&
				($host['status'] == HOST_RECOVERING || $host['status'] == HOST_UP) &&
				($host['availability_method'] != AVAIL_NONE && $host['availability_method'] != AVAIL_PING)
			) {
				$uptime    = get_uptime($host);
			} else {
				$uptime    = __('N/A');
			}

			$sites_url       = CACTI_PATH_URL . 'host.php?site_id=' . $host['site_id'];
			$graphs_url      = CACTI_PATH_URL . 'graphs.php?reset=1&host_id=' . $host['id'];
			$data_source_url = CACTI_PATH_URL . 'data_sources.php?reset=1&host_id=' . $host['id'];
			$errors_url      = CACTI_PATH_URL . 'data_sources.php?reset=1&errored=true&host_id=' . $host['id'];

			if (empty($host['graphs'])) {
				$host['graphs'] = 0;
			}

			if (empty($host['data_sources'])) {
				$host['data_sources'] = 0;
			}

			if (empty($host['current_errors'])) {
				$host['current_errors'] = 0;
			}

			form_alternate_row('line' . $host['id'], true);

			$maint = ($host['maint'] == 1 ? '<i class="ti ti-tool" title="' . __('Maintenance') . '"></i>' : '');

			form_selectable_cell(filter_value($host['description'], grv('filter'), 'host.php?action=edit&id=' . $host['id']) . $maint, $host['id']);
			form_selectable_cell(filter_value($host['hostname'], grv('filter')), $host['id']);
			form_selectable_cell(filter_value($host['id'], grv('filter')), $host['id'], '', 'right');
			form_selectable_cell($host['device_threads'], $host['id'], '', 'right');

			form_selectable_cell(filter_value(number_format_i18n($host['graphs'], -1), '', $graphs_url), $host['id'], '', 'right');

			form_selectable_cell(filter_value(number_format_i18n($host['data_sources'], -1), '', $data_source_url), $host['id'], '', 'right');

			form_selectable_cell(filter_value(number_format_i18n($host['current_errors'], -1), '', $errors_url), $host['id'], '', 'right');

			form_selectable_cell($host_status, $host['id'], '', 'center');

			if ($host['site_disabled'] == 'on') {
				$class = 'deviceDisabled';
			} else {
				$class = 'deviceUp';
			}

			form_selectable_cell(filter_value($host['site_name'], '', $sites_url), $host['id'], '', $class);

			form_selectable_cell($availability_options[$host['availability_method']], $host['id'], '', 'right');

			form_selectable_cell(get_timeinstate($host), $host['id'], '', 'right');

			if ($host['availability_method'] != AVAIL_STREAM) {
				form_selectable_cell($uptime, $host['id'], '', 'right');
				form_selectable_cell(round($host['polling_time'], 2), $host['id'], '', 'right');
				form_selectable_cell(round(($host['cur_time']), 2), $host['id'], '', 'right');
				form_selectable_cell(round(($host['avg_time']), 2), $host['id'], '', 'right');
				form_selectable_cell(round($host['availability'], 2) . ' %', $host['id'], '', 'right');
			} else {
				form_selectable_cell(__('N/A'), $host['id'], '', 'right');
				form_selectable_cell(__('N/A'), $host['id'], '', 'right');
				form_selectable_cell(__('N/A'), $host['id'], '', 'right');
				form_selectable_cell(__('N/A'), $host['id'], '', 'right');
				form_selectable_cell(__('N/A'), $host['id'], '', 'right');
			}

			form_selectable_cell($host['created'] == '' ? __('Unknown') : substr($host['created'], 0, 10), $host['id'], '', 'right');
			form_checkbox_cell($host['description'], $host['id']);
			form_end_row();
		}
	} else {
		print "<tr class='tableRow odd'><td colspan='" . (cacti_sizeof($display_text) + 1) . "'><em>" . __('No Devices Found') . '</em></td></tr>';
	}

	html_end_box(false);

	if (cacti_sizeof($hosts)) {
		print $nav;
	}

	// add a list of tree names to the actions dropdown
	add_tree_names_to_actions_array();

	// draw the dropdown containing a list of available actions for this form
	draw_actions_dropdown($actions);

	form_end();

	api_plugin_hook('device_table_bottom');
}

function create_hosts_filter() : array {
	global $item_rows, $availability_options;

	$all     = ['-1' => __('All')];
	$any     = ['-1' => __('Any')];
	$none    = ['0'  => __('None')];

	$sites   = array_rekey(
		db_fetch_assoc('SELECT id, name
			FROM sites
			ORDER BY name'),
		'id', 'name'
	);
	$sites   = $any + $none + $sites;

	$status = [
		'-1' => __('Any'),
		'-3' => __('Enabled'),
		'-2' => __('Disabled'),
		'-4' => __('Not Up'),
		'3'  => __('Up'),
		'1'  => __('Down'),
		'2'  => __('Recovering'),
		'0'  => __('Unknown'),
	];

	if (api_plugin_is_enabled('maint')) {
		$status[-5] = __('Maintenance');
	}

	if (gfrv('site_id') > 0) {
		$sql_where    = 'AND site_id = ?';
		$sql_params[] = grv('site_id');
	} else {
		$sql_where  = '';
		$sql_params = [];
	}

	$locations = array_rekey(
		db_fetch_assoc_prepared("SELECT DISTINCT location
			FROM host
			WHERE location != ''
			$sql_where
			ORDER BY location",
			$sql_params),
		'location', 'location'
	);
	$locations = $any + $none + $locations;

	$pollers = array_rekey(
		db_fetch_assoc('SELECT p.id, p.name
			FROM poller AS p
			INNER JOIN host AS h
			ON h.poller_id = p.id
			ORDER BY p.name'),
		'id', 'name'
	);
	$pollers = $any + $pollers;

	$sql_where  = '';
	$sql_params = [];

	if (gfrv('host_template_id') > 0) {
		$sql_where    = 'WHERE host_template_id = ?';
		$sql_params[] = grv('host_template_id');
	}

	$options = array_rekey(
		db_fetch_assoc_prepared("SELECT DISTINCT availability_method AS id
			FROM host $sql_where",
			$sql_params),
		'id', 'id'
	);

	$checks = [];

	if (cacti_sizeof($options)) {
		foreach ($options as $option) {
			$checks[$option] = $availability_options[$option];
		}
	}

	$checks = $any + $checks;

	$templates = array_rekey(
		db_fetch_assoc('SELECT DISTINCT ht.id, ht.name
			FROM host_template ht
			JOIN host h ON h.host_template_id = ht.id
			ORDER BY ht.name'),
		'id', 'name'
	);

	$templates = $any + $none + $templates;

	return [
		'rows' => [
			[
				'site_id' => [
					'method'        => 'drop_array',
					'friendly_name' => __('Site'),
					'filter'        => FILTER_VALIDATE_INT,
					'default'       => '-1',
					'pageset'       => true,
					'array'         => $sites,
					'value'         => '-1'
				],
				'poller_id' => [
					'method'        => 'drop_array',
					'friendly_name' => __('Data Collector'),
					'filter'        => FILTER_VALIDATE_INT,
					'default'       => '-1',
					'pageset'       => true,
					'array'         => $pollers,
					'value'         => '-1'
				],
				'host_template_id' => [
					'method'        => 'drop_array',
					'friendly_name' => __('Template'),
					'filter'        => FILTER_VALIDATE_INT,
					'default'       => '-1',
					'pageset'       => true,
					'array'         => $templates,
					'value'         => '-1'
				],
				'location' => [
					'method'         => 'drop_array',
					'friendly_name'  => __('Location'),
					'filter'         => FILTER_CALLBACK,
					'filter_options' => ['options' => 'sanitize_search_string'],
					'default'        => '-1',
					'pageset'        => true,
					'array'          => $locations,
					'value'          => '-1'
				]
			],
			[
				'filter' => [
					'method'         => 'textbox',
					'friendly_name'  => __('Search'),
					'filter'         => FILTER_DEFAULT,
					'placeholder'    => __('Enter a search term'),
					'size'           => '30',
					'default'        => '',
					'pageset'        => true,
					'max_length'     => '120',
					'value'          => ''
				],
				'host_status' => [
					'method'        => 'drop_array',
					'friendly_name' => __('Status'),
					'filter'        => FILTER_VALIDATE_INT,
					'default'       => '-1',
					'pageset'       => true,
					'array'         => $status,
					'value'         => '-1'
				],
				'availability_method' => [
					'method'        => 'drop_array',
					'friendly_name' => __('Service Check'),
					'filter'        => FILTER_VALIDATE_INT,
					'default'       => '-1',
					'pageset'       => true,
					'array'         => $checks,
					'value'         => '-1'
				],
				'rows' => [
					'method'        => 'drop_array',
					'friendly_name' => __('Devices'),
					'filter'        => FILTER_VALIDATE_INT,
					'default'       => '-1',
					'pageset'       => true,
					'array'         => $item_rows,
					'value'         => '-1'
				]
			]
		],
		'buttons' => [
			'go' => [
				'method'  => 'submit',
				'display' => __('Go'),
				'title'   => __('Apply filter to table'),
			],
			'clear' => [
				'method'  => 'button',
				'display' => __('Clear'),
				'title'   => __('Reset filter to default values'),
			],
			'export' => [
				'method'   => 'button',
				'display'  => __('Export'),
				'title'    => __('Export the filtered Devices'),
				'callback' => 'document.location = \'host.php?action=export\''
			]
		],
		'sort' => [
			'sort_column'    => 'description',
			'sort_direction' => 'DESC'
		]
	];
}

function draw_hosts_filter(bool $render = false) : void {
	// grab sanifization for plugins
	$hfilters    = [];
	$hfilters    = api_plugin_hook_function('device_filters', $hfilters);

	if (cacti_sizeof($hfilters)) {
		foreach ($hfilters as $id => $filter) {
			if (!isset($filter['method'])) {
				$hfilters[$id]['method'] = 'validate';
			}
		}
	}

	$filters = create_hosts_filter();

	if (grv('host_template_id') > 0) {
		$url = 'host.php?action=edit&host_template_id=' . grv('host_template_id');
	} else {
		$url = 'host.php?action=edit';
	}

	// create the page filter
	$pageFilter             = new CactiTableFilter(__('Devices'), 'host.php', 'form_devices', 'sess_host', $url);
	$pageFilter->rows_label = __('Devices');
	$pageFilter->set_filter_array($filters);

	// add sinitization logic for plugins
	if (cacti_sizeof($hfilters)) {
		foreach ($hfilters as $id => $filter) {
			$pageFilter->add_row_element(0, $id, $filter);
		}
	}

	if ($render) {
		$pageFilter->render();
	} else {
		$pageFilter->sanitize();
	}
}

function get_maint_hosts() : array {
	$maint_devices = [];
	$t             = time();
	$schedules     = [];

	$all_sch = db_fetch_assoc("SELECT *
		FROM plugin_maint_schedules
		WHERE enabled = 'on'");

	if (cacti_sizeof($all_sch)) {
		foreach ($all_sch as $sch) {
			if ($sch['mtype'] == 1 && ($t > $sch['stime'] && $t < $sch['etime'])) {
				$schedules[] = $sch['id'];
			}

			if ($sch['mtype'] == 2) {
				if ($sch['etime'] < $t) {
					/* convert start and end to local so that hour stays same for
					add days across daylight saving time change */
					$starttimelocal = (new DateTime('@' . strval($sch['stime'])))->setTimezone(new DateTimeZone(date_default_timezone_get()));
					$endtimelocal   = (new DateTime('@' . strval($sch['etime'])))->setTimezone(new DateTimeZone(date_default_timezone_get()));
					$nowtime        = new DateTime();
					// add interval days
					$addday = new DateInterval('P' . strval($sch['minterval'] / 86400) . 'D');

					while ($endtimelocal < $nowtime) {
						$starttimelocal = $starttimelocal->add($addday);
						$endtimelocal   = $endtimelocal->add($addday);
					}

					$sch['stime'] = $starttimelocal->getTimestamp();
					$sch['etime'] = $endtimelocal->getTimestamp();
				}

				if ($t > $sch['stime'] && $t < $sch['etime']) {
					$schedules[] = $sch['id'];
				}
			}
		}

		if (cacti_sizeof($schedules)) {
			$maint_devices = db_fetch_row('SELECT host
				FROM plugin_maint_hosts
				WHERE type = 1 AND
				schedule in (' . implode(',', $schedules) . ')');
		}
	}

	return $maint_devices;
}