Black Box - Revision history

Sam: /* Examples */

2026-02-20T12:01:08Z

Examples

Sam at 10:43, 20 February 2026

2026-02-20T10:43:28Z

Sam: /* Sample */

2026-02-20T10:36:34Z

Sample

Sam at 11:16, 19 February 2026

2026-02-19T11:16:09Z

Sam: /* Slots */

2026-02-19T11:10:53Z

Slots

Sam at 11:02, 19 February 2026

2026-02-19T11:02:10Z

Sam: /* Thread Information */

2024-02-03T11:52:26Z

Thread Information

Sam at 10:55, 25 January 2024

2024-01-25T10:55:31Z

Sam at 13:43, 29 May 2023

2023-05-29T13:43:59Z

Sam: /* Thread Information */

2023-05-29T13:37:57Z

Thread Information

@@ Line 47: / Line 47: @@
 If an individual process was told to dump its state and <code>[[Configuration System|logdir]]</code> was set to "<code>E:\Logs\</code>" then the dump file would be something like this:<br />
 <code>E:\Logs\Truxton\Debug Dumps\20230523_174359_Process_1234_DebugDump.xml</code>
 =Sample=

@@ Line 40: / Line 40: @@
 =Dump File Location=
-The state information will be written to a file in a folder named "<code>Truxton\\Debug Dumps</code>" with a timestamp and process id in the filename.
+The state information will be written to a file in a folder named "<code>Truxton\Debug Dumps</code>" with a timestamp and process id in the filename.
 If the <code>[[Configuration System|logdir]]</code> option was not set, the root folder for the dump folder will be in the Program Data folder, usually the hidden <code>C:\ProgramData</code> folder.
@@ Line 46: / Line 46: @@
 ===Individual Process===
 If an individual process was told to dump its state and <code>[[Configuration System|logdir]]</code> was set to "<code>E:\Logs\</code>" then the dump file would be something like this:<br />
-<code>E:\Logs\Truxton\\Debug Dumps\\20230523_174359_Process_1234_DebugDump.xml</code>
+<code>E:\Logs\Truxton\Debug Dumps\20230523_174359_Process_1234_DebugDump.xml</code>
 =Sample=

@@ Line 55: / Line 55: @@
     <process name="Carve.exe" id="10020" hex_id="2724"></process>
    </processnames>
    <process id="10020">
     <pid hex="2724">10020</pid>

@@ Line 45: / Line 45: @@
 ==Examples==
 ===Individual Process===
-If an indevidual process was told to dump its state and <code>[[Configuration System|logdir]]</code> was set to "<code>E:\Logs\</code>" then the dump file would be something like this:<br />
+If an individual process was told to dump its state and <code>[[Configuration System|logdir]]</code> was set to "<code>E:\Logs\</code>" then the dump file would be something like this:<br />
 <code>E:\Logs\Truxton\\Debug Dumps\\20230523_174359_Process_1234_DebugDump.xml</code>

@@ Line 33: / Line 33: @@
 ==Slots==
 There are 20 slots where information can be stored.
-* Slot Number
+* Slot Number - An index value from 0 to 19
-* value
+* value - The integer value the programmer chose to store
-* sourcecodefile
+* sourcecodefile - An integer that uniquely identifies the full path to the source code file
-* linenumber
+* linenumber - The line number in the source code file
 =Dump File Location=

@@ Line 1: / Line 1: @@
 The Truxton ETL processes have a "black box recorder" that contains information about the process.
-It is a process equivalent of an [https://en.wikipedia.org/wiki/Flight_recorder aircraft black box].
+It is equivalent to an [https://en.wikipedia.org/wiki/Flight_recorder aircraft black box].
 The contents are dumped upon request to an [https://en.wikipedia.org/wiki/XML XML] file.

@@ Line 18: / Line 18: @@
 * fileid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the [[TGUID#File_ID|file]] currently being processed. This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table.
 * lastfileid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the [[TGUID#File_ID|file]] previously processed. This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table.
-* mediaid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media that contains the file being processed. This corresponds to the <code>[ID]</code> column of the <code>[Media]</code> table.
+* mediaid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media that contains the file being processed. This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
-* lastmediaid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media of the last file processed. This corresponds to the <code>[ID]</code> column of the <code>[Media]</code> table.
+* lastmediaid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media of the last file processed. This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[Media Table|Media]]<nowiki>]</nowiki></code> table.
 * activity
 * lastactivity

@@ Line 19: / Line 19: @@
 * lastactivity
 * flushloopcount
-* sourcecodefile
+* sourcecodefile - An integer representing the name of the source code file containing the code currently being executed. It is set using the <code>[[truxton_set_black_box_source_code_location]]()</code>
-* linenumber
+* linenumber - An integer representing the line number of the source code file containing the code currently being executed. It is set using the <code>[[truxton_set_black_box_source_code_location]]()</code>
 * lastupdate
 * lastupdatesecondsago