From ahl@zion.sfbay.sun.com Thu May  7 13:09:15 2009
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 n47K9E99014335
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 7 May 2009 13:09:14 -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.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n47K9DRE024233;
	Thu, 7 May 2009 13:09:14 -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 <0KJA00505INDGX00@nwk-avmta-2.sfbay.sun.com>; Thu,
 07 May 2009 13:09:13 -0700 (PDT)
Received: from zion.sfbay.sun.com ([129.146.17.75])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KJA000K4INCKT70@nwk-avmta-2.sfbay.sun.com>; Thu,
 07 May 2009 13:09:13 -0700 (PDT)
Received: from zion.sfbay.sun.com (localhost [127.0.0.1])
	by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id n47K9C2l020880; Thu,
 07 May 2009 20:09:12 +0000 (GMT)
Received: (from ahl@localhost)	by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit)
 id n47K9CQ7020876; Thu, 07 May 2009 13:09:12 -0700 (PDT)
Date: Thu, 07 May 2009 13:09:12 -0700 (PDT)
From: Adam Leventhal <ahl@zion.sfbay.sun.com>
Subject: DTrace COMSTAR Fibre Channel Target Provider [PSARC/2009/291 FastTrack
 timeout 05/07/2009]
To: PSARC-ext@sun.com
Cc: Sam.Cramer@sun.com, ahl@eng.sun.com
Message-id: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 8049


Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 DTrace COMSTAR Fibre Channel Target Provider
    1.2. Name of Document Author/Supplier:
	 Author:  Sam Cramer
    1.3  Date of This Document:
	07 May, 2009
4. Technical Description
Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
         DTrace COMSTAR Fibre Channel Target Provider
    1.2. Name of Document Author/Supplier:
         Author:  Sam Cramer
    1.3  Date of This Document:
        07 May, 2009
4. Technical Description

The following specification describes the COMSTAR Fibre Channel Target
provider for DTrace. It has been reviewed and approved by the DTrace
community; the PSARC case is closed approved automatic to record the
interface. The stability is Committed and the binding is Patch.

The fc provider provides probes for tracing fibre channel port provider
activity.

This is a kernel provider built into the COMSTAR fc target port provider.

FC Provider

4.1 Probes overview

Fibre Channel Event Type        Probes
------------------------        ------
Link events                     fc:::link-up
                                fc:::link-down

Remote Port login/logout        fc:::rport-login-start
                                fc:::rport-login-end
                                fc:::rport-logout-start
                                fc:::rport-logout-end

Fabric login                    fc:::fabric-login-start
                                fc:::fabric-login-end

SCSI command/response           fc:::scsi-command
                                fc:::scsi-response

Data transfer                   fc:::xfer-start
                                fc:::xfer-done

4.2 Probe argument commonality

4.2.1 Arguments common to all probes

All FC probes have the first argument in common:

        args[0]         conninfo_t *            fc connection information

The conninfo_t structure is already used by the iSCSI target provider (iscsi),
and is intended for use by all provider which are providing some higher
level protocol (e.g. iscsi, nfs, http, ftp).

        typedef struct conninfo {
                string ci_local;        /* local host address (port WWN) */
                string ci_remote;       /* remote host address (port WWN) */
                string ci_protocol;     /* protocol (fc) */
        } conninfo_t;


4.2.2 Arguments common to all probes save for link event probes

All FC event probes other than link event probes have their second argument
in common:

        args[1]         fc_port_info_t *        local port information

The fc_port_info_t structure contains detailed information about a Fibre
Channel port:

        typedef struct fc_port_info {
                string fcp_node_wwn;            /* node WWN */
                string fcp_sym_node_name;       /* node symbolic name */
                string fcp_sym_port_name;       /* port symbolic name */
                uint32_t fcp_port_hard_address; /* port hard address */
        } fc_port_info_t;

4.2.3 Arguments common to SCSI command and data transfer probes

FC SCSI command and data transfer probes have their third and fourth
arguments in common:

        args[2]         scsicmd_t *             SCSI command block (cdb)
        args[3]         fc_port_info_t *        remote port information

The scsicmd_t structure contains information about SCSI command blocks:

        typedef struct scsicmd {
                uint64_t ic_len;        /* CDB length */
                uint8_t  *ic_cdb;       /* CDB data */
        } scsicmd_t;

4.2.4 Arguments common to data transfer probes

FC data transfer probes have their fifth argument in common:

        args[4]         fc_xferinfo_t *         data transfer information

The fc_xferinfo_t structure contains information about the data transfer:

        typedef struct fc_xferinfo {
                uint32_t fcx_len;       /* transfer length */
                uint32_t fcx_offset;    /* transfer offset */
                uint16_t fcx_flags;     /* db_flags as defined in sys/stmf.h */
        } fc_xferinfo_t;


4.3 Detailed probes specification

4.3.1 Link Event Probes

fc:::link-up and fc:::link-down trace Fibre Channel link-up and link-down
events.

Remote port information (ci_remote) is unavailable for both probes.

Probes                         Variable  Type               Description
------                         --------  ----               -----------
fc:::link-up,                  args[0]   conninfo_t *       connection info
fc:::link-down  

4.3.2 Remote Port Login/Logout Event Probes

Probes                         Variable  Type               Description
------                         --------  ----               -----------
fc:::rport-login-start,        args[0]   conninfo_t *       connection info
fc:::rport-login-end,          args[1]   fc_port_info_t *   local port info
fc:::rport-logout-start,       args[2]   fc_port_info_t *   remote port info
fc:::rport-logout-end          args[3]   int                solicited login flag

args[3] is 0 if the login or logout is unsolicited (inbound) and is
non-zero if solicited (outbound).

4.3.3 Fabric Login Event Probes

Probes                         Variable  Type               Description
------                         --------  ----               -----------
fc:::fabric-login-start,       args[0]   conninfo_t *       connection info
fc:::fabric-login-end,

fc:::fabric-login-end          args[1]   fc_port_info_t *   local port info

Fabric login applies only to the local port, since that's the entity that
logs into the fabric. Note that there's no explicit fabric logout. Detailed
local port information is only known at the end of fabric login.

4.3.4 SCSI Command Event Probes

Probes                         Variable  Type               Description
------                         --------  ----               -----------
fc:::scsi-command,             args[0]   conninfo_t *       connection info
fc:::scsi-response             args[1]   fc_port_info_t *   local port info
                               args[2]   scsi_cmd_t *       SCSI command block
                               args[3]   fc_port_info_t *   remote port info

4.3.5 Data Transfer Event Probes

