OpenVMS マニュアル

getgrgid (Integrity, Alpha)

グループ ID に対応するグループ・データベース・エントリを取得します。

形式

#include <types.h>

#include <grp.h>

struct group *getgrgid (gid_t gid);

引数

gid

グループ・データベース・エントリを取り出すグループのグループ ID。

説明

getgrgid関数は，グループ・データベースで gid が一致するエントリを検索します。そして，一致するエントリが格納された group構造体へのポインタを返します。

戻り値

x

一致するエントリが格納された，有効な group 構造体へのポインタです。

NULL

エラーが発生しました。 注意: 戻り値は，以後の getgrent ， getgrgid ，または getgrnam の呼び出しで上書きされる静的領域を指しています。 エラーが発生すると，この関数は， errno に以下のいずれかの値を設定します。 EACCES -- ユーザ・プロセスが，ユーザ登録ファイルにアクセスするための適切な特権を持っていません。 EIO -- 入出力エラーが発生しました。 EINTR -- getgrgid の実行中にシグナルをキャッチしました。 EMFILE -- 呼び出し元プロセス内で， OPEN_MAX 個のファイル記述子が現在オープンされています。 ENFILE -- 許されている最大個数のファイルが，現在システム内でオープンされています。 エラー状態をチェックするアプリケーションは， getgrgid を呼び出す前に， errno に 0 を設定する必要があります。戻り時に errno が設定されている場合，エラーが発生しています。