svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
ucred_get(3c)
ucred_get(3C) Standard C Library Functions ucred_get(3C)
NAME
ucred_get, ucred_free, ucred_geteuid, ucred_getruid, ucred_getsuid,
ucred_getegid, ucred_getrgid, ucred_getsgid, ucred_getgroups,
ucred_getprivset, ucred_getpid, ucred_getprinc, ucred_getprojid,
ucred_getzoneid, ucred_getpflags, ucred_getlabel, ucred_size - user
credential functions
SYNOPSIS
#include <ucred.h>
ucred_t *ucred_get(pid_t pid);
void ucred_free(ucred_t *uc);
uid_t ucred_geteuid(const ucred_t *uc);
uid_t ucred_getruid(const ucred_t *uc);
uid_t ucred_getsuid(const ucred_t *uc);
gid_t ucred_getegid(const ucred_t *uc);
gid_t ucred_getrgid(const ucred_t *uc);
gid_t ucred_getsgid(const ucred_t *uc);
int ucred_getgroups(const ucred_t *uc, const gid_t **groups);
const priv_set_t *ucred_getprivset(const ucred_t *uc,
priv_ptype_t set);
pid_t ucred_getpid(const ucred_t *uc);
const char *ucred_getprinc(const ucred_t *uc);
projid_t ucred_getprojid(const ucred_t *uc);
zoneid_t ucred_getzoneid(const ucred_t *uc);
uint_t ucred_getpflags(const ucred_t *uc, uint_t flags);
m_label_t *ucred_getlabel(const ucred_t *uc);
size_t ucred_size(void);
DESCRIPTION
These functions return or act on a user credential, ucred_t. User cre‐
dentials are returned by various functions and describe the credentials
of a process. Information about the process can then be obtained by
calling the access functions. Access functions can fail if the underly‐
ing mechanism did not return sufficient information.
The ucred_get() function returns the user credential of the specified
pid or NULL if none can be obtained. A pid value of P_MYID returns in‐
formation about the calling process. The return value is dynamically
allocated and must be freed using ucred_free().
The ucred_geteuid(), ucred_getruid(), ucred_getsuid(), ucred_getegid(),
ucred_getrgid(), and ucred_getsgid() functions return the effective
UID, real UID, saved UID, effective GID, real GID, saved GID, respec‐
tively, or -1 if the user credential does not contain sufficient infor‐
mation.
The ucred_getgroups() function stores a pointer to the group list in
the gid_t * pointed to by the second argument and returns the number of
groups in the list. It returns -1 if the information is not available.
The returned group list is valid until ucred_free() is called on the
user credential given as argument.
The ucred_getpid() function returns the process ID of the process or -1
if the process ID is not available. The process ID returned in a user
credential is only guaranteed to be correct in a very limited number of
cases when returned by door_ucred(3C) and ucred_get(). In all other
cases, the process in question might have handed of the file descrip‐
tor, the process might have exited or executed another program, or the
process ID might have been reused by a completely unrelated process af‐
ter the original program exited.
The ucred_getprinc() function returns a null-terminated string contain‐
ing the kerberos principal associated with the credential. The returned
pointer remains valid until ucred_free() is called on the user creden‐
tial given as argument. The function returns NULL if there is no ker‐
beros principal associated with the credential.
The ucred_getprojid() function returns the project ID of the process or
-1 if the project ID is not available.
The ucred_getzoneid() function returns the zone ID of the process or −1
if the zone ID is not available.
The ucred_getprivset() function returns the specified privilege set
specified as second argument, or NULL if either the requested informa‐
tion is not available or the privilege set name is invalid. The re‐
turned privilege set is valid until ucred_free() is called on the spec‐
ified user credential.
The ucred_getpflags() function returns the value of the specified priv‐
ilege flags from the ucred structure, or (uint_t)-1 if none was
present.
The ucred_getlabel() function returns the value of the label, or NULL
if the label is not available. The returned label is valid until
ucred_free() is called on the specified user credential.
The ucred_free() function frees the memory allocated for the specified
user credential.
The ucred_size() function returns sizeof(ucred_t). This value is con‐
stant only until the next boot, at which time it could change. The
ucred_size() function can be used to determine the size of the buffer
needed to receive a credential option with SO_RECVUCRED. See
socket.h(3HEAD).
RETURN VALUES
See DESCRIPTION.
ERRORS
The ucred_get() function will fail if:
EAGAIN There is not enough memory available to allocate sufficient
memory to hold a user credential. The application can try
again later.
EACCES The caller does not have sufficient privileges to examine the
target process.
EMFILE The calling process cannot open any more files.
ENFILE
ENOMEM The physical limits of the system are exceeded by the memory
allocation needed to hold a user credential.
ESRCH The target process does not exist.
The ucred_getprivset() function will fail if:
EINVAL The privilege set argument is invalid.
The ucred_getlabel() function will fail if:
EINVAL The label is not present.
The ucred_geteuid(), ucred_getruid(), ucred_getsuid(), ucred_getegid(),
ucred_getrgid(), ucred_getsgid(), ucred_getgroups(), ucred_getlabel(),
ucred_getpflags(), ucred_getpid(), ucred_getprinc(), ucred_get‐
privset(), and ucred_getprojid() functions will fail if:
EINVAL The requested user credential attribute is not available in
the specified user credential.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelMT-Safe
SEE ALSO
getpflags(2), getppriv(2), door_ucred(3C), getpeerucred(3C),
priv_set(3C), socket.h(3HEAD), attributes(7), labels(7), privileges(7)
HISTORY
Support for the following functions is available in Oracle Solaris
starting with the listed release:
tab() box; cw(4.12i) |cw(1.37i) lw(4.12i) |lw(1.37i) FUNCTIONRELEASE _
ucred_getprinc() 11.4.63 _ ucred_getlabel() 10 11/06 (Update 3) _ T{
ucred_get(), ucred_free(), ucred_size(), ucred_getegid(),
ucred_geteuid(), ucred_getgroups(), ucred_getlabel(),
ucred_getpflags(), ucred_getpid(), ucred_getprivset(),
ucred_getprojid(), ucred_getrgid(), ucred_getruid(), ucred_getsgid(),
ucred_getsuid(), ucred_getzoneid() T} 10 3/05
Oracle Solaris 11.4 4 Dec 2023 ucred_get(3C)