1posix_spawnattr_destroy(3CS)tandard C Library Functionpsosix_spawnattr_destroy(3C)
2
3
4

NAME

6       posix_spawnattr_destroy,  posix_spawnattr_init - destroy and initialize
7       spawn attributes object
8

SYNOPSIS

10       #include <spawn.h>
11
12       int posix_spawnattr_destroy(posix_spawnattr_t *attr);
13
14
15       int posix_spawnattr_init(posix_spawnattr_t *attr);
16
17

DESCRIPTION

19       The posix_spawnattr_destroy()  function  destroys  a  spawn  attributes
20       object.  A  destroyed attr attributes object can be reinitialized using
21       posix_spawnattr_init(). The results of otherwise referencing the object
22       after  it has been destroyed are undefined. An implementation can cause
23       posix_spawnattr_destroy() to set the object referenced by  attr  to  an
24       invalid value.
25
26
27       The  posix_spawnattr_init()  function  initializes  a  spawn attributes
28       object attr with the default value for all of the individual attributes
29       used  by  the  implementation.  Results  are  undefined  if posix_spaw‐
30       nattr_init()  is  called  specifying  an   already   initialized   attr
31       attributes object.
32
33
34       A  spawn  attributes  object  is  of type posix_spawnattr_t (defined in
35       <spawn.h>) and is used to specify the inheritance of process attributes
36       across a spawn operation.
37
38
39       No attributes other than those defined by IEEE Std 1003.1-200x are pro‐
40       vided.
41
42
43       The resulting spawn attributes object  (possibly  modified  by  setting
44       individual  attribute  values),  is  used  to  modify  the  behavior of
45       posix_spawn(3C) or posix_spawnp(3C). After a  spawn  attributes  object
46       has  been  used  to  spawn  a  process  by  a  call to posix_spawn() or
47       posix_spawnp(), any function affecting the attributes object (including
48       destruction)  will not affect any process that has been spawned in this
49       way.
50

RETURN VALUES

52       Upon successful completion, posix_spawnattr_destroy()  and  posix_spaw‐
53       nattr_init()  return 0. Otherwise, an error number is returned to indi‐
54       cate the error.
55

ERRORS

57       The posix_spawnattr_init() function will fail if:
58
59       ENOMEM    Insufficient memory exists to initialize the spawn attributes
60                 object.
61
62
63
64       The posix_spawnattr_destroy() function may fail if:
65
66       EINVAL    The value specified by attr is invalid.
67
68

ATTRIBUTES

70       See attributes(5) for descriptions of the following attributes:
71
72
73
74
75       ┌─────────────────────────────┬─────────────────────────────┐
76       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
77       ├─────────────────────────────┼─────────────────────────────┤
78       │Interface Stability          │Standard                     │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │MT-Level                     │MT-Safe                      │
81       └─────────────────────────────┴─────────────────────────────┘
82

SEE ALSO

84       posix_spawn(3C),   posix_spawnattr_getflags(3C),  posix_spawnattr_getp‐
85       group(3C), posix_spawnattr_getschedparam(3C), posix_spawnattr_getsched‐
86       policy(3C),  posix_spawnattr_getsigdefault(3C), posix_spawnattr_getsig‐
87       mask(3C), attributes(5), standards(5)
88
89
90
91SunOS 5.11                        30 Jan 2004      posix_spawnattr_destroy(3C)
Impressum