DOOR_REVOKE(3C) Standard C Library Functions DOOR_REVOKE(3C)
door_revoke - revoke access to a door descriptor
cc -mt [ flag... ] file... [ library... ]
#include <door.h>
int door_revoke(int d);
The door_revoke() function revokes access to a door descriptor. Door
descriptors are created with door_create(3C). The door_revoke()
function 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()
invocation are allowed to complete normally.
Upon successful completion, door_revoke() returns 0. Otherwise,
door_revoke() returns -1 and sets errno to indicate the error.
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)).
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Architecture | all |
+--------------------+-----------------+
|Interface Stability | Stable |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+
close(2), door_create(3C), attributes(7)
March 22, 2005 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()
function 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()
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(3C)).
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Architecture | all |
+--------------------+-----------------+
|Interface Stability | Stable |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+
SEE ALSO
close(2), door_create(3C), attributes(7)
March 22, 2005 DOOR_REVOKE(3C)