CAP_FROM_TEXT(3C)CAP_FROM_TEXT(3C)NAME
cap_from_text, cap_to_text, cap_value_to_text - convert a POSIX
capabilities string to internal form, convert capabilities to a POSIX
capabilities string, or return the POSIX name for a capability value
SYNOPSIS
#include <sys/capability.h>
cap_t cap_from_text(const char *argp);
char * cap_to_text(cap_t cap, ssize_t *len_p);
char * cap_value_to_text( cap_value_t capv);
DESCRIPTION
These routines convert strings defined by the POSIX P1003.1e
specifications (see chcap(1)capabilities(4)) to/from cap_t, which is the
internal format for an capability set (see capability(4)).
RETURN VALUES
cap_from_text returns a pointer to a cap_t allocated by the routine or a
NULL pointer in the case of a failure. The storage should be freed when
no longer needed by calling cap_free(3c).
cap_to_text returns a pointer to a null terminated character string
allocated by the routine which is a long form representation of the
capability, or a NULL pointer if an error occurred. This string should
be freed when no longer needed by calling cap_free(3c). If the len_p
argument is not NULL, then the length of the string is returned in
ssize_t pointed to by len_p.
cap_value_to_text returns a pointer to the POSIX capability name
corresponding to the argument capv.
ERRORS
cap_from_text:
EINVAL input text is invalid
ENOMEM could not allocate space for new capability
cap_to_text:
EINVAL input cap is invalid
ERANGE could not allocate space for the return string
cap_value_to_text
EINVAL capv is not a valid capability value.
ENOMEM could not allocate space for the return string
Page 1
CAP_FROM_TEXT(3C)CAP_FROM_TEXT(3C)SEE ALSOcap_get_proc(3C), cap_set_proc(3C), capability(4), capabilities(4),
dominance(5), chcap(1), attr(1),
Page 2
