mac_text3
Convert mac label to/from text representation
Usage
#include <sys/mac.h>
int
mac_from_text(mac_t *mac, const char *text);
int
mac_to_text(mac_t label, char **text);
Library
Standard C Library (libc, -lc)
Overview
The mac_from_text() function converts the text representation of a label into the internal policy label format (mac_t) and places it in *mac, which must later be freed with mac_free(3).
The mac_to_text() function allocates storage for *text, which will be set to the text representation of label and must later be freed with free(3).
Refer to maclabel(7) for the MAC label format.
Return values
The mac_from_text() and mac_to_text() functions return the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
Compatibility
POSIX.1e does not define a format for text representations of MAC labels.
POSIX.1e requires that text strings allocated using mac_to_text() be freed using mac_free(3); in the FreeBSD implementation, they must be freed using free(3), as mac_free(3) is used only to free memory used for type mac_t.
Errors
- [ENOMEM]
-
Insufficient memory was available to allocate internal storage.
Releases
56 releases since FreeBSD 5.0-RELEASE; the text changed 40 times.