ds_get()

retrieve a data server variable

Synopsis:

#include <ds.h>

int ds_get( ds_t dsdes,
            char *variable_name,
            char *variable_data,
            int data_len );

Description:

The ds_get() function retrieves the data corresponding to variable_name from the data server dsdes, and places it in the buffer pointed to by variable_data. The data_len argument is the size of variable_data.

Returns:

0: Success.
-1: An error occurred; errno is set.

Errors:

EMSGSIZE: The buffer isn't big enough for the data.
ESRCH: The variable doesn't exist in the data server.

Classification:

QNX

Safety:
Interrupt handler	No
Signal handler	Yes, but modifies errno
Thread	Yes

See also:

ds_create(), ds_set()