This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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.

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.

To display the modified data on an HTML page, use the qnxvar token with the read tag. See the description of slinger in the Utilities Reference.

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.

Examples:

See slinger in the Utilities Reference.

Classification:

QNX Neutrino

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