smbstat - 手册页部分 8：系统管理命令

语言：

smbstat(8)

名称

smbstat - 显示 Solaris SMB 文件服务器统计信息

用法概要

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

描述

smbstat 命令可显示 smbd(8) 服务器的统计信息。smbstat 具有多个选项（如下所述）和两个操作数（interval 和 count）。第一个表汇总自服务器启动以来执行的活动。后续的每一个表汇总上一间隔期间的活动。

缺省情况下，smbstat 命令显示所有统计信息。

选项

smbstat 命令具有以下选项：

–c

显示计数器。

–r

显示请求的统计信息。–r 选项可以与以下选项组合使用。

–a: 显示所有类型的服务器请求（包括有效的和无效的）的统计信息。–a 选项和 –z 选项是互斥的。
–n: 按字母顺序显示。
–z: 显示实际接收的请求的统计信息。–a 选项和 –z 选项是互斥的。
–v version: 指定要输出其统计信息的 SMB 版本。version 参数（1、2 或 3）仅请求该版本的统计信息。不指定 –v 选项时，smbstat 将输出所有版本的统计信息。

–t

显示 SMB 服务器的吞吐量。

–u

显示 SMB 服务器的使用率。

扩展描述

smbstat 命令显示下面所示的标题。为给定命令显示的标题根据所指定的选项不同而不同。有四种类别的标题，分别对应于四种类别的统计信息：计数器、吞吐量、使用率和（服务器）请求。

计数器

nbt: SMB NetBIOS-over-TCP (NBT) 会话的数目。
tcp: SMB TCP 会话的数目。
users: 登录的用户的数目。
trees: 连接的树的数目。
files: 打开的文件的数目。
pipes: 打开的管道的数目。

吞吐量

rbytes/s: 每秒接收的字节数。
tbytes/s: 每秒传输的字节数。
reqs/s: 每秒处理的请求数。
reads/s: 每秒的读取请求数。这将是下列请求的聚合：SMB_COM_READ、SMB_COM_LOCK_AND_READ、SMB_COM_READ_ANDX 和 SMB2_READ。
writes/s: 每秒的写入请求数。这将是下列请求的聚合：SMB_COM_WRITE、SMB_COM_WRITE_AND_UNLOCK、SMB_COM_WRITE_AND_CLOSE 和 SMB2_WRITE。

使用率

wcnt: 已被接收但在等待 SMB 工作线程执行的平均请求数。
rcnt: SMB 工作线程同时执行的平均请求数。
wtime: 请求在 SMB 工作线程开始执行它之前等待的平均时间。
rtime: 请求的平均执行时间。
w%: 至少有一个请求处于等待状态的时间所占的百分比。
r%: 至少有一个请求处于执行状态的时间所占的百分比。
u%: SMB 服务器使用率百分比。此数字的定义为：rcnt / (max_worker_threads)。
sat: 表示服务器过去是否已经饱和的标志。饱和的定义是 u% == 100%。
usr%: 处理器在用户空间中花费的时间所占的百分比。
sys%: 处理器在内核空间中花费的时间所占的百分比。
idle%: 处理空闲时间所占的百分比。

请求

为每种类型的请求显示以下标题。

code: 以十六进制表示的请求代码。
%: 给定类型的请求所占的百分比。
count: 已接收的请求数。
rbytes/s: 每秒接收的字节数。
tbytes/s: 每秒接收的字节数。
req/s: 每秒处理的请求数。
rt-mean: 平均响应时间，以秒为单位。
rt-stddev: 响应时间的标准偏差。

操作数

支持下列操作数

count: 要输出统计信息的次数。
interval: 每隔一定间隔（秒）报告一次。

示例

示例 1 组合选项

以下命令将 –c、–t 和 –u 选项组合使用。

% 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

示例 2 显示 SMB2 请求

以下命令为显示 smb2 请求显示输出样例。

# smbstat -rv 2
SMB v2 Requests: 
. 
                                 code   %    count     rbytes/s   tbytes/s     
req/s     rt-mean   rt-stddev 
                 Smb2Negotiate  00    0         70  0.000e+00  0.000e+00   
0.000e+00  3.525e-03  2.450e-05 
              Smb2SessionSetup  01    0        140  0.000e+00  0.000e+00   
0.000e+00  9.640e-03  7.446e-04 
                    Smb2Logoff  02    0          3  0.000e+00  0.000e+00   
0.000e+00  7.113e-05  1.766e-05 
               Smb2TreeConnect  03    0         70  0.000e+00  0.000e+00   
0.000e+00  8.932e-05  2.867e-07 
            Smb2TreeDisconnect  04    0          2  0.000e+00  0.000e+00   
0.000e+00  5.658e-06  1.036e-06 
                    Smb2Create  05    0        622  0.000e+00  0.000e+00   
0.000e+00  3.353e-02  1.342e-03 
                     Smb2Close  06    0        345  0.000e+00  0.000e+00   
0.000e+00  1.345e-05  7.645e-08 
                     Smb2Flush  07    0          2  0.000e+00  0.000e+00   
0.000e+00  1.647e-02  1.647e-02 
                      Smb2Read  08    0         52  0.000e+00  0.000e+00   
0.000e+00  3.547e-05  3.660e-06 
                     Smb2Write  09    0        101  3.513e+00  0.000e+00   
0.000e+00  5.088e-04  3.865e-06 
                      Smb2Lock  0A    0          1  0.000e+00  0.000e+00   
0.000e+00  1.528e-05  0.000e+00 
                     Smb2Ioctl  0B    0          0  0.000e+00  0.000e+00   
0.000e+00  0.000e+00  0.000e+00 
                    Smb2Cancel  0C    0          0  0.000e+00  0.000e+00   
0.000e+00  0.000e+00  0.000e+00 
                      Smb2Echo  0D    0          1  0.000e+00  0.000e+00   
0.000e+00  4.601e-06  0.000e+00 
            Smb2QueryDirectory  0E    0         38  0.000e+00  0.000e+00   
0.000e+00  9.123e-05  1.154e-05 
              Smb2ChangeNotify  0F    0          0  0.000e+00  0.000e+00   
0.000e+00  0.000e+00  0.000e+00 
                 Smb2QueryInfo  10    0         55  0.000e+00  0.000e+00   
0.000e+00  4.634e-05  6.007e-06 
                   Smb2SetInfo  11    0          9  0.000e+00  0.000e+00   
0.000e+00  9.772e-05  2.421e-05 
               Smb2OplockBreak  12    0         11  0.000e+00  0.000e+00   
0.000e+00  9.808e-06  2.308e-07

退出状态

将返回以下退出值：

0: 成功完成。
>0: 出现错误。

属性

有关以下属性的说明，请参见 attributes(7) 手册页：

属性类型	属性值
可用性	service/file-system/smb
接口稳定性	Uncommitted（未确定）
实用程序输出格式	Not-an-Interface（不是接口）

另请参见

attributes(7)、sharectl(8)、smbadm(8)、smbd(8)