1 '\" te
   2 .\"  Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
   4 .\"  See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with
   5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH NFSSTAT 1M "Jun 16, 2009"
   7 .SH NAME
   8 nfsstat \- NFS statistics
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBnfsstat\fR [\fB-cnrsza\fR] [\fB-T\fR u | d ] [\fB-v\fR \fIversion\fR] [\fIinterval\fR [\fIcount\fR]]
  13 .fi
  14 
  15 .LP
  16 .nf
  17 \fBnfsstat\fR \fB-m\fR [\fIpathname\fR]...
  18 .fi
  19 
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 \fBnfsstat\fR displays statistical information about the \fBNFS\fR and
  24 \fBRPC\fR (Remote Procedure Call), interfaces to the kernel. It can also be
  25 used to reinitialize this information. If no options are given the default is
  26 as follows:
  27 .sp
  28 .LP
  29 \fBnfsstat\fR \fB-csnra\fR
  30 .sp
  31 .LP
  32 The default displays everything, but reinitializes nothing.
  33 .SH OPTIONS
  34 .sp
  35 .ne 2
  36 .na
  37 \fB\fB-a\fR\fR
  38 .ad
  39 .sp .6
  40 .RS 4n
  41 Display \fBNFS_ACL\fR information.
  42 .RE
  43 
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fB-c\fR\fR
  48 .ad
  49 .sp .6
  50 .RS 4n
  51 Display client information. Only the client side \fBNFS\fR, \fBRPC\fR, and
  52 \fBNFS_ACL\fR information is printed. Can be combined with the \fB-n\fR,
  53 \fB-r\fR, and \fB-a\fR options to print client side \fBNFS\fR, \fBRPC\fR, and
  54 \fBNFS_ACL\fR information only.

 133 .sp .6
 134 .RS 4n
 135 Specify which NFS version for which to print statistics. When followed by the
 136 optional \fIversion\fR argument, (\fB2\fR|\fB3\fR|\fB4\fR), specifies
 137 statistics for that version. By default, prints statistics for all versions.
 138 .RE
 139 
 140 .sp
 141 .ne 2
 142 .na
 143 \fB\fB-z\fR\fR
 144 .ad
 145 .sp .6
 146 .RS 4n
 147 Zero (reinitialize) statistics. This option is for use by the super user only,
 148 and can be combined with any of the above options to zero particular sets of
 149 statistics after printing them.
 150 .RE
 151 
 152 .SH OPERANDS
 153 .sp
 154 .LP
 155 The following operands are supported:
 156 .sp
 157 .ne 2
 158 .na
 159 \fB\fIcount\fR\fR
 160 .ad
 161 .sp .6
 162 .RS 4n
 163 Display only count reports
 164 .RE
 165 
 166 .sp
 167 .ne 2
 168 .na
 169 \fB\fIinterval\fR\fR
 170 .ad
 171 .sp .6
 172 .RS 4n
 173 Report once each interval seconds.
 174 .RE
 175 
 176 .sp
 177 .ne 2
 178 .na
 179 \fB\fIpathname\fR\fR
 180 .ad
 181 .sp .6
 182 .RS 4n
 183 Specify the pathname of a file in an NFS mounted file system for which
 184 statistics are to be displayed.
 185 .RE
 186 
 187 .SH DISPLAYS
 188 .sp
 189 .LP
 190 The server \fBRPC\fR display includes the following fields:
 191 .sp
 192 .ne 2
 193 .na
 194 \fB\fBbadcalls\fR\fR
 195 .ad
 196 .sp .6
 197 .RS 4n
 198 The total number of calls rejected by the \fBRPC\fR layer (the sum of
 199 \fBbadlen\fR and \fBxdrcall\fR as defined below).
 200 .RE
 201 
 202 .sp
 203 .ne 2
 204 .na
 205 \fB\fBbadlen\fR\fR
 206 .ad
 207 .sp .6
 208 .RS 4n

 720 \fB\fBproto\fR\fR
 721 .ad
 722 .sp .6
 723 .RS 4n
 724 Protocol.
 725 .RE
 726 
 727 .sp
 728 .ne 2
 729 .na
 730 \fB\fBvers\fR\fR
 731 .ad
 732 .sp .6
 733 .RS 4n
 734 \fBNFS\fR version.
 735 .RE
 736 
 737 .sp
 738 .LP
 739 The \fB-m\fR option also provides attribute cache timeout values. The following
 740 fields in \fB-m\fR ouput provide timeout values for attribute cache:
 741 .sp
 742 .ne 2
 743 .na
 744 \fB\fBacdirmax\fR\fR
 745 .ad
 746 .sp .6
 747 .RS 4n
 748 Maximum seconds to hold cached directory attributes.
 749 .RE
 750 
 751 .sp
 752 .ne 2
 753 .na
 754 \fB\fBacdirmin\fR\fR
 755 .ad
 756 .sp .6
 757 .RS 4n
 758 Minimum seconds to hold cached directory attributes.
 759 .RE
 760 

 841 .ne 2
 842 .na
 843 \fB\fBdev\fR\fR
 844 .ad
 845 .sp .6
 846 .RS 4n
 847 Estimated deviation, in milliseconds.
 848 .RE
 849 
 850 .sp
 851 .ne 2
 852 .na
 853 \fB\fBsrtt\fR\fR
 854 .ad
 855 .sp .6
 856 .RS 4n
 857 The value for the smoothed round-trip time, in milliseconds.
 858 .RE
 859 
 860 .SH EXIT STATUS
 861 .sp
 862 .LP
 863 The following exit values are returned:
 864 .sp
 865 .ne 2
 866 .na
 867 \fB\fB0\fR\fR
 868 .ad
 869 .sp .6
 870 .RS 4n
 871 Successful completion.
 872 .RE
 873 
 874 .sp
 875 .ne 2
 876 .na
 877 \fB\fB>0\fR\fR
 878 .ad
 879 .sp .6
 880 .RS 4n
 881 An error occurred.
 882 .RE
 883 
 884 .SH SEE ALSO
 885 .sp
 886 .LP
 887 \fBmount_nfs\fR(1M), \fBattributes\fR(5)
 888 .sp
 889 .LP
 890 \fI\fR
 891 .sp
 892 .LP
 893 \fI\fR

   1 '\" te
   2 .\"  Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
   4 .\"  See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with
   5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH NFSSTAT 1M "Jun 16, 2009"
   7 .SH NAME
   8 nfsstat \- NFS statistics
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBnfsstat\fR [\fB-cnrsza\fR] [\fB-T\fR u | d ] [\fB-v\fR \fIversion\fR] [\fIinterval\fR [\fIcount\fR]]
  13 .fi
  14 
  15 .LP
  16 .nf
  17 \fBnfsstat\fR \fB-m\fR [\fIpathname\fR]...
  18 .fi
  19 
  20 .SH DESCRIPTION

  21 .LP
  22 \fBnfsstat\fR displays statistical information about the \fBNFS\fR and
  23 \fBRPC\fR (Remote Procedure Call), interfaces to the kernel. It can also be
  24 used to reinitialize this information. If no options are given the default is
  25 as follows:
  26 .sp
  27 .LP
  28 \fBnfsstat\fR \fB-csnra\fR
  29 .sp
  30 .LP
  31 The default displays everything, but reinitializes nothing.
  32 .SH OPTIONS

  33 .ne 2
  34 .na
  35 \fB\fB-a\fR\fR
  36 .ad
  37 .sp .6
  38 .RS 4n
  39 Display \fBNFS_ACL\fR information.
  40 .RE
  41 
  42 .sp
  43 .ne 2
  44 .na
  45 \fB\fB-c\fR\fR
  46 .ad
  47 .sp .6
  48 .RS 4n
  49 Display client information. Only the client side \fBNFS\fR, \fBRPC\fR, and
  50 \fBNFS_ACL\fR information is printed. Can be combined with the \fB-n\fR,
  51 \fB-r\fR, and \fB-a\fR options to print client side \fBNFS\fR, \fBRPC\fR, and
  52 \fBNFS_ACL\fR information only.

 131 .sp .6
 132 .RS 4n
 133 Specify which NFS version for which to print statistics. When followed by the
 134 optional \fIversion\fR argument, (\fB2\fR|\fB3\fR|\fB4\fR), specifies
 135 statistics for that version. By default, prints statistics for all versions.
 136 .RE
 137 
 138 .sp
 139 .ne 2
 140 .na
 141 \fB\fB-z\fR\fR
 142 .ad
 143 .sp .6
 144 .RS 4n
 145 Zero (reinitialize) statistics. This option is for use by the super user only,
 146 and can be combined with any of the above options to zero particular sets of
 147 statistics after printing them.
 148 .RE
 149 
 150 .SH OPERANDS

 151 .LP
 152 The following operands are supported:
 153 .sp
 154 .ne 2
 155 .na
 156 \fB\fIcount\fR\fR
 157 .ad
 158 .sp .6
 159 .RS 4n
 160 Display only count reports
 161 .RE
 162 
 163 .sp
 164 .ne 2
 165 .na
 166 \fB\fIinterval\fR\fR
 167 .ad
 168 .sp .6
 169 .RS 4n
 170 Report once each interval seconds.
 171 .RE
 172 
 173 .sp
 174 .ne 2
 175 .na
 176 \fB\fIpathname\fR\fR
 177 .ad
 178 .sp .6
 179 .RS 4n
 180 Specify the pathname of a file in an NFS mounted file system for which
 181 statistics are to be displayed.
 182 .RE
 183 
 184 .SH DISPLAYS

 185 .LP
 186 The server \fBRPC\fR display includes the following fields:
 187 .sp
 188 .ne 2
 189 .na
 190 \fB\fBbadcalls\fR\fR
 191 .ad
 192 .sp .6
 193 .RS 4n
 194 The total number of calls rejected by the \fBRPC\fR layer (the sum of
 195 \fBbadlen\fR and \fBxdrcall\fR as defined below).
 196 .RE
 197 
 198 .sp
 199 .ne 2
 200 .na
 201 \fB\fBbadlen\fR\fR
 202 .ad
 203 .sp .6
 204 .RS 4n

 716 \fB\fBproto\fR\fR
 717 .ad
 718 .sp .6
 719 .RS 4n
 720 Protocol.
 721 .RE
 722 
 723 .sp
 724 .ne 2
 725 .na
 726 \fB\fBvers\fR\fR
 727 .ad
 728 .sp .6
 729 .RS 4n
 730 \fBNFS\fR version.
 731 .RE
 732 
 733 .sp
 734 .LP
 735 The \fB-m\fR option also provides attribute cache timeout values. The following
 736 fields in \fB-m\fR output provide timeout values for attribute cache:
 737 .sp
 738 .ne 2
 739 .na
 740 \fB\fBacdirmax\fR\fR
 741 .ad
 742 .sp .6
 743 .RS 4n
 744 Maximum seconds to hold cached directory attributes.
 745 .RE
 746 
 747 .sp
 748 .ne 2
 749 .na
 750 \fB\fBacdirmin\fR\fR
 751 .ad
 752 .sp .6
 753 .RS 4n
 754 Minimum seconds to hold cached directory attributes.
 755 .RE
 756 

 837 .ne 2
 838 .na
 839 \fB\fBdev\fR\fR
 840 .ad
 841 .sp .6
 842 .RS 4n
 843 Estimated deviation, in milliseconds.
 844 .RE
 845 
 846 .sp
 847 .ne 2
 848 .na
 849 \fB\fBsrtt\fR\fR
 850 .ad
 851 .sp .6
 852 .RS 4n
 853 The value for the smoothed round-trip time, in milliseconds.
 854 .RE
 855 
 856 .SH EXIT STATUS

 857 .LP
 858 The following exit values are returned:
 859 .sp
 860 .ne 2
 861 .na
 862 \fB\fB0\fR\fR
 863 .ad
 864 .sp .6
 865 .RS 4n
 866 Successful completion.
 867 .RE
 868 
 869 .sp
 870 .ne 2
 871 .na
 872 \fB\fB>0\fR\fR
 873 .ad
 874 .sp .6
 875 .RS 4n
 876 An error occurred.
 877 .RE
 878 
 879 .SH SEE ALSO

 880 .LP
 881 \fBmount_nfs\fR(1M), \fBattributes\fR(5)
 882 .sp
 883 .LP
 884 \fI\fR
 885 .sp
 886 .LP
 887 \fI\fR