setbltype(3)

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

NAME

bltype, setbltype- Compare and set the type of binary label

SYNOPSIS

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


#include <tsol/label.h>

int bltype(const void * label , const unsigned char type);
void setbltype(void * label , const unsigned char type);

DESCRIPTION

These functions compare and set the type of binary labels.

bltype() examines label to determine if it is of the specified type type .

setbltype() sets the type of label to the specified type type .

type may be one of:

SUN_SL_ID

label is a defined binary sensitivity label.

SUN_SL_UN

label is an undefined binary sensitivity label.

SUN_CLR_ID

label is a defined binary clearance.

SUN_CLR_UN

label is an undefined binary clearance.

SUN_CMW_ID

label is a binary CMW label whose sensitivity label and information label portions may or may not be defined. ( bltype() only.)

ATTRIBUTES

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

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

RETURN VALUES

bltype() returns non-zero if label is of type type, otherwise zero is returned.

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) , blvalid(3) , btohex(3) , hextob(3) , labelinfo(3) , labelvers(3) , sbltos(3) , stobl(3)

Trusted Solaris Developer's Guide

SunOS 5.7 Reference Manual

attributes(5)

WARNINGS

• bltype(&cmw_label, SUN_CMW_ID) checks the existence of a binary CMW label structure and not the portions of the structure that contain defined labels.

• When attempting to determine the type of a label, rather than to verify that a specific label type is present, check SUN_CMW_ID first.

• setbltype() makes no checks on the structure it is setting or the type value.

NOTES

Information labels ( IL s) are not supported in Trusted Solaris 7 and later releases. Trusted Solaris software interprets any IL s 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 has the following characteristics:

• IL s do not display in window labels; SL s (Sensitivity Labels) display alone within brackets.

• IL s 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 IL s are always ADMIN_LOW , and cannot be set on any objects.

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