dxFeed Graal Native SDK 3.13.0-rc2
Loading...
Searching...
No Matches
__graal_create_isolate_params_t Struct Reference

The parameters of graal_create_isolate(). More...

#include <graal_isolate.h>

Data Fields

int version
 The version of this structure: __graal_create_isolate_params_version, set after zeroing it.
__graal_uword reserved_address_space_size
 The size of the virtual address space to reserve for the heap (0: the default).
const char * auxiliary_image_path
 Internal: the path of an auxiliary image to load (leave it NULL).
__graal_uword auxiliary_image_reserved_space_size
 Internal: the bytes reserved for loading an auxiliary image (leave it 0).
int argc
 The number of the strings in argv, including argv[0].
char ** argv
 The isolate arguments, parsed like a command line (see graal_create_isolate_params_t).
int pkey
 Internal: the protection key or domain of the isolate (leave it 0, NO_PROTECTION_DOMAIN).
char ignore_unrecognized_args
 1: unknown options in argv are ignored instead of failing graal_create_isolate().
char _reserved_4
 Internal, leave it 0.
char _reserved_5
 Internal, leave it 0.

Detailed Description

The parameters of graal_create_isolate().

Zero the structure, then set version to __graal_create_isolate_params_version and the fields to change; the fields that are 0 keep their defaults. The isolate reads only the fields of the given version, so a program built with an older header works with a newer library.

The isolate arguments (argc, argv) are parsed like the command line of a native executable, and argv[0] (the program name) is skipped:

  • -D<name>=<value> sets a system property, as dxfg_system_set_property() does after the creation (for example the properties that must be set before the first endpoint is created);
  • -Xmx<size>, -Xms<size>, -Xmn<size> set the maximum, the initial and the young generation sizes of the heap (64m, 1g);
  • -XX:<option>=<value>, -XX:+<option>, -XX:-<option> set the runtime options of the isolate, for example -XX:TearDownWarningSeconds=<seconds> (prints the threads that block graal_tear_down_isolate(); the debug builds of the SDK use 10 seconds) or -XX:-EnableSignalHandling (on Linux and macOS the isolate does not install its handlers of SIGPIPE and SIGXFSZ).

An unknown -XX: option or a wrong value (-Xmx64q) fails graal_create_isolate() and prints the reason to stderr, unless ignore_unrecognized_args is 1. The other arguments are not checked.

char *argv[] = {"app", "-Dlog.level=OFF", "-XX:TearDownWarningSeconds=10"};
memset(&params, 0, sizeof(params));
params.argc = 3;
params.argv = argv;
if (graal_create_isolate(&params, &isolate, &thread) != 0) { ... }
struct __graal_create_isolate_params_t graal_create_isolate_params_t
The parameters of graal_create_isolate(): see struct __graal_create_isolate_params_t.
Definition graal_isolate.h:146
int graal_create_isolate(graal_create_isolate_params_t *params, graal_isolate_t **isolate, graal_isolatethread_t **thread)
Creates a new isolate and attaches the current thread to it.
@ __graal_create_isolate_params_version
Definition graal_isolate.h:80
int argc
The number of the strings in argv, including argv[0].
Definition graal_isolate.h:129
int version
The version of this structure: __graal_create_isolate_params_version, set after zeroing it.
Definition graal_isolate.h:115
char ** argv
The isolate arguments, parsed like a command line (see graal_create_isolate_params_t).
Definition graal_isolate.h:131

Field Documentation

◆ _reserved_4

char __graal_create_isolate_params_t::_reserved_4

Internal, leave it 0.

◆ _reserved_5

char __graal_create_isolate_params_t::_reserved_5

Internal, leave it 0.

◆ argc

int __graal_create_isolate_params_t::argc

The number of the strings in argv, including argv[0].

◆ argv

char ** __graal_create_isolate_params_t::argv

The isolate arguments, parsed like a command line (see graal_create_isolate_params_t).

◆ auxiliary_image_path

const char * __graal_create_isolate_params_t::auxiliary_image_path

Internal: the path of an auxiliary image to load (leave it NULL).

◆ auxiliary_image_reserved_space_size

__graal_uword __graal_create_isolate_params_t::auxiliary_image_reserved_space_size

Internal: the bytes reserved for loading an auxiliary image (leave it 0).

◆ ignore_unrecognized_args

char __graal_create_isolate_params_t::ignore_unrecognized_args

1: unknown options in argv are ignored instead of failing graal_create_isolate().

◆ pkey

int __graal_create_isolate_params_t::pkey

Internal: the protection key or domain of the isolate (leave it 0, NO_PROTECTION_DOMAIN).

◆ reserved_address_space_size

__graal_uword __graal_create_isolate_params_t::reserved_address_space_size

The size of the virtual address space to reserve for the heap (0: the default).

◆ version

int __graal_create_isolate_params_t::version

The version of this structure: __graal_create_isolate_params_version, set after zeroing it.


The documentation for this struct was generated from the following files: