1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbstatus</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbstatus.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbstatus — report on current Samba connections</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbstatus</code> [-P] [-b] [-d <debug level>] [-v] [-L] [-B] [-p] [-S] [-s <configuration file>] [-u <username>]</p></div></div><div class="refsect1" lang="en"><a name="id2483359"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbstatus</code> is a very simple program to
2
list the current Samba connections.</p></div><div class="refsect1" lang="en"><a name="id2483386"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">-P|--profile</span></dt><dd><p>If samba has been compiled with the
3
profiling option, print only the contents of the profiling
4
shared memory area.</p></dd><dt><span class="term">-b|--brief</span></dt><dd><p>gives brief output.</p></dd><dt><span class="term">-d|--debuglevel=level</span></dt><dd><p><em class="replaceable"><code>level</code></em> is an integer
5
from 0 to 10. The default value if this parameter is
6
not specified is 0.</p><p>The higher this value, the more detail will be
7
logged to the log files about the activities of the
8
server. At level 0, only critical errors and serious
9
warnings will be logged. Level 1 is a reasonable level for
10
day-to-day running - it generates a small amount of
11
information about operations carried out.</p><p>Levels above 1 will generate considerable
12
amounts of log data, and should only be used when
13
investigating a problem. Levels above 3 are designed for
14
use only by developers and generate HUGE amounts of log
15
data, most of which is extremely cryptic.</p><p>Note that specifying this parameter here will
16
override the <a class="link" href="smb.conf.5.html#" target="_top"></a> parameter
17
in the <code class="filename">smb.conf</code> file.</p></dd><dt><span class="term">-V|--version</span></dt><dd><p>Prints the program version number.
18
</p></dd><dt><span class="term">-s|--configfile <configuration file></span></dt><dd><p>The file specified contains the
19
configuration details required by the server. The
20
information in this file includes server-specific
21
information such as what printcap file to use, as well
22
as descriptions of all the services that the server is
23
to provide. See <code class="filename">smb.conf</code> for more information.
24
The default configuration file name is determined at
25
compile time.</p></dd><dt><span class="term">-l|--log-basename=logdirectory</span></dt><dd><p>Base directory name for log/debug files. The extension
26
<code class="constant">".progname"</code> will be appended (e.g. log.smbclient,
27
log.smbd, etc...). The log file is never removed by the client.
28
</p></dd><dt><span class="term">-v|--verbose</span></dt><dd><p>gives verbose output.</p></dd><dt><span class="term">-L|--locks</span></dt><dd><p>causes smbstatus to only list locks.</p></dd><dt><span class="term">-B|--byterange</span></dt><dd><p>causes smbstatus to include byte range locks.
29
</p></dd><dt><span class="term">-p|--processes</span></dt><dd><p>print a list of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> processes and exit.
30
Useful for scripting.</p></dd><dt><span class="term">-S|--shares</span></dt><dd><p>causes smbstatus to only list shares.</p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
31
</p></dd><dt><span class="term">-u|--user=<username></span></dt><dd><p>selects information relevant to <em class="parameter"><code>username</code></em> only.</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481522"></a><h2>VERSION</h2><p>This man page is correct for version 3 of
32
the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2481533"></a><h2>SEE ALSO</h2><p><a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and <a class="citerefentry" href="smb.conf.5.html"><span class="citerefentry"><span class="refentrytitle">smb.conf</span>(5)</span></a>.</p></div><div class="refsect1" lang="en"><a name="id2481558"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
33
were created by Andrew Tridgell. Samba is now developed
34
by the Samba Team as an Open Source project similar
35
to the way the Linux kernel is developed.</p><p>The original Samba man pages were written by Karl Auer.
36
The man page sources were converted to YODL format (another
37
excellent piece of Open Source software, available at <a class="ulink" href="ftp://ftp.icce.rug.nl/pub/unix/" target="_top">
38
ftp://ftp.icce.rug.nl/pub/unix/</a>) and updated for the Samba 2.0
39
release by Jeremy Allison. The conversion to DocBook for
40
Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2
41
for Samba 3.0 was done by Alexander Bokovoy.</p></div></div></body></html>