Truxton etl set application name - Revision history

Sam: /* Sample */

2021-03-19T19:18:15Z

Sample

Sam: /* Sample */

2021-02-10T15:26:44Z

Sample

Sam at 15:22, 10 February 2021

2021-02-10T15:22:25Z

Sam at 07:40, 5 December 2020

2020-12-05T07:40:57Z

Sam at 07:37, 5 December 2020

2020-12-05T07:37:13Z

Sam at 10:48, 10 June 2020

2020-06-10T10:48:17Z

Sam at 15:01, 26 May 2020

2020-05-26T15:01:58Z

Sam: /* Sample */

2020-05-26T10:41:08Z

Sample

Sam: Created page with "This is used to build the command line arguments for the process. Truxton will automatically parse the command line for you but this allows you to programmatically force comma..."

2020-05-26T10:09:28Z

Created page with "This is used to build the command line arguments for the process. Truxton will automatically parse the command line for you but this allows you to programmatically force comma..."

New page

This is used to build the command line arguments for the process.
Truxton will automatically parse the command line for you but this allows you to programmatically force command line options.

=Syntax=
<syntaxhighlight lang="C">
void truxton_etl_set_application_name( uint64_t etl_handle, char const * name )
</syntaxhighlight>

=Parameters=
==<code>etl_handle</code>==

The handle created by the [[truxton_etl_create]] call.

==<code>name</code>==
A short human readable string that identifies your exploitation process.

=Remarks=
If you do not set the queue name, then the application name becomes the queue name by having all letters converted to lower case and spaces removed.
An application name of "Sample ETL" would cause the message queue name to be "sampleetl" unless otherwise specified.

=Sample=

<syntaxhighlight lang="C" highlight="13">
#include <TruxtonCAPI.h>

void main( void )
{
char file_id[ 65 ];
char description[ 128 ];

int exit_loop = 0;

uint64_t message = 0;
uint64_t app = truxton_etl_create();

truxton_etl_set_application_name( app, "Sample C ETL" );
truxton_etl_set_stage_number( app, 42 );
truxton_etl_set_queue_name( app, "SampleC" );

truxton_etl_set_description( app, "A sample of how to write an ETL");
truxton_etl_add_get_description( app, description, sizeof(description));

while( exit_loop == 0 )
{
message = truxton_etl_get_message( app );

if ( message != 0 )
{
// Do something with the message

memset( file_id, 0x00, sizeof( file_id ) );
truxton_message_get_file_id( message, file_id, sizeof( file_id ) );

printf( "Received file id %s\n", file_id );

truxton_message_destroy( message );
}
else
{
exit_loop = 1;
}
}
}
</syntaxhighlight>

@@ Line 53: / Line 53: @@
          message = truxton_etl_get_message( app );
+     }
      truxton_etl_destroy( app );
+}
 </source>

@@ Line 53: / Line 53: @@
          message = truxton_etl_get_message( app );
+     }
+}
 </source>

@@ Line 33: / Line 33: @@
      truxton_etl_set_queue_name( app, "SampleC" );
-     truxton_etl_set_description( app, "A sample of how to write an ETL");
+     truxton_etl_set_description( app, "A sample of how to write an ETL" );
-     truxton_etl_get_description( app, description, sizeof(description));
+     truxton_etl_get_description( app, description, sizeof(description) );
      // Pause here until we get a message from the "SampleC" message queue

@@ Line 36: / Line 36: @@
      truxton_etl_get_description( app, description, sizeof(description));
      message = truxton_etl_get_message( app );
@@ Line 48: / Line 49: @@
          truxton_message_destroy( message );
+     }
+}
 </source>

← Older revision		Revision as of 15:01, 26 May 2020
Line 1:		Line 1:
−	This ~~is used to build the command line arguments for the process.~~	+	This gives your ETL a human friendly name.
−	~~Truxton will automatically parse the command line for you but this allows you to programmatically force command line options~~.

	=Syntax=		=Syntax=

@@ Line 2: / Line 2: @@
 =Syntax=
-<syntaxhighlight lang="C">
+<source lang="C">
 void truxton_etl_set_application_name( uint64_t etl_handle, char const * name );
-</syntaxhighlight>
+</source>
 =Parameters=
 ==<code>etl_handle</code>==
 The handle created by the [[truxton_etl_create]] call.
@@ Line 19: / Line 18: @@
 =Sample=
-<syntaxhighlight lang="C" highlight="13">
+<source lang="C" highlight="11">
 #include <TruxtonCAPI.h>
@@ Line 26: / Line 25: @@
      char file_id[ 65 ];
      char description[ 128 ];
      uint64_t message = 0;
@@ Line 39: / Line 36: @@
      truxton_etl_get_description( app, description, sizeof(description));
-     while( exit_loop == 0 )
+    message = truxton_etl_get_message( app );
+     {
-         message = truxton_etl_get_message( app );
+         // Do something with the message
-            memset( file_id, 0x00, sizeof( file_id ) );
+        memset( file_id, 0x00, sizeof( file_id ) );
-            truxton_message_get_file_id( message, file_id, sizeof( file_id ) );
+        truxton_message_get_file_id( message, file_id, sizeof( file_id ) );
-            printf( "Received file id %s\n", file_id );
+        printf( "Received file id %s\n", file_id );
-            truxton_message_destroy( message );
+        truxton_message_destroy( message );
+     }
+}
-</syntaxhighlight>
+</source>