次の例は、次のフラグ値を使用して、ASCII 文字列をバイナリの CMW ラベル、機密ラベル、または情報ラベルに変換します。
NEW_LABEL - 新しいラベルを作成し、そのバイナリラベルが label_encodings(4) に定義されているように、システムに対して完全で有効なラベルとなるように、その文字列を可能なかぎり修正します。修正ができない場合には、エラーが返されます。文字列は、ASCII または 16 進のどちらかです。
NO_CORRECTION - 新しいラベルを作成しますが、文字列の構造は修正しません。文字列が完全でなくシステムに対して無効なラベルである場合は、エラーが返されます。文字列は、ASCII または 16 進のどちらかです。
ASCII の CMW ラベルに使用できる形式を次に示します。
情報ラベル [機密ラベル] - この構造では、情報ラベルと機密ラベルは、空白文字、タブ、コンマ、スラッシュ (/) のいずれかで区切ることができます。この例では、空白文字で区切られています。
[機密ラベル] - この構造では、機密ラベル部だけが指定されており、情報ラベル部はシステムにより ADMIN_LOW に設定されます。
ASCII の機密ラベルと情報ラベルに使用できる形式を次に示します。入力項目は、空白文字、タブ、コンマ、スラッシュ (/) のいずれかで区切ることができます。格付けと語句の名前は、短い形式でも長い形式でもかまいません。
{+} {格付け} {{+|-}語句...}
縦棒 (|) は、2 つの項目から選択することを示します。縦棒の前後の空白は、無視されます。
正と負の符号を使用すると、語句に対応したコンパートメントとマーキングを有効または無効にして、既存のラベルの内容を変更できます。
中括弧は省略可能な項目を示し、ピリオドは語句の繰り返しを示します。語句が指定される場合、機密ラベルではコンパートメントを表し、情報ラベルではコンパートメントとマーキングを表します。
次の例は、NEW_LABEL フラグを使用して、ASCII 文字列をバイナリの CMW ラベル、機密ラベル、情報ラベルに変換し、再び元の ASCII に戻します。また、機密ラベルを指定された長さに変換する (クリッピング) 例も示しています。プロセスが SECRET B A [TS] 以上で作動する場合は、ラベル変換に sys_trans_label 特権を必要としません。
#include <tsol/label.h> main() { int retval, error, length = 0; char *cmwstring ="SECRET A B [TOP SECRET A B]"; char *sensstring = "TOP SECRET A B"; char *string1 = (char *)0, *string2 = (char *)0, *string3 = (char *)0; bclabel_t cmwlabel; bslabel_t senslabel; retval = stobcl(cmwstring, &cmwlabel, NEW_LABEL, &error); retval = bcltos(&cmwlabel, &string1, length, ALL_ENTRIES); retval = stobsl(sensstring, &senslabel, NEW_LABEL, &error); retval = bsltos(&senslabel, &string2, length, ALL_ENTRIES); string3 = sbsltos(&senslabel, 4); printf("CMW label = %s¥nSens label = %s¥nClipped label = %s¥nInf label= %s¥n", string1, string2, string3); }
printf 文により、次のように出力されます。Clipped label (クリッピングされたラベル) 中の矢印 <- は、機密ラベル名の文字がクリッピングされたことを示します。
CMW label = SECRET B A [TS A B]
Sen label = TS A B
Clipped label = TS<-