Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_get.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_get.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_get.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_get.html on line 8

ds_get()

Retrieve a data server variable

Synopsis:

#include <ds.h>

int ds_get( 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 get.
variable_data
A buffer where the function can store the data associated with the variable.
data_len
The size of the buffer, in bytes.

Library:

libds

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

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.

Returns:

The amount of data written to the buffer variable_data, or -1 if an error occurs (errno is set).

Errors:

EBADF
Invalid file descriptor dsdes.
EMSGSIZE
The buffer isn't big enough for 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

See also:

ds_create(), ds_set()


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_get.html on line 147

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/d/ds_get.html on line 147