개요

• 솔라나라에 설명된 어플리케이션에 대해 맨 페이지를 찾아 출력한다.
• MAN 페이지에 대한 설명은 윈디하나의 솔라나라: MAN 페이지을 참고하자.
• svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.

ddi_cred(9f)

ddi_cred(9F)                   Kernel Functions                   ddi_cred(9F)



NAME
       ddi_cred,  crgetuid, crgetruid, crgetsuid, crgetgid, crgetrgid, crgets‐
       gid, crgetzoneid, crgetgroups, crgetngroups - access and  change  parts
       of the cred_t structure

SYNOPSIS
       #include <sys/cred.h>

       uid_t crgetuid(const cred_t *cr);


       uid_t crgetruid(const cred_t *cr);


       uid_t crgetsuid(const cred_t *cr);


       gid_t crgetgid(const cred_t *cr);


       gid_t crgetrgid(const cred_t *cr);


       gid_t crgetsgid(const cred_t *cr);


       zoneid_t crgetzoneid(const cred_t *cr);


       const gid_t *crgetgroups(const cred_t *cr);


       int crgetngroups(const cred_t *cr);


       int crsetresuid(cred_t *cr, uid_t ruid, uid_t euid, uid_t suid);


       int crsetresgid(cred_t *cr, gid_t rgid, gid_t egid, gid_t sgid);


       int crsetugid(cred_t *cr, uid_t uid, gid_t gid);


       int crsetgroups(cred_t *cr, int ngroups, gid_t gids);

INTERFACE LEVEL
       Solaris DDI specific (Solaris DDI).

PARAMETERS
       cr                       pointer to the user credential structure


       uid, ruid, euid, suid    new user id, real, effective and saved user id


       gid, rgid, egid, sgid    new  group id, real, effective and saved group
                                id


       ngroups                  number of groups in the group array


       gids                     pointer to array of new groups


DESCRIPTION
       The user credential is a shared, read-only, ref-counted data structure.
       Its  actual  size  and  layout  are  subject  to  change. The functions
       described in this page allow the programmer to retrieve fields from the
       structure and to initialize newly allocated credential structures.


       crgetuid(),  crgetruid(),  and  crgetsuid()  return,  respectively, the
       effective, real, and saved user id from the user credential pointed  to
       by cr.


       crgetgid(),  crgetrgid(),  and  crgetsgid()  return,  respectively, the
       effective, real, and saved group id from the user credential pointed to
       by cr.


       crgetzoneid()  returns  the zone id from the user credential pointed to
       by cr.


       crgetgroups() returns the group list of the user credential pointed  to
       by cr.


       crgetngroups()  returns  the  number  of  groups in the user credential
       pointed to by cr.


       crsetresuid() sets the real, effective and saved user id. All  but  one
       can be specified as -1, which causes the original value not to change.


       crsetresgid()  sets the real, effective and saved group id. All but one
       can be specified as -1, which causes the original value not to change.


       crsetugid() initializes the real, effective and saved user  id  all  to
       uid. It initializes the real, effective, and saved group id all to gid.


       crsetgroups()  sets  the  number  of  groups  in the user credential to
       ngroups and copies the groups from gids  to  the  user  credential.  If
       ngroups is 0, gids need not point to valid storage.


       It  is  an  error  to call this any of the crset*() functions on a user
       credential structure that was newly allocated.

RETURN VALUES
       The crget*() functions return the requested information.


       The crset*id() functions return 0 on success and -1 if any of the spec‐
       ified  ids  are  invalid.  The  functions might cause a system panic if
       called on a user credential structure that is referenced by other parts
       of the system.

CONTEXT
       These functions can be called from user and kernel contexts.

ATTRIBUTES
       See attributes(7) for a description of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ ArchitectureAll _ Interface StabilityCommitted


SEE ALSO
       attributes(7), privileges(7), drv_priv(9F)


       Writing Device Drivers in Oracle Solaris 11.4



Oracle Solaris 11.4               6 Aug 2003                      ddi_cred(9F)