labelinfo(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | FILES | 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;		/*max information label length */
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

The maximum length of a character-coded information label returned when translated from a binary information label.

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.

ATTRIBUTES

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

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

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.

SEE ALSO

Trusted Solaris 7 Reference Manual

bcltobanner(3), bilconjoin(3), blcompare(3), blinset(3), blmanifest(3), blminmax(3), blportion(3), bltocolor(3), bltos(3), bltype(3), blvalid(3), btohex(3), hextob(3), labelvers(3), sbltos(3), stobl(3), label_encodings(4)

Trusted Solaris Developer's Guide

SunOS 5.7 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.

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