posix_trace_attr_getinherited Subroutine
Purpose
Retrieves the inheritance policy of a trace stream.
Library
Posix Trace Library (libposixtrace.a)
Syntax
#include <trace.h>
int posix_trace_attr_getinherited(attr,inheritancepolicy)
const trace_attr_t * attr;
int *restrict inheritancepolicy;
Description
The posix_trace_attr_getinherited subroutine
gets the inheritance policy stored in the inheritance attribute
of the attr object for traced processes
across the fork and posix_spawn subroutine.
The inheritance attribute of the attr object
is set to one of the following values defined by manifest constants
in the trace.h header file:
| Item | Description |
|---|---|
| POSIX_TRACE_CLOSE_FOR_CHILD | After a fork or spawn operation, the child is not traced, and tracing of the parent continues. |
| POSIX_TRACE_INHERITED | After a fork or spawn operation, if the parent is being traced, its child will be simultaneously traced using the same trace stream. |
The default value for of the inheritance attribute is POSIX_TRACE_CLOSE_FOR_CHILD.
If this subroutine is called with a non-initialized attributes object as parameter, the result is not specified.
Parameters
| Item | Description |
|---|---|
| attr | Specifies the trace attribute object. |
| inheritancepolicy | Specifies where the inheritance attribute of the attr object is stored. |
Return Values
Upon successful completion, this subroutine returns a value of zero. Otherwise, it returns the corresponding error number.
If successful, the posix_trace_attr_getinherited subroutine stores the value of the attr object in the object specified by the inheritancepolicy parameter. Otherwise, the content of this object is not modified.
Errors
This subroutine
fails if the following error number returns:
| Item | Description |
|---|---|
| EINVAL | The object of a parameter is null or not valid. |
Files
The trace.h file in the Files Reference