door_revoke(3C) Standard C Library Functions door_revoke(3C)
NAME
door_revoke - revoke access to a door descriptor
SYNOPSIS
cc -mt [ flag... ] file... [ 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(3C). The door_revoke() func-
tion performs an implicit call to close(2), marking the door descriptor d as invalid.
A door descriptor can be revoked only 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(3C)).
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Architecture |all |
+-----------------------------+-----------------------------+
|Availability |SUNWcsu |
+-----------------------------+-----------------------------+
|Interface Stability |Stable |
+-----------------------------+-----------------------------+
|MT-Level |Safe |
+-----------------------------+-----------------------------+
SEE ALSO
close(2), door_create(3C), attributes(5)
SunOS 5.11 22 Mar 2005 door_revoke(3C)