blvalid(3TSOL)

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

NAME

blvalid, bslvalid, bclearvalid- check validity of binary label

SYNOPSIS

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


#include <tsol/label.h>

int bslvalid(const bslabel_t *label);
int bclearvalid(const bclear_t *clearance);

DESCRIPTION

The calling process must have PRIV_SYS_TRANS_LABEL in its set of effective privileges to inquire about labels that dominate the current process' sensitivity label.

These functions check the validity of binary labels.

bslvalid() examines label to determine if it is a valid sensitivity label for this system.

bclearvalid() examines clearance to determine if it is a valid clearance for this system.

RETURN VALUES

These routines return:

-1

If the label_encodings file is inaccessible.

0

If the binary label is not valid for this system or is not dominated by the process' sensitivity label and the process does not have PRIV_SYS_TRANS_LABEL in its set of effective privileges,

1

If the binary label is valid for this system.

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 4/01 Reference Manual

bcltobanner(3TSOL), blcompare(3TSOL), bltocolor(3TSOL), btohex(3TSOL), labelinfo(3TSOL)

Trusted Solaris Developer's Guide

SunOS 5.8 Reference Manual

attributes(5)

NOTES

Binary sensitivity labels are valid if they are contained in the SYSTEM_ACCREDITATION_RANGE as checked by blinset(3TSOL). bslvalid() is a synonym for calling blinset() with the containing set of SYSTEM_ACCREDITATION_RANGE and is included for completeness.

SunOS 5.8  Last Revised 1 Feb 2001

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