sysmgr_confstr_set()
QNX SDP8.0C Library ReferenceAPIDeveloper
Set a configuration string
Synopsis:
#include <sys/sysmgr.h>
int sysmgr_confstr_set( int cmd,
int name,
const char *str );
Arguments:
- cmd
- Set whether the configuration string value that you specify is removed after the calling
process terminates. Valid values are:
0— the value is removed (the default)- _CONF_STICKY — the value outlives the calling process
- name
- The configuration string that you want to set. For a list, go to the entry for confstr().
- str
- The new value for the configuration string.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The sysmgr_confstr_set function sets the value of a configuration string.
Note:
To set a configuration string, your process must have the confset ability enabled
(for more information, go to
Abilitiesin the QNX OS System Security Guide).
Returns:
0, or -1 if an error occurred (errno is set).
Errors:
- EBUSY
- A configuration variable with the name value you specified is already defined by another process.
- EINVAL
- Invalid argument (e.g., cmd is invalid).
- ENOMEM
- There is not enough memory available to create the configuration variable entry.
- EPERM
- The calling process doesn't have the required permission; go to
Abilities
in the QNX OS System Security Guide. - ETIMEDOUT
- A kernel timeout unblocked the call. Go to TimerTimeout().
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Page updated: