MSEN_FROM_TEXT(3C)MSEN_FROM_TEXT(3C)NAME
msen_from_text, msen_to_text - convert a MSEN string from/to msen_t
SYNOPSIS
#include <sys/mac.h>
msen_t msen_from_text(const char *argp);
char * msen_to_text(msen_t msenp, size_t *len_p);
DESCRIPTION
These routines convert a textual name of a mandatory sensitvity (MSEN)
label from/to a msen_t - a pointer to a structure representing the
mandatory sensitivity component of a MAC label.
msen_from_text translates a textual description of a MSEN label into a
msen_t and returns the result. msen_to_text translates a msen_t into a
character string describing the MSEN label. Both of these routines
allocate storage for the information returned. The allocated storage for
both can be released when no longer needed by calling msen_free(3c).
The len_p argument to msen_to_text is a pointer to a size_t that can be
used to hold the length of the returned string. If this argument is not
NULL, then the length of the string is placed in this location on return
from msen_to_text.
RETURN VALUES
If successful, msen_from_text returns a msen_t. Upon failure
msen_from_text returns a NULL pointer - a value of ((msen_t)0).
If successful, msen_to_text returns a pointer to an allocated null
terminated character string containing a representation of the MSEN
label. If an error occurs, msen_to_text returns a NULL pointer.
ERRORS
msen_from_text:
EINVAL input text is invalid
ENOMEM could not allocate space for new label
msen_to_text:
EINVAL input label is invalid
ENOMEM could not allocate space for the return string
SEE ALSOmsen_dom(3C), msen_equal(3C), msen_free(3C), msen_from_mac(3C)
Page 1