door_revoke(3DOOR)					      Door Library Functions						door_revoke(3DOOR)

NAME

       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() 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(3DOOR)).

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Architecture		     |all			   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.10							    21 Aug 1997 						door_revoke(3DOOR)