door_revoke(3DOOR) Door Library Functions door_revoke(3DOOR)
NAME
door_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() invoca-
tion 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 ALSO
close(2), door_create(3DOOR), libdoor(3LIB), attributes(5)
SunOS 5.10 21 Aug 1997 door_revoke(3DOOR)