initgroups

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

名前

initgroups - 追加のグループアクセスリストの初期化  

ライブラリ

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

書式

#include <sys/types.h>
#include <grp.h>

int initgroups(const char *user, gid_t group);

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

initgroups():

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

説明

initgroups() 関数はグループデータベース /etc/group を読み 込んで、user が所属している全てのグループを使って、グループアク セスリストを初期化する。さらに、group に示されるグループもグルー プアクセスリストに追加される。

user 引数は NULL であってはならない。  

返り値

The initgroups() function returns 0 on success. On error, -1 is returned, and errno is set to indicate the error.  

エラー

ENOMEM
グループ情報構造体を配置するためのメモリーが不足している。
EPERM
呼出しプロセスが十分な特権を持っていない。 この関数の裏で実行されるシステムコール setgroups(2) も参照のこと。
 

ファイル

/etc/group
グループデータベースファイル
 

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
initgroups() Thread safetyMT-Safe locale
 

標準規格

なし。  

歴史

SVr4, 4.3BSD.  

関連項目

getgroups(2), setgroups(2), credentials(7)


 

Index

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

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