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() func-
       tion 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() 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(3C)).

ATTRIBUTES

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

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

SEE ALSO

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

SunOS 5.11							    22 Mar 2005 						   door_revoke(3C)