ds_flags()

Set the flags for a data server variable

Synopsis:

#include <ds.h>

int ds_flags( ds_t dsdes, 
              const char* variable_name,
              char flags );

Arguments:

dsdes

A data server descriptor returned by ds_register().

variable_name

The name of the data server variable.

flags

The new flags for the variable. The flags include:

• DS_PERM -- don't delete the variable when the application that created it terminates. The variable is removed when the data server process terminates, or if the flag is turned off after the application that created the variable terminates.

Library:

libds

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

Description:

The ds_flags() function changes the state of the flags belonging to the variable called variable_name on the data server identified by dsdes.

Returns:

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

Errors:

EBADF

Invalid file descriptor dsdes.

ESRCH

The variable doesn't exist in the data server.

Classification:

QNX Neutrino

See also:

ds_clear(), ds_create(), ds_deregister(), ds_set()