summaryrefslogtreecommitdiffstats
path: root/usr
diff options
context:
space:
mode:
authorScott Ullrich <sullrich@pfsense.org>2007-01-19 03:52:07 +0000
committerScott Ullrich <sullrich@pfsense.org>2007-01-19 03:52:07 +0000
commitab6a5cfc9e028bce3e784b42737937a386f1337a (patch)
tree757c9558438842e884d2c37f1438fc440510c5f0 /usr
parent20112c27736e0567464d65acc450ca5fd559aa85 (diff)
downloadpfsense-ab6a5cfc9e028bce3e784b42737937a386f1337a.zip
pfsense-ab6a5cfc9e028bce3e784b42737937a386f1337a.tar.gz
MFC TCPDump packet capture scripts from Scott Dale
Diffstat (limited to 'usr')
-rw-r--r--usr/local/www/diag_packet_capture.php232
-rwxr-xr-xusr/local/www/fbegin.inc1
2 files changed, 233 insertions, 0 deletions
diff --git a/usr/local/www/diag_packet_capture.php b/usr/local/www/diag_packet_capture.php
new file mode 100644
index 0000000..6c53442
--- /dev/null
+++ b/usr/local/www/diag_packet_capture.php
@@ -0,0 +1,232 @@
+<?php
+/*
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are met:
+
+ 1. Redistributions of source code must retain the above copyright notice,
+ this list of conditions and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+ INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+ AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+ OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ POSSIBILITY OF SUCH DAMAGE.
+*/
+
+$pgtitle = array("Diagnostics", "Packet Capture");
+require("guiconfig.inc");
+require("pfsense-utils.inc");
+
+$fp = "/usr/local/www/";
+$fn = "packetcapture.cap";
+$snaplen = 1500;//default packet length
+$count = 100;//default number of packets to capture
+
+function get_interface_addr($if) {
+
+ /* find out interface name */
+ if ($ifdescr == "wan")
+ $if = get_real_wan_interface();
+ else
+ $if = $config['interfaces'][$ifdescr];
+
+ return $if;
+
+}
+
+if ($_POST) {
+ $do_tcpdump = true;
+ $host = $_POST['host'];
+ $selectedif = $_POST['interface'];
+ $count = $_POST['count'];
+ $packetlength = $_POST['snaplen'];
+ $port = $_POST['port'];
+ $detail = $_POST['detail'];
+
+ if ($_POST['dnsquery'])//if dns lookup is checked
+ {
+ $disabledns = "";
+ }
+ else //if dns lookup is unchecked
+ {
+ $disabledns = "-n";
+ }
+
+ if ($_POST['startbtn'] != "" )
+ {
+ $action = "Start";
+
+ }
+ elseif ($_POST['stopbtn']!= "")
+ {
+ $action = "Stop";
+ stop_service(tcpdump);
+ }
+ else //download file
+ {
+ $fs = filesize($fn);
+ header("Content-Type: application/octet-stream");
+ header("Content-Disposition: attachment; filename=$fn");
+ header("Content-Length: $fs");
+ readfile($fp.$fn);
+ }
+}
+else
+{
+ $do_tcpdump = false;
+
+}
+$pgtitle = "Diagnostics: Packet Capture";
+include("head.inc"); ?>
+<body link="#000000" vlink="#0000CC" alink="#0000CC">
+<? include("fbegin.inc"); ?>
+
+
+
+<p class="pgtitle"><?=$pgtitle?></p>
+<table width="100%" border="0" cellpadding="0" cellspacing="0">
+ <tr>
+ <td>
+ <form action="diag_packet_capture.php" method="post" name="iform" id="iform">
+ <table width="100%" border="0" cellpadding="6" cellspacing="0">
+ <tr>
+ <td width="17%" valign="top" class="vncellreq">Interface</td>
+ <td width="83%" class="vtable">
+ <select name="interface" class="formfld">
+ <?php $interfaces = array('wan' => 'WAN', 'lan' => 'LAN');
+ for ($i = 1; isset($config['interfaces']['opt' . $i]); $i++) {
+ if (isset($config['interfaces']['opt' . $i]['enable']) &&
+ !$config['interfaces']['opt' . $i]['bridge'])
+ $interfaces['opt' . $i] = $config['interfaces']['opt' . $i]['descr'];
+ }
+ foreach ($interfaces as $iface => $ifacename): ?>
+ <option value="<?=$iface;?>" <?php if ($selectedif == $iface) echo "selected"; ?>>
+ <?php echo $ifacename;?>
+ </option>
+ <?php endforeach;?>
+ </select>
+ <br>Select the interface the traffic will be passing through. Typically this will be the WAN interface.
+ </td>
+ </tr>
+ <tr>
+ <td width="17%" valign="top" class="vncellreq">Host Address</td>
+ <td width="83%" class="vtable">
+ <input name="host" type="text" class="formfld" id="host" size="20" value="<?=htmlspecialchars($host);?>">
+ <br>This value is either the Source or Destination IP address. The packet capture will look for this address in either field.
+ <br>This value can be a domain name or IP address.
+ </td>
+ </tr>
+ <tr>
+ <td width="17%" valign="top" class="vncellreq">Port</td>
+ <td width="83%" class="vtable">
+ <input name="port" type="text" class="formfld" id="port" size="5" value="<?=$port;?>">
+ <br>The port can be either the source or destination port. The packet capture will look for this port in either field.
+ <br>Leave blank if you do not want to the capture to filter by port.
+ </td>
+ </tr>
+ <tr>
+ <td width="17%" valign="top" class="vncellreq">Packet Length</td>
+ <td width="83%" class="vtable">
+ <input name="snaplen" type="text" class="formfld" id="snaplen" size="5" value="<?=$snaplen;?>">
+ <br>The Packet length is the number of bytes the packet will capture for each payload. Default value is 1500.
+ <br>This value should be the same as the MTU of the Interface selected above.
+ </td>
+ </tr>
+ <tr>
+ <td width="17%" valign="top" class="vncellreq">Count</td>
+ <td width="83%" class="vtable">
+ <input name="count" type="text" class="formfld" id="count" size="5" value="<?=$count;?>">
+ <br>This is the number of packets the packet capture will grab. Default value is 100.
+ </tr>
+ <tr>
+ <td width="17%" valign="top" class="vncellreq">Level of Detail</td>
+ <td width="83%" class="vtable">
+ <select name="detail" type="text" class="formfld" id="detail" size="1">
+ <option value="-q" <?php if ($detail == "-q") echo "selected"; ?>>Normal</option>
+ <option value="-v" <?php if ($detail == "-v") echo "selected"; ?>>Medium</option>
+ <option value="-vv" <?php if ($detail == "-vv") echo "selected"; ?>>High</option>
+ <option value="-vv -e" <?php if ($detail == "-vv -e") echo "selected"; ?>>Full</option>
+ </select>
+ <br>This is the level of detail that will be displayed after hitting 'Stop' when the packets have been captured. <br><b>Note:</b> This option does not affect the level of detail when downloading the packet capture.
+ </tr>
+ <tr>
+ <td width="17%" valign="top" class="vncellreq">Reverse DNS Lookup</td>
+ <td width="83%" class="vtable">
+ <input name="dnsquery" type="checkbox"<?php if($_POST['dnsquery']) echo " CHECKED"; ?>>
+ <br>This check box will cause the packet capture to perform a reverse DNS lookup associated with all IP addresses.
+ <br><b>Note: </b>This option can be CPU intensive for large packet captures.
+ </td>
+ </tr>
+ <tr>
+ <td width="17%" valign="top">&nbsp;</td>
+ <td width="83%">
+ <?php
+ if (is_process_running(tcpdump))
+ $processisrunning = True;
+ if (($action == "Stop" or $action == "") and $processisrunning != True)
+ echo "<input type=\"submit\" name=\"startbtn\" value=\"Start\">&nbsp;";
+ else
+ echo "<input type=\"submit\" name=\"stopbtn\" value=\"Stop\">&nbsp;";
+ if (file_exists($fp.$fn)){
+ echo "<input type=\"submit\" name=\"downloadbtn\" value=\"Download Capture\">";
+ echo "&nbsp;&nbsp;(The packet capture file was last updated: " . date("F jS, Y g:i:s a.", filemtime($fp.$fn)) . ")";
+ }
+ ?>
+ </td>
+ </tr>
+ <tr>
+ <td valign="top" colspan="2">
+ <?php
+ if ($do_tcpdump) {
+ echo "<font face='terminal' size='2'>";
+
+ if ($port != "")
+ {
+ $searchport = "and port ".$port;
+ }
+ else
+ {
+ $searchport = "";
+ }
+
+ $selectedif = convert_friendly_interface_to_real_interface_name($selectedif);
+
+ if ($action == "Start")
+ {
+ //delete previous packet capture if it exists
+ if (file_exists($fp.$fn))
+ unlink ($fp.$fn);
+
+ echo("<strong>Packet Capture is running.</strong><br>");
+ exec ("/usr/sbin/tcpdump -i $selectedif -v -c $count -s $packetlength -w $fn host $host $searchport");
+ }
+ else //action = stop
+ {
+ echo("<strong>Packet Capture stopped. <br><br>Packets Captured:</strong><br>");
+ ?>
+ <textarea style="width:98%" name="code" rows="15" cols="66" wrap="off" readonly="readonly">
+ <?php
+ system ("/usr/sbin/tcpdump $disabledns $detail -r $fn");?>
+ </textarea><?php
+ }
+ }
+ if ($processisrunning)
+ echo("<strong>Packet Capture is running.</strong><br>");?>
+ </td>
+ </tr>
+ <tr>
+
+ </table>
+</form>
+</td></tr></table>
+<?php include("fend.inc"); ?>
diff --git a/usr/local/www/fbegin.inc b/usr/local/www/fbegin.inc
index aa7365c..4a2254f 100755
--- a/usr/local/www/fbegin.inc
+++ b/usr/local/www/fbegin.inc
@@ -223,6 +223,7 @@ require_once("notices.inc");
<li><a href="/diag_routes.php" class="navlnk">Routes</a></li>
<li><a href="/diag_dump_states.php" class="navlnk">States</a></li>
<li><a href="/diag_traceroute.php" class="navlnk">Traceroute</a></li>
+ <li><a href="/diag_packet_capture.php" class="navlnk">Packet Capture</a></li>
<?php echo return_ext_menu("Diagnostics"); ?>
<?php if(isset($config['system']['developer'])): ?>
<li><hr width="80%"/></li>
OpenPOWER on IntegriCloud