Probes                         Variable  Type               Description
------                         --------  ----               -----------
fc:::xfer-start,               args[0]   conninfo_t *       connection info
fc:::xfer-done                 args[1]   fc_port_info_t *   local port info
                               args[2]   scsi_cmd_t *       SCSI command block
                               args[3]   fc_port_info_t *   remote port info
                               args[4]   fc_xferinfo_t *    data transfer info


Documentation and examples can be found here:

  http://wikis.sun.com/display/DTrace/fibre+channel+Provider

The table below describes the DTrace stability levels

                 |  Name            Data            Class                       
    -------------+-------------------------------------------                   
    Provider     |  Evolving        Evolving        ISA                         
    Module       |  Private         Private         Unknown                     
    Function     |  Private         Private         Unknown                     
    Name         |  Evolving        Evolving        ISA                         
    Arguments    |  Evolving        Evolving        ISA


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


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


From ahl@basura.sf.fishpong.com Thu May  7 13:11:28 2009
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n47KBP4o014450
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 7 May 2009 13:11:26 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n47KBNZS014257;
	Thu, 7 May 2009 21:11:23 +0100 (BST)
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 <0KJA00101IQYEL00@nwk-avmta-1.sfbay.Sun.COM>; Thu,
 07 May 2009 13:11:23 -0700 (PDT)
Received: from zion.sfbay.sun.com ([129.146.17.75])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KJA00FOMIQYLQA0@nwk-avmta-1.sfbay.Sun.COM>; Thu,
 07 May 2009 13:11:22 -0700 (PDT)
Received: from basura.sf.fishpong.com (fgw.SFBay.Sun.COM [10.7.251.167])
	by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id n47KBJup020981; Thu,
 07 May 2009 20:11:22 +0000 (GMT)
Received: from basura.sf.fishpong.com (localhost [127.0.0.1])
	by basura.sf.fishpong.com (8.14.2+Sun/8.14.2) with ESMTP id n47KDxOo167766;
 Thu, 07 May 2009 20:13:59 +0000 (GMT)
Received: (from ahl@localhost)	by basura.sf.fishpong.com
 (8.14.2+Sun/8.14.2/Submit) id n47KDxtq167765; Thu,
 07 May 2009 13:13:59 -0700 (PDT)
Date: Thu, 07 May 2009 13:13:59 -0700
From: Adam Leventhal <ahl@eng.sun.com>
Subject: Re: DTrace COMSTAR Fibre Channel Target Provider [PSARC/2009/291
	FastTrack timeout 05/07/2009]
In-reply-to: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
To: PSARC-ext@sun.com
Cc: Sam.Cramer@sun.com, Adam Leventhal <ahl@eng.sun.com>
Message-id: <20090507201358.GA164900@eng.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
References: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
User-Agent: Mutt/1.5.17 (2007-11-01)
Status: RO
Content-Length: 8783

Note that this case is closed approved automatic and has been approved by
the DTrace OpenSolaris community. As noted, the stability is Committed and
binding is Patch.

Adam

On Thu, May 07, 2009 at 01:09:12PM -0700, Adam Leventhal wrote:
> 
> Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
> This information is Copyright 2009 Sun Microsystems
> 1. Introduction
>     1.1. Project/Component Working Name:
> 	 DTrace COMSTAR Fibre Channel Target Provider
>     1.2. Name of Document Author/Supplier:
> 	 Author:  Sam Cramer
>     1.3  Date of This Document:
> 	07 May, 2009
> 4. Technical Description
> Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
> This information is Copyright 2009 Sun Microsystems
> 1. Introduction
>     1.1. Project/Component Working Name:
>          DTrace COMSTAR Fibre Channel Target Provider
>     1.2. Name of Document Author/Supplier:
>          Author:  Sam Cramer
>     1.3  Date of This Document:
>         07 May, 2009
> 4. Technical Description
> 
> The following specification describes the COMSTAR Fibre Channel Target
> provider for DTrace. It has been reviewed and approved by the DTrace
> community; the PSARC case is closed approved automatic to record the
> interface. The stability is Committed and the binding is Patch.
> 
> The fc provider provides probes for tracing fibre channel port provider
> activity.
> 
> This is a kernel provider built into the COMSTAR fc target port provider.
> 
> FC Provider
> 
> 4.1 Probes overview
> 
> Fibre Channel Event Type        Probes
> ------------------------        ------
> Link events                     fc:::link-up
>                                 fc:::link-down
> 
> Remote Port login/logout        fc:::rport-login-start
>                                 fc:::rport-login-end
>                                 fc:::rport-logout-start
>                                 fc:::rport-logout-end
> 
> Fabric login                    fc:::fabric-login-start
>                                 fc:::fabric-login-end
> 
> SCSI command/response           fc:::scsi-command
>                                 fc:::scsi-response
> 
> Data transfer                   fc:::xfer-start
>                                 fc:::xfer-done
> 
> 4.2 Probe argument commonality
> 
> 4.2.1 Arguments common to all probes
> 
> All FC probes have the first argument in common:
> 
>         args[0]         conninfo_t *            fc connection information
> 
> The conninfo_t structure is already used by the iSCSI target provider (iscsi),
> and is intended for use by all provider which are providing some higher
> level protocol (e.g. iscsi, nfs, http, ftp).
> 
>         typedef struct conninfo {
>                 string ci_local;        /* local host address (port WWN) */
>                 string ci_remote;       /* remote host address (port WWN) */
>                 string ci_protocol;     /* protocol (fc) */
>         } conninfo_t;
> 
> 
> 4.2.2 Arguments common to all probes save for link event probes
> 
> All FC event probes other than link event probes have their second argument
> in common:
> 
>         args[1]         fc_port_info_t *        local port information
> 
> The fc_port_info_t structure contains detailed information about a Fibre
> Channel port:
> 
>         typedef struct fc_port_info {
>                 string fcp_node_wwn;            /* node WWN */
>                 string fcp_sym_node_name;       /* node symbolic name */
>                 string fcp_sym_port_name;       /* port symbolic name */
>                 uint32_t fcp_port_hard_address; /* port hard address */
>         } fc_port_info_t;
> 
> 4.2.3 Arguments common to SCSI command and data transfer probes
> 
> FC SCSI command and data transfer probes have their third and fourth
> arguments in common:
> 
>         args[2]         scsicmd_t *             SCSI command block (cdb)
>         args[3]         fc_port_info_t *        remote port information
> 
> The scsicmd_t structure contains information about SCSI command blocks:
> 
>         typedef struct scsicmd {
>                 uint64_t ic_len;        /* CDB length */
>                 uint8_t  *ic_cdb;       /* CDB data */
>         } scsicmd_t;
> 
> 4.2.4 Arguments common to data transfer probes
> 
> FC data transfer probes have their fifth argument in common:
> 
>         args[4]         fc_xferinfo_t *         data transfer information
> 
> The fc_xferinfo_t structure contains information about the data transfer:
> 
>         typedef struct fc_xferinfo {
>                 uint32_t fcx_len;       /* transfer length */
>                 uint32_t fcx_offset;    /* transfer offset */
>                 uint16_t fcx_flags;     /* db_flags as defined in sys/stmf.h */
>         } fc_xferinfo_t;
> 
> 
> 4.3 Detailed probes specification
> 
> 4.3.1 Link Event Probes
> 
> fc:::link-up and fc:::link-down trace Fibre Channel link-up and link-down
> events.
> 
> Remote port information (ci_remote) is unavailable for both probes.
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::link-up,                  args[0]   conninfo_t *       connection info
> fc:::link-down  
> 
> 4.3.2 Remote Port Login/Logout Event Probes
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::rport-login-start,        args[0]   conninfo_t *       connection info
> fc:::rport-login-end,          args[1]   fc_port_info_t *   local port info
> fc:::rport-logout-start,       args[2]   fc_port_info_t *   remote port info
> fc:::rport-logout-end          args[3]   int                solicited login flag
> 
> args[3] is 0 if the login or logout is unsolicited (inbound) and is
> non-zero if solicited (outbound).
> 
> 4.3.3 Fabric Login Event Probes
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::fabric-login-start,       args[0]   conninfo_t *       connection info
> fc:::fabric-login-end,
> 
> fc:::fabric-login-end          args[1]   fc_port_info_t *   local port info
> 
> Fabric login applies only to the local port, since that's the entity that
> logs into the fabric. Note that there's no explicit fabric logout. Detailed
> local port information is only known at the end of fabric login.
> 
> 4.3.4 SCSI Command Event Probes
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::scsi-command,             args[0]   conninfo_t *       connection info
> fc:::scsi-response             args[1]   fc_port_info_t *   local port info
>                                args[2]   scsi_cmd_t *       SCSI command block
>                                args[3]   fc_port_info_t *   remote port info
> 
> 4.3.5 Data Transfer Event Probes
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::xfer-start,               args[0]   conninfo_t *       connection info
> fc:::xfer-done                 args[1]   fc_port_info_t *   local port info
>                                args[2]   scsi_cmd_t *       SCSI command block
>                                args[3]   fc_port_info_t *   remote port info
>                                args[4]   fc_xferinfo_t *    data transfer info
> 
> 
> Documentation and examples can be found here:
> 
>   http://wikis.sun.com/display/DTrace/fibre+channel+Provider
> 
> The table below describes the DTrace stability levels
> 
>                  |  Name            Data            Class                       
>     -------------+-------------------------------------------                   
>     Provider     |  Evolving        Evolving        ISA                         
>     Module       |  Private         Private         Unknown                     
>     Function     |  Private         Private         Unknown                     
>     Name         |  Evolving        Evolving        ISA                         
>     Arguments    |  Evolving        Evolving        ISA
> 
> 
> 6. Resources and Schedule
>     6.4. Steering Committee requested information
>         6.4.1. Consolidation C-team Name:
>                 OS/Net
>     6.5. ARC review type: FastTrack
>     6.6. ARC Exposure: open
> 
> 
> 6. Resources and Schedule
>     6.4. Steering Committee requested information
>    	6.4.1. Consolidation C-team Name:
> 		OS/Net
>     6.5. ARC review type: FastTrack
>     6.6. ARC Exposure: open
> 

