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

PROLOG

6       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
7       implementation of this interface may differ (consult the  corresponding
8       Linux  manual page for details of Linux behavior), or the interface may
9       not be implemented on Linux.
10

NAME

12       posix_spawnattr_getflags, posix_spawnattr_setflags — get  and  set  the
13       spawn-flags attribute of a spawn attributes object (ADVANCED REALTIME)
14

SYNOPSIS

16       #include <spawn.h>
17
18       int posix_spawnattr_getflags(const posix_spawnattr_t *restrict attr,
19           short *restrict flags);
20       int posix_spawnattr_setflags(posix_spawnattr_t *attr, short flags);
21

DESCRIPTION

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

RETURN VALUE

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

ERRORS

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

EXAMPLES

66       None.
67

APPLICATION USAGE

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

RATIONALE

73       None.
74

FUTURE DIRECTIONS

76       None.
77

SEE ALSO

79       posix_spawn(), posix_spawnattr_destroy(), posix_spawnattr_getsigde‐
80       fault(), posix_spawnattr_getpgroup(), posix_spawnattr_getschedparam(),
81       posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigmask()
82
83       The Base Definitions volume of POSIX.1‐2017, <spawn.h>
84
86       Portions  of  this text are reprinted and reproduced in electronic form
87       from IEEE Std 1003.1-2017, Standard for Information Technology --  Por‐
88       table  Operating System Interface (POSIX), The Open Group Base Specifi‐
89       cations Issue 7, 2018 Edition, Copyright (C) 2018 by the  Institute  of
90       Electrical  and  Electronics Engineers, Inc and The Open Group.  In the
91       event of any discrepancy between this version and the original IEEE and
92       The  Open Group Standard, the original IEEE and The Open Group Standard
93       is the referee document. The original Standard can be  obtained  online
94       at http://www.opengroup.org/unix/online.html .
95
96       Any  typographical  or  formatting  errors that appear in this page are
97       most likely to have been introduced during the conversion of the source
98       files  to  man page format. To report such errors, see https://www.ker
99       nel.org/doc/man-pages/reporting_bugs.html .
100
101
102
103IEEE/The Open Group                  2017         POSIX_SPAWNATTR_GETFLAGS(3P)
Impressum