NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO
#include <pd/chPd.h>int ptdRemoteSet(KnCap *actorcap, int threadli, PdKey key, const void *value);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
PRIVATE-DATA
The ptdRemoteSet() call associates a thread-specific value with a key, obtained using 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.
On successful completion, a value of 0 is returned. Otherwise, a positive error code is returned.
The key value is invalid, 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 | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO