From ahl@cyber.eng.sun.com Wed Nov 21 19:40:28 2007 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id lAM3eSLJ014570 for ; Wed, 21 Nov 2007 19:40:28 -0800 (PST) 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.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id lAM3eQkX005605 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@Sun.COM>; Wed, 21 Nov 2007 19:40:27 -0800 (PST) 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 <0JRW00J0N27FDN00@brm-avmta-1.central.sun.com> for PSARC-ext@Sun.COM (ORCPT PSARC-ext@Sun.COM); Wed, 21 Nov 2007 20:40:27 -0700 (MST) Received: from engmail3mpk.sfbay.Sun.COM ([129.146.11.26]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JRW00I8M27EM600@brm-avmta-1.central.sun.com> for PSARC-ext@Sun.COM (ORCPT PSARC-ext@Sun.COM); Wed, 21 Nov 2007 20:40:26 -0700 (MST) Received: from cyber.eng.sun.com (cyber.SFBay.Sun.COM [129.146.228.109]) by engmail3mpk.sfbay.Sun.COM (8.13.6+Sun/8.13.6/ENSMAIL,v2.2) with ESMTP id lAM3ePph015753; Wed, 21 Nov 2007 19:40:25 -0800 (PST) Received: from cyber.eng.sun.com (localhost [127.0.0.1]) by cyber.eng.sun.com (8.14.1+Sun/8.14.1) with ESMTP id lAM3Su7p009538; Wed, 21 Nov 2007 19:28:56 -0800 (PST) Received: (from ahl@localhost) by cyber.eng.sun.com (8.14.1+Sun/8.14.1/Submit) id lAM3St53009534; Wed, 21 Nov 2007 19:28:55 -0800 (PST) Date: Wed, 21 Nov 2007 19:28:55 -0800 (PST) From: Adam Leventhal Subject: DTrace NFS v4 Provider [PSARC/2007/665 FastTrack timeout 11/21/2007] To: PSARC-ext@sun.com Cc: Lisa.Week@sun.com, Sam.Falkner@sun.com, adam.leventhal@sun.com Message-id: <200711220328.lAM3St53009534@cyber.eng.sun.com> Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 Status: RO Content-Length: 6089 Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI This information is Copyright 2007 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: DTrace NFS v4 Provider 1.2. Name of Document Author/Supplier: Author: Adam Leventhal 1.3 Date of This Document: 21 November, 2007 4. Technical Description NFS v4 Provider All NFS operation probes have the first argument in common: args[0] conninfo_t * socket 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 */ string ci_remote; /* remote host address */ string ci_protocol; /* protocol (ipv4, ipv6, etc) */ } conninfo_t; Operation probes have their second argument in common: args[1] nfsv4opinfo_t * NFS v4 operation properties typedef struct nfsv4opinfo { string noi_curpath; /* current file handle path (if any) */ cred_t *noi_cred; /* credentials */ uint64_t noi_xid; /* transaction ID */ } nfsv4opinfo_t; Below is a list of the top level operation probes along with the specific argument for each whose type is defined by the NFS v4 specification: probe name args[2] ---------- ------- nfsv4:::compound-op-start COMPOUND4args * nfsv4:::compound-op-done COMPOUND4res * Below is a list of operation probes along with the specific argument for each whose type is defined by the NFS v4 specification: probe name args[2] ---------- ------- nfsv4:::op-access-start ACCESS4args * nfsv4:::op-access-done ACCESS4res * nfsv4:::op-close-start CLOSE4args * nfsv4:::op-close-done CLOSE4res * nfsv4:::op-commit-start COMMIT4args * nfsv4:::op-commit-done COMMIT4res * nfsv4:::op-create-start CREATE4args * nfsv4:::op-create-done CREATE4res * nfsv4:::op-delegpurge-start DELEGPURGE4args * nfsv4:::op-delegpurge-done DELEGPURGE4res * nfsv4:::op-delegreturn-start DELEGRETURN4args * nfsv4:::op-delegreturn-done DELEGRETURN4res * nfsv4:::op-getattr-start GETATTR4args * nfsv4:::op-getattr-done GETATTR4res * nfsv4:::op-getfh-start GETFH4args * nfsv4:::op-getfh-done GETFH4res * nfsv4:::op-link-start LINK4args * nfsv4:::op-link-done LINK4res * nfsv4:::op-lock-start LOCK4args * nfsv4:::op-lock-done LOCK4res * nfsv4:::op-lockt-start LOCKT4args * nfsv4:::op-lockt-done LOCKT4res * nfsv4:::op-locku-start LOCKU4args * nfsv4:::op-locku-done LOCKU4res * nfsv4:::op-lookup-start LOOKUP4args * nfsv4:::op-lookup-done LOOKUP4res * nfsv4:::op-lookupp-start LOOKUPP4args * nfsv4:::op-lookupp-done LOOKUPP4res * nfsv4:::op-nverify-start NVERIFY4args * nfsv4:::op-nverify-done NVERIFY4res * nfsv4:::op-open-start OPEN4args * nfsv4:::op-open-done OPEN4res * nfsv4:::op-open-confirm-start OPEN_CONFIRM4args * nfsv4:::op-open-confirm-done OPEN_CONFIRM4res * nfsv4:::op-open-downgrade-start OPEN_DOWNGRADE4args * nfsv4:::op-open-downgrade-done OPEN_DOWNGRADE4res * nfsv4:::op-openattr-start OPENATTR4args * nfsv4:::op-openattr-done OPENATTR4res * nfsv4:::op-putfh-start PUTFH4args * nfsv4:::op-putfh-done PUTFH4res * nfsv4:::op-putpubfh-start PUTPUBFH4args * nfsv4:::op-putpubfh-done PUTPUBFH4res * nfsv4:::op-putrootfh-start PUTROOTFH4args * nfsv4:::op-putrootfh-done PUTROOTFH4res * nfsv4:::op-read-start READ4args * nfsv4:::op-read-done READ4res * nfsv4:::op-readdir-start READDIR4args * nfsv4:::op-readdir-done READDIR4res * nfsv4:::op-readlink-start READLINK4args * nfsv4:::op-readlink-done READLINK4res * nfsv4:::op-release-lockowner-start RELEASE_LOCKOWNER4args * nfsv4:::op-release-lockowner-done RELEASE_LOCKOWNER4res * nfsv4:::op-remove-start REMOVE4args * nfsv4:::op-remove-done REMOVE4res * nfsv4:::op-rename-start RENAME4args * nfsv4:::op-rename-done RENAME4res * nfsv4:::op-renew-start RENEW4args * nfsv4:::op-renew-done RENEW4res * nfsv4:::op-restorefh-start nfsv4:::op-restorefh-done nfsv4:::op-savefh-start SAVEFH4args * nfsv4:::op-savefh-done SAVEFH4res * nfsv4:::op-secinfo-start SECINFO4args * nfsv4:::op-secinfo-done SECINFO4res * nfsv4:::op-setattr-start SETATTR4args * nfsv4:::op-setattr-done SETATTR4res * nfsv4:::op-setclientid-start SETCLIENTID4args * nfsv4:::op-setclientid-done SETCLIENTID4res * nfsv4:::op-setclientid-confirm-start SETCLIENTID_CONFIRM4args * nfsv4:::op-setclientid-confirm-done SETCLIENTID_CONFIRM4res * nfsv4:::op-verify-start VERIFY4args * nfsv4:::op-verify-done VERIFY4res * nfsv4:::op-write-start WRITE4args * nfsv4:::op-write-done WRITE4res * Callback compound probes have an undefined second argument; this slot is reserved for future use. Below is a list of the top level callback probes along with the specific argument for each whose type is defined by the NFS v4 specification: probe name args[2] ---------- ------- nfsv4:::compound-cb-start CB_COMPOUND4args * nfsv4:::compound-cb-done CB_COMPOUND4res * Callback operation probes have their second argument in common: args[1] nfsv4cbinfo_t * NFS v4 callback properties typedef struct nfsv4cbinfo { string nci_curpath; /* file handle path (if any) */ } nfsv4cbinfo_t; Below is a list of callback probes along with the specific argument for each whose type is defined by the NFS v4 specification: probe name args[2] ---------- ------- nfsv4:::cb-getattr-start CB_GETATTR4args * nfsv4:::cb-getattr-done CB_GETATTR4res * nfsv4:::cb-recall-start CB_RECALL4args * nfsv4:::cb-recall-done CB_RECALL4res * (Note that since the Solaris NFS v4 implementation does not yet use the 'getattr' callback, the probe will not be implemented; it is noted here in anticipation of a future implementation). 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 Sebastien.Roy@sun.com Sun Nov 25 13:34:47 2007 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 lAPLYk78018241 for ; Sun, 25 Nov 2007 13:34:47 -0800 (PST) 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 lAPLYgs1021940 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Sun, 25 Nov 2007 21:34:45 GMT 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 <0JS200F03ZXVIF00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Sun, 25 Nov 2007 13:34:43 -0800 (PST) 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 <0JS200C26ZXUVS10@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Sun, 25 Nov 2007 13:34:42 -0800 (PST) Received: from fe-amer-10.sun.com ([192.18.109.80]) by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id lAPLYgFR011182 for ; Sun, 25 Nov 2007 21:34:42 +0000 (GMT) Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0JS200B01ZO30R00@mail-amer.sun.com> (original mail from Sebastien.Roy@Sun.COM) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Sun, 25 Nov 2007 14:34:42 -0700 (MST) Received: from [192.168.1.3] ([72.93.210.146]) by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JS2008NLZXTHQB0@mail-amer.sun.com>; Sun, 25 Nov 2007 14:34:42 -0700 (MST) Date: Sun, 25 Nov 2007 16:34:41 -0500 From: Sebastien Roy Subject: Re: DTrace NFS v4 Provider [PSARC/2007/665 FastTrack timeout 11/21/2007] In-reply-to: <200711220328.lAM3St53009534@cyber.eng.sun.com> Sender: Sebastien.Roy@sun.com To: Adam Leventhal Cc: PSARC-ext@sun.com, Sam.Falkner@sun.com, Adam.Leventhal@sun.com, Lisa.Week@sun.com Message-id: <4749EA71.1090209@sun.com> Organization: Sun Microsystems MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <200711220328.lAM3St53009534@cyber.eng.sun.com> User-Agent: Thunderbird 2.0.0.6 (X11/20071009) Status: RO Content-Length: 80 What are the stability classifications of the probes and their arguments? -Seb From ahl@zion.sfbay.sun.com Sun Nov 25 13:37:15 2007 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 lAPLbENo018255 for ; Sun, 25 Nov 2007 13:37:14 -0800 (PST) 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 lAPLb9B6024224 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@Sun.COM>; Sun, 25 Nov 2007 21:37:13 GMT 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 <0JS300F0101ZND00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@Sun.COM (ORCPT PSARC-ext@Sun.COM); Sun, 25 Nov 2007 13:37:11 -0800 (PST) Received: from sfbaymail2sca.sfbay.sun.com ([129.145.155.42]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JS300C7Q01ZVY10@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@Sun.COM (ORCPT PSARC-ext@Sun.COM); Sun, 25 Nov 2007 13:37:11 -0800 (PST) Received: from zion.sfbay.sun.com (zion.SFBay.Sun.COM [129.146.17.75]) by sfbaymail2sca.sfbay.sun.com (8.13.6+Sun/8.13.6/ENSMAIL,v2.2) with ESMTP id lAPLbAeX013186; Sun, 25 Nov 2007 13:37:10 -0800 (PST) Received: from zion.sfbay.sun.com (localhost [127.0.0.1]) by zion.sfbay.sun.com (8.14.1+Sun/8.14.1) with ESMTP id lAPLb4Kg118148; Sun, 25 Nov 2007 21:37:04 +0000 (GMT) Received: (from ahl@localhost) by zion.sfbay.sun.com (8.14.1+Sun/8.14.1/Submit) id lAPLb48U118147; Sun, 25 Nov 2007 13:37:04 -0800 (PST) Date: Sun, 25 Nov 2007 13:37:04 -0800 From: Adam Leventhal Subject: Re: DTrace NFS v4 Provider [PSARC/2007/665 FastTrack timeout 11/21/2007] In-reply-to: <4749EA71.1090209@sun.com> To: Sebastien Roy Cc: PSARC-ext@sun.com, Sam.Falkner@sun.com, Adam.Leventhal@sun.com, Lisa.Week@sun.com Message-id: <20071125213704.GD117864@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.2.0.264296 References: <200711220328.lAM3St53009534@cyber.eng.sun.com> <4749EA71.1090209@sun.com> User-Agent: Mutt/1.5.10i Status: RO Content-Length: 685 Apologies for not noting this in the original mail (I mistakenly updated the wrong file to include that information). Here's what should have been at the top of the previous mail: ---8<--- The following specification describes the NFS v4 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. ---8<--- Adam On Sun, Nov 25, 2007 at 04:34:41PM -0500, Sebastien Roy wrote: > What are the stability classifications of the probes and their arguments? > > -Seb -- Adam Leventhal, FishWorks http://blogs.sun.com/ahl