NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO
#include <ipc/chIpc.h>int portPi(KnCap *actorcap, int portli, KnProtId *oldpi, KnProtId *newpi);
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.
IPC
The portPi call gets and/or sets the protection identifier of the port whose local identifier is portli in the actor whose capability is given by actorcap (see actorCreate(2K)).
If actorcap is K_MYACTOR, the operation is applied to the current actor.
If portli is K_DEFAULTPORT, the actor's default port is used.
The oldpi and newpi fields are pointers to KnProtId structures whose members are the following:
unsigned short uid ; unsigned short gid ; unsigned short did ;
The user identifier is uid, the group identifier is gid, and the domain identifier is did.
The corresponding port's protection identifier is copied into the structure pointed to by oldpi in the client address space. The new corresponding context is copied from the structure pointed to by newpi.
If oldpi is a NULL pointer, the port's protection identifier is not copied to the caller's address space. If newpi is a NULL pointer, the port's protection identifier is not modified. The caller thread must be a SUPERVISOR thread (see threadCreate(2K)) or must belong to a SYSTEM actor (see actorCreate(2K)).
Upon successful completion a value of 0 is returned. Otherwise, a negative error code is returned.
Some of the data provided are outside the current actor's address space.
actorcap is an inconsistent actor capability.
The current thread is neither a supervisor thread nor a thread of a system actor.
actorcap does not specify a reachable actor.
portli is not a valid port identifier in the actor.
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