プログラミングインタフェース宣言

ライブラリルーチンを使用して、tsoluser(4) と tsolprof(4) データベース内のユーザー認可上限とプロファイルの情報にアクセスできます。この節の多くのインタフェースで使用される src パラメータ値は、データベース情報を取得する位置を示しています。

• TSOL_DB_SRC_SWITCH - /etc/nsswitch.conf ファイルを使用して、データベース情報の情報元を確認する。このフラグは、もっともよく使用されます。

• TSOL_DB_SRC_NISPLUS - tsoluser または tsolprof NIS+ データベースから読み取る

• TSOL_DB_SRC_FILES - /etc/security/tsol/tsoluser または /etc/security/tsol/tsolprof ファイルから読み取る

ユーザーエントリの取得

次のルーチンは、ユーザーの名前またはユーザー ID を使用して、tsoluser データベース内のユーザーエントリを取得します。詳細は、getuserent(3) のマニュアルページを参照してください。

userent_t						*getuserentbyname(char *user, int src);
 userent_t 						*getuserentbyuid(uid_t uid, int src);

ユーザーエントリの列挙

次のルーチンは、tsoluser データベースの先頭に移動し、データベース全体を巡回します。詳細は、getuserent(3) マニュアルページを参照してください。

/* getuserent() に対する最初の呼び出しの前にこのルーチンを呼び出す */
 	void					setuserent(int stayopen, int src);

/* ユーザーのデータベースの最初のエントリを戻す。その後、 */
/* 呼び出しの都度、その次のエントリを戻す */
 	userent_t 				*getuserent(int src);

/* 終了処理 */
 	void					enduserent(int src);

ユーザーエントリに割り当てられた記憶領域の解放

次のルーチンは、再入可能なルーチン getuserentbyname(3)、 getuserentbyuid(3)、 getuserent(3) に割り当てられた記憶領域を解放します。詳細は、getuserent(3) マニュアルページを参照してください。

void 						free_userent(userent_t *userent);

プロファイルエントリの取得

次のルーチンは、プロファイル名を使用して tsolprof(4) データベース内のエントリを取得します。getprofentbyname(3) ルーチンは、リンクリスト内のアクションとコマンドの情報を返します。この情報は、getprofstrbyname(3) ルーチンが返す情報よりも詳しいものです。詳細は、getprofent(3) と getprofstr(3) マニュアルページを参照してください。

profstr_t						*getprofstrbyname(char *name, int src);
 profent_t						*getprofentbyname(char *name, int src);

プロファイルエントリの列挙

次のルーチンは、tsolprof データベースの初めに移動し、データベース内を巡回します。詳細は、getprofent(3) と getprofstr(3) のマニュアルページを参照してください。

/* getprofent() に対する最初の呼び出しの前に呼び出す */
 		void				setprofstr(int stayopen, int src);
 	void						setprofent(int stayopen, int src);

/* ユーザーのデータベースの最初のエントリを戻す。その後、 */
/* 呼び出しの都度、その次のエントリを戻す */
 	profstr_t					*getprofstr(int src);
 	profent_t	 				*getprofent(int src);

/* 終了処理 */
 	void					endprofstr(int src);
 	void					endprofent(int src);

プロファイルエントリに割り当てられた記憶領域の解放

次のルーチンは、再入可能なルーチン getprofentbyname(3)、 getprofent(3)、 getprofstrbyname(3)、getprofstr(3) に割り当てられた記憶領域を解放します。詳細は、getprofent(3) と getprofstr(3) マニュアルページを参照してください。

void				free_profstr(profstr_t *profent);
 void 				free_profent(profent_t *profent);