-- 
Adam Leventhal, Fishworks                     http://blogs.sun.com/ahl

From carlsonj@phorcys.east.sun.com Fri May  8 11:37:42 2009
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 n48IbgsF022348
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 8 May 2009 11:37:42 -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.2) with ESMTP id n48IbdMd042803
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 8 May 2009 12:37:41 -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 <0KJC00M0F92RA000@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 08 May 2009 11:37:39 -0700 (PDT)
Received: from dm-east-01.east.sun.com ([129.148.9.192])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KJC00BYK92QLVC0@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 08 May 2009 11:37:39 -0700 (PDT)
Received: from phorcys.east.sun.com (phorcys.East.Sun.COM [129.148.174.143])
	by dm-east-01.east.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2)
 with ESMTP id n48IbbPt011343; Fri, 08 May 2009 14:37:37 -0400 (EDT)
Received: from phorcys.east.sun.com (phorcys.local [127.0.0.1])
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n48Ian8C001022; Fri,
 08 May 2009 14:36:49 -0400 (EDT)
Received: (from carlsonj@localhost)
	by phorcys.east.sun.com (8.14.3+Sun/8.14.3/Submit) id n48Ian58001019; Fri,
 08 May 2009 14:36:49 -0400 (EDT)
Date: Fri, 08 May 2009 14:36:49 -0400
From: James Carlson <james.d.carlson@sun.com>
Subject: Re: DTrace COMSTAR Fibre Channel Target Provider [PSARC/2009/291
 FastTrack timeout 05/07/2009]
In-reply-to: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
To: Adam Leventhal <ahl@zion.sfbay.sun.com>
Cc: PSARC-ext@sun.com, Sam.Cramer@sun.com, ahl@eng.sun.com
Message-id: <18948.31681.177303.41923@gargle.gargle.HOWL>
MIME-version: 1.0
X-Mailer: VM 7.01 under Emacs 21.3.1
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
Status: RO
Content-Length: 532

Adam Leventhal writes:
> The following specification describes the COMSTAR Fibre Channel Target
> provider for DTrace. It has been reviewed and approved by the DTrace
> community; the PSARC case is closed approved automatic to record the
> interface. The stability is Committed and the binding is Patch.

+1

-- 
James Carlson, Solaris Networking              <james.d.carlson@sun.com>
Sun Microsystems / 35 Network Drive        71.232W   Vox +1 781 442 2084
MS UBUR02-212 / Burlington MA 01803-2757   42.496N   Fax +1 781 442 1677

From Milan.Jurik@sun.com Mon May 11 12:37:30 2009
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n4BJXjG7023592
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 11 May 2009 12:37:30 -0700 (PDT)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n4BJXghW012117
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Mon, 11 May 2009 20:33:44 +0100 (BST)
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 <0KJH00G0FVO6GW00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 11 May 2009 13:33:42 -0600 (MDT)
Received: from gmp-eb-inf-2.sun.com ([192.18.6.24])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KJH00E00VO4MD10@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon,
 11 May 2009 13:33:41 -0600 (MDT)
Received: from fe-emea-09.sun.com (gmp-eb-lb-2-fe3.eu.sun.com [192.18.6.12])
	by gmp-eb-inf-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n4BJXeFu004345	for
 <PSARC-ext@sun.com>; Mon, 11 May 2009 19:33:40 +0000 (GMT)
Received: from conversion-daemon.fe-emea-09.sun.com by fe-emea-09.sun.com
 (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009))
 id <0KJH00500VMZ0M00@fe-emea-09.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Mon, 11 May 2009 20:33:40 +0100 (BST)
Received: from [94.112.2.8] ([unknown] [94.112.2.8])
 by fe-emea-09.sun.com (Sun Java(tm) System Messaging Server 7u2-7.02 64bit
 (built Apr 16 2009)) with ESMTPSA id <0KJH002XXVO3SU00@fe-emea-09.sun.com>;
 Mon, 11 May 2009 20:33:40 +0100 (BST)
Date: Mon, 11 May 2009 21:33:38 +0200
From: Milan Jurik <Milan.Jurik@sun.com>
Subject: Re: DTrace COMSTAR Fibre Channel Target Provider [PSARC/2009/291
 FastTrack timeout 05/07/2009]
In-reply-to: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
Sender: Milan.Jurik@sun.com
To: ahl@eng.sun.com
Cc: PSARC-ext@sun.com, Sam.Cramer@sun.com
Message-id: <1242070418.1527.6.camel@xylabone>
Organization: Sun Microsystems Czech
MIME-version: 1.0
X-Mailer: Evolution 2.24.2
Content-type: text/plain; charset=UTF-8
Content-transfer-encoding: 8BIT
X-PMX-Version: 5.4.1.325704
References: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
Status: RO
Content-Length: 8780

Hi,

only one question - why FC provider? COMSTAR FC target provider is new
code, but FC stack (aka Leadville) is much older (and it could receive
own dtrace probes). Wouldn't it be better to use "fct" for COMSTAR FC
target provider?

Best regards,

Milan

Adam Leventhal píše v čt 07. 05. 2009 v 13:09 -0700:
> Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
> This information is Copyright 2009 Sun Microsystems
> 1. Introduction
>     1.1. Project/Component Working Name:
> 	 DTrace COMSTAR Fibre Channel Target Provider
>     1.2. Name of Document Author/Supplier:
> 	 Author:  Sam Cramer
>     1.3  Date of This Document:
> 	07 May, 2009
> 4. Technical Description
> Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
> This information is Copyright 2009 Sun Microsystems
> 1. Introduction
>     1.1. Project/Component Working Name:
>          DTrace COMSTAR Fibre Channel Target Provider
>     1.2. Name of Document Author/Supplier:
>          Author:  Sam Cramer
>     1.3  Date of This Document:
>         07 May, 2009
> 4. Technical Description
> 
> The following specification describes the COMSTAR Fibre Channel Target
> provider for DTrace. It has been reviewed and approved by the DTrace
> community; the PSARC case is closed approved automatic to record the
> interface. The stability is Committed and the binding is Patch.
> 
> The fc provider provides probes for tracing fibre channel port provider
> activity.
> 
> This is a kernel provider built into the COMSTAR fc target port provider.
> 
> FC Provider
> 
> 4.1 Probes overview
> 
> Fibre Channel Event Type        Probes
> ------------------------        ------
> Link events                     fc:::link-up
>                                 fc:::link-down
> 
> Remote Port login/logout        fc:::rport-login-start
>                                 fc:::rport-login-end
>                                 fc:::rport-logout-start
>                                 fc:::rport-logout-end
> 
> Fabric login                    fc:::fabric-login-start
>                                 fc:::fabric-login-end
> 
> SCSI command/response           fc:::scsi-command
>                                 fc:::scsi-response
> 
> Data transfer                   fc:::xfer-start
>                                 fc:::xfer-done
> 
> 4.2 Probe argument commonality
> 
> 4.2.1 Arguments common to all probes
> 
> All FC probes have the first argument in common:
> 
>         args[0]         conninfo_t *            fc connection information
> 
> The conninfo_t structure is already used by the iSCSI target provider (iscsi),
> and is intended for use by all provider which are providing some higher
> level protocol (e.g. iscsi, nfs, http, ftp).
> 
>         typedef struct conninfo {
>                 string ci_local;        /* local host address (port WWN) */
>                 string ci_remote;       /* remote host address (port WWN) */
>                 string ci_protocol;     /* protocol (fc) */
>         } conninfo_t;
> 
> 
> 4.2.2 Arguments common to all probes save for link event probes
> 
> All FC event probes other than link event probes have their second argument
> in common:
> 
>         args[1]         fc_port_info_t *        local port information
> 
> The fc_port_info_t structure contains detailed information about a Fibre
> Channel port:
> 
>         typedef struct fc_port_info {
>                 string fcp_node_wwn;            /* node WWN */
>                 string fcp_sym_node_name;       /* node symbolic name */
>                 string fcp_sym_port_name;       /* port symbolic name */
>                 uint32_t fcp_port_hard_address; /* port hard address */
>         } fc_port_info_t;
> 
> 4.2.3 Arguments common to SCSI command and data transfer probes
> 
> FC SCSI command and data transfer probes have their third and fourth
> arguments in common:
> 
>         args[2]         scsicmd_t *             SCSI command block (cdb)
>         args[3]         fc_port_info_t *        remote port information
> 
> The scsicmd_t structure contains information about SCSI command blocks:
> 
>         typedef struct scsicmd {
>                 uint64_t ic_len;        /* CDB length */
>                 uint8_t  *ic_cdb;       /* CDB data */
>         } scsicmd_t;
> 
> 4.2.4 Arguments common to data transfer probes
> 
> FC data transfer probes have their fifth argument in common:
> 
>         args[4]         fc_xferinfo_t *         data transfer information
> 
> The fc_xferinfo_t structure contains information about the data transfer:
> 
>         typedef struct fc_xferinfo {
>                 uint32_t fcx_len;       /* transfer length */
>                 uint32_t fcx_offset;    /* transfer offset */
>                 uint16_t fcx_flags;     /* db_flags as defined in sys/stmf.h */
>         } fc_xferinfo_t;
> 
> 
> 4.3 Detailed probes specification
> 
> 4.3.1 Link Event Probes
> 
> fc:::link-up and fc:::link-down trace Fibre Channel link-up and link-down
> events.
> 
> Remote port information (ci_remote) is unavailable for both probes.
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::link-up,                  args[0]   conninfo_t *       connection info
> fc:::link-down  
> 
> 4.3.2 Remote Port Login/Logout Event Probes
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::rport-login-start,        args[0]   conninfo_t *       connection info
> fc:::rport-login-end,          args[1]   fc_port_info_t *   local port info
> fc:::rport-logout-start,       args[2]   fc_port_info_t *   remote port info
> fc:::rport-logout-end          args[3]   int                solicited login flag
> 
> args[3] is 0 if the login or logout is unsolicited (inbound) and is
> non-zero if solicited (outbound).
> 
> 4.3.3 Fabric Login Event Probes
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::fabric-login-start,       args[0]   conninfo_t *       connection info
> fc:::fabric-login-end,
> 
> fc:::fabric-login-end          args[1]   fc_port_info_t *   local port info
> 
> Fabric login applies only to the local port, since that's the entity that
> logs into the fabric. Note that there's no explicit fabric logout. Detailed
> local port information is only known at the end of fabric login.
> 
> 4.3.4 SCSI Command Event Probes
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::scsi-command,             args[0]   conninfo_t *       connection info
> fc:::scsi-response             args[1]   fc_port_info_t *   local port info
>                                args[2]   scsi_cmd_t *       SCSI command block
>                                args[3]   fc_port_info_t *   remote port info
> 
> 4.3.5 Data Transfer Event Probes
> 
> Probes                         Variable  Type               Description
> ------                         --------  ----               -----------
> fc:::xfer-start,               args[0]   conninfo_t *       connection info
> fc:::xfer-done                 args[1]   fc_port_info_t *   local port info
>                                args[2]   scsi_cmd_t *       SCSI command block
>                                args[3]   fc_port_info_t *   remote port info
>                                args[4]   fc_xferinfo_t *    data transfer info
> 
> 
> Documentation and examples can be found here:
> 
>   http://wikis.sun.com/display/DTrace/fibre+channel+Provider
> 
> The table below describes the DTrace stability levels
> 
>                  |  Name            Data            Class                       
>     -------------+-------------------------------------------                   
>     Provider     |  Evolving        Evolving        ISA                         
>     Module       |  Private         Private         Unknown                     
>     Function     |  Private         Private         Unknown                     
>     Name         |  Evolving        Evolving        ISA                         
>     Arguments    |  Evolving        Evolving        ISA
> 
> 
> 6. Resources and Schedule
>     6.4. Steering Committee requested information
>         6.4.1. Consolidation C-team Name:
>                 OS/Net
>     6.5. ARC review type: FastTrack
>     6.6. ARC Exposure: open
> 
> 
> 6. Resources and Schedule
>     6.4. Steering Committee requested information
>    	6.4.1. Consolidation C-team Name:
> 		OS/Net
>     6.5. ARC review type: FastTrack
>     6.6. ARC Exposure: open
> 


