lgrp_affinity_inherit_set

- set lgroup inheritance

Synopsis

cc [ flag … ] file… -llgrp [ library … ]
#include <sys/lgrp_user.h>

int lgrp_affinity_inherit_set(idtype_t idtype, id_t id,
     lgrp_aff_inherit_t inherit_flags);

Description

The lgrp_affinity_inherit_set() function sets the lgroup affinity inheritance of the specified process or thread. The lgroup affinities can be inherited by child processes or threads across fork(2), exec(2), pthread_create(3C), and thr_create(3C). By default, they are not inherited across fork(), pthread_create(), and thr_create(), but are inherited across the exec functions for compatibility.

If the idtype is P_PID, the lgroup inheritance is set for all of the threads in the process. The lgroup inheritance is set for the thread in the current process with LWP ID id if idtype is P_LWPID. If id is P_MYID, then the current LWP or process is specified.

The lgrp_aff_inherit_t can be one of the following values:

LGRP_AFF_INHERIT_DEFAULT

The lgroup affinity inheritance is set to the default value for the specified process or thread.

LGRP_AFF_INHERIT_NONE

The lgroup affinities are not inherited from the specified process or thread.

LGRP_AFF_INHERIT_FUTURE

The lgroup affinities will be inherited by future children of the specified process or thread.

Return Values

Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno is set to indicate the error.

Errors

The lgrp_affinity_inherit_set() function will fail if:

EACCES

Operation permission is denied to the calling process (see Intro(2)).

EINVAL

An invalid idtype, process or thread ID, or lgroup affinity inheritance was specified.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

Intro(2), exec(2), fork(2), lgrp_affinity_get(3LGRP), lgrp_affinity_inherit_get(3LGRP), lgrp_affinity_set(3LGRP), liblgrp(3LIB), pthread_create(3C), thr_create(3C), attributes(5)