Project

General

Profile

Download (5.17 KB) Statistics
| Branch: | Tag: | Revision:
1
<?php
2
/*
3
 * diag_traceroute.php
4
 *
5
 * part of pfSense (https://www.pfsense.org)
6
 * Copyright (c) 2004-2016 Rubicon Communications, LLC (Netgate)
7
 * Copyright (c) 2005 Paul Taylor (paultaylor@winndixie.com)
8
 * All rights reserved.
9
 *
10
 * originally based on m0n0wall (http://m0n0.ch/wall)
11
 * Copyright (c) 2003-2004 Manuel Kasper <mk@neon1.net>.
12
 * All rights reserved.
13
 *
14
 * Licensed under the Apache License, Version 2.0 (the "License");
15
 * you may not use this file except in compliance with the License.
16
 * You may obtain a copy of the License at
17
 *
18
 * http://www.apache.org/licenses/LICENSE-2.0
19
 *
20
 * Unless required by applicable law or agreed to in writing, software
21
 * distributed under the License is distributed on an "AS IS" BASIS,
22
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
23
 * See the License for the specific language governing permissions and
24
 * limitations under the License.
25
 */
26

    
27
##|+PRIV
28
##|*IDENT=page-diagnostics-traceroute
29
##|*NAME=Diagnostics: Traceroute
30
##|*DESCR=Allow access to the 'Diagnostics: Traceroute' page.
31
##|*MATCH=diag_traceroute.php*
32
##|-PRIV
33

    
34
require_once("guiconfig.inc");
35

    
36
$allowautocomplete = true;
37
$pgtitle = array(gettext("Diagnostics"), gettext("Traceroute"));
38
include("head.inc");
39

    
40
/* Max TTL of both traceroute and traceroute6 is 255, but in practice more than
41
   64 hops would most likely time out in the GUI. If a user requires a
42
   traceroute that long, they can use the CLI. */
43
define('MAX_TTL', 64);
44
define('DEFAULT_TTL', 18);
45

    
46
// Set defaults in case they are not supplied.
47
$do_traceroute = false;
48
$host = '';
49
$ttl = DEFAULT_TTL;
50
$ipproto = 'ipv4';
51
$sourceip = 'any';
52

    
53
if ($_POST || $_REQUEST['host']) {
54
	unset($input_errors);
55

    
56
	/* input validation */
57
	$reqdfields = explode(" ", "host ttl");
58
	$reqdfieldsn = array(gettext("Host"), gettext("ttl"));
59
	do_input_validation($_REQUEST, $reqdfields, $reqdfieldsn, $input_errors);
60

    
61
	if (($_REQUEST['ttl'] < 1) || ($_REQUEST['ttl'] > MAX_TTL)) {
62
		$input_errors[] = sprintf(gettext("Maximum number of hops must be between 1 and %s"), MAX_TTL);
63
	}
64
	$host = trim($_REQUEST['host']);
65
	$ipproto = $_REQUEST['ipproto'];
66
	if (($ipproto == "ipv4") && is_ipaddrv6($host)) {
67
		$input_errors[] = gettext("When using IPv4, the target host must be an IPv4 address or hostname.");
68
	}
69
	if (($ipproto == "ipv6") && is_ipaddrv4($host)) {
70
		$input_errors[] = gettext("When using IPv6, the target host must be an IPv6 address or hostname.");
71
	}
72

    
73
	$sourceip = $_REQUEST['sourceip'];
74
	$ttl = $_REQUEST['ttl'];
75
	$resolve = $_REQUEST['resolve'];
76
	$useicmp = $_REQUEST['useicmp'];
77

    
78
	if ($_POST && !$input_errors) {
79
		$do_traceroute = true;
80
	}
81

    
82
} else {
83
	$resolve = false;
84
	$useicmp = false;
85
}
86

    
87
if ($input_errors) {
88
	print_input_errors($input_errors);
89
}
90

    
91
/* Do the traceroute and show any error */
92
if ($do_traceroute) {
93
	$useicmpparam = isset($useicmp) ? "-I" : "";
94
	$n = isset($resolve) ? "" : "-n";
95

    
96
	$command = "/usr/sbin/traceroute";
97
	if ($ipproto == "ipv6") {
98
		$command .= "6";
99
		if (empty($n)) {
100
			$n = "-l";
101
		}
102
		$ifaddr = is_ipaddr($sourceip) ? $sourceip : get_interface_ipv6($sourceip);
103
	} else {
104
		$ifaddr = is_ipaddr($sourceip) ? $sourceip : get_interface_ip($sourceip);
105
	}
106

    
107
	if ($ifaddr && (is_ipaddr($host) || is_hostname($host))) {
108
		$srcip = "-s " . escapeshellarg($ifaddr);
109
	}
110

    
111
	$cmd = "{$command} {$n} {$srcip} -w 2 {$useicmpparam} -m " . escapeshellarg($ttl) . " " . escapeshellarg($host);
112
	$result = shell_exec($cmd);
113

    
114
	if (!$result) {
115
		print_info_box(sprintf(gettext('Error: %s could not be traced/resolved'), $host));
116
	}
117
}
118

    
119
$form = new Form(false);
120

    
121
$section = new Form_Section('Traceroute');
122

    
123
$section->addInput(new Form_Input(
124
	'host',
125
	'*Hostname',
126
	'text',
127
	$host,
128
	['placeholder' => 'Hostname to trace.']
129
));
130

    
131
$section->addInput(new Form_Select(
132
	'ipproto',
133
	'*IP Protocol',
134
	$ipproto,
135
	array('ipv4' => 'IPv4', 'ipv6' => 'IPv6')
136
))->setHelp('Select the protocol to use.');
137

    
138
$section->addInput(new Form_Select(
139
	'sourceip',
140
	'*Source Address',
141
	$sourceip,
142
	array('any' => gettext('Any')) + get_possible_traffic_source_addresses(true)
143
))->setHelp('Select source address for the trace.');
144

    
145
$section->addInput(new Form_Select(
146
	'ttl',
147
	'Maximum number of hops',
148
	$ttl,
149
	array_combine(range(1, MAX_TTL), range(1, MAX_TTL))
150
))->setHelp('Select the maximum number of network hops to trace.');
151

    
152
$section->addInput(new Form_Checkbox(
153
	'resolve',
154
	'Reverse Address Lookup',
155
	'',
156
	$resolve
157
))->setHelp('When checked, traceroute will attempt to perform a PTR lookup to locate hostnames for hops along the path. This will slow down the process as it has to wait for DNS replies.');
158

    
159
$section->addInput(new Form_Checkbox(
160
	'useicmp',
161
	gettext("Use ICMP"),
162
	'',
163
	$useicmp
164
))->setHelp('By default, traceroute uses UDP but that may be blocked by some routers. Check this box to use ICMP instead, which may succeed. ');
165

    
166
$form->add($section);
167

    
168
$form->addGlobal(new Form_Button(
169
	'Submit',
170
	'Traceroute',
171
	null,
172
	'fa-rss'
173
))->addClass('btn-primary');
174

    
175
print $form;
176

    
177
/* Show the traceroute results */
178
if ($do_traceroute && $result) {
179
?>
180
	<div class="panel panel-default">
181
		<div class="panel-heading"><h2 class="panel-title"><?=gettext('Results')?></h2></div>
182
		<div class="panel-body">
183
<?php
184
	print('<pre>' . $result . '</pre>');
185
?>
186
		</div>
187
	</div>
188
<?php
189
}
190

    
191
include("foot.inc");
192
?>
(31-31/223)