dacs_runtime_init

NAME

dacs_runtime_init - Initialize all runtime services for DaCS.

SYNOPSIS

DACS_ERR_T dacs_runtime_init ( void *, void * )

Call parameters
All parameters must be set to NULL for SDK 3.0. Passing in a value other than NULL will result in the error DACS_ERR_INVALID_ADDR.

DESCRIPTION

The dacs_runtime_init service initializes all runtime services for DaCS.
Note: This service must be called for every process before any other DaCS services can be used. All other DaCS services will return DACS_ERR_NOT_INITIALIZED if called before this service.
A host process may call this service more than once, provided there is a call to dacs_runtime_exit() in between. An accelerator process may only call this service once, even if there is an intervening call to dacs_runtime_exit().

RETURN VALUE

The dacs_runtime_init service returns an error indicator defined as:
  • DACS_SUCCESS: normal return.
  • DACS_ERR_INVALID_ADDR: invalid pointer.
  • DACS_ERR_NO_RESOURCE: unable to allocate required resources.
  • DACS_ERR_INITIALIZED: DaCS is already initialized.
  • DACS_ERR_DACSD_FAILURE: unable to communicate with DaCSd.
  • DACS_ERR_VERSION_MISMATCH: version mismatch between library and DaCSd.

USAGE

dacs_runtime_init() respects the following environment variables for setting up an event listener for a remote workstation client:
  • DACS_LISTENER_HOST: the IP address of the workstation client.
  • DACS_LISTENER_PORT: the IP port listening on the workstation client.
  • DACS_LISTENER_EVENT: the named event to send to the client workstation:
    • DACS_LISTENER_EVENT=CELL_APP_LISTENER: see dacs_de_start for more details;
    • otherwise, all events are sent to the remote workstation client.

SEE ALSO

dacs_runtime_exit(3)
Parent topic: Initializing and closing down the DaCS library