labelinfo(3TSOL)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | FILES | ATTRIBUTES | SEE ALSO | WARNINGS | BUGS

NAME

labelinfo– get information about the label encodings

SYNOPSIS

cc [flag…] file… -ltsol [library…]


#include <tsol/label.h>

int labelinfo(struct label_info *info);

DESCRIPTION

Information about the label encodings is returned in the label_info structure pointed to by info.

struct label_info{
short	ilabel_len;        /*obsolete */
short	slabel_len;        /*max sensitivity label length */
short	clabel_len;        /*max CMW label length */
short	clear_len;         /*max clearance label length */
short	vers_len;          /*version string length */
short	header_len;        /*max len of banner page header */
short	protect_as_len;    /*max len of banner page protect as */
short	caveats_len;       /*max len of banner page caveats */
short	channels_len;      /*max len of banner page channels */
};  

The fields in this structure have the following values:

ilabel_len

Obsolete.

slabel_len

The maximum length of a character–coded sensitivity label returned when translated from a binary sensitivity label.

clabel_len

The maximum length of a character–coded CMW label returned when translated from a binary CMW label.

clear_len

The maximum length of a character–coded clearance returned when translated from a binary clearance.

vers_len

The length of the label_encodings file version string returned by labelvers().

header_len

The maximum length of a printer banner page header string returned by bcltobanner().

protect_as_len

The maximum length of a printer banner page “protect_as” string returned by bcltobanner().

caveats_len

The maximum length of a printer banner page caveats string returned by bcltobanner().

channels_len

The maximum length of a printer banner page channels string returned by bcltobanner().

RETURN VALUES

labelinfo() returns:

1

On success.

-1

If the label_encodings information is unavailable.

FILES

/etc/security/tsol/label_encodings

The label encodings file contains the classification names, words, constraints, and values for the defined labels of this system.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWtsu
MT-Level	MT-Safe

SEE ALSO

Trusted Solaris 8 HW 12/02 Reference Manual

bcltobanner(3TSOL), blcompare(3TSOL), bltocolor(3TSOL), blvalid(3TSOL), hextob(3TSOL)

Trusted Solaris Developer's Guide

SunOS 5.8 Reference Manual

attributes(5)

WARNINGS

If the label_encodings file is modified after an application gets information about it, that information may be out of date.

BUGS

The label_encodings file is rarely updated on a running system and there is no way of informing an application that the label_encodings file has been modified.

Trusted Solaris 8 HW 12/02  Last Revised 24 May 2001

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | FILES | ATTRIBUTES | SEE ALSO | WARNINGS | BUGS