From ahl@basura.sf.fishpong.com Mon May 11 12:45:01 2009
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n4BJfGxW023687
	for <psarc-ext@sac.sfbay.sun.com>; Mon, 11 May 2009 12:45:01 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n4BJfDPI017196;
	Mon, 11 May 2009 20:41:14 +0100 (BST)
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 <0KJH00I1PW0PF100@nwk-avmta-1.sfbay.Sun.COM>; Mon,
 11 May 2009 12:41:13 -0700 (PDT)
Received: from zion.sfbay.sun.com ([129.146.17.75])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KJH001XMW0OD250@nwk-avmta-1.sfbay.Sun.COM>; Mon,
 11 May 2009 12:41:12 -0700 (PDT)
Received: from basura.sf.fishpong.com (fgw.SFBay.Sun.COM [10.7.251.167])
	by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id n4BJfCas025939; Mon,
 11 May 2009 19:41:12 +0000 (GMT)
Received: from basura.sf.fishpong.com (localhost [127.0.0.1])
	by basura.sf.fishpong.com (8.14.2+Sun/8.14.2) with ESMTP id n4BJhpXX170745;
 Mon, 11 May 2009 19:43:51 +0000 (GMT)
Received: (from ahl@localhost)	by basura.sf.fishpong.com
 (8.14.2+Sun/8.14.2/Submit) id n4BJhotW170744; Mon,
 11 May 2009 12:43:50 -0700 (PDT)
Date: Mon, 11 May 2009 12:43:50 -0700
From: Adam Leventhal <ahl@eng.sun.com>
Subject: Re: DTrace COMSTAR Fibre Channel Target Provider [PSARC/2009/291
	FastTrack timeout 05/07/2009]
In-reply-to: <1242070418.1527.6.camel@xylabone>
To: Milan Jurik <Milan.Jurik@sun.com>
Cc: PSARC-ext@sun.com, Sam.Cramer@sun.com
Message-id: <20090511194350.GC164900@eng.sun.com>
MIME-version: 1.0
Content-type: text/plain; charset=unknown-8bit
Content-transfer-encoding: 8BIT
Content-disposition: inline
X-PMX-Version: 5.4.1.325704
References: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
 <1242070418.1527.6.camel@xylabone>
User-Agent: Mutt/1.5.17 (2007-11-01)
Status: RO
Content-Length: 9604

Hi Milan,

For DTrace providers, the decision we made was to have the server provider
be the name of the protocol (e.g. iscsi, nfsv3, http, etc) and the client
provider have an additional component (e.g. iscsi_initiator, nfsv3_client).

Adam

