Index for Section 3

Alphabetical listing for S

Bottom of page

siad_getgrent(3)
NAME
  siad_getgrent, siad_getgrgid, siad_getgrnam, siad_setgrent, siad_endgrent -
  group routines for SIA (Security Integration Architecture)

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

  int siad_getgrent(
	  struct group *result,
	  char *buffer,
	  int buflen,
	  FILE **context );

  int siad_getgrgid(
	  gid_t gid,
	  struct group *result,
	  char *buffer,
	  int buflen );

  int siad_getgrnam(
	  char *name,
	  struct group *result,
	  char *buffer,
	  int buflen );

  int siad_setgrent(
	  FILE **context );

  int siad_endgrent(
	  FILE **context );

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

PARAMETERS
  result
      The result parameter is used to provide a result. The actual result
      string is placed in the buffer provided and result points to the
      resultant struct group in the buffer. Values in the passwd structure
      may be changed by the siad_*gr* routines.

  buffer
      The buffer parameter is a pointer to a buffer which holds the resultant
      struct group. This parameter is read only.

  buflen
      The buflen parameter is the length of the buffer in chars. This
      parameter is read only.

  gid The gid parameter is the group identifier (GID) for the request. This
      parameter is read only.

  name
      The name parameter specifies the group name for the request. This
      parameter is read only.

  context
      A pointer to the location that records which I/O stream is to be used.

DESCRIPTION
  siad_getgrent()

  The siad_getgrent() routine is called indirectly (by the sia_switch()
  function) from the sia_getgroup() routine which is called from the libc and
  libc_r routines getgrent() and getgrent_r() respectively. The buffer for
  the group information is  preallocated and a thread lock has been taken in
  the thread safe mode.

  siad_getgrgid()

  This routine is called indirectly (by the sia_switch() function) from the
  sia_getgroup() routine which is called from the libc and libc_r routines
  getgrgid and getgrgid_r respectively. The buffer for the group information
  is preallocated and a thread lock has been taken in the thread safe mode.

  siad_getgrnam()

  This routine is called indirectly (by the sia_switch function) from the
  sia_getgroup() routine which is called from the libc and libc_r routines
  getgrnam and getgrnam_r respectively. The buffer for the group information
  is preallocated and a thread lock has been taken in the thread safe mode.

  siad_setgrent()

  This routine is called by the sia_getgroup() routine to start or initialize
  a series of getgrent calls.

  siad_endgrent()

  This routine is called to close or complete the processing of a getgrent()
  series of calls.

RETURN VALUES
  The siad_*gr*() routines return bitmapped values which indicate the
  following status:

  SIADSUCCESS
      Indicates unconditional success. All bits set to 0.

  SIADFAIL
      Indicates conditional failure. Lowest bit set to 1. If other security
      mechanism are in place, continue.

  SIADSTOP
      Indicates unconditional failure. Do not continue. Second lowest bit set
      to 1.

ERRORS
  The errno values are those returned from the dynamic loader interface, from
  the (siad_*) routines, or from malloc. Possible errors include resource
  constraints (no memory) and various authentication failures.

FILES
  /etc/group

  /etc/sia/matrix.conf

SEE ALSO
  sia_getgroup(3), matrix.conf(4)

  Security

Index for Section 3

Alphabetical listing for S

Top of page