1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
.\"
.\" This file and its contents are supplied under the terms of the
.\" Common Development and Distribution License ("CDDL"), version 1.0.
.\" You may only use this file in accordance with the terms of version
.\" 1.0 of the CDDL.
.\"
.\" A full copy of the text of the CDDL should have accompanied this
.\" source. A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
.\"
.\"
.\" Copyright 2014 Nexenta Systems, Inc.
.\"
.Dd Nov 22, 2013
.Dt SMBSTAT 8
.Os
.Sh NAME
.Nm smbstat
.Nd report SMB server statistics
.Sh SYNOPSIS
.Nm smbstat
.Op Fl ctu
.Op Fl r Op Fl anz
.Op Ar interval
.Sh DESCRIPTION
The
.Nm
command shows statistical information for the SMB server, including any or all
of the following four categories:
.Sy counters ,
.Sy throughput ,
.Sy utilization ,
.Sy requests .
By default,
.Nm
shows
.Sy throughput
and
.Sy utilization .
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl c
Display
.Sy counters .
The columns shown are:
.Bl -tag -width "users" -compact
.It Sy nbt
NetBIOS connections
.It Sy tcp
TCP connections
.It Sy users
logged on users
.It Sy trees
share connections
.It Sy files
open files and directories
.It Sy pipes
open named pipes
.El
.It Fl r
Display
.Sy request
data, one row for each SMB command.
The columns shown are, for each request type:
.Bl -tag -width "rt-stddev" -compact
.It Pq name
command name
.It Sy code
command code
.It Sy %
% of requests that fall in this row
.It Sy rbytes/s
received bytes per second
.It Sy tbytes/s
transmitted bytes per second
.It Sy reqs/s
requests per second
.It Sy rt-mean
response time average
.It Sy rt-stddev
response time standard deviation
.El
.It Fl t
Display
.Sy throughput .
The columns shown are:
.Bl -tag -width "rbytes/s" -compact
.It Sy rbytes/s
received bytes per second
.It Sy tbytes/s
transmitted bytes per second
.It Sy reqs/s
requests per second
.It Sy reads/s
number of read requests per second
.It Sy writes/s
number of write requests per second
.El
.It Fl u
Display
.Sy utilization .
The columns shown are:
.Bl -tag -width "wtime" -compact
.It Sy wcnt
average number of waiting requests
.It Sy rcnt
average number of running requests
.It Sy wtime
average wait time per request
.It Sy rtime
average run time per request
.It Sy w%
% of time there were waiting requests
.It Sy r%
% of time there were running requests
.It Sy u%
utilization, computed as
.Sy rcnt Ns / Ns Sy max_workers
.It Sy sat
has the server been
.Qq saturated
.Pq u% at 100
.It Sy usr%
% of CPU time in user space
.It Sy sys%
% of CPU time in kernel
.It Sy idle%
% of CPU time spent idle
.El
.El
.Pp
The
.Fl r
option supports additional modifiers including:
.Bl -tag -width Ds
.It Fl a
show
.Qq all
request types
.Pq including unsupported ones
.It Fl n
.Qq name
order
.Pq sort by request name
.It Fl z
suppress
.Qq zero
count rows
.Pq types for which none were received
.El
.Sh OPERANDS
.Bl -tag -width Ds
.It Ar interval
When
.Ar interval
is specified,
.Nm
runs in a loop, printing the requested output every
.Ar interval
seconds.
When no
.Ar interval
is specified, the statistics presented are based on running averages accumulated
since the system started.
The first output shows the same cumulative statistics one would see without the
.Ar interval
specified, and subsequent outputs represent the activity in the interval that
just finished.
.El
.Sh INTERFACE STABILITY
.Sy Uncommitted .
Output format is
.Sy Not-an-Interface.
.Sh SEE ALSO
.Xr sharectl 8 ,
.Xr sharemgr 8 ,
.Xr smbadm 8 ,
.Xr smbd 8
|
