--- a/kernel/eka/include/e32btrace.h Mon Dec 21 16:14:42 2009 +0000
+++ b/kernel/eka/include/e32btrace.h Wed Dec 23 11:43:31 2009 +0000
@@ -387,14 +387,16 @@
EKernPerfLog = 5,
/**
- @internalTechnology
- @prototype 9.3
+ Trace generated when client-server activity takes place such as server creation,
+ session management, message handling, etc.
+
+ If #Prime is called with this category, traces will be generated for all
+ servers currently running and their sessions.
*/
EClientServer = 6,
/**
- @internalTechnology
- @prototype 9.3
+ Trace generated on thread request completion.
*/
ERequests = 7,
@@ -773,14 +775,13 @@
enum TClientServer
{
/**
- Trace generated whenever a server is created.
+ Trace generated whenever a server is created and during prime.
Trace data format:
- 4 bytes containing the server id (a DServer*).
- - 4 bytes containing undefined data
+ - 4 bytes containing the owning thread pointer (a DThread*).
- Remaining data is the ASCII name of the server.
- The context id (NThread*) in this trace is that of the thread creating the server.
*/
EServerCreate,
@@ -794,14 +795,16 @@
EServerDestroy,
/**
- Trace generated whenever a new session is attached to a server.
+ Trace generated whenever a new session is attached to a server and during prime.
I.e. a new session has been created.
Trace data format:
- 4 bytes containing the session id (a DSession*).
- 4 bytes containing the server id (a DServer*).
-
- The context id (NThread*) in this trace is that of the thread creating the session.
+ - 4 bytes containing the owner id (a DObject*).
+
+ The context id (NThread*) in this trace is that of the thread creating the session
+ (apart from during prime when it is NULL).
*/
ESessionAttach,