Solaris Trusted Extensions リファレンスマニュアル

labelclipping(3TSOL)

名前 | 形式 | インタフェースレベル | 機能説明 | 戻り値 | ファイル | 使用例 | 属性 | 関連項目

名前

labelclipping, Xbsltos, Xbcleartos – バイナリラベルの変換および指定された幅への編集 (クリッピング)

形式

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

#include <Dt/label_clipping.h>

XmString Xbsltos(Display *display, const m_label_t *senslabel, Dimension width,
     const XmFontList fontlist, const int flags);

XmString Xbcleartos(Display *display, const m_label_t *clearance,
     Dimension width, const XmFontList fontlist, const int flags);

インタフェースレベル

ラベルクリッピング関数 Xbsltos() および Xbcleartos() は、廃止または互換性がなくなる可能性があります。代わりに label_to_str(3TSOL) 関数を使用してください。

機能説明

現在のプロセスの機密ラベルより優位にあるラベルや認可上限を変換するには、呼び出し元プロセスの、有効な特権セットの中に PRIV_SYS_TRANS_LABEL が存在する必要があります。

display: X Window System 表示への接続を制御する構造体。
senslabel: 変換される機密ラベル。
clearance: 変換される認可上限。
width: 変換されたラベルまたは認可上限の幅 (ピクセル数)。指定された幅がフルラベルより短い場合、ラベルはクリッピングされ、クリッピングした文字があることが矢印で示されます。この例では、文字は TS<- の右側でクリッピングされています。クリッピングされたことを示すインジケータについては、 sbltos(3TSOL) のマニュアルページを参照してください。指定された幅が表示幅 (display) に等しい場合は、ラベルは表示幅の半分の幅で折り返されます。このとき、ラベルの長さは切り捨てられません。
fontlist: フォントと文字セットのリスト。各フォントは文字セット 1 つと関連付けられています。
flags: フラグの値は、label_encodings(4) ファイルの中のどの語句を変換に使用するかを示しています。次のフラグ値の説明については、 bltos(3TSOL) マニュアルページを参照してください。LONG_WORDS、SHORT_WORDS、LONG_CLASSIFICATION、SHORT_CLASSIFICATION、ALL_ENTRIES, ACCESS_RELATED、VIEW_EXTERNAL、VIEW_INTERNAL、NO_CLASSIFICATION。BRACKETED は、Xbsltos() でのみ使用できる補足フラグです。次のように、機密ラベルは角括弧で囲まれます。[C]。

戻り値

これらのインタフェースは、文字コード形式の変換済み機密ラベルまたは認可上限を表す複合文字列を返します。複合文字列に使用する言語とフォントは、fontlist に指定され、width にクリップされます。これらのインタフェースは、ラベルまたは認可上限が label_encodings(4) ファイルに定義される有効かつ必須のタイプでない場合、またはプロセスの機密ラベルより下位でなく、PRIV_SYS_TRANS_LABEL 特権が表明されていない場合には、NULL を返します。

ファイル

/usr/dt/include/Dt/label_clipping.h: ラベルクリッピング用ヘッダファイル
/etc/security/tsol/label_encodings: ラベルエンコーディングファイルには、このシステムの定義済みラベルに対する格付け名、語句、制約、および値が含まれます。

使用例

例 1 許可上限を変換およびクリップする

この例では、フォントリストである label_encodings(4) ファイルに指定されている long word を使って認可上限をテキストに変換し、変換した認可上限を 72 ピクセル幅にクリップします。

xmstr = Xbcleartos(XtDisplay(topLevel), 
&clearance, 72, fontlist, LONG_WORDS

属性

次の属性については、attributes(5) を参照してください。

属性タイプ	属性値
使用条件	SUNWtsu
MT レベル	MT-安全