dg_has_priv_creds(3) — DG/UX R4.11MU05



dg_has_priv_creds(3)           DG/UX R4.11MU05          dg_has_priv_creds(3)


NAME
       dghasprivcreds - determine whether credentials grant appropriate
       privilege

SYNOPSIS
       #include <capability.h>
       #include <dgevents.h>

       int dghasprivcreds (char *eventname, privcredentialst
              *credentialsptr)

   where:
       eventname       The event for which to check privilege
       credentialsptr  A pointer to a credentials structure for the
                        hypothetical subject

DESCRIPTION
       The dghasprivcreds routine determines whether a hypothetical
       process with specified credentials has appropriate privilege to
       satisfy a specified event.  The structure pointed to by
       credentialsptr contains a UID value and an effective capability set
       value.

       On systems where the capability feature is present, appropriate
       privilege is determined by comparing the effective capability set
       value with the capability list associated with the specified event.
       The hypothetical subject has appropriate privilege if the capability
       list is a subset of the effective capability set value.

       On systems where the capability feature is absent, the hypothetical
       subject has appropriate privilege if the UID value is 0.

FILES
       /etc/tcb/cap/events  Location of event definitions

DIAGNOSTICS
   Return Values
         0    The specified event requires privilege, and the hypothetical
              subject does not have appropriate privilege.

         1    The specified event requires privilege, and the hypothetical
              subject has appropriate privilege.

         2    The specified event does not require privilege.

SEE ALSO
       dghaspriveuid(3), dghasprivruid(3) dgrunningwith(3C).


Licensed material--property of copyright holder(s)
Museum
