DOOR_UCRED(3C) Standard C Library Functions DOOR_UCRED(3C)
NAME
door_ucred - return credential information associated with the client
SYNOPSIS
cc -mt [
flag... ]
file... [
library... ]
#include <door.h>
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 location was previously
NULL. If that location was non-null,
door_ucred() assumes that
info points to a previously allocated
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 necessarily from the first
thread in a chain of door calls.
RETURN VALUES
Upon successful completion,
door_ucred() returns 0. Otherwise, -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 allocating
memory sufficient to hold a ucred failed.
EFAULT The address of the
info argument is invalid.
EINVAL There is no associated door client.
ENOMEM The location pointed to by
info was
NULL and allocating
memory sufficient to hold a ucred failed.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Stable |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+
SEE ALSO
door_call(3C),
door_create(3C),
ucred_get(3C),
attributes(7) March 22, 2005 DOOR_UCRED(3C)
