crgetuid man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

ddi_cred(9F)		 Kernel Functions for Drivers		  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(5) for a description of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Architecture		     │All			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Evolving			   │
       └─────────────────────────────┴─────────────────────────────┘

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

       Writing Device Drivers

SunOS 5.10			  6 Aug 2003			  ddi_cred(9F)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net