Truxton dump black box - Revision history

Sam: Created page with "This function tells a Truxton process on this machine to dump its state. =Syntax= void truxton_dump_black_box( uint64_t process_id );
2023-05-28T14:44:16Z

Created page with "This function tells a Truxton process on this machine to dump its state. =Syntax= <source lang="C"> void truxton_dump_black_box( uint64_t process_id ); </source..."

New page
This function tells a Truxton process on this machine to dump its [[Black Box|state]].

=Syntax=
<source lang="C">
void truxton_dump_black_box( uint64_t process_id );
</source>

=Parameters=
==<code>process_id</code>==
The id of the process to dump.

=Sample=
<source lang="C" highlight="5">
void whats_going_on( uint64_t process_id )
{
printf( "Dumping the black box of process %" PRIU64 "\n" );

truxton_dump_black_box( process_id );
}
</source>

The <code>PRIu64</code> in the sample code above is a standard way of [https://en.wikipedia.org/wiki/C_data_types#Printf_and_scanf_format_specifiers formatting] a 64-bit unsigned integer in C.
Over the years, different compilers on different operating systems used different format specifiers for things, these <code>PRI</code> macros, along with some tricky string concatenation the compilers perform for you, allow you to maintain a single code base without a bunch of macro magic.