NAME

door_revoke − revoke access to a door descriptor

SYNOPSIS

#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(3X).  door_revoke() 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.  Upon failure, door_revoke() returns -1 and sets errno to indicate the error. 

ERRORS

The door_revoke() function fails if one or more of the following are true:

EBADF An invalid door descriptor was passed. 

EPERM The door descriptor was not created by this process (with door_create(3X)). 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

SEE ALSO

close(2), door_create(3X), attributes(5)

SunOS 5.6  —  Last change: 26 Nov 1996