*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> cap_acquire (3c)              



NAME    [Toc]    [Back]

     cap_acquire, cap_surrender	 - make	permitted set capabilities effective
     or	remove effective capabilities

SYNOPSIS    [Toc]    [Back]

     #include <sys/capability.h>

     cap_t cap_acquire(	int ncap, const	cap_value_t *caps);
     void cap_surrender( cap_t cap);

DESCRIPTION    [Toc]    [Back]

     cap_acquire activates the capabilities from the permitted set of the
     process by	making each of them active in the effective set	for the

     cap_surrender sets	the effective set to the capabilities specified	in the
     cap argument, and deallocates this	structure.

RETURN VALUES    [Toc]    [Back]

     cap_acquire returns the previous effective	set, or	NULL if	there were
     errors. NULL may also be returned if the process has no current
     capability	set.  This return value	has been allocated by the library, and
     should be freed when no longer needed, most commonly by calling
     cap_surrender to revert the effective set to its prior value.
     cap_free(3c) may also be called directly to deallocate the	structure.

     cap_surrender has no return value.

ERRORS    [Toc]    [Back]


     EINVAL	     caps is null.

     ENOSYS	     capabilities are not enabled.

SEE ALSO    [Toc]    [Back]

     cap_free(3c), capabilities(4).

									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
cap_from_text IRIX convert a POSIX capabilities string to internal form, convert capabilities to a POSIX capabilities string, or
term HP-UX terminal capabilities
cap_get_file IRIX get or set the capabilities for a pathname
capget Linux set/get process capabilities
TERM HP-UX terminal capabilities
term.h HP-UX terminal capabilities
term_c HP-UX terminal capabilities
cap_get_proc IRIX get or set process capabilities
pxfgeteuid IRIX Gets effective user ID
pxfgetegid IRIX Gets the effective group ID
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service