承認の変換

次のライブラリルーチンは、指定された承認 ID を対応する外部名または数値 ID に変換し、再び元に戻します。これらのルーチンは、auth_name(4) のマニュアルページで説明されている承認名データベースファイルを読み取り、auth_id (承認 ID) と *string (文字列) 間で変換を行います。

承認 ID から文字列への変換

この例では、auth_id が明示的定数名 TSOL_AUTH_FILE_DOWNGRADE_SL に初期化され、auth_to_str(3) ルーチンに渡されてその外部名に変換されます。

	string1 = auth_to_str(TSOL_AUTH_FILE_DOWNGRADE_SL);
 	printf("%s¥n", string1);

printf 文によって、次のように出力されます。

downgrade file sensitivity label

文字列から承認 ID への変換

次の例では、auth_to_str(3) から戻された文字列が str_to_auth(3) に渡されて、文字列がその数値 ID に変換されます。

	auth_id = str_to_auth(string1);
 	printf("Auth ID = %d¥n", auth_id);

printf 文によって、次のように出力されます。

Auth ID = 5

承認の説明テキストの取得

get_auth_text(3) ルーチンは、指定された auth_id (承認 ID) の説明テキストを返します。auth_name(4) のマニュアルページには、システム内のすべての承認の説明テキストが示されています。

	string1 = get_auth_text(TSOL_AUTH_FILE_DOWNGRADE_SL);
 	printf("%s¥n", string1);

printf 文によって、次のように出力されます。

Allows a user to specify the Sensitivity Label to set on a file that does not dominate the file's existing Sensitivity Label.