|
From: <sv...@va...> - 2009-05-16 10:44:16
|
Author: sewardj Date: 2009-05-16 11:44:08 +0100 (Sat, 16 May 2009) New Revision: 9853 Log: Update specification for Ptrcheck output, to be in line with overall XML format overhaul committed in r9849. Modified: branches/MESSAGING_TIDYUP/docs/internals/xml-output-protocol4.txt Modified: branches/MESSAGING_TIDYUP/docs/internals/xml-output-protocol4.txt =================================================================== --- branches/MESSAGING_TIDYUP/docs/internals/xml-output-protocol4.txt 2009-05-16 06:24:40 UTC (rev 9852) +++ branches/MESSAGING_TIDYUP/docs/internals/xml-output-protocol4.txt 2009-05-16 10:44:08 UTC (rev 9853) @@ -537,37 +537,39 @@ ==================================================================== -ERROR definition for Ptrcheck ------------------------------ +TOOLSPECIFIC definition for Ptrcheck +------------------------------------ -The definition is: +For Ptrcheck, a TOOLSPECIFIC is simply an ERROR: - <error> - <unique>HEX64</unique> - <tid>INT</tid> - <kind>KIND</kind> - <what>TEXT</what> (either 1 or 2 times) +TOOLSPECIIFIC = ERROR - STACK - zero or more of (STACK or <auxwhat>TEXT</auxwhat>) +ERROR details for Ptrcheck +-------------------------- - optionally: SUPPRESSION - </error> +The "... tool-specific fields ..." for Ptrcheck consist of +zero or more of "(either AUXWHAT or XAUXWHAT or STACK)". +They should be shown to the user in the order they appear. -The first four fields and the last field are specified in "ERROR -definition -- common fields" above. The remaining fields are as -follows: +Ptrcheck does not produce any XWHAT records, despite the fact that +"ERROR definition -- common structure" says it might do. -* The primary STACK for this error, indicating where it occurred. -* Some error types may have auxiliary information attached, expressed - as an arbitrary sequence of (STACK or <auxwhat>TEXT</auxwhat>). - These should be presented to the user in the sequence they appear in - the file, as they are intended to be read top-to-bottom. +XAUXWHATs (for definition, see above) may contain the following extra +components (along with the mandatory <text>...</text> component): +* <hthreadid>INT</hthreadid>, same meaning as when referred to in + XWHAT +* <file>TEXT</file>, as defined in FRAME + +* <line>INT</line>, as defined in FRAME + +* <dir>TEXT</dir>, as defined in FRAME + + KIND for Ptrcheck ----------------- This is a small enumeration indicating roughly the nature of an error. |