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
| Safety: |
|
|---|
| Cancellation point |
Yes |
| Interrupt handler |
No |
| Signal handler |
Yes |
| Thread |
Yes |