GETNETGRENT
Section: C Library Functions (3)
索引
jman
BSD mandoc
索引
名称
getnetgrent
innetgr
setnetgrent
endnetgrent
- ネットグループデータベースの操作
索引
書式
Ft int
Fn getnetgrent char **host char **user char **domain
Ft int
Fn innetgr const char *netgroup const char *host const char *user const char *domain
Ft void
Fn setnetgrent const char *netgroup
Ft void
Fn endnetgrent void
索引
解説
これらの関数はいずれも、
netgroup(5)
に記述されたネットグループデータベースのファイル
/etc/netgroup
を操作します。データベースはネットグループの集合を定義しますが、
ネットグループはぞれぞれ、1 つまたは複数の次のような 3 つ組で構成されます。
(host, user, domain)
それぞれ、ホスト、ユーザおよびドメインの組み合わせを定義します。
3 つのフィールドのどれにも、あらゆるストリングに適合する
`'ワイルドカード' を指定可能です。
関数
Fn getnetgrent
は、現在のネットグループの次のメンバの、文字列に対する
3 つのポインタ引数を設定します。文字列ポインタのどれかが
(char *)0
だと、そのフィールドはワイルドカードと見なされます。
関数
Fn setnetgrent
は現在のネットグループを設定し、
Fn endnetgrent
は現在のネットグループを終了します。
前の呼び出しとは違うネットグループに対して
Fn setnetgrent
が呼び出された場合、暗黙に
Fn endnetgrent
が実行されます。
Fn setnetgrent
はまた、ネットグループの最初のメンバのオフセットを設定します。
関数
Fn innetgr
は適合するものがあるかどうか、指定したグループにあるすべての
フィールドを検索します。
host
user
domain
引数のどれかが
(char *)0
の場合、そのフィールドは指定されたネットグループメンバのあらゆる
文字列値に適合します。
索引
戻り値
関数
Fn getnetgrent
は ``それ以上ネットグループメンバがない'' 場合には 0 を返し、
その他の場合は 1 を返します。
関数
Fn innetgr
は、適合するフィールドがあった場合は 1 を、
その他の場合は 0 を返します。
関数
Fn setnetgrent
および
Fn endnetgrent
には戻り値がありません。
索引
関連ファイル
- /etc/netgroup
-
ネットグループデータベースファイル
索引
関連項目
netgroup(5)
索引
互換性
ネットグループメンバには、他のベンダによる実装との互換性を維持するために
3 つの文字列フィールドがありますが、
domain
文字列の BSD 内での使用法が明らかではありません。
索引
バグ
関数
Fn getnetgrent
は、動的に割り振られたデータ領域のポインタを返しますが、
関数
Fn endnetgrent
が呼び出されるとそのデータ領域は解放されます。
索引
Index
- 名称
-
- 書式
-
- 解説
-
- 戻り値
-
- 関連ファイル
-
- 関連項目
-
- 互換性
-
- バグ
-
Time: 07:06:52 GMT, January 12, 2009