setnetgrent

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

setnetgrent, endnetgrent, getnetgrent, getnetgrent_r, innetgr - ネットワークグループのエントリーを操作する  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <netdb.h>

int setnetgrent(const char *netgroup);
void endnetgrent(void);

int getnetgrent(char **restrict host,
            char **restrict user, char **restrict domain);
int getnetgrent_r(size_t size;
            char **restrict host,
            char **restrict user, char **restrict domain,
            char buf[restrict size], size_t size);

int innetgr(const char *netgroup, const char *host,
            const char *user, const char *domain);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

setnetgrent(), endnetgrent(), getnetgrent(), getnetgrent_r(), innetgr():

    glibc 2.19 以降:
        _DEFAULT_SOURCE
    glibc 2.19 以前:
        _BSD_SOURCE || _SVID_SOURCE
 

説明

netgroup は SunOS で考案されたものである。ネットグループのデータベースの エントリーは、 3 つの文字列のリスト (hostname, username, domainname) もしくはネットグループ名である。 前記のリストの各要素は空であってもよい。 空は何とでも一致することを意味する。 本ページで説明する関数を使うことで、ネットグループのデータベースに アクセスすることができる。どのデータベースが検索されるかは /etc/nsswitch.conf ファイルで定義されている。

setnetgrent() コールは、この後で呼ばれる getnetgrent() コールが検索するネットグループを定める。 getnetgrent() 関数はネットグループの次のエントリーを取得し、 host, user, domain にポインターを入れて返る。ヌルポインターは、対応するエントリーがどんな文字列とも一致することを意味する。 得られたポインターは、ネットグループ関係の関数のいずれかが呼ばれるまでの 間だけ有効である。この問題を避けるためには GNU 拡張の関数 getnetgrent_r() を使うとよい。この関数は呼び出し側が用意したバッファーに 文字列を格納する。割り当て済のバッファーを全て解放するには endnetgrent() を使用する。

ほとんどの場合、 (hostname, username, domainname) の3要素の組がネットグループのメンバーかどうかを確認したいだけであろう。 innetgr() 関数を使うと、上記の3つの関数を呼び出さずにこの目的を達成できる。 もう一度書いておくが、NULL ポインターはワイルドカードであり、 あらゆる文字列と一致する。この関数はスレッドセーフである。  

返り値

これらの関数は成功すると 1 を、失敗すると 0 を返す。  

ファイル

/etc/netgroup
/etc/nsswitch.conf  

属性

この節で使用されている用語の説明は attributes(7) を参照のこと。
InterfaceAttributeValue
setnetgrent(), getnetgrent_r(), innetgr() Thread safety MT-Unsafe race:netgrent locale
endnetgrent() Thread safety MT-Unsafe race:netgrent
getnetgrent() Thread safety MT-Unsafe race:netgrent race:netgrentbuf locale

In the above table, netgrent in race:netgrent signifies that if any of the functions setnetgrent(), getnetgrent_r(), innetgr(), getnetgrent(), or endnetgrent() are used in parallel in different threads of a program, then data races could occur.  

バージョン

BSD の実装では setnetgrent() は void を返す。  

標準規格

なし。  

歴史

setnetgrent(), endnetgrent(), getnetgrent(), and innetgr() are available on most UNIX systems. getnetgrent_r() is not widely available on other systems.  

関連項目

sethostent(3), setprotoent(3), setservent(3)


 

Index

名前
ライブラリ
書式
説明
返り値
ファイル
属性
バージョン
標準規格
歴史
関連項目

This document was created by man2html, using the manual pages.