Debian Codegraph @

upstream/debian-unstable/man1/samba-log-parser.1

raw
1 '\" t
2 .\" Title: samba-log-parser
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 05/26/2026
6 .\" Manual: User Commands
7 .\" Source: Samba 4.24.3-Debian-4.24.3+dfsg-1
8 .\" Language: English
9 .\"
10 .TH "SAMBA\-LOG\-PARSER" "1" "05/26/2026" "Samba 4\&.24\&.3\-Debian\-4\&.24\&.3+dfs" "User Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 samba-log-parser \- Samba (winbind) trace parser\&.
32
33 options:
34 \-h, \-\-help show this help message and exit
35 \-\-traceid ID specify the traceid of the trace records
36 \-\-pid PID specify the pid of winbind client
37 \-\-breakdown breakdown the traces into per traceid files
38 \-\-merge\-by\-timestamp merge logs by timestamp
39 \-\-flow show the request/sub\-request flow traces
40 \-\-flow\-compact show the request/sub\-request flow traces without dcerpc details
41 .SH "SYNOPSIS"
42 .HP \w'\ 'u
43 samba\-log\-parser {path} [\-\-pid=PID] [\-\-traceid=ID] [\-\-breakdown] [\-\-merge\-by\-timestamp] [\-\-flow] [\-\-flow\-compact] [\-h|\-\-help]
44 .SH "DESCRIPTION"
45 .PP
46 This tool is part of the
47 \fBsamba\fR(7)
48 suite\&.
49 .PP
50 The
51 samba\-log\-parser
52 program parses samba winbind logs\&.
53 .SH "OPTIONS"
54 .PP
55 The following options are available to the
56 samba\-log\-parser
57 program\&.
58 .PP
59 \-\-pid=PID
60 .RS 4
61 Display traces for winbind client with the matching PID\&.
62 .RE
63 .PP
64 \-\-traceid=ID
65 .RS 4
66 Display traces with matching traceid debug header field\&.
67 .RE
68 .PP
69 \-\-breakdown
70 .RS 4
71 Break down all traces to separate files in the current working directory\&. For each traceid, three files are created: traceid\&.full traceid\&.flow traceid\&.flowcompact
72 .RE
73 .PP
74 \-\-merge\-by\-timestamp
75 .RS 4
76 Sort the trace lines according to the timestamp\&. Works with log files without traceid header field as well\&.
77 .RE
78 .PP
79 \-\-flow
80 .RS 4
81 Display the request/sub\-request flow\&.
82 .RE
83 .PP
84 \-\-flow\-compact
85 .RS 4
86 Display the request/sub\-request flow without dcerpc call details\&.
87 .RE
88 .SH "EXAMPLES"
89 .PP
90 Show the flow traces for trace id
91 \fI1234\fR
92 from log file log\&.winbind:
93 .sp
94 .if n \{\
95 .RS 4
96 .\}
97 .nf
98 # samba\-log\-parser \-\-traceid 1234 \-\-flow /var/log/samba/log\&.winbind
99 .fi
100 .if n \{\
101 .RE
102 .\}
103 .PP
104 Show the full traces for winbind client with PID
105 \fI999999\fR
106 sorted using the timestamp for log files found in the samba log directory:
107 .sp
108 .if n \{\
109 .RS 4
110 .\}
111 .nf
112 # samba\-log\-parser \-\-pid 999999 \-\-merge\-by\-timestamp /var/log/samba
113 .fi
114 .if n \{\
115 .RE
116 .\}
117 .PP
118 Break down the traces into separate files according to traceid sorted using the timestamp for log files found in the samba log directory:
119 .sp
120 .if n \{\
121 .RS 4
122 .\}
123 .nf
124 # samba\-log\-parser \-\-breakdown \-\-merge\-by\-timestamp /var/log/samba
125 .fi
126 .if n \{\
127 .RE
128 .\}
129 .PP
130 Sort traces using the timestamp for log files found in the samba log directory\&. Traces do not need to contain the traceid header field\&.
131 .sp
132 .if n \{\
133 .RS 4
134 .\}
135 .nf
136 # samba\-log\-parser \-\-merge\-by\-timestamp /var/log/samba
137 .fi
138 .if n \{\
139 .RE
140 .\}
141 .SH "VERSION"
142 .PP
143 This man page is part of version 4\&.24\&.3\-Debian\-4\&.24\&.3+dfsg\-1 of the Samba suite\&.
144 .SH "AUTHOR"
145 .PP
146 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\&.