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