SGI_GETCAPABILITYBYNAME(3C)			   SGI_GETCAPABILITYBYNAME(3C)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <capability.h>

     struct user_cap *sgi_getcapabilitybyname(const char *name);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     ENOSYS	     capabilities are not enabled.

SEE ALSO    [Toc]    [Back]

     capabilities(4)


									PPPPaaaaggggeeee 1111