Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../.././../usr/man/man8/smbstat.8
Real path: /usr/share/man/man8/smbstat.8
Zurück

'\" te
.\" Copyright (c) 2008, 2019, Oracle and/or its affiliates. All rights reserved.
.TH smbstat 8 "03 Nov 2016" "Oracle Solaris 11.4" "System Administration Commands"
.SH NAME
smbstat \- Show Solaris SMB file server statistics
.SH SYNOPSIS

.LP
.nf
\fBsmbstat\fR [\fB-r\fR [\fB-n\fR [\fB-a\fR | \fB-z\fR] \fB-v\fR ]] [\fB-t\fR] [\fB-u\fR] [\fB-c\fR] [\fIinterval\fR [\fIcount\fR]
.fi
.SH DESCRIPTION
.sp
.LP
The \fBsmbstat\fR command shows statistical information for the \fBsmbd\fR(8) server. \fBsmbstat\fR has a number of options, described below, and two operands, \fIinterval\fR and \fIcount\fR. The first table summarizes the activity since the server started. Each subsequent table summarizes the activity for the preceding interval.
.sp
.LP
By default, the \fBsmbstat\fR command shows all statistics.
.SH OPTIONS
.sp
.LP
The \fBsmbstat\fR command includes the following options:
.sp
.ne 2
.mk
.na
\fB\fB-c\fR\fR
.ad
.br
.sp .6
.RS 4n
Display counters.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-r\fR\fR
.ad
.br
.sp .6
.RS 4n
Display the statistics of the requests. You can combine \fB-r\fR with the following options.
.sp
.ne 2
.mk
.na
\fB\fB-a\fR\fR
.ad
.br
.sp .6
.RS 4n
Display statistics for all the types of server requests, whether valid or not. The \fB-a\fR and \fB-z\fR options are mutually exclusive.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-n\fR\fR
.ad
.br
.sp .6
.RS 4n
Display in alphabetic order.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-z\fR\fR
.ad
.br
.sp .6
.RS 4n
Display statistics for requests actually received. The \fB-a\fR and \fB-z\fR options are mutually exclusive.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-v\fR version\fR
.ad
.br
.sp .6
.RS 4n
Specify the SMB version for which to print statistics. The version argument, 1, 2, or 3 requests statistics for only that version. Without \fB-v\fR option, \fBsmbstat\fR prints statistics for all versions.
.RE

.RE

.sp
.ne 2
.mk
.na
\fB\fB-t\fR\fR
.ad
.br
.sp .6
.RS 4n
Display the throughput of the SMB server.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-u\fR\fR
.ad
.br
.sp .6
.RS 4n
Display the utilization of the SMB server.
.RE

.SH EXTENDED DESCRIPTION
.sp
.LP
The \fBsmbstat\fR 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.
.SS "Counters"
.sp
.ne 2
.mk
.na
\fB\fBnbt\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of SMB NetBIOS-over-TCP (NBT) sessions.
.RE

.sp
.ne 2
.mk
.na
\fB\fBtcp\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of SMB TCP sessions.
.RE

.sp
.ne 2
.mk
.na
\fB\fBusers\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of users logged in.
.RE

.sp
.ne 2
.mk
.na
\fB\fBtrees\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of trees connected.
.RE

.sp
.ne 2
.mk
.na
\fB\fBfiles\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of open files.
.RE

.sp
.ne 2
.mk
.na
\fB\fBpipes\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of open pipes.
.RE

.sp
.ne 2
.mk
.na
\fB\fBidle\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of idle connections timed out and disconnected.
.RE

.SS "Throughput"
.sp
.ne 2
.mk
.na
\fB\fBrbytes/s\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of bytes received per second.
.RE

.sp
.ne 2
.mk
.na
\fB\fBtbytes/s\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of bytes transmitted per second.
.RE

.sp
.ne 2
.mk
.na
\fB\fBreqs/s\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of requests handled per second.
.RE

.sp
.ne 2
.mk
.na
\fB\fBreads/s\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of read requests per second. This would be an aggregation of the following requests: \fBSMB_COM_READ\fR, \fBSMB_COM_LOCK_AND_READ\fR, \fBSMB_COM_READ_ANDX\fR and \fBSMB2_READ\fR.
.RE

.sp
.ne 2
.mk
.na
\fB\fBwrites/s\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of write requests per second. This would be an aggregation of the following requests: \fBSMB_COM_WRITE\fR, \fBSMB_COM_WRITE_AND_UNLOCK\fR, \fBSMB_COM_WRITE_AND_CLOSE\fR and \fBSMB2_WRITE\fR.
.RE

.SS "Utilization"
.sp
.ne 2
.mk
.na
\fB\fBwcnt\fR\fR
.ad
.br
.sp .6
.RS 4n
Average number of requests received but waiting for an SMB worker thread to execute them.
.RE

.sp
.ne 2
.mk
.na
\fB\fBrcnt\fR\fR
.ad
.br
.sp .6
.RS 4n
Average number of requests being simultaneously executed by an SMB worker thread.
.RE

.sp
.ne 2
.mk
.na
\fB\fBwtime\fR\fR
.ad
.br
.sp .6
.RS 4n
Average time a request waits before an SMB worker thread starts executing it.
.RE

.sp
.ne 2
.mk
.na
\fB\fBrtime\fR\fR
.ad
.br
.sp .6
.RS 4n
Average execution time of a request.
.RE

.sp
.ne 2
.mk
.na
\fB\fBw%\fR\fR
.ad
.br
.sp .6
.RS 4n
Percentage of the time during which at least one request was waiting.
.RE

.sp
.ne 2
.mk
.na
\fB\fBr%\fR\fR
.ad
.br
.sp .6
.RS 4n
Percentage of the time during which at least one request was being executed.
.RE

.sp
.ne 2
.mk
.na
\fB\fBu%\fR\fR
.ad
.br
.sp .6
.RS 4n
Percentage of utilization of the SMB server. This number is defined as: \fBrcnt\fR / (\fImax_worker_threads\fR).
.RE

.sp
.ne 2
.mk
.na
\fB\fBsat\fR\fR
.ad
.br
.sp .6
.RS 4n
Flag indicating if the server has been saturated in the past. Saturation is defined as: \fBu%\fR == 100%.
.RE

.sp
.ne 2
.mk
.na
\fB\fBusr%\fR\fR
.ad
.br
.sp .6
.RS 4n
Percentage of the time the processor(s) spent in user space.
.RE

.sp
.ne 2
.mk
.na
\fB\fBsys%\fR\fR
.ad
.br
.sp .6
.RS 4n
Percentage of the time the processor(s) spent in kernel space.
.RE

.sp
.ne 2
.mk
.na
\fB\fBidle%\fR\fR
.ad
.br
.sp .6
.RS 4n
Percentage of the time the processor(s) was(were) idle.
.RE

.SS "Requests"
.sp
.LP
The following headings are displayed for each type of request.
.sp
.ne 2
.mk
.na
\fB\fBcode\fR\fR
.ad
.br
.sp .6
.RS 4n
Code of the request, in hexadecimal.
.RE

.sp
.ne 2
.mk
.na
\fB\fB%\fR\fR
.ad
.br
.sp .6
.RS 4n
Percentage of a given type of request.
.RE

.sp
.ne 2
.mk
.na
\fB\fBcount\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of requests received.
.RE

.sp
.ne 2
.mk
.na
\fB\fBrbytes/s\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of bytes received per second.
.RE

.sp
.ne 2
.mk
.na
\fB\fBtbytes/s\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of bytes received per second.
.RE

.sp
.ne 2
.mk
.na
\fB\fBreq/s\fR\fR
.ad
.br
.sp .6
.RS 4n
Number of requests handled per second.
.RE

.sp
.ne 2
.mk
.na
\fB\fBrt-mean\fR\fR
.ad
.br
.sp .6
.RS 4n
Average response time in seconds.
.RE

.sp
.ne 2
.mk
.na
\fB\fBrt-stddev\fR\fR
.ad
.br
.sp .6
.RS 4n
Standard deviation of the response time.
.RE

.SH OPERANDS
.sp
.LP
The following operand is supported
.sp
.ne 2
.mk
.na
\fB\fBcount\fR\fR
.ad
.RS 12n
.rt
Number of times statistics are printed.
.RE

.sp
.ne 2
.mk
.na
\fB\fBinterval\fR\fR
.ad
.RS 12n
.rt
Report once each interval seconds.
.RE

.SH EXAMPLES
.LP
\fBExample 1\fR 
Combining Options

.sp
.LP
The following command combines the \fB-c\fR, \fB-t\fR, and \fB-u\fR options.

.sp
.in +2
.nf
% \fBsmbstat -ctu\fR
nbt   tcp users trees files pipes  idle
0     1     1     2    20     0       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
.fi
.in -2
.sp

.LP
\fBExample 2\fR Displaying SMB2 Requests

.sp
.LP
The following command displays sample output for displaying smb2 requests.

.sp
.in +2
.nf
# 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 
.fi
.in -2
.sp
.SH EXIT STATUS
.sp
.LP
The following exit values are returned:
.sp
.ne 2
.mk
.na
\fB0\fR
.ad
.RS 13n
.rt
Successful completion.
.RE

.sp
.ne 2
.mk
.na
\fB>0\fR
.ad
.RS 13n
.rt
An error occurred.
.RE

.SH ATTRIBUTES
.sp
.LP
See the \fBattributes\fR(7) man page for descriptions of the following attributes:
.sp
.TS
tab(
) box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPE
ATTRIBUTE VALUE
_
Availability
service/file-system/smb
_
Interface Stability
Uncommitted
_
Utility Output Format
Not-an-Interface
.TE
.sp
.SH SEE ALSO
.sp
.LP
\fBattributes\fR(7), \fBsharectl\fR(8), \fBsmbadm\fR(8), \fBsmbd\fR(8)