Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
MAC_TEXT(3)	       FreeBSD Library Functions Manual		   MAC_TEXT(3)

NAME
     mac_from_text, mac_to_text	-- convert MAC label to/from text representa-
     tion

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <sys/mac.h>

     int
     mac_from_text(mac_t *mac, const char *text);

     int
     mac_to_text(mac_t label, char **text);

DESCRIPTION
     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 free(3).

     The mac_to_text() function	allocates storage for *text, which will	be set
     to	the text representation	of label.

     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.

SEE ALSO
     free(3), mac(3), mac_get(3), mac_is_present(3), mac_prepare(3),
     mac_set(3), posix1e(3), mac(4), maclabel(7)

STANDARDS
     POSIX.1e is described in IEEE POSIX.1e draft 17.  Discussion of the draft
     continues on the cross-platform POSIX.1e implementation mailing list.  To
     join this list, see the FreeBSD POSIX.1e implementation page for more
     information.

HISTORY
     Support for Mandatory Access Control was introduced in FreeBSD 5.0	as
     part of the TrustedBSD Project.

FreeBSD	10.1		       December	21, 2001		  FreeBSD 10.1

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | COMPATIBILITY | ERRORS | SEE ALSO | STANDARDS | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=mac_text&sektion=3&manpath=FreeBSD+10.0-RELEASE>

home | help