Set the type identifier of a spawn attributes object
Synopsis:
#include <spawn.h>
int posix_spawnattr_settypeid(
posix_spawnattr_t *attrp, uint32_t type_id);
Arguments:
- attrp
- A pointer to the spawn attributes object that you want to modify.
- type_id
- The type identifier to associate with the spawned process.
Library:
libc
Use the -l c option to qcc
to link against this library. This library is usually included automatically.
Description:
A type identifier associates a process or channel with a set of
rules in order to protect or restrict it. The security policy contains the rules for all type
identifiers. To learn more about security policies, see the
Security Developer's Guide.
The
posix_spawnattr_settypeid() function sets the
type_id attribute in the spawn attributes object pointed to by
attrp. You must have already initialized the spawn attributes object by
calling
posix_spawnattr_init(). In order for the type identifier to take
effect:
- You must pass the posix_spawnattr_t attributes object as a parameter to
posix_spawn().
- You must have set POSIX_SPAWN_SETTYPEID in the spawn flags by calling
posix_spawnattr_setxflags().
The calling process must have the
PROCMGR_AID_SETTYPEID ability with a
range that includes this type identifier.
Note: While a process inherits its parent's type
identifier by default, the effect may not be identical to spawning with the same type
identifier set with posix_spawnattr_settypeid(). When you use
posix_spawnattr_settypeid(), the abilities of the child process are
reset to those that the security policy indicates the type should have even if they differ
from the parent. When a child acquires its type identifier through inheritance, it also
inherits its parent's procmgr abilities.
For more information
about spawn attributes, see the entry for posix_spawn().
Note: This function is a QNX Neutrino extension.
Returns:
- EOK
- Success.
- EINVAL
- The value specified by attrp or type_id was invalid.
Classification:
QNX Neutrino
| Safety: |
|
| Cancellation point |
No |
| Interrupt handler |
Yes |
| Signal handler |
Yes |
| Thread |
Yes |