日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
AU_MASK(3) FreeBSD ライブラリ関数マニュアル AU_MASK(3)
名称
au_preselect, getauditflagsbin, getauditflagschar -- 文字列と監査マスクの
数値を相互に変換する
ライブラリ
基本的なセキュリティモジュールユーザライブラリ (libbsm, -lbsm)
書式
#include <bsm/libbsm.h>
int
au_preselect(au_event_t event, au_mask_t *mask_p, int sorf, int flag);
int
getauditflagsbin(char *auditstr, au_mask_t *masks);
int
getauditflagschar(char *auditstr, au_mask_t *masks, int verbose);
解説
これらのインタフェースは、数値とテキスト形式の間の変換とイベントがマスク
によって適合するかどうかを計算することを含んで、タイプ au_mask_t によって
表される監査マスクの処理をサポートします。
au_preselect() 関数は、event を通して渡される監査イベントが mask_p を通し
て渡される監査マスクによって適合するかどうかを計算します。sorf 引数は、
AU_PRS_SUCCESS フラグが設定されているなら、成功している、または
AU_PRS_FAILURE フラグが設定されているなら、失敗しているイベントであるとみ
なすかどうかを示します。flag 引数は、キャッシュから読み込むよりむしろ再検
索されるイベントを引き起こす AU_PRS_REREAD または、キャッシュの使用を強制
する AU_PRS_USECACHE を含んで、au_preselect() の振る舞いに影響を及ぼす追
加引数を受け付けます。
getauditflagsbin() 関数は、auditstr によって指された文字列を通して渡され
た監査マスクの文字列表現を変換し、有効であるなら、結果のマスクを *masks
を通して返します。
getauditflagschar() 関数は、*masks を通して渡された監査イベントマスクを変
換して、auditstr によって指されたバッファ中の文字列にそれを変換して置きま
す。どのように十分なサイズのバッファを提供するかに関する詳しい情報につい
ては、「バグ」セッションを参照してください。verbose フラグが設定されてい
るなら、audit_class(5) から検索されたクラス記述文字列が使用されます。そう
でなければ、2 文字のクラス名が使用されます。
実装に関する注
au_preselect() 関数は、様々な監査データベースルーチンを暗黙に使用して、他
のコードによってそれらのデータベースの同期、または、インタリーブされた処
理の振る舞いに影響を及ぼすかもしれません。
戻り値
au_preselect() 関数は、成功すれば 0 を返すか、またはイベントタイプまたは
他のデータベースアクセスで失敗があるなら、-1 を返します、その場合、errno
はエラーの内容を示すように設定されます。イベントが適合するなら、1 を返
し、そうでなければ 0 を返します。
関数 getauditflagsbin() および getauditflagschar() は、処理が成功すると値
0 を返します。そうでない場合、値 -1 が返され、グローバル変数 errno にエ
ラーを示す値が設定されます。
関連項目
libbsm(3), audit_class(5)
歴史
OpenBSM 実装は、2004 年に Apple Computer Inc. との契約に基づき、McAfee
Inc. のセキュリティ部門、McAfee Research によって作成されました。その後に
それは、OpenBSM 配布のための基盤として TrustedBSD Project によって採用さ
れました。
作者
このソフトウェアは、Apple Computer Inc. との契約に基づき、McAfee Inc. の
セキュリティ研究部門、McAfee Research のために Robert Watson, Wayne
Salamon と Suresh Krishnaswamy によって作成されました。
レコードを監査し、イベントストリームフォーマットを監査する Basic Security
Module (BSM) インタフェースは、Sun Microsystems によって定義されました。
バグ
errno 変数は、エラーの場合に、常に適切に設定されるというわけではありませ
ん。
getauditflagschar() 関数は、オーバフローを検出するために、文字バッファが
どれくらい長さかを示すための方法を提供していません。結果として、呼び出し
側は、イベントの非冗長な (non-verbose) クラス名のマスク引数で 0 でない
ビットの 3 倍の数が使用されているものとして計算される、任意の利用可能なマ
スクのために常に十分な長さのバッファを提供しなければなりません、そして、
冗長な (verbose) クラス名のための自明の予測はできません。この API は、よ
り強健なものに置き替えられるべきです。
FreeBSD 11.4 April 19, 2005 FreeBSD 11.4