source: trunk/samba/docs/htmldocs/manpages/log2pcap.1.html @ 22

Last change on this file since 22 was 1, checked in by Paul Smedley, 14 years ago

Initial code import

File size: 3.7 KB
Line 
1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>log2pcap</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="log2pcap.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>log2pcap &#8212; Extract network traces from Samba log files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">log2pcap</code>  [-h] [-q] [logfile] [pcap_file]</p></div></div><div class="refsect1" lang="en"><a name="id230792"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><span><strong class="command">log2pcap</strong></span> reads in a
2        samba log file and generates a pcap file (readable
3        by most sniffers, such as ethereal or tcpdump) based on the packet
4        dumps in the log file.</p><p>The log file must have a <em class="parameter"><code>log level</code></em> 
5        of at least <code class="constant">5</code> to get the SMB header/parameters
6        right, <code class="constant">10</code> to get the first 512 data bytes of the
7        packet and <code class="constant">50</code> to get the whole packet.
8        </p></div><div class="refsect1" lang="en"><a name="id231165"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-h</span></dt><dd><p>If this parameter is
9                specified the output file will be a
10                hex dump, in a format that is readable
11                by the <span class="application">text2pcap</span> utility.</p></dd><dt><span class="term">-q</span></dt><dd><p>Be quiet. No warning messages about missing
12                or incomplete data will be given.</p></dd><dt><span class="term">logfile</span></dt><dd><p>
13                Samba log file. log2pcap will try to read the log from stdin
14                if the log file is not specified.
15                </p></dd><dt><span class="term">pcap_file</span></dt><dd><p>
16                Name of the output file to write the pcap (or hexdump) data to.
17                If this argument is not specified, output data will be written
18                to stdout.
19                </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
20</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id231439"></a><h2>EXAMPLES</h2><p>Extract all network traffic from all samba log files:</p><pre class="programlisting">
21                        <code class="prompt">$</code> log2pcap &lt; /var/log/* &gt; trace.pcap
22        </pre><p>Convert to pcap using text2pcap:</p><pre class="programlisting">
23        <code class="prompt">$</code> log2pcap -h samba.log | text2pcap -T 139,139 - trace.pcap
24        </pre></div><div class="refsect1" lang="en"><a name="id231478"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id231487"></a><h2>BUGS</h2><p>Only SMB data is extracted from the samba logs, no LDAP,
25        NetBIOS lookup or other data.</p><p>The generated TCP and IP headers don't contain a valid
26        checksum.</p></div><div class="refsect1" lang="en"><a name="id231502"></a><h2>SEE ALSO</h2><p><a href="text2pcap.1.html"><span class="citerefentry"><span class="refentrytitle">text2pcap</span>(1)</span></a>, <a href="ethereal.1.html"><span class="citerefentry"><span class="refentrytitle">ethereal</span>(1)</span></a></p></div><div class="refsect1" lang="en"><a name="id231524"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
27        were created by Andrew Tridgell. Samba is now developed
28        by the Samba Team as an Open Source project similar
29        to the way the Linux kernel is developed.</p><p>This manpage was written by Jelmer Vernooij.</p></div></div></body></html>
Note: See TracBrowser for help on using the repository browser.