door_revoke(3DOOR) Door Library Functions door_revoke(3DOOR)NAMEdoor_revoke - revoke access to a door descriptor
SYNOPSIS
cc -mt [ flag ... ] file ... -ldoor [ library ... ]
#include <door.h>
int door_revoke(int d);
DESCRIPTION
The door_revoke() function revokes access to a door descriptor. Door
descriptors are created with door_create(3DOOR). The door_revoke()
function performs an implicit call to close(2), marking the door
descriptor d as invalid.
A door descriptor can only be revoked by the process that created it.
Door invocations that are in progress during a door_revoke() invocation
are allowed to complete normally.
RETURN VALUES
Upon successful completion, door_revoke() returns 0. Otherwise,
door_revoke() returns −1 and sets errno to indicate the error.
ERRORS
The door_revoke() function will fail if:
EBADF An invalid door descriptor was passed.
EPERM The door descriptor was not created by this process
(with door_create(3DOOR)).
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Architecture │all │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcsu │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Evolving │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOclose(2), door_create(3DOOR), libdoor(3LIB), attributes(5)SunOS 5.10 21 Aug 1997 door_revoke(3DOOR)