Tutorial

Getting started with Helixis in C/C++

1) Put the code below in your main source

 #include "hlx/core.h"
 
 int main()
 {
   if (hlx_core_init() < 1)
      return (-1);
   hlx_core_start();
   hlx_core_destroy();
   return (0);
 }

2) Initialize Helixis API

Because of Helixis is ​​written in "pure" C, we needs to give it the entry points of system calls. Depending on the configuration chosen in the configuration (build_config.h), you must provide more or fewer functions.

In Native Threading Mode (!HLX_BUILD_WITH_PARALLEL_THREADING) :

• malloc_entry
• free_entry

In Parallel Threading Mode (HLX_BUILD_WITH_PARALLEL_THREADING)

• malloc_entry
• free_entry
• aligned_malloc_entry
• aligned_free_entry
• atomic_incr_entry
• atomic_decr_entry
• atomic_cas_entry
• atomic_dcas_entry

The Native Threading Mode gives us the following code :

 #include <stdio.h>
 #include "hlx/core.h"
 
 int main()
 {
   hlx_get_api_entries()->malloc_entry = &malloc;
   hlx_get_api_entries()->free_entry = &free;
   if (hlx_core_init() < 1)
      return (-1);
   hlx_core_start();
   hlx_core_destroy();
   return (0);
 }

Remarks:

All prototypes are detailed in api.h

For The Parallel Threading Mode see the section with the same name.

3) Do what you want :)

Sample codes section