ds_set()

Set a data server variable

Synopsis:

#include <ds.h>

int ds_set( ds_t dsdes,
            const char* variable_name,
            const char* variable_data,
            size_t data_len );

Arguments:

dsdes
A data server descriptor returned by ds_register().
variable_name
The name of the data server variable that you want to set.
variable_data
A pointer to the data you want to associate with the variable.
data_len
The size of the data, in bytes.

Library:

libds

Use the -l ds option to qcc to link against this library.

Description:

The ds_set() function passes the data variable_data to the data server identified by dsdes. The data server stores the data in the variable whose name is given by variable_name, overwriting any existing value.

Returns:

0 for success, or -1 if an error occurs (errno is set).

Errors:

EBADF
Invalid file descriptor dsdes.
ENOMEM
Not enough memory to store the data.
ESRCH
The variable doesn't exist in the data server.

Classification:

QNX Neutrino

Safety:  
Cancellation point Yes
Interrupt handler No
Signal handler Yes
Thread Yes