1POSIX_SPAWNATTR_GETFLAGS(P)POSIX Programmer's ManualPOSIX_SPAWNATTR_GETFLAGS(P)
2
3
4

NAME

6       posix_spawnattr_getflags,  posix_spawnattr_setflags  -  get and set the
7       spawn-flags attribute of a spawn attributes object (ADVANCED REALTIME)
8

SYNOPSIS

10       #include <spawn.h>
11
12       int posix_spawnattr_getflags(const posix_spawnattr_t *restrict attr,
13              short *restrict flags);
14       int posix_spawnattr_setflags(posix_spawnattr_t *attr, short flags);
15
16

DESCRIPTION

18       The posix_spawnattr_getflags() function shall obtain the value  of  the
19       spawn-flags attribute from the attributes object referenced by attr.
20
21       The  posix_spawnattr_setflags()  function  shall  set  the  spawn-flags
22       attribute in an initialized attributes object referenced by attr.
23
24       The spawn-flags attribute is used to indicate which process  attributes
25       are  to be changed in the new process image when invoking posix_spawn()
26       or posix_spawnp(). It is the bitwise-inclusive OR of zero  or  more  of
27       the following flags:
28
29       POSIX_SPAWN_RESETIDS
30       POSIX_SPAWN_SETPGROUP
31       POSIX_SPAWN_SETSIGDEF
32       POSIX_SPAWN_SETSIGMASK
33
34       POSIX_SPAWN_SETSCHEDPARAM
35       POSIX_SPAWN_SETSCHEDULER
36
37
38       These  flags  are  defined  in  <spawn.h>.  The  default  value of this
39       attribute shall be as if no flags were set.
40

RETURN VALUE

42       Upon successful  completion,  posix_spawnattr_getflags()  shall  return
43       zero  and store the value of the spawn-flags attribute of attr into the
44       object referenced by the flags parameter; otherwise,  an  error  number
45       shall be returned to indicate the error.
46
47       Upon  successful  completion,  posix_spawnattr_setflags()  shall return
48       zero; otherwise, an error number shall  be  returned  to  indicate  the
49       error.
50

ERRORS

52       These functions may fail if:
53
54       EINVAL The value specified by attr is invalid.
55
56
57       The posix_spawnattr_setflags() function may fail if:
58
59       EINVAL The value of the attribute being set is not valid.
60
61
62       The following sections are informative.
63

EXAMPLES

65       None.
66

APPLICATION USAGE

68       These  functions  are part of the Spawn option and need not be provided
69       on all implementations.
70

RATIONALE

72       None.
73

FUTURE DIRECTIONS

75       None.
76

SEE ALSO

78       posix_spawn() , posix_spawnattr_destroy()  ,  posix_spawnattr_init()  ,
79       posix_spawnattr_getsigdefault()    ,    posix_spawnattr_getpgroup()   ,
80       posix_spawnattr_getschedparam()  ,  posix_spawnattr_getschedpolicy()  ,
81       posix_spawnattr_getsigmask()    ,   posix_spawnattr_setsigdefault()   ,
82       posix_spawnattr_setpgroup()   ,    posix_spawnattr_setschedparam()    ,
83       posix_spawnattr_setschedpolicy()   ,   posix_spawnattr_setsigmask()   ,
84       posix_spawnp() , the Base Definitions volume  of  IEEE Std 1003.1-2001,
85       <spawn.h>
86

88       Portions  of  this text are reprinted and reproduced in electronic form
89       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
90       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
91       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
92       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
93       event of any discrepancy between this version and the original IEEE and
94       The  Open Group Standard, the original IEEE and The Open Group Standard
95       is the referee document. The original Standard can be  obtained  online
96       at http://www.opengroup.org/unix/online.html .
97
98
99
100IEEE/The Open Group                  2003          POSIX_SPAWNATTR_GETFLAGS(P)
Impressum