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()
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)