Manual Pages for UNIX Operating System command usage for man door_ucred

Standard C Library Functions                       door_ucred(3C)



NAME
     door_ucred - return credential information  associated  with
     the client

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

     int door_ucred(ucred_t **info);


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


     When successful, door_ucred() writes a  pointer  to  a  user
     credential  to the location pointed to by info if that loca-
     tion was previously NULL. If  that  location  was  non-null,
     door_ucred()  assumes that info points to a previously allo-
     cated ucred_t 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 ucred_free(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, door_ucred() 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.

ERRORS
     The door_ucred() function will fail if:

     EAGAIN    The location pointed to by info was NULL 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                       door_ucred(3C)



     EINVAL    There is no associated door client.


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


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     door_call(3C), door_create(3C), ucred_get(3C), attributes(5)































SunOS 5.11          Last change: 22 Mar 2005                    2