cifs_stat

by Chris Kranz on Jul.07, 2009, under Manual Pages

Table of Contents

NAME

cifs_stat – print CIFS operating statistics

SYNOPSIS

cifs stat [ -u user ] [ -h host ] [ -v[v] ] [ interval ]

cifs stat -c

cifs stat -z

The cifs stat command has two main forms. If you specify the interval, the command continues displaying a summary of CIFS activity until interrupted. The information is for the preceding interval seconds. (The header line is repeated periodically.) The interval must be >= 1.

If you do not specify the interval, the command displays counts and percentages of all CIFS operations as well as a number of internal statistics that may be of use when diagnosing performance and other problems.

By default, the statistics displayed are cumulative for all clients. However, if the cifs.per_client_stats.enable option is on, a subset of the clients may be selected using the -u and/or -h options.

OPTIONS

-u <user>: If per-client stats are being gathered, selects a user account to match for stats reporting. More than one -u <user> option may be supplied. If more than one client matches the user, the values reported are the sum of all matching clients.

The user specified may have a domain, which restricts matching to that domain, or the domain may be "*" or left blank to match any domain. The user account may be specified, or may be "*" to match any user.

-h <host>: If per-client stats are being gathered, specifies a host to match for stats reporting. More than one -h <host> option may be supplied. If more than one client matches the host, the values reported are the sum of all matching clients.

The host may be an IP address in dot notation, or it may be any host name found using DNS if that is enabled on the filer.

-v[v]: If per-client stats are being reported using the -u or -h options, it may be desirable to know which clients contributed to the total stats being reported. If -v is given, the count of the number of matching clients is printed prior to the stats themselves. If -vv is given, the actual matching clients are also printed prior to printing the stats themselves.

-c: Displays counts and percentages for non_blocking CIFS operations as well as block_ing, which is the default. This option is not available in combination with the perclient options.

-z: Zeroes all CIFS operation counters, including per-client counters, if any.

EXAMPLE

toaster> cifs stat 10

    GetAttr      Read     Write      Lock   Open/Cl    Direct     Other         175       142         3        70      115        642        50           0         0         0         0        0         18         0           0         8         0         0        3          8         0           0        10         0         0        0          0         0           0         6         0         0        1          0         0           0         0         0         0        0          0         0

NOTES

If vfilers are licensed the per-user statistics are only available when in a vfiler context. That means that when using the -u <user> or -h <host> options with the "cifs stat" command it must be invoked using "vfiler run”, even for the hosting filer. For example,