release/src-rt-6.x.4708/router/samba-3.0.25b/docs/manpages/log2pcap.1

   1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
   2 .de Sh \" Subsection
   3 .br
   4 .if t .Sp
   5 .ne 5
   6 .PP
   7 \fB\\$1\fR
   8 .PP
   9 ..
  10 .de Sp \" Vertical space (when we can't use .PP)
  11 .if t .sp .5v
  12 .if n .sp
  13 ..
  14 .de Ip \" List item
  15 .br
  16 .ie \\n(.$>=3 .ne \\$3
  17 .el .ne 3
  18 .IP "\\$1" \\$2
  19 ..
  20 .TH "LOG2PCAP" 1 "" "" ""
  21 .SH "NAME"
  22 log2pcap - Extract network traces from Samba log files
  23 .SH "SYNOPSIS"
  24 .HP 1
  25 log2pcap [-h] [-q] [logfile] [pcap_file]
  26 .SH "DESCRIPTION"
  27 .PP
  28 This tool is part of the
  29 \fBsamba\fR(7)
  30 suite.
  31 .PP
  32 log2pcap
  33 reads in a samba log file and generates a pcap file (readable by most sniffers, such as ethereal or tcpdump) based on the packet dumps in the log file.
  34 .PP
  35 The log file must have a
  36 \fIlog level\fR
  37 of at least
  38 \fB5\fR
  39 to get the SMB header/parameters right,
  40 \fB10\fR
  41 to get the first 512 data bytes of the packet and
  42 \fB50\fR
  43 to get the whole packet.
  44 .SH "OPTIONS"
  45 .PP
  46 -h
  47 .RS 3n
  48 If this parameter is specified the output file will be a hex dump, in a format that is readable by the
  49 text2pcap
  50 utility.
  51 .RE
  52 .PP
  53 -q
  54 .RS 3n
  55 Be quiet. No warning messages about missing or incomplete data will be given.
  56 .RE
  57 .PP
  58 logfile
  59 .RS 3n
  60 Samba log file. log2pcap will try to read the log from stdin if the log file is not specified.
  61 .RE
  62 .PP
  63 pcap_file
  64 .RS 3n
  65 Name of the output file to write the pcap (or hexdump) data to. If this argument is not specified, output data will be written to stdout.
  66 .RE
  67 .PP
  68 -h|--help
  69 .RS 3n
  70 Print a summary of command line options.
  71 .RE
  72 .SH "EXAMPLES"
  73 .PP
  74 Extract all network traffic from all samba log files:
  75 .PP
  76
  77 .sp
  78
  79 .nf
  80
  81                         $ log2pcap < /var/log/* > trace.pcap
  82
  83 .fi
  84
  85 .PP
  86 Convert to pcap using text2pcap:
  87 .PP
  88
  89 .sp
  90
  91 .nf
  92
  93         $ log2pcap -h samba.log | text2pcap -T 139,139 - trace.pcap
  94
  95 .fi
  96
  97 .SH "VERSION"
  98 .PP
  99 This man page is correct for version 3.0 of the Samba suite.
 100 .SH "BUGS"
 101 .PP
 102 Only SMB data is extracted from the samba logs, no LDAP, NetBIOS lookup or other data.
 103 .PP
 104 The generated TCP and IP headers don't contain a valid checksum.
 105 .SH "SEE ALSO"
 106 .PP
 107 \fBtext2pcap\fR(1),
 108 \fBethereal\fR(1)
 109 .SH "AUTHOR"
 110 .PP
 111 The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.
 112 .PP
 113 This manpage was written by Jelmer Vernooij.
 114