On Mon, May 11, 2009 at 09:33:38PM +0200, Milan Jurik wrote:
> Hi,
> 
> only one question - why FC provider? COMSTAR FC target provider is new
> code, but FC stack (aka Leadville) is much older (and it could receive
> own dtrace probes). Wouldn't it be better to use "fct" for COMSTAR FC
> target provider?
> 
> Best regards,
> 
> Milan
> 
> Adam Leventhal píše v čt 07. 05. 2009 v 13:09 -0700:
> > Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
> > This information is Copyright 2009 Sun Microsystems
> > 1. Introduction
> >     1.1. Project/Component Working Name:
> > 	 DTrace COMSTAR Fibre Channel Target Provider
> >     1.2. Name of Document Author/Supplier:
> > 	 Author:  Sam Cramer
> >     1.3  Date of This Document:
> > 	07 May, 2009
> > 4. Technical Description
> > Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
> > This information is Copyright 2009 Sun Microsystems
> > 1. Introduction
> >     1.1. Project/Component Working Name:
> >          DTrace COMSTAR Fibre Channel Target Provider
> >     1.2. Name of Document Author/Supplier:
> >          Author:  Sam Cramer
> >     1.3  Date of This Document:
> >         07 May, 2009
> > 4. Technical Description
> > 
> > The following specification describes the COMSTAR Fibre Channel Target
> > provider for DTrace. It has been reviewed and approved by the DTrace
> > community; the PSARC case is closed approved automatic to record the
> > interface. The stability is Committed and the binding is Patch.
> > 
> > The fc provider provides probes for tracing fibre channel port provider
> > activity.
> > 
> > This is a kernel provider built into the COMSTAR fc target port provider.
> > 
> > FC Provider
> > 
> > 4.1 Probes overview
> > 
> > Fibre Channel Event Type        Probes
> > ------------------------        ------
> > Link events                     fc:::link-up
> >                                 fc:::link-down
> > 
> > Remote Port login/logout        fc:::rport-login-start
> >                                 fc:::rport-login-end
> >                                 fc:::rport-logout-start
> >                                 fc:::rport-logout-end
> > 
> > Fabric login                    fc:::fabric-login-start
> >                                 fc:::fabric-login-end
> > 
> > SCSI command/response           fc:::scsi-command
> >                                 fc:::scsi-response
> > 
> > Data transfer                   fc:::xfer-start
> >                                 fc:::xfer-done
> > 
> > 4.2 Probe argument commonality
> > 
> > 4.2.1 Arguments common to all probes
> > 
> > All FC probes have the first argument in common:
> > 
> >         args[0]         conninfo_t *            fc connection information
> > 
> > The conninfo_t structure is already used by the iSCSI target provider (iscsi),
> > and is intended for use by all provider which are providing some higher
> > level protocol (e.g. iscsi, nfs, http, ftp).
> > 
> >         typedef struct conninfo {
> >                 string ci_local;        /* local host address (port WWN) */
> >                 string ci_remote;       /* remote host address (port WWN) */
> >                 string ci_protocol;     /* protocol (fc) */
> >         } conninfo_t;
> > 
> > 
> > 4.2.2 Arguments common to all probes save for link event probes
> > 
> > All FC event probes other than link event probes have their second argument
> > in common:
> > 
> >         args[1]         fc_port_info_t *        local port information
> > 
> > The fc_port_info_t structure contains detailed information about a Fibre
> > Channel port:
> > 
> >         typedef struct fc_port_info {
> >                 string fcp_node_wwn;            /* node WWN */
> >                 string fcp_sym_node_name;       /* node symbolic name */
> >                 string fcp_sym_port_name;       /* port symbolic name */
> >                 uint32_t fcp_port_hard_address; /* port hard address */
> >         } fc_port_info_t;
> > 
> > 4.2.3 Arguments common to SCSI command and data transfer probes
> > 
> > FC SCSI command and data transfer probes have their third and fourth
> > arguments in common:
> > 
> >         args[2]         scsicmd_t *             SCSI command block (cdb)
> >         args[3]         fc_port_info_t *        remote port information
> > 
> > The scsicmd_t structure contains information about SCSI command blocks:
> > 
> >         typedef struct scsicmd {
> >                 uint64_t ic_len;        /* CDB length */
> >                 uint8_t  *ic_cdb;       /* CDB data */
> >         } scsicmd_t;
> > 
> > 4.2.4 Arguments common to data transfer probes
> > 
> > FC data transfer probes have their fifth argument in common:
> > 
> >         args[4]         fc_xferinfo_t *         data transfer information
> > 
> > The fc_xferinfo_t structure contains information about the data transfer:
> > 
> >         typedef struct fc_xferinfo {
> >                 uint32_t fcx_len;       /* transfer length */
> >                 uint32_t fcx_offset;    /* transfer offset */
> >                 uint16_t fcx_flags;     /* db_flags as defined in sys/stmf.h */
> >         } fc_xferinfo_t;
> > 
> > 
> > 4.3 Detailed probes specification
> > 
> > 4.3.1 Link Event Probes
> > 
> > fc:::link-up and fc:::link-down trace Fibre Channel link-up and link-down
> > events.
> > 
> > Remote port information (ci_remote) is unavailable for both probes.
> > 
> > Probes                         Variable  Type               Description
> > ------                         --------  ----               -----------
> > fc:::link-up,                  args[0]   conninfo_t *       connection info
> > fc:::link-down  
> > 
> > 4.3.2 Remote Port Login/Logout Event Probes
> > 
> > Probes                         Variable  Type               Description
> > ------                         --------  ----               -----------
> > fc:::rport-login-start,        args[0]   conninfo_t *       connection info
> > fc:::rport-login-end,          args[1]   fc_port_info_t *   local port info
> > fc:::rport-logout-start,       args[2]   fc_port_info_t *   remote port info
> > fc:::rport-logout-end          args[3]   int                solicited login flag
> > 
> > args[3] is 0 if the login or logout is unsolicited (inbound) and is
> > non-zero if solicited (outbound).
> > 
> > 4.3.3 Fabric Login Event Probes
> > 
> > Probes                         Variable  Type               Description
> > ------                         --------  ----               -----------
> > fc:::fabric-login-start,       args[0]   conninfo_t *       connection info
> > fc:::fabric-login-end,
> > 
> > fc:::fabric-login-end          args[1]   fc_port_info_t *   local port info
> > 
> > Fabric login applies only to the local port, since that's the entity that
> > logs into the fabric. Note that there's no explicit fabric logout. Detailed
> > local port information is only known at the end of fabric login.
> > 
> > 4.3.4 SCSI Command Event Probes
> > 
> > Probes                         Variable  Type               Description
> > ------                         --------  ----               -----------
> > fc:::scsi-command,             args[0]   conninfo_t *       connection info
> > fc:::scsi-response             args[1]   fc_port_info_t *   local port info
> >                                args[2]   scsi_cmd_t *       SCSI command block
> >                                args[3]   fc_port_info_t *   remote port info
> > 
> > 4.3.5 Data Transfer Event Probes
> > 
> > Probes                         Variable  Type               Description
> > ------                         --------  ----               -----------
> > fc:::xfer-start,               args[0]   conninfo_t *       connection info
> > fc:::xfer-done                 args[1]   fc_port_info_t *   local port info
> >                                args[2]   scsi_cmd_t *       SCSI command block
> >                                args[3]   fc_port_info_t *   remote port info
> >                                args[4]   fc_xferinfo_t *    data transfer info
> > 
> > 
> > Documentation and examples can be found here:
> > 
> >   http://wikis.sun.com/display/DTrace/fibre+channel+Provider
> > 
> > The table below describes the DTrace stability levels
> > 
> >                  |  Name            Data            Class                       
> >     -------------+-------------------------------------------                   
> >     Provider     |  Evolving        Evolving        ISA                         
> >     Module       |  Private         Private         Unknown                     
> >     Function     |  Private         Private         Unknown                     
> >     Name         |  Evolving        Evolving        ISA                         
> >     Arguments    |  Evolving        Evolving        ISA
> > 
> > 
> > 6. Resources and Schedule
> >     6.4. Steering Committee requested information
> >         6.4.1. Consolidation C-team Name:
> >                 OS/Net
> >     6.5. ARC review type: FastTrack
> >     6.6. ARC Exposure: open
> > 
> > 
> > 6. Resources and Schedule
> >     6.4. Steering Committee requested information
> >    	6.4.1. Consolidation C-team Name:
> > 		OS/Net
> >     6.5. ARC review type: FastTrack
> >     6.6. ARC Exposure: open
> > 
> 

