NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO
#include <pd/chPd.h>int ptdRemoteSet(KnCap *actorcap, int threadli, PdKey key, const void *value);
PRIVATE-DATA
The ptdRemoteSet call associates a thread-specific value with a key (obtained via a previous call to ptdKeyCreate (2K)) for the thread whose local identifier is threadli in the actor whose capability is given by actorcap.
If actorcap is K_MYACTOR, the thread used must belong to the current actor. In this case, if threadli is K_MYSELF, the current thread is used.
Different threads may bind different values to the same key. These values are typically pointers to blocks of dynamically allocated memory that have been reserved for use by the calling thread.
In user mode, actorcap must represent the current actor.
Upon successful completion a value of 0 is returned. Otherwise, a positive error code is returned.
The key value is invalid, or threadli does not belong to the target actor, or actorcap is an inconsistent actor capability.
There is insufficient memory to associate the value with the key.
The Private Data Manager is unreachable.
The target actor and the current actor must be located on the same site.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO