Thanks to a couple of gentle prods from the JDS team, I've finally submitted the
ARC fasttrack to add the Xserver dtrace probes to the Xservers shipped in
Solaris. There's only been one probe added since the original release, the
send-event probe, though others can always be added in the future should
the need arise. (Should anyone wish to comment to the ARC reviewing this,
I believe you can mail opensolaris-arc at opensolaris.org, though you may have
to send it to psarc-ext at sun.com - I'm not clear on the current state of the
proposed changes.)
-Alan Coopersmith- alan.coopersmith at sun.com
Sun Microsystems, Inc. - X Window System Engineering
-------- Original Message --------
Subject: Xserver provider for DTrace [PSARC/2006/609 Timeout: 11/06/2006]
Date: Mon, 30 Oct 2006 14:45:51 -0800 (PST)
From: Alan Coopersmith <[email protected]>
To: PSARC at sac.sfbay.sun.com
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