-- 
Adam Leventhal, Fishworks                     http://blogs.sun.com/ahl

From ahl@eng.sun.com Tue Jun 30 14:20:32 2009
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n5ULKV2s013194
	for <psarc-ext@sac.sfbay.sun.com>; Tue, 30 Jun 2009 14:20:31 -0700 (PDT)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n5ULKTWQ016507
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Tue, 30 Jun 2009 22:20:30 +0100 (BST)
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 <0KM200E05LY5JP00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Tue, 30 Jun 2009 14:20:29 -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 <0KM200AZCLY5Z430@nwk-avmta-2.sfbay.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue,
 30 Jun 2009 14:20:29 -0700 (PDT)
Received: from fe-amer-09.sun.com ([192.18.109.79])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n5ULKTul008837	for
 <PSARC-ext@sun.com>; Tue, 30 Jun 2009 21:20:29 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009))
 id <0KM200D00LML8B00@mail-amer.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Tue, 30 Jun 2009 15:20:29 -0600 (MDT)
Received: from [192.168.221.203] ([unknown] [198.144.208.55])
 by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7u2-7.02 64bit (built Apr 16 2009))
 with ESMTPSA id <0KM200APQLV0X190@mail-amer.sun.com>; Tue,
 30 Jun 2009 15:20:20 -0600 (MDT)
Date: Tue, 30 Jun 2009 12:33:33 -0400
From: Adam Leventhal <ahl@eng.sun.com>
Subject: DTrace COMSTAR Fibre Channel Target Provider [PSARC/2009/291 FastTrack
 timeout 05/07/2009]
In-reply-to: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
Sender: Adam.Leventhal@sun.com
To: PSARC-ext@sun.com
Cc: Sam Cramer <Sam.Cramer@sun.com>, Allan Ou <Allan.Ou@sun.com>,
        Adam Leventhal <ahl@zion.sfbay.sun.com>
Message-id: <17058D7C-292B-4714-9D88-96E24AF131D1@eng.sun.com>
MIME-version: 1.0
X-Mailer: Apple Mail (2.935.3)
Content-type: text/plain; CHARSET=US-ASCII; delsp=yes; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
Status: RO
Content-Length: 1173

For the PSARC record, Allan Ou has made the following additions under  
the aegis of the original close approved automatic case:

4.1 Probes overview

Fibre Channel Event Type        Probes
------------------------        ------
rscn receive                    fc:::rscn-receive
abts receive                    fc:::abts-receive

4.3 Detailed probes specification

4.3.6 RSCN Packet Probes

fc:::rscn-receive trace all RSCN packets target port received

Probes              Variable   Type               Description
-----               ---------  ----               -----------
fc:::rscn-receive   args[0]    conninfo_t *       connection info
fc:::rscn-receive   args[1]    fc_port_info_t *   local port info
fc:::rscn-receive   args[2]    int                port id

args[2] is the port id which retrived from RSCN pages

4.3.7 ABTS Packet Probes

Probes               Variable  Type               Description
------               --------  ----               -----------
fc:::abts-receive    args[0]   conninfo_t *       connection info
fc:::abts-receive    args[1]   fc_port_info_t *   local port info
fc:::abts-receive    args[2]   fc_port_info_t *   remote port info

From daleg@elemental.org Tue Jun 30 16:34:23 2009
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 n5UNYMlg018401
	for <psarc-ext@sac.sfbay.sun.com>; Tue, 30 Jun 2009 16:34:22 -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.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n5UNYJJh007845;
	Tue, 30 Jun 2009 16:34:20 -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 <0KM200G0VS58U700@nwk-avmta-1.sfbay.Sun.COM>; Tue,
 30 Jun 2009 16:34:20 -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 <0KM200FXNS571940@nwk-avmta-1.sfbay.Sun.COM>; Tue,
 30 Jun 2009 16:34:20 -0700 (PDT)
Received: from relay44i.sun.com ([192.5.209.118])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n5UNYJRe013964; Tue,
 30 Jun 2009 23:34:19 +0000 (GMT)
Received: from mmp41es.mmp.us.syntegra.com ([160.41.221.10] [160.41.221.10])
 by relay44i.sun.com with ESMTP id BT-MMP-884099; Tue,
 30 Jun 2009 23:34:19 +0000 (Z)
Received: from relay44i.sun.com (relay44i.sun.com [192.5.209.118])
 by mmp41es.mmp.us.syntegra.com with ESMTP id BT-MMP-88965801; Tue,
 30 Jun 2009 23:34:18 +0000 (Z)
Received: from mercury.elemental.org ([205.134.191.194] [205.134.191.194])
 by relay4i.sun.com with ESMTP id BT-MMP-7481580; Tue,
 30 Jun 2009 23:34:18 +0000 (Z)
Received: from [10.75.10.106]
 (nat-204-14-233-149-rvo.net.salesforce.com [204.14.233.149])
	(authenticated bits=0)	by mercury.elemental.org (8.14.3/8.14.3/ELEMENTAL-4.0)
 with ESMTP id n5UNYIZS004037
	(version=TLSv1/SSLv3 cipher=AES128-SHA bits=128 verify=NO); Tue,
 30 Jun 2009 19:34:18 -0400 (EDT)
Date: Tue, 30 Jun 2009 19:34:18 -0400
From: Dale Ghent <daleg@elemental.org>
Subject: Re: DTrace COMSTAR Fibre Channel Target Provider [PSARC/2009/291
 FastTrack timeout 05/07/2009]
In-reply-to: <17058D7C-292B-4714-9D88-96E24AF131D1@eng.sun.com>
To: Adam Leventhal <ahl@eng.sun.com>
Cc: PSARC-ext@sun.com, Sam Cramer <Sam.Cramer@sun.com>,
        Allan Ou <Allan.Ou@sun.com>, Adam Leventhal <ahl@zion.sfbay.sun.com>
Message-id: <A732B143-5BE6-4BE7-8F53-1E9A29D8B285@elemental.org>
MIME-version: 1.0
X-Mailer: Apple Mail (2.935.3)
Content-type: text/plain; charset=US-ASCII; format=flowed; delsp=yes
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Brightmail-Tracker: AAAAAA==
X-Greylist: Sender succeeded SMTP AUTH,
 not delayed by milter-greylist-4.0 (mercury.elemental.org [205.134.191.194]);
 Tue, 30 Jun 2009 19:34:18 -0400 (EDT)
X-Antispam: No, score=0.0/5.0, scanned in 0.060sec at (localhost [127.0.0.1])
	by smf-spamd v1.3.1 - http://smfs.sf.net/
References: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
 <17058D7C-292B-4714-9D88-96E24AF131D1@eng.sun.com>
Status: RO
Content-Length: 1553


Cool plan, but could any of these COMSTAR FCTP-specific probes be  
misconstrued as having something to do with leadvile/fibre channel  
initiators?

/dale

On Jun 30, 2009, at 12:33 PM, Adam Leventhal wrote:

> For the PSARC record, Allan Ou has made the following additions  
> under the aegis of the original close approved automatic case:
>
> 4.1 Probes overview
>
> Fibre Channel Event Type        Probes
> ------------------------        ------
> rscn receive                    fc:::rscn-receive
> abts receive                    fc:::abts-receive
>
> 4.3 Detailed probes specification
>
> 4.3.6 RSCN Packet Probes
>
> fc:::rscn-receive trace all RSCN packets target port received
>
> Probes              Variable   Type               Description
> -----               ---------  ----               -----------
> fc:::rscn-receive   args[0]    conninfo_t *       connection info
> fc:::rscn-receive   args[1]    fc_port_info_t *   local port info
> fc:::rscn-receive   args[2]    int                port id
>
> args[2] is the port id which retrived from RSCN pages
>
> 4.3.7 ABTS Packet Probes
>
> Probes               Variable  Type               Description
> ------               --------  ----               -----------
> fc:::abts-receive    args[0]   conninfo_t *       connection info
> fc:::abts-receive    args[1]   fc_port_info_t *   local port info
> fc:::abts-receive    args[2]   fc_port_info_t *   remote port info
> _______________________________________________
> opensolaris-arc mailing list
> opensolaris-arc@opensolaris.org


From ahl@basura.sf.fishpong.com Tue Jun 30 17:15:57 2009
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 n610Fv8O019436
	for <psarc-ext@sac.sfbay.sun.com>; Tue, 30 Jun 2009 17:15:57 -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.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n610Fq25005372;
	Tue, 30 Jun 2009 17:15: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 <0KM200305U2JEG00@nwk-avmta-2.sfbay.sun.com>; Tue,
 30 Jun 2009 17:15:55 -0700 (PDT)
Received: from zion.sfbay.sun.com ([129.146.17.75])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KM200APXU2IZBD0@nwk-avmta-2.sfbay.sun.com>; Tue,
 30 Jun 2009 17:15:54 -0700 (PDT)
Received: from basura.sf.fishpong.com (fgw.SFBay.Sun.COM [10.7.251.167])
	by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id n6108HaR002252; Wed,
 01 Jul 2009 00:08:17 +0000 (GMT)
Received: from basura.sf.fishpong.com (localhost [127.0.0.1])
	by basura.sf.fishpong.com (8.14.2+Sun/8.14.2) with ESMTP id n6108I09206205;
 Wed, 01 Jul 2009 00:08:18 +0000 (GMT)
Received: (from ahl@localhost)	by basura.sf.fishpong.com
 (8.14.2+Sun/8.14.2/Submit) id n6108IDb206204; Tue,
 30 Jun 2009 17:08:18 -0700 (PDT)
Date: Tue, 30 Jun 2009 17:08:18 -0700
From: Adam Leventhal <ahl@eng.sun.com>
Subject: Re: DTrace COMSTAR Fibre Channel Target Provider [PSARC/2009/291
	FastTrack timeout 05/07/2009]
In-reply-to: <A732B143-5BE6-4BE7-8F53-1E9A29D8B285@elemental.org>
To: Dale Ghent <daleg@elemental.org>
Cc: PSARC-ext@sun.com, Sam Cramer <Sam.Cramer@sun.com>,
        Allan Ou <Allan.Ou@sun.com>
Message-id: <20090701000817.GC206174@eng.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
References: <200905072009.n47K9CQ7020876@zion.sfbay.sun.com>
 <17058D7C-292B-4714-9D88-96E24AF131D1@eng.sun.com>
 <A732B143-5BE6-4BE7-8F53-1E9A29D8B285@elemental.org>
User-Agent: Mutt/1.5.17 (2007-11-01)
Status: RO
Content-Length: 1978

Hey Dale,

They could if someone didn't read any of the documentation for example. In
general, the name of the provider pertaining to the server (or target) gets
the protocol name and the client (or initiator) has an additional suffix.

Adam

On Tue, Jun 30, 2009 at 07:34:18PM -0400, Dale Ghent wrote:
>
> Cool plan, but could any of these COMSTAR FCTP-specific probes be 
> misconstrued as having something to do with leadvile/fibre channel 
> initiators?
>
> /dale
>
> On Jun 30, 2009, at 12:33 PM, Adam Leventhal wrote:
>
>> For the PSARC record, Allan Ou has made the following additions under the 
>> aegis of the original close approved automatic case:
>>
>> 4.1 Probes overview
>>
>> Fibre Channel Event Type        Probes
>> ------------------------        ------
>> rscn receive                    fc:::rscn-receive
>> abts receive                    fc:::abts-receive
>>
>> 4.3 Detailed probes specification
>>
>> 4.3.6 RSCN Packet Probes
>>
>> fc:::rscn-receive trace all RSCN packets target port received
>>
>> Probes              Variable   Type               Description
>> -----               ---------  ----               -----------
>> fc:::rscn-receive   args[0]    conninfo_t *       connection info
>> fc:::rscn-receive   args[1]    fc_port_info_t *   local port info
>> fc:::rscn-receive   args[2]    int                port id
>>
>> args[2] is the port id which retrived from RSCN pages
>>
>> 4.3.7 ABTS Packet Probes
>>
>> Probes               Variable  Type               Description
>> ------               --------  ----               -----------
>> fc:::abts-receive    args[0]   conninfo_t *       connection info
>> fc:::abts-receive    args[1]   fc_port_info_t *   local port info
>> fc:::abts-receive    args[2]   fc_port_info_t *   remote port info
>> _______________________________________________
>> opensolaris-arc mailing list
>> opensolaris-arc@opensolaris.org
>

-- 
Adam Leventhal, Fishworks                     http://blogs.sun.com/ahl

