Current File : //usr/man/man3c/door_cred.3c

'\" te
.\" Copyright (c) 2005, Sun Microsystems, Inc.  All Rights Reserved.
.TH door_cred 3C "22 Mar 2005" "SunOS 5.11" "Standard C Library Functions"
.SH NAME
door_cred \- return credential information associated with the client
.SH SYNOPSIS
.LP
.nf
\fBcc\fR \fB-mt\fR [ \fIflag\fR... ] \fIfile\fR... [ \fIlibrary\fR... ]
#include <door.h>

\fBint\fR \fBdoor_cred\fR(\fBdoor_cred_t *\fR\fIinfo\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The  \fBdoor_cred()\fR function returns credential information associated with the  client (if any) of the current door invocation.
.sp
.LP
The contents of the \fIinfo\fR argument include the following fields:
.sp
.in +2
.nf
uid_t   dc_euid;        /* Effective uid of client */
gid_t   dc_egid;        /* Effective gid of client */
uid_t   dc_ruid;        /* Real uid of client */
gid_t   dc_rgid;        /* Real gid of client */
pid_t   dc_pid;         /* pid of client */
.fi
.in -2

.sp
.LP
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.
.SH RETURN VALUES
.sp
.LP
Upon successful completion, \fBdoor_cred()\fR returns \fB0\fR. Otherwise, \fBdoor_cred()\fR returns \fB\(mi1\fR and sets \fBerrno\fR to indicate the error.
.SH ERRORS
.sp
.LP
The  \fBdoor_cred()\fR function will fail if:
.sp
.ne 2
.mk
.na
\fB\fBEFAULT\fR\fR
.ad
.RS 10n
.rt  
The address of the \fIinfo\fR argument is invalid.
.RE

.sp
.ne 2
.mk
.na
\fB\fBEINVAL\fR\fR
.ad
.RS 10n
.rt  
There is no associated door client.
.RE

.SH USAGE
.sp
.LP
The \fBdoor_cred()\fR function is obsolete. Applications should use the \fBdoor_ucred\fR(3C) function in place of \fBdoor_cred()\fR.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Architectureall
_
Availabilitysystem/core-os
_
Interface StabilityObsolete
_
MT-LevelSafe
.TE

.SH SEE ALSO
.sp
.LP
\fBdoor_call\fR(3C), \fBdoor_create\fR(3C), \fBdoor_ucred\fR(3C), \fBattributes\fR(5)