Trusted Extensions Developer's Guide

Exit Print View

Updated: July 2014
 
 

Label APIs

This section describes the APIs that are available for basic label operations. To use these APIs, you must include the following header file:

#include tsol/label.h

The label APIs compile with the –ltsol library option.

    The Trusted Extensions APIs include data types for the following:

  • Sensitivity label – The m_label_t type definition represents a sensitivity label. The m_label_t structure is opaque.

    Interfaces accept a variable of type m_label_t as a parameter. Interfaces can return sensitivity labels in a variable of type m_label_t. The m_label_t type definition is compatible with the blevel_t structure.

  • Sensitivity label range – The brange_t data structure represents a range of sensitivity labels. The structure holds a minimum label and a maximum label. The structure fields are referred to as variable.lower_bound and variable.upper_bound.

    The APIs for the following operations are described in this section:

  • Enabling and disabling a Trusted Extensions system

  • Setting a specific label encodings file

  • Detecting a Trusted Extensions system

  • Accessing the process sensitivity label

  • Allocating and freeing memory for labels

  • Obtaining and setting the label of a file

  • Obtaining label ranges

  • Accessing labels in zones

  • Obtaining the remote host type

  • Translating between labels and strings

  • Comparing labels