Destroy a spawn file actions object
Synopsis:
#include <spawn.h>
int posix_spawn_file_actions_destroy(
posix_spawn_file_actions_t *fact_p);
Arguments:
- fact_p
- A pointer to the spawn file action object that you want to destroy.
Library:
libc
Use the -l c option to
qcc
to link against this library. This library is usually included automatically.
Description:
The posix_spawn_file_actions_destroy() function destroys the object
referenced by fact_p; in effect, the object becomes uninitialized.
Note:
The posix_spawn_file_actions_destroy() function renders the
posix_spawn_file_actions_t unusable.
Before reusing the object, you must initialize it with posix_spawn_file_actions_init().
POSIX specifies that results are undefined when you use a
posix_spawnattr_t object after it has been destroyed, including
calling posix_spawn_file_actions_destroy() on an already destroyed
object.
Returns:
- EOK
- Success.
- EINVAL
- The value specified by fact_p was invalid.
Classification:
POSIX 1003.1 SPN
Safety: |
|
Cancellation point |
No |
Interrupt handler |
Yes |
Signal handler |
Yes |
Thread |
Yes |