Subject: PSARC FastTrack [11/06/2006]: Xserver provider for DTrace

I am sponsoring this case for myself with a timeout of Monday, Nov. 6.

Template Version: @(#)sac_nextcase %I% %G% SMI

1. Introduction
    1.1. Project/Component Working Name:
	 Xserver provider for DTrace
    1.2. Name of Document Author/Supplier:
	 Author:  Alan Coopersmith
    1.3  Date of This Document:
	30 October, 2006
4. Technical Description

Xserver provider for DTrace
===========================

This case introduces a User-land Statically Defined Tracing (USDT) DTrace
provider for X11 servers.  This provider instruments various points in
the X server, to allow tracing what client applications are up to.

These probes will be included in the main X server applications shipped
in the Solaris X Consolidation: Xorg, Xsun, Xprt, Xnest, Xvfb.

Since this case only adds functionality and makes no visible changes to
existing interfaces, it seeks a Patch release binding.

Descriptions of the probes and their arguments are in the Xserver-probes.html
file in the case materials.   [For those reading this outside the Sun firewall,
you can reference the copy at http://people.freedesktop.org/~alanc/dtrace/
now, or the case materials should be automatically mirrored to the case
directory in the ARC community on opensolaris.org shortly.]

Where possible, data formats and structures used are taken directly from the
X11 Protocol wire formats, which are well defined and have been a stable
standard interface for over 20 years.

The probe definitions are annotated with these stability levels (the stability
facility in DTrace still uses the previous stability taxonomy names):

#pragma D attributes Unstable/Unstable/Common provider Xserver provider
#pragma D attributes Private/Private/Unknown  provider Xserver module
#pragma D attributes Private/Private/Unknown  provider Xserver function
#pragma D attributes Unstable/Unstable/Common provider Xserver name
#pragma D attributes Unstable/Unstable/Common provider Xserver args


Imported Interfaces:
--------------------
X11 Protocol, Revision 6.7			Stable		X.Org Standard
User-land Statically Defined Tracing (USDT)	Evolving	PSARC 2004/624

Exported Interfaces:
--------------------
Xserver provider					Uncommitted
Xserver probe names & data				Uncommitted
Xserver binary file names & function names which 
 may be exposed via these probes		 	Project Private

6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		X Consolidation / Desktop C-Team
    6.5. ARC review type: FastTrack