Standard C Library Functions                       doorucred(3C)



NAME
     doorucred - return credential information  associated  with
     the client

SYNOPSIS
     cc -mt [ flag... ] file... [ library... ]
     #include 

     int doorucred(ucredt **info);


DESCRIPTION
     The  doorucred() function  returns  credential  information
     associated  with  the  client,  if  any, of the current door
     invocation.


     When successful, doorucred() writes a  pointer  to  a  user
     credential  to the location pointed to by info if that loca-
     tion was previously NUL. If  that  location  was  non-null,
     doorucred()  assumes that info points to a previously allo-
     cated ucredt which is then reused. The location pointed  to
     by  info  can be used multiple times before being freed. The
     value returned in info must be freed using ucredfree(3C).


     The resulting user credential includes information about the
     effective user and group ID, the real user and group ID, all
     privilege sets and the calling PID.


     The credential information associated with the client refers
     to  the  information  from  the immediate caller, not neces-
     sarily from the first thread in a chain of door calls.

RETURN VALUES
     Upon successful completion, doorucred() returns  0.  Other-
     wise, -1 is returned and errno is set to indicate the error,
     in which case the memory location pointed  to  by  the  info
     argument is unchanged.

ERORS
     The doorucred() function will fail if:

     EAGAIN    The location pointed to by info was NUL and allo-
               cating memory sufficient to hold a ucred failed.


     EFAULT    The address of the info argument is invalid.






SunOS 5.11          Last change: 22 Mar 2005                    1






Standard C Library Functions                       doorucred(3C)



     EINVAL    There is no associated door client.


     ENOMEM    The location pointed to by info was NUL and allo-
               cating memory sufficient to hold a ucred failed.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Stable                      
    
     MT-Level                     Safe                        
    


SEE ALSO
     doorcall(3C), doorcreate(3C), ucredget(3C), attributes(5)































SunOS 5.11          Last change: 22 Mar 2005                    2