sgi_getclearancebyname(3C)

NAME
     sgi_getclearancebyname - get the default and allowed mac label range for
     a named user

SYNOPSIS
     #include <clearance.h>

     struct clearance *sgi_getclearancebyname(const char *name);

DESCRIPTION
     Return the default and allowed mac label ranges for the user name.  The
     routine uses the NIS map clearance.byname if NIS is active,
      otherwise it uses the local clearance file, /etc/clearance.

RETURN VALUES
     The routine returns a pointer to an allocated struct clearance. This
     structure and its components (cap->cl_name, cap->cl_default and cap-
     >cl_allowed) have been allocated by the routine with malloc(3c) and
     should be released with free(3c) when no longer needed.

     If errors are encountered, or the specified user name could not be found,
     NULL is returned.

ERRORS
     ENOSYS          MAC is not enabled.

SEE ALSO
     clearance(4)