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

See Also

close(2), door_create(3DOOR), libdoor(3LIB), attributes(5)