man pages section 1M: System Administration Commands

Exit Print View

Updated: July 2014
 
 

smbstat(1M)

Name

smbstat - show Solaris SMB file server statistics

Synopsis

smbstat [-r [-n [-a | -z]] [-t] [-u] [-c] interval

Description

The smbstat command shows statistical information for the smbd(1M) server. smbstat has a number of options, described below, and a single operand, interval. If interval is specified, the first display captures statistics since the server started, up to the moment the command was entered. Subsequent displays capture statistics for the last interval.

By default, the smbstat command shows all statistics.

Options

The smbstat command includes the following options:

–c

Display counters.

–r

Display the statistics of the requests. You can combine –r with the following options.

–a

Display statistics for all the types of server requests, whether valid or not. Note that there are 256 types of server requests. The –a and –z options are mutually exclusive.

–n

Display in alphabetic order.

–z

Display statistics for requests actually received. The –a and –z options are mutually exclusive.

–t

Display the throughput of the SMB server.

–u

Display the utilization of the SMB server.

Extended Description

The

The smbstat command displays the headings shown below. The headings displayed for a given command vary according to which option(s) are specified. There are four categories of headings, corresponding to categories of statistics: counters, throughput, utilization, and (server) requests.

Counters

nbt

Number of SMB NetBIOS-over-TCP (NBT) sessions.

tcp

Number of SMB TCP sessions.

users

Number of users logged in.

trees

Number of trees connected.

files

Number of open files.

pipes

Number of open pipes.

Throughput

rbytes/s

Number of bytes received per second.

tbytes/s

Number of bytes transmitted per second.

reqs/s

Number of requests handled per second.

reads/s

Number of read requests per second. This would be an aggregation of the following requests: SMB_COM_READ, SMB_COM_LOCK_AND_READ, SMB_COM_READ_RAW, and SMB_COM_READ_ANDX.

writes/s

Number of write requests per second. This would ba an aggregation of the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK, SMB_COM_WRITE_RAW, and SMB_COM_WRITE_AND_CLOSE.

Utilization

wcnt

Average number of requests received but waiting for an SMB worker thread to execute them.

rcnt

Average number of requests being simultaneously executed by an SMB worker thread.

wtime

Average time a request waits before an SMB worker thread starts executing it.

rtime

Average execution time of a request.

w%

Percentage of the time during which at least one request was waiting.

r%

Percentage of the time during which at least one request was being executed.

u%

Percentage of utilization of the SMB server. This number is defined as: rcnt / (max_worker_threads).

sat

Flag indicating if the server has been saturated in the past. Saturation is defined as: u% == 100%.

usr%

Percentage of the time the processor(s) spent in user space.

sys%

Percentage of the time the processor(s) spent in kernel space.

idle%

Percentage of the time the processor(s) was(were) idle.

Requests

The following headings are displayed for each type of request.

code

Code of the request, in hexadecimal.

%

Percentage of a given type of request.

count

Number of requests received.

rbytes/s

Number of bytes received per second.

tbytes/s

Number of bytes received per second.

req/s

Number of requests handled per second.

rt-mean

Average response time in seconds.

rt-stddev

Standard deviation of the response time.

Examples

Example 1 Combining Options

The following command combines the –c, –t, and –u options.

% smbstat -ctu
nbt   tcp users trees files pipes
0     1     1     2    20     0

rbytes/s   tbytes/s    reqs/s     reads/s   writes/s
1.036e+02  1.298e+00  0.000e+00  0.000e+00  0.000e+00

wcnt       rcnt       wtime      rtime       w%   r%  u% sat usr% sys% idle%
4.317e-01  7.410e+00  2.461e-05  4.224e-04   31  100  0  no  0    76   24

Exit Status

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

Attributes

See the attributes(5) man page for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
service/file-system/smb
Interface Stability
Uncommitted
Utility Output Format
Not-an-Interface

See also

sharectl(1M), smbadm(1M), smbd(1M), attributes(5)