From jb25718@sac.sfbay.sun.com Wed Apr  7 17:51:36 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o380pako027161
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 7 Apr 2010 17:51:36 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o380papZ017428;
	Wed, 7 Apr 2010 17:51:36 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00H03920A500@nwk-avmta-1.sfbay.Sun.COM>; Wed,
 07 Apr 2010 17:51:36 -0700 (PDT)
Received: from dm-sfbay-01.sfbay.sun.com ([129.145.155.118])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J0001I91ZGN90@nwk-avmta-1.sfbay.Sun.COM>; Wed,
 07 Apr 2010 17:51:35 -0700 (PDT)
Received: from sac.sfbay.sun.com (sac.SFBay.Sun.COM [129.146.226.132])
	by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4)
 with ESMTP id o380pZX9027126; Wed, 07 Apr 2010 17:51:35 -0700 (PDT)
Received: from sac.sfbay.sun.com (localhost [127.0.0.1])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o380pYMW027156; Wed,
 07 Apr 2010 17:51:34 -0700 (PDT)
Received: (from jb25718@localhost)
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id o380pYGC027152; Wed,
 07 Apr 2010 17:51:34 -0700 (PDT)
Date: Wed, 07 Apr 2010 17:51:34 -0700 (PDT)
From: Jordan Brown <jb25718@sac.sfbay.sun.com>
Subject: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
To: PSARC-ext@sun.com
Cc: smb-eng_ww@oracle.com
Message-id: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 11800


Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
This information is Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
1. Introduction
    1.1. Project/Component Working Name:
	 SMB/CIFS Statistics
    1.2. Name of Document Author/Supplier:
	 Author:  Jose Borrego
    1.3  Date of This Document:
	07 April, 2010

    1.4. Name of Major Document Customer(s)/Consumer(s):
         PSARC
	CIFS team

    1.5. Email Aliases:
     	1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
     	1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
     	1.5.3. Marketing Manager:
	1.5.4. Interest List: cifs-team@sun.com

4. Technical Description:

Executive Summary:

    This case improves the statistics the SMB/CIFS server maintains as well as
    the output of smbstat.

Problem:

    Currently the only statistics the SMB/CIFS server maintains are counters
    keeping track of how many requests of each type were received, the number
    of open files, the number of sessions (users logged in) and the number of
    connections (trees connected). Those statistics are not enough to describe
    the load being applied as well as how the server is responding to it.

Solution:

    In order to get a better picture of the state of the SMB/CIFS server the
    following information can be maintained and provided through smbstat:

    - Counters:
	* nbt:
	    Number of SMB NetBIOS-over-TCP (NBT) sessions.

	* tcp:
	    Number of SMB TCP sessions.

	* users:
	    Number of users logged in.

	* trees:
	    Number of trees connected.

	* files:
	    Number of open files.

	* pipes:
	    Number of open pipes.

    - Throughput:
	* rbytes/s:
	    Number of bytes received per second.

	* tbytes/s:
	    Number of bytes transmitted per second.

	* reqs/s:
	    Number of requests handled per second.

	* reads/s:
	    Number of read requests per second. This would be an aggregation of
	    the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
	    SMB_COM_READ_RAW and SMB_COM_READ_ANDX.

	* writes/s:
	    Number of write requests per second. This would ba an aggregation of
	    the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
	    SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.

    - Utilization:
        * wcnt:
	    Average number of requests received but waiting for an SMB worker
	    thread to execute them.

        * rcnt:
	    Average number of requests being simultaneously executed by an SMB
	    worker thread.

	* wtime:
	    Average time a request waits before an SMB worker thread starts
	    executing it.

        * rtime:
	    Average execution time of a request.

        * w%:
	    Percentage of the time during which at least one request was
	    waiting.

        * r%:
	    Percentage of the time during which at least one request was being
	    executed.

        * u%:
	    Percentage of utilization of the SMB/CIFS server. This number is
	    defined as: rcnt / (Max Worker Threads).

        * sat:
	    Flag indicating if the server saturated in the past. Saturation is
	    defined as: u% == 100%.

	* usr%:
	    Percentage of the time the processor(s) spent in user space.

	* sys%:
	    Percentage of the time the processor(s) spent in kernel space.

	* idle%:
	    Percentage of the time the processor(s) was(were) idle.

    - Requests:
        For each type of request:
        * %:
	    Percentage of that type of request.

        * rbytes/s:
	    Number of bytes received per second.

        * tbytes/s:
	    Number of bytes received per second.

        * req/s:
	    Number of requests handled per second.

        * rt-mean:
	    Average response time in seconds.

        *  rt-stddev:
	    Standard deviation of the response time.

    To access this information the CLI smbstat must be modified and allow the
    following options:

    -r  Display the statistics of the requests.

        -a  Display the statistics of all the types of request (the 256 of
            them) whether they are valid or not.

        -n  Display in alphabetic order.

        -z  Display the statistics of the requests actually received.

    -t  Display the throughput of the SMB/CIFS server.

    -u  Display the utilization of the SMB/CIFS server.

    -c  Display the counters.

    A number can also be provided indicating the interval of time between
    refreshes. The first statistics displayed cover the time between when
    the server was started and the moment the statistics were requested.
    Subsequent refreshes cover the last time interval only.

    It should be noted that the output is all new replacing the old one and
    is for humans only.

Examples of smbstat output:

    '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

    'smbstat -r'

                               code   %   rbytes/s   tbytes/s     req/s     rt-mean   rt-stddev
            SmbCreateDirectory  00     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
            SmbDeleteDirectory  01     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                       SmbOpen  02     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                     SmbCreate  03     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                      SmbClose  04     0  0.000e+00  0.000e+00  0.000e+00  2.496e-04  8.003e-06
                      SmbFlush  05     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                     SmbDelete  06     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                     SmbRename  07     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
           SmbQueryInformation  08     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
             SmbSetInformation  09     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                       SmbRead  0A     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                      SmbWrite  0B     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
              SmbLockByteRange  0C     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
            SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
            SmbCreateTemporary  0E     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                  SmbCreateNew  0F     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
             SmbCheckDirectory  10     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                SmbProcessExit  11     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                       SmbSeek  12     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                SmbLockAndRead  13     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
             SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                    SmbReadRaw  1A     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                   SmbWriteRaw  1D     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
            SmbSetInformation2  22     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
          SmbQueryInformation2  23     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                   SmbLockingX  24     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                SmbTransaction  25     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
       SmbTransactionSecondary  26     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                      SmbIoctl  27     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                       SmbEcho  2B     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
              SmbWriteAndClose  2C     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                      SmbOpenX  2D     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                      SmbReadX  2E     0  0.000e+00  0.000e+00  0.000e+00  3.550e-04  1.856e-05
                     SmbWriteX  2F   100  4.607e+02  1.675e+00  0.000e+00  3.893e-04  2.691e-07
     SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
               SmbTransaction2  32     0  0.000e+00  0.000e+00  0.000e+00  5.203e-04  8.612e-06
      SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                 SmbFindClose2  34     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                SmbTreeConnect  70     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
             SmbTreeDisconnect  71     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                  SmbNegotiate  72     0  0.000e+00  0.000e+00  0.000e+00  4.625e-05  0.000e+00
              SmbSessionSetupX  73     0  0.000e+00  0.000e+00  0.000e+00  1.145e-01  0.000e+00
                    SmbLogoffX  74     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
               SmbTreeConnectX  75     0  0.000e+00  0.000e+00  0.000e+00  5.851e-04  2.436e-05
       SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                     SmbSearch  81     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                       SmbFind  82     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                 SmbFindUnique  83     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                  SmbFindClose  84     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                 SmbNtTransact  A0     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
        SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                  SmbNtCreateX  A2     0  0.000e+00  0.000e+00  0.000e+00  5.154e-02  2.063e-03
                   SmbNtCancel  A4     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
                   SmbNtRename  A5     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
              SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
             SmbWritePrintFile  C1     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
             SmbClosePrintFile  C2     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
              SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00

    'smbstat -rz'

                               code   %   rbytes/s   tbytes/s     req/s     rt-mean   rt-stddev
                      SmbClose  04     0  0.000e+00  0.000e+00  0.000e+00  2.445e-04  5.906e-06
                      SmbReadX  2E     4  0.000e+00  2.772e+01  0.000e+00  1.556e-03  7.878e-06
                     SmbWriteX  2F    96  7.162e+02  2.604e+00  0.000e+00  5.365e-04  3.913e-07
               SmbTransaction2  32     0  0.000e+00  0.000e+00  0.000e+00  5.203e-04  8.612e-06
                  SmbNegotiate  72     0  0.000e+00  0.000e+00  0.000e+00  4.625e-05  0.000e+00
              SmbSessionSetupX  73     0  0.000e+00  0.000e+00  0.000e+00  1.145e-01  0.000e+00
               SmbTreeConnectX  75     0  0.000e+00  0.000e+00  0.000e+00  5.851e-04  2.436e-05
                  SmbNtCreateX  A2     0  0.000e+00  0.000e+00  0.000e+00  7.250e-02  2.304e-03

6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		ON
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open

From garrett.damore@oracle.com Wed Apr  7 20:59:17 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o383xHYV029882
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 7 Apr 2010 20:59:17 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o383xG59014938
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 7 Apr 2010 20:59:16 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00005HQS2A00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 07 Apr 2010 21:59:16 -0600 (MDT)
Received: from sca-ea-mail-4.sun.com ([192.18.43.22])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J00LJUHQSRP10@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 07 Apr 2010 21:59:16 -0600 (MDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by sca-ea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o383xFZ2029288	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 03:59:15 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o383xEG8023304	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 03:59:14 +0000 (GMT)
Received: from abhmt004.oracle.com by acsmt355.oracle.com	with ESMTP id
 156331541270699151; Wed, 07 Apr 2010 20:59:11 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Wed,
 07 Apr 2010 20:59:10 -0700
Date: Wed, 07 Apr 2010 20:59:09 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
To: Jordan Brown <jb25718@sac.sfbay.sun.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBD548D.4060509@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090202.4BBD5493.0070:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 12623


What's missing is an interface table.  I think though that based on the 
statement that its not to be parsed ("for humans only"), the output is 
not-an-interface.

     - Garrett

On 04/ 7/10 05:51 PM, Jordan Brown wrote:
> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
> This information is Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
> 1. Introduction
>      1.1. Project/Component Working Name:
> 	 SMB/CIFS Statistics
>      1.2. Name of Document Author/Supplier:
> 	 Author:  Jose Borrego
>      1.3  Date of This Document:
> 	07 April, 2010
>
>      1.4. Name of Major Document Customer(s)/Consumer(s):
>           PSARC
> 	CIFS team
>
>      1.5. Email Aliases:
>       	1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>       	1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>       	1.5.3. Marketing Manager:
> 	1.5.4. Interest List: cifs-team@sun.com
>
> 4. Technical Description:
>
> Executive Summary:
>
>      This case improves the statistics the SMB/CIFS server maintains as well as
>      the output of smbstat.
>
> Problem:
>
>      Currently the only statistics the SMB/CIFS server maintains are counters
>      keeping track of how many requests of each type were received, the number
>      of open files, the number of sessions (users logged in) and the number of
>      connections (trees connected). Those statistics are not enough to describe
>      the load being applied as well as how the server is responding to it.
>
> Solution:
>
>      In order to get a better picture of the state of the SMB/CIFS server the
>      following information can be maintained and provided through smbstat:
>
>      - Counters:
> 	* nbt:
> 	    Number of SMB NetBIOS-over-TCP (NBT) sessions.
>
> 	* tcp:
> 	    Number of SMB TCP sessions.
>
> 	* users:
> 	    Number of users logged in.
>
> 	* trees:
> 	    Number of trees connected.
>
> 	* files:
> 	    Number of open files.
>
> 	* pipes:
> 	    Number of open pipes.
>
>      - Throughput:
> 	* rbytes/s:
> 	    Number of bytes received per second.
>
> 	* tbytes/s:
> 	    Number of bytes transmitted per second.
>
> 	* reqs/s:
> 	    Number of requests handled per second.
>
> 	* reads/s:
> 	    Number of read requests per second. This would be an aggregation of
> 	    the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
> 	    SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>
> 	* writes/s:
> 	    Number of write requests per second. This would ba an aggregation of
> 	    the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
> 	    SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>
>      - Utilization:
>          * wcnt:
> 	    Average number of requests received but waiting for an SMB worker
> 	    thread to execute them.
>
>          * rcnt:
> 	    Average number of requests being simultaneously executed by an SMB
> 	    worker thread.
>
> 	* wtime:
> 	    Average time a request waits before an SMB worker thread starts
> 	    executing it.
>
>          * rtime:
> 	    Average execution time of a request.
>
>          * w%:
> 	    Percentage of the time during which at least one request was
> 	    waiting.
>
>          * r%:
> 	    Percentage of the time during which at least one request was being
> 	    executed.
>
>          * u%:
> 	    Percentage of utilization of the SMB/CIFS server. This number is
> 	    defined as: rcnt / (Max Worker Threads).
>
>          * sat:
> 	    Flag indicating if the server saturated in the past. Saturation is
> 	    defined as: u% == 100%.
>
> 	* usr%:
> 	    Percentage of the time the processor(s) spent in user space.
>
> 	* sys%:
> 	    Percentage of the time the processor(s) spent in kernel space.
>
> 	* idle%:
> 	    Percentage of the time the processor(s) was(were) idle.
>
>      - Requests:
>          For each type of request:
>          * %:
> 	    Percentage of that type of request.
>
>          * rbytes/s:
> 	    Number of bytes received per second.
>
>          * tbytes/s:
> 	    Number of bytes received per second.
>
>          * req/s:
> 	    Number of requests handled per second.
>
>          * rt-mean:
> 	    Average response time in seconds.
>
>          *  rt-stddev:
> 	    Standard deviation of the response time.
>
>      To access this information the CLI smbstat must be modified and allow the
>      following options:
>
>      -r  Display the statistics of the requests.
>
>          -a  Display the statistics of all the types of request (the 256 of
>              them) whether they are valid or not.
>
>          -n  Display in alphabetic order.
>
>          -z  Display the statistics of the requests actually received.
>
>      -t  Display the throughput of the SMB/CIFS server.
>
>      -u  Display the utilization of the SMB/CIFS server.
>
>      -c  Display the counters.
>
>      A number can also be provided indicating the interval of time between
>      refreshes. The first statistics displayed cover the time between when
>      the server was started and the moment the statistics were requested.
>      Subsequent refreshes cover the last time interval only.
>
>      It should be noted that the output is all new replacing the old one and
>      is for humans only.
>
> Examples of smbstat output:
>
>      '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
>
>      'smbstat -r'
>
>                                 code   %   rbytes/s   tbytes/s     req/s     rt-mean   rt-stddev
>              SmbCreateDirectory  00     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>              SmbDeleteDirectory  01     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbOpen  02     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                       SmbCreate  03     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbClose  04     0  0.000e+00  0.000e+00  0.000e+00  2.496e-04  8.003e-06
>                        SmbFlush  05     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                       SmbDelete  06     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                       SmbRename  07     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>             SmbQueryInformation  08     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbSetInformation  09     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbRead  0A     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbWrite  0B     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                SmbLockByteRange  0C     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>              SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>              SmbCreateTemporary  0E     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                    SmbCreateNew  0F     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbCheckDirectory  10     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                  SmbProcessExit  11     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbSeek  12     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                  SmbLockAndRead  13     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                      SmbReadRaw  1A     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                     SmbWriteRaw  1D     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>              SmbSetInformation2  22     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>            SmbQueryInformation2  23     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                     SmbLockingX  24     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                  SmbTransaction  25     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>         SmbTransactionSecondary  26     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbIoctl  27     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbEcho  2B     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                SmbWriteAndClose  2C     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbOpenX  2D     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbReadX  2E     0  0.000e+00  0.000e+00  0.000e+00  3.550e-04  1.856e-05
>                       SmbWriteX  2F   100  4.607e+02  1.675e+00  0.000e+00  3.893e-04  2.691e-07
>       SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  0.000e+00  5.203e-04  8.612e-06
>        SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                   SmbFindClose2  34     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                  SmbTreeConnect  70     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbTreeDisconnect  71     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  0.000e+00  4.625e-05  0.000e+00
>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  0.000e+00  1.145e-01  0.000e+00
>                      SmbLogoffX  74     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  0.000e+00  5.851e-04  2.436e-05
>         SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                       SmbSearch  81     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbFind  82     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                   SmbFindUnique  83     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                    SmbFindClose  84     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                   SmbNtTransact  A0     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>          SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  0.000e+00  5.154e-02  2.063e-03
>                     SmbNtCancel  A4     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                     SmbNtRename  A5     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbWritePrintFile  C1     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbClosePrintFile  C2     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>
>      'smbstat -rz'
>
>                                 code   %   rbytes/s   tbytes/s     req/s     rt-mean   rt-stddev
>                        SmbClose  04     0  0.000e+00  0.000e+00  0.000e+00  2.445e-04  5.906e-06
>                        SmbReadX  2E     4  0.000e+00  2.772e+01  0.000e+00  1.556e-03  7.878e-06
>                       SmbWriteX  2F    96  7.162e+02  2.604e+00  0.000e+00  5.365e-04  3.913e-07
>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  0.000e+00  5.203e-04  8.612e-06
>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  0.000e+00  4.625e-05  0.000e+00
>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  0.000e+00  1.145e-01  0.000e+00
>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  0.000e+00  5.851e-04  2.436e-05
>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  0.000e+00  7.250e-02  2.304e-03
>
> 6. Resources and Schedule
>      6.4. Steering Committee requested information
>     	6.4.1. Consolidation C-team Name:
> 		ON
>      6.5. ARC review type: FastTrack
>      6.6. ARC Exposure: open
>    


From garrett.damore@oracle.com Wed Apr  7 20:59:18 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o383xHQI029886
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 7 Apr 2010 20:59:17 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o383xHKS026552
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 7 Apr 2010 20:59:17 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00B01HQTQD00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 07 Apr 2010 20:59:17 -0700 (PDT)
Received: from sca-ea-mail-3.sun.com ([192.18.43.21])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J002L2HQTVP60@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 07 Apr 2010 20:59:17 -0700 (PDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by sca-ea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o383xGft005035	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 03:59:16 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o383xEGA023304	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 03:59:16 +0000 (GMT)
Received: from abhmt004.oracle.com by acsmt355.oracle.com	with ESMTP id
 156331541270699151; Wed, 07 Apr 2010 20:59:11 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Wed,
 07 Apr 2010 20:59:10 -0700
Date: Wed, 07 Apr 2010 20:59:09 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
To: Jordan Brown <jb25718@sac.sfbay.sun.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBD548D.4060509@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090203.4BBD5494.0092:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 12623


What's missing is an interface table.  I think though that based on the 
statement that its not to be parsed ("for humans only"), the output is 
not-an-interface.

     - Garrett

On 04/ 7/10 05:51 PM, Jordan Brown wrote:
> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
> This information is Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
> 1. Introduction
>      1.1. Project/Component Working Name:
> 	 SMB/CIFS Statistics
>      1.2. Name of Document Author/Supplier:
> 	 Author:  Jose Borrego
>      1.3  Date of This Document:
> 	07 April, 2010
>
>      1.4. Name of Major Document Customer(s)/Consumer(s):
>           PSARC
> 	CIFS team
>
>      1.5. Email Aliases:
>       	1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>       	1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>       	1.5.3. Marketing Manager:
> 	1.5.4. Interest List: cifs-team@sun.com
>
> 4. Technical Description:
>
> Executive Summary:
>
>      This case improves the statistics the SMB/CIFS server maintains as well as
>      the output of smbstat.
>
> Problem:
>
>      Currently the only statistics the SMB/CIFS server maintains are counters
>      keeping track of how many requests of each type were received, the number
>      of open files, the number of sessions (users logged in) and the number of
>      connections (trees connected). Those statistics are not enough to describe
>      the load being applied as well as how the server is responding to it.
>
> Solution:
>
>      In order to get a better picture of the state of the SMB/CIFS server the
>      following information can be maintained and provided through smbstat:
>
>      - Counters:
> 	* nbt:
> 	    Number of SMB NetBIOS-over-TCP (NBT) sessions.
>
> 	* tcp:
> 	    Number of SMB TCP sessions.
>
> 	* users:
> 	    Number of users logged in.
>
> 	* trees:
> 	    Number of trees connected.
>
> 	* files:
> 	    Number of open files.
>
> 	* pipes:
> 	    Number of open pipes.
>
>      - Throughput:
> 	* rbytes/s:
> 	    Number of bytes received per second.
>
> 	* tbytes/s:
> 	    Number of bytes transmitted per second.
>
> 	* reqs/s:
> 	    Number of requests handled per second.
>
> 	* reads/s:
> 	    Number of read requests per second. This would be an aggregation of
> 	    the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
> 	    SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>
> 	* writes/s:
> 	    Number of write requests per second. This would ba an aggregation of
> 	    the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
> 	    SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>
>      - Utilization:
>          * wcnt:
> 	    Average number of requests received but waiting for an SMB worker
> 	    thread to execute them.
>
>          * rcnt:
> 	    Average number of requests being simultaneously executed by an SMB
> 	    worker thread.
>
> 	* wtime:
> 	    Average time a request waits before an SMB worker thread starts
> 	    executing it.
>
>          * rtime:
> 	    Average execution time of a request.
>
>          * w%:
> 	    Percentage of the time during which at least one request was
> 	    waiting.
>
>          * r%:
> 	    Percentage of the time during which at least one request was being
> 	    executed.
>
>          * u%:
> 	    Percentage of utilization of the SMB/CIFS server. This number is
> 	    defined as: rcnt / (Max Worker Threads).
>
>          * sat:
> 	    Flag indicating if the server saturated in the past. Saturation is
> 	    defined as: u% == 100%.
>
> 	* usr%:
> 	    Percentage of the time the processor(s) spent in user space.
>
> 	* sys%:
> 	    Percentage of the time the processor(s) spent in kernel space.
>
> 	* idle%:
> 	    Percentage of the time the processor(s) was(were) idle.
>
>      - Requests:
>          For each type of request:
>          * %:
> 	    Percentage of that type of request.
>
>          * rbytes/s:
> 	    Number of bytes received per second.
>
>          * tbytes/s:
> 	    Number of bytes received per second.
>
>          * req/s:
> 	    Number of requests handled per second.
>
>          * rt-mean:
> 	    Average response time in seconds.
>
>          *  rt-stddev:
> 	    Standard deviation of the response time.
>
>      To access this information the CLI smbstat must be modified and allow the
>      following options:
>
>      -r  Display the statistics of the requests.
>
>          -a  Display the statistics of all the types of request (the 256 of
>              them) whether they are valid or not.
>
>          -n  Display in alphabetic order.
>
>          -z  Display the statistics of the requests actually received.
>
>      -t  Display the throughput of the SMB/CIFS server.
>
>      -u  Display the utilization of the SMB/CIFS server.
>
>      -c  Display the counters.
>
>      A number can also be provided indicating the interval of time between
>      refreshes. The first statistics displayed cover the time between when
>      the server was started and the moment the statistics were requested.
>      Subsequent refreshes cover the last time interval only.
>
>      It should be noted that the output is all new replacing the old one and
>      is for humans only.
>
> Examples of smbstat output:
>
>      '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
>
>      'smbstat -r'
>
>                                 code   %   rbytes/s   tbytes/s     req/s     rt-mean   rt-stddev
>              SmbCreateDirectory  00     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>              SmbDeleteDirectory  01     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbOpen  02     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                       SmbCreate  03     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbClose  04     0  0.000e+00  0.000e+00  0.000e+00  2.496e-04  8.003e-06
>                        SmbFlush  05     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                       SmbDelete  06     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                       SmbRename  07     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>             SmbQueryInformation  08     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbSetInformation  09     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbRead  0A     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbWrite  0B     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                SmbLockByteRange  0C     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>              SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>              SmbCreateTemporary  0E     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                    SmbCreateNew  0F     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbCheckDirectory  10     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                  SmbProcessExit  11     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbSeek  12     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                  SmbLockAndRead  13     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                      SmbReadRaw  1A     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                     SmbWriteRaw  1D     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>              SmbSetInformation2  22     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>            SmbQueryInformation2  23     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                     SmbLockingX  24     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                  SmbTransaction  25     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>         SmbTransactionSecondary  26     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbIoctl  27     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbEcho  2B     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                SmbWriteAndClose  2C     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbOpenX  2D     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                        SmbReadX  2E     0  0.000e+00  0.000e+00  0.000e+00  3.550e-04  1.856e-05
>                       SmbWriteX  2F   100  4.607e+02  1.675e+00  0.000e+00  3.893e-04  2.691e-07
>       SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  0.000e+00  5.203e-04  8.612e-06
>        SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                   SmbFindClose2  34     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                  SmbTreeConnect  70     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbTreeDisconnect  71     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  0.000e+00  4.625e-05  0.000e+00
>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  0.000e+00  1.145e-01  0.000e+00
>                      SmbLogoffX  74     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  0.000e+00  5.851e-04  2.436e-05
>         SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                       SmbSearch  81     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                         SmbFind  82     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                   SmbFindUnique  83     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                    SmbFindClose  84     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                   SmbNtTransact  A0     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>          SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  0.000e+00  5.154e-02  2.063e-03
>                     SmbNtCancel  A4     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                     SmbNtRename  A5     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbWritePrintFile  C1     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>               SmbClosePrintFile  C2     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>                SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00  0.000e+00  0.000e+00  0.000e+00
>
>      'smbstat -rz'
>
>                                 code   %   rbytes/s   tbytes/s     req/s     rt-mean   rt-stddev
>                        SmbClose  04     0  0.000e+00  0.000e+00  0.000e+00  2.445e-04  5.906e-06
>                        SmbReadX  2E     4  0.000e+00  2.772e+01  0.000e+00  1.556e-03  7.878e-06
>                       SmbWriteX  2F    96  7.162e+02  2.604e+00  0.000e+00  5.365e-04  3.913e-07
>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  0.000e+00  5.203e-04  8.612e-06
>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  0.000e+00  4.625e-05  0.000e+00
>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  0.000e+00  1.145e-01  0.000e+00
>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  0.000e+00  5.851e-04  2.436e-05
>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  0.000e+00  7.250e-02  2.304e-03
>
> 6. Resources and Schedule
>      6.4. Steering Committee requested information
>     	6.4.1. Consolidation C-team Name:
> 		ON
>      6.5. ARC review type: FastTrack
>      6.6. ARC Exposure: open
>    


From Jordan.Brown@oracle.com Wed Apr  7 22:47:33 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o385lXqp001110
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 7 Apr 2010 22:47:33 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o385lWs6011125
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 7 Apr 2010 23:47:32 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00J0DMR8J400@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 07 Apr 2010 22:47:32 -0700 (PDT)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J002NWMR7VTB0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 07 Apr 2010 22:47:32 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o385lVnp008863	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 05:47:31 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o385WEut014990	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 05:47:30 +0000 (GMT)
Received: from abhmt007.oracle.com by acsmt353.oracle.com	with ESMTP id
 145028921270705649; Wed, 07 Apr 2010 22:47:29 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Wed,
 07 Apr 2010 22:47:29 -0700
Date: Wed, 07 Apr 2010 22:47:27 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBD548D.4060509@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBD6DEF.7010400@oracle.com>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_4rH+nPJOzRgNEmDfVZgsEw)"
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090206.4BBD6DF3.0040:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 32694

This is a multi-part message in MIME format.

--Boundary_(ID_4rH+nPJOzRgNEmDfVZgsEw)
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT

Garrett D'Amore wrote:
>
> What's missing is an interface table.  I think though that based on 
> the statement that its not to be parsed ("for humans only"), the 
> output is not-an-interface.

Yes.  The stability is the same as the existing command:

    |_____________________________|_____________________________|
    | Interface Stability         | Uncommitted                 |
    |_____________________________|_____________________________|
    | Utility Output Format       | Not-an-Interface            |
    |_____________________________|_____________________________|



>
>     - Garrett
>
> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>> This information is Copyright (c) 2010, Oracle and/or its affiliates. 
>> All rights reserved.
>> 1. Introduction
>>      1.1. Project/Component Working Name:
>>      SMB/CIFS Statistics
>>      1.2. Name of Document Author/Supplier:
>>      Author:  Jose Borrego
>>      1.3  Date of This Document:
>>     07 April, 2010
>>
>>      1.4. Name of Major Document Customer(s)/Consumer(s):
>>           PSARC
>>     CIFS team
>>
>>      1.5. Email Aliases:
>>           1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>           1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>           1.5.3. Marketing Manager:
>>     1.5.4. Interest List: cifs-team@sun.com
>>
>> 4. Technical Description:
>>
>> Executive Summary:
>>
>>      This case improves the statistics the SMB/CIFS server maintains 
>> as well as
>>      the output of smbstat.
>>
>> Problem:
>>
>>      Currently the only statistics the SMB/CIFS server maintains are 
>> counters
>>      keeping track of how many requests of each type were received, 
>> the number
>>      of open files, the number of sessions (users logged in) and the 
>> number of
>>      connections (trees connected). Those statistics are not enough 
>> to describe
>>      the load being applied as well as how the server is responding 
>> to it.
>>
>> Solution:
>>
>>      In order to get a better picture of the state of the SMB/CIFS 
>> server the
>>      following information can be maintained and provided through 
>> smbstat:
>>
>>      - Counters:
>>     * nbt:
>>         Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>
>>     * tcp:
>>         Number of SMB TCP sessions.
>>
>>     * users:
>>         Number of users logged in.
>>
>>     * trees:
>>         Number of trees connected.
>>
>>     * files:
>>         Number of open files.
>>
>>     * pipes:
>>         Number of open pipes.
>>
>>      - Throughput:
>>     * rbytes/s:
>>         Number of bytes received per second.
>>
>>     * tbytes/s:
>>         Number of bytes transmitted per second.
>>
>>     * reqs/s:
>>         Number of requests handled per second.
>>
>>     * reads/s:
>>         Number of read requests per second. This would be an 
>> aggregation of
>>         the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>         SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>
>>     * writes/s:
>>         Number of write requests per second. This would ba an 
>> aggregation of
>>         the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>>         SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>
>>      - Utilization:
>>          * wcnt:
>>         Average number of requests received but waiting for an SMB 
>> worker
>>         thread to execute them.
>>
>>          * rcnt:
>>         Average number of requests being simultaneously executed by 
>> an SMB
>>         worker thread.
>>
>>     * wtime:
>>         Average time a request waits before an SMB worker thread starts
>>         executing it.
>>
>>          * rtime:
>>         Average execution time of a request.
>>
>>          * w%:
>>         Percentage of the time during which at least one request was
>>         waiting.
>>
>>          * r%:
>>         Percentage of the time during which at least one request was 
>> being
>>         executed.
>>
>>          * u%:
>>         Percentage of utilization of the SMB/CIFS server. This number is
>>         defined as: rcnt / (Max Worker Threads).
>>
>>          * sat:
>>         Flag indicating if the server saturated in the past. 
>> Saturation is
>>         defined as: u% == 100%.
>>
>>     * usr%:
>>         Percentage of the time the processor(s) spent in user space.
>>
>>     * sys%:
>>         Percentage of the time the processor(s) spent in kernel space.
>>
>>     * idle%:
>>         Percentage of the time the processor(s) was(were) idle.
>>
>>      - Requests:
>>          For each type of request:
>>          * %:
>>         Percentage of that type of request.
>>
>>          * rbytes/s:
>>         Number of bytes received per second.
>>
>>          * tbytes/s:
>>         Number of bytes received per second.
>>
>>          * req/s:
>>         Number of requests handled per second.
>>
>>          * rt-mean:
>>         Average response time in seconds.
>>
>>          *  rt-stddev:
>>         Standard deviation of the response time.
>>
>>      To access this information the CLI smbstat must be modified and 
>> allow the
>>      following options:
>>
>>      -r  Display the statistics of the requests.
>>
>>          -a  Display the statistics of all the types of request (the 
>> 256 of
>>              them) whether they are valid or not.
>>
>>          -n  Display in alphabetic order.
>>
>>          -z  Display the statistics of the requests actually received.
>>
>>      -t  Display the throughput of the SMB/CIFS server.
>>
>>      -u  Display the utilization of the SMB/CIFS server.
>>
>>      -c  Display the counters.
>>
>>      A number can also be provided indicating the interval of time 
>> between
>>      refreshes. The first statistics displayed cover the time between 
>> when
>>      the server was started and the moment the statistics were 
>> requested.
>>      Subsequent refreshes cover the last time interval only.
>>
>>      It should be noted that the output is all new replacing the old 
>> one and
>>      is for humans only.
>>
>> Examples of smbstat output:
>>
>>      '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
>>
>>      'smbstat -r'
>>
>>                                 code   %   rbytes/s   tbytes/s     
>> req/s     rt-mean   rt-stddev
>>              SmbCreateDirectory  00     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>              SmbDeleteDirectory  01     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbOpen  02     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                       SmbCreate  03     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbClose  04     0  0.000e+00  0.000e+00  
>> 0.000e+00  2.496e-04  8.003e-06
>>                        SmbFlush  05     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                       SmbDelete  06     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                       SmbRename  07     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>             SmbQueryInformation  08     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbSetInformation  09     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbRead  0A     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbWrite  0B     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                SmbLockByteRange  0C     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>              SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>              SmbCreateTemporary  0E     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                    SmbCreateNew  0F     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbCheckDirectory  10     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                  SmbProcessExit  11     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbSeek  12     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                  SmbLockAndRead  13     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                      SmbReadRaw  1A     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                     SmbWriteRaw  1D     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>              SmbSetInformation2  22     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>            SmbQueryInformation2  23     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                     SmbLockingX  24     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                  SmbTransaction  25     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>         SmbTransactionSecondary  26     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbIoctl  27     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbEcho  2B     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                SmbWriteAndClose  2C     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbOpenX  2D     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbReadX  2E     0  0.000e+00  0.000e+00  
>> 0.000e+00  3.550e-04  1.856e-05
>>                       SmbWriteX  2F   100  4.607e+02  1.675e+00  
>> 0.000e+00  3.893e-04  2.691e-07
>>       SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.203e-04  8.612e-06
>>        SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                   SmbFindClose2  34     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                  SmbTreeConnect  70     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbTreeDisconnect  71     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  
>> 0.000e+00  4.625e-05  0.000e+00
>>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  
>> 0.000e+00  1.145e-01  0.000e+00
>>                      SmbLogoffX  74     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.851e-04  2.436e-05
>>         SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                       SmbSearch  81     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbFind  82     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                   SmbFindUnique  83     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                    SmbFindClose  84     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                   SmbNtTransact  A0     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>          SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.154e-02  2.063e-03
>>                     SmbNtCancel  A4     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                     SmbNtRename  A5     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbWritePrintFile  C1     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbClosePrintFile  C2     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>
>>      'smbstat -rz'
>>
>>                                 code   %   rbytes/s   tbytes/s     
>> req/s     rt-mean   rt-stddev
>>                        SmbClose  04     0  0.000e+00  0.000e+00  
>> 0.000e+00  2.445e-04  5.906e-06
>>                        SmbReadX  2E     4  0.000e+00  2.772e+01  
>> 0.000e+00  1.556e-03  7.878e-06
>>                       SmbWriteX  2F    96  7.162e+02  2.604e+00  
>> 0.000e+00  5.365e-04  3.913e-07
>>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.203e-04  8.612e-06
>>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  
>> 0.000e+00  4.625e-05  0.000e+00
>>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  
>> 0.000e+00  1.145e-01  0.000e+00
>>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.851e-04  2.436e-05
>>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  
>> 0.000e+00  7.250e-02  2.304e-03
>>
>> 6. Resources and Schedule
>>      6.4. Steering Committee requested information
>>         6.4.1. Consolidation C-team Name:
>>         ON
>>      6.5. ARC review type: FastTrack
>>      6.6. ARC Exposure: open
>>    
>


--Boundary_(ID_4rH+nPJOzRgNEmDfVZgsEw)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: 8BIT

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html;charset=UTF-8" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
Garrett D'Amore wrote:
<blockquote cite="mid:4BBD548D.4060509@oracle.com" type="cite"><br>
What's missing is an interface table.  I think though that based on the
statement that its not to be parsed ("for humans only"), the output is
not-an-interface.
  <br>
</blockquote>
<br>
Yes.  The stability is the same as the existing command:<br>
<br>
<samp>    |_____________________________|_____________________________|<br>
    | Interface Stability         | Uncommitted                 |<br>
    |_____________________________|_____________________________|<br>
    | Utility Output Format       | Not-an-Interface            |<br>
    |_____________________________|_____________________________|<br>
</samp><br>
<br>
<br>
<blockquote cite="mid:4BBD548D.4060509@oracle.com" type="cite"><br>
    - Garrett
  <br>
  <br>
On 04/ 7/10 05:51 PM, Jordan Brown wrote:
  <br>
  <blockquote type="cite">Template Version: @(#)sac_nextcase 1.70
03/30/10 SMI
    <br>
This information is Copyright (c) 2010, Oracle and/or its affiliates.
All rights reserved.
    <br>
1. Introduction
    <br>
     1.1. Project/Component Working Name:
    <br>
     SMB/CIFS Statistics
    <br>
     1.2. Name of Document Author/Supplier:
    <br>
     Author:  Jose Borrego
    <br>
     1.3  Date of This Document:
    <br>
    07 April, 2010
    <br>
    <br>
     1.4. Name of Major Document Customer(s)/Consumer(s):
    <br>
          PSARC
    <br>
    CIFS team
    <br>
    <br>
     1.5. Email Aliases:
    <br>
          1.5.1. Responsible Manager: <a class="moz-txt-link-abbreviated" href="mailto:Barry.Greenberg@Sun.COM">Barry.Greenberg@Sun.COM</a>
    <br>
          1.5.2. Responsible Engineer: <a class="moz-txt-link-abbreviated" href="mailto:Jose.Borrego@Sun.COM">Jose.Borrego@Sun.COM</a>
    <br>
          1.5.3. Marketing Manager:
    <br>
    1.5.4. Interest List: <a class="moz-txt-link-abbreviated" href="mailto:cifs-team@sun.com">cifs-team@sun.com</a>
    <br>
    <br>
4. Technical Description:
    <br>
    <br>
Executive Summary:
    <br>
    <br>
     This case improves the statistics the SMB/CIFS server maintains as
well as
    <br>
     the output of smbstat.
    <br>
    <br>
Problem:
    <br>
    <br>
     Currently the only statistics the SMB/CIFS server maintains are
counters
    <br>
     keeping track of how many requests of each type were received, the
number
    <br>
     of open files, the number of sessions (users logged in) and the
number of
    <br>
     connections (trees connected). Those statistics are not enough to
describe
    <br>
     the load being applied as well as how the server is responding to
it.
    <br>
    <br>
Solution:
    <br>
    <br>
     In order to get a better picture of the state of the SMB/CIFS
server the
    <br>
     following information can be maintained and provided through
smbstat:
    <br>
    <br>
     - Counters:
    <br>
    * nbt:
    <br>
        Number of SMB NetBIOS-over-TCP (NBT) sessions.
    <br>
    <br>
    * tcp:
    <br>
        Number of SMB TCP sessions.
    <br>
    <br>
    * users:
    <br>
        Number of users logged in.
    <br>
    <br>
    * trees:
    <br>
        Number of trees connected.
    <br>
    <br>
    * files:
    <br>
        Number of open files.
    <br>
    <br>
    * pipes:
    <br>
        Number of open pipes.
    <br>
    <br>
     - Throughput:
    <br>
    * rbytes/s:
    <br>
        Number of bytes received per second.
    <br>
    <br>
    * tbytes/s:
    <br>
        Number of bytes transmitted per second.
    <br>
    <br>
    * reqs/s:
    <br>
        Number of requests handled per second.
    <br>
    <br>
    * reads/s:
    <br>
        Number of read requests per second. This would be an
aggregation of
    <br>
        the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
    <br>
        SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
    <br>
    <br>
    * writes/s:
    <br>
        Number of write requests per second. This would ba an
aggregation of
    <br>
        the following requests: SMB_COM_WRITE,
SMB_COM_WRITE_AND_UNLOCK,
    <br>
        SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
    <br>
    <br>
     - Utilization:
    <br>
         * wcnt:
    <br>
        Average number of requests received but waiting for an SMB
worker
    <br>
        thread to execute them.
    <br>
    <br>
         * rcnt:
    <br>
        Average number of requests being simultaneously executed by an
SMB
    <br>
        worker thread.
    <br>
    <br>
    * wtime:
    <br>
        Average time a request waits before an SMB worker thread starts
    <br>
        executing it.
    <br>
    <br>
         * rtime:
    <br>
        Average execution time of a request.
    <br>
    <br>
         * w%:
    <br>
        Percentage of the time during which at least one request was
    <br>
        waiting.
    <br>
    <br>
         * r%:
    <br>
        Percentage of the time during which at least one request was
being
    <br>
        executed.
    <br>
    <br>
         * u%:
    <br>
        Percentage of utilization of the SMB/CIFS server. This number
is
    <br>
        defined as: rcnt / (Max Worker Threads).
    <br>
    <br>
         * sat:
    <br>
        Flag indicating if the server saturated in the past. Saturation
is
    <br>
        defined as: u% == 100%.
    <br>
    <br>
    * usr%:
    <br>
        Percentage of the time the processor(s) spent in user space.
    <br>
    <br>
    * sys%:
    <br>
        Percentage of the time the processor(s) spent in kernel space.
    <br>
    <br>
    * idle%:
    <br>
        Percentage of the time the processor(s) was(were) idle.
    <br>
    <br>
     - Requests:
    <br>
         For each type of request:
    <br>
         * %:
    <br>
        Percentage of that type of request.
    <br>
    <br>
         * rbytes/s:
    <br>
        Number of bytes received per second.
    <br>
    <br>
         * tbytes/s:
    <br>
        Number of bytes received per second.
    <br>
    <br>
         * req/s:
    <br>
        Number of requests handled per second.
    <br>
    <br>
         * rt-mean:
    <br>
        Average response time in seconds.
    <br>
    <br>
         *  rt-stddev:
    <br>
        Standard deviation of the response time.
    <br>
    <br>
     To access this information the CLI smbstat must be modified and
allow the
    <br>
     following options:
    <br>
    <br>
     -r  Display the statistics of the requests.
    <br>
    <br>
         -a  Display the statistics of all the types of request (the
256 of
    <br>
             them) whether they are valid or not.
    <br>
    <br>
         -n  Display in alphabetic order.
    <br>
    <br>
         -z  Display the statistics of the requests actually received.
    <br>
    <br>
     -t  Display the throughput of the SMB/CIFS server.
    <br>
    <br>
     -u  Display the utilization of the SMB/CIFS server.
    <br>
    <br>
     -c  Display the counters.
    <br>
    <br>
     A number can also be provided indicating the interval of time
between
    <br>
     refreshes. The first statistics displayed cover the time between
when
    <br>
     the server was started and the moment the statistics were
requested.
    <br>
     Subsequent refreshes cover the last time interval only.
    <br>
    <br>
     It should be noted that the output is all new replacing the old
one and
    <br>
     is for humans only.
    <br>
    <br>
Examples of smbstat output:
    <br>
    <br>
     'smbstat -ctu'
    <br>
    <br>
       nbt   tcp users trees files pipes
    <br>
         0     1     1     2    20     0
    <br>
    <br>
     rbytes/s   tbytes/s    reqs/s     reads/s   writes/s
    <br>
     1.036e+02  1.298e+00  0.000e+00  0.000e+00  0.000e+00
    <br>
    <br>
       wcnt       rcnt       wtime      rtime     w%   r%   u%  sat
usr% sys% idle%
    <br>
     4.317e-01  7.410e+00  2.461e-05  4.224e-04   31  100    0  no   
0   76    24
    <br>
    <br>
     'smbstat -r'
    <br>
    <br>
                                code   %   rbytes/s   tbytes/s    
req/s     rt-mean   rt-stddev
    <br>
             SmbCreateDirectory  00     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
             SmbDeleteDirectory  01     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbOpen  02     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                      SmbCreate  03     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbClose  04     0  0.000e+00  0.000e+00 
0.000e+00  2.496e-04  8.003e-06
    <br>
                       SmbFlush  05     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                      SmbDelete  06     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                      SmbRename  07     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
            SmbQueryInformation  08     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbSetInformation  09     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbRead  0A     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbWrite  0B     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
               SmbLockByteRange  0C     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
             SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
             SmbCreateTemporary  0E     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                   SmbCreateNew  0F     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbCheckDirectory  10     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                 SmbProcessExit  11     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbSeek  12     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                 SmbLockAndRead  13     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                     SmbReadRaw  1A     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                    SmbWriteRaw  1D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
             SmbSetInformation2  22     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
           SmbQueryInformation2  23     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                    SmbLockingX  24     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                 SmbTransaction  25     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
        SmbTransactionSecondary  26     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbIoctl  27     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbEcho  2B     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
               SmbWriteAndClose  2C     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbOpenX  2D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbReadX  2E     0  0.000e+00  0.000e+00 
0.000e+00  3.550e-04  1.856e-05
    <br>
                      SmbWriteX  2F   100  4.607e+02  1.675e+00 
0.000e+00  3.893e-04  2.691e-07
    <br>
      SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                SmbTransaction2  32     0  0.000e+00  0.000e+00 
0.000e+00  5.203e-04  8.612e-06
    <br>
       SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                  SmbFindClose2  34     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                 SmbTreeConnect  70     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbTreeDisconnect  71     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                   SmbNegotiate  72     0  0.000e+00  0.000e+00 
0.000e+00  4.625e-05  0.000e+00
    <br>
               SmbSessionSetupX  73     0  0.000e+00  0.000e+00 
0.000e+00  1.145e-01  0.000e+00
    <br>
                     SmbLogoffX  74     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                SmbTreeConnectX  75     0  0.000e+00  0.000e+00 
0.000e+00  5.851e-04  2.436e-05
    <br>
        SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                      SmbSearch  81     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbFind  82     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                  SmbFindUnique  83     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                   SmbFindClose  84     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                  SmbNtTransact  A0     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
         SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                   SmbNtCreateX  A2     0  0.000e+00  0.000e+00 
0.000e+00  5.154e-02  2.063e-03
    <br>
                    SmbNtCancel  A4     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                    SmbNtRename  A5     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
               SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbWritePrintFile  C1     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbClosePrintFile  C2     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
               SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
    <br>
     'smbstat -rz'
    <br>
    <br>
                                code   %   rbytes/s   tbytes/s    
req/s     rt-mean   rt-stddev
    <br>
                       SmbClose  04     0  0.000e+00  0.000e+00 
0.000e+00  2.445e-04  5.906e-06
    <br>
                       SmbReadX  2E     4  0.000e+00  2.772e+01 
0.000e+00  1.556e-03  7.878e-06
    <br>
                      SmbWriteX  2F    96  7.162e+02  2.604e+00 
0.000e+00  5.365e-04  3.913e-07
    <br>
                SmbTransaction2  32     0  0.000e+00  0.000e+00 
0.000e+00  5.203e-04  8.612e-06
    <br>
                   SmbNegotiate  72     0  0.000e+00  0.000e+00 
0.000e+00  4.625e-05  0.000e+00
    <br>
               SmbSessionSetupX  73     0  0.000e+00  0.000e+00 
0.000e+00  1.145e-01  0.000e+00
    <br>
                SmbTreeConnectX  75     0  0.000e+00  0.000e+00 
0.000e+00  5.851e-04  2.436e-05
    <br>
                   SmbNtCreateX  A2     0  0.000e+00  0.000e+00 
0.000e+00  7.250e-02  2.304e-03
    <br>
    <br>
6. Resources and Schedule
    <br>
     6.4. Steering Committee requested information
    <br>
        6.4.1. Consolidation C-team Name:
    <br>
        ON
    <br>
     6.5. ARC review type: FastTrack
    <br>
     6.6. ARC Exposure: open
    <br>
   </blockquote>
  <br>
</blockquote>
<br>
</body>
</html>

--Boundary_(ID_4rH+nPJOzRgNEmDfVZgsEw)--

From Jordan.Brown@oracle.com Wed Apr  7 22:47:35 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o385lY05001114
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 7 Apr 2010 22:47:34 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o385lXaE011151
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 7 Apr 2010 23:47:34 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00C0BMRAVO00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 07 Apr 2010 22:47:34 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J00ESAMR802D0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 07 Apr 2010 22:47:32 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o385lWvd018127	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 05:47:32 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o385WEuv014990	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 05:47:31 +0000 (GMT)
Received: from abhmt007.oracle.com by acsmt353.oracle.com	with ESMTP id
 145028921270705649; Wed, 07 Apr 2010 22:47:29 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Wed,
 07 Apr 2010 22:47:29 -0700
Date: Wed, 07 Apr 2010 22:47:27 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBD548D.4060509@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBD6DEF.7010400@oracle.com>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_2d2iolcY8ZhRTOAJBAqhIQ)"
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090209.4BBD6DF3.00FA:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 32694

This is a multi-part message in MIME format.

--Boundary_(ID_2d2iolcY8ZhRTOAJBAqhIQ)
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT

Garrett D'Amore wrote:
>
> What's missing is an interface table.  I think though that based on 
> the statement that its not to be parsed ("for humans only"), the 
> output is not-an-interface.

Yes.  The stability is the same as the existing command:

    |_____________________________|_____________________________|
    | Interface Stability         | Uncommitted                 |
    |_____________________________|_____________________________|
    | Utility Output Format       | Not-an-Interface            |
    |_____________________________|_____________________________|



>
>     - Garrett
>
> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>> This information is Copyright (c) 2010, Oracle and/or its affiliates. 
>> All rights reserved.
>> 1. Introduction
>>      1.1. Project/Component Working Name:
>>      SMB/CIFS Statistics
>>      1.2. Name of Document Author/Supplier:
>>      Author:  Jose Borrego
>>      1.3  Date of This Document:
>>     07 April, 2010
>>
>>      1.4. Name of Major Document Customer(s)/Consumer(s):
>>           PSARC
>>     CIFS team
>>
>>      1.5. Email Aliases:
>>           1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>           1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>           1.5.3. Marketing Manager:
>>     1.5.4. Interest List: cifs-team@sun.com
>>
>> 4. Technical Description:
>>
>> Executive Summary:
>>
>>      This case improves the statistics the SMB/CIFS server maintains 
>> as well as
>>      the output of smbstat.
>>
>> Problem:
>>
>>      Currently the only statistics the SMB/CIFS server maintains are 
>> counters
>>      keeping track of how many requests of each type were received, 
>> the number
>>      of open files, the number of sessions (users logged in) and the 
>> number of
>>      connections (trees connected). Those statistics are not enough 
>> to describe
>>      the load being applied as well as how the server is responding 
>> to it.
>>
>> Solution:
>>
>>      In order to get a better picture of the state of the SMB/CIFS 
>> server the
>>      following information can be maintained and provided through 
>> smbstat:
>>
>>      - Counters:
>>     * nbt:
>>         Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>
>>     * tcp:
>>         Number of SMB TCP sessions.
>>
>>     * users:
>>         Number of users logged in.
>>
>>     * trees:
>>         Number of trees connected.
>>
>>     * files:
>>         Number of open files.
>>
>>     * pipes:
>>         Number of open pipes.
>>
>>      - Throughput:
>>     * rbytes/s:
>>         Number of bytes received per second.
>>
>>     * tbytes/s:
>>         Number of bytes transmitted per second.
>>
>>     * reqs/s:
>>         Number of requests handled per second.
>>
>>     * reads/s:
>>         Number of read requests per second. This would be an 
>> aggregation of
>>         the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>         SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>
>>     * writes/s:
>>         Number of write requests per second. This would ba an 
>> aggregation of
>>         the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>>         SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>
>>      - Utilization:
>>          * wcnt:
>>         Average number of requests received but waiting for an SMB 
>> worker
>>         thread to execute them.
>>
>>          * rcnt:
>>         Average number of requests being simultaneously executed by 
>> an SMB
>>         worker thread.
>>
>>     * wtime:
>>         Average time a request waits before an SMB worker thread starts
>>         executing it.
>>
>>          * rtime:
>>         Average execution time of a request.
>>
>>          * w%:
>>         Percentage of the time during which at least one request was
>>         waiting.
>>
>>          * r%:
>>         Percentage of the time during which at least one request was 
>> being
>>         executed.
>>
>>          * u%:
>>         Percentage of utilization of the SMB/CIFS server. This number is
>>         defined as: rcnt / (Max Worker Threads).
>>
>>          * sat:
>>         Flag indicating if the server saturated in the past. 
>> Saturation is
>>         defined as: u% == 100%.
>>
>>     * usr%:
>>         Percentage of the time the processor(s) spent in user space.
>>
>>     * sys%:
>>         Percentage of the time the processor(s) spent in kernel space.
>>
>>     * idle%:
>>         Percentage of the time the processor(s) was(were) idle.
>>
>>      - Requests:
>>          For each type of request:
>>          * %:
>>         Percentage of that type of request.
>>
>>          * rbytes/s:
>>         Number of bytes received per second.
>>
>>          * tbytes/s:
>>         Number of bytes received per second.
>>
>>          * req/s:
>>         Number of requests handled per second.
>>
>>          * rt-mean:
>>         Average response time in seconds.
>>
>>          *  rt-stddev:
>>         Standard deviation of the response time.
>>
>>      To access this information the CLI smbstat must be modified and 
>> allow the
>>      following options:
>>
>>      -r  Display the statistics of the requests.
>>
>>          -a  Display the statistics of all the types of request (the 
>> 256 of
>>              them) whether they are valid or not.
>>
>>          -n  Display in alphabetic order.
>>
>>          -z  Display the statistics of the requests actually received.
>>
>>      -t  Display the throughput of the SMB/CIFS server.
>>
>>      -u  Display the utilization of the SMB/CIFS server.
>>
>>      -c  Display the counters.
>>
>>      A number can also be provided indicating the interval of time 
>> between
>>      refreshes. The first statistics displayed cover the time between 
>> when
>>      the server was started and the moment the statistics were 
>> requested.
>>      Subsequent refreshes cover the last time interval only.
>>
>>      It should be noted that the output is all new replacing the old 
>> one and
>>      is for humans only.
>>
>> Examples of smbstat output:
>>
>>      '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
>>
>>      'smbstat -r'
>>
>>                                 code   %   rbytes/s   tbytes/s     
>> req/s     rt-mean   rt-stddev
>>              SmbCreateDirectory  00     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>              SmbDeleteDirectory  01     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbOpen  02     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                       SmbCreate  03     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbClose  04     0  0.000e+00  0.000e+00  
>> 0.000e+00  2.496e-04  8.003e-06
>>                        SmbFlush  05     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                       SmbDelete  06     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                       SmbRename  07     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>             SmbQueryInformation  08     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbSetInformation  09     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbRead  0A     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbWrite  0B     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                SmbLockByteRange  0C     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>              SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>              SmbCreateTemporary  0E     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                    SmbCreateNew  0F     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbCheckDirectory  10     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                  SmbProcessExit  11     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbSeek  12     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                  SmbLockAndRead  13     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                      SmbReadRaw  1A     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                     SmbWriteRaw  1D     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>              SmbSetInformation2  22     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>            SmbQueryInformation2  23     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                     SmbLockingX  24     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                  SmbTransaction  25     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>         SmbTransactionSecondary  26     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbIoctl  27     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbEcho  2B     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                SmbWriteAndClose  2C     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbOpenX  2D     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                        SmbReadX  2E     0  0.000e+00  0.000e+00  
>> 0.000e+00  3.550e-04  1.856e-05
>>                       SmbWriteX  2F   100  4.607e+02  1.675e+00  
>> 0.000e+00  3.893e-04  2.691e-07
>>       SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.203e-04  8.612e-06
>>        SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                   SmbFindClose2  34     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                  SmbTreeConnect  70     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbTreeDisconnect  71     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  
>> 0.000e+00  4.625e-05  0.000e+00
>>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  
>> 0.000e+00  1.145e-01  0.000e+00
>>                      SmbLogoffX  74     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.851e-04  2.436e-05
>>         SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                       SmbSearch  81     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                         SmbFind  82     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                   SmbFindUnique  83     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                    SmbFindClose  84     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                   SmbNtTransact  A0     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>          SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.154e-02  2.063e-03
>>                     SmbNtCancel  A4     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                     SmbNtRename  A5     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbWritePrintFile  C1     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>               SmbClosePrintFile  C2     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>                SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00  
>> 0.000e+00  0.000e+00  0.000e+00
>>
>>      'smbstat -rz'
>>
>>                                 code   %   rbytes/s   tbytes/s     
>> req/s     rt-mean   rt-stddev
>>                        SmbClose  04     0  0.000e+00  0.000e+00  
>> 0.000e+00  2.445e-04  5.906e-06
>>                        SmbReadX  2E     4  0.000e+00  2.772e+01  
>> 0.000e+00  1.556e-03  7.878e-06
>>                       SmbWriteX  2F    96  7.162e+02  2.604e+00  
>> 0.000e+00  5.365e-04  3.913e-07
>>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.203e-04  8.612e-06
>>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  
>> 0.000e+00  4.625e-05  0.000e+00
>>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  
>> 0.000e+00  1.145e-01  0.000e+00
>>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  
>> 0.000e+00  5.851e-04  2.436e-05
>>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  
>> 0.000e+00  7.250e-02  2.304e-03
>>
>> 6. Resources and Schedule
>>      6.4. Steering Committee requested information
>>         6.4.1. Consolidation C-team Name:
>>         ON
>>      6.5. ARC review type: FastTrack
>>      6.6. ARC Exposure: open
>>    
>


--Boundary_(ID_2d2iolcY8ZhRTOAJBAqhIQ)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: 8BIT

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html;charset=UTF-8" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
Garrett D'Amore wrote:
<blockquote cite="mid:4BBD548D.4060509@oracle.com" type="cite"><br>
What's missing is an interface table.  I think though that based on the
statement that its not to be parsed ("for humans only"), the output is
not-an-interface.
  <br>
</blockquote>
<br>
Yes.  The stability is the same as the existing command:<br>
<br>
<samp>    |_____________________________|_____________________________|<br>
    | Interface Stability         | Uncommitted                 |<br>
    |_____________________________|_____________________________|<br>
    | Utility Output Format       | Not-an-Interface            |<br>
    |_____________________________|_____________________________|<br>
</samp><br>
<br>
<br>
<blockquote cite="mid:4BBD548D.4060509@oracle.com" type="cite"><br>
    - Garrett
  <br>
  <br>
On 04/ 7/10 05:51 PM, Jordan Brown wrote:
  <br>
  <blockquote type="cite">Template Version: @(#)sac_nextcase 1.70
03/30/10 SMI
    <br>
This information is Copyright (c) 2010, Oracle and/or its affiliates.
All rights reserved.
    <br>
1. Introduction
    <br>
     1.1. Project/Component Working Name:
    <br>
     SMB/CIFS Statistics
    <br>
     1.2. Name of Document Author/Supplier:
    <br>
     Author:  Jose Borrego
    <br>
     1.3  Date of This Document:
    <br>
    07 April, 2010
    <br>
    <br>
     1.4. Name of Major Document Customer(s)/Consumer(s):
    <br>
          PSARC
    <br>
    CIFS team
    <br>
    <br>
     1.5. Email Aliases:
    <br>
          1.5.1. Responsible Manager: <a class="moz-txt-link-abbreviated" href="mailto:Barry.Greenberg@Sun.COM">Barry.Greenberg@Sun.COM</a>
    <br>
          1.5.2. Responsible Engineer: <a class="moz-txt-link-abbreviated" href="mailto:Jose.Borrego@Sun.COM">Jose.Borrego@Sun.COM</a>
    <br>
          1.5.3. Marketing Manager:
    <br>
    1.5.4. Interest List: <a class="moz-txt-link-abbreviated" href="mailto:cifs-team@sun.com">cifs-team@sun.com</a>
    <br>
    <br>
4. Technical Description:
    <br>
    <br>
Executive Summary:
    <br>
    <br>
     This case improves the statistics the SMB/CIFS server maintains as
well as
    <br>
     the output of smbstat.
    <br>
    <br>
Problem:
    <br>
    <br>
     Currently the only statistics the SMB/CIFS server maintains are
counters
    <br>
     keeping track of how many requests of each type were received, the
number
    <br>
     of open files, the number of sessions (users logged in) and the
number of
    <br>
     connections (trees connected). Those statistics are not enough to
describe
    <br>
     the load being applied as well as how the server is responding to
it.
    <br>
    <br>
Solution:
    <br>
    <br>
     In order to get a better picture of the state of the SMB/CIFS
server the
    <br>
     following information can be maintained and provided through
smbstat:
    <br>
    <br>
     - Counters:
    <br>
    * nbt:
    <br>
        Number of SMB NetBIOS-over-TCP (NBT) sessions.
    <br>
    <br>
    * tcp:
    <br>
        Number of SMB TCP sessions.
    <br>
    <br>
    * users:
    <br>
        Number of users logged in.
    <br>
    <br>
    * trees:
    <br>
        Number of trees connected.
    <br>
    <br>
    * files:
    <br>
        Number of open files.
    <br>
    <br>
    * pipes:
    <br>
        Number of open pipes.
    <br>
    <br>
     - Throughput:
    <br>
    * rbytes/s:
    <br>
        Number of bytes received per second.
    <br>
    <br>
    * tbytes/s:
    <br>
        Number of bytes transmitted per second.
    <br>
    <br>
    * reqs/s:
    <br>
        Number of requests handled per second.
    <br>
    <br>
    * reads/s:
    <br>
        Number of read requests per second. This would be an
aggregation of
    <br>
        the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
    <br>
        SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
    <br>
    <br>
    * writes/s:
    <br>
        Number of write requests per second. This would ba an
aggregation of
    <br>
        the following requests: SMB_COM_WRITE,
SMB_COM_WRITE_AND_UNLOCK,
    <br>
        SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
    <br>
    <br>
     - Utilization:
    <br>
         * wcnt:
    <br>
        Average number of requests received but waiting for an SMB
worker
    <br>
        thread to execute them.
    <br>
    <br>
         * rcnt:
    <br>
        Average number of requests being simultaneously executed by an
SMB
    <br>
        worker thread.
    <br>
    <br>
    * wtime:
    <br>
        Average time a request waits before an SMB worker thread starts
    <br>
        executing it.
    <br>
    <br>
         * rtime:
    <br>
        Average execution time of a request.
    <br>
    <br>
         * w%:
    <br>
        Percentage of the time during which at least one request was
    <br>
        waiting.
    <br>
    <br>
         * r%:
    <br>
        Percentage of the time during which at least one request was
being
    <br>
        executed.
    <br>
    <br>
         * u%:
    <br>
        Percentage of utilization of the SMB/CIFS server. This number
is
    <br>
        defined as: rcnt / (Max Worker Threads).
    <br>
    <br>
         * sat:
    <br>
        Flag indicating if the server saturated in the past. Saturation
is
    <br>
        defined as: u% == 100%.
    <br>
    <br>
    * usr%:
    <br>
        Percentage of the time the processor(s) spent in user space.
    <br>
    <br>
    * sys%:
    <br>
        Percentage of the time the processor(s) spent in kernel space.
    <br>
    <br>
    * idle%:
    <br>
        Percentage of the time the processor(s) was(were) idle.
    <br>
    <br>
     - Requests:
    <br>
         For each type of request:
    <br>
         * %:
    <br>
        Percentage of that type of request.
    <br>
    <br>
         * rbytes/s:
    <br>
        Number of bytes received per second.
    <br>
    <br>
         * tbytes/s:
    <br>
        Number of bytes received per second.
    <br>
    <br>
         * req/s:
    <br>
        Number of requests handled per second.
    <br>
    <br>
         * rt-mean:
    <br>
        Average response time in seconds.
    <br>
    <br>
         *  rt-stddev:
    <br>
        Standard deviation of the response time.
    <br>
    <br>
     To access this information the CLI smbstat must be modified and
allow the
    <br>
     following options:
    <br>
    <br>
     -r  Display the statistics of the requests.
    <br>
    <br>
         -a  Display the statistics of all the types of request (the
256 of
    <br>
             them) whether they are valid or not.
    <br>
    <br>
         -n  Display in alphabetic order.
    <br>
    <br>
         -z  Display the statistics of the requests actually received.
    <br>
    <br>
     -t  Display the throughput of the SMB/CIFS server.
    <br>
    <br>
     -u  Display the utilization of the SMB/CIFS server.
    <br>
    <br>
     -c  Display the counters.
    <br>
    <br>
     A number can also be provided indicating the interval of time
between
    <br>
     refreshes. The first statistics displayed cover the time between
when
    <br>
     the server was started and the moment the statistics were
requested.
    <br>
     Subsequent refreshes cover the last time interval only.
    <br>
    <br>
     It should be noted that the output is all new replacing the old
one and
    <br>
     is for humans only.
    <br>
    <br>
Examples of smbstat output:
    <br>
    <br>
     'smbstat -ctu'
    <br>
    <br>
       nbt   tcp users trees files pipes
    <br>
         0     1     1     2    20     0
    <br>
    <br>
     rbytes/s   tbytes/s    reqs/s     reads/s   writes/s
    <br>
     1.036e+02  1.298e+00  0.000e+00  0.000e+00  0.000e+00
    <br>
    <br>
       wcnt       rcnt       wtime      rtime     w%   r%   u%  sat
usr% sys% idle%
    <br>
     4.317e-01  7.410e+00  2.461e-05  4.224e-04   31  100    0  no   
0   76    24
    <br>
    <br>
     'smbstat -r'
    <br>
    <br>
                                code   %   rbytes/s   tbytes/s    
req/s     rt-mean   rt-stddev
    <br>
             SmbCreateDirectory  00     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
             SmbDeleteDirectory  01     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbOpen  02     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                      SmbCreate  03     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbClose  04     0  0.000e+00  0.000e+00 
0.000e+00  2.496e-04  8.003e-06
    <br>
                       SmbFlush  05     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                      SmbDelete  06     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                      SmbRename  07     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
            SmbQueryInformation  08     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbSetInformation  09     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbRead  0A     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbWrite  0B     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
               SmbLockByteRange  0C     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
             SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
             SmbCreateTemporary  0E     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                   SmbCreateNew  0F     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbCheckDirectory  10     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                 SmbProcessExit  11     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbSeek  12     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                 SmbLockAndRead  13     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                     SmbReadRaw  1A     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                    SmbWriteRaw  1D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
             SmbSetInformation2  22     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
           SmbQueryInformation2  23     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                    SmbLockingX  24     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                 SmbTransaction  25     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
        SmbTransactionSecondary  26     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbIoctl  27     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbEcho  2B     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
               SmbWriteAndClose  2C     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbOpenX  2D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                       SmbReadX  2E     0  0.000e+00  0.000e+00 
0.000e+00  3.550e-04  1.856e-05
    <br>
                      SmbWriteX  2F   100  4.607e+02  1.675e+00 
0.000e+00  3.893e-04  2.691e-07
    <br>
      SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                SmbTransaction2  32     0  0.000e+00  0.000e+00 
0.000e+00  5.203e-04  8.612e-06
    <br>
       SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                  SmbFindClose2  34     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                 SmbTreeConnect  70     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbTreeDisconnect  71     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                   SmbNegotiate  72     0  0.000e+00  0.000e+00 
0.000e+00  4.625e-05  0.000e+00
    <br>
               SmbSessionSetupX  73     0  0.000e+00  0.000e+00 
0.000e+00  1.145e-01  0.000e+00
    <br>
                     SmbLogoffX  74     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                SmbTreeConnectX  75     0  0.000e+00  0.000e+00 
0.000e+00  5.851e-04  2.436e-05
    <br>
        SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                      SmbSearch  81     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                        SmbFind  82     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                  SmbFindUnique  83     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                   SmbFindClose  84     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                  SmbNtTransact  A0     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
         SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                   SmbNtCreateX  A2     0  0.000e+00  0.000e+00 
0.000e+00  5.154e-02  2.063e-03
    <br>
                    SmbNtCancel  A4     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
                    SmbNtRename  A5     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
               SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbWritePrintFile  C1     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
              SmbClosePrintFile  C2     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
               SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00
    <br>
    <br>
     'smbstat -rz'
    <br>
    <br>
                                code   %   rbytes/s   tbytes/s    
req/s     rt-mean   rt-stddev
    <br>
                       SmbClose  04     0  0.000e+00  0.000e+00 
0.000e+00  2.445e-04  5.906e-06
    <br>
                       SmbReadX  2E     4  0.000e+00  2.772e+01 
0.000e+00  1.556e-03  7.878e-06
    <br>
                      SmbWriteX  2F    96  7.162e+02  2.604e+00 
0.000e+00  5.365e-04  3.913e-07
    <br>
                SmbTransaction2  32     0  0.000e+00  0.000e+00 
0.000e+00  5.203e-04  8.612e-06
    <br>
                   SmbNegotiate  72     0  0.000e+00  0.000e+00 
0.000e+00  4.625e-05  0.000e+00
    <br>
               SmbSessionSetupX  73     0  0.000e+00  0.000e+00 
0.000e+00  1.145e-01  0.000e+00
    <br>
                SmbTreeConnectX  75     0  0.000e+00  0.000e+00 
0.000e+00  5.851e-04  2.436e-05
    <br>
                   SmbNtCreateX  A2     0  0.000e+00  0.000e+00 
0.000e+00  7.250e-02  2.304e-03
    <br>
    <br>
6. Resources and Schedule
    <br>
     6.4. Steering Committee requested information
    <br>
        6.4.1. Consolidation C-team Name:
    <br>
        ON
    <br>
     6.5. ARC review type: FastTrack
    <br>
     6.6. ARC Exposure: open
    <br>
   </blockquote>
  <br>
</blockquote>
<br>
</body>
</html>

--Boundary_(ID_2d2iolcY8ZhRTOAJBAqhIQ)--

From garrett.damore@oracle.com Wed Apr  7 22:59:36 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o385xabZ001488
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 7 Apr 2010 22:59:36 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o385xZjX016142
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 00:59:36 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00K0DNBBC300@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 07 Apr 2010 22:59:35 -0700 (PDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J0023KNBAVXE0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 07 Apr 2010 22:59:35 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o385xYBE000709	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 05:59:34 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o385WEvX014990	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 05:59:33 +0000 (GMT)
Received: from abhmt008.oracle.com by acsmt355.oracle.com	with ESMTP id
 145050001270706370; Wed, 07 Apr 2010 22:59:30 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Wed,
 07 Apr 2010 22:59:29 -0700
Date: Wed, 07 Apr 2010 22:59:27 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBD6DEF.7010400@oracle.com>
To: Jordan Brown <Jordan.Brown@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBD70BF.2070508@oracle.com>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_Jz5PBDqGWxBAqiF2qnlZZg)"
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090202.4BBD70C6.0047:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 33206

This is a multi-part message in MIME format.

--Boundary_(ID_Jz5PBDqGWxBAqiF2qnlZZg)
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT

On 04/ 7/10 10:47 PM, Jordan Brown wrote:
> Garrett D'Amore wrote:
>>
>> What's missing is an interface table.  I think though that based on 
>> the statement that its not to be parsed ("for humans only"), the 
>> output is not-an-interface.
>
> Yes.  The stability is the same as the existing command:
>
>     |_____________________________|_____________________________|
>     | Interface Stability         | Uncommitted                 |
>     |_____________________________|_____________________________|
>     | Utility Output Format       | Not-an-Interface            |
>     |_____________________________|_____________________________|
>

You haven't mentioned anything about underlying kstats.  Is this how 
these stats are implemented?  Should that be covered under an ARC case 
as well (perhaps this one)?

     - Garrett
>
>
>>
>>     - Garrett
>>
>> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>>> This information is Copyright (c) 2010, Oracle and/or its 
>>> affiliates. All rights reserved.
>>> 1. Introduction
>>>      1.1. Project/Component Working Name:
>>>      SMB/CIFS Statistics
>>>      1.2. Name of Document Author/Supplier:
>>>      Author:  Jose Borrego
>>>      1.3  Date of This Document:
>>>     07 April, 2010
>>>
>>>      1.4. Name of Major Document Customer(s)/Consumer(s):
>>>           PSARC
>>>     CIFS team
>>>
>>>      1.5. Email Aliases:
>>>           1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>>           1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>>           1.5.3. Marketing Manager:
>>>     1.5.4. Interest List: cifs-team@sun.com
>>>
>>> 4. Technical Description:
>>>
>>> Executive Summary:
>>>
>>>      This case improves the statistics the SMB/CIFS server maintains 
>>> as well as
>>>      the output of smbstat.
>>>
>>> Problem:
>>>
>>>      Currently the only statistics the SMB/CIFS server maintains are 
>>> counters
>>>      keeping track of how many requests of each type were received, 
>>> the number
>>>      of open files, the number of sessions (users logged in) and the 
>>> number of
>>>      connections (trees connected). Those statistics are not enough 
>>> to describe
>>>      the load being applied as well as how the server is responding 
>>> to it.
>>>
>>> Solution:
>>>
>>>      In order to get a better picture of the state of the SMB/CIFS 
>>> server the
>>>      following information can be maintained and provided through 
>>> smbstat:
>>>
>>>      - Counters:
>>>     * nbt:
>>>         Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>>
>>>     * tcp:
>>>         Number of SMB TCP sessions.
>>>
>>>     * users:
>>>         Number of users logged in.
>>>
>>>     * trees:
>>>         Number of trees connected.
>>>
>>>     * files:
>>>         Number of open files.
>>>
>>>     * pipes:
>>>         Number of open pipes.
>>>
>>>      - Throughput:
>>>     * rbytes/s:
>>>         Number of bytes received per second.
>>>
>>>     * tbytes/s:
>>>         Number of bytes transmitted per second.
>>>
>>>     * reqs/s:
>>>         Number of requests handled per second.
>>>
>>>     * reads/s:
>>>         Number of read requests per second. This would be an 
>>> aggregation of
>>>         the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>>         SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>>
>>>     * writes/s:
>>>         Number of write requests per second. This would ba an 
>>> aggregation of
>>>         the following requests: SMB_COM_WRITE, 
>>> SMB_COM_WRITE_AND_UNLOCK,
>>>         SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>>
>>>      - Utilization:
>>>          * wcnt:
>>>         Average number of requests received but waiting for an SMB 
>>> worker
>>>         thread to execute them.
>>>
>>>          * rcnt:
>>>         Average number of requests being simultaneously executed by 
>>> an SMB
>>>         worker thread.
>>>
>>>     * wtime:
>>>         Average time a request waits before an SMB worker thread starts
>>>         executing it.
>>>
>>>          * rtime:
>>>         Average execution time of a request.
>>>
>>>          * w%:
>>>         Percentage of the time during which at least one request was
>>>         waiting.
>>>
>>>          * r%:
>>>         Percentage of the time during which at least one request was 
>>> being
>>>         executed.
>>>
>>>          * u%:
>>>         Percentage of utilization of the SMB/CIFS server. This 
>>> number is
>>>         defined as: rcnt / (Max Worker Threads).
>>>
>>>          * sat:
>>>         Flag indicating if the server saturated in the past. 
>>> Saturation is
>>>         defined as: u% == 100%.
>>>
>>>     * usr%:
>>>         Percentage of the time the processor(s) spent in user space.
>>>
>>>     * sys%:
>>>         Percentage of the time the processor(s) spent in kernel space.
>>>
>>>     * idle%:
>>>         Percentage of the time the processor(s) was(were) idle.
>>>
>>>      - Requests:
>>>          For each type of request:
>>>          * %:
>>>         Percentage of that type of request.
>>>
>>>          * rbytes/s:
>>>         Number of bytes received per second.
>>>
>>>          * tbytes/s:
>>>         Number of bytes received per second.
>>>
>>>          * req/s:
>>>         Number of requests handled per second.
>>>
>>>          * rt-mean:
>>>         Average response time in seconds.
>>>
>>>          *  rt-stddev:
>>>         Standard deviation of the response time.
>>>
>>>      To access this information the CLI smbstat must be modified and 
>>> allow the
>>>      following options:
>>>
>>>      -r  Display the statistics of the requests.
>>>
>>>          -a  Display the statistics of all the types of request (the 
>>> 256 of
>>>              them) whether they are valid or not.
>>>
>>>          -n  Display in alphabetic order.
>>>
>>>          -z  Display the statistics of the requests actually received.
>>>
>>>      -t  Display the throughput of the SMB/CIFS server.
>>>
>>>      -u  Display the utilization of the SMB/CIFS server.
>>>
>>>      -c  Display the counters.
>>>
>>>      A number can also be provided indicating the interval of time 
>>> between
>>>      refreshes. The first statistics displayed cover the time 
>>> between when
>>>      the server was started and the moment the statistics were 
>>> requested.
>>>      Subsequent refreshes cover the last time interval only.
>>>
>>>      It should be noted that the output is all new replacing the old 
>>> one and
>>>      is for humans only.
>>>
>>> Examples of smbstat output:
>>>
>>>      '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
>>>
>>>      'smbstat -r'
>>>
>>>                                 code   %   rbytes/s   tbytes/s     
>>> req/s     rt-mean   rt-stddev
>>>              SmbCreateDirectory  00     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>              SmbDeleteDirectory  01     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbOpen  02     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                       SmbCreate  03     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbClose  04     0  0.000e+00  0.000e+00  
>>> 0.000e+00  2.496e-04  8.003e-06
>>>                        SmbFlush  05     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                       SmbDelete  06     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                       SmbRename  07     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>             SmbQueryInformation  08     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbSetInformation  09     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbRead  0A     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbWrite  0B     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                SmbLockByteRange  0C     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>              SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>              SmbCreateTemporary  0E     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                    SmbCreateNew  0F     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbCheckDirectory  10     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                  SmbProcessExit  11     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbSeek  12     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                  SmbLockAndRead  13     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                      SmbReadRaw  1A     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                     SmbWriteRaw  1D     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>              SmbSetInformation2  22     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>            SmbQueryInformation2  23     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                     SmbLockingX  24     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                  SmbTransaction  25     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>         SmbTransactionSecondary  26     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbIoctl  27     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbEcho  2B     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                SmbWriteAndClose  2C     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbOpenX  2D     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbReadX  2E     0  0.000e+00  0.000e+00  
>>> 0.000e+00  3.550e-04  1.856e-05
>>>                       SmbWriteX  2F   100  4.607e+02  1.675e+00  
>>> 0.000e+00  3.893e-04  2.691e-07
>>>       SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.203e-04  8.612e-06
>>>        SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                   SmbFindClose2  34     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                  SmbTreeConnect  70     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbTreeDisconnect  71     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  
>>> 0.000e+00  4.625e-05  0.000e+00
>>>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  
>>> 0.000e+00  1.145e-01  0.000e+00
>>>                      SmbLogoffX  74     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.851e-04  2.436e-05
>>>         SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                       SmbSearch  81     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbFind  82     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                   SmbFindUnique  83     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                    SmbFindClose  84     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                   SmbNtTransact  A0     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>          SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.154e-02  2.063e-03
>>>                     SmbNtCancel  A4     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                     SmbNtRename  A5     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbWritePrintFile  C1     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbClosePrintFile  C2     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>
>>>      'smbstat -rz'
>>>
>>>                                 code   %   rbytes/s   tbytes/s     
>>> req/s     rt-mean   rt-stddev
>>>                        SmbClose  04     0  0.000e+00  0.000e+00  
>>> 0.000e+00  2.445e-04  5.906e-06
>>>                        SmbReadX  2E     4  0.000e+00  2.772e+01  
>>> 0.000e+00  1.556e-03  7.878e-06
>>>                       SmbWriteX  2F    96  7.162e+02  2.604e+00  
>>> 0.000e+00  5.365e-04  3.913e-07
>>>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.203e-04  8.612e-06
>>>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  
>>> 0.000e+00  4.625e-05  0.000e+00
>>>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  
>>> 0.000e+00  1.145e-01  0.000e+00
>>>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.851e-04  2.436e-05
>>>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  
>>> 0.000e+00  7.250e-02  2.304e-03
>>>
>>> 6. Resources and Schedule
>>>      6.4. Steering Committee requested information
>>>         6.4.1. Consolidation C-team Name:
>>>         ON
>>>      6.5. ARC review type: FastTrack
>>>      6.6. ARC Exposure: open
>>
>


--Boundary_(ID_Jz5PBDqGWxBAqiF2qnlZZg)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: 8BIT

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#ffffff">
On 04/ 7/10 10:47 PM, Jordan Brown wrote:
<blockquote cite="mid:4BBD6DEF.7010400@oracle.com" type="cite">
  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
Garrett D'Amore wrote:
  <blockquote cite="mid:4BBD548D.4060509@oracle.com" type="cite"><br>
What's missing is an interface table.  I think though that based on the
statement that its not to be parsed ("for humans only"), the output is
not-an-interface. <br>
  </blockquote>
  <br>
Yes.  The stability is the same as the existing command:<br>
  <br>
  <samp>   
|_____________________________|_____________________________|<br>
    | Interface Stability         | Uncommitted                 |<br>
    |_____________________________|_____________________________|<br>
    | Utility Output Format       | Not-an-Interface            |<br>
    |_____________________________|_____________________________|<br>
  </samp><br>
</blockquote>
<br>
You haven't mentioned anything about underlying kstats.  Is this how
these stats are implemented?  Should that be covered under an ARC case
as well (perhaps this one)?<br>
<br>
    - Garrett<br>
<blockquote cite="mid:4BBD6DEF.7010400@oracle.com" type="cite"><br>
  <br>
  <blockquote cite="mid:4BBD548D.4060509@oracle.com" type="cite"><br>
    - Garrett <br>
    <br>
On 04/ 7/10 05:51 PM, Jordan Brown wrote: <br>
    <blockquote type="cite">Template Version: @(#)sac_nextcase 1.70
03/30/10 SMI <br>
This information is Copyright (c) 2010, Oracle and/or its affiliates.
All rights reserved. <br>
1. Introduction <br>
     1.1. Project/Component Working Name: <br>
     SMB/CIFS Statistics <br>
     1.2. Name of Document Author/Supplier: <br>
     Author:  Jose Borrego <br>
     1.3  Date of This Document: <br>
    07 April, 2010 <br>
      <br>
     1.4. Name of Major Document Customer(s)/Consumer(s): <br>
          PSARC <br>
    CIFS team <br>
      <br>
     1.5. Email Aliases: <br>
          1.5.1. Responsible Manager: <a moz-do-not-send="true"
 class="moz-txt-link-abbreviated" href="mailto:Barry.Greenberg@Sun.COM">Barry.Greenberg@Sun.COM</a>
      <br>
          1.5.2. Responsible Engineer: <a moz-do-not-send="true"
 class="moz-txt-link-abbreviated" href="mailto:Jose.Borrego@Sun.COM">Jose.Borrego@Sun.COM</a>
      <br>
          1.5.3. Marketing Manager: <br>
    1.5.4. Interest List: <a moz-do-not-send="true"
 class="moz-txt-link-abbreviated" href="mailto:cifs-team@sun.com">cifs-team@sun.com</a>
      <br>
      <br>
4. Technical Description: <br>
      <br>
Executive Summary: <br>
      <br>
     This case improves the statistics the SMB/CIFS server maintains as
well as <br>
     the output of smbstat. <br>
      <br>
Problem: <br>
      <br>
     Currently the only statistics the SMB/CIFS server maintains are
counters <br>
     keeping track of how many requests of each type were received, the
number <br>
     of open files, the number of sessions (users logged in) and the
number of <br>
     connections (trees connected). Those statistics are not enough to
describe <br>
     the load being applied as well as how the server is responding to
it. <br>
      <br>
Solution: <br>
      <br>
     In order to get a better picture of the state of the SMB/CIFS
server the <br>
     following information can be maintained and provided through
smbstat: <br>
      <br>
     - Counters: <br>
    * nbt: <br>
        Number of SMB NetBIOS-over-TCP (NBT) sessions. <br>
      <br>
    * tcp: <br>
        Number of SMB TCP sessions. <br>
      <br>
    * users: <br>
        Number of users logged in. <br>
      <br>
    * trees: <br>
        Number of trees connected. <br>
      <br>
    * files: <br>
        Number of open files. <br>
      <br>
    * pipes: <br>
        Number of open pipes. <br>
      <br>
     - Throughput: <br>
    * rbytes/s: <br>
        Number of bytes received per second. <br>
      <br>
    * tbytes/s: <br>
        Number of bytes transmitted per second. <br>
      <br>
    * reqs/s: <br>
        Number of requests handled per second. <br>
      <br>
    * reads/s: <br>
        Number of read requests per second. This would be an
aggregation of <br>
        the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ, <br>
        SMB_COM_READ_RAW and SMB_COM_READ_ANDX. <br>
      <br>
    * writes/s: <br>
        Number of write requests per second. This would ba an
aggregation of <br>
        the following requests: SMB_COM_WRITE,
SMB_COM_WRITE_AND_UNLOCK, <br>
        SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE. <br>
      <br>
     - Utilization: <br>
         * wcnt: <br>
        Average number of requests received but waiting for an SMB
worker <br>
        thread to execute them. <br>
      <br>
         * rcnt: <br>
        Average number of requests being simultaneously executed by an
SMB <br>
        worker thread. <br>
      <br>
    * wtime: <br>
        Average time a request waits before an SMB worker thread starts
      <br>
        executing it. <br>
      <br>
         * rtime: <br>
        Average execution time of a request. <br>
      <br>
         * w%: <br>
        Percentage of the time during which at least one request was <br>
        waiting. <br>
      <br>
         * r%: <br>
        Percentage of the time during which at least one request was
being <br>
        executed. <br>
      <br>
         * u%: <br>
        Percentage of utilization of the SMB/CIFS server. This number
is <br>
        defined as: rcnt / (Max Worker Threads). <br>
      <br>
         * sat: <br>
        Flag indicating if the server saturated in the past. Saturation
is <br>
        defined as: u% == 100%. <br>
      <br>
    * usr%: <br>
        Percentage of the time the processor(s) spent in user space. <br>
      <br>
    * sys%: <br>
        Percentage of the time the processor(s) spent in kernel space. <br>
      <br>
    * idle%: <br>
        Percentage of the time the processor(s) was(were) idle. <br>
      <br>
     - Requests: <br>
         For each type of request: <br>
         * %: <br>
        Percentage of that type of request. <br>
      <br>
         * rbytes/s: <br>
        Number of bytes received per second. <br>
      <br>
         * tbytes/s: <br>
        Number of bytes received per second. <br>
      <br>
         * req/s: <br>
        Number of requests handled per second. <br>
      <br>
         * rt-mean: <br>
        Average response time in seconds. <br>
      <br>
         *  rt-stddev: <br>
        Standard deviation of the response time. <br>
      <br>
     To access this information the CLI smbstat must be modified and
allow the <br>
     following options: <br>
      <br>
     -r  Display the statistics of the requests. <br>
      <br>
         -a  Display the statistics of all the types of request (the
256 of <br>
             them) whether they are valid or not. <br>
      <br>
         -n  Display in alphabetic order. <br>
      <br>
         -z  Display the statistics of the requests actually received. <br>
      <br>
     -t  Display the throughput of the SMB/CIFS server. <br>
      <br>
     -u  Display the utilization of the SMB/CIFS server. <br>
      <br>
     -c  Display the counters. <br>
      <br>
     A number can also be provided indicating the interval of time
between <br>
     refreshes. The first statistics displayed cover the time between
when <br>
     the server was started and the moment the statistics were
requested. <br>
     Subsequent refreshes cover the last time interval only. <br>
      <br>
     It should be noted that the output is all new replacing the old
one and <br>
     is for humans only. <br>
      <br>
Examples of smbstat output: <br>
      <br>
     'smbstat -ctu' <br>
      <br>
       nbt   tcp users trees files pipes <br>
         0     1     1     2    20     0 <br>
      <br>
     rbytes/s   tbytes/s    reqs/s     reads/s   writes/s <br>
     1.036e+02  1.298e+00  0.000e+00  0.000e+00  0.000e+00 <br>
      <br>
       wcnt       rcnt       wtime      rtime     w%   r%   u%  sat
usr% sys% idle% <br>
     4.317e-01  7.410e+00  2.461e-05  4.224e-04   31  100    0  no   
0   76    24 <br>
      <br>
     'smbstat -r' <br>
      <br>
                                code   %   rbytes/s   tbytes/s    
req/s     rt-mean   rt-stddev <br>
             SmbCreateDirectory  00     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
             SmbDeleteDirectory  01     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbOpen  02     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                      SmbCreate  03     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbClose  04     0  0.000e+00  0.000e+00 
0.000e+00  2.496e-04  8.003e-06 <br>
                       SmbFlush  05     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                      SmbDelete  06     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                      SmbRename  07     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
            SmbQueryInformation  08     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbSetInformation  09     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbRead  0A     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbWrite  0B     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
               SmbLockByteRange  0C     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
             SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
             SmbCreateTemporary  0E     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                   SmbCreateNew  0F     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbCheckDirectory  10     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                 SmbProcessExit  11     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbSeek  12     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                 SmbLockAndRead  13     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                     SmbReadRaw  1A     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                    SmbWriteRaw  1D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
             SmbSetInformation2  22     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
           SmbQueryInformation2  23     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                    SmbLockingX  24     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                 SmbTransaction  25     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
        SmbTransactionSecondary  26     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbIoctl  27     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbEcho  2B     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
               SmbWriteAndClose  2C     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbOpenX  2D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbReadX  2E     0  0.000e+00  0.000e+00 
0.000e+00  3.550e-04  1.856e-05 <br>
                      SmbWriteX  2F   100  4.607e+02  1.675e+00 
0.000e+00  3.893e-04  2.691e-07 <br>
      SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                SmbTransaction2  32     0  0.000e+00  0.000e+00 
0.000e+00  5.203e-04  8.612e-06 <br>
       SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                  SmbFindClose2  34     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                 SmbTreeConnect  70     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbTreeDisconnect  71     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                   SmbNegotiate  72     0  0.000e+00  0.000e+00 
0.000e+00  4.625e-05  0.000e+00 <br>
               SmbSessionSetupX  73     0  0.000e+00  0.000e+00 
0.000e+00  1.145e-01  0.000e+00 <br>
                     SmbLogoffX  74     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                SmbTreeConnectX  75     0  0.000e+00  0.000e+00 
0.000e+00  5.851e-04  2.436e-05 <br>
        SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                      SmbSearch  81     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbFind  82     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                  SmbFindUnique  83     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                   SmbFindClose  84     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                  SmbNtTransact  A0     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
         SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                   SmbNtCreateX  A2     0  0.000e+00  0.000e+00 
0.000e+00  5.154e-02  2.063e-03 <br>
                    SmbNtCancel  A4     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                    SmbNtRename  A5     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
               SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbWritePrintFile  C1     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbClosePrintFile  C2     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
               SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
      <br>
     'smbstat -rz' <br>
      <br>
                                code   %   rbytes/s   tbytes/s    
req/s     rt-mean   rt-stddev <br>
                       SmbClose  04     0  0.000e+00  0.000e+00 
0.000e+00  2.445e-04  5.906e-06 <br>
                       SmbReadX  2E     4  0.000e+00  2.772e+01 
0.000e+00  1.556e-03  7.878e-06 <br>
                      SmbWriteX  2F    96  7.162e+02  2.604e+00 
0.000e+00  5.365e-04  3.913e-07 <br>
                SmbTransaction2  32     0  0.000e+00  0.000e+00 
0.000e+00  5.203e-04  8.612e-06 <br>
                   SmbNegotiate  72     0  0.000e+00  0.000e+00 
0.000e+00  4.625e-05  0.000e+00 <br>
               SmbSessionSetupX  73     0  0.000e+00  0.000e+00 
0.000e+00  1.145e-01  0.000e+00 <br>
                SmbTreeConnectX  75     0  0.000e+00  0.000e+00 
0.000e+00  5.851e-04  2.436e-05 <br>
                   SmbNtCreateX  A2     0  0.000e+00  0.000e+00 
0.000e+00  7.250e-02  2.304e-03 <br>
      <br>
6. Resources and Schedule <br>
     6.4. Steering Committee requested information <br>
        6.4.1. Consolidation C-team Name: <br>
        ON <br>
     6.5. ARC review type: FastTrack <br>
     6.6. ARC Exposure: open <br>
   </blockquote>
    <br>
  </blockquote>
  <br>
</blockquote>
<br>
</body>
</html>

--Boundary_(ID_Jz5PBDqGWxBAqiF2qnlZZg)--

From garrett.damore@oracle.com Wed Apr  7 22:59:36 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o385xaiI001489
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 7 Apr 2010 22:59:36 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o385xaqW018646
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 7 Apr 2010 23:59:36 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00G0BNBBD800@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 07 Apr 2010 22:59:35 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J00EAPNBA00F0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 07 Apr 2010 22:59:34 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o385xX7o021663	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 05:59:33 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o385WEvV014990	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 05:59:33 +0000 (GMT)
Received: from abhmt008.oracle.com by acsmt355.oracle.com	with ESMTP id
 145050001270706370; Wed, 07 Apr 2010 22:59:30 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Wed,
 07 Apr 2010 22:59:29 -0700
Date: Wed, 07 Apr 2010 22:59:27 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBD6DEF.7010400@oracle.com>
To: Jordan Brown <Jordan.Brown@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBD70BF.2070508@oracle.com>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_RiQ5qXP/TN3i0pngu/5kxg)"
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090204.4BBD70C5.00A3:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 33206

This is a multi-part message in MIME format.

--Boundary_(ID_RiQ5qXP/TN3i0pngu/5kxg)
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT

On 04/ 7/10 10:47 PM, Jordan Brown wrote:
> Garrett D'Amore wrote:
>>
>> What's missing is an interface table.  I think though that based on 
>> the statement that its not to be parsed ("for humans only"), the 
>> output is not-an-interface.
>
> Yes.  The stability is the same as the existing command:
>
>     |_____________________________|_____________________________|
>     | Interface Stability         | Uncommitted                 |
>     |_____________________________|_____________________________|
>     | Utility Output Format       | Not-an-Interface            |
>     |_____________________________|_____________________________|
>

You haven't mentioned anything about underlying kstats.  Is this how 
these stats are implemented?  Should that be covered under an ARC case 
as well (perhaps this one)?

     - Garrett
>
>
>>
>>     - Garrett
>>
>> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>>> This information is Copyright (c) 2010, Oracle and/or its 
>>> affiliates. All rights reserved.
>>> 1. Introduction
>>>      1.1. Project/Component Working Name:
>>>      SMB/CIFS Statistics
>>>      1.2. Name of Document Author/Supplier:
>>>      Author:  Jose Borrego
>>>      1.3  Date of This Document:
>>>     07 April, 2010
>>>
>>>      1.4. Name of Major Document Customer(s)/Consumer(s):
>>>           PSARC
>>>     CIFS team
>>>
>>>      1.5. Email Aliases:
>>>           1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>>           1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>>           1.5.3. Marketing Manager:
>>>     1.5.4. Interest List: cifs-team@sun.com
>>>
>>> 4. Technical Description:
>>>
>>> Executive Summary:
>>>
>>>      This case improves the statistics the SMB/CIFS server maintains 
>>> as well as
>>>      the output of smbstat.
>>>
>>> Problem:
>>>
>>>      Currently the only statistics the SMB/CIFS server maintains are 
>>> counters
>>>      keeping track of how many requests of each type were received, 
>>> the number
>>>      of open files, the number of sessions (users logged in) and the 
>>> number of
>>>      connections (trees connected). Those statistics are not enough 
>>> to describe
>>>      the load being applied as well as how the server is responding 
>>> to it.
>>>
>>> Solution:
>>>
>>>      In order to get a better picture of the state of the SMB/CIFS 
>>> server the
>>>      following information can be maintained and provided through 
>>> smbstat:
>>>
>>>      - Counters:
>>>     * nbt:
>>>         Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>>
>>>     * tcp:
>>>         Number of SMB TCP sessions.
>>>
>>>     * users:
>>>         Number of users logged in.
>>>
>>>     * trees:
>>>         Number of trees connected.
>>>
>>>     * files:
>>>         Number of open files.
>>>
>>>     * pipes:
>>>         Number of open pipes.
>>>
>>>      - Throughput:
>>>     * rbytes/s:
>>>         Number of bytes received per second.
>>>
>>>     * tbytes/s:
>>>         Number of bytes transmitted per second.
>>>
>>>     * reqs/s:
>>>         Number of requests handled per second.
>>>
>>>     * reads/s:
>>>         Number of read requests per second. This would be an 
>>> aggregation of
>>>         the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>>         SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>>
>>>     * writes/s:
>>>         Number of write requests per second. This would ba an 
>>> aggregation of
>>>         the following requests: SMB_COM_WRITE, 
>>> SMB_COM_WRITE_AND_UNLOCK,
>>>         SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>>
>>>      - Utilization:
>>>          * wcnt:
>>>         Average number of requests received but waiting for an SMB 
>>> worker
>>>         thread to execute them.
>>>
>>>          * rcnt:
>>>         Average number of requests being simultaneously executed by 
>>> an SMB
>>>         worker thread.
>>>
>>>     * wtime:
>>>         Average time a request waits before an SMB worker thread starts
>>>         executing it.
>>>
>>>          * rtime:
>>>         Average execution time of a request.
>>>
>>>          * w%:
>>>         Percentage of the time during which at least one request was
>>>         waiting.
>>>
>>>          * r%:
>>>         Percentage of the time during which at least one request was 
>>> being
>>>         executed.
>>>
>>>          * u%:
>>>         Percentage of utilization of the SMB/CIFS server. This 
>>> number is
>>>         defined as: rcnt / (Max Worker Threads).
>>>
>>>          * sat:
>>>         Flag indicating if the server saturated in the past. 
>>> Saturation is
>>>         defined as: u% == 100%.
>>>
>>>     * usr%:
>>>         Percentage of the time the processor(s) spent in user space.
>>>
>>>     * sys%:
>>>         Percentage of the time the processor(s) spent in kernel space.
>>>
>>>     * idle%:
>>>         Percentage of the time the processor(s) was(were) idle.
>>>
>>>      - Requests:
>>>          For each type of request:
>>>          * %:
>>>         Percentage of that type of request.
>>>
>>>          * rbytes/s:
>>>         Number of bytes received per second.
>>>
>>>          * tbytes/s:
>>>         Number of bytes received per second.
>>>
>>>          * req/s:
>>>         Number of requests handled per second.
>>>
>>>          * rt-mean:
>>>         Average response time in seconds.
>>>
>>>          *  rt-stddev:
>>>         Standard deviation of the response time.
>>>
>>>      To access this information the CLI smbstat must be modified and 
>>> allow the
>>>      following options:
>>>
>>>      -r  Display the statistics of the requests.
>>>
>>>          -a  Display the statistics of all the types of request (the 
>>> 256 of
>>>              them) whether they are valid or not.
>>>
>>>          -n  Display in alphabetic order.
>>>
>>>          -z  Display the statistics of the requests actually received.
>>>
>>>      -t  Display the throughput of the SMB/CIFS server.
>>>
>>>      -u  Display the utilization of the SMB/CIFS server.
>>>
>>>      -c  Display the counters.
>>>
>>>      A number can also be provided indicating the interval of time 
>>> between
>>>      refreshes. The first statistics displayed cover the time 
>>> between when
>>>      the server was started and the moment the statistics were 
>>> requested.
>>>      Subsequent refreshes cover the last time interval only.
>>>
>>>      It should be noted that the output is all new replacing the old 
>>> one and
>>>      is for humans only.
>>>
>>> Examples of smbstat output:
>>>
>>>      '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
>>>
>>>      'smbstat -r'
>>>
>>>                                 code   %   rbytes/s   tbytes/s     
>>> req/s     rt-mean   rt-stddev
>>>              SmbCreateDirectory  00     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>              SmbDeleteDirectory  01     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbOpen  02     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                       SmbCreate  03     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbClose  04     0  0.000e+00  0.000e+00  
>>> 0.000e+00  2.496e-04  8.003e-06
>>>                        SmbFlush  05     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                       SmbDelete  06     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                       SmbRename  07     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>             SmbQueryInformation  08     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbSetInformation  09     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbRead  0A     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbWrite  0B     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                SmbLockByteRange  0C     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>              SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>              SmbCreateTemporary  0E     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                    SmbCreateNew  0F     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbCheckDirectory  10     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                  SmbProcessExit  11     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbSeek  12     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                  SmbLockAndRead  13     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                      SmbReadRaw  1A     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                     SmbWriteRaw  1D     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>              SmbSetInformation2  22     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>            SmbQueryInformation2  23     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                     SmbLockingX  24     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                  SmbTransaction  25     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>         SmbTransactionSecondary  26     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbIoctl  27     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbEcho  2B     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                SmbWriteAndClose  2C     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbOpenX  2D     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                        SmbReadX  2E     0  0.000e+00  0.000e+00  
>>> 0.000e+00  3.550e-04  1.856e-05
>>>                       SmbWriteX  2F   100  4.607e+02  1.675e+00  
>>> 0.000e+00  3.893e-04  2.691e-07
>>>       SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.203e-04  8.612e-06
>>>        SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                   SmbFindClose2  34     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                  SmbTreeConnect  70     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbTreeDisconnect  71     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  
>>> 0.000e+00  4.625e-05  0.000e+00
>>>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  
>>> 0.000e+00  1.145e-01  0.000e+00
>>>                      SmbLogoffX  74     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.851e-04  2.436e-05
>>>         SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                       SmbSearch  81     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                         SmbFind  82     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                   SmbFindUnique  83     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                    SmbFindClose  84     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                   SmbNtTransact  A0     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>          SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.154e-02  2.063e-03
>>>                     SmbNtCancel  A4     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                     SmbNtRename  A5     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbWritePrintFile  C1     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>               SmbClosePrintFile  C2     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>                SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00  
>>> 0.000e+00  0.000e+00  0.000e+00
>>>
>>>      'smbstat -rz'
>>>
>>>                                 code   %   rbytes/s   tbytes/s     
>>> req/s     rt-mean   rt-stddev
>>>                        SmbClose  04     0  0.000e+00  0.000e+00  
>>> 0.000e+00  2.445e-04  5.906e-06
>>>                        SmbReadX  2E     4  0.000e+00  2.772e+01  
>>> 0.000e+00  1.556e-03  7.878e-06
>>>                       SmbWriteX  2F    96  7.162e+02  2.604e+00  
>>> 0.000e+00  5.365e-04  3.913e-07
>>>                 SmbTransaction2  32     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.203e-04  8.612e-06
>>>                    SmbNegotiate  72     0  0.000e+00  0.000e+00  
>>> 0.000e+00  4.625e-05  0.000e+00
>>>                SmbSessionSetupX  73     0  0.000e+00  0.000e+00  
>>> 0.000e+00  1.145e-01  0.000e+00
>>>                 SmbTreeConnectX  75     0  0.000e+00  0.000e+00  
>>> 0.000e+00  5.851e-04  2.436e-05
>>>                    SmbNtCreateX  A2     0  0.000e+00  0.000e+00  
>>> 0.000e+00  7.250e-02  2.304e-03
>>>
>>> 6. Resources and Schedule
>>>      6.4. Steering Committee requested information
>>>         6.4.1. Consolidation C-team Name:
>>>         ON
>>>      6.5. ARC review type: FastTrack
>>>      6.6. ARC Exposure: open
>>
>


--Boundary_(ID_RiQ5qXP/TN3i0pngu/5kxg)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: 8BIT

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#ffffff">
On 04/ 7/10 10:47 PM, Jordan Brown wrote:
<blockquote cite="mid:4BBD6DEF.7010400@oracle.com" type="cite">
  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
Garrett D'Amore wrote:
  <blockquote cite="mid:4BBD548D.4060509@oracle.com" type="cite"><br>
What's missing is an interface table.  I think though that based on the
statement that its not to be parsed ("for humans only"), the output is
not-an-interface. <br>
  </blockquote>
  <br>
Yes.  The stability is the same as the existing command:<br>
  <br>
  <samp>   
|_____________________________|_____________________________|<br>
    | Interface Stability         | Uncommitted                 |<br>
    |_____________________________|_____________________________|<br>
    | Utility Output Format       | Not-an-Interface            |<br>
    |_____________________________|_____________________________|<br>
  </samp><br>
</blockquote>
<br>
You haven't mentioned anything about underlying kstats.  Is this how
these stats are implemented?  Should that be covered under an ARC case
as well (perhaps this one)?<br>
<br>
    - Garrett<br>
<blockquote cite="mid:4BBD6DEF.7010400@oracle.com" type="cite"><br>
  <br>
  <blockquote cite="mid:4BBD548D.4060509@oracle.com" type="cite"><br>
    - Garrett <br>
    <br>
On 04/ 7/10 05:51 PM, Jordan Brown wrote: <br>
    <blockquote type="cite">Template Version: @(#)sac_nextcase 1.70
03/30/10 SMI <br>
This information is Copyright (c) 2010, Oracle and/or its affiliates.
All rights reserved. <br>
1. Introduction <br>
     1.1. Project/Component Working Name: <br>
     SMB/CIFS Statistics <br>
     1.2. Name of Document Author/Supplier: <br>
     Author:  Jose Borrego <br>
     1.3  Date of This Document: <br>
    07 April, 2010 <br>
      <br>
     1.4. Name of Major Document Customer(s)/Consumer(s): <br>
          PSARC <br>
    CIFS team <br>
      <br>
     1.5. Email Aliases: <br>
          1.5.1. Responsible Manager: <a moz-do-not-send="true"
 class="moz-txt-link-abbreviated" href="mailto:Barry.Greenberg@Sun.COM">Barry.Greenberg@Sun.COM</a>
      <br>
          1.5.2. Responsible Engineer: <a moz-do-not-send="true"
 class="moz-txt-link-abbreviated" href="mailto:Jose.Borrego@Sun.COM">Jose.Borrego@Sun.COM</a>
      <br>
          1.5.3. Marketing Manager: <br>
    1.5.4. Interest List: <a moz-do-not-send="true"
 class="moz-txt-link-abbreviated" href="mailto:cifs-team@sun.com">cifs-team@sun.com</a>
      <br>
      <br>
4. Technical Description: <br>
      <br>
Executive Summary: <br>
      <br>
     This case improves the statistics the SMB/CIFS server maintains as
well as <br>
     the output of smbstat. <br>
      <br>
Problem: <br>
      <br>
     Currently the only statistics the SMB/CIFS server maintains are
counters <br>
     keeping track of how many requests of each type were received, the
number <br>
     of open files, the number of sessions (users logged in) and the
number of <br>
     connections (trees connected). Those statistics are not enough to
describe <br>
     the load being applied as well as how the server is responding to
it. <br>
      <br>
Solution: <br>
      <br>
     In order to get a better picture of the state of the SMB/CIFS
server the <br>
     following information can be maintained and provided through
smbstat: <br>
      <br>
     - Counters: <br>
    * nbt: <br>
        Number of SMB NetBIOS-over-TCP (NBT) sessions. <br>
      <br>
    * tcp: <br>
        Number of SMB TCP sessions. <br>
      <br>
    * users: <br>
        Number of users logged in. <br>
      <br>
    * trees: <br>
        Number of trees connected. <br>
      <br>
    * files: <br>
        Number of open files. <br>
      <br>
    * pipes: <br>
        Number of open pipes. <br>
      <br>
     - Throughput: <br>
    * rbytes/s: <br>
        Number of bytes received per second. <br>
      <br>
    * tbytes/s: <br>
        Number of bytes transmitted per second. <br>
      <br>
    * reqs/s: <br>
        Number of requests handled per second. <br>
      <br>
    * reads/s: <br>
        Number of read requests per second. This would be an
aggregation of <br>
        the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ, <br>
        SMB_COM_READ_RAW and SMB_COM_READ_ANDX. <br>
      <br>
    * writes/s: <br>
        Number of write requests per second. This would ba an
aggregation of <br>
        the following requests: SMB_COM_WRITE,
SMB_COM_WRITE_AND_UNLOCK, <br>
        SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE. <br>
      <br>
     - Utilization: <br>
         * wcnt: <br>
        Average number of requests received but waiting for an SMB
worker <br>
        thread to execute them. <br>
      <br>
         * rcnt: <br>
        Average number of requests being simultaneously executed by an
SMB <br>
        worker thread. <br>
      <br>
    * wtime: <br>
        Average time a request waits before an SMB worker thread starts
      <br>
        executing it. <br>
      <br>
         * rtime: <br>
        Average execution time of a request. <br>
      <br>
         * w%: <br>
        Percentage of the time during which at least one request was <br>
        waiting. <br>
      <br>
         * r%: <br>
        Percentage of the time during which at least one request was
being <br>
        executed. <br>
      <br>
         * u%: <br>
        Percentage of utilization of the SMB/CIFS server. This number
is <br>
        defined as: rcnt / (Max Worker Threads). <br>
      <br>
         * sat: <br>
        Flag indicating if the server saturated in the past. Saturation
is <br>
        defined as: u% == 100%. <br>
      <br>
    * usr%: <br>
        Percentage of the time the processor(s) spent in user space. <br>
      <br>
    * sys%: <br>
        Percentage of the time the processor(s) spent in kernel space. <br>
      <br>
    * idle%: <br>
        Percentage of the time the processor(s) was(were) idle. <br>
      <br>
     - Requests: <br>
         For each type of request: <br>
         * %: <br>
        Percentage of that type of request. <br>
      <br>
         * rbytes/s: <br>
        Number of bytes received per second. <br>
      <br>
         * tbytes/s: <br>
        Number of bytes received per second. <br>
      <br>
         * req/s: <br>
        Number of requests handled per second. <br>
      <br>
         * rt-mean: <br>
        Average response time in seconds. <br>
      <br>
         *  rt-stddev: <br>
        Standard deviation of the response time. <br>
      <br>
     To access this information the CLI smbstat must be modified and
allow the <br>
     following options: <br>
      <br>
     -r  Display the statistics of the requests. <br>
      <br>
         -a  Display the statistics of all the types of request (the
256 of <br>
             them) whether they are valid or not. <br>
      <br>
         -n  Display in alphabetic order. <br>
      <br>
         -z  Display the statistics of the requests actually received. <br>
      <br>
     -t  Display the throughput of the SMB/CIFS server. <br>
      <br>
     -u  Display the utilization of the SMB/CIFS server. <br>
      <br>
     -c  Display the counters. <br>
      <br>
     A number can also be provided indicating the interval of time
between <br>
     refreshes. The first statistics displayed cover the time between
when <br>
     the server was started and the moment the statistics were
requested. <br>
     Subsequent refreshes cover the last time interval only. <br>
      <br>
     It should be noted that the output is all new replacing the old
one and <br>
     is for humans only. <br>
      <br>
Examples of smbstat output: <br>
      <br>
     'smbstat -ctu' <br>
      <br>
       nbt   tcp users trees files pipes <br>
         0     1     1     2    20     0 <br>
      <br>
     rbytes/s   tbytes/s    reqs/s     reads/s   writes/s <br>
     1.036e+02  1.298e+00  0.000e+00  0.000e+00  0.000e+00 <br>
      <br>
       wcnt       rcnt       wtime      rtime     w%   r%   u%  sat
usr% sys% idle% <br>
     4.317e-01  7.410e+00  2.461e-05  4.224e-04   31  100    0  no   
0   76    24 <br>
      <br>
     'smbstat -r' <br>
      <br>
                                code   %   rbytes/s   tbytes/s    
req/s     rt-mean   rt-stddev <br>
             SmbCreateDirectory  00     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
             SmbDeleteDirectory  01     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbOpen  02     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                      SmbCreate  03     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbClose  04     0  0.000e+00  0.000e+00 
0.000e+00  2.496e-04  8.003e-06 <br>
                       SmbFlush  05     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                      SmbDelete  06     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                      SmbRename  07     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
            SmbQueryInformation  08     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbSetInformation  09     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbRead  0A     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbWrite  0B     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
               SmbLockByteRange  0C     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
             SmbUnlockByteRange  0D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
             SmbCreateTemporary  0E     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                   SmbCreateNew  0F     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbCheckDirectory  10     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                 SmbProcessExit  11     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbSeek  12     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                 SmbLockAndRead  13     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbWriteAndUnlock  14     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                     SmbReadRaw  1A     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                    SmbWriteRaw  1D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
             SmbSetInformation2  22     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
           SmbQueryInformation2  23     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                    SmbLockingX  24     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                 SmbTransaction  25     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
        SmbTransactionSecondary  26     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbIoctl  27     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbEcho  2B     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
               SmbWriteAndClose  2C     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbOpenX  2D     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                       SmbReadX  2E     0  0.000e+00  0.000e+00 
0.000e+00  3.550e-04  1.856e-05 <br>
                      SmbWriteX  2F   100  4.607e+02  1.675e+00 
0.000e+00  3.893e-04  2.691e-07 <br>
      SmbCloseAndTreeDisconnect  31     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                SmbTransaction2  32     0  0.000e+00  0.000e+00 
0.000e+00  5.203e-04  8.612e-06 <br>
       SmbTransaction2Secondary  33     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                  SmbFindClose2  34     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                 SmbTreeConnect  70     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbTreeDisconnect  71     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                   SmbNegotiate  72     0  0.000e+00  0.000e+00 
0.000e+00  4.625e-05  0.000e+00 <br>
               SmbSessionSetupX  73     0  0.000e+00  0.000e+00 
0.000e+00  1.145e-01  0.000e+00 <br>
                     SmbLogoffX  74     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                SmbTreeConnectX  75     0  0.000e+00  0.000e+00 
0.000e+00  5.851e-04  2.436e-05 <br>
        SmbQueryInformationDisk  80     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                      SmbSearch  81     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                        SmbFind  82     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                  SmbFindUnique  83     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                   SmbFindClose  84     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                  SmbNtTransact  A0     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
         SmbNtTransactSecondary  A1     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                   SmbNtCreateX  A2     0  0.000e+00  0.000e+00 
0.000e+00  5.154e-02  2.063e-03 <br>
                    SmbNtCancel  A4     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
                    SmbNtRename  A5     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
               SmbOpenPrintFile  C0     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbWritePrintFile  C1     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
              SmbClosePrintFile  C2     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
               SmbGetPrintQueue  C3     0  0.000e+00  0.000e+00 
0.000e+00  0.000e+00  0.000e+00 <br>
      <br>
     'smbstat -rz' <br>
      <br>
                                code   %   rbytes/s   tbytes/s    
req/s     rt-mean   rt-stddev <br>
                       SmbClose  04     0  0.000e+00  0.000e+00 
0.000e+00  2.445e-04  5.906e-06 <br>
                       SmbReadX  2E     4  0.000e+00  2.772e+01 
0.000e+00  1.556e-03  7.878e-06 <br>
                      SmbWriteX  2F    96  7.162e+02  2.604e+00 
0.000e+00  5.365e-04  3.913e-07 <br>
                SmbTransaction2  32     0  0.000e+00  0.000e+00 
0.000e+00  5.203e-04  8.612e-06 <br>
                   SmbNegotiate  72     0  0.000e+00  0.000e+00 
0.000e+00  4.625e-05  0.000e+00 <br>
               SmbSessionSetupX  73     0  0.000e+00  0.000e+00 
0.000e+00  1.145e-01  0.000e+00 <br>
                SmbTreeConnectX  75     0  0.000e+00  0.000e+00 
0.000e+00  5.851e-04  2.436e-05 <br>
                   SmbNtCreateX  A2     0  0.000e+00  0.000e+00 
0.000e+00  7.250e-02  2.304e-03 <br>
      <br>
6. Resources and Schedule <br>
     6.4. Steering Committee requested information <br>
        6.4.1. Consolidation C-team Name: <br>
        ON <br>
     6.5. ARC review type: FastTrack <br>
     6.6. ARC Exposure: open <br>
   </blockquote>
    <br>
  </blockquote>
  <br>
</blockquote>
<br>
</body>
</html>

--Boundary_(ID_RiQ5qXP/TN3i0pngu/5kxg)--

From Jordan.Brown@oracle.com Wed Apr  7 23:23:56 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o386NuN2001868
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 7 Apr 2010 23:23:56 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o386Ntud016727
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 7 Apr 2010 23:23:55 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00G0JOFV5C00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 00:23:55 -0600 (MDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J00CS4OFURQ10@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 00:23:54 -0600 (MDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o386NsqI000264	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 06:23:54 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38685td028743	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 06:23:53 +0000 (GMT)
Received: from abhmt018.oracle.com by acsmt354.oracle.com	with ESMTP id
 145097621270707826; Wed, 07 Apr 2010 23:23:46 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Wed,
 07 Apr 2010 23:23:45 -0700
Date: Wed, 07 Apr 2010 23:23:44 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBD70BF.2070508@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBD7670.4010602@oracle.com>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_asYraUUG7TxZZjbqWRKO3w)"
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090207.4BBD7679.00AD:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 1504

This is a multi-part message in MIME format.

--Boundary_(ID_asYraUUG7TxZZjbqWRKO3w)
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT

Garrett D'Amore wrote:
> You haven't mentioned anything about underlying kstats.  Is this how 
> these stats are implemented?  Should that be covered under an ARC case 
> as well (perhaps this one)?

Jose is really the one to answer that, but as I'm here at the moment and 
he's presumably not, I'll take a stab at that:  the mechanism by which 
the statistics are collected is, I assume, project private.


--Boundary_(ID_asYraUUG7TxZZjbqWRKO3w)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: 8BIT

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html;charset=UTF-8" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
Garrett D'Amore wrote:
<blockquote cite="mid:4BBD70BF.2070508@oracle.com" type="cite">
  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
You haven't mentioned anything about underlying kstats.  Is this how
these stats are implemented?  Should that be covered under an ARC case
as well (perhaps this one)?</blockquote>
<br>
Jose is really the one to answer that, but as I'm here at the moment
and he's presumably not, I'll take a stab at that:  the mechanism by
which the statistics are collected is, I assume, project private.<br>
<br>
</body>
</html>

--Boundary_(ID_asYraUUG7TxZZjbqWRKO3w)--

From Jordan.Brown@oracle.com Wed Apr  7 23:23:56 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o386Nue2001869
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 7 Apr 2010 23:23:56 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o386Ntof029132
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 01:23:55 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00L0POFUWM00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 07 Apr 2010 23:23:54 -0700 (PDT)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J002HGOFTVYD0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 07 Apr 2010 23:23:53 -0700 (PDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o386Nr1D020897	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 06:23:53 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38685tb028743	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 06:23:49 +0000 (GMT)
Received: from abhmt018.oracle.com by acsmt354.oracle.com	with ESMTP id
 145097621270707826; Wed, 07 Apr 2010 23:23:46 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Wed,
 07 Apr 2010 23:23:45 -0700
Date: Wed, 07 Apr 2010 23:23:44 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBD70BF.2070508@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBD7670.4010602@oracle.com>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_hfP1RUxMhOW+7A8f1GmOZA)"
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090201.4BBD7678.0190:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 1504

This is a multi-part message in MIME format.

--Boundary_(ID_hfP1RUxMhOW+7A8f1GmOZA)
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT

Garrett D'Amore wrote:
> You haven't mentioned anything about underlying kstats.  Is this how 
> these stats are implemented?  Should that be covered under an ARC case 
> as well (perhaps this one)?

Jose is really the one to answer that, but as I'm here at the moment and 
he's presumably not, I'll take a stab at that:  the mechanism by which 
the statistics are collected is, I assume, project private.


--Boundary_(ID_hfP1RUxMhOW+7A8f1GmOZA)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: 8BIT

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html;charset=UTF-8" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
Garrett D'Amore wrote:
<blockquote cite="mid:4BBD70BF.2070508@oracle.com" type="cite">
  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
You haven't mentioned anything about underlying kstats.  Is this how
these stats are implemented?  Should that be covered under an ARC case
as well (perhaps this one)?</blockquote>
<br>
Jose is really the one to answer that, but as I'm here at the moment
and he's presumably not, I'll take a stab at that:  the mechanism by
which the statistics are collected is, I assume, project private.<br>
<br>
</body>
</html>

--Boundary_(ID_hfP1RUxMhOW+7A8f1GmOZA)--

From jose.borrego@oracle.com Thu Apr  8 00:08:13 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3878D4T004282
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 00:08:13 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3877mMo000931
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 01:08:11 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J0010DQHJR400@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 00:08:07 -0700 (PDT)
Received: from sca-ea-mail-1.sun.com ([192.18.43.24])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J00MVSQHHYJ50@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 00:08:05 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o38784gd001493	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 07:08:05 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o386PYgw016294	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 07:08:04 +0000 (GMT)
Received: from abhmt002.oracle.com by acsmt354.oracle.com	with ESMTP id
 145182471270710482; Thu, 08 Apr 2010 00:08:02 -0700
Received: from obelix (/129.150.32.49)	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Thu, 08 Apr 2010 00:08:02 -0700
Date: Thu, 08 Apr 2010 01:07:58 -0600
From: Jose Borrego <jose.borrego@oracle.com>
Subject: RE: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBD7670.4010602@oracle.com>
To: "'Jordan Brown'" <Jordan.Brown@oracle.com>,
        "'Garrett D'Amore'" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
Organization: Oracle
MIME-version: 1.0
X-Mailer: Microsoft Office Outlook 12.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_MWI7p3u7EgGIUeYlmS67vw)"
Content-language: en-us
Thread-index: AcrW5AzazAuzW7djS4mFPVLLMsgZJwABSADg
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090207.4BBD80D4.00FC:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
Status: RO
Content-Length: 5180

This is a multi-part message in MIME format.

--Boundary_(ID_MWI7p3u7EgGIUeYlmS67vw)
Content-type: text/plain; charset=UTF-8
Content-transfer-encoding: 7BIT

 

From: Jordan Brown [mailto:Jordan.Brown@oracle.com] 
Sent: Thursday, April 08, 2010 12:24 AM
To: Garrett D'Amore
Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]

 

Garrett D'Amore wrote: 

You haven't mentioned anything about underlying kstats.  Is this how these stats are implemented? 

 

All the raw data is collected using kstats. Smbstat massages the data to produce the output. 

 

 Should that be covered under an ARC case as well (perhaps this one)?

 

I honestly don't know how to answer this question.

Jose is really the one to answer that, but as I'm here at the moment and he's presumably not, I'll take a stab at that:  the mechanism by which the statistics are collected is, I assume, project private.


--Boundary_(ID_MWI7p3u7EgGIUeYlmS67vw)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: quoted-printable

<html xmlns:v=3D"urn:schemas-microsoft-com:vml" =
xmlns:o=3D"urn:schemas-microsoft-com:office:office" =
xmlns:w=3D"urn:schemas-microsoft-com:office:word" =
xmlns:m=3D"http://schemas.microsoft.com/office/2004/12/omml" =
xmlns=3D"http://www.w3.org/TR/REC-html40">

<head>
<meta http-equiv=3DContent-Type content=3D"text/html; charset=3Dutf-8">
<meta name=3DGenerator content=3D"Microsoft Word 12 (filtered medium)">
<style>
<!--
 /* Font Definitions */
 @font-face
	{font-family:"Cambria Math";
	panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
	{font-family:Calibri;
	panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
	{font-family:Tahoma;
	panose-1:2 11 6 4 3 5 4 4 2 4;}
 /* Style Definitions */
 p.MsoNormal, li.MsoNormal, div.MsoNormal
	{margin:0in;
	margin-bottom:.0001pt;
	font-size:12.0pt;
	font-family:"Times New Roman","serif";
	color:black;}
a:link, span.MsoHyperlink
	{mso-style-priority:99;
	color:blue;
	text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
	{mso-style-priority:99;
	color:purple;
	text-decoration:underline;}
span.EmailStyle17
	{mso-style-type:personal-reply;
	font-family:"Calibri","sans-serif";
	color:#1F497D;}
.MsoChpDefault
	{mso-style-type:export-only;
	font-size:10.0pt;}
@page Section1
	{size:8.5in 11.0in;
	margin:1.0in 1.0in 1.0in 1.0in;}
div.Section1
	{page:Section1;}
-->
</style>
<!--[if gte mso 9]><xml>
 <o:shapedefaults v:ext=3D"edit" spidmax=3D"1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
 <o:shapelayout v:ext=3D"edit">
  <o:idmap v:ext=3D"edit" data=3D"1" />
 </o:shapelayout></xml><![endif]-->
</head>

<body bgcolor=3Dwhite lang=3DEN-US link=3Dblue vlink=3Dpurple>

<div class=3DSection1>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p>&nbsp;</o:p></span></p>

<div style=3D'border:none;border-left:solid blue 1.5pt;padding:0in 0in =
0in 4.0pt'>

<div>

<div style=3D'border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt =
0in 0in 0in'>

<p class=3DMsoNormal><b><span =
style=3D'font-size:10.0pt;font-family:"Tahoma","sans-serif";
color:windowtext'>From:</span></b><span =
style=3D'font-size:10.0pt;font-family:
"Tahoma","sans-serif";color:windowtext'> Jordan Brown
[mailto:Jordan.Brown@oracle.com] <br>
<b>Sent:</b> Thursday, April 08, 2010 12:24 AM<br>
<b>To:</b> Garrett D'Amore<br>
<b>Cc:</b> PSARC-ext@sun.com; smb-eng_ww@oracle.com<br>
<b>Subject:</b> Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack =
timeout
04/14/2010]<o:p></o:p></span></p>

</div>

</div>

<p class=3DMsoNormal><o:p>&nbsp;</o:p></p>

<p class=3DMsoNormal>Garrett D'Amore wrote: <o:p></o:p></p>

<p class=3DMsoNormal>You haven't mentioned anything about underlying
kstats.&nbsp; Is this how these stats are implemented?<span =
style=3D'font-size:
11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'> =
<o:p></o:p></span></p>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p>&nbsp;</o:p></span></p>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>All the raw data is collected using kstats. Smbstat =
massages the
data to produce the output. <o:p></o:p></span></p>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p>&nbsp;</o:p></span></p>

<p class=3DMsoNormal>=C2=A0Should that be covered under an ARC case as =
well (perhaps
this one)?<o:p></o:p></p>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p>&nbsp;</o:p></span></p>

<p class=3DMsoNormal style=3D'margin-bottom:12.0pt'><span =
style=3D'color:#1F497D'>I honestly
don't know how to answer this question.<o:p></o:p></span></p>

<p class=3DMsoNormal style=3D'margin-bottom:12.0pt'>Jose is really the =
one to
answer that, but as I'm here at the moment and he's presumably not, I'll =
take a
stab at that:&nbsp; the mechanism by which the statistics are collected =
is, I
assume, project private.<o:p></o:p></p>

</div>

</div>

</body>

</html>

--Boundary_(ID_MWI7p3u7EgGIUeYlmS67vw)--

From jose.borrego@oracle.com Thu Apr  8 00:08:17 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3878H6d004733
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 00:08:17 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3871AvU065492
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 01:08:16 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0J00B0JQHHAP00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 00:08:05 -0700 (PDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0J00HSIQHG1240@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 00:08:04 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o387846M023777	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 07:08:04 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o386PYgu016294	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 07:08:03 +0000 (GMT)
Received: from abhmt002.oracle.com by acsmt354.oracle.com	with ESMTP id
 145182471270710482; Thu, 08 Apr 2010 00:08:02 -0700
Received: from obelix (/129.150.32.49)	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Thu, 08 Apr 2010 00:08:02 -0700
Date: Thu, 08 Apr 2010 01:07:58 -0600
From: Jose Borrego <jose.borrego@oracle.com>
Subject: RE: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBD7670.4010602@oracle.com>
To: "'Jordan Brown'" <Jordan.Brown@oracle.com>,
        "'Garrett D'Amore'" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
Organization: Oracle
MIME-version: 1.0
X-Mailer: Microsoft Office Outlook 12.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_cvrk3hL+JypTIGaVLeW4eg)"
Content-language: en-us
Thread-index: AcrW5AzazAuzW7djS4mFPVLLMsgZJwABSADg
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090202.4BBD80D3.010D:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
Status: RO
Content-Length: 5180

This is a multi-part message in MIME format.

--Boundary_(ID_cvrk3hL+JypTIGaVLeW4eg)
Content-type: text/plain; charset=UTF-8
Content-transfer-encoding: 7BIT

 

From: Jordan Brown [mailto:Jordan.Brown@oracle.com] 
Sent: Thursday, April 08, 2010 12:24 AM
To: Garrett D'Amore
Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]

 

Garrett D'Amore wrote: 

You haven't mentioned anything about underlying kstats.  Is this how these stats are implemented? 

 

All the raw data is collected using kstats. Smbstat massages the data to produce the output. 

 

 Should that be covered under an ARC case as well (perhaps this one)?

 

I honestly don't know how to answer this question.

Jose is really the one to answer that, but as I'm here at the moment and he's presumably not, I'll take a stab at that:  the mechanism by which the statistics are collected is, I assume, project private.


--Boundary_(ID_cvrk3hL+JypTIGaVLeW4eg)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: quoted-printable

<html xmlns:v=3D"urn:schemas-microsoft-com:vml" =
xmlns:o=3D"urn:schemas-microsoft-com:office:office" =
xmlns:w=3D"urn:schemas-microsoft-com:office:word" =
xmlns:m=3D"http://schemas.microsoft.com/office/2004/12/omml" =
xmlns=3D"http://www.w3.org/TR/REC-html40">

<head>
<meta http-equiv=3DContent-Type content=3D"text/html; charset=3Dutf-8">
<meta name=3DGenerator content=3D"Microsoft Word 12 (filtered medium)">
<style>
<!--
 /* Font Definitions */
 @font-face
	{font-family:"Cambria Math";
	panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
	{font-family:Calibri;
	panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
	{font-family:Tahoma;
	panose-1:2 11 6 4 3 5 4 4 2 4;}
 /* Style Definitions */
 p.MsoNormal, li.MsoNormal, div.MsoNormal
	{margin:0in;
	margin-bottom:.0001pt;
	font-size:12.0pt;
	font-family:"Times New Roman","serif";
	color:black;}
a:link, span.MsoHyperlink
	{mso-style-priority:99;
	color:blue;
	text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
	{mso-style-priority:99;
	color:purple;
	text-decoration:underline;}
span.EmailStyle17
	{mso-style-type:personal-reply;
	font-family:"Calibri","sans-serif";
	color:#1F497D;}
.MsoChpDefault
	{mso-style-type:export-only;
	font-size:10.0pt;}
@page Section1
	{size:8.5in 11.0in;
	margin:1.0in 1.0in 1.0in 1.0in;}
div.Section1
	{page:Section1;}
-->
</style>
<!--[if gte mso 9]><xml>
 <o:shapedefaults v:ext=3D"edit" spidmax=3D"1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
 <o:shapelayout v:ext=3D"edit">
  <o:idmap v:ext=3D"edit" data=3D"1" />
 </o:shapelayout></xml><![endif]-->
</head>

<body bgcolor=3Dwhite lang=3DEN-US link=3Dblue vlink=3Dpurple>

<div class=3DSection1>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p>&nbsp;</o:p></span></p>

<div style=3D'border:none;border-left:solid blue 1.5pt;padding:0in 0in =
0in 4.0pt'>

<div>

<div style=3D'border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt =
0in 0in 0in'>

<p class=3DMsoNormal><b><span =
style=3D'font-size:10.0pt;font-family:"Tahoma","sans-serif";
color:windowtext'>From:</span></b><span =
style=3D'font-size:10.0pt;font-family:
"Tahoma","sans-serif";color:windowtext'> Jordan Brown
[mailto:Jordan.Brown@oracle.com] <br>
<b>Sent:</b> Thursday, April 08, 2010 12:24 AM<br>
<b>To:</b> Garrett D'Amore<br>
<b>Cc:</b> PSARC-ext@sun.com; smb-eng_ww@oracle.com<br>
<b>Subject:</b> Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack =
timeout
04/14/2010]<o:p></o:p></span></p>

</div>

</div>

<p class=3DMsoNormal><o:p>&nbsp;</o:p></p>

<p class=3DMsoNormal>Garrett D'Amore wrote: <o:p></o:p></p>

<p class=3DMsoNormal>You haven't mentioned anything about underlying
kstats.&nbsp; Is this how these stats are implemented?<span =
style=3D'font-size:
11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'> =
<o:p></o:p></span></p>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p>&nbsp;</o:p></span></p>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>All the raw data is collected using kstats. Smbstat =
massages the
data to produce the output. <o:p></o:p></span></p>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p>&nbsp;</o:p></span></p>

<p class=3DMsoNormal>=C2=A0Should that be covered under an ARC case as =
well (perhaps
this one)?<o:p></o:p></p>

<p class=3DMsoNormal><span =
style=3D'font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p>&nbsp;</o:p></span></p>

<p class=3DMsoNormal style=3D'margin-bottom:12.0pt'><span =
style=3D'color:#1F497D'>I honestly
don't know how to answer this question.<o:p></o:p></span></p>

<p class=3DMsoNormal style=3D'margin-bottom:12.0pt'>Jose is really the =
one to
answer that, but as I'm here at the moment and he's presumably not, I'll =
take a
stab at that:&nbsp; the mechanism by which the statistics are collected =
is, I
assume, project private.<o:p></o:p></p>

</div>

</div>

</body>

</html>

--Boundary_(ID_cvrk3hL+JypTIGaVLeW4eg)--

From garrett.damore@oracle.com Thu Apr  8 06:08:03 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38D83VQ026926
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 06:08:03 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38D836s029944
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 06:08:03 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K0000H75FMZ00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 06:08:03 -0700 (PDT)
Received: from sca-ea-mail-1.sun.com ([192.18.43.24])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00MR375EGA10@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 06:08:02 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o38D81Ii013018	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 13:08:02 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38D4VKG009922	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 13:08:00 +0000 (GMT)
Received: from abhmt007.oracle.com by acsmt353.oracle.com	with ESMTP id
 145979551270732076; Thu, 08 Apr 2010 06:07:56 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 06:07:55 -0700
Date: Thu, 08 Apr 2010 06:07:53 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
To: Jose Borrego <jose.borrego@oracle.com>
Cc: "'Jordan Brown'" <Jordan.Brown@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBDD529.9070002@oracle.com>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_rEKzh60fsEWIYLDpzqGHGw)"
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090202.4BBDD531.00B8:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 6276

This is a multi-part message in MIME format.

--Boundary_(ID_rEKzh60fsEWIYLDpzqGHGw)
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT

On 04/ 8/10 12:07 AM, Jose Borrego wrote:
>
> *From:* Jordan Brown [mailto:Jordan.Brown@oracle.com]
> *Sent:* Thursday, April 08, 2010 12:24 AM
> *To:* Garrett D'Amore
> *Cc:* PSARC-ext@sun.com; smb-eng_ww@oracle.com
> *Subject:* Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 
> 04/14/2010]
>
> Garrett D'Amore wrote:
>
> You haven't mentioned anything about underlying kstats.  Is this how 
> these stats are implemented?
>
> All the raw data is collected using kstats. Smbstat massages the data 
> to produce the output.
>
>  Should that be covered under an ARC case as well (perhaps this one)?
>
> I honestly don't know how to answer this question.
>
> Jose is really the one to answer that, but as I'm here at the moment 
> and he's presumably not, I'll take a stab at that:  the mechanism by 
> which the statistics are collected is, I assume, project private.
>

It would be a good idea to list out the kstats in this case, and perhaps 
declare them Project Private if you don't want to commit to supporting 
them for 3rd party apps.

     - Garrett


--Boundary_(ID_rEKzh60fsEWIYLDpzqGHGw)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: 8BIT

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#ffffff">
On 04/ 8/10 12:07 AM, Jose Borrego wrote:
<blockquote
 cite="mid:000f01cad6ea$3883e620$a98bb260$@borrego@oracle.com"
 type="cite">
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <meta name="Generator" content="Microsoft Word 12 (filtered medium)">
  <style>
<!--
 /* Font Definitions */
 @font-face
	{font-family:"Cambria Math";
	panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
	{font-family:Calibri;
	panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
	{font-family:Tahoma;
	panose-1:2 11 6 4 3 5 4 4 2 4;}
 /* Style Definitions */
 p.MsoNormal, li.MsoNormal, div.MsoNormal
	{margin:0in;
	margin-bottom:.0001pt;
	font-size:12.0pt;
	font-family:"Times New Roman","serif";
	color:black;}
a:link, span.MsoHyperlink
	{mso-style-priority:99;
	color:blue;
	text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
	{mso-style-priority:99;
	color:purple;
	text-decoration:underline;}
span.EmailStyle17
	{mso-style-type:personal-reply;
	font-family:"Calibri","sans-serif";
	color:#1F497D;}
.MsoChpDefault
	{mso-style-type:export-only;
	font-size:10.0pt;}
@page Section1
	{size:8.5in 11.0in;
	margin:1.0in 1.0in 1.0in 1.0in;}
div.Section1
	{page:Section1;}
-->
  </style>
<!--[if gte mso 9]><xml>
 <o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
 <o:shapelayout v:ext="edit">
  <o:idmap v:ext="edit" data="1" />
 </o:shapelayout></xml><![endif]-->
  <div class="Section1">
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);"><o:p> </o:p></span></p>
  <div
 style="border-style: none none none solid; border-color: -moz-use-text-color -moz-use-text-color -moz-use-text-color blue; border-width: medium medium medium 1.5pt; padding: 0in 0in 0in 4pt;">
  <div>
  <div
 style="border-style: solid none none; border-color: rgb(181, 196, 223) -moz-use-text-color -moz-use-text-color; border-width: 1pt medium medium; padding: 3pt 0in 0in;">
  <p class="MsoNormal"><b><span
 style="font-size: 10pt; font-family: &quot;Tahoma&quot;,&quot;sans-serif&quot;; color: windowtext;">From:</span></b><span
 style="font-size: 10pt; font-family: &quot;Tahoma&quot;,&quot;sans-serif&quot;; color: windowtext;">
Jordan Brown
[<a class="moz-txt-link-freetext" href="mailto:Jordan.Brown@oracle.com">mailto:Jordan.Brown@oracle.com</a>] <br>
  <b>Sent:</b> Thursday, April 08, 2010 12:24 AM<br>
  <b>To:</b> Garrett D'Amore<br>
  <b>Cc:</b> <a class="moz-txt-link-abbreviated" href="mailto:PSARC-ext@sun.com">PSARC-ext@sun.com</a>; <a class="moz-txt-link-abbreviated" href="mailto:smb-eng_ww@oracle.com">smb-eng_ww@oracle.com</a><br>
  <b>Subject:</b> Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack
timeout
04/14/2010]<o:p></o:p></span></p>
  </div>
  </div>
  <p class="MsoNormal"><o:p> </o:p></p>
  <p class="MsoNormal">Garrett D'Amore wrote: <o:p></o:p></p>
  <p class="MsoNormal">You haven't mentioned anything about underlying
kstats.  Is this how these stats are implemented?<span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);">
  <o:p></o:p></span></p>
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);"><o:p> </o:p></span></p>
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);">All
the raw data is collected using kstats. Smbstat massages the
data to produce the output. <o:p></o:p></span></p>
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);"><o:p> </o:p></span></p>
  <p class="MsoNormal"> Should that be covered under an ARC case as
well (perhaps
this one)?<o:p></o:p></p>
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);"><o:p> </o:p></span></p>
  <p class="MsoNormal" style="margin-bottom: 12pt;"><span
 style="color: rgb(31, 73, 125);">I honestly
don't know how to answer this question.<o:p></o:p></span></p>
  <p class="MsoNormal" style="margin-bottom: 12pt;">Jose is really the
one to
answer that, but as I'm here at the moment and he's presumably not,
I'll take a
stab at that:  the mechanism by which the statistics are collected is,
I
assume, project private.<o:p></o:p></p>
  </div>
  </div>
</blockquote>
<br>
It would be a good idea to list out the kstats in this case, and
perhaps declare them Project Private if you don't want to commit to
supporting them for 3rd party apps.<br>
<br>
    - Garrett<br>
<br>
</body>
</html>

--Boundary_(ID_rEKzh60fsEWIYLDpzqGHGw)--

From garrett.damore@oracle.com Thu Apr  8 06:08:05 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38D84ZL026930
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 06:08:04 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o38D82bZ029790
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 07:08:04 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00C1175FKK00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 06:08:03 -0700 (PDT)
Received: from sca-ea-mail-1.sun.com ([192.18.43.24])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00MLL75EOA50@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 06:08:02 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o38D82mm013021	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 13:08:02 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38D4VKI009922	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 13:08:01 +0000 (GMT)
Received: from abhmt007.oracle.com by acsmt353.oracle.com	with ESMTP id
 145979551270732076; Thu, 08 Apr 2010 06:07:56 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 06:07:55 -0700
Date: Thu, 08 Apr 2010 06:07:53 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
To: Jose Borrego <jose.borrego@oracle.com>
Cc: "'Jordan Brown'" <Jordan.Brown@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBDD529.9070002@oracle.com>
MIME-version: 1.0
Content-type: multipart/alternative;
 boundary="Boundary_(ID_ThEwy2LUb+gfwUJrTIsJMw)"
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090204.4BBDD532.0052:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 6276

This is a multi-part message in MIME format.

--Boundary_(ID_ThEwy2LUb+gfwUJrTIsJMw)
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT

On 04/ 8/10 12:07 AM, Jose Borrego wrote:
>
> *From:* Jordan Brown [mailto:Jordan.Brown@oracle.com]
> *Sent:* Thursday, April 08, 2010 12:24 AM
> *To:* Garrett D'Amore
> *Cc:* PSARC-ext@sun.com; smb-eng_ww@oracle.com
> *Subject:* Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 
> 04/14/2010]
>
> Garrett D'Amore wrote:
>
> You haven't mentioned anything about underlying kstats.  Is this how 
> these stats are implemented?
>
> All the raw data is collected using kstats. Smbstat massages the data 
> to produce the output.
>
>  Should that be covered under an ARC case as well (perhaps this one)?
>
> I honestly don't know how to answer this question.
>
> Jose is really the one to answer that, but as I'm here at the moment 
> and he's presumably not, I'll take a stab at that:  the mechanism by 
> which the statistics are collected is, I assume, project private.
>

It would be a good idea to list out the kstats in this case, and perhaps 
declare them Project Private if you don't want to commit to supporting 
them for 3rd party apps.

     - Garrett


--Boundary_(ID_ThEwy2LUb+gfwUJrTIsJMw)
Content-type: text/html; charset=UTF-8
Content-transfer-encoding: 8BIT

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body text="#000000" bgcolor="#ffffff">
On 04/ 8/10 12:07 AM, Jose Borrego wrote:
<blockquote
 cite="mid:000f01cad6ea$3883e620$a98bb260$@borrego@oracle.com"
 type="cite">
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <meta name="Generator" content="Microsoft Word 12 (filtered medium)">
  <style>
<!--
 /* Font Definitions */
 @font-face
	{font-family:"Cambria Math";
	panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
	{font-family:Calibri;
	panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
	{font-family:Tahoma;
	panose-1:2 11 6 4 3 5 4 4 2 4;}
 /* Style Definitions */
 p.MsoNormal, li.MsoNormal, div.MsoNormal
	{margin:0in;
	margin-bottom:.0001pt;
	font-size:12.0pt;
	font-family:"Times New Roman","serif";
	color:black;}
a:link, span.MsoHyperlink
	{mso-style-priority:99;
	color:blue;
	text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
	{mso-style-priority:99;
	color:purple;
	text-decoration:underline;}
span.EmailStyle17
	{mso-style-type:personal-reply;
	font-family:"Calibri","sans-serif";
	color:#1F497D;}
.MsoChpDefault
	{mso-style-type:export-only;
	font-size:10.0pt;}
@page Section1
	{size:8.5in 11.0in;
	margin:1.0in 1.0in 1.0in 1.0in;}
div.Section1
	{page:Section1;}
-->
  </style>
<!--[if gte mso 9]><xml>
 <o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
 <o:shapelayout v:ext="edit">
  <o:idmap v:ext="edit" data="1" />
 </o:shapelayout></xml><![endif]-->
  <div class="Section1">
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);"><o:p> </o:p></span></p>
  <div
 style="border-style: none none none solid; border-color: -moz-use-text-color -moz-use-text-color -moz-use-text-color blue; border-width: medium medium medium 1.5pt; padding: 0in 0in 0in 4pt;">
  <div>
  <div
 style="border-style: solid none none; border-color: rgb(181, 196, 223) -moz-use-text-color -moz-use-text-color; border-width: 1pt medium medium; padding: 3pt 0in 0in;">
  <p class="MsoNormal"><b><span
 style="font-size: 10pt; font-family: &quot;Tahoma&quot;,&quot;sans-serif&quot;; color: windowtext;">From:</span></b><span
 style="font-size: 10pt; font-family: &quot;Tahoma&quot;,&quot;sans-serif&quot;; color: windowtext;">
Jordan Brown
[<a class="moz-txt-link-freetext" href="mailto:Jordan.Brown@oracle.com">mailto:Jordan.Brown@oracle.com</a>] <br>
  <b>Sent:</b> Thursday, April 08, 2010 12:24 AM<br>
  <b>To:</b> Garrett D'Amore<br>
  <b>Cc:</b> <a class="moz-txt-link-abbreviated" href="mailto:PSARC-ext@sun.com">PSARC-ext@sun.com</a>; <a class="moz-txt-link-abbreviated" href="mailto:smb-eng_ww@oracle.com">smb-eng_ww@oracle.com</a><br>
  <b>Subject:</b> Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack
timeout
04/14/2010]<o:p></o:p></span></p>
  </div>
  </div>
  <p class="MsoNormal"><o:p> </o:p></p>
  <p class="MsoNormal">Garrett D'Amore wrote: <o:p></o:p></p>
  <p class="MsoNormal">You haven't mentioned anything about underlying
kstats.  Is this how these stats are implemented?<span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);">
  <o:p></o:p></span></p>
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);"><o:p> </o:p></span></p>
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);">All
the raw data is collected using kstats. Smbstat massages the
data to produce the output. <o:p></o:p></span></p>
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);"><o:p> </o:p></span></p>
  <p class="MsoNormal"> Should that be covered under an ARC case as
well (perhaps
this one)?<o:p></o:p></p>
  <p class="MsoNormal"><span
 style="font-size: 11pt; font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; color: rgb(31, 73, 125);"><o:p> </o:p></span></p>
  <p class="MsoNormal" style="margin-bottom: 12pt;"><span
 style="color: rgb(31, 73, 125);">I honestly
don't know how to answer this question.<o:p></o:p></span></p>
  <p class="MsoNormal" style="margin-bottom: 12pt;">Jose is really the
one to
answer that, but as I'm here at the moment and he's presumably not,
I'll take a
stab at that:  the mechanism by which the statistics are collected is,
I
assume, project private.<o:p></o:p></p>
  </div>
  </div>
</blockquote>
<br>
It would be a good idea to list out the kstats in this case, and
perhaps declare them Project Private if you don't want to commit to
supporting them for 3rd party apps.<br>
<br>
    - Garrett<br>
<br>
</body>
</html>

--Boundary_(ID_ThEwy2LUb+gfwUJrTIsJMw)--

From Nicolas.Williams@sun.com Thu Apr  8 08:50:56 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38Fotot028751
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 08:50:55 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38ForGp005903
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 10:50:55 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K0053JEOUJ700@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 08:50:54 -0700 (PDT)
Received: from sca-ea-mail-3.sun.com ([192.18.43.21])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K008PYEOTWXC0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 08:50:53 -0700 (PDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by sca-ea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38Forqc009854	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 15:50:53 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38FJtSH013250	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 15:50:52 +0000 (GMT)
Received: from abhmt009.oracle.com by acsmt353.oracle.com	with ESMTP id
 158233971270741842; Thu, 08 Apr 2010 08:50:42 -0700
Received: from Sun.COM (/129.153.128.104)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 08:50:41 -0700
Date: Thu, 08 Apr 2010 10:50:36 -0500
From: Nicolas Williams <Nicolas.Williams@sun.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBDD529.9070002@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: Jose Borrego <jose.borrego@oracle.com>,
        "'Jordan Brown'" <Jordan.Brown@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <20100408155035.GG4225@Sun.COM>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-disposition: inline
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090203.4BBDFB5D.0034,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com>
User-Agent: Mutt/1.5.20 (2010-03-02)
Status: RO
Content-Length: 558

On Thu, Apr 08, 2010 at 06:07:53AM -0700, Garrett D'Amore wrote:
> It would be a good idea to list out the kstats in this case, and
> perhaps declare them Project Private if you don't want to commit to
> supporting them for 3rd party apps.

kstats are scriptable (you can get at them from C, Perl5, Python, and
shell scripts), so they are more convenient, but then, the actual kstats
are typically either not documented or at best Uncommitted.  Listing the
CIFS kstats as Volatile and documenting their meaning would be useful,
if you can help it.

Nico
-- 

From Nicolas.Williams@sun.com Thu Apr  8 08:50:56 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38FoufM028755
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 08:50:56 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38FosCm004533
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 08:50:56 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00415EOVHB00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 09:50:55 -0600 (MDT)
Received: from sca-ea-mail-2.sun.com ([192.18.43.25])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00NVWEOU2130@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 09:50:54 -0600 (MDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by sca-ea-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o38Fos5b001271	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 15:50:54 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38FJtSJ013250	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 15:50:53 +0000 (GMT)
Received: from abhmt009.oracle.com by acsmt353.oracle.com	with ESMTP id
 158233971270741842; Thu, 08 Apr 2010 08:50:42 -0700
Received: from Sun.COM (/129.153.128.104)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 08:50:41 -0700
Date: Thu, 08 Apr 2010 10:50:36 -0500
From: Nicolas Williams <Nicolas.Williams@sun.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBDD529.9070002@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: Jose Borrego <jose.borrego@oracle.com>,
        "'Jordan Brown'" <Jordan.Brown@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <20100408155035.GG4225@Sun.COM>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-disposition: inline
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090203.4BBDFB5D.0135,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com>
User-Agent: Mutt/1.5.20 (2010-03-02)
Status: RO
Content-Length: 558

On Thu, Apr 08, 2010 at 06:07:53AM -0700, Garrett D'Amore wrote:
> It would be a good idea to list out the kstats in this case, and
> perhaps declare them Project Private if you don't want to commit to
> supporting them for 3rd party apps.

kstats are scriptable (you can get at them from C, Perl5, Python, and
shell scripts), so they are more convenient, but then, the actual kstats
are typically either not documented or at best Uncommitted.  Listing the
CIFS kstats as Volatile and documenting their meaning would be useful,
if you can help it.

Nico
-- 

From john.plocher@gmail.com Thu Apr  8 10:36:46 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38HakcQ000577
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 10:36:46 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38HajJ2002596
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 10:36:46 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00E07JLAWP00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 11:36:46 -0600 (MDT)
Received: from sca-ea-mail-2.sun.com ([192.18.43.25])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00N4NJL924F0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 11:36:45 -0600 (MDT)
Received: from relay41i.sun.com ([192.5.209.70])
	by sca-ea-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o38HU1wx014194	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 17:36:45 +0000 (GMT)
Received: from mms49es.mms.us.syntegra.com ([160.41.221.232] [160.41.221.232])
 by relay41i.sun.com with ESMTP id BT-MMP-3911842 for PSARC-ext@sun.com; Thu,
 08 Apr 2010 17:36:44 +0000 (Z)
Received: from relay45i.sun.com (relay45i.sun.com [192.5.209.94])
 by mms49es.mms.us.syntegra.com with ESMTP id BT-MMP-78286392 for
 PSARC-ext@sun.com; Thu, 08 Apr 2010 17:36:44 +0000 (Z)
Received: from mail-qy0-f189.google.com ([209.85.221.189] [209.85.221.189])
 by relay4i.sun.com with ESMTP id BT-MMP-32601413 for PSARC-ext@sun.com; Thu,
 08 Apr 2010 17:36:44 +0000 (Z)
Received: by qyk27 with SMTP id 27so3240398qyk.23 for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 10:36:15 -0700 (PDT)
Received: by 10.229.102.15 with HTTP; Thu, 08 Apr 2010 10:36:15 -0700 (PDT)
Received: by 10.229.222.82 with SMTP id if18mr648819qcb.65.1270748175453; Thu,
 08 Apr 2010 10:36:15 -0700 (PDT)
Date: Thu, 08 Apr 2010 10:36:15 -0700
From: John Plocher <john.plocher@gmail.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
To: Jordan Brown <jb25718@sac.sfbay.sun.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <p2macff61d31004081036h8ee70508m717fdb07f4400b97@mail.gmail.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;        d=gmail.com;
 s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references
 :date:received:message-id:subject:from:to:cc:content-type;
 bh=vT7HJDYnwXeEcLqVYLIgwzCA6pD/7BtyEVIeO3dYvz4=;
 b=A2EVL6aB3sOA7ox+4wn+35tctjbrUzi8TLig8V2uhehFtJrKB6z223BuKOfVIc6Q98
 lew1eoBKEGaKQStrA8YUR/2oGx9WwCidyfvMM/UIwBubFXNTOtQZwyTEE9h+HAmoFnSq
 +ySxwlc4zHpCPKPzqkeF8I9GL9LhEWRZIYw0I=
DomainKey-Signature: a=rsa-sha1; c=nofws;        d=gmail.com; s=gamma;
 h=mime-version:in-reply-to:references:date:message-id:subject:from:to
 :cc:content-type;
 b=oiXZPoqEhNdgRBjbFinkKmEoaECjKiqhYK8ylhwKN0Nvgc+CzGntU8R3OQ1HSKHPIF
 TbJk+R4qWgpG0fj/itfvqntQcTgf3OY4vaU6FdOe2ftHz5zsWIiNXkgDSJMqFIMY1phf
 yoYdaZ9U+ykMFSNvZvb2Svlk9015PjnSzVyxI=
X-PMX-Version: 5.4.1.325704
X-Brightmail-Tracker: AAAAAA==
X-Antispam: No, score=-0.7/5.0, scanned in 0.055sec at (localhost [127.0.0.1])
	by smf-spamd v1.3.1 - http://smfs.sf.net/
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
Status: RO
Content-Length: 967

On Wed, Apr 7, 2010 at 5:51 PM, Jordan Brown <jb25718@sac.sfbay.sun.com> wrote:
> long list of stats...

I'm running OpenSolaris.recent on my server @home with CIFS, Mac's and
PC's.  File write access from the clients is slow; it appears that
something is timing out (not responding) for every initial save-file
request - which then retries and succeeds.

Not to debug my problem here (E_WRONG_FORUM), but I'm stuck with the
general issue of not seeing the forest because of all that d@mn
vegetation in this case.

I presume it is a good thing to have so many stats, and to be able to
inundate the admin with tons of info, but what is missing for me is
the conceptual structure to interpret and utilize all this info and to
actually debug problems.  In ARC-speak, what (where?) is the
user/usage model that pulls all these stats together into a coherent
whole?  Or, do I need to be an expert CIFS protocol/implementation
expert to make sense of any of this?

  -John

From Nicolas.Williams@sun.com Thu Apr  8 10:53:52 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38Hrp2X000848
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 10:53:51 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38Hrp7A012147
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 10:53:51 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00G05KDREW00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 10:53:51 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00ECUKDRKW20@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 10:53:51 -0700 (PDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38Hro0m020604	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 17:53:50 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38HrnnW008427	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 17:53:50 +0000 (GMT)
Received: from abhmt008.oracle.com by acsmt355.oracle.com	with ESMTP id
 146828241270749212; Thu, 08 Apr 2010 10:53:32 -0700
Received: from Sun.COM (/129.153.128.104)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 10:53:32 -0700
Date: Thu, 08 Apr 2010 12:53:26 -0500
From: Nicolas Williams <Nicolas.Williams@sun.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <p2macff61d31004081036h8ee70508m717fdb07f4400b97@mail.gmail.com>
To: John Plocher <john.plocher@gmail.com>
Cc: Jordan Brown <jb25718@sac.sfbay.sun.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <20100408175326.GK4225@Sun.COM>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-disposition: inline
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090203.4BBE182E.0134,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <p2macff61d31004081036h8ee70508m717fdb07f4400b97@mail.gmail.com>
User-Agent: Mutt/1.5.20 (2010-03-02)
Status: RO
Content-Length: 1014

On Thu, Apr 08, 2010 at 10:36:15AM -0700, John Plocher wrote:
> I presume it is a good thing to have so many stats, and to be able to
> inundate the admin with tons of info, but what is missing for me is
> the conceptual structure to interpret and utilize all this info and to
> actually debug problems.  In ARC-speak, what (where?) is the
> user/usage model that pulls all these stats together into a coherent
> whole?  Or, do I need to be an expert CIFS protocol/implementation
> expert to make sense of any of this?

You might need to write DTrace scripts to debug performance problems on
your own.  And if you're using unstable probes then you must have
knowledge of the relevant implementation and/or protocol details.

IMO the stats themselves, both kstats and kernel symbols/variables
that'd be meaningful to refer to from DTrace scripts should be listed as
Volatile, as that will allow for programmatic access with the necessary
"could break between releases" caveat.  But that could come later.

Nico
-- 

From Nicolas.Williams@sun.com Thu Apr  8 10:53:53 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38Hrqsp000852
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 10:53:53 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o38Hrqjp008126
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 11:53:52 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00D03KDS4K00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 10:53:52 -0700 (PDT)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00AYQKDQKA70@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 10:53:51 -0700 (PDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38Hroqc009702	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 17:53:50 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38HrnnU008427	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 17:53:49 +0000 (GMT)
Received: from abhmt008.oracle.com by acsmt355.oracle.com	with ESMTP id
 146828241270749212; Thu, 08 Apr 2010 10:53:32 -0700
Received: from Sun.COM (/129.153.128.104)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 10:53:32 -0700
Date: Thu, 08 Apr 2010 12:53:26 -0500
From: Nicolas Williams <Nicolas.Williams@sun.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <p2macff61d31004081036h8ee70508m717fdb07f4400b97@mail.gmail.com>
To: John Plocher <john.plocher@gmail.com>
Cc: Jordan Brown <jb25718@sac.sfbay.sun.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <20100408175326.GK4225@Sun.COM>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-disposition: inline
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090201.4BBE182E.0014,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <p2macff61d31004081036h8ee70508m717fdb07f4400b97@mail.gmail.com>
User-Agent: Mutt/1.5.20 (2010-03-02)
Status: RO
Content-Length: 1014

On Thu, Apr 08, 2010 at 10:36:15AM -0700, John Plocher wrote:
> I presume it is a good thing to have so many stats, and to be able to
> inundate the admin with tons of info, but what is missing for me is
> the conceptual structure to interpret and utilize all this info and to
> actually debug problems.  In ARC-speak, what (where?) is the
> user/usage model that pulls all these stats together into a coherent
> whole?  Or, do I need to be an expert CIFS protocol/implementation
> expert to make sense of any of this?

You might need to write DTrace scripts to debug performance problems on
your own.  And if you're using unstable probes then you must have
knowledge of the relevant implementation and/or protocol details.

IMO the stats themselves, both kstats and kernel symbols/variables
that'd be meaningful to refer to from DTrace scripts should be listed as
Volatile, as that will allow for programmatic access with the necessary
"could break between releases" caveat.  But that could come later.

Nico
-- 

From alan.wright@oracle.com Thu Apr  8 11:38:35 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38IcZ1m001672
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 11:38:35 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o38IcYau044931
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 12:38:34 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00I07MGAWO00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 11:38:34 -0700 (PDT)
Received: from sca-ea-mail-4.sun.com ([192.18.43.22])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00EE9MG9KX40@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 11:38:33 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38IcX9f015853	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 18:38:33 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38IcUV9021426	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 18:38:30 +0000 (GMT)
Received: from abhmt014.oracle.com by acsmt354.oracle.com	with ESMTP id
 146936711270751909; Thu, 08 Apr 2010 11:38:29 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 11:38:29 -0700
Date: Thu, 08 Apr 2010 11:37:58 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBDD529.9070002@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBE2286.7010207@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090202.4BBE22A6.0119:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 12479

On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
 > On 04/ 7/10 10:47 PM, Jordan Brown wrote:
 >> Garrett D'Amore wrote:
 >>>
 >>> What's missing is an interface table. I think though that based on
 >>> the statement that its not to be parsed ("for humans only"), the
 >>> output is not-an-interface.
 >>
 >> Yes. The stability is the same as the existing command:
 >>
 >> |_____________________________|_____________________________|
 >> | Interface Stability | Uncommitted |
 >> |_____________________________|_____________________________|
 >> | Utility Output Format | Not-an-Interface |
 >> |_____________________________|_____________________________|
 >>
 >
 > You haven't mentioned anything about underlying kstats. Is this how
 > these stats are implemented? Should that be covered under an ARC case as
 > well (perhaps this one)?

smbstat has always created its output from undocumented kstats and,
as with the interface stability, changing that wasn't part of this
project.  The purpose here is solely to expand and improve on the
command output.  The underlying kstats have not been considered for
anything other than internal smbstat consumption.  Publishing them,
particularly if they may be used in scripts, without taking the
change of scope into consideration and reviewing the design from
that perspective is not a good idea.

I'd prefer to take this as an RFE rather than delay/withdraw this
case while we go back and review the project with a different scope.

Alan
--

 >>> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
 >>>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
 >>>> This information is Copyright (c) 2010, Oracle and/or its
 >>>> affiliates. All rights reserved.
 >>>> 1. Introduction
 >>>> 1.1. Project/Component Working Name:
 >>>> SMB/CIFS Statistics
 >>>> 1.2. Name of Document Author/Supplier:
 >>>> Author: Jose Borrego
 >>>> 1.3 Date of This Document:
 >>>> 07 April, 2010
 >>>>
 >>>> 1.4. Name of Major Document Customer(s)/Consumer(s):
 >>>> PSARC
 >>>> CIFS team
 >>>>
 >>>> 1.5. Email Aliases:
 >>>> 1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
 >>>> 1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
 >>>> 1.5.3. Marketing Manager:
 >>>> 1.5.4. Interest List: cifs-team@sun.com
 >>>>
 >>>> 4. Technical Description:
 >>>>
 >>>> Executive Summary:
 >>>>
 >>>> This case improves the statistics the SMB/CIFS server maintains as
 >>>> well as
 >>>> the output of smbstat.
 >>>>
 >>>> Problem:
 >>>>
 >>>> Currently the only statistics the SMB/CIFS server maintains are
 >>>> counters
 >>>> keeping track of how many requests of each type were received, the
 >>>> number
 >>>> of open files, the number of sessions (users logged in) and the
 >>>> number of
 >>>> connections (trees connected). Those statistics are not enough to
 >>>> describe
 >>>> the load being applied as well as how the server is responding to it.
 >>>>
 >>>> Solution:
 >>>>
 >>>> In order to get a better picture of the state of the SMB/CIFS server
 >>>> the
 >>>> following information can be maintained and provided through smbstat:
 >>>>
 >>>> - Counters:
 >>>> * nbt:
 >>>> Number of SMB NetBIOS-over-TCP (NBT) sessions.
 >>>>
 >>>> * tcp:
 >>>> Number of SMB TCP sessions.
 >>>>
 >>>> * users:
 >>>> Number of users logged in.
 >>>>
 >>>> * trees:
 >>>> Number of trees connected.
 >>>>
 >>>> * files:
 >>>> Number of open files.
 >>>>
 >>>> * pipes:
 >>>> Number of open pipes.
 >>>>
 >>>> - Throughput:
 >>>> * rbytes/s:
 >>>> Number of bytes received per second.
 >>>>
 >>>> * tbytes/s:
 >>>> Number of bytes transmitted per second.
 >>>>
 >>>> * reqs/s:
 >>>> Number of requests handled per second.
 >>>>
 >>>> * reads/s:
 >>>> Number of read requests per second. This would be an aggregation of
 >>>> the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
 >>>> SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
 >>>>
 >>>> * writes/s:
 >>>> Number of write requests per second. This would ba an aggregation of
 >>>> the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
 >>>> SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
 >>>>
 >>>> - Utilization:
 >>>> * wcnt:
 >>>> Average number of requests received but waiting for an SMB worker
 >>>> thread to execute them.
 >>>>
 >>>> * rcnt:
 >>>> Average number of requests being simultaneously executed by an SMB
 >>>> worker thread.
 >>>>
 >>>> * wtime:
 >>>> Average time a request waits before an SMB worker thread starts
 >>>> executing it.
 >>>>
 >>>> * rtime:
 >>>> Average execution time of a request.
 >>>>
 >>>> * w%:
 >>>> Percentage of the time during which at least one request was
 >>>> waiting.
 >>>>
 >>>> * r%:
 >>>> Percentage of the time during which at least one request was being
 >>>> executed.
 >>>>
 >>>> * u%:
 >>>> Percentage of utilization of the SMB/CIFS server. This number is
 >>>> defined as: rcnt / (Max Worker Threads).
 >>>>
 >>>> * sat:
 >>>> Flag indicating if the server saturated in the past. Saturation is
 >>>> defined as: u% == 100%.
 >>>>
 >>>> * usr%:
 >>>> Percentage of the time the processor(s) spent in user space.
 >>>>
 >>>> * sys%:
 >>>> Percentage of the time the processor(s) spent in kernel space.
 >>>>
 >>>> * idle%:
 >>>> Percentage of the time the processor(s) was(were) idle.
 >>>>
 >>>> - Requests:
 >>>> For each type of request:
 >>>> * %:
 >>>> Percentage of that type of request.
 >>>>
 >>>> * rbytes/s:
 >>>> Number of bytes received per second.
 >>>>
 >>>> * tbytes/s:
 >>>> Number of bytes received per second.
 >>>>
 >>>> * req/s:
 >>>> Number of requests handled per second.
 >>>>
 >>>> * rt-mean:
 >>>> Average response time in seconds.
 >>>>
 >>>> * rt-stddev:
 >>>> Standard deviation of the response time.
 >>>>
 >>>> To access this information the CLI smbstat must be modified and
 >>>> allow the
 >>>> following options:
 >>>>
 >>>> -r Display the statistics of the requests.
 >>>>
 >>>> -a Display the statistics of all the types of request (the 256 of
 >>>> them) whether they are valid or not.
 >>>>
 >>>> -n Display in alphabetic order.
 >>>>
 >>>> -z Display the statistics of the requests actually received.
 >>>>
 >>>> -t Display the throughput of the SMB/CIFS server.
 >>>>
 >>>> -u Display the utilization of the SMB/CIFS server.
 >>>>
 >>>> -c Display the counters.
 >>>>
 >>>> A number can also be provided indicating the interval of time between
 >>>> refreshes. The first statistics displayed cover the time between when
 >>>> the server was started and the moment the statistics were requested.
 >>>> Subsequent refreshes cover the last time interval only.
 >>>>
 >>>> It should be noted that the output is all new replacing the old one and
 >>>> is for humans only.
 >>>>
 >>>> Examples of smbstat output:
 >>>>
 >>>> '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
 >>>>
 >>>> 'smbstat -r'
 >>>>
 >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
 >>>> SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
 >>>> SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
 >>>> SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-07
 >>>> SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00 0.000e+00
 >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04 8.612e-06
 >>>> SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00 0.000e+00
 >>>> SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05 0.000e+00
 >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01 0.000e+00
 >>>> SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04 2.436e-05
 >>>> SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-03
 >>>> SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>>
 >>>> 'smbstat -rz'
 >>>>
 >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
 >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
 >>>> SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
 >>>> SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
 >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04 8.612e-06
 >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05 0.000e+00
 >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01 0.000e+00
 >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04 2.436e-05
 >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-03
 >>>>
 >>>> 6. Resources and Schedule
 >>>> 6.4. Steering Committee requested information
 >>>> 6.4.1. Consolidation C-team Name:
 >>>> ON
 >>>> 6.5. ARC review type: FastTrack
 >>>> 6.6. ARC Exposure: open


From alan.wright@oracle.com Thu Apr  8 11:38:36 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38Icacl001676
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 11:38:36 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38IcaFc021715
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 11:38:36 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00L05MGC2G00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 12:38:36 -0600 (MDT)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00HZ7MGBPR20@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 12:38:35 -0600 (MDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38IcYps008433	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 18:38:34 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38IcUVB021426	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 18:38:33 +0000 (GMT)
Received: from abhmt014.oracle.com by acsmt354.oracle.com	with ESMTP id
 146936711270751909; Thu, 08 Apr 2010 11:38:29 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 11:38:29 -0700
Date: Thu, 08 Apr 2010 11:37:58 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBDD529.9070002@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBE2286.7010207@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090207.4BBE22A9.00D0:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 12479

On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
 > On 04/ 7/10 10:47 PM, Jordan Brown wrote:
 >> Garrett D'Amore wrote:
 >>>
 >>> What's missing is an interface table. I think though that based on
 >>> the statement that its not to be parsed ("for humans only"), the
 >>> output is not-an-interface.
 >>
 >> Yes. The stability is the same as the existing command:
 >>
 >> |_____________________________|_____________________________|
 >> | Interface Stability | Uncommitted |
 >> |_____________________________|_____________________________|
 >> | Utility Output Format | Not-an-Interface |
 >> |_____________________________|_____________________________|
 >>
 >
 > You haven't mentioned anything about underlying kstats. Is this how
 > these stats are implemented? Should that be covered under an ARC case as
 > well (perhaps this one)?

smbstat has always created its output from undocumented kstats and,
as with the interface stability, changing that wasn't part of this
project.  The purpose here is solely to expand and improve on the
command output.  The underlying kstats have not been considered for
anything other than internal smbstat consumption.  Publishing them,
particularly if they may be used in scripts, without taking the
change of scope into consideration and reviewing the design from
that perspective is not a good idea.

I'd prefer to take this as an RFE rather than delay/withdraw this
case while we go back and review the project with a different scope.

Alan
--

 >>> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
 >>>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
 >>>> This information is Copyright (c) 2010, Oracle and/or its
 >>>> affiliates. All rights reserved.
 >>>> 1. Introduction
 >>>> 1.1. Project/Component Working Name:
 >>>> SMB/CIFS Statistics
 >>>> 1.2. Name of Document Author/Supplier:
 >>>> Author: Jose Borrego
 >>>> 1.3 Date of This Document:
 >>>> 07 April, 2010
 >>>>
 >>>> 1.4. Name of Major Document Customer(s)/Consumer(s):
 >>>> PSARC
 >>>> CIFS team
 >>>>
 >>>> 1.5. Email Aliases:
 >>>> 1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
 >>>> 1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
 >>>> 1.5.3. Marketing Manager:
 >>>> 1.5.4. Interest List: cifs-team@sun.com
 >>>>
 >>>> 4. Technical Description:
 >>>>
 >>>> Executive Summary:
 >>>>
 >>>> This case improves the statistics the SMB/CIFS server maintains as
 >>>> well as
 >>>> the output of smbstat.
 >>>>
 >>>> Problem:
 >>>>
 >>>> Currently the only statistics the SMB/CIFS server maintains are
 >>>> counters
 >>>> keeping track of how many requests of each type were received, the
 >>>> number
 >>>> of open files, the number of sessions (users logged in) and the
 >>>> number of
 >>>> connections (trees connected). Those statistics are not enough to
 >>>> describe
 >>>> the load being applied as well as how the server is responding to it.
 >>>>
 >>>> Solution:
 >>>>
 >>>> In order to get a better picture of the state of the SMB/CIFS server
 >>>> the
 >>>> following information can be maintained and provided through smbstat:
 >>>>
 >>>> - Counters:
 >>>> * nbt:
 >>>> Number of SMB NetBIOS-over-TCP (NBT) sessions.
 >>>>
 >>>> * tcp:
 >>>> Number of SMB TCP sessions.
 >>>>
 >>>> * users:
 >>>> Number of users logged in.
 >>>>
 >>>> * trees:
 >>>> Number of trees connected.
 >>>>
 >>>> * files:
 >>>> Number of open files.
 >>>>
 >>>> * pipes:
 >>>> Number of open pipes.
 >>>>
 >>>> - Throughput:
 >>>> * rbytes/s:
 >>>> Number of bytes received per second.
 >>>>
 >>>> * tbytes/s:
 >>>> Number of bytes transmitted per second.
 >>>>
 >>>> * reqs/s:
 >>>> Number of requests handled per second.
 >>>>
 >>>> * reads/s:
 >>>> Number of read requests per second. This would be an aggregation of
 >>>> the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
 >>>> SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
 >>>>
 >>>> * writes/s:
 >>>> Number of write requests per second. This would ba an aggregation of
 >>>> the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
 >>>> SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
 >>>>
 >>>> - Utilization:
 >>>> * wcnt:
 >>>> Average number of requests received but waiting for an SMB worker
 >>>> thread to execute them.
 >>>>
 >>>> * rcnt:
 >>>> Average number of requests being simultaneously executed by an SMB
 >>>> worker thread.
 >>>>
 >>>> * wtime:
 >>>> Average time a request waits before an SMB worker thread starts
 >>>> executing it.
 >>>>
 >>>> * rtime:
 >>>> Average execution time of a request.
 >>>>
 >>>> * w%:
 >>>> Percentage of the time during which at least one request was
 >>>> waiting.
 >>>>
 >>>> * r%:
 >>>> Percentage of the time during which at least one request was being
 >>>> executed.
 >>>>
 >>>> * u%:
 >>>> Percentage of utilization of the SMB/CIFS server. This number is
 >>>> defined as: rcnt / (Max Worker Threads).
 >>>>
 >>>> * sat:
 >>>> Flag indicating if the server saturated in the past. Saturation is
 >>>> defined as: u% == 100%.
 >>>>
 >>>> * usr%:
 >>>> Percentage of the time the processor(s) spent in user space.
 >>>>
 >>>> * sys%:
 >>>> Percentage of the time the processor(s) spent in kernel space.
 >>>>
 >>>> * idle%:
 >>>> Percentage of the time the processor(s) was(were) idle.
 >>>>
 >>>> - Requests:
 >>>> For each type of request:
 >>>> * %:
 >>>> Percentage of that type of request.
 >>>>
 >>>> * rbytes/s:
 >>>> Number of bytes received per second.
 >>>>
 >>>> * tbytes/s:
 >>>> Number of bytes received per second.
 >>>>
 >>>> * req/s:
 >>>> Number of requests handled per second.
 >>>>
 >>>> * rt-mean:
 >>>> Average response time in seconds.
 >>>>
 >>>> * rt-stddev:
 >>>> Standard deviation of the response time.
 >>>>
 >>>> To access this information the CLI smbstat must be modified and
 >>>> allow the
 >>>> following options:
 >>>>
 >>>> -r Display the statistics of the requests.
 >>>>
 >>>> -a Display the statistics of all the types of request (the 256 of
 >>>> them) whether they are valid or not.
 >>>>
 >>>> -n Display in alphabetic order.
 >>>>
 >>>> -z Display the statistics of the requests actually received.
 >>>>
 >>>> -t Display the throughput of the SMB/CIFS server.
 >>>>
 >>>> -u Display the utilization of the SMB/CIFS server.
 >>>>
 >>>> -c Display the counters.
 >>>>
 >>>> A number can also be provided indicating the interval of time between
 >>>> refreshes. The first statistics displayed cover the time between when
 >>>> the server was started and the moment the statistics were requested.
 >>>> Subsequent refreshes cover the last time interval only.
 >>>>
 >>>> It should be noted that the output is all new replacing the old one and
 >>>> is for humans only.
 >>>>
 >>>> Examples of smbstat output:
 >>>>
 >>>> '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
 >>>>
 >>>> 'smbstat -r'
 >>>>
 >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
 >>>> SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
 >>>> SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
 >>>> SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-07
 >>>> SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00 0.000e+00
 >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04 8.612e-06
 >>>> SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00 0.000e+00
 >>>> SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05 0.000e+00
 >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01 0.000e+00
 >>>> SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04 2.436e-05
 >>>> SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-03
 >>>> SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>> 0.000e+00
 >>>> SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
 >>>>
 >>>> 'smbstat -rz'
 >>>>
 >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
 >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
 >>>> SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
 >>>> SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
 >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04 8.612e-06
 >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05 0.000e+00
 >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01 0.000e+00
 >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04 2.436e-05
 >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-03
 >>>>
 >>>> 6. Resources and Schedule
 >>>> 6.4. Steering Committee requested information
 >>>> 6.4.1. Consolidation C-team Name:
 >>>> ON
 >>>> 6.5. ARC review type: FastTrack
 >>>> 6.6. ARC Exposure: open


From jose.borrego@oracle.com Thu Apr  8 13:27:25 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38KRP2T003266
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 13:27:25 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38KROF9013048
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 15:27:24 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00205RHOB600@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 13:27:24 -0700 (PDT)
Received: from sca-ea-mail-1.sun.com ([192.18.43.24])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00EO9RHOL0E0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 13:27:24 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o38KRN8p014983	for
 <PSARC-ext@Sun.COM>; Thu, 08 Apr 2010 20:27:24 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38JwKaW011979	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 20:27:23 +0000 (GMT)
Received: from abhmt009.oracle.com by acsmt353.oracle.com	with ESMTP id
 158362831270744025; Thu, 08 Apr 2010 09:27:05 -0700
Received: from obelix (/129.150.32.49)	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Thu, 08 Apr 2010 09:27:04 -0700
Date: Thu, 08 Apr 2010 10:27:01 -0600
From: Jose Borrego <jose.borrego@oracle.com>
Subject: RE: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBDD529.9070002@oracle.com>
To: "'Garrett D'Amore'" <garrett.damore@oracle.com>
Cc: "'Jordan Brown'" <Jordan.Brown@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <000001cad738$519944e0$f4cbcea0$%borrego@oracle.com>
Organization: Oracle
MIME-version: 1.0
X-Mailer: Microsoft Office Outlook 12.0
Content-type: text/plain; charset=UTF-8
Content-language: en-us
Content-transfer-encoding: 7BIT
Thread-index: AcrXHIL6iD+hvNvsSZSllxqVDfXrqQAG5KoQ
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090201.4BBE3C2B.0123:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com>
Status: RO
Content-Length: 219

Garrett D'Amore wrote:
> It would be a good idea to list out the kstats in this case, and perhaps declare them Project Private if you don't want to commit to supporting them for 3rd party apps.

I'll add that.

- Jose


From jose.borrego@oracle.com Thu Apr  8 13:27:26 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38KRQkH003270
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 13:27:26 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38KRP39001033
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 13:27:25 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00201RHPBH00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 13:27:25 -0700 (PDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00EWURHPL1D0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 13:27:25 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38KROZW002470	for
 <PSARC-ext@Sun.COM>; Thu, 08 Apr 2010 20:27:24 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38JwKaY011979	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 20:27:24 +0000 (GMT)
Received: from abhmt009.oracle.com by acsmt353.oracle.com	with ESMTP id
 158362831270744025; Thu, 08 Apr 2010 09:27:05 -0700
Received: from obelix (/129.150.32.49)	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Thu, 08 Apr 2010 09:27:04 -0700
Date: Thu, 08 Apr 2010 10:27:01 -0600
From: Jose Borrego <jose.borrego@oracle.com>
Subject: RE: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBDD529.9070002@oracle.com>
To: "'Garrett D'Amore'" <garrett.damore@oracle.com>
Cc: "'Jordan Brown'" <Jordan.Brown@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <000001cad738$519944e0$f4cbcea0$%borrego@oracle.com>
Organization: Oracle
MIME-version: 1.0
X-Mailer: Microsoft Office Outlook 12.0
Content-type: text/plain; charset=UTF-8
Content-language: en-us
Content-transfer-encoding: 7BIT
Thread-index: AcrXHIL6iD+hvNvsSZSllxqVDfXrqQAG5KoQ
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090203.4BBE3C2C.00F1:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com>
Status: RO
Content-Length: 219

Garrett D'Amore wrote:
> It would be a good idea to list out the kstats in this case, and perhaps declare them Project Private if you don't want to commit to supporting them for 3rd party apps.

I'll add that.

- Jose


From jose.borrego@oracle.com Thu Apr  8 14:11:19 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38LBJ5X004498
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 14:11:19 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o38LBI9d025368
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 15:11:19 -0600 (MDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00D09TIUKT00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 15:11:18 -0600 (MDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00CZQTIUAL10@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 15:11:18 -0600 (MDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38LBItk018354	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 21:11:18 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38KrSsN026088	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 21:11:17 +0000 (GMT)
Received: from abhmt012.oracle.com by acsmt354.oracle.com	with ESMTP id
 147272901270761074; Thu, 08 Apr 2010 14:11:14 -0700
Received: from obelix (/129.150.32.49)	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Thu, 08 Apr 2010 14:11:14 -0700
Date: Thu, 08 Apr 2010 15:11:09 -0600
From: Jose Borrego <jose.borrego@oracle.com>
Subject: RE: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBE2286.7010207@oracle.com>
To: "'Alan Wright'" <alan.wright@oracle.com>,
        "'Garrett D'Amore'" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
Organization: Oracle
MIME-version: 1.0
X-Mailer: Microsoft Office Outlook 12.0
Content-type: text/plain; charset=us-ascii
Content-language: en-us
Content-transfer-encoding: 7BIT
Thread-index: AcrXSq6UXc8SgLxsRJK3h5qbOBNWawAFKaYg
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090202.4BBE4676.003B:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
Status: RO
Content-Length: 13564



> -----Original Message-----
> From: Alan Wright [mailto:alan.wright@oracle.com]
> Sent: Thursday, April 08, 2010 12:38 PM
> To: Garrett D'Amore
> Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
> Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout
> 04/14/2010]
> 
> On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
>  > On 04/ 7/10 10:47 PM, Jordan Brown wrote:
>  >> Garrett D'Amore wrote:
>  >>>
>  >>> What's missing is an interface table. I think though that based on
>  >>> the statement that its not to be parsed ("for humans only"), the
>  >>> output is not-an-interface.
>  >>
>  >> Yes. The stability is the same as the existing command:
>  >>
>  >> |_____________________________|_____________________________|
>  >> | Interface Stability | Uncommitted |
>  >> |_____________________________|_____________________________|
>  >> | Utility Output Format | Not-an-Interface |
>  >> |_____________________________|_____________________________|
>  >>
>  >
>  > You haven't mentioned anything about underlying kstats. Is this how
>  > these stats are implemented? Should that be covered under an ARC
> case as
>  > well (perhaps this one)?
> 
> smbstat has always created its output from undocumented kstats and,
> as with the interface stability, changing that wasn't part of this
> project.  The purpose here is solely to expand and improve on the
> command output.  The underlying kstats have not been considered for
> anything other than internal smbstat consumption.  Publishing them,
> particularly if they may be used in scripts, without taking the
> change of scope into consideration and reviewing the design from
> that perspective is not a good idea.
> 
> I'd prefer to take this as an RFE rather than delay/withdraw this
> case while we go back and review the project with a different scope.
> 

This is a good point. Please indicate if everybody is okay with this.

> --
> 
>  >>> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>  >>>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>  >>>> This information is Copyright (c) 2010, Oracle and/or its
>  >>>> affiliates. All rights reserved.
>  >>>> 1. Introduction
>  >>>> 1.1. Project/Component Working Name:
>  >>>> SMB/CIFS Statistics
>  >>>> 1.2. Name of Document Author/Supplier:
>  >>>> Author: Jose Borrego
>  >>>> 1.3 Date of This Document:
>  >>>> 07 April, 2010
>  >>>>
>  >>>> 1.4. Name of Major Document Customer(s)/Consumer(s):
>  >>>> PSARC
>  >>>> CIFS team
>  >>>>
>  >>>> 1.5. Email Aliases:
>  >>>> 1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>  >>>> 1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>  >>>> 1.5.3. Marketing Manager:
>  >>>> 1.5.4. Interest List: cifs-team@sun.com
>  >>>>
>  >>>> 4. Technical Description:
>  >>>>
>  >>>> Executive Summary:
>  >>>>
>  >>>> This case improves the statistics the SMB/CIFS server maintains
> as
>  >>>> well as
>  >>>> the output of smbstat.
>  >>>>
>  >>>> Problem:
>  >>>>
>  >>>> Currently the only statistics the SMB/CIFS server maintains are
>  >>>> counters
>  >>>> keeping track of how many requests of each type were received,
> the
>  >>>> number
>  >>>> of open files, the number of sessions (users logged in) and the
>  >>>> number of
>  >>>> connections (trees connected). Those statistics are not enough to
>  >>>> describe
>  >>>> the load being applied as well as how the server is responding to
> it.
>  >>>>
>  >>>> Solution:
>  >>>>
>  >>>> In order to get a better picture of the state of the SMB/CIFS
> server
>  >>>> the
>  >>>> following information can be maintained and provided through
> smbstat:
>  >>>>
>  >>>> - Counters:
>  >>>> * nbt:
>  >>>> Number of SMB NetBIOS-over-TCP (NBT) sessions.
>  >>>>
>  >>>> * tcp:
>  >>>> Number of SMB TCP sessions.
>  >>>>
>  >>>> * users:
>  >>>> Number of users logged in.
>  >>>>
>  >>>> * trees:
>  >>>> Number of trees connected.
>  >>>>
>  >>>> * files:
>  >>>> Number of open files.
>  >>>>
>  >>>> * pipes:
>  >>>> Number of open pipes.
>  >>>>
>  >>>> - Throughput:
>  >>>> * rbytes/s:
>  >>>> Number of bytes received per second.
>  >>>>
>  >>>> * tbytes/s:
>  >>>> Number of bytes transmitted per second.
>  >>>>
>  >>>> * reqs/s:
>  >>>> Number of requests handled per second.
>  >>>>
>  >>>> * reads/s:
>  >>>> Number of read requests per second. This would be an aggregation
> of
>  >>>> the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>  >>>> SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>  >>>>
>  >>>> * writes/s:
>  >>>> Number of write requests per second. This would ba an aggregation
> of
>  >>>> the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>  >>>> SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>  >>>>
>  >>>> - Utilization:
>  >>>> * wcnt:
>  >>>> Average number of requests received but waiting for an SMB worker
>  >>>> thread to execute them.
>  >>>>
>  >>>> * rcnt:
>  >>>> Average number of requests being simultaneously executed by an
> SMB
>  >>>> worker thread.
>  >>>>
>  >>>> * wtime:
>  >>>> Average time a request waits before an SMB worker thread starts
>  >>>> executing it.
>  >>>>
>  >>>> * rtime:
>  >>>> Average execution time of a request.
>  >>>>
>  >>>> * w%:
>  >>>> Percentage of the time during which at least one request was
>  >>>> waiting.
>  >>>>
>  >>>> * r%:
>  >>>> Percentage of the time during which at least one request was
> being
>  >>>> executed.
>  >>>>
>  >>>> * u%:
>  >>>> Percentage of utilization of the SMB/CIFS server. This number is
>  >>>> defined as: rcnt / (Max Worker Threads).
>  >>>>
>  >>>> * sat:
>  >>>> Flag indicating if the server saturated in the past. Saturation
> is
>  >>>> defined as: u% == 100%.
>  >>>>
>  >>>> * usr%:
>  >>>> Percentage of the time the processor(s) spent in user space.
>  >>>>
>  >>>> * sys%:
>  >>>> Percentage of the time the processor(s) spent in kernel space.
>  >>>>
>  >>>> * idle%:
>  >>>> Percentage of the time the processor(s) was(were) idle.
>  >>>>
>  >>>> - Requests:
>  >>>> For each type of request:
>  >>>> * %:
>  >>>> Percentage of that type of request.
>  >>>>
>  >>>> * rbytes/s:
>  >>>> Number of bytes received per second.
>  >>>>
>  >>>> * tbytes/s:
>  >>>> Number of bytes received per second.
>  >>>>
>  >>>> * req/s:
>  >>>> Number of requests handled per second.
>  >>>>
>  >>>> * rt-mean:
>  >>>> Average response time in seconds.
>  >>>>
>  >>>> * rt-stddev:
>  >>>> Standard deviation of the response time.
>  >>>>
>  >>>> To access this information the CLI smbstat must be modified and
>  >>>> allow the
>  >>>> following options:
>  >>>>
>  >>>> -r Display the statistics of the requests.
>  >>>>
>  >>>> -a Display the statistics of all the types of request (the 256 of
>  >>>> them) whether they are valid or not.
>  >>>>
>  >>>> -n Display in alphabetic order.
>  >>>>
>  >>>> -z Display the statistics of the requests actually received.
>  >>>>
>  >>>> -t Display the throughput of the SMB/CIFS server.
>  >>>>
>  >>>> -u Display the utilization of the SMB/CIFS server.
>  >>>>
>  >>>> -c Display the counters.
>  >>>>
>  >>>> A number can also be provided indicating the interval of time
> between
>  >>>> refreshes. The first statistics displayed cover the time between
> when
>  >>>> the server was started and the moment the statistics were
> requested.
>  >>>> Subsequent refreshes cover the last time interval only.
>  >>>>
>  >>>> It should be noted that the output is all new replacing the old
> one and
>  >>>> is for humans only.
>  >>>>
>  >>>> Examples of smbstat output:
>  >>>>
>  >>>> '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
>  >>>>
>  >>>> 'smbstat -r'
>  >>>>
>  >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>  >>>> SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
>  >>>> SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
>  >>>> SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-
> 07
>  >>>> SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00 0.000e+00
>  >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
> 8.612e-06
>  >>>> SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00 0.000e+00
>  >>>> SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
> 0.000e+00
>  >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
> 0.000e+00
>  >>>> SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
> 2.436e-05
>  >>>> SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-
> 03
>  >>>> SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>>
>  >>>> 'smbstat -rz'
>  >>>>
>  >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>  >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
>  >>>> SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
>  >>>> SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
>  >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
> 8.612e-06
>  >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
> 0.000e+00
>  >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
> 0.000e+00
>  >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
> 2.436e-05
>  >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-
> 03
>  >>>>
>  >>>> 6. Resources and Schedule
>  >>>> 6.4. Steering Committee requested information
>  >>>> 6.4.1. Consolidation C-team Name:
>  >>>> ON
>  >>>> 6.5. ARC review type: FastTrack
>  >>>> 6.6. ARC Exposure: open



From jose.borrego@oracle.com Thu Apr  8 14:11:20 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38LBJs4004502
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 14:11:20 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38LBJT7023845
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 14:11:19 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00D07TIVKU00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 15:11:19 -0600 (MDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00CZSTIVAL10@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 15:11:19 -0600 (MDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38LBIUL025709	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 21:11:18 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38KrSsP026088	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 21:11:18 +0000 (GMT)
Received: from abhmt012.oracle.com by acsmt354.oracle.com	with ESMTP id
 147272901270761074; Thu, 08 Apr 2010 14:11:14 -0700
Received: from obelix (/129.150.32.49)	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Thu, 08 Apr 2010 14:11:14 -0700
Date: Thu, 08 Apr 2010 15:11:09 -0600
From: Jose Borrego <jose.borrego@oracle.com>
Subject: RE: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBE2286.7010207@oracle.com>
To: "'Alan Wright'" <alan.wright@oracle.com>,
        "'Garrett D'Amore'" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
Organization: Oracle
MIME-version: 1.0
X-Mailer: Microsoft Office Outlook 12.0
Content-type: text/plain; charset=us-ascii
Content-language: en-us
Content-transfer-encoding: 7BIT
Thread-index: AcrXSq6UXc8SgLxsRJK3h5qbOBNWawAFKaYg
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090208.4BBE4676.0167:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
Status: RO
Content-Length: 13564



> -----Original Message-----
> From: Alan Wright [mailto:alan.wright@oracle.com]
> Sent: Thursday, April 08, 2010 12:38 PM
> To: Garrett D'Amore
> Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
> Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout
> 04/14/2010]
> 
> On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
>  > On 04/ 7/10 10:47 PM, Jordan Brown wrote:
>  >> Garrett D'Amore wrote:
>  >>>
>  >>> What's missing is an interface table. I think though that based on
>  >>> the statement that its not to be parsed ("for humans only"), the
>  >>> output is not-an-interface.
>  >>
>  >> Yes. The stability is the same as the existing command:
>  >>
>  >> |_____________________________|_____________________________|
>  >> | Interface Stability | Uncommitted |
>  >> |_____________________________|_____________________________|
>  >> | Utility Output Format | Not-an-Interface |
>  >> |_____________________________|_____________________________|
>  >>
>  >
>  > You haven't mentioned anything about underlying kstats. Is this how
>  > these stats are implemented? Should that be covered under an ARC
> case as
>  > well (perhaps this one)?
> 
> smbstat has always created its output from undocumented kstats and,
> as with the interface stability, changing that wasn't part of this
> project.  The purpose here is solely to expand and improve on the
> command output.  The underlying kstats have not been considered for
> anything other than internal smbstat consumption.  Publishing them,
> particularly if they may be used in scripts, without taking the
> change of scope into consideration and reviewing the design from
> that perspective is not a good idea.
> 
> I'd prefer to take this as an RFE rather than delay/withdraw this
> case while we go back and review the project with a different scope.
> 

This is a good point. Please indicate if everybody is okay with this.

> --
> 
>  >>> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>  >>>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>  >>>> This information is Copyright (c) 2010, Oracle and/or its
>  >>>> affiliates. All rights reserved.
>  >>>> 1. Introduction
>  >>>> 1.1. Project/Component Working Name:
>  >>>> SMB/CIFS Statistics
>  >>>> 1.2. Name of Document Author/Supplier:
>  >>>> Author: Jose Borrego
>  >>>> 1.3 Date of This Document:
>  >>>> 07 April, 2010
>  >>>>
>  >>>> 1.4. Name of Major Document Customer(s)/Consumer(s):
>  >>>> PSARC
>  >>>> CIFS team
>  >>>>
>  >>>> 1.5. Email Aliases:
>  >>>> 1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>  >>>> 1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>  >>>> 1.5.3. Marketing Manager:
>  >>>> 1.5.4. Interest List: cifs-team@sun.com
>  >>>>
>  >>>> 4. Technical Description:
>  >>>>
>  >>>> Executive Summary:
>  >>>>
>  >>>> This case improves the statistics the SMB/CIFS server maintains
> as
>  >>>> well as
>  >>>> the output of smbstat.
>  >>>>
>  >>>> Problem:
>  >>>>
>  >>>> Currently the only statistics the SMB/CIFS server maintains are
>  >>>> counters
>  >>>> keeping track of how many requests of each type were received,
> the
>  >>>> number
>  >>>> of open files, the number of sessions (users logged in) and the
>  >>>> number of
>  >>>> connections (trees connected). Those statistics are not enough to
>  >>>> describe
>  >>>> the load being applied as well as how the server is responding to
> it.
>  >>>>
>  >>>> Solution:
>  >>>>
>  >>>> In order to get a better picture of the state of the SMB/CIFS
> server
>  >>>> the
>  >>>> following information can be maintained and provided through
> smbstat:
>  >>>>
>  >>>> - Counters:
>  >>>> * nbt:
>  >>>> Number of SMB NetBIOS-over-TCP (NBT) sessions.
>  >>>>
>  >>>> * tcp:
>  >>>> Number of SMB TCP sessions.
>  >>>>
>  >>>> * users:
>  >>>> Number of users logged in.
>  >>>>
>  >>>> * trees:
>  >>>> Number of trees connected.
>  >>>>
>  >>>> * files:
>  >>>> Number of open files.
>  >>>>
>  >>>> * pipes:
>  >>>> Number of open pipes.
>  >>>>
>  >>>> - Throughput:
>  >>>> * rbytes/s:
>  >>>> Number of bytes received per second.
>  >>>>
>  >>>> * tbytes/s:
>  >>>> Number of bytes transmitted per second.
>  >>>>
>  >>>> * reqs/s:
>  >>>> Number of requests handled per second.
>  >>>>
>  >>>> * reads/s:
>  >>>> Number of read requests per second. This would be an aggregation
> of
>  >>>> the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>  >>>> SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>  >>>>
>  >>>> * writes/s:
>  >>>> Number of write requests per second. This would ba an aggregation
> of
>  >>>> the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>  >>>> SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>  >>>>
>  >>>> - Utilization:
>  >>>> * wcnt:
>  >>>> Average number of requests received but waiting for an SMB worker
>  >>>> thread to execute them.
>  >>>>
>  >>>> * rcnt:
>  >>>> Average number of requests being simultaneously executed by an
> SMB
>  >>>> worker thread.
>  >>>>
>  >>>> * wtime:
>  >>>> Average time a request waits before an SMB worker thread starts
>  >>>> executing it.
>  >>>>
>  >>>> * rtime:
>  >>>> Average execution time of a request.
>  >>>>
>  >>>> * w%:
>  >>>> Percentage of the time during which at least one request was
>  >>>> waiting.
>  >>>>
>  >>>> * r%:
>  >>>> Percentage of the time during which at least one request was
> being
>  >>>> executed.
>  >>>>
>  >>>> * u%:
>  >>>> Percentage of utilization of the SMB/CIFS server. This number is
>  >>>> defined as: rcnt / (Max Worker Threads).
>  >>>>
>  >>>> * sat:
>  >>>> Flag indicating if the server saturated in the past. Saturation
> is
>  >>>> defined as: u% == 100%.
>  >>>>
>  >>>> * usr%:
>  >>>> Percentage of the time the processor(s) spent in user space.
>  >>>>
>  >>>> * sys%:
>  >>>> Percentage of the time the processor(s) spent in kernel space.
>  >>>>
>  >>>> * idle%:
>  >>>> Percentage of the time the processor(s) was(were) idle.
>  >>>>
>  >>>> - Requests:
>  >>>> For each type of request:
>  >>>> * %:
>  >>>> Percentage of that type of request.
>  >>>>
>  >>>> * rbytes/s:
>  >>>> Number of bytes received per second.
>  >>>>
>  >>>> * tbytes/s:
>  >>>> Number of bytes received per second.
>  >>>>
>  >>>> * req/s:
>  >>>> Number of requests handled per second.
>  >>>>
>  >>>> * rt-mean:
>  >>>> Average response time in seconds.
>  >>>>
>  >>>> * rt-stddev:
>  >>>> Standard deviation of the response time.
>  >>>>
>  >>>> To access this information the CLI smbstat must be modified and
>  >>>> allow the
>  >>>> following options:
>  >>>>
>  >>>> -r Display the statistics of the requests.
>  >>>>
>  >>>> -a Display the statistics of all the types of request (the 256 of
>  >>>> them) whether they are valid or not.
>  >>>>
>  >>>> -n Display in alphabetic order.
>  >>>>
>  >>>> -z Display the statistics of the requests actually received.
>  >>>>
>  >>>> -t Display the throughput of the SMB/CIFS server.
>  >>>>
>  >>>> -u Display the utilization of the SMB/CIFS server.
>  >>>>
>  >>>> -c Display the counters.
>  >>>>
>  >>>> A number can also be provided indicating the interval of time
> between
>  >>>> refreshes. The first statistics displayed cover the time between
> when
>  >>>> the server was started and the moment the statistics were
> requested.
>  >>>> Subsequent refreshes cover the last time interval only.
>  >>>>
>  >>>> It should be noted that the output is all new replacing the old
> one and
>  >>>> is for humans only.
>  >>>>
>  >>>> Examples of smbstat output:
>  >>>>
>  >>>> '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
>  >>>>
>  >>>> 'smbstat -r'
>  >>>>
>  >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>  >>>> SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
>  >>>> SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
>  >>>> SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-
> 07
>  >>>> SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00 0.000e+00
>  >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
> 8.612e-06
>  >>>> SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00 0.000e+00
>  >>>> SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
> 0.000e+00
>  >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
> 0.000e+00
>  >>>> SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
> 2.436e-05
>  >>>> SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-
> 03
>  >>>> SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>> SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>  >>>> 0.000e+00
>  >>>> SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
> 0.000e+00
>  >>>>
>  >>>> 'smbstat -rz'
>  >>>>
>  >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>  >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
>  >>>> SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
>  >>>> SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
>  >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
> 8.612e-06
>  >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
> 0.000e+00
>  >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
> 0.000e+00
>  >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
> 2.436e-05
>  >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-
> 03
>  >>>>
>  >>>> 6. Resources and Schedule
>  >>>> 6.4. Steering Committee requested information
>  >>>> 6.4.1. Consolidation C-team Name:
>  >>>> ON
>  >>>> 6.5. ARC review type: FastTrack
>  >>>> 6.6. ARC Exposure: open



From garrett.damore@oracle.com Thu Apr  8 15:48:53 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38MmrJG006175
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 15:48:53 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38Mmpju002742
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 15:48:53 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K0000DY1HYK00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 16:48:53 -0600 (MDT)
Received: from sca-ea-mail-2.sun.com ([192.18.43.25])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00CM2Y1GAKE0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 16:48:52 -0600 (MDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by sca-ea-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o38Mmqvv007278	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 22:48:52 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38M9lqn016381	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 22:48:51 +0000 (GMT)
Received: from abhmt018.oracle.com by acsmt353.oracle.com	with ESMTP id
 147437651270766930; Thu, 08 Apr 2010 15:48:50 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 15:48:50 -0700
Date: Thu, 08 Apr 2010 15:48:48 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
To: Jose Borrego <jose.borrego@oracle.com>
Cc: "'Alan Wright'" <alan.wright@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBE5D50.5060606@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090205.4BBE5D54.000A:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 15165

I'd still like a record of the kstats in this case, albeit with Project 
Private (or Uncommitted) binding.

Why bother for Project Private interfaces?  Because in this case the 
kstats are quite visible to end users (as are all kstats) via kstat(1M), 
and so I think its useful to record the fact that these are explicitly 
*not* supported.  It will also help potential future developers who 
might need the information in the stats, although it will also 
underscore to them that any use will require a contract.

So while the list isn't *required*, it *is* desired (by me at least).

     - Garrett

On 04/ 8/10 02:11 PM, Jose Borrego wrote:
>
>    
>> -----Original Message-----
>> From: Alan Wright [mailto:alan.wright@oracle.com]
>> Sent: Thursday, April 08, 2010 12:38 PM
>> To: Garrett D'Amore
>> Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
>> Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout
>> 04/14/2010]
>>
>> On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
>>   >  On 04/ 7/10 10:47 PM, Jordan Brown wrote:
>>   >>  Garrett D'Amore wrote:
>>   >>>
>>   >>>  What's missing is an interface table. I think though that based on
>>   >>>  the statement that its not to be parsed ("for humans only"), the
>>   >>>  output is not-an-interface.
>>   >>
>>   >>  Yes. The stability is the same as the existing command:
>>   >>
>>   >>  |_____________________________|_____________________________|
>>   >>  | Interface Stability | Uncommitted |
>>   >>  |_____________________________|_____________________________|
>>   >>  | Utility Output Format | Not-an-Interface |
>>   >>  |_____________________________|_____________________________|
>>   >>
>>   >
>>   >  You haven't mentioned anything about underlying kstats. Is this how
>>   >  these stats are implemented? Should that be covered under an ARC
>> case as
>>   >  well (perhaps this one)?
>>
>> smbstat has always created its output from undocumented kstats and,
>> as with the interface stability, changing that wasn't part of this
>> project.  The purpose here is solely to expand and improve on the
>> command output.  The underlying kstats have not been considered for
>> anything other than internal smbstat consumption.  Publishing them,
>> particularly if they may be used in scripts, without taking the
>> change of scope into consideration and reviewing the design from
>> that perspective is not a good idea.
>>
>> I'd prefer to take this as an RFE rather than delay/withdraw this
>> case while we go back and review the project with a different scope.
>>
>>      
> This is a good point. Please indicate if everybody is okay with this.
>
>    
>> --
>>
>>   >>>  On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>>   >>>>  Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>>   >>>>  This information is Copyright (c) 2010, Oracle and/or its
>>   >>>>  affiliates. All rights reserved.
>>   >>>>  1. Introduction
>>   >>>>  1.1. Project/Component Working Name:
>>   >>>>  SMB/CIFS Statistics
>>   >>>>  1.2. Name of Document Author/Supplier:
>>   >>>>  Author: Jose Borrego
>>   >>>>  1.3 Date of This Document:
>>   >>>>  07 April, 2010
>>   >>>>
>>   >>>>  1.4. Name of Major Document Customer(s)/Consumer(s):
>>   >>>>  PSARC
>>   >>>>  CIFS team
>>   >>>>
>>   >>>>  1.5. Email Aliases:
>>   >>>>  1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>   >>>>  1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>   >>>>  1.5.3. Marketing Manager:
>>   >>>>  1.5.4. Interest List: cifs-team@sun.com
>>   >>>>
>>   >>>>  4. Technical Description:
>>   >>>>
>>   >>>>  Executive Summary:
>>   >>>>
>>   >>>>  This case improves the statistics the SMB/CIFS server maintains
>> as
>>   >>>>  well as
>>   >>>>  the output of smbstat.
>>   >>>>
>>   >>>>  Problem:
>>   >>>>
>>   >>>>  Currently the only statistics the SMB/CIFS server maintains are
>>   >>>>  counters
>>   >>>>  keeping track of how many requests of each type were received,
>> the
>>   >>>>  number
>>   >>>>  of open files, the number of sessions (users logged in) and the
>>   >>>>  number of
>>   >>>>  connections (trees connected). Those statistics are not enough to
>>   >>>>  describe
>>   >>>>  the load being applied as well as how the server is responding to
>> it.
>>   >>>>
>>   >>>>  Solution:
>>   >>>>
>>   >>>>  In order to get a better picture of the state of the SMB/CIFS
>> server
>>   >>>>  the
>>   >>>>  following information can be maintained and provided through
>> smbstat:
>>   >>>>
>>   >>>>  - Counters:
>>   >>>>  * nbt:
>>   >>>>  Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>   >>>>
>>   >>>>  * tcp:
>>   >>>>  Number of SMB TCP sessions.
>>   >>>>
>>   >>>>  * users:
>>   >>>>  Number of users logged in.
>>   >>>>
>>   >>>>  * trees:
>>   >>>>  Number of trees connected.
>>   >>>>
>>   >>>>  * files:
>>   >>>>  Number of open files.
>>   >>>>
>>   >>>>  * pipes:
>>   >>>>  Number of open pipes.
>>   >>>>
>>   >>>>  - Throughput:
>>   >>>>  * rbytes/s:
>>   >>>>  Number of bytes received per second.
>>   >>>>
>>   >>>>  * tbytes/s:
>>   >>>>  Number of bytes transmitted per second.
>>   >>>>
>>   >>>>  * reqs/s:
>>   >>>>  Number of requests handled per second.
>>   >>>>
>>   >>>>  * reads/s:
>>   >>>>  Number of read requests per second. This would be an aggregation
>> of
>>   >>>>  the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>   >>>>  SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>   >>>>
>>   >>>>  * writes/s:
>>   >>>>  Number of write requests per second. This would ba an aggregation
>> of
>>   >>>>  the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>>   >>>>  SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>   >>>>
>>   >>>>  - Utilization:
>>   >>>>  * wcnt:
>>   >>>>  Average number of requests received but waiting for an SMB worker
>>   >>>>  thread to execute them.
>>   >>>>
>>   >>>>  * rcnt:
>>   >>>>  Average number of requests being simultaneously executed by an
>> SMB
>>   >>>>  worker thread.
>>   >>>>
>>   >>>>  * wtime:
>>   >>>>  Average time a request waits before an SMB worker thread starts
>>   >>>>  executing it.
>>   >>>>
>>   >>>>  * rtime:
>>   >>>>  Average execution time of a request.
>>   >>>>
>>   >>>>  * w%:
>>   >>>>  Percentage of the time during which at least one request was
>>   >>>>  waiting.
>>   >>>>
>>   >>>>  * r%:
>>   >>>>  Percentage of the time during which at least one request was
>> being
>>   >>>>  executed.
>>   >>>>
>>   >>>>  * u%:
>>   >>>>  Percentage of utilization of the SMB/CIFS server. This number is
>>   >>>>  defined as: rcnt / (Max Worker Threads).
>>   >>>>
>>   >>>>  * sat:
>>   >>>>  Flag indicating if the server saturated in the past. Saturation
>> is
>>   >>>>  defined as: u% == 100%.
>>   >>>>
>>   >>>>  * usr%:
>>   >>>>  Percentage of the time the processor(s) spent in user space.
>>   >>>>
>>   >>>>  * sys%:
>>   >>>>  Percentage of the time the processor(s) spent in kernel space.
>>   >>>>
>>   >>>>  * idle%:
>>   >>>>  Percentage of the time the processor(s) was(were) idle.
>>   >>>>
>>   >>>>  - Requests:
>>   >>>>  For each type of request:
>>   >>>>  * %:
>>   >>>>  Percentage of that type of request.
>>   >>>>
>>   >>>>  * rbytes/s:
>>   >>>>  Number of bytes received per second.
>>   >>>>
>>   >>>>  * tbytes/s:
>>   >>>>  Number of bytes received per second.
>>   >>>>
>>   >>>>  * req/s:
>>   >>>>  Number of requests handled per second.
>>   >>>>
>>   >>>>  * rt-mean:
>>   >>>>  Average response time in seconds.
>>   >>>>
>>   >>>>  * rt-stddev:
>>   >>>>  Standard deviation of the response time.
>>   >>>>
>>   >>>>  To access this information the CLI smbstat must be modified and
>>   >>>>  allow the
>>   >>>>  following options:
>>   >>>>
>>   >>>>  -r Display the statistics of the requests.
>>   >>>>
>>   >>>>  -a Display the statistics of all the types of request (the 256 of
>>   >>>>  them) whether they are valid or not.
>>   >>>>
>>   >>>>  -n Display in alphabetic order.
>>   >>>>
>>   >>>>  -z Display the statistics of the requests actually received.
>>   >>>>
>>   >>>>  -t Display the throughput of the SMB/CIFS server.
>>   >>>>
>>   >>>>  -u Display the utilization of the SMB/CIFS server.
>>   >>>>
>>   >>>>  -c Display the counters.
>>   >>>>
>>   >>>>  A number can also be provided indicating the interval of time
>> between
>>   >>>>  refreshes. The first statistics displayed cover the time between
>> when
>>   >>>>  the server was started and the moment the statistics were
>> requested.
>>   >>>>  Subsequent refreshes cover the last time interval only.
>>   >>>>
>>   >>>>  It should be noted that the output is all new replacing the old
>> one and
>>   >>>>  is for humans only.
>>   >>>>
>>   >>>>  Examples of smbstat output:
>>   >>>>
>>   >>>>  '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
>>   >>>>
>>   >>>>  'smbstat -r'
>>   >>>>
>>   >>>>  code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>   >>>>  SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
>>   >>>>  SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
>>   >>>>  SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-
>> 07
>>   >>>>  SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00 0.000e+00
>>   >>>>  SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>> 8.612e-06
>>   >>>>  SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00 0.000e+00
>>   >>>>  SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>> 0.000e+00
>>   >>>>  SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>> 0.000e+00
>>   >>>>  SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>> 2.436e-05
>>   >>>>  SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-
>> 03
>>   >>>>  SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>
>>   >>>>  'smbstat -rz'
>>   >>>>
>>   >>>>  code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>   >>>>  SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
>>   >>>>  SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
>>   >>>>  SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
>>   >>>>  SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>> 8.612e-06
>>   >>>>  SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>> 0.000e+00
>>   >>>>  SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>> 0.000e+00
>>   >>>>  SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>> 2.436e-05
>>   >>>>  SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-
>> 03
>>   >>>>
>>   >>>>  6. Resources and Schedule
>>   >>>>  6.4. Steering Committee requested information
>>   >>>>  6.4.1. Consolidation C-team Name:
>>   >>>>  ON
>>   >>>>  6.5. ARC review type: FastTrack
>>   >>>>  6.6. ARC Exposure: open
>>      
>
>    


From garrett.damore@oracle.com Thu Apr  8 15:48:54 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38MmsbP006179
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 15:48:54 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38Mmrvw006065
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 17:48:53 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00B03Y1HK900@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 15:48:53 -0700 (PDT)
Received: from sca-ea-mail-2.sun.com ([192.18.43.25])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K003AVY1HBJ60@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 15:48:53 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by sca-ea-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o38Mmqhn007281	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 22:48:52 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38M9lqp016381	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 22:48:52 +0000 (GMT)
Received: from abhmt018.oracle.com by acsmt353.oracle.com	with ESMTP id
 147437651270766930; Thu, 08 Apr 2010 15:48:50 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 15:48:50 -0700
Date: Thu, 08 Apr 2010 15:48:48 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
To: Jose Borrego <jose.borrego@oracle.com>
Cc: "'Alan Wright'" <alan.wright@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBE5D50.5060606@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090206.4BBE5D54.0067:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 15165

I'd still like a record of the kstats in this case, albeit with Project 
Private (or Uncommitted) binding.

Why bother for Project Private interfaces?  Because in this case the 
kstats are quite visible to end users (as are all kstats) via kstat(1M), 
and so I think its useful to record the fact that these are explicitly 
*not* supported.  It will also help potential future developers who 
might need the information in the stats, although it will also 
underscore to them that any use will require a contract.

So while the list isn't *required*, it *is* desired (by me at least).

     - Garrett

On 04/ 8/10 02:11 PM, Jose Borrego wrote:
>
>    
>> -----Original Message-----
>> From: Alan Wright [mailto:alan.wright@oracle.com]
>> Sent: Thursday, April 08, 2010 12:38 PM
>> To: Garrett D'Amore
>> Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
>> Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout
>> 04/14/2010]
>>
>> On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
>>   >  On 04/ 7/10 10:47 PM, Jordan Brown wrote:
>>   >>  Garrett D'Amore wrote:
>>   >>>
>>   >>>  What's missing is an interface table. I think though that based on
>>   >>>  the statement that its not to be parsed ("for humans only"), the
>>   >>>  output is not-an-interface.
>>   >>
>>   >>  Yes. The stability is the same as the existing command:
>>   >>
>>   >>  |_____________________________|_____________________________|
>>   >>  | Interface Stability | Uncommitted |
>>   >>  |_____________________________|_____________________________|
>>   >>  | Utility Output Format | Not-an-Interface |
>>   >>  |_____________________________|_____________________________|
>>   >>
>>   >
>>   >  You haven't mentioned anything about underlying kstats. Is this how
>>   >  these stats are implemented? Should that be covered under an ARC
>> case as
>>   >  well (perhaps this one)?
>>
>> smbstat has always created its output from undocumented kstats and,
>> as with the interface stability, changing that wasn't part of this
>> project.  The purpose here is solely to expand and improve on the
>> command output.  The underlying kstats have not been considered for
>> anything other than internal smbstat consumption.  Publishing them,
>> particularly if they may be used in scripts, without taking the
>> change of scope into consideration and reviewing the design from
>> that perspective is not a good idea.
>>
>> I'd prefer to take this as an RFE rather than delay/withdraw this
>> case while we go back and review the project with a different scope.
>>
>>      
> This is a good point. Please indicate if everybody is okay with this.
>
>    
>> --
>>
>>   >>>  On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>>   >>>>  Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>>   >>>>  This information is Copyright (c) 2010, Oracle and/or its
>>   >>>>  affiliates. All rights reserved.
>>   >>>>  1. Introduction
>>   >>>>  1.1. Project/Component Working Name:
>>   >>>>  SMB/CIFS Statistics
>>   >>>>  1.2. Name of Document Author/Supplier:
>>   >>>>  Author: Jose Borrego
>>   >>>>  1.3 Date of This Document:
>>   >>>>  07 April, 2010
>>   >>>>
>>   >>>>  1.4. Name of Major Document Customer(s)/Consumer(s):
>>   >>>>  PSARC
>>   >>>>  CIFS team
>>   >>>>
>>   >>>>  1.5. Email Aliases:
>>   >>>>  1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>   >>>>  1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>   >>>>  1.5.3. Marketing Manager:
>>   >>>>  1.5.4. Interest List: cifs-team@sun.com
>>   >>>>
>>   >>>>  4. Technical Description:
>>   >>>>
>>   >>>>  Executive Summary:
>>   >>>>
>>   >>>>  This case improves the statistics the SMB/CIFS server maintains
>> as
>>   >>>>  well as
>>   >>>>  the output of smbstat.
>>   >>>>
>>   >>>>  Problem:
>>   >>>>
>>   >>>>  Currently the only statistics the SMB/CIFS server maintains are
>>   >>>>  counters
>>   >>>>  keeping track of how many requests of each type were received,
>> the
>>   >>>>  number
>>   >>>>  of open files, the number of sessions (users logged in) and the
>>   >>>>  number of
>>   >>>>  connections (trees connected). Those statistics are not enough to
>>   >>>>  describe
>>   >>>>  the load being applied as well as how the server is responding to
>> it.
>>   >>>>
>>   >>>>  Solution:
>>   >>>>
>>   >>>>  In order to get a better picture of the state of the SMB/CIFS
>> server
>>   >>>>  the
>>   >>>>  following information can be maintained and provided through
>> smbstat:
>>   >>>>
>>   >>>>  - Counters:
>>   >>>>  * nbt:
>>   >>>>  Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>   >>>>
>>   >>>>  * tcp:
>>   >>>>  Number of SMB TCP sessions.
>>   >>>>
>>   >>>>  * users:
>>   >>>>  Number of users logged in.
>>   >>>>
>>   >>>>  * trees:
>>   >>>>  Number of trees connected.
>>   >>>>
>>   >>>>  * files:
>>   >>>>  Number of open files.
>>   >>>>
>>   >>>>  * pipes:
>>   >>>>  Number of open pipes.
>>   >>>>
>>   >>>>  - Throughput:
>>   >>>>  * rbytes/s:
>>   >>>>  Number of bytes received per second.
>>   >>>>
>>   >>>>  * tbytes/s:
>>   >>>>  Number of bytes transmitted per second.
>>   >>>>
>>   >>>>  * reqs/s:
>>   >>>>  Number of requests handled per second.
>>   >>>>
>>   >>>>  * reads/s:
>>   >>>>  Number of read requests per second. This would be an aggregation
>> of
>>   >>>>  the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>   >>>>  SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>   >>>>
>>   >>>>  * writes/s:
>>   >>>>  Number of write requests per second. This would ba an aggregation
>> of
>>   >>>>  the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>>   >>>>  SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>   >>>>
>>   >>>>  - Utilization:
>>   >>>>  * wcnt:
>>   >>>>  Average number of requests received but waiting for an SMB worker
>>   >>>>  thread to execute them.
>>   >>>>
>>   >>>>  * rcnt:
>>   >>>>  Average number of requests being simultaneously executed by an
>> SMB
>>   >>>>  worker thread.
>>   >>>>
>>   >>>>  * wtime:
>>   >>>>  Average time a request waits before an SMB worker thread starts
>>   >>>>  executing it.
>>   >>>>
>>   >>>>  * rtime:
>>   >>>>  Average execution time of a request.
>>   >>>>
>>   >>>>  * w%:
>>   >>>>  Percentage of the time during which at least one request was
>>   >>>>  waiting.
>>   >>>>
>>   >>>>  * r%:
>>   >>>>  Percentage of the time during which at least one request was
>> being
>>   >>>>  executed.
>>   >>>>
>>   >>>>  * u%:
>>   >>>>  Percentage of utilization of the SMB/CIFS server. This number is
>>   >>>>  defined as: rcnt / (Max Worker Threads).
>>   >>>>
>>   >>>>  * sat:
>>   >>>>  Flag indicating if the server saturated in the past. Saturation
>> is
>>   >>>>  defined as: u% == 100%.
>>   >>>>
>>   >>>>  * usr%:
>>   >>>>  Percentage of the time the processor(s) spent in user space.
>>   >>>>
>>   >>>>  * sys%:
>>   >>>>  Percentage of the time the processor(s) spent in kernel space.
>>   >>>>
>>   >>>>  * idle%:
>>   >>>>  Percentage of the time the processor(s) was(were) idle.
>>   >>>>
>>   >>>>  - Requests:
>>   >>>>  For each type of request:
>>   >>>>  * %:
>>   >>>>  Percentage of that type of request.
>>   >>>>
>>   >>>>  * rbytes/s:
>>   >>>>  Number of bytes received per second.
>>   >>>>
>>   >>>>  * tbytes/s:
>>   >>>>  Number of bytes received per second.
>>   >>>>
>>   >>>>  * req/s:
>>   >>>>  Number of requests handled per second.
>>   >>>>
>>   >>>>  * rt-mean:
>>   >>>>  Average response time in seconds.
>>   >>>>
>>   >>>>  * rt-stddev:
>>   >>>>  Standard deviation of the response time.
>>   >>>>
>>   >>>>  To access this information the CLI smbstat must be modified and
>>   >>>>  allow the
>>   >>>>  following options:
>>   >>>>
>>   >>>>  -r Display the statistics of the requests.
>>   >>>>
>>   >>>>  -a Display the statistics of all the types of request (the 256 of
>>   >>>>  them) whether they are valid or not.
>>   >>>>
>>   >>>>  -n Display in alphabetic order.
>>   >>>>
>>   >>>>  -z Display the statistics of the requests actually received.
>>   >>>>
>>   >>>>  -t Display the throughput of the SMB/CIFS server.
>>   >>>>
>>   >>>>  -u Display the utilization of the SMB/CIFS server.
>>   >>>>
>>   >>>>  -c Display the counters.
>>   >>>>
>>   >>>>  A number can also be provided indicating the interval of time
>> between
>>   >>>>  refreshes. The first statistics displayed cover the time between
>> when
>>   >>>>  the server was started and the moment the statistics were
>> requested.
>>   >>>>  Subsequent refreshes cover the last time interval only.
>>   >>>>
>>   >>>>  It should be noted that the output is all new replacing the old
>> one and
>>   >>>>  is for humans only.
>>   >>>>
>>   >>>>  Examples of smbstat output:
>>   >>>>
>>   >>>>  '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
>>   >>>>
>>   >>>>  'smbstat -r'
>>   >>>>
>>   >>>>  code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>   >>>>  SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
>>   >>>>  SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
>>   >>>>  SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-
>> 07
>>   >>>>  SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00 0.000e+00
>>   >>>>  SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>> 8.612e-06
>>   >>>>  SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00 0.000e+00
>>   >>>>  SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>> 0.000e+00
>>   >>>>  SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>> 0.000e+00
>>   >>>>  SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>> 2.436e-05
>>   >>>>  SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-
>> 03
>>   >>>>  SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>  SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>   >>>>  0.000e+00
>>   >>>>  SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>> 0.000e+00
>>   >>>>
>>   >>>>  'smbstat -rz'
>>   >>>>
>>   >>>>  code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>   >>>>  SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
>>   >>>>  SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
>>   >>>>  SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
>>   >>>>  SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>> 8.612e-06
>>   >>>>  SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>> 0.000e+00
>>   >>>>  SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>> 0.000e+00
>>   >>>>  SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>> 2.436e-05
>>   >>>>  SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-
>> 03
>>   >>>>
>>   >>>>  6. Resources and Schedule
>>   >>>>  6.4. Steering Committee requested information
>>   >>>>  6.4.1. Consolidation C-team Name:
>>   >>>>  ON
>>   >>>>  6.5. ARC review type: FastTrack
>>   >>>>  6.6. ARC Exposure: open
>>      
>
>    


From bart.smaalders@oracle.com Thu Apr  8 16:05:54 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38N5shV006663
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 16:05:54 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38N5rBe015357
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 18:05:53 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K0050VYTT5000@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 16:05:53 -0700 (PDT)
Received: from jurassic.Eng.Sun.COM ([129.146.17.59])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K00JIGYTS2240@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 16:05:52 -0700 (PDT)
Received: from [129.146.228.109] (cyber.SFBay.Sun.COM [129.146.228.109])
	by jurassic.Eng.Sun.COM (8.14.4+Sun/8.14.4) with ESMTP id o38N5qij868510; Thu,
 08 Apr 2010 16:05:52 -0700 (PDT)
Date: Thu, 08 Apr 2010 16:03:46 -0700
From: Bart Smaalders <bart.smaalders@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBE5D50.5060606@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: Jose Borrego <jose.borrego@oracle.com>,
        "'Alan Wright'" <alan.wright@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBE60D2.6020508@oracle.com>
Organization: Oracle
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.8) Gecko/20100315
 Lightning/1.0b1 Thunderbird/3.0.3
Status: RO
Content-Length: 1041

On 04/08/10 15:48, Garrett D'Amore wrote:
> I'd still like a record of the kstats in this case, albeit with Project
> Private (or Uncommitted) binding.
>
> Why bother for Project Private interfaces? Because in this case the
> kstats are quite visible to end users (as are all kstats) via kstat(1M),
> and so I think its useful to record the fact that these are explicitly
> *not* supported. It will also help potential future developers who might
> need the information in the stats, although it will also underscore to
> them that any use will require a contract.
>
> So while the list isn't *required*, it *is* desired (by me at least).


So why not wait for the project to integrate?

Writing it down here is useless; it's a PRIVATE interface.

All that is needed is a simple statement:

smb kstats are a private interface; relying on them will break your code.

- Bart


-- 
Bart Smaalders			Solaris Kernel Performance
bart.smaalders@oracle.com	http://blogs.sun.com/barts
"You will contribute more with mercurial than with thunderbird."

From calum.mackay@oracle.com Thu Apr  8 16:10:24 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38NAOYF006687
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 16:10:24 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38NAOFQ017781
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 18:10:24 -0500 (CDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00303Z1CEF00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 17:10:24 -0600 (MDT)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K0015XZ1BFP10@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 17:10:23 -0600 (MDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38NANDK001596	for
 <PSARC-ext@Sun.COM>; Thu, 08 Apr 2010 23:10:23 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38Mf6jn029436	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 23:10:22 +0000 (GMT)
Received: from abhmt005.oracle.com by acsmt355.oracle.com	with ESMTP id
 159610341270768219; Thu, 08 Apr 2010 16:10:19 -0700
Received: from mbp-2.local (/212.44.17.104)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 16:10:19 -0700
Date: Fri, 09 Apr 2010 00:10:17 +0100
From: Calum Mackay <calum.mackay@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <p2macff61d31004081036h8ee70508m717fdb07f4400b97@mail.gmail.com>
To: John Plocher <john.plocher@gmail.com>
Cc: Jordan Brown <jb25718@sac.sfbay.sun.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBE6259.9080607@oracle.com>
Organization: Oracle Corporation
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090205.4BBE625E.016B:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <p2macff61d31004081036h8ee70508m717fdb07f4400b97@mail.gmail.com>
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-GB; rv:1.9.1.9)
 Gecko/20100317 Thunderbird/3.0.4
Status: RO
Content-Length: 636

On 08/04/2010 18:36, John Plocher wrote:
> I presume it is a good thing to have so many stats, and to be able to
> inundate the admin with tons of info, but what is missing for me is
> the conceptual structure to interpret and utilize all this info and to
> actually debug problems.  In ARC-speak, what (where?) is the
> user/usage model that pulls all these stats together into a coherent
> whole?  Or, do I need to be an expert CIFS protocol/implementation
> expert to make sense of any of this?

fsstat(1M) attempts to given an overview, that might be helpful before 
turning to more details tools like the per-fs stats.

cheers,
c.

From calum.mackay@oracle.com Thu Apr  8 16:10:25 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38NAPuN006691
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 16:10:25 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38NAO96013335
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 16:10:24 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0K00D01Z1C2I00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 16:10:24 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0K0033NZ1CBB80@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 16:10:24 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o38NAN4a012687	for
 <PSARC-ext@Sun.COM>; Thu, 08 Apr 2010 23:10:23 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o38Mf6jp029436	for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 23:10:23 +0000 (GMT)
Received: from abhmt005.oracle.com by acsmt355.oracle.com	with ESMTP id
 159610341270768219; Thu, 08 Apr 2010 16:10:19 -0700
Received: from mbp-2.local (/212.44.17.104)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 16:10:19 -0700
Date: Fri, 09 Apr 2010 00:10:17 +0100
From: Calum Mackay <calum.mackay@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <p2macff61d31004081036h8ee70508m717fdb07f4400b97@mail.gmail.com>
To: John Plocher <john.plocher@gmail.com>
Cc: Jordan Brown <jb25718@sac.sfbay.sun.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBE6259.9080607@oracle.com>
Organization: Oracle Corporation
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090205.4BBE625F.00D8:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <p2macff61d31004081036h8ee70508m717fdb07f4400b97@mail.gmail.com>
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-GB; rv:1.9.1.9)
 Gecko/20100317 Thunderbird/3.0.4
Status: RO
Content-Length: 636

On 08/04/2010 18:36, John Plocher wrote:
> I presume it is a good thing to have so many stats, and to be able to
> inundate the admin with tons of info, but what is missing for me is
> the conceptual structure to interpret and utilize all this info and to
> actually debug problems.  In ARC-speak, what (where?) is the
> user/usage model that pulls all these stats together into a coherent
> whole?  Or, do I need to be an expert CIFS protocol/implementation
> expert to make sense of any of this?

fsstat(1M) attempts to given an overview, that might be helpful before 
turning to more details tools like the per-fs stats.

cheers,
c.

From jason.brian.king@gmail.com Thu Apr  8 16:36:56 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o38NauKF006994
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 16:36:56 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o38Nathg025249
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 8 Apr 2010 16:36:55 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0L00E0109JXF00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 16:36:55 -0700 (PDT)
Received: from sca-ea-mail-2.sun.com ([192.18.43.25])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0L003WJ09JBI80@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 16:36:55 -0700 (PDT)
Received: from relay15i.sun.com
 (ip125.net129179-4.block1.us.syntegra.com [129.179.4.125])
	by sca-ea-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o38NY19e021272	for
 <PSARC-ext@sun.com>; Thu, 08 Apr 2010 23:36:54 +0000 (GMT)
Received: from mmp14es.mmp.us.syntegra.com ([160.41.208.14] [160.41.208.14])
 by relay15i.sun.com with ESMTP id BT-MMP-3887766 for PSARC-ext@sun.com; Thu,
 08 Apr 2010 23:36:53 +0000 (Z)
Received: from relay15i.sun.com (relay15i.sun.com [129.179.4.125])
 by mmp14es.mmp.us.syntegra.com with ESMTP id BT-MMP-240594 for
 PSARC-ext@sun.com; Thu, 08 Apr 2010 23:36:53 +0000 (Z)
Received: from mail-gy0-f177.google.com ([209.85.160.177] [209.85.160.177])
 by relay1i.sun.com with ESMTP id BT-MMP-12568602 for PSARC-ext@sun.com; Thu,
 08 Apr 2010 23:36:53 +0000 (Z)
Received: by gyb11 with SMTP id 11so1373131gyb.8 for <PSARC-ext@sun.com>; Thu,
 08 Apr 2010 16:36:48 -0700 (PDT)
Received: by 10.151.8.21 with HTTP; Thu, 08 Apr 2010 16:36:47 -0700 (PDT)
Received: by 10.151.65.30 with SMTP id s30mr1041819ybk.57.1270769807609; Thu,
 08 Apr 2010 16:36:47 -0700 (PDT)
Date: Thu, 08 Apr 2010 18:36:47 -0500
From: Jason King <jason@ansipunx.net>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBE5D50.5060606@oracle.com>
Sender: jason.brian.king@gmail.com
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: Jose Borrego <jose.borrego@oracle.com>,
        Alan Wright <alan.wright@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <v2hfa9202c31004081636t7cfd4e10jade1837d99253f0@mail.gmail.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;        d=gmail.com;
 s=gamma;        h=domainkey-signature:mime-version:sender:received:in-reply-to
         :references:date:x-google-sender-auth:received:message-id:subject
 :from:to:cc:content-type:content-transfer-encoding;
 bh=ebuXRc/3FC1tGxb6zMkN1usB7a1MSGZKyerfxapV53k=;
 b=RZv8x/OBoZURkE62yDW4emsTcH1XPozK76Hot28TmUEMFiVlxtg5osTvdDlkAEhBUP
 An/G+t62sMS/KSQ03j8aNAaYTG/FO/q5l4IsYWaARyasG4nUoTTWAitBFAX9PMI/tV2H
 7+ysLC6uGp/TYI/BfhB8fS4ULKc0MSzLbDvOo=
DomainKey-Signature: a=rsa-sha1; c=nofws;        d=gmail.com; s=gamma;
 h=mime-version:sender:in-reply-to:references:date
 :x-google-sender-auth:message-id:subject:from:to:cc:content-type
 :content-transfer-encoding;
 b=q72eu/5wrx1F3E33ASmvqUniXedE7xiJnCqx3P/T074BiBLETO6yBYXj9sy+7SyFic
 QO3H2X4rAoODj+5zAzLqHqbGulQ9pvgXm9qUiq3Bxw/7Blq2gZjC+h/XWv3n5iZ6hIjh
 QsTEQ59od9kNr73dQk3fmLtLA3MeQfoNXY2vk=
X-PMX-Version: 5.4.1.325704
X-Brightmail-Tracker: AAAAAA==
X-Google-Sender-Auth: 026833c82a48e224
X-Antispam: No, score=-2.6/5.0, scanned in 0.236sec at (localhost [127.0.0.1])
	by smf-spamd v1.3.1 - http://smfs.sf.net/
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com>
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from quoted-printable to 8bit by sac.sfbay.sun.com id o38NauKF006994
Status: RO
Content-Length: 15705

As an outside developer, I would greatly appreciate this.  Having had
past projects that tried to do the right thing wrt to consuming kstats
(and reaching brick wall after brick wall), this would greatly help
those of us on the outside navigate things.

On Thu, Apr 8, 2010 at 5:48 PM, Garrett D'Amore
<garrett.damore@oracle.com> wrote:
> I'd still like a record of the kstats in this case, albeit with Project
> Private (or Uncommitted) binding.
>
> Why bother for Project Private interfaces?  Because in this case the kstats
> are quite visible to end users (as are all kstats) via kstat(1M), and so I
> think its useful to record the fact that these are explicitly *not*
> supported.  It will also help potential future developers who might need the
> information in the stats, although it will also underscore to them that any
> use will require a contract.
>
> So while the list isn't *required*, it *is* desired (by me at least).
>
>    - Garrett
>
> On 04/ 8/10 02:11 PM, Jose Borrego wrote:
>>
>>
>>>
>>> -----Original Message-----
>>> From: Alan Wright [mailto:alan.wright@oracle.com]
>>> Sent: Thursday, April 08, 2010 12:38 PM
>>> To: Garrett D'Amore
>>> Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
>>> Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout
>>> 04/14/2010]
>>>
>>> On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
>>>  >  On 04/ 7/10 10:47 PM, Jordan Brown wrote:
>>>  >>  Garrett D'Amore wrote:
>>>  >>>
>>>  >>>  What's missing is an interface table. I think though that based on
>>>  >>>  the statement that its not to be parsed ("for humans only"), the
>>>  >>>  output is not-an-interface.
>>>  >>
>>>  >>  Yes. The stability is the same as the existing command:
>>>  >>
>>>  >>  |_____________________________|_____________________________|
>>>  >>  | Interface Stability | Uncommitted |
>>>  >>  |_____________________________|_____________________________|
>>>  >>  | Utility Output Format | Not-an-Interface |
>>>  >>  |_____________________________|_____________________________|
>>>  >>
>>>  >
>>>  >  You haven't mentioned anything about underlying kstats. Is this how
>>>  >  these stats are implemented? Should that be covered under an ARC
>>> case as
>>>  >  well (perhaps this one)?
>>>
>>> smbstat has always created its output from undocumented kstats and,
>>> as with the interface stability, changing that wasn't part of this
>>> project.  The purpose here is solely to expand and improve on the
>>> command output.  The underlying kstats have not been considered for
>>> anything other than internal smbstat consumption.  Publishing them,
>>> particularly if they may be used in scripts, without taking the
>>> change of scope into consideration and reviewing the design from
>>> that perspective is not a good idea.
>>>
>>> I'd prefer to take this as an RFE rather than delay/withdraw this
>>> case while we go back and review the project with a different scope.
>>>
>>>
>>
>> This is a good point. Please indicate if everybody is okay with this.
>>
>>
>>>
>>> --
>>>
>>>  >>>  On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>>>  >>>>  Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>>>  >>>>  This information is Copyright (c) 2010, Oracle and/or its
>>>  >>>>  affiliates. All rights reserved.
>>>  >>>>  1. Introduction
>>>  >>>>  1.1. Project/Component Working Name:
>>>  >>>>  SMB/CIFS Statistics
>>>  >>>>  1.2. Name of Document Author/Supplier:
>>>  >>>>  Author: Jose Borrego
>>>  >>>>  1.3 Date of This Document:
>>>  >>>>  07 April, 2010
>>>  >>>>
>>>  >>>>  1.4. Name of Major Document Customer(s)/Consumer(s):
>>>  >>>>  PSARC
>>>  >>>>  CIFS team
>>>  >>>>
>>>  >>>>  1.5. Email Aliases:
>>>  >>>>  1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>>  >>>>  1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>>  >>>>  1.5.3. Marketing Manager:
>>>  >>>>  1.5.4. Interest List: cifs-team@sun.com
>>>  >>>>
>>>  >>>>  4. Technical Description:
>>>  >>>>
>>>  >>>>  Executive Summary:
>>>  >>>>
>>>  >>>>  This case improves the statistics the SMB/CIFS server maintains
>>> as
>>>  >>>>  well as
>>>  >>>>  the output of smbstat.
>>>  >>>>
>>>  >>>>  Problem:
>>>  >>>>
>>>  >>>>  Currently the only statistics the SMB/CIFS server maintains are
>>>  >>>>  counters
>>>  >>>>  keeping track of how many requests of each type were received,
>>> the
>>>  >>>>  number
>>>  >>>>  of open files, the number of sessions (users logged in) and the
>>>  >>>>  number of
>>>  >>>>  connections (trees connected). Those statistics are not enough to
>>>  >>>>  describe
>>>  >>>>  the load being applied as well as how the server is responding to
>>> it.
>>>  >>>>
>>>  >>>>  Solution:
>>>  >>>>
>>>  >>>>  In order to get a better picture of the state of the SMB/CIFS
>>> server
>>>  >>>>  the
>>>  >>>>  following information can be maintained and provided through
>>> smbstat:
>>>  >>>>
>>>  >>>>  - Counters:
>>>  >>>>  * nbt:
>>>  >>>>  Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>>  >>>>
>>>  >>>>  * tcp:
>>>  >>>>  Number of SMB TCP sessions.
>>>  >>>>
>>>  >>>>  * users:
>>>  >>>>  Number of users logged in.
>>>  >>>>
>>>  >>>>  * trees:
>>>  >>>>  Number of trees connected.
>>>  >>>>
>>>  >>>>  * files:
>>>  >>>>  Number of open files.
>>>  >>>>
>>>  >>>>  * pipes:
>>>  >>>>  Number of open pipes.
>>>  >>>>
>>>  >>>>  - Throughput:
>>>  >>>>  * rbytes/s:
>>>  >>>>  Number of bytes received per second.
>>>  >>>>
>>>  >>>>  * tbytes/s:
>>>  >>>>  Number of bytes transmitted per second.
>>>  >>>>
>>>  >>>>  * reqs/s:
>>>  >>>>  Number of requests handled per second.
>>>  >>>>
>>>  >>>>  * reads/s:
>>>  >>>>  Number of read requests per second. This would be an aggregation
>>> of
>>>  >>>>  the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>>  >>>>  SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>>  >>>>
>>>  >>>>  * writes/s:
>>>  >>>>  Number of write requests per second. This would ba an aggregation
>>> of
>>>  >>>>  the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>>>  >>>>  SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>>  >>>>
>>>  >>>>  - Utilization:
>>>  >>>>  * wcnt:
>>>  >>>>  Average number of requests received but waiting for an SMB worker
>>>  >>>>  thread to execute them.
>>>  >>>>
>>>  >>>>  * rcnt:
>>>  >>>>  Average number of requests being simultaneously executed by an
>>> SMB
>>>  >>>>  worker thread.
>>>  >>>>
>>>  >>>>  * wtime:
>>>  >>>>  Average time a request waits before an SMB worker thread starts
>>>  >>>>  executing it.
>>>  >>>>
>>>  >>>>  * rtime:
>>>  >>>>  Average execution time of a request.
>>>  >>>>
>>>  >>>>  * w%:
>>>  >>>>  Percentage of the time during which at least one request was
>>>  >>>>  waiting.
>>>  >>>>
>>>  >>>>  * r%:
>>>  >>>>  Percentage of the time during which at least one request was
>>> being
>>>  >>>>  executed.
>>>  >>>>
>>>  >>>>  * u%:
>>>  >>>>  Percentage of utilization of the SMB/CIFS server. This number is
>>>  >>>>  defined as: rcnt / (Max Worker Threads).
>>>  >>>>
>>>  >>>>  * sat:
>>>  >>>>  Flag indicating if the server saturated in the past. Saturation
>>> is
>>>  >>>>  defined as: u% == 100%.
>>>  >>>>
>>>  >>>>  * usr%:
>>>  >>>>  Percentage of the time the processor(s) spent in user space.
>>>  >>>>
>>>  >>>>  * sys%:
>>>  >>>>  Percentage of the time the processor(s) spent in kernel space.
>>>  >>>>
>>>  >>>>  * idle%:
>>>  >>>>  Percentage of the time the processor(s) was(were) idle.
>>>  >>>>
>>>  >>>>  - Requests:
>>>  >>>>  For each type of request:
>>>  >>>>  * %:
>>>  >>>>  Percentage of that type of request.
>>>  >>>>
>>>  >>>>  * rbytes/s:
>>>  >>>>  Number of bytes received per second.
>>>  >>>>
>>>  >>>>  * tbytes/s:
>>>  >>>>  Number of bytes received per second.
>>>  >>>>
>>>  >>>>  * req/s:
>>>  >>>>  Number of requests handled per second.
>>>  >>>>
>>>  >>>>  * rt-mean:
>>>  >>>>  Average response time in seconds.
>>>  >>>>
>>>  >>>>  * rt-stddev:
>>>  >>>>  Standard deviation of the response time.
>>>  >>>>
>>>  >>>>  To access this information the CLI smbstat must be modified and
>>>  >>>>  allow the
>>>  >>>>  following options:
>>>  >>>>
>>>  >>>>  -r Display the statistics of the requests.
>>>  >>>>
>>>  >>>>  -a Display the statistics of all the types of request (the 256 of
>>>  >>>>  them) whether they are valid or not.
>>>  >>>>
>>>  >>>>  -n Display in alphabetic order.
>>>  >>>>
>>>  >>>>  -z Display the statistics of the requests actually received.
>>>  >>>>
>>>  >>>>  -t Display the throughput of the SMB/CIFS server.
>>>  >>>>
>>>  >>>>  -u Display the utilization of the SMB/CIFS server.
>>>  >>>>
>>>  >>>>  -c Display the counters.
>>>  >>>>
>>>  >>>>  A number can also be provided indicating the interval of time
>>> between
>>>  >>>>  refreshes. The first statistics displayed cover the time between
>>> when
>>>  >>>>  the server was started and the moment the statistics were
>>> requested.
>>>  >>>>  Subsequent refreshes cover the last time interval only.
>>>  >>>>
>>>  >>>>  It should be noted that the output is all new replacing the old
>>> one and
>>>  >>>>  is for humans only.
>>>  >>>>
>>>  >>>>  Examples of smbstat output:
>>>  >>>>
>>>  >>>>  '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
>>>  >>>>
>>>  >>>>  'smbstat -r'
>>>  >>>>
>>>  >>>>  code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>>  >>>>  SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
>>>  >>>>  SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
>>>  >>>>  SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-
>>> 07
>>>  >>>>  SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00 0.000e+00
>>>  >>>>  SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>> 8.612e-06
>>>  >>>>  SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00 0.000e+00
>>>  >>>>  SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>> 0.000e+00
>>>  >>>>  SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>> 0.000e+00
>>>  >>>>  SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>> 2.436e-05
>>>  >>>>  SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-
>>> 03
>>>  >>>>  SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>  SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>  >>>>  0.000e+00
>>>  >>>>  SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>>  >>>>
>>>  >>>>  'smbstat -rz'
>>>  >>>>
>>>  >>>>  code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>>  >>>>  SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
>>>  >>>>  SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
>>>  >>>>  SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
>>>  >>>>  SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>> 8.612e-06
>>>  >>>>  SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>> 0.000e+00
>>>  >>>>  SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>> 0.000e+00
>>>  >>>>  SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>> 2.436e-05
>>>  >>>>  SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-
>>> 03
>>>  >>>>
>>>  >>>>  6. Resources and Schedule
>>>  >>>>  6.4. Steering Committee requested information
>>>  >>>>  6.4.1. Consolidation C-team Name:
>>>  >>>>  ON
>>>  >>>>  6.5. ARC review type: FastTrack
>>>  >>>>  6.6. ARC Exposure: open
>>>
>>
>>
>
> _______________________________________________
> opensolaris-arc mailing list
> opensolaris-arc@opensolaris.org
>


From alan.wright@oracle.com Thu Apr  8 23:23:10 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o396N9Xa012346
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 23:23:09 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o396N64O016111
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 01:23:09 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0L00K0BJ2LBQ00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 08 Apr 2010 23:23:09 -0700 (PDT)
Received: from sca-ea-mail-1.sun.com ([192.18.43.24])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0L0010LJ2KUYD0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 08 Apr 2010 23:23:08 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o396N7VB001157	for
 <PSARC-ext@sun.com>; Fri, 09 Apr 2010 06:23:07 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3963W5Z021910	for <PSARC-ext@sun.com>; Fri,
 09 Apr 2010 06:23:07 +0000 (GMT)
Received: from abhmt020.oracle.com by acsmt355.oracle.com	with ESMTP id
 160383961270794185; Thu, 08 Apr 2010 23:23:05 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 23:23:05 -0700
Date: Thu, 08 Apr 2010 23:22:40 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <v2hfa9202c31004081636t7cfd4e10jade1837d99253f0@mail.gmail.com>
To: Jason King <jason@ansipunx.net>
Cc: "Garrett D'Amore" <garrett.damore@oracle.com>,
        Jose Borrego <jose.borrego@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBEC7B0.10803@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090201.4BBEC7CB.0050:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com>
 <v2hfa9202c31004081636t7cfd4e10jade1837d99253f0@mail.gmail.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 17149

On 04/ 8/10 04:36 PM, Jason King wrote:
> As an outside developer, I would greatly appreciate this.  Having had
> past projects that tried to do the right thing wrt to consuming kstats
> (and reaching brick wall after brick wall), this would greatly help
> those of us on the outside navigate things.

Thank you.  You are justifying my point.  This is precisely why
I don't think it's a good idea to document this private use of
kstats.  Nothing but smbstat should consume these kstats.

Alan

> On Thu, Apr 8, 2010 at 5:48 PM, Garrett D'Amore
> <garrett.damore@oracle.com>  wrote:
>> I'd still like a record of the kstats in this case, albeit with Project
>> Private (or Uncommitted) binding.
>>
>> Why bother for Project Private interfaces?  Because in this case the kstats
>> are quite visible to end users (as are all kstats) via kstat(1M), and so I
>> think its useful to record the fact that these are explicitly *not*
>> supported.  It will also help potential future developers who might need the
>> information in the stats, although it will also underscore to them that any
>> use will require a contract.
>>
>> So while the list isn't *required*, it *is* desired (by me at least).
>>
>>     - Garrett
>>
>> On 04/ 8/10 02:11 PM, Jose Borrego wrote:
>>>
>>>
>>>>
>>>> -----Original Message-----
>>>> From: Alan Wright [mailto:alan.wright@oracle.com]
>>>> Sent: Thursday, April 08, 2010 12:38 PM
>>>> To: Garrett D'Amore
>>>> Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
>>>> Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout
>>>> 04/14/2010]
>>>>
>>>> On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
>>>>   >    On 04/ 7/10 10:47 PM, Jordan Brown wrote:
>>>>   >>    Garrett D'Amore wrote:
>>>>   >>>
>>>>   >>>    What's missing is an interface table. I think though that based on
>>>>   >>>    the statement that its not to be parsed ("for humans only"), the
>>>>   >>>    output is not-an-interface.
>>>>   >>
>>>>   >>    Yes. The stability is the same as the existing command:
>>>>   >>
>>>>   >>    |_____________________________|_____________________________|
>>>>   >>    | Interface Stability | Uncommitted |
>>>>   >>    |_____________________________|_____________________________|
>>>>   >>    | Utility Output Format | Not-an-Interface |
>>>>   >>    |_____________________________|_____________________________|
>>>>   >>
>>>>   >
>>>>   >    You haven't mentioned anything about underlying kstats. Is this how
>>>>   >    these stats are implemented? Should that be covered under an ARC
>>>> case as
>>>>   >    well (perhaps this one)?
>>>>
>>>> smbstat has always created its output from undocumented kstats and,
>>>> as with the interface stability, changing that wasn't part of this
>>>> project.  The purpose here is solely to expand and improve on the
>>>> command output.  The underlying kstats have not been considered for
>>>> anything other than internal smbstat consumption.  Publishing them,
>>>> particularly if they may be used in scripts, without taking the
>>>> change of scope into consideration and reviewing the design from
>>>> that perspective is not a good idea.
>>>>
>>>> I'd prefer to take this as an RFE rather than delay/withdraw this
>>>> case while we go back and review the project with a different scope.
>>>>
>>>>
>>>
>>> This is a good point. Please indicate if everybody is okay with this.
>>>
>>>
>>>>
>>>> --
>>>>
>>>>   >>>    On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>>>>   >>>>    Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>>>>   >>>>    This information is Copyright (c) 2010, Oracle and/or its
>>>>   >>>>    affiliates. All rights reserved.
>>>>   >>>>    1. Introduction
>>>>   >>>>    1.1. Project/Component Working Name:
>>>>   >>>>    SMB/CIFS Statistics
>>>>   >>>>    1.2. Name of Document Author/Supplier:
>>>>   >>>>    Author: Jose Borrego
>>>>   >>>>    1.3 Date of This Document:
>>>>   >>>>    07 April, 2010
>>>>   >>>>
>>>>   >>>>    1.4. Name of Major Document Customer(s)/Consumer(s):
>>>>   >>>>    PSARC
>>>>   >>>>    CIFS team
>>>>   >>>>
>>>>   >>>>    1.5. Email Aliases:
>>>>   >>>>    1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>>>   >>>>    1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>>>   >>>>    1.5.3. Marketing Manager:
>>>>   >>>>    1.5.4. Interest List: cifs-team@sun.com
>>>>   >>>>
>>>>   >>>>    4. Technical Description:
>>>>   >>>>
>>>>   >>>>    Executive Summary:
>>>>   >>>>
>>>>   >>>>    This case improves the statistics the SMB/CIFS server maintains
>>>> as
>>>>   >>>>    well as
>>>>   >>>>    the output of smbstat.
>>>>   >>>>
>>>>   >>>>    Problem:
>>>>   >>>>
>>>>   >>>>    Currently the only statistics the SMB/CIFS server maintains are
>>>>   >>>>    counters
>>>>   >>>>    keeping track of how many requests of each type were received,
>>>> the
>>>>   >>>>    number
>>>>   >>>>    of open files, the number of sessions (users logged in) and the
>>>>   >>>>    number of
>>>>   >>>>    connections (trees connected). Those statistics are not enough to
>>>>   >>>>    describe
>>>>   >>>>    the load being applied as well as how the server is responding to
>>>> it.
>>>>   >>>>
>>>>   >>>>    Solution:
>>>>   >>>>
>>>>   >>>>    In order to get a better picture of the state of the SMB/CIFS
>>>> server
>>>>   >>>>    the
>>>>   >>>>    following information can be maintained and provided through
>>>> smbstat:
>>>>   >>>>
>>>>   >>>>    - Counters:
>>>>   >>>>    * nbt:
>>>>   >>>>    Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>>>   >>>>
>>>>   >>>>    * tcp:
>>>>   >>>>    Number of SMB TCP sessions.
>>>>   >>>>
>>>>   >>>>    * users:
>>>>   >>>>    Number of users logged in.
>>>>   >>>>
>>>>   >>>>    * trees:
>>>>   >>>>    Number of trees connected.
>>>>   >>>>
>>>>   >>>>    * files:
>>>>   >>>>    Number of open files.
>>>>   >>>>
>>>>   >>>>    * pipes:
>>>>   >>>>    Number of open pipes.
>>>>   >>>>
>>>>   >>>>    - Throughput:
>>>>   >>>>    * rbytes/s:
>>>>   >>>>    Number of bytes received per second.
>>>>   >>>>
>>>>   >>>>    * tbytes/s:
>>>>   >>>>    Number of bytes transmitted per second.
>>>>   >>>>
>>>>   >>>>    * reqs/s:
>>>>   >>>>    Number of requests handled per second.
>>>>   >>>>
>>>>   >>>>    * reads/s:
>>>>   >>>>    Number of read requests per second. This would be an aggregation
>>>> of
>>>>   >>>>    the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>>>   >>>>    SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>>>   >>>>
>>>>   >>>>    * writes/s:
>>>>   >>>>    Number of write requests per second. This would ba an aggregation
>>>> of
>>>>   >>>>    the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>>>>   >>>>    SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>>>   >>>>
>>>>   >>>>    - Utilization:
>>>>   >>>>    * wcnt:
>>>>   >>>>    Average number of requests received but waiting for an SMB worker
>>>>   >>>>    thread to execute them.
>>>>   >>>>
>>>>   >>>>    * rcnt:
>>>>   >>>>    Average number of requests being simultaneously executed by an
>>>> SMB
>>>>   >>>>    worker thread.
>>>>   >>>>
>>>>   >>>>    * wtime:
>>>>   >>>>    Average time a request waits before an SMB worker thread starts
>>>>   >>>>    executing it.
>>>>   >>>>
>>>>   >>>>    * rtime:
>>>>   >>>>    Average execution time of a request.
>>>>   >>>>
>>>>   >>>>    * w%:
>>>>   >>>>    Percentage of the time during which at least one request was
>>>>   >>>>    waiting.
>>>>   >>>>
>>>>   >>>>    * r%:
>>>>   >>>>    Percentage of the time during which at least one request was
>>>> being
>>>>   >>>>    executed.
>>>>   >>>>
>>>>   >>>>    * u%:
>>>>   >>>>    Percentage of utilization of the SMB/CIFS server. This number is
>>>>   >>>>    defined as: rcnt / (Max Worker Threads).
>>>>   >>>>
>>>>   >>>>    * sat:
>>>>   >>>>    Flag indicating if the server saturated in the past. Saturation
>>>> is
>>>>   >>>>    defined as: u% == 100%.
>>>>   >>>>
>>>>   >>>>    * usr%:
>>>>   >>>>    Percentage of the time the processor(s) spent in user space.
>>>>   >>>>
>>>>   >>>>    * sys%:
>>>>   >>>>    Percentage of the time the processor(s) spent in kernel space.
>>>>   >>>>
>>>>   >>>>    * idle%:
>>>>   >>>>    Percentage of the time the processor(s) was(were) idle.
>>>>   >>>>
>>>>   >>>>    - Requests:
>>>>   >>>>    For each type of request:
>>>>   >>>>    * %:
>>>>   >>>>    Percentage of that type of request.
>>>>   >>>>
>>>>   >>>>    * rbytes/s:
>>>>   >>>>    Number of bytes received per second.
>>>>   >>>>
>>>>   >>>>    * tbytes/s:
>>>>   >>>>    Number of bytes received per second.
>>>>   >>>>
>>>>   >>>>    * req/s:
>>>>   >>>>    Number of requests handled per second.
>>>>   >>>>
>>>>   >>>>    * rt-mean:
>>>>   >>>>    Average response time in seconds.
>>>>   >>>>
>>>>   >>>>    * rt-stddev:
>>>>   >>>>    Standard deviation of the response time.
>>>>   >>>>
>>>>   >>>>    To access this information the CLI smbstat must be modified and
>>>>   >>>>    allow the
>>>>   >>>>    following options:
>>>>   >>>>
>>>>   >>>>    -r Display the statistics of the requests.
>>>>   >>>>
>>>>   >>>>    -a Display the statistics of all the types of request (the 256 of
>>>>   >>>>    them) whether they are valid or not.
>>>>   >>>>
>>>>   >>>>    -n Display in alphabetic order.
>>>>   >>>>
>>>>   >>>>    -z Display the statistics of the requests actually received.
>>>>   >>>>
>>>>   >>>>    -t Display the throughput of the SMB/CIFS server.
>>>>   >>>>
>>>>   >>>>    -u Display the utilization of the SMB/CIFS server.
>>>>   >>>>
>>>>   >>>>    -c Display the counters.
>>>>   >>>>
>>>>   >>>>    A number can also be provided indicating the interval of time
>>>> between
>>>>   >>>>    refreshes. The first statistics displayed cover the time between
>>>> when
>>>>   >>>>    the server was started and the moment the statistics were
>>>> requested.
>>>>   >>>>    Subsequent refreshes cover the last time interval only.
>>>>   >>>>
>>>>   >>>>    It should be noted that the output is all new replacing the old
>>>> one and
>>>>   >>>>    is for humans only.
>>>>   >>>>
>>>>   >>>>    Examples of smbstat output:
>>>>   >>>>
>>>>   >>>>    '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
>>>>   >>>>
>>>>   >>>>    'smbstat -r'
>>>>   >>>>
>>>>   >>>>    code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>>>   >>>>    SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
>>>>   >>>>    SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
>>>>   >>>>    SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-
>>>> 07
>>>>   >>>>    SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00 0.000e+00
>>>>   >>>>    SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>>> 8.612e-06
>>>>   >>>>    SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00 0.000e+00
>>>>   >>>>    SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>>> 0.000e+00
>>>>   >>>>    SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>>> 0.000e+00
>>>>   >>>>    SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>>> 2.436e-05
>>>>   >>>>    SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-
>>>> 03
>>>>   >>>>    SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>
>>>>   >>>>    'smbstat -rz'
>>>>   >>>>
>>>>   >>>>    code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>>>   >>>>    SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
>>>>   >>>>    SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
>>>>   >>>>    SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
>>>>   >>>>    SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>>> 8.612e-06
>>>>   >>>>    SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>>> 0.000e+00
>>>>   >>>>    SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>>> 0.000e+00
>>>>   >>>>    SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>>> 2.436e-05
>>>>   >>>>    SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-
>>>> 03
>>>>   >>>>
>>>>   >>>>    6. Resources and Schedule
>>>>   >>>>    6.4. Steering Committee requested information
>>>>   >>>>    6.4.1. Consolidation C-team Name:
>>>>   >>>>    ON
>>>>   >>>>    6.5. ARC review type: FastTrack
>>>>   >>>>    6.6. ARC Exposure: open
>>>>
>>>
>>>
>>
>> _______________________________________________
>> opensolaris-arc mailing list
>> opensolaris-arc@opensolaris.org
>>


From alan.wright@oracle.com Thu Apr  8 23:23:12 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o396NBiF012350
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 8 Apr 2010 23:23:11 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o396N8VF058169
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 00:23:11 -0600 (MDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0L00505J2MLC00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 00:23:10 -0600 (MDT)
Received: from sca-ea-mail-1.sun.com ([192.18.43.24])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0L00AU0J2LUB60@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 00:23:09 -0600 (MDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o396N8sf001162	for
 <PSARC-ext@sun.com>; Fri, 09 Apr 2010 06:23:08 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3963W5b021910	for <PSARC-ext@sun.com>; Fri,
 09 Apr 2010 06:23:07 +0000 (GMT)
Received: from abhmt020.oracle.com by acsmt355.oracle.com	with ESMTP id
 160383961270794185; Thu, 08 Apr 2010 23:23:05 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Thu,
 08 Apr 2010 23:23:05 -0700
Date: Thu, 08 Apr 2010 23:22:40 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <v2hfa9202c31004081636t7cfd4e10jade1837d99253f0@mail.gmail.com>
To: Jason King <jason@ansipunx.net>
Cc: "Garrett D'Amore" <garrett.damore@oracle.com>,
        Jose Borrego <jose.borrego@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBEC7B0.10803@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090204.4BBEC7CC.0063:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com>
 <v2hfa9202c31004081636t7cfd4e10jade1837d99253f0@mail.gmail.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 17149

On 04/ 8/10 04:36 PM, Jason King wrote:
> As an outside developer, I would greatly appreciate this.  Having had
> past projects that tried to do the right thing wrt to consuming kstats
> (and reaching brick wall after brick wall), this would greatly help
> those of us on the outside navigate things.

Thank you.  You are justifying my point.  This is precisely why
I don't think it's a good idea to document this private use of
kstats.  Nothing but smbstat should consume these kstats.

Alan

> On Thu, Apr 8, 2010 at 5:48 PM, Garrett D'Amore
> <garrett.damore@oracle.com>  wrote:
>> I'd still like a record of the kstats in this case, albeit with Project
>> Private (or Uncommitted) binding.
>>
>> Why bother for Project Private interfaces?  Because in this case the kstats
>> are quite visible to end users (as are all kstats) via kstat(1M), and so I
>> think its useful to record the fact that these are explicitly *not*
>> supported.  It will also help potential future developers who might need the
>> information in the stats, although it will also underscore to them that any
>> use will require a contract.
>>
>> So while the list isn't *required*, it *is* desired (by me at least).
>>
>>     - Garrett
>>
>> On 04/ 8/10 02:11 PM, Jose Borrego wrote:
>>>
>>>
>>>>
>>>> -----Original Message-----
>>>> From: Alan Wright [mailto:alan.wright@oracle.com]
>>>> Sent: Thursday, April 08, 2010 12:38 PM
>>>> To: Garrett D'Amore
>>>> Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
>>>> Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout
>>>> 04/14/2010]
>>>>
>>>> On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
>>>>   >    On 04/ 7/10 10:47 PM, Jordan Brown wrote:
>>>>   >>    Garrett D'Amore wrote:
>>>>   >>>
>>>>   >>>    What's missing is an interface table. I think though that based on
>>>>   >>>    the statement that its not to be parsed ("for humans only"), the
>>>>   >>>    output is not-an-interface.
>>>>   >>
>>>>   >>    Yes. The stability is the same as the existing command:
>>>>   >>
>>>>   >>    |_____________________________|_____________________________|
>>>>   >>    | Interface Stability | Uncommitted |
>>>>   >>    |_____________________________|_____________________________|
>>>>   >>    | Utility Output Format | Not-an-Interface |
>>>>   >>    |_____________________________|_____________________________|
>>>>   >>
>>>>   >
>>>>   >    You haven't mentioned anything about underlying kstats. Is this how
>>>>   >    these stats are implemented? Should that be covered under an ARC
>>>> case as
>>>>   >    well (perhaps this one)?
>>>>
>>>> smbstat has always created its output from undocumented kstats and,
>>>> as with the interface stability, changing that wasn't part of this
>>>> project.  The purpose here is solely to expand and improve on the
>>>> command output.  The underlying kstats have not been considered for
>>>> anything other than internal smbstat consumption.  Publishing them,
>>>> particularly if they may be used in scripts, without taking the
>>>> change of scope into consideration and reviewing the design from
>>>> that perspective is not a good idea.
>>>>
>>>> I'd prefer to take this as an RFE rather than delay/withdraw this
>>>> case while we go back and review the project with a different scope.
>>>>
>>>>
>>>
>>> This is a good point. Please indicate if everybody is okay with this.
>>>
>>>
>>>>
>>>> --
>>>>
>>>>   >>>    On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>>>>   >>>>    Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>>>>   >>>>    This information is Copyright (c) 2010, Oracle and/or its
>>>>   >>>>    affiliates. All rights reserved.
>>>>   >>>>    1. Introduction
>>>>   >>>>    1.1. Project/Component Working Name:
>>>>   >>>>    SMB/CIFS Statistics
>>>>   >>>>    1.2. Name of Document Author/Supplier:
>>>>   >>>>    Author: Jose Borrego
>>>>   >>>>    1.3 Date of This Document:
>>>>   >>>>    07 April, 2010
>>>>   >>>>
>>>>   >>>>    1.4. Name of Major Document Customer(s)/Consumer(s):
>>>>   >>>>    PSARC
>>>>   >>>>    CIFS team
>>>>   >>>>
>>>>   >>>>    1.5. Email Aliases:
>>>>   >>>>    1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>>>   >>>>    1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>>>   >>>>    1.5.3. Marketing Manager:
>>>>   >>>>    1.5.4. Interest List: cifs-team@sun.com
>>>>   >>>>
>>>>   >>>>    4. Technical Description:
>>>>   >>>>
>>>>   >>>>    Executive Summary:
>>>>   >>>>
>>>>   >>>>    This case improves the statistics the SMB/CIFS server maintains
>>>> as
>>>>   >>>>    well as
>>>>   >>>>    the output of smbstat.
>>>>   >>>>
>>>>   >>>>    Problem:
>>>>   >>>>
>>>>   >>>>    Currently the only statistics the SMB/CIFS server maintains are
>>>>   >>>>    counters
>>>>   >>>>    keeping track of how many requests of each type were received,
>>>> the
>>>>   >>>>    number
>>>>   >>>>    of open files, the number of sessions (users logged in) and the
>>>>   >>>>    number of
>>>>   >>>>    connections (trees connected). Those statistics are not enough to
>>>>   >>>>    describe
>>>>   >>>>    the load being applied as well as how the server is responding to
>>>> it.
>>>>   >>>>
>>>>   >>>>    Solution:
>>>>   >>>>
>>>>   >>>>    In order to get a better picture of the state of the SMB/CIFS
>>>> server
>>>>   >>>>    the
>>>>   >>>>    following information can be maintained and provided through
>>>> smbstat:
>>>>   >>>>
>>>>   >>>>    - Counters:
>>>>   >>>>    * nbt:
>>>>   >>>>    Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>>>   >>>>
>>>>   >>>>    * tcp:
>>>>   >>>>    Number of SMB TCP sessions.
>>>>   >>>>
>>>>   >>>>    * users:
>>>>   >>>>    Number of users logged in.
>>>>   >>>>
>>>>   >>>>    * trees:
>>>>   >>>>    Number of trees connected.
>>>>   >>>>
>>>>   >>>>    * files:
>>>>   >>>>    Number of open files.
>>>>   >>>>
>>>>   >>>>    * pipes:
>>>>   >>>>    Number of open pipes.
>>>>   >>>>
>>>>   >>>>    - Throughput:
>>>>   >>>>    * rbytes/s:
>>>>   >>>>    Number of bytes received per second.
>>>>   >>>>
>>>>   >>>>    * tbytes/s:
>>>>   >>>>    Number of bytes transmitted per second.
>>>>   >>>>
>>>>   >>>>    * reqs/s:
>>>>   >>>>    Number of requests handled per second.
>>>>   >>>>
>>>>   >>>>    * reads/s:
>>>>   >>>>    Number of read requests per second. This would be an aggregation
>>>> of
>>>>   >>>>    the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>>>   >>>>    SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>>>   >>>>
>>>>   >>>>    * writes/s:
>>>>   >>>>    Number of write requests per second. This would ba an aggregation
>>>> of
>>>>   >>>>    the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>>>>   >>>>    SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>>>   >>>>
>>>>   >>>>    - Utilization:
>>>>   >>>>    * wcnt:
>>>>   >>>>    Average number of requests received but waiting for an SMB worker
>>>>   >>>>    thread to execute them.
>>>>   >>>>
>>>>   >>>>    * rcnt:
>>>>   >>>>    Average number of requests being simultaneously executed by an
>>>> SMB
>>>>   >>>>    worker thread.
>>>>   >>>>
>>>>   >>>>    * wtime:
>>>>   >>>>    Average time a request waits before an SMB worker thread starts
>>>>   >>>>    executing it.
>>>>   >>>>
>>>>   >>>>    * rtime:
>>>>   >>>>    Average execution time of a request.
>>>>   >>>>
>>>>   >>>>    * w%:
>>>>   >>>>    Percentage of the time during which at least one request was
>>>>   >>>>    waiting.
>>>>   >>>>
>>>>   >>>>    * r%:
>>>>   >>>>    Percentage of the time during which at least one request was
>>>> being
>>>>   >>>>    executed.
>>>>   >>>>
>>>>   >>>>    * u%:
>>>>   >>>>    Percentage of utilization of the SMB/CIFS server. This number is
>>>>   >>>>    defined as: rcnt / (Max Worker Threads).
>>>>   >>>>
>>>>   >>>>    * sat:
>>>>   >>>>    Flag indicating if the server saturated in the past. Saturation
>>>> is
>>>>   >>>>    defined as: u% == 100%.
>>>>   >>>>
>>>>   >>>>    * usr%:
>>>>   >>>>    Percentage of the time the processor(s) spent in user space.
>>>>   >>>>
>>>>   >>>>    * sys%:
>>>>   >>>>    Percentage of the time the processor(s) spent in kernel space.
>>>>   >>>>
>>>>   >>>>    * idle%:
>>>>   >>>>    Percentage of the time the processor(s) was(were) idle.
>>>>   >>>>
>>>>   >>>>    - Requests:
>>>>   >>>>    For each type of request:
>>>>   >>>>    * %:
>>>>   >>>>    Percentage of that type of request.
>>>>   >>>>
>>>>   >>>>    * rbytes/s:
>>>>   >>>>    Number of bytes received per second.
>>>>   >>>>
>>>>   >>>>    * tbytes/s:
>>>>   >>>>    Number of bytes received per second.
>>>>   >>>>
>>>>   >>>>    * req/s:
>>>>   >>>>    Number of requests handled per second.
>>>>   >>>>
>>>>   >>>>    * rt-mean:
>>>>   >>>>    Average response time in seconds.
>>>>   >>>>
>>>>   >>>>    * rt-stddev:
>>>>   >>>>    Standard deviation of the response time.
>>>>   >>>>
>>>>   >>>>    To access this information the CLI smbstat must be modified and
>>>>   >>>>    allow the
>>>>   >>>>    following options:
>>>>   >>>>
>>>>   >>>>    -r Display the statistics of the requests.
>>>>   >>>>
>>>>   >>>>    -a Display the statistics of all the types of request (the 256 of
>>>>   >>>>    them) whether they are valid or not.
>>>>   >>>>
>>>>   >>>>    -n Display in alphabetic order.
>>>>   >>>>
>>>>   >>>>    -z Display the statistics of the requests actually received.
>>>>   >>>>
>>>>   >>>>    -t Display the throughput of the SMB/CIFS server.
>>>>   >>>>
>>>>   >>>>    -u Display the utilization of the SMB/CIFS server.
>>>>   >>>>
>>>>   >>>>    -c Display the counters.
>>>>   >>>>
>>>>   >>>>    A number can also be provided indicating the interval of time
>>>> between
>>>>   >>>>    refreshes. The first statistics displayed cover the time between
>>>> when
>>>>   >>>>    the server was started and the moment the statistics were
>>>> requested.
>>>>   >>>>    Subsequent refreshes cover the last time interval only.
>>>>   >>>>
>>>>   >>>>    It should be noted that the output is all new replacing the old
>>>> one and
>>>>   >>>>    is for humans only.
>>>>   >>>>
>>>>   >>>>    Examples of smbstat output:
>>>>   >>>>
>>>>   >>>>    '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
>>>>   >>>>
>>>>   >>>>    'smbstat -r'
>>>>   >>>>
>>>>   >>>>    code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>>>   >>>>    SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
>>>>   >>>>    SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
>>>>   >>>>    SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-
>>>> 07
>>>>   >>>>    SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00 0.000e+00
>>>>   >>>>    SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>>> 8.612e-06
>>>>   >>>>    SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00 0.000e+00
>>>>   >>>>    SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>>> 0.000e+00
>>>>   >>>>    SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>>> 0.000e+00
>>>>   >>>>    SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>>> 2.436e-05
>>>>   >>>>    SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-
>>>> 03
>>>>   >>>>    SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>    SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>>   >>>>    0.000e+00
>>>>   >>>>    SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>>> 0.000e+00
>>>>   >>>>
>>>>   >>>>    'smbstat -rz'
>>>>   >>>>
>>>>   >>>>    code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>>>   >>>>    SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
>>>>   >>>>    SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
>>>>   >>>>    SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
>>>>   >>>>    SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>>> 8.612e-06
>>>>   >>>>    SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>>> 0.000e+00
>>>>   >>>>    SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>>> 0.000e+00
>>>>   >>>>    SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>>> 2.436e-05
>>>>   >>>>    SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-
>>>> 03
>>>>   >>>>
>>>>   >>>>    6. Resources and Schedule
>>>>   >>>>    6.4. Steering Committee requested information
>>>>   >>>>    6.4.1. Consolidation C-team Name:
>>>>   >>>>    ON
>>>>   >>>>    6.5. ARC review type: FastTrack
>>>>   >>>>    6.6. ARC Exposure: open
>>>>
>>>
>>>
>>
>> _______________________________________________
>> opensolaris-arc mailing list
>> opensolaris-arc@opensolaris.org
>>


From alan.wright@oracle.com Fri Apr  9 01:01:49 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3981m7I001893
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 01:01:48 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3981m5R060166
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 02:01:48 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0L00M11NN02M00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 01:01:48 -0700 (PDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0L00ARKNMZNI40@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 01:01:47 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3981lOh001269	for
 <PSARC-ext@sun.com>; Fri, 09 Apr 2010 08:01:47 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o397D9da009952	for <PSARC-ext@sun.com>; Fri,
 09 Apr 2010 08:01:46 +0000 (GMT)
Received: from abhmt016.oracle.com by acsmt354.oracle.com	with ESMTP id
 148256831270800103; Fri, 09 Apr 2010 01:01:43 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Fri,
 09 Apr 2010 01:01:42 -0700
Date: Fri, 09 Apr 2010 01:01:17 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBE5D50.5060606@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBEDECD.3030100@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090204.4BBEDEEA.0127:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 15429

On 04/ 8/10 03:48 PM, Garrett D'Amore wrote:
> I'd still like a record of the kstats in this case, albeit with Project
> Private (or Uncommitted) binding.
>
> Why bother for Project Private interfaces? Because in this case the
> kstats are quite visible to end users (as are all kstats) via kstat(1M),
> and so I think its useful to record the fact that these are explicitly
> *not* supported. It will also help potential future developers who might
> need the information in the stats, although it will also underscore to
> them that any use will require a contract.
>
> So while the list isn't *required*, it *is* desired (by me at least).

I'm struggling to see the desire for this case to provide that
documentation.  This case is documenting a change in smbstat output.
The fact that the kstat API is used internally is an existing
internal implementation detail, and ARC'ing details of the
internal implementation between smbsrv and smbstat for the purpose
of having a specification for something whose use is unsupported
seems strange.

If another project wants to consume the kstats, it would seem better
to document them with the contract rather than live in a cycle of
having to repeatedly supersede this case with new cases on every
trivial change between smbsrv and smbstat, even when smbstat output
is unafffected.  That seems like unnecessary ARC noise.

Alan

> On 04/ 8/10 02:11 PM, Jose Borrego wrote:
>>
>>> -----Original Message-----
>>> From: Alan Wright [mailto:alan.wright@oracle.com]
>>> Sent: Thursday, April 08, 2010 12:38 PM
>>> To: Garrett D'Amore
>>> Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
>>> Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout
>>> 04/14/2010]
>>>
>>> On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
>>> > On 04/ 7/10 10:47 PM, Jordan Brown wrote:
>>> >> Garrett D'Amore wrote:
>>> >>>
>>> >>> What's missing is an interface table. I think though that based on
>>> >>> the statement that its not to be parsed ("for humans only"), the
>>> >>> output is not-an-interface.
>>> >>
>>> >> Yes. The stability is the same as the existing command:
>>> >>
>>> >> |_____________________________|_____________________________|
>>> >> | Interface Stability | Uncommitted |
>>> >> |_____________________________|_____________________________|
>>> >> | Utility Output Format | Not-an-Interface |
>>> >> |_____________________________|_____________________________|
>>> >>
>>> >
>>> > You haven't mentioned anything about underlying kstats. Is this how
>>> > these stats are implemented? Should that be covered under an ARC
>>> case as
>>> > well (perhaps this one)?
>>>
>>> smbstat has always created its output from undocumented kstats and,
>>> as with the interface stability, changing that wasn't part of this
>>> project. The purpose here is solely to expand and improve on the
>>> command output. The underlying kstats have not been considered for
>>> anything other than internal smbstat consumption. Publishing them,
>>> particularly if they may be used in scripts, without taking the
>>> change of scope into consideration and reviewing the design from
>>> that perspective is not a good idea.
>>>
>>> I'd prefer to take this as an RFE rather than delay/withdraw this
>>> case while we go back and review the project with a different scope.
>>>
>> This is a good point. Please indicate if everybody is okay with this.
>>
>>> --
>>>
>>> >>> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>>> >>>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>>> >>>> This information is Copyright (c) 2010, Oracle and/or its
>>> >>>> affiliates. All rights reserved.
>>> >>>> 1. Introduction
>>> >>>> 1.1. Project/Component Working Name:
>>> >>>> SMB/CIFS Statistics
>>> >>>> 1.2. Name of Document Author/Supplier:
>>> >>>> Author: Jose Borrego
>>> >>>> 1.3 Date of This Document:
>>> >>>> 07 April, 2010
>>> >>>>
>>> >>>> 1.4. Name of Major Document Customer(s)/Consumer(s):
>>> >>>> PSARC
>>> >>>> CIFS team
>>> >>>>
>>> >>>> 1.5. Email Aliases:
>>> >>>> 1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>> >>>> 1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>> >>>> 1.5.3. Marketing Manager:
>>> >>>> 1.5.4. Interest List: cifs-team@sun.com
>>> >>>>
>>> >>>> 4. Technical Description:
>>> >>>>
>>> >>>> Executive Summary:
>>> >>>>
>>> >>>> This case improves the statistics the SMB/CIFS server maintains
>>> as
>>> >>>> well as
>>> >>>> the output of smbstat.
>>> >>>>
>>> >>>> Problem:
>>> >>>>
>>> >>>> Currently the only statistics the SMB/CIFS server maintains are
>>> >>>> counters
>>> >>>> keeping track of how many requests of each type were received,
>>> the
>>> >>>> number
>>> >>>> of open files, the number of sessions (users logged in) and the
>>> >>>> number of
>>> >>>> connections (trees connected). Those statistics are not enough to
>>> >>>> describe
>>> >>>> the load being applied as well as how the server is responding to
>>> it.
>>> >>>>
>>> >>>> Solution:
>>> >>>>
>>> >>>> In order to get a better picture of the state of the SMB/CIFS
>>> server
>>> >>>> the
>>> >>>> following information can be maintained and provided through
>>> smbstat:
>>> >>>>
>>> >>>> - Counters:
>>> >>>> * nbt:
>>> >>>> Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>> >>>>
>>> >>>> * tcp:
>>> >>>> Number of SMB TCP sessions.
>>> >>>>
>>> >>>> * users:
>>> >>>> Number of users logged in.
>>> >>>>
>>> >>>> * trees:
>>> >>>> Number of trees connected.
>>> >>>>
>>> >>>> * files:
>>> >>>> Number of open files.
>>> >>>>
>>> >>>> * pipes:
>>> >>>> Number of open pipes.
>>> >>>>
>>> >>>> - Throughput:
>>> >>>> * rbytes/s:
>>> >>>> Number of bytes received per second.
>>> >>>>
>>> >>>> * tbytes/s:
>>> >>>> Number of bytes transmitted per second.
>>> >>>>
>>> >>>> * reqs/s:
>>> >>>> Number of requests handled per second.
>>> >>>>
>>> >>>> * reads/s:
>>> >>>> Number of read requests per second. This would be an aggregation
>>> of
>>> >>>> the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>> >>>> SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>> >>>>
>>> >>>> * writes/s:
>>> >>>> Number of write requests per second. This would ba an aggregation
>>> of
>>> >>>> the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>>> >>>> SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>> >>>>
>>> >>>> - Utilization:
>>> >>>> * wcnt:
>>> >>>> Average number of requests received but waiting for an SMB worker
>>> >>>> thread to execute them.
>>> >>>>
>>> >>>> * rcnt:
>>> >>>> Average number of requests being simultaneously executed by an
>>> SMB
>>> >>>> worker thread.
>>> >>>>
>>> >>>> * wtime:
>>> >>>> Average time a request waits before an SMB worker thread starts
>>> >>>> executing it.
>>> >>>>
>>> >>>> * rtime:
>>> >>>> Average execution time of a request.
>>> >>>>
>>> >>>> * w%:
>>> >>>> Percentage of the time during which at least one request was
>>> >>>> waiting.
>>> >>>>
>>> >>>> * r%:
>>> >>>> Percentage of the time during which at least one request was
>>> being
>>> >>>> executed.
>>> >>>>
>>> >>>> * u%:
>>> >>>> Percentage of utilization of the SMB/CIFS server. This number is
>>> >>>> defined as: rcnt / (Max Worker Threads).
>>> >>>>
>>> >>>> * sat:
>>> >>>> Flag indicating if the server saturated in the past. Saturation
>>> is
>>> >>>> defined as: u% == 100%.
>>> >>>>
>>> >>>> * usr%:
>>> >>>> Percentage of the time the processor(s) spent in user space.
>>> >>>>
>>> >>>> * sys%:
>>> >>>> Percentage of the time the processor(s) spent in kernel space.
>>> >>>>
>>> >>>> * idle%:
>>> >>>> Percentage of the time the processor(s) was(were) idle.
>>> >>>>
>>> >>>> - Requests:
>>> >>>> For each type of request:
>>> >>>> * %:
>>> >>>> Percentage of that type of request.
>>> >>>>
>>> >>>> * rbytes/s:
>>> >>>> Number of bytes received per second.
>>> >>>>
>>> >>>> * tbytes/s:
>>> >>>> Number of bytes received per second.
>>> >>>>
>>> >>>> * req/s:
>>> >>>> Number of requests handled per second.
>>> >>>>
>>> >>>> * rt-mean:
>>> >>>> Average response time in seconds.
>>> >>>>
>>> >>>> * rt-stddev:
>>> >>>> Standard deviation of the response time.
>>> >>>>
>>> >>>> To access this information the CLI smbstat must be modified and
>>> >>>> allow the
>>> >>>> following options:
>>> >>>>
>>> >>>> -r Display the statistics of the requests.
>>> >>>>
>>> >>>> -a Display the statistics of all the types of request (the 256 of
>>> >>>> them) whether they are valid or not.
>>> >>>>
>>> >>>> -n Display in alphabetic order.
>>> >>>>
>>> >>>> -z Display the statistics of the requests actually received.
>>> >>>>
>>> >>>> -t Display the throughput of the SMB/CIFS server.
>>> >>>>
>>> >>>> -u Display the utilization of the SMB/CIFS server.
>>> >>>>
>>> >>>> -c Display the counters.
>>> >>>>
>>> >>>> A number can also be provided indicating the interval of time
>>> between
>>> >>>> refreshes. The first statistics displayed cover the time between
>>> when
>>> >>>> the server was started and the moment the statistics were
>>> requested.
>>> >>>> Subsequent refreshes cover the last time interval only.
>>> >>>>
>>> >>>> It should be noted that the output is all new replacing the old
>>> one and
>>> >>>> is for humans only.
>>> >>>>
>>> >>>> Examples of smbstat output:
>>> >>>>
>>> >>>> '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
>>> >>>>
>>> >>>> 'smbstat -r'
>>> >>>>
>>> >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>> >>>> SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
>>> >>>> SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
>>> >>>> SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-
>>> 07
>>> >>>> SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00 0.000e+00
>>> >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>> 8.612e-06
>>> >>>> SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00 0.000e+00
>>> >>>> SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>> 0.000e+00
>>> >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>> 0.000e+00
>>> >>>> SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>> 2.436e-05
>>> >>>> SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-
>>> 03
>>> >>>> SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>>
>>> >>>> 'smbstat -rz'
>>> >>>>
>>> >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>> >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
>>> >>>> SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
>>> >>>> SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
>>> >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>> 8.612e-06
>>> >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>> 0.000e+00
>>> >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>> 0.000e+00
>>> >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>> 2.436e-05
>>> >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-
>>> 03
>>> >>>>
>>> >>>> 6. Resources and Schedule
>>> >>>> 6.4. Steering Committee requested information
>>> >>>> 6.4.1. Consolidation C-team Name:
>>> >>>> ON
>>> >>>> 6.5. ARC review type: FastTrack
>>> >>>> 6.6. ARC Exposure: open
>>
>


From alan.wright@oracle.com Fri Apr  9 01:01:50 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3981o5H001900
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 01:01:50 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3981mN4002420
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 01:01:49 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0L00G0XNN1B000@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 02:01:49 -0600 (MDT)
Received: from sca-ea-mail-1.sun.com ([192.18.43.24])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0L00AZENN0UBB0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 02:01:49 -0600 (MDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o3981mcE022500	for
 <PSARC-ext@sun.com>; Fri, 09 Apr 2010 08:01:48 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o397D9dc009952	for <PSARC-ext@sun.com>; Fri,
 09 Apr 2010 08:01:47 +0000 (GMT)
Received: from abhmt016.oracle.com by acsmt354.oracle.com	with ESMTP id
 148256831270800103; Fri, 09 Apr 2010 01:01:43 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Fri,
 09 Apr 2010 01:01:42 -0700
Date: Fri, 09 Apr 2010 01:01:17 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBE5D50.5060606@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: PSARC-ext@sun.com, smb-eng_ww@oracle.com
Message-id: <4BBEDECD.3030100@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090209.4BBEDEEB.0199:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 15429

On 04/ 8/10 03:48 PM, Garrett D'Amore wrote:
> I'd still like a record of the kstats in this case, albeit with Project
> Private (or Uncommitted) binding.
>
> Why bother for Project Private interfaces? Because in this case the
> kstats are quite visible to end users (as are all kstats) via kstat(1M),
> and so I think its useful to record the fact that these are explicitly
> *not* supported. It will also help potential future developers who might
> need the information in the stats, although it will also underscore to
> them that any use will require a contract.
>
> So while the list isn't *required*, it *is* desired (by me at least).

I'm struggling to see the desire for this case to provide that
documentation.  This case is documenting a change in smbstat output.
The fact that the kstat API is used internally is an existing
internal implementation detail, and ARC'ing details of the
internal implementation between smbsrv and smbstat for the purpose
of having a specification for something whose use is unsupported
seems strange.

If another project wants to consume the kstats, it would seem better
to document them with the contract rather than live in a cycle of
having to repeatedly supersede this case with new cases on every
trivial change between smbsrv and smbstat, even when smbstat output
is unafffected.  That seems like unnecessary ARC noise.

Alan

> On 04/ 8/10 02:11 PM, Jose Borrego wrote:
>>
>>> -----Original Message-----
>>> From: Alan Wright [mailto:alan.wright@oracle.com]
>>> Sent: Thursday, April 08, 2010 12:38 PM
>>> To: Garrett D'Amore
>>> Cc: PSARC-ext@sun.com; smb-eng_ww@oracle.com
>>> Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout
>>> 04/14/2010]
>>>
>>> On 04/ 7/10 10:59 PM, Garrett D'Amore wrote:
>>> > On 04/ 7/10 10:47 PM, Jordan Brown wrote:
>>> >> Garrett D'Amore wrote:
>>> >>>
>>> >>> What's missing is an interface table. I think though that based on
>>> >>> the statement that its not to be parsed ("for humans only"), the
>>> >>> output is not-an-interface.
>>> >>
>>> >> Yes. The stability is the same as the existing command:
>>> >>
>>> >> |_____________________________|_____________________________|
>>> >> | Interface Stability | Uncommitted |
>>> >> |_____________________________|_____________________________|
>>> >> | Utility Output Format | Not-an-Interface |
>>> >> |_____________________________|_____________________________|
>>> >>
>>> >
>>> > You haven't mentioned anything about underlying kstats. Is this how
>>> > these stats are implemented? Should that be covered under an ARC
>>> case as
>>> > well (perhaps this one)?
>>>
>>> smbstat has always created its output from undocumented kstats and,
>>> as with the interface stability, changing that wasn't part of this
>>> project. The purpose here is solely to expand and improve on the
>>> command output. The underlying kstats have not been considered for
>>> anything other than internal smbstat consumption. Publishing them,
>>> particularly if they may be used in scripts, without taking the
>>> change of scope into consideration and reviewing the design from
>>> that perspective is not a good idea.
>>>
>>> I'd prefer to take this as an RFE rather than delay/withdraw this
>>> case while we go back and review the project with a different scope.
>>>
>> This is a good point. Please indicate if everybody is okay with this.
>>
>>> --
>>>
>>> >>> On 04/ 7/10 05:51 PM, Jordan Brown wrote:
>>> >>>> Template Version: @(#)sac_nextcase 1.70 03/30/10 SMI
>>> >>>> This information is Copyright (c) 2010, Oracle and/or its
>>> >>>> affiliates. All rights reserved.
>>> >>>> 1. Introduction
>>> >>>> 1.1. Project/Component Working Name:
>>> >>>> SMB/CIFS Statistics
>>> >>>> 1.2. Name of Document Author/Supplier:
>>> >>>> Author: Jose Borrego
>>> >>>> 1.3 Date of This Document:
>>> >>>> 07 April, 2010
>>> >>>>
>>> >>>> 1.4. Name of Major Document Customer(s)/Consumer(s):
>>> >>>> PSARC
>>> >>>> CIFS team
>>> >>>>
>>> >>>> 1.5. Email Aliases:
>>> >>>> 1.5.1. Responsible Manager: Barry.Greenberg@Sun.COM
>>> >>>> 1.5.2. Responsible Engineer: Jose.Borrego@Sun.COM
>>> >>>> 1.5.3. Marketing Manager:
>>> >>>> 1.5.4. Interest List: cifs-team@sun.com
>>> >>>>
>>> >>>> 4. Technical Description:
>>> >>>>
>>> >>>> Executive Summary:
>>> >>>>
>>> >>>> This case improves the statistics the SMB/CIFS server maintains
>>> as
>>> >>>> well as
>>> >>>> the output of smbstat.
>>> >>>>
>>> >>>> Problem:
>>> >>>>
>>> >>>> Currently the only statistics the SMB/CIFS server maintains are
>>> >>>> counters
>>> >>>> keeping track of how many requests of each type were received,
>>> the
>>> >>>> number
>>> >>>> of open files, the number of sessions (users logged in) and the
>>> >>>> number of
>>> >>>> connections (trees connected). Those statistics are not enough to
>>> >>>> describe
>>> >>>> the load being applied as well as how the server is responding to
>>> it.
>>> >>>>
>>> >>>> Solution:
>>> >>>>
>>> >>>> In order to get a better picture of the state of the SMB/CIFS
>>> server
>>> >>>> the
>>> >>>> following information can be maintained and provided through
>>> smbstat:
>>> >>>>
>>> >>>> - Counters:
>>> >>>> * nbt:
>>> >>>> Number of SMB NetBIOS-over-TCP (NBT) sessions.
>>> >>>>
>>> >>>> * tcp:
>>> >>>> Number of SMB TCP sessions.
>>> >>>>
>>> >>>> * users:
>>> >>>> Number of users logged in.
>>> >>>>
>>> >>>> * trees:
>>> >>>> Number of trees connected.
>>> >>>>
>>> >>>> * files:
>>> >>>> Number of open files.
>>> >>>>
>>> >>>> * pipes:
>>> >>>> Number of open pipes.
>>> >>>>
>>> >>>> - Throughput:
>>> >>>> * rbytes/s:
>>> >>>> Number of bytes received per second.
>>> >>>>
>>> >>>> * tbytes/s:
>>> >>>> Number of bytes transmitted per second.
>>> >>>>
>>> >>>> * reqs/s:
>>> >>>> Number of requests handled per second.
>>> >>>>
>>> >>>> * reads/s:
>>> >>>> Number of read requests per second. This would be an aggregation
>>> of
>>> >>>> the following requests:SMB_COM_READ, SMB_COM_LOCK_AND_READ,
>>> >>>> SMB_COM_READ_RAW and SMB_COM_READ_ANDX.
>>> >>>>
>>> >>>> * writes/s:
>>> >>>> Number of write requests per second. This would ba an aggregation
>>> of
>>> >>>> the following requests: SMB_COM_WRITE, SMB_COM_WRITE_AND_UNLOCK,
>>> >>>> SMB_COM_WRITE_RAW and SMB_COM_WRITE_AND_CLOSE.
>>> >>>>
>>> >>>> - Utilization:
>>> >>>> * wcnt:
>>> >>>> Average number of requests received but waiting for an SMB worker
>>> >>>> thread to execute them.
>>> >>>>
>>> >>>> * rcnt:
>>> >>>> Average number of requests being simultaneously executed by an
>>> SMB
>>> >>>> worker thread.
>>> >>>>
>>> >>>> * wtime:
>>> >>>> Average time a request waits before an SMB worker thread starts
>>> >>>> executing it.
>>> >>>>
>>> >>>> * rtime:
>>> >>>> Average execution time of a request.
>>> >>>>
>>> >>>> * w%:
>>> >>>> Percentage of the time during which at least one request was
>>> >>>> waiting.
>>> >>>>
>>> >>>> * r%:
>>> >>>> Percentage of the time during which at least one request was
>>> being
>>> >>>> executed.
>>> >>>>
>>> >>>> * u%:
>>> >>>> Percentage of utilization of the SMB/CIFS server. This number is
>>> >>>> defined as: rcnt / (Max Worker Threads).
>>> >>>>
>>> >>>> * sat:
>>> >>>> Flag indicating if the server saturated in the past. Saturation
>>> is
>>> >>>> defined as: u% == 100%.
>>> >>>>
>>> >>>> * usr%:
>>> >>>> Percentage of the time the processor(s) spent in user space.
>>> >>>>
>>> >>>> * sys%:
>>> >>>> Percentage of the time the processor(s) spent in kernel space.
>>> >>>>
>>> >>>> * idle%:
>>> >>>> Percentage of the time the processor(s) was(were) idle.
>>> >>>>
>>> >>>> - Requests:
>>> >>>> For each type of request:
>>> >>>> * %:
>>> >>>> Percentage of that type of request.
>>> >>>>
>>> >>>> * rbytes/s:
>>> >>>> Number of bytes received per second.
>>> >>>>
>>> >>>> * tbytes/s:
>>> >>>> Number of bytes received per second.
>>> >>>>
>>> >>>> * req/s:
>>> >>>> Number of requests handled per second.
>>> >>>>
>>> >>>> * rt-mean:
>>> >>>> Average response time in seconds.
>>> >>>>
>>> >>>> * rt-stddev:
>>> >>>> Standard deviation of the response time.
>>> >>>>
>>> >>>> To access this information the CLI smbstat must be modified and
>>> >>>> allow the
>>> >>>> following options:
>>> >>>>
>>> >>>> -r Display the statistics of the requests.
>>> >>>>
>>> >>>> -a Display the statistics of all the types of request (the 256 of
>>> >>>> them) whether they are valid or not.
>>> >>>>
>>> >>>> -n Display in alphabetic order.
>>> >>>>
>>> >>>> -z Display the statistics of the requests actually received.
>>> >>>>
>>> >>>> -t Display the throughput of the SMB/CIFS server.
>>> >>>>
>>> >>>> -u Display the utilization of the SMB/CIFS server.
>>> >>>>
>>> >>>> -c Display the counters.
>>> >>>>
>>> >>>> A number can also be provided indicating the interval of time
>>> between
>>> >>>> refreshes. The first statistics displayed cover the time between
>>> when
>>> >>>> the server was started and the moment the statistics were
>>> requested.
>>> >>>> Subsequent refreshes cover the last time interval only.
>>> >>>>
>>> >>>> It should be noted that the output is all new replacing the old
>>> one and
>>> >>>> is for humans only.
>>> >>>>
>>> >>>> Examples of smbstat output:
>>> >>>>
>>> >>>> '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
>>> >>>>
>>> >>>> 'smbstat -r'
>>> >>>>
>>> >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>> >>>> SmbCreateDirectory 00 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbDeleteDirectory 01 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbOpen 02 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbCreate 03 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.496e-04 8.003e-06
>>> >>>> SmbFlush 05 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbDelete 06 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbRename 07 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbQueryInformation 08 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbSetInformation 09 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbRead 0A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbWrite 0B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbLockByteRange 0C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbUnlockByteRange 0D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbCreateTemporary 0E 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbCreateNew 0F 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbCheckDirectory 10 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbProcessExit 11 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbSeek 12 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbLockAndRead 13 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbWriteAndUnlock 14 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbReadRaw 1A 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbWriteRaw 1D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbSetInformation2 22 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbQueryInformation2 23 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbLockingX 24 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbTransaction 25 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbTransactionSecondary 26 0 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbIoctl 27 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbEcho 2B 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbWriteAndClose 2C 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbOpenX 2D 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbReadX 2E 0 0.000e+00 0.000e+00 0.000e+00 3.550e-04 1.856e-05
>>> >>>> SmbWriteX 2F 100 4.607e+02 1.675e+00 0.000e+00 3.893e-04 2.691e-
>>> 07
>>> >>>> SmbCloseAndTreeDisconnect 31 0 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00 0.000e+00
>>> >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>> 8.612e-06
>>> >>>> SmbTransaction2Secondary 33 0 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00 0.000e+00
>>> >>>> SmbFindClose2 34 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbTreeConnect 70 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbTreeDisconnect 71 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>> 0.000e+00
>>> >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>> 0.000e+00
>>> >>>> SmbLogoffX 74 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>> 2.436e-05
>>> >>>> SmbQueryInformationDisk 80 0 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbSearch 81 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbFind 82 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> SmbFindUnique 83 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbFindClose 84 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbNtTransact A0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbNtTransactSecondary A1 0 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 5.154e-02 2.063e-
>>> 03
>>> >>>> SmbNtCancel A4 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbNtRename A5 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbOpenPrintFile C0 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>> SmbWritePrintFile C1 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbClosePrintFile C2 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> >>>> 0.000e+00
>>> >>>> SmbGetPrintQueue C3 0 0.000e+00 0.000e+00 0.000e+00 0.000e+00
>>> 0.000e+00
>>> >>>>
>>> >>>> 'smbstat -rz'
>>> >>>>
>>> >>>> code % rbytes/s tbytes/s req/s rt-mean rt-stddev
>>> >>>> SmbClose 04 0 0.000e+00 0.000e+00 0.000e+00 2.445e-04 5.906e-06
>>> >>>> SmbReadX 2E 4 0.000e+00 2.772e+01 0.000e+00 1.556e-03 7.878e-06
>>> >>>> SmbWriteX 2F 96 7.162e+02 2.604e+00 0.000e+00 5.365e-04 3.913e-07
>>> >>>> SmbTransaction2 32 0 0.000e+00 0.000e+00 0.000e+00 5.203e-04
>>> 8.612e-06
>>> >>>> SmbNegotiate 72 0 0.000e+00 0.000e+00 0.000e+00 4.625e-05
>>> 0.000e+00
>>> >>>> SmbSessionSetupX 73 0 0.000e+00 0.000e+00 0.000e+00 1.145e-01
>>> 0.000e+00
>>> >>>> SmbTreeConnectX 75 0 0.000e+00 0.000e+00 0.000e+00 5.851e-04
>>> 2.436e-05
>>> >>>> SmbNtCreateX A2 0 0.000e+00 0.000e+00 0.000e+00 7.250e-02 2.304e-
>>> 03
>>> >>>>
>>> >>>> 6. Resources and Schedule
>>> >>>> 6.4. Steering Committee requested information
>>> >>>> 6.4.1. Consolidation C-team Name:
>>> >>>> ON
>>> >>>> 6.5. ARC review type: FastTrack
>>> >>>> 6.6. ARC Exposure: open
>>
>


From carlsonj@workingcode.com Fri Apr  9 05:51:26 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o39CpQ3d005789
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 05:51:26 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o39CpN8G014151
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 07:51:26 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0M00M0111P8100@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 05:51:25 -0700 (PDT)
Received: from sca-ea-mail-2.sun.com ([192.18.43.25])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0M00JZN11PVQ20@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 05:51:25 -0700 (PDT)
Received: from relay13i.sun.com
 (ip123.net129179-4.block1.us.syntegra.com [129.179.4.123])
	by sca-ea-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o39CkVPG022320	for
 <PSARC-ext@sun.com>; Fri, 09 Apr 2010 12:51:25 +0000 (GMT)
Received: from mmp13es.mmp.us.syntegra.com ([160.41.208.13] [160.41.208.13])
 by relay13i.sun.com with ESMTP id BT-MMP-3937315 for PSARC-ext@sun.com; Fri,
 09 Apr 2010 12:51:24 +0000 (Z)
Received: from relay14i.sun.com (relay14i.sun.com [129.179.4.124])
 by mmp13es.mmp.us.syntegra.com with ESMTP id BT-MMP-120106580 for
 PSARC-ext@sun.com; Fri, 09 Apr 2010 12:51:24 +0000 (Z)
Received: from carlson.workingcode.com ([75.150.68.97] [75.150.68.97])
 by relay1i.sun.com with ESMTP id BT-MMP-13980061 for PSARC-ext@sun.com; Fri,
 09 Apr 2010 12:51:24 +0000 (Z)
Received: from [75.150.68.97] (carlson [75.150.68.97])	(authenticated bits=0)
	by carlson.workingcode.com (8.14.2+Sun/8.14.4) with ESMTP id o39CpJ8h026875
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri,
 09 Apr 2010 08:51:20 -0400 (EDT)
Date: Fri, 09 Apr 2010 08:51:19 -0400
From: James Carlson <carlsonj@workingcode.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBEDECD.3030100@oracle.com>
To: Alan Wright <alan.wright@oracle.com>
Cc: "Garrett D'Amore" <garrett.damore@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBF22C7.4050906@workingcode.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Brightmail-Tracker: AAAAAA==
X-DCC-x.dcc-servers-Metrics: carlson; whitelist
X-Antispam: No, score=-0.7/5.0, scanned in 0.243sec at (localhost [127.0.0.1])
	by smf-spamd v1.3.1 - http://smfs.sf.net/
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 2722

On 04/09/10 04:01, Alan Wright wrote:
> On 04/ 8/10 03:48 PM, Garrett D'Amore wrote:
>> So while the list isn't *required*, it *is* desired (by me at least).
> 
> I'm struggling to see the desire for this case to provide that
> documentation.  This case is documenting a change in smbstat output.
> The fact that the kstat API is used internally is an existing
> internal implementation detail, and ARC'ing details of the
> internal implementation between smbsrv and smbstat for the purpose
> of having a specification for something whose use is unsupported
> seems strange.

I think it's really a nit (and much ado about nothing), but I agree with
Garrett.

The whole point of the "Private" ARC classification is that it
encompasses things that people can *see* in some manner but that they
should not *use*.  Where we have adequate and reasonable means of hiding
the interfaces (e.g., linker map files), they can become what's known as
"Internal" interfaces and may need no special handling.  Absent that (as
is the case with kstats), ARC documentation marking them as some flavor
of "Private" shows who should be using them.

It's true that "Project Private" things needn't be disclosed.  And it's
true that changes to "Project Private" things don't need ARC review.  So
you can just drive on and ignore the issue.

But the project team does get a benefit from going on-record to document
their "Project Private" interfaces.  If someone else -- completely
unbeknowst to you -- wants to use them, then the ARC can warn him away
appropriately and direct him to the proper alternative.  This happens
more often than you'd think.  There are many layered "Explorer" types of
tools around.

You get at least that by merely listing them; something that should take
no more than a few seconds' worth of effort.  If you do more, and
actually provide details, then more can be done.

The ARC also serves as a repository of high-level design information.
Long after you're gone, there may well be people who have to wander into
this area.  If there are copies of useful information in the ARC (often
the _only_ source of information after a big RIF), then that future
project team is in a better place, even if the information is somewhat
stale.

And it's often information that's useful to people exploring how to
build higher-level tools.

I think the ARC is effective only to the degree that project teams are
engaged in the process and contribute well.  If they hold back, the ARC
is going to be less effective than it could be.  There's nothing we can
do to prevent secrecy but observe that the ARC is (or at least has been)
an important commons.

-- 
James Carlson         42.703N 71.076W         <carlsonj@workingcode.com>

From jason.brian.king@gmail.com Fri Apr  9 06:51:57 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o39DpvkQ006559
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 06:51:57 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o39Dpvbv008265
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 06:51:57 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0M006073ULMV00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 07:51:57 -0600 (MDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0M00ER43UK13B0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 07:51:56 -0600 (MDT)
Received: from relay14i.sun.com
 (ip124.net129179-4.block1.us.syntegra.com [129.179.4.124])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o39DpuG8025250	for
 <PSARC-ext@sun.com>; Fri, 09 Apr 2010 13:51:56 +0000 (GMT)
Received: from mmp11es.mmp.us.syntegra.com ([160.41.208.11] [160.41.208.11])
 by relay14i.sun.com with ESMTP id BT-MMP-1469810 for PSARC-ext@sun.com; Fri,
 09 Apr 2010 13:49:56 +0000 (Z)
Received: from relay14i.sun.com (relay14i.sun.com [129.179.4.124])
 by mmp11es.mmp.us.syntegra.com with ESMTP id BT-MMP-122479073 for
 PSARC-ext@sun.com; Fri, 09 Apr 2010 13:49:36 +0000 (Z)
Received: from mail-pv0-f177.google.com ([74.125.83.177] [74.125.83.177])
 by relay1i.sun.com with ESMTP id BT-MMP-14124155 for PSARC-ext@sun.com; Fri,
 09 Apr 2010 13:49:36 +0000 (Z)
Received: by pvc30 with SMTP id 30so1529456pvc.8 for <PSARC-ext@sun.com>; Fri,
 09 Apr 2010 06:49:28 -0700 (PDT)
Received: by 10.142.211.8 with HTTP; Fri, 09 Apr 2010 06:49:27 -0700 (PDT)
Received: by 10.142.55.18 with SMTP id d18mr46620wfa.170.1270820968060; Fri,
 09 Apr 2010 06:49:28 -0700 (PDT)
Date: Fri, 09 Apr 2010 08:49:27 -0500
From: Jason King <jason@ansipunx.net>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBF22C7.4050906@workingcode.com>
Sender: jason.brian.king@gmail.com
To: James Carlson <carlsonj@workingcode.com>
Cc: Alan Wright <alan.wright@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com, "Garrett D'Amore" <garrett.damore@oracle.com>
Message-id: <u2kfa9202c31004090649v780dc4a9yb1ee96ae563ca4e7@mail.gmail.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;        d=gmail.com;
 s=gamma;        h=domainkey-signature:mime-version:sender:received:in-reply-to
         :references:date:x-google-sender-auth:received:message-id:subject
 :from:to:cc:content-type:content-transfer-encoding;
 bh=UQ/p4bK6BXtk8zLjhLi+T/hO10Ucj+7Pnt4uKFV/0Pw=;
 b=pvKclVu6PgwAfnDTtIYbjwlXLhrc1588GDfM8Z21sLwj/8cRKIfAWhgGDLVb8q6QMH
 EIa5TPnOPMGvqsciJadCfrTLptfS1ov8AABotd5unGDchM89nl0ZgYbR8fB5UIykq0hB
 ih2kfPdiZrj6VAf8rPNH2uGgTYXcZEQ32x5bs=
DomainKey-Signature: a=rsa-sha1; c=nofws;        d=gmail.com; s=gamma;
 h=mime-version:sender:in-reply-to:references:date
 :x-google-sender-auth:message-id:subject:from:to:cc:content-type
 :content-transfer-encoding;
 b=O47vjr/kXMJBOb0WAAAyFako7CPzlOOe/MlddnsEZYbzcMzCtByCTkJgYkN+99xK4I
 /omwE2oshbDx6EvzaxpIzokkJC006usgIjjbFLWcFQB0ZZUYcZwWzIbRLWsodr0zQB5T
 2uaqzYJiY+AgKSEhq9lLpr0mz/DZ4lxB8vLnc=
X-PMX-Version: 5.4.1.325704
X-Brightmail-Tracker: AAAAAA==
X-Google-Sender-Auth: a5bb7fd2e6fdcc44
X-Antispam: No, score=-2.6/5.0, scanned in 0.089sec at (localhost [127.0.0.1])
	by smf-spamd v1.3.1 - http://smfs.sf.net/
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com>
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from quoted-printable to 8bit by sac.sfbay.sun.com id o39DpvkQ006559
Status: RO
Content-Length: 3353

On Fri, Apr 9, 2010 at 7:51 AM, James Carlson <carlsonj@workingcode.com> wrote:
> On 04/09/10 04:01, Alan Wright wrote:
>> On 04/ 8/10 03:48 PM, Garrett D'Amore wrote:
>>> So while the list isn't *required*, it *is* desired (by me at least).
>>
>> I'm struggling to see the desire for this case to provide that
>> documentation.  This case is documenting a change in smbstat output.
>> The fact that the kstat API is used internally is an existing
>> internal implementation detail, and ARC'ing details of the
>> internal implementation between smbsrv and smbstat for the purpose
>> of having a specification for something whose use is unsupported
>> seems strange.
>
> I think it's really a nit (and much ado about nothing), but I agree with
> Garrett.
>
> The whole point of the "Private" ARC classification is that it
> encompasses things that people can *see* in some manner but that they
> should not *use*.  Where we have adequate and reasonable means of hiding
> the interfaces (e.g., linker map files), they can become what's known as
> "Internal" interfaces and may need no special handling.  Absent that (as
> is the case with kstats), ARC documentation marking them as some flavor
> of "Private" shows who should be using them.
>
> It's true that "Project Private" things needn't be disclosed.  And it's
> true that changes to "Project Private" things don't need ARC review.  So
> you can just drive on and ignore the issue.
>
> But the project team does get a benefit from going on-record to document
> their "Project Private" interfaces.  If someone else -- completely
> unbeknowst to you -- wants to use them, then the ARC can warn him away
> appropriately and direct him to the proper alternative.  This happens
> more often than you'd think.  There are many layered "Explorer" types of
> tools around.
>
> You get at least that by merely listing them; something that should take
> no more than a few seconds' worth of effort.  If you do more, and
> actually provide details, then more can be done.
>
> The ARC also serves as a repository of high-level design information.
> Long after you're gone, there may well be people who have to wander into
> this area.  If there are copies of useful information in the ARC (often
> the _only_ source of information after a big RIF), then that future
> project team is in a better place, even if the information is somewhat
> stale.
>
> And it's often information that's useful to people exploring how to
> build higher-level tools.
>
> I think the ARC is effective only to the degree that project teams are
> engaged in the process and contribute well.  If they hold back, the ARC
> is going to be less effective than it could be.  There's nothing we can
> do to prevent secrecy but observe that the ARC is (or at least has been)
> an important commons.
>
> --
> James Carlson         42.703N 71.076W         <carlsonj@workingcode.com>

Exactly, and with kstats (at least), they are going to be used
regardless (witness net-snmp -- I'm pretty sure every kstat it
consumes -- which is a lot -- are all classified as private) since
often there is no alternative.  Having some documentation gives those
of aren't Sun employees a starting point to try to do the right thing
(i.e. find the right people, talk about raising the classification as
needed for a project, etc.) instead of just giving up.


From Jordan.Brown@oracle.com Fri Apr  9 09:55:59 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o39GtxGE010266
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 09:55:59 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o39GtuLD026814
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 11:55:59 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0M0042DCDA2000@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 09:55:58 -0700 (PDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0M005H8CD84370@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 09:55:57 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o39GtuOm000763	for
 <PSARC-ext@sun.com>; Fri, 09 Apr 2010 16:55:56 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o39GQdqb026626	for <PSARC-ext@sun.com>; Fri,
 09 Apr 2010 16:55:54 +0000 (GMT)
Received: from abhmt017.oracle.com by acsmt355.oracle.com	with ESMTP id
 162143871270832141; Fri, 09 Apr 2010 09:55:41 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Fri,
 09 Apr 2010 09:55:41 -0700
Date: Fri, 09 Apr 2010 09:55:40 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBEDECD.3030100@oracle.com>
To: Alan Wright <alan.wright@oracle.com>
Cc: "Garrett D'Amore" <garrett.damore@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBF5C0C.2040105@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090206.4BBF5C1B.011D:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 276

It appears that smb-eng_ww@oracle.com doesn't get the messages that 
originate outside the company.  We'll have to figure out how to address 
that, but in the meantime those who are interested might want to review 
the message log at
    http://sac.sfbay/PSARC/2010/120/mail


From Jordan.Brown@oracle.com Fri Apr  9 09:56:00 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o39Gu0lw010270
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 09:56:00 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o39Gu0nX002028
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 10:56:00 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0M0042VCDC2000@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 09:56:00 -0700 (PDT)
Received: from sca-ea-mail-2.sun.com ([192.18.43.25])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0M005HKCDB4370@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 09:55:59 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by sca-ea-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o39Gtwhr003459	for
 <PSARC-ext@sun.com>; Fri, 09 Apr 2010 16:55:58 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o39GQdqd026626	for <PSARC-ext@sun.com>; Fri,
 09 Apr 2010 16:55:57 +0000 (GMT)
Received: from abhmt017.oracle.com by acsmt355.oracle.com	with ESMTP id
 162143871270832141; Fri, 09 Apr 2010 09:55:41 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Fri,
 09 Apr 2010 09:55:41 -0700
Date: Fri, 09 Apr 2010 09:55:40 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBEDECD.3030100@oracle.com>
To: Alan Wright <alan.wright@oracle.com>
Cc: "Garrett D'Amore" <garrett.damore@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBF5C0C.2040105@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090203.4BBF5C1E.001D:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 276

It appears that smb-eng_ww@oracle.com doesn't get the messages that 
originate outside the company.  We'll have to figure out how to address 
that, but in the meantime those who are interested might want to review 
the message log at
    http://sac.sfbay/PSARC/2010/120/mail


From alan.wright@oracle.com Fri Apr  9 17:44:29 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3A0iTDk018383
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 17:44:29 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3A0iTDf055113
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 18:44:29 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0M00L05Y25UR00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 17:44:29 -0700 (PDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0M007YLY24YQ70@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 17:44:29 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3A0iRAs000924	for
 <PSARC-ext@sun.com>; Sat, 10 Apr 2010 00:44:28 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3A0aMkf001273	for <PSARC-ext@sun.com>; Sat,
 10 Apr 2010 00:44:27 +0000 (GMT)
Received: from abhmt015.oracle.com by acsmt355.oracle.com	with ESMTP id
 150431851270860266; Fri, 09 Apr 2010 17:44:26 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Fri,
 09 Apr 2010 17:44:26 -0700
Date: Fri, 09 Apr 2010 17:44:00 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBF22C7.4050906@workingcode.com>
To: James Carlson <carlsonj@workingcode.com>
Cc: "Garrett D'Amore" <garrett.damore@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBFC9D0.5050107@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A0B0209.4BBFC9EB.0112:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 3501

On 04/ 9/10 05:51 AM, James Carlson wrote:
> On 04/09/10 04:01, Alan Wright wrote:
>> On 04/ 8/10 03:48 PM, Garrett D'Amore wrote:
>>> So while the list isn't *required*, it *is* desired (by me at least).
>>
>> I'm struggling to see the desire for this case to provide that
>> documentation.  This case is documenting a change in smbstat output.
>> The fact that the kstat API is used internally is an existing
>> internal implementation detail, and ARC'ing details of the
>> internal implementation between smbsrv and smbstat for the purpose
>> of having a specification for something whose use is unsupported
>> seems strange.
>
> I think it's really a nit (and much ado about nothing), but I agree with
> Garrett.
>
> The whole point of the "Private" ARC classification is that it
> encompasses things that people can *see* in some manner but that they
> should not *use*.  Where we have adequate and reasonable means of hiding
> the interfaces (e.g., linker map files), they can become what's known as
> "Internal" interfaces and may need no special handling.  Absent that (as
> is the case with kstats), ARC documentation marking them as some flavor
> of "Private" shows who should be using them.
>
> It's true that "Project Private" things needn't be disclosed.  And it's
> true that changes to "Project Private" things don't need ARC review.  So
> you can just drive on and ignore the issue.
>
> But the project team does get a benefit from going on-record to document
> their "Project Private" interfaces.  If someone else -- completely
> unbeknowst to you -- wants to use them, then the ARC can warn him away
> appropriately and direct him to the proper alternative.  This happens
> more often than you'd think.  There are many layered "Explorer" types of
> tools around.
>
> You get at least that by merely listing them; something that should take
> no more than a few seconds' worth of effort.  If you do more, and
> actually provide details, then more can be done.
>
> The ARC also serves as a repository of high-level design information.
> Long after you're gone, there may well be people who have to wander into
> this area.  If there are copies of useful information in the ARC (often
> the _only_ source of information after a big RIF), then that future
> project team is in a better place, even if the information is somewhat
> stale.
>
> And it's often information that's useful to people exploring how to
> build higher-level tools.
>
> I think the ARC is effective only to the degree that project teams are
> engaged in the process and contribute well.  If they hold back, the ARC
> is going to be less effective than it could be.  There's nothing we can
> do to prevent secrecy but observe that the ARC is (or at least has been)
> an important commons.

I honestly can't see what value a list would add to this case.
The examples in the case material provide way more information
than such a list because they provide context, and one can
always obtain a list by running kstat at the command line.

If an interface table is desirable, how about:

   Interfaces
   ________________________________________________________________
   | Imported Interface     | Classification    | Comments         |
   |________________________|___________________|__________________|
   | smbsrv kstats          | Project           |                  |
   |                        | Private           |                  |
   |________________________|___________________|__________________|

Alan

From alan.wright@oracle.com Fri Apr  9 17:44:30 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3A0iUE5018387
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 17:44:30 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3A0iUed016380
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 17:44:30 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0M00K01Y26X300@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 17:44:30 -0700 (PDT)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0M00MBVY24AQ90@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 17:44:30 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3A0iS1L011495	for
 <PSARC-ext@sun.com>; Sat, 10 Apr 2010 00:44:28 +0000 (GMT)
Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3A0aMkh001273	for <PSARC-ext@sun.com>; Sat,
 10 Apr 2010 00:44:28 +0000 (GMT)
Received: from abhmt015.oracle.com by acsmt355.oracle.com	with ESMTP id
 150431851270860266; Fri, 09 Apr 2010 17:44:26 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Fri,
 09 Apr 2010 17:44:26 -0700
Date: Fri, 09 Apr 2010 17:44:00 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBF22C7.4050906@workingcode.com>
To: James Carlson <carlsonj@workingcode.com>
Cc: "Garrett D'Amore" <garrett.damore@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBFC9D0.5050107@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt354.oracle.com [141.146.40.154]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A0B0206.4BBFC9EC.0078:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 3501

On 04/ 9/10 05:51 AM, James Carlson wrote:
> On 04/09/10 04:01, Alan Wright wrote:
>> On 04/ 8/10 03:48 PM, Garrett D'Amore wrote:
>>> So while the list isn't *required*, it *is* desired (by me at least).
>>
>> I'm struggling to see the desire for this case to provide that
>> documentation.  This case is documenting a change in smbstat output.
>> The fact that the kstat API is used internally is an existing
>> internal implementation detail, and ARC'ing details of the
>> internal implementation between smbsrv and smbstat for the purpose
>> of having a specification for something whose use is unsupported
>> seems strange.
>
> I think it's really a nit (and much ado about nothing), but I agree with
> Garrett.
>
> The whole point of the "Private" ARC classification is that it
> encompasses things that people can *see* in some manner but that they
> should not *use*.  Where we have adequate and reasonable means of hiding
> the interfaces (e.g., linker map files), they can become what's known as
> "Internal" interfaces and may need no special handling.  Absent that (as
> is the case with kstats), ARC documentation marking them as some flavor
> of "Private" shows who should be using them.
>
> It's true that "Project Private" things needn't be disclosed.  And it's
> true that changes to "Project Private" things don't need ARC review.  So
> you can just drive on and ignore the issue.
>
> But the project team does get a benefit from going on-record to document
> their "Project Private" interfaces.  If someone else -- completely
> unbeknowst to you -- wants to use them, then the ARC can warn him away
> appropriately and direct him to the proper alternative.  This happens
> more often than you'd think.  There are many layered "Explorer" types of
> tools around.
>
> You get at least that by merely listing them; something that should take
> no more than a few seconds' worth of effort.  If you do more, and
> actually provide details, then more can be done.
>
> The ARC also serves as a repository of high-level design information.
> Long after you're gone, there may well be people who have to wander into
> this area.  If there are copies of useful information in the ARC (often
> the _only_ source of information after a big RIF), then that future
> project team is in a better place, even if the information is somewhat
> stale.
>
> And it's often information that's useful to people exploring how to
> build higher-level tools.
>
> I think the ARC is effective only to the degree that project teams are
> engaged in the process and contribute well.  If they hold back, the ARC
> is going to be less effective than it could be.  There's nothing we can
> do to prevent secrecy but observe that the ARC is (or at least has been)
> an important commons.

I honestly can't see what value a list would add to this case.
The examples in the case material provide way more information
than such a list because they provide context, and one can
always obtain a list by running kstat at the command line.

If an interface table is desirable, how about:

   Interfaces
   ________________________________________________________________
   | Imported Interface     | Classification    | Comments         |
   |________________________|___________________|__________________|
   | smbsrv kstats          | Project           |                  |
   |                        | Private           |                  |
   |________________________|___________________|__________________|

Alan

From Jordan.Brown@oracle.com Fri Apr  9 21:52:11 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3A4qB3K020924
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 21:52:11 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3A4q67L060617
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 22:52:11 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0N00H019IZZL00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 21:52:11 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0N007DG9IXYOF0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 21:52:10 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3A4q9Xn020508	for
 <PSARC-ext@sun.com>; Sat, 10 Apr 2010 04:52:09 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3A4eY0T009722	for <PSARC-ext@sun.com>; Sat,
 10 Apr 2010 04:52:08 +0000 (GMT)
Received: from abhmt021.oracle.com by acsmt355.oracle.com	with ESMTP id
 163223471270860475; Fri, 09 Apr 2010 17:47:55 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Fri,
 09 Apr 2010 17:47:55 -0700
Date: Fri, 09 Apr 2010 17:47:54 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBFC9D0.5050107@oracle.com>
To: Alan Wright <alan.wright@oracle.com>
Cc: James Carlson <carlsonj@workingcode.com>,
        "Garrett D'Amore" <garrett.damore@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBFCABA.4050005@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090207.4BC003F8.012B:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 548

Alan Wright wrote:
> I honestly can't see what value a list would add to this case. 

I agree.  Note also that some have held that once you have put a Project 
Private interface into an ARC case, you must run an ARC case to make any 
changes to it.  That seems like inappropriate overhead and a good reason 
to avoid including anything you don't have to.

(If somebody on the ARC wants to say "No, that's not true, you don't 
have to do that", that would be great.  I still wouldn't understand the 
benefit, but at least that cost would go away.)


From Jordan.Brown@oracle.com Fri Apr  9 21:52:12 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3A4qBr8020925
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 9 Apr 2010 21:52:11 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3A4q67N060617
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 9 Apr 2010 22:52:11 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0N00H039IZZL00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 09 Apr 2010 21:52:11 -0700 (PDT)
Received: from sca-ea-mail-4.sun.com ([192.18.43.22])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0N007DQ9IYYOF0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 09 Apr 2010 21:52:10 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3A4q9UF000387	for
 <PSARC-ext@sun.com>; Sat, 10 Apr 2010 04:52:10 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3A4eY0V009722	for <PSARC-ext@sun.com>; Sat,
 10 Apr 2010 04:52:09 +0000 (GMT)
Received: from abhmt021.oracle.com by acsmt355.oracle.com	with ESMTP id
 163223471270860475; Fri, 09 Apr 2010 17:47:55 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Fri,
 09 Apr 2010 17:47:55 -0700
Date: Fri, 09 Apr 2010 17:47:54 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBFC9D0.5050107@oracle.com>
To: Alan Wright <alan.wright@oracle.com>
Cc: James Carlson <carlsonj@workingcode.com>,
        "Garrett D'Amore" <garrett.damore@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BBFCABA.4050005@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090207.4BC003F9.005D:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 548

Alan Wright wrote:
> I honestly can't see what value a list would add to this case. 

I agree.  Note also that some have held that once you have put a Project 
Private interface into an ARC case, you must run an ARC case to make any 
changes to it.  That seems like inappropriate overhead and a good reason 
to avoid including anything you don't have to.

(If somebody on the ARC wants to say "No, that's not true, you don't 
have to do that", that would be great.  I still wouldn't understand the 
benefit, but at least that cost would go away.)


From garrett.damore@oracle.com Sat Apr 10 06:56:59 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3ADuwvq014401
	for <psarc-ext@sac.sfbay.sun.com>; Sat, 10 Apr 2010 06:56:59 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3ADuw53020942
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Sat, 10 Apr 2010 07:56:58 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0N00F03YQYQ900@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Sat, 10 Apr 2010 06:56:58 -0700 (PDT)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0N00JBKYQXY7E0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Sat,
 10 Apr 2010 06:56:58 -0700 (PDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3ADuvbW014491	for
 <PSARC-ext@sun.com>; Sat, 10 Apr 2010 13:56:57 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3ADuuhU031572	for <PSARC-ext@sun.com>; Sat,
 10 Apr 2010 13:56:56 +0000 (GMT)
Received: from abhmt020.oracle.com by acsmt354.oracle.com	with ESMTP id
 150931051270907813; Sat, 10 Apr 2010 06:56:53 -0700
Received: from localhost (/174.192.27.188)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Sat,
 10 Apr 2010 06:56:53 -0700
Date: Sat, 10 Apr 2010 06:56:59 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
To: Jordan Brown <Jordan.Brown@oracle.com>,
        Alan Wright <alan.wright@oracle.com>
Cc: James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <46xitfxlok0c61b83s89m99b.1270907819236@email.android.com>
MIME-version: 1.0
Content-type: text/plain; charset=utf-8
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090209.4BC083A9.0039:SCFMA4539814,ss=1,fgs=0
Status: RO
Content-Length: 776

I think you should file changes, but can do so with a self-review case or even just an email update to the original case.  So not free, but really cheap.

  -- Garrett

Jordan Brown <Jordan.Brown@oracle.com> wrote:

>Alan Wright wrote:
>> I honestly can't see what value a list would add to this case. 
>
>I agree.  Note also that some have held that once you have put a Project 
>Private interface into an ARC case, you must run an ARC case to make any 
>changes to it.  That seems like inappropriate overhead and a good reason 
>to avoid including anything you don't have to.
>
>(If somebody on the ARC wants to say "No, that's not true, you don't 
>have to do that", that would be great.  I still wouldn't understand the 
>benefit, but at least that cost would go away.)
>

From garrett.damore@oracle.com Sat Apr 10 06:56:59 2010
Received: from sunmail6brm.central.sun.com (sunmail6brm.Central.Sun.COM [129.147.4.169])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3ADuxjN014404
	for <psarc-ext@sac.sfbay.sun.com>; Sat, 10 Apr 2010 06:56:59 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail6brm.central.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3ADuxkV027773
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Sat, 10 Apr 2010 08:56:59 -0500 (CDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0N00C01YQY8J00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Sat, 10 Apr 2010 06:56:58 -0700 (PDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0N003V3YQYSI30@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Sat,
 10 Apr 2010 06:56:58 -0700 (PDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3ADuvqZ003008	for
 <PSARC-ext@sun.com>; Sat, 10 Apr 2010 13:56:57 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3ADuuhW031572	for <PSARC-ext@sun.com>; Sat,
 10 Apr 2010 13:56:57 +0000 (GMT)
Received: from abhmt020.oracle.com by acsmt354.oracle.com	with ESMTP id
 150931051270907813; Sat, 10 Apr 2010 06:56:53 -0700
Received: from localhost (/174.192.27.188)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Sat,
 10 Apr 2010 06:56:53 -0700
Date: Sat, 10 Apr 2010 06:56:59 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
To: Jordan Brown <Jordan.Brown@oracle.com>,
        Alan Wright <alan.wright@oracle.com>
Cc: James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <46xitfxlok0c61b83s89m99b.1270907819236@email.android.com>
MIME-version: 1.0
Content-type: text/plain; charset=utf-8
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090203.4BC083A9.00C6:SCFMA4539814,ss=1,fgs=0
Status: RO
Content-Length: 776

I think you should file changes, but can do so with a self-review case or even just an email update to the original case.  So not free, but really cheap.

  -- Garrett

Jordan Brown <Jordan.Brown@oracle.com> wrote:

>Alan Wright wrote:
>> I honestly can't see what value a list would add to this case. 
>
>I agree.  Note also that some have held that once you have put a Project 
>Private interface into an ARC case, you must run an ARC case to make any 
>changes to it.  That seems like inappropriate overhead and a good reason 
>to avoid including anything you don't have to.
>
>(If somebody on the ARC wants to say "No, that's not true, you don't 
>have to do that", that would be great.  I still wouldn't understand the 
>benefit, but at least that cost would go away.)
>

From carlsonj@workingcode.com Sat Apr 10 09:05:25 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3AG5P1a015795
	for <psarc-ext@sac.sfbay.sun.com>; Sat, 10 Apr 2010 09:05:25 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3AG5Ov2028192
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Sat, 10 Apr 2010 09:05:25 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0O00M094P00600@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Sat, 10 Apr 2010 10:05:24 -0600 (MDT)
Received: from sca-ea-mail-1.sun.com ([192.18.43.24])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0O000IL4P0ATD0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Sat,
 10 Apr 2010 10:05:24 -0600 (MDT)
Received: from relay13i.sun.com
 (ip123.net129179-4.block1.us.syntegra.com [129.179.4.123])
	by sca-ea-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o3AG09w6026425	for
 <PSARC-ext@sun.com>; Sat, 10 Apr 2010 16:05:23 +0000 (GMT)
Received: from mmp11es.mmp.us.syntegra.com ([160.41.208.11] [160.41.208.11])
 by relay13i.sun.com with ESMTP id BT-MMP-3990040 for PSARC-ext@sun.com; Sat,
 10 Apr 2010 16:05:23 +0000 (Z)
Received: from relay14i.sun.com (relay14i.sun.com [129.179.4.124])
 by mmp11es.mmp.us.syntegra.com with ESMTP id BT-MMP-125057194 for
 PSARC-ext@sun.com; Sat, 10 Apr 2010 16:05:22 +0000 (Z)
Received: from carlson.workingcode.com ([75.150.68.97] [75.150.68.97])
 by relay1i.sun.com with ESMTP id BT-MMP-16882240 for PSARC-ext@sun.com; Sat,
 10 Apr 2010 16:05:22 +0000 (Z)
Received: from [75.150.68.97] (carlson [75.150.68.97])	(authenticated bits=0)
	by carlson.workingcode.com (8.14.2+Sun/8.14.4) with ESMTP id o3AG5A3d010960
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sat,
 10 Apr 2010 12:05:10 -0400 (EDT)
Date: Sat, 10 Apr 2010 12:05:09 -0400
From: James Carlson <carlsonj@workingcode.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <46xitfxlok0c61b83s89m99b.1270907819236@email.android.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: Jordan Brown <Jordan.Brown@oracle.com>,
        Alan Wright <alan.wright@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC0A1B5.5050208@workingcode.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Brightmail-Tracker: AAAAAA==
X-DCC-dmv.com-Metrics: carlson; whitelist
X-Antispam: No, score=0.0/5.0, scanned in 0.152sec at (localhost [127.0.0.1])
	by smf-spamd v1.3.1 - http://smfs.sf.net/
References: <46xitfxlok0c61b83s89m99b.1270907819236@email.android.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 1279

On 04/10/10 09:56, Garrett D'Amore wrote:
> I think you should file changes, but can do so with a self-review case or even just an email update to the original case.  So not free, but really cheap.
> 
>   -- Garrett

What the ARC Interface Taxonomy actually says about Project Private is this:

  Once an interface is classified Project Private by an ARC, changes
  to that interface need not be ARC approved.

So, no, it's not necessary to get ARC approval or notify the ARC in any
way if there are changes to a Project Private interface.  You can do it
(and in some cases I'd encourage it), but there's no requirement.

For other forms of "Private," you generally tell the ARC when you're
establishing the interface what you expect to do in the future --
whether you'll bring changes to the ARC, change without ARC review, or
whatever, provided that you can explain how the users will adapt.

Thus, the absolute minimum you could do would look like this:

	"We have some kstats that look like 'foo_*' and are all
	Project Private."

And then never mention it again.  Doing more than the minimum necessary
would be nice, but the ARC has no ability to compel project team action.
 It's a review body.

-- 
James Carlson         42.703N 71.076W         <carlsonj@workingcode.com>

From brian.utterback@oracle.com Sat Apr 10 15:59:58 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3AMxwIg019571
	for <psarc-ext@sac.sfbay.sun.com>; Sat, 10 Apr 2010 15:59:58 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3AMxvdn022225
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Sat, 10 Apr 2010 15:59:57 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0O00205NVXOY00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Sat, 10 Apr 2010 16:59:57 -0600 (MDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0O00033NVWDV40@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Sat,
 10 Apr 2010 16:59:57 -0600 (MDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3AMxuAk028107	for
 <PSARC-ext@sun.com>; Sat, 10 Apr 2010 22:59:56 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3AMxtqh026121	for <PSARC-ext@sun.com>; Sat,
 10 Apr 2010 22:59:55 +0000 (GMT)
Received: from abhmt009.oracle.com by acsmt353.oracle.com	with ESMTP id
 164220861270940392; Sat, 10 Apr 2010 15:59:52 -0700
Received: from [129.148.9.178] (/129.148.9.178)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Sat,
 10 Apr 2010 15:59:52 -0700
Date: Sat, 10 Apr 2010 18:59:50 -0400
From: Brian Utterback <brian.utterback@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBFC9D0.5050107@oracle.com>
To: Alan Wright <alan.wright@oracle.com>
Cc: James Carlson <carlsonj@workingcode.com>,
        "Garrett D'Amore" <garrett.damore@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC102E6.2070802@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090209.4BC102EC.0048:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS sun4v; en-US; rv:1.9.1.9) Gecko/20100318
 Lightning/1.0b1 Thunderbird/3.0.4
Status: RO
Content-Length: 2341

On 04/09/10 20:44, Alan Wright wrote:
> I honestly can't see what value a list would add to this case.
> The examples in the case material provide way more information
> than such a list because they provide context, and one can
> always obtain a list by running kstat at the command line.
>
> If an interface table is desirable, how about:
>
>   Interfaces
>   ________________________________________________________________
>   | Imported Interface     | Classification    | Comments         |
>   |________________________|___________________|__________________|
>   | smbsrv kstats          | Project           |                  |
>   |                        | Private           |                  |
>   |________________________|___________________|__________________|
>
> Alan

Did you name the stats you are using something opaque or something
vaguely intelligible? I am going to guess the latter. So, we know that
the kstat output was explicitly designed to be machine readable, i.e.
able to be an interface. So, with library interfaces we have man pages
to tell us what each is and we know if there doesn't exist a man page,
then that interface is private. Tell me, where is the list of public
kstats? As a programmer, I see something I would like to use in the
kstats output, and looking at the source code I see that it tallies
exactly what I need. How do I find out if it is public or private? I
might plug it into Google and see what I get. If you don't list it in
your proposal, then I get nothing, or just where it is found in the
source code. If you do list it, then the single hit that is not in the
source code is going to be your table, where it is clearly listed as
private. Darn, I am out of luck.

Unless and until we get a standard set of docs that definitively lists
what is public, then in proposals like this one is the only place these
interfaces are documented. You don't have to do this now, when you
integrate make a list from the kstat output and send it so it gets added
to the mail file. How hard is that?

-- 
blu

It's bad civic hygiene to build technologies that could someday be
used to facilitate a police state. - Bruce Schneier
----------------------------------------------------------------------
Brian Utterback - Solaris RPE, Oracle Corporation.
Ph:877-259-7345, Em:brian.utterback@oracle.com


From brian.utterback@oracle.com Sat Apr 10 15:59:58 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3AMxwsS019574
	for <psarc-ext@sac.sfbay.sun.com>; Sat, 10 Apr 2010 15:59:58 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3AMxvMx039529
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Sat, 10 Apr 2010 16:59:57 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0O00205NVXS200@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Sat, 10 Apr 2010 15:59:57 -0700 (PDT)
Received: from sca-ea-mail-3.sun.com ([192.18.43.21])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0O00GNPNVWYUA0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Sat,
 10 Apr 2010 15:59:56 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3AMxtOv020901	for
 <PSARC-ext@sun.com>; Sat, 10 Apr 2010 22:59:56 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3AMxtqf026121	for <PSARC-ext@sun.com>; Sat,
 10 Apr 2010 22:59:55 +0000 (GMT)
Received: from abhmt009.oracle.com by acsmt353.oracle.com	with ESMTP id
 164220861270940392; Sat, 10 Apr 2010 15:59:52 -0700
Received: from [129.148.9.178] (/129.148.9.178)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Sat,
 10 Apr 2010 15:59:52 -0700
Date: Sat, 10 Apr 2010 18:59:50 -0400
From: Brian Utterback <brian.utterback@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBFC9D0.5050107@oracle.com>
To: Alan Wright <alan.wright@oracle.com>
Cc: James Carlson <carlsonj@workingcode.com>,
        "Garrett D'Amore" <garrett.damore@oracle.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC102E6.2070802@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090207.4BC102EB.014C:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS sun4v; en-US; rv:1.9.1.9) Gecko/20100318
 Lightning/1.0b1 Thunderbird/3.0.4
Status: RO
Content-Length: 2341

On 04/09/10 20:44, Alan Wright wrote:
> I honestly can't see what value a list would add to this case.
> The examples in the case material provide way more information
> than such a list because they provide context, and one can
> always obtain a list by running kstat at the command line.
>
> If an interface table is desirable, how about:
>
>   Interfaces
>   ________________________________________________________________
>   | Imported Interface     | Classification    | Comments         |
>   |________________________|___________________|__________________|
>   | smbsrv kstats          | Project           |                  |
>   |                        | Private           |                  |
>   |________________________|___________________|__________________|
>
> Alan

Did you name the stats you are using something opaque or something
vaguely intelligible? I am going to guess the latter. So, we know that
the kstat output was explicitly designed to be machine readable, i.e.
able to be an interface. So, with library interfaces we have man pages
to tell us what each is and we know if there doesn't exist a man page,
then that interface is private. Tell me, where is the list of public
kstats? As a programmer, I see something I would like to use in the
kstats output, and looking at the source code I see that it tallies
exactly what I need. How do I find out if it is public or private? I
might plug it into Google and see what I get. If you don't list it in
your proposal, then I get nothing, or just where it is found in the
source code. If you do list it, then the single hit that is not in the
source code is going to be your table, where it is clearly listed as
private. Darn, I am out of luck.

Unless and until we get a standard set of docs that definitively lists
what is public, then in proposals like this one is the only place these
interfaces are documented. You don't have to do this now, when you
integrate make a list from the kstat output and send it so it gets added
to the mail file. How hard is that?

-- 
blu

It's bad civic hygiene to build technologies that could someday be
used to facilitate a police state. - Bruce Schneier
----------------------------------------------------------------------
Brian Utterback - Solaris RPE, Oracle Corporation.
Ph:877-259-7345, Em:brian.utterback@oracle.com


From garrett.damore@oracle.com Mon Apr 12 08:25:40 2010
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3CFPenJ020364
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 12 Apr 2010 08:25:40 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail3mpk.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3CFPcUj029561
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 12 Apr 2010 08:25:40 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0R00L03S6P4Z00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 12 Apr 2010 09:25:37 -0600 (MDT)
Received: from sca-ea-mail-2.sun.com ([192.18.43.25])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0R004S6S6PM2A0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 12 Apr 2010 09:25:37 -0600 (MDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o3CFPaKL013268	for
 <PSARC-ext@Sun.COM>; Mon, 12 Apr 2010 15:25:36 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3CEo1Yv031903	for <PSARC-ext@sun.com>; Mon,
 12 Apr 2010 15:25:35 +0000 (GMT)
Received: from abhmt013.oracle.com by acsmt355.oracle.com	with ESMTP id
 153663281271085933; Mon, 12 Apr 2010 08:25:33 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Mon,
 12 Apr 2010 08:25:32 -0700
Date: Mon, 12 Apr 2010 08:25:22 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBFCABA.4050005@oracle.com>
To: Jordan Brown <Jordan.Brown@oracle.com>
Cc: Alan Wright <alan.wright@oracle.com>,
        James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC33B62.3040706@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090207.4BC33B70.005D:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
 <4BBFCABA.4050005@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 1531

On 04/ 9/10 05:47 PM, Jordan Brown wrote:
> Alan Wright wrote:
>> I honestly can't see what value a list would add to this case. 
>
> I agree.  Note also that some have held that once you have put a 
> Project Private interface into an ARC case, you must run an ARC case 
> to make any changes to it.  That seems like inappropriate overhead and 
> a good reason to avoid including anything you don't have to.
>
> (If somebody on the ARC wants to say "No, that's not true, you don't 
> have to do that", that would be great.  I still wouldn't understand 
> the benefit, but at least that cost would go away.)
>

In case it wasn't clear, my earlier reply said "should" not "must".  
I.e. if you're changing the kstats its a good idea (IMO) to post an 
update to the case log (although this is pretty darned easy), but I 
don't think anyone on ARC is going to force you to do this, any more 
than they were forcing you to list the kstats in the first place.

I have to admit, I don't understand the resistance to just posting the 
list... it should take far less time than you've already spent arguing 
why you shouldn't need to do it.  Of course, if you have a compelling 
reason why you should not post such a list (as opposed to why you 
shouldn't be "required" to post the list), then I'd like to hear it.

In any case, if I have not already done so, +1 on this case.  I still 
hope you'll post the expanded list of kstats, but its fine if you 
don't.  (Hrmm, I didn't post the list of kstats for Boomer either.)

     -- Garrett

From garrett.damore@oracle.com Mon Apr 12 08:25:41 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3CFPfJQ020368
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 12 Apr 2010 08:25:41 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3CFPegw027221
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 12 Apr 2010 08:25:41 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0R00K0BS6OST00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 12 Apr 2010 08:25:36 -0700 (PDT)
Received: from sca-ea-mail-3.sun.com ([192.18.43.21])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0R00C65S6O6RC0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 12 Apr 2010 08:25:36 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by sca-ea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3CFPZYI026376	for
 <PSARC-ext@Sun.COM>; Mon, 12 Apr 2010 15:25:36 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3CEo1Yt031903	for <PSARC-ext@sun.com>; Mon,
 12 Apr 2010 15:25:35 +0000 (GMT)
Received: from abhmt013.oracle.com by acsmt355.oracle.com	with ESMTP id
 153663281271085933; Mon, 12 Apr 2010 08:25:33 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Mon,
 12 Apr 2010 08:25:32 -0700
Date: Mon, 12 Apr 2010 08:25:22 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BBFCABA.4050005@oracle.com>
To: Jordan Brown <Jordan.Brown@oracle.com>
Cc: Alan Wright <alan.wright@oracle.com>,
        James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC33B62.3040706@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090202.4BC33B6F.0128:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
 <4BBFCABA.4050005@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 1531

On 04/ 9/10 05:47 PM, Jordan Brown wrote:
> Alan Wright wrote:
>> I honestly can't see what value a list would add to this case. 
>
> I agree.  Note also that some have held that once you have put a 
> Project Private interface into an ARC case, you must run an ARC case 
> to make any changes to it.  That seems like inappropriate overhead and 
> a good reason to avoid including anything you don't have to.
>
> (If somebody on the ARC wants to say "No, that's not true, you don't 
> have to do that", that would be great.  I still wouldn't understand 
> the benefit, but at least that cost would go away.)
>

In case it wasn't clear, my earlier reply said "should" not "must".  
I.e. if you're changing the kstats its a good idea (IMO) to post an 
update to the case log (although this is pretty darned easy), but I 
don't think anyone on ARC is going to force you to do this, any more 
than they were forcing you to list the kstats in the first place.

I have to admit, I don't understand the resistance to just posting the 
list... it should take far less time than you've already spent arguing 
why you shouldn't need to do it.  Of course, if you have a compelling 
reason why you should not post such a list (as opposed to why you 
shouldn't be "required" to post the list), then I'd like to hear it.

In any case, if I have not already done so, +1 on this case.  I still 
hope you'll post the expanded list of kstats, but its fine if you 
don't.  (Hrmm, I didn't post the list of kstats for Boomer either.)

     -- Garrett

From Jordan.Brown@oracle.com Mon Apr 12 09:02:34 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3CG2YZZ021169
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 12 Apr 2010 09:02:34 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3CG2Wii049192
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 12 Apr 2010 10:02:34 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0R00M27TW9VZ00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 12 Apr 2010 09:02:34 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0R00MIDTW83V40@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 12 Apr 2010 09:02:33 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3CG2Wf2014997	for
 <PSARC-ext@sun.com>; Mon, 12 Apr 2010 16:02:32 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3CG2Uxt013935	for <PSARC-ext@sun.com>; Mon,
 12 Apr 2010 16:02:31 +0000 (GMT)
Received: from abhmt012.oracle.com by acsmt354.oracle.com	with ESMTP id
 153787981271088146; Mon, 12 Apr 2010 09:02:26 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Mon,
 12 Apr 2010 09:02:26 -0700
Date: Mon, 12 Apr 2010 09:02:24 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BC33B62.3040706@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: Alan Wright <alan.wright@oracle.com>,
        James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC34410.40503@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090208.4BC34418.007C:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
 <4BBFCABA.4050005@oracle.com> <4BC33B62.3040706@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 731

Garrett D'Amore wrote:
> I have to admit, I don't understand the resistance to just posting the 
> list...

Reasons why I would resist...

1)  The more you document, the more you're tied down.

2)  The attitude that something might be construed to be public if it 
isn't explicitly private is a worrisome trend - the default is (or at 
least should be) that things are private unless explicitly made public.  
(Consider also the reader who finds the documentation and misses the 
"private" note.)

3)  Why document something subject to change without notice?  Makes the 
documentation longer without value.

4)  Even the fact that the tool uses kstats is a project private 
implementation detail subject to change without notice.


From Jordan.Brown@oracle.com Mon Apr 12 09:02:36 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3CG2Z4o021173
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 12 Apr 2010 09:02:35 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3CG2Wiu049192
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 12 Apr 2010 10:02:35 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0R00M2LTWAVZ00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 12 Apr 2010 09:02:34 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0R00MINTW93V40@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 12 Apr 2010 09:02:33 -0700 (PDT)
Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3CG2XQQ015009	for
 <PSARC-ext@sun.com>; Mon, 12 Apr 2010 16:02:33 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3CG2Uxv013935	for <PSARC-ext@sun.com>; Mon,
 12 Apr 2010 16:02:32 +0000 (GMT)
Received: from abhmt012.oracle.com by acsmt354.oracle.com	with ESMTP id
 153787981271088146; Mon, 12 Apr 2010 09:02:26 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Mon,
 12 Apr 2010 09:02:26 -0700
Date: Mon, 12 Apr 2010 09:02:24 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BC33B62.3040706@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: Alan Wright <alan.wright@oracle.com>,
        James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC34410.40503@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090204.4BC34418.01BD:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
 <4BBFCABA.4050005@oracle.com> <4BC33B62.3040706@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 731

Garrett D'Amore wrote:
> I have to admit, I don't understand the resistance to just posting the 
> list...

Reasons why I would resist...

1)  The more you document, the more you're tied down.

2)  The attitude that something might be construed to be public if it 
isn't explicitly private is a worrisome trend - the default is (or at 
least should be) that things are private unless explicitly made public.  
(Consider also the reader who finds the documentation and misses the 
"private" note.)

3)  Why document something subject to change without notice?  Makes the 
documentation longer without value.

4)  Even the fact that the tool uses kstats is a project private 
implementation detail subject to change without notice.


From alan.wright@oracle.com Mon Apr 12 14:15:52 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3CLFqCd027909
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 12 Apr 2010 14:15:52 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3CLFpeP034596
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 12 Apr 2010 15:15:52 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0S00I058EFLD00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 12 Apr 2010 14:15:51 -0700 (PDT)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0S00FI88EFP6B0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 12 Apr 2010 14:15:51 -0700 (PDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3CLFprW003989	for
 <PSARC-ext@sun.com>; Mon, 12 Apr 2010 21:15:51 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3CL0usu014603	for <PSARC-ext@sun.com>; Mon,
 12 Apr 2010 21:15:50 +0000 (GMT)
Received: from abhmt015.oracle.com by acsmt355.oracle.com	with ESMTP id
 154684351271106948; Mon, 12 Apr 2010 14:15:48 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Mon,
 12 Apr 2010 14:15:48 -0700
Date: Mon, 12 Apr 2010 14:15:20 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BC33B62.3040706@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: Jordan Brown <Jordan.Brown@oracle.com>,
        James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC38D68.70008@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090207.4BC38D87.000B:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
 <4BBFCABA.4050005@oracle.com> <4BC33B62.3040706@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 2150

On 04/12/10 08:25 AM, Garrett D'Amore wrote:
> On 04/ 9/10 05:47 PM, Jordan Brown wrote:
>> Alan Wright wrote:
>>> I honestly can't see what value a list would add to this case.
>>
>> I agree. Note also that some have held that once you have put a
>> Project Private interface into an ARC case, you must run an ARC case
>> to make any changes to it. That seems like inappropriate overhead and
>> a good reason to avoid including anything you don't have to.
>>
>> (If somebody on the ARC wants to say "No, that's not true, you don't
>> have to do that", that would be great. I still wouldn't understand the
>> benefit, but at least that cost would go away.)
>>
>
> In case it wasn't clear, my earlier reply said "should" not "must". I.e.
> if you're changing the kstats its a good idea (IMO) to post an update to
> the case log (although this is pretty darned easy), but I don't think
> anyone on ARC is going to force you to do this, any more than they were
> forcing you to list the kstats in the first place.
>
> I have to admit, I don't understand the resistance to just posting the
> list... it should take far less time than you've already spent arguing
> why you shouldn't need to do it. Of course, if you have a compelling
> reason why you should not post such a list (as opposed to why you
> shouldn't be "required" to post the list), then I'd like to hear it.
>
> In any case, if I have not already done so, +1 on this case. I still
> hope you'll post the expanded list of kstats, but its fine if you don't.
> (Hrmm, I didn't post the list of kstats for Boomer either.)
>
> -- Garrett

Thanks for the +1.

My main concern is that smbstat is a consumer and using a consumer
as a vehicle for documenting a consumed interface doesn't seem
appropriate - both as a mechanism and for traceability.  I'd really
prefer that this case remain a simple update to smbstat output format.

I think we should have mentioned the kstats in PSARC 2006/715 and I'd
be more comfortable submitting a separate addendum to that case to
describe them than burdening smbstat with being the vehicle to document
smbsrv kstats.  I'll take that as an action item.

Alan

From alan.wright@oracle.com Mon Apr 12 14:15:52 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3CLFqX8027908
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 12 Apr 2010 14:15:52 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3CLFpXU034585
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 12 Apr 2010 15:15:51 -0600 (MDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0S00A0B8EFQB00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 12 Apr 2010 15:15:51 -0600 (MDT)
Received: from sca-ea-mail-4.sun.com ([192.18.43.22])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0S007M88EFF930@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 12 Apr 2010 15:15:51 -0600 (MDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by sca-ea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3CLFo6a011798	for
 <PSARC-ext@sun.com>; Mon, 12 Apr 2010 21:15:50 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3CL0uss014603	for <PSARC-ext@sun.com>; Mon,
 12 Apr 2010 21:15:50 +0000 (GMT)
Received: from abhmt015.oracle.com by acsmt355.oracle.com	with ESMTP id
 154684351271106948; Mon, 12 Apr 2010 14:15:48 -0700
Received: from [10.1.106.211] (/10.1.106.211)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Mon,
 12 Apr 2010 14:15:48 -0700
Date: Mon, 12 Apr 2010 14:15:20 -0700
From: Alan Wright <alan.wright@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BC33B62.3040706@oracle.com>
To: "Garrett D'Amore" <garrett.damore@oracle.com>
Cc: Jordan Brown <Jordan.Brown@oracle.com>,
        James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC38D68.70008@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090205.4BC38D86.0102:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
 <4BBFCABA.4050005@oracle.com> <4BC33B62.3040706@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100214
 Thunderbird/3.0.1
Status: RO
Content-Length: 2150

On 04/12/10 08:25 AM, Garrett D'Amore wrote:
> On 04/ 9/10 05:47 PM, Jordan Brown wrote:
>> Alan Wright wrote:
>>> I honestly can't see what value a list would add to this case.
>>
>> I agree. Note also that some have held that once you have put a
>> Project Private interface into an ARC case, you must run an ARC case
>> to make any changes to it. That seems like inappropriate overhead and
>> a good reason to avoid including anything you don't have to.
>>
>> (If somebody on the ARC wants to say "No, that's not true, you don't
>> have to do that", that would be great. I still wouldn't understand the
>> benefit, but at least that cost would go away.)
>>
>
> In case it wasn't clear, my earlier reply said "should" not "must". I.e.
> if you're changing the kstats its a good idea (IMO) to post an update to
> the case log (although this is pretty darned easy), but I don't think
> anyone on ARC is going to force you to do this, any more than they were
> forcing you to list the kstats in the first place.
>
> I have to admit, I don't understand the resistance to just posting the
> list... it should take far less time than you've already spent arguing
> why you shouldn't need to do it. Of course, if you have a compelling
> reason why you should not post such a list (as opposed to why you
> shouldn't be "required" to post the list), then I'd like to hear it.
>
> In any case, if I have not already done so, +1 on this case. I still
> hope you'll post the expanded list of kstats, but its fine if you don't.
> (Hrmm, I didn't post the list of kstats for Boomer either.)
>
> -- Garrett

Thanks for the +1.

My main concern is that smbstat is a consumer and using a consumer
as a vehicle for documenting a consumed interface doesn't seem
appropriate - both as a mechanism and for traceability.  I'd really
prefer that this case remain a simple update to smbstat output format.

I think we should have mentioned the kstats in PSARC 2006/715 and I'd
be more comfortable submitting a separate addendum to that case to
describe them than burdening smbstat with being the vehicle to document
smbsrv kstats.  I'll take that as an action item.

Alan

From garrett.damore@oracle.com Mon Apr 12 15:59:26 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3CMxQ9g000112
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 12 Apr 2010 15:59:26 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3CMxQVR027173
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 12 Apr 2010 15:59:26 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0S00L0DD72MC00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 12 Apr 2010 16:59:26 -0600 (MDT)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0S007L5D71F7D0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 12 Apr 2010 16:59:25 -0600 (MDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3CMxPYM013017	for
 <PSARC-ext@sun.com>; Mon, 12 Apr 2010 22:59:25 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3CM2d87005918	for <PSARC-ext@sun.com>; Mon,
 12 Apr 2010 22:59:24 +0000 (GMT)
Received: from abhmt016.oracle.com by acsmt354.oracle.com	with ESMTP id
 154908481271113159; Mon, 12 Apr 2010 15:59:19 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Mon,
 12 Apr 2010 15:59:18 -0700
Date: Mon, 12 Apr 2010 15:59:17 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BC38D68.70008@oracle.com>
To: Alan Wright <alan.wright@oracle.com>
Cc: Jordan Brown <Jordan.Brown@oracle.com>,
        James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC3A5C5.3010006@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090202.4BC3A5CD.005F:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
 <4BBFCABA.4050005@oracle.com> <4BC33B62.3040706@oracle.com>
 <4BC38D68.70008@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 923

On 04/12/10 02:15 PM, Alan Wright wrote:
>
> Thanks for the +1.
>
> My main concern is that smbstat is a consumer and using a consumer
> as a vehicle for documenting a consumed interface doesn't seem
> appropriate - both as a mechanism and for traceability.  I'd really
> prefer that this case remain a simple update to smbstat output format.
>
> I think we should have mentioned the kstats in PSARC 2006/715 and I'd
> be more comfortable submitting a separate addendum to that case to
> describe them than burdening smbstat with being the vehicle to document
> smbsrv kstats.  I'll take that as an action item.

Thanks.  In case its not obvious, I didn't realize that that you were 
just consuming existing kstats -- I thought you were producing them (or 
adding the code to produce them) as part of this case.

I agree that the right place to document them is in the case associated 
with the producer.

     -- Garrett


From garrett.damore@oracle.com Mon Apr 12 15:59:27 2010
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3CMxRRL000116
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 12 Apr 2010 15:59:27 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.4) with ESMTP id o3CMxQKg042979
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 12 Apr 2010 16:59:26 -0600 (MDT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0S0010BD72Y900@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 12 Apr 2010 15:59:26 -0700 (PDT)
Received: from sca-ea-mail-2.sun.com ([192.18.43.25])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0S00JHPD71QAB0@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 12 Apr 2010 15:59:25 -0700 (PDT)
Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125])
	by sca-ea-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id o3CMxOp4007265	for
 <PSARC-ext@sun.com>; Mon, 12 Apr 2010 22:59:25 +0000 (GMT)
Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155])
	by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3CM2d85005918	for <PSARC-ext@sun.com>; Mon,
 12 Apr 2010 22:59:24 +0000 (GMT)
Received: from abhmt016.oracle.com by acsmt354.oracle.com	with ESMTP id
 154908481271113159; Mon, 12 Apr 2010 15:59:19 -0700
Received: from [10.7.251.172] (/10.7.251.172)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Mon,
 12 Apr 2010 15:59:18 -0700
Date: Mon, 12 Apr 2010 15:59:17 -0700
From: "Garrett D'Amore" <garrett.damore@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BC38D68.70008@oracle.com>
To: Alan Wright <alan.wright@oracle.com>
Cc: Jordan Brown <Jordan.Brown@oracle.com>,
        James Carlson <carlsonj@workingcode.com>, PSARC-ext@sun.com,
        smb-eng_ww@oracle.com
Message-id: <4BC3A5C5.3010006@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt355.oracle.com [141.146.40.155]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090205.4BC3A5CC.010C:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
 <4BBFCABA.4050005@oracle.com> <4BC33B62.3040706@oracle.com>
 <4BC38D68.70008@oracle.com>
User-Agent: Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:1.9.1.7) Gecko/20100131
 Lightning/1.0b1 Thunderbird/3.0.1
Status: RO
Content-Length: 923

On 04/12/10 02:15 PM, Alan Wright wrote:
>
> Thanks for the +1.
>
> My main concern is that smbstat is a consumer and using a consumer
> as a vehicle for documenting a consumed interface doesn't seem
> appropriate - both as a mechanism and for traceability.  I'd really
> prefer that this case remain a simple update to smbstat output format.
>
> I think we should have mentioned the kstats in PSARC 2006/715 and I'd
> be more comfortable submitting a separate addendum to that case to
> describe them than burdening smbstat with being the vehicle to document
> smbsrv kstats.  I'll take that as an action item.

Thanks.  In case its not obvious, I didn't realize that that you were 
just consuming existing kstats -- I thought you were producing them (or 
adding the code to produce them) as part of this case.

I agree that the right place to document them is in the case associated 
with the producer.

     -- Garrett


From Jordan.Brown@oracle.com Wed Apr 14 10:35:09 2010
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id o3EHZ9PA004495
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 14 Apr 2010 10:35:09 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.4) with ESMTP id o3EHZ6i4025234
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 14 Apr 2010 10:35:09 -0700 (PDT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0L0V00E0VNIJ3900@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Wed, 14 Apr 2010 11:35:08 -0600 (MDT)
Received: from sca-ea-mail-4.sun.com ([192.18.43.22])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0L0V001Z2NIJIUB0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed,
 14 Apr 2010 11:35:07 -0600 (MDT)
Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227])
	by sca-ea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id o3EHZ6U9021016	for
 <PSARC-ext@Sun.COM>; Wed, 14 Apr 2010 17:35:07 +0000 (GMT)
Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153])
	by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1)
 with ESMTP id o3EFYbeU011178	for <PSARC-ext@sun.com>; Wed,
 14 Apr 2010 17:35:05 +0000 (GMT)
Received: from abhmt020.oracle.com by acsmt353.oracle.com	with ESMTP id
 160642061271266423; Wed, 14 Apr 2010 10:33:43 -0700
Received: from [129.145.155.152] (/129.145.155.152)
	by default (Oracle Beehive Gateway v4.0)	with ESMTP ; Wed,
 14 Apr 2010 10:33:43 -0700
Date: Wed, 14 Apr 2010 10:33:42 -0700
From: Jordan Brown <Jordan.Brown@oracle.com>
Subject: Re: SMB/CIFS Statistics [PSARC/2010/120 FastTrack timeout 04/14/2010]
In-reply-to: <4BC3A5C5.3010006@oracle.com>
To: PSARC-ext@sun.com
Message-id: <4BC5FC76.4090102@oracle.com>
MIME-version: 1.0
Content-type: text/plain; charset=UTF-8; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Source-IP: acsmt353.oracle.com [141.146.40.153]
X-Auth-Type: Internal IP
X-CT-RefId: str=0001.0A090206.4BC5FCC9.018D:SCFMA4539814,ss=1,fgs=0
References: <201004080051.o380pYGC027152@sac.sfbay.sun.com>
 <4BBD548D.4060509@oracle.com> <4BBD6DEF.7010400@oracle.com>
 <4BBD70BF.2070508@oracle.com> <4BBD7670.4010602@oracle.com>
 <000f01cad6ea$3883e620$a98bb260$%borrego@oracle.com>
 <4BBDD529.9070002@oracle.com> <4BBE2286.7010207@oracle.com>
 <001701cad760$038069a0$0a813ce0$%borrego@oracle.com>
 <4BBE5D50.5060606@oracle.com> <4BBEDECD.3030100@oracle.com>
 <4BBF22C7.4050906@workingcode.com> <4BBFC9D0.5050107@oracle.com>
 <4BBFCABA.4050005@oracle.com> <4BC33B62.3040706@oracle.com>
 <4BC38D68.70008@oracle.com> <4BC3A5C5.3010006@oracle.com>
User-Agent: Thunderbird 2.0.0.14 (X11/20080505)
Status: RO
Content-Length: 300

This case timed out today.  It has its +1, and the issue raised 
(documentation of the underlying kstats) appears to have been resolved 
as not being appropriate for this case.  I expected it to come up at the 
meeting today, but it seems there was no meeting, so I'm declaring it 
closed approved.