labelinfo(3TSOL)

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

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:

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

NOTES

Information labels (ILs) are not supported in Trusted Solaris 7 and later releases. Trusted Solaris software interprets any ILs on communications and files from systems running earlier releases as ADMIN_LOW.

Objects still have CMW labels, and CMW labels still include the IL component: IL[SL]; however, the IL component is fixed at ADMIN_LOW.

As a result, Trusted Solaris 7 and later releases have the following characteristics:

• ILs do not display in window labels; SLs (Sensitivity Labels) display alone within brackets.

• ILs do not float.

• Setting an IL on an object has no effect.

• Getting an object's IL will always return ADMIN_LOW.

• Although certain utilities, library functions, and system calls can manipulate IL strings, the resulting ILs are always ADMIN_LOW, and cannot be set on any objects.

Trusted Solaris 8  Last Revised 14 Jan 1997

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