Difference between revisions of "Truxton carve file"

From truxwiki.com
Jump to navigation Jump to search
(Created page with "Sends a file to the carver. =Syntax= <source lang="C"> int truxton_carve_file( uint64_t truxton_handle, char const * file_id ); </source> =Parameters= ==<code>truxton_handle...")
 
 
Line 13: Line 13:
 
==<code>file_id</code>==
 
==<code>file_id</code>==
 
The string representation of the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the file to carve.
 
The string representation of the [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the file to carve.
It should match the value in the <code>[ID]</code> column of a record in the <code>[File]</code> table.
+
It should match the value in the <code>[ID]</code> column of a record in the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table.
  
 
=Return value=
 
=Return value=

Latest revision as of 07:55, 3 February 2024

Sends a file to the carver.

Syntax

int truxton_carve_file( uint64_t truxton_handle, char const * file_id );

Parameters

truxton_handle

The Truxton instance that contains this media. This handle comes from calling truxton_create().

file_id

The string representation of the GUID of the file to carve. It should match the value in the [ID] column of a record in the [File] table.

Return value

A non-zero value on success, zero on failure.

Sample

void dump( char const * file_id )
{
   uint64_t truxton = truxton_create();

   if ( truxton_carve_file( truxton, file_id, hash ) == 0 )
   {
      printf( "Cannot carve the file.\n" );
   }

   truxton_destroy( truxton );
}