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.
SEE ALSO
     capability(4), posix_capability_strings(4).