*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> sia_get_groups (3)              



NAME    [Toc]    [Back]

       sia_get_groups - retrieve user's group information for SIA
       (Security Integration Architecture)

SYNOPSIS    [Toc]    [Back]

       #include <sia.h> #include <siad.h>

       int sia_get_groups(
               const char *username,
               gid_t basegid,
               gid_t *buffer,
               int *ngroups );

LIBRARY    [Toc]    [Back]

       Standard C library (libc.so and libc.a)

PARAMETERS    [Toc]    [Back]

       The name of the user whose  group  information  should  be
       written  to the buffer array. This parameter is read only.
       If not ((gid_t)-1), this GID will  appear  in  the  buffer
       array in addition to any other groups found for this user.
       This is normally used to pass  the  user's  GID  from  the
       password  information,  since  the  GID is not necessarily
       listed in the group information obtained with  getgrent().
       The  array  into which this routine writes the accumulated
       GIDs for the specified user.   On  input,  this  parameter
       points to an integer that represents the maximum number of
       entries allowed for the buffer array.  When  this  routine
       returns, it updates this value to be the number of entries
       which were found. On failure, the value is  indeterminate.

DESCRIPTION    [Toc]    [Back]

       The  sia_get_groups() routine is called to obtain a user's
       group array.

RETURN VALUES    [Toc]    [Back]

       This routine returns SIA_SUCCESS if all the incoming arguments
  are  correct (non-null pointers, non-null username,
       and *ngroups must be positive), and if none of the configured
  mechanism  functions for group processing returned a
       fatal error.  Finding more than *ngroups GIDs for the user
       is  one  such fatal error, and is the only one defined for
       all mechanisms.  If a fatal error is encountered in one of
       the    configured   mechanisms,   this   routine   returns
       SIAFAIL|SIASTOP.  If there are parameter errors, or  if  a
       getgrent_r call fails, this routine returns SIAFAIL.

ERRORS    [Toc]    [Back]

       While errno will usually be propagated from whatever other
       calls failed, this routine will return with errno  explicitly
  set for the following conditions: One of the pointer
       arguments was NULL.  *username was 0, or *ngroups was  not
       positive.   Thread  context  failure  while  scanning  for

EXAMPLES    [Toc]    [Back]

       A typical call to obtain a user's group array follows:

            #include <sia.h>
               int ngroups;
               gid_t groups[NGROUPS];
               struct passwd *pw;
               extern char *username;

               pw = getpwnam(username);
               if (pw == NULL)
                       return 0;
               ngroups = NGROUPS;
               if (sia_get_groups(username,  pw->pw_gid,  groups,
                   != SIASUCCESS)
                       return 0;

               /* process group array here */

FILES    [Toc]    [Back]


SEE ALSO    [Toc]    [Back]

       getgrent(3),         matrix.conf(4),        initgroups(3),
       siad_get_groups(3) _sia_isagroup(3)


[ Back ]
 Similar pages
Name OS Title
siad_endgrent Tru64 group routines for SIA (Security Integration Architecture)
siad_getgrgid Tru64 group routines for SIA (Security Integration Architecture)
siad_getgrent Tru64 group routines for SIA (Security Integration Architecture)
siad_setgrent Tru64 group routines for SIA (Security Integration Architecture)
siad_getgrnam Tru64 group routines for SIA (Security Integration Architecture)
siad_chk_user Tru64 check user dependent routine for SIA (Security Integration Architecture)
sia_become_user Tru64 su routine for SIA (Security Integration Architecture)
sialog Tru64 SIA (Security Integration Architecture) log file
siad_setpwent Tru64 password routines for SIA (Security Integration Architecture)
sia_ses_suauthent Tru64 SIA session routines (Security Integration Architecture)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service