sgi_getcapabilitybyname(3C)

NAME
     sgi_getcapabilitybyname - get the default and allowed capability sets for
     a named user

SYNOPSIS
     #include <capability.h>

     struct user_cap *sgi_getcapabilitybyname(const char *name);

DESCRIPTION
     Return the default and allowed capability sets for the user name.  The
     routine uses the NIS map capability.byname if NIS is active, otherwise it
     uses the local capabilities file, /etc/capability.

RETURN VALUES
     The routine returns a pointer to an allocated struct user_cap. This
     structure and its components (cap->ca_name, cap->ca_default and cap-
     >ca_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          capabilities are not enabled.

SEE ALSO
     capabilities(4)