Initial import
[samba] / docs / htmldocs / manpages / log2pcap.1.html
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="id2489057"></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="id2450622"></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="id2450699"></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="id2450740"></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="id2450751"></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="id2450767"></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="id2450859"></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>