posix_spawn_file_actions_init(3)

posix_spawn_file_actions_init3

Initialize and destroy spawn file actions object

Usage

#include <spawn.h>

int

posix_spawn_file_actions_init(posix_spawn_file_actions_t * file_actions);

int

posix_spawn_file_actions_destroy(posix_spawn_file_actions_t * file_actions);

Library

Standard C Library (libc, -lc)

Overview

The posix_spawn_file_actions_init() function initialize the object referenced by file_actions() to contain no file actions for posix_spawn() or posix_spawnp(). Initializing an already initialized spawn file actions object may cause memory to be leaked.

The posix_spawn_file_actions_destroy() function destroy the object referenced by file_actions; the object becomes, in effect, uninitialized. A destroyed spawn file actions object can be reinitialized using posix_spawn_file_actions_init(). The object should not be used after it has been destroyed.

Return values

Upon successful completion, these functions return zero; otherwise, an error number is returned to indicate the error.

Errors

The posix_spawn_file_actions_init() function will fail if:

[ENOMEM]

Insufficient memory exists to initialize the spawn file actions object.

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 26 times.

  1. 8.0
  2. 8.1
  3. 8.2
  4. 8.3
  5. 8.4
  6. 9.0
  7. 9.1
  8. 9.2
  9. 9.3
  10. 10.0
  11. 10.1
  12. 10.2
  13. 10.3
  14. 10.4
  15. 11.0
  16. 11.1
  17. 11.2
  18. 11.3
  19. 11.4
  20. 12.0
  21. 12.1
  22. 12.2
  23. 12.3
  24. 12.4
  25. 13.0
  26. 13.1–13.2
  27. 13.3–16.0

Standards

The posix_spawn_file_actions_init() and posix_spawn_file_actions_destroy() functions conform to IEEE Std 1003.1-2001 (“POSIX.1”).

History

The posix_spawn_file_actions_init() and posix_spawn_file_actions_destroy() functions first appeared in FreeBSD 8.0.

Authors

Ed Schouten ⟨[email protected]⟩

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.