initgroups 子例程

用途

初始化补充组标识。

标准 C 库 (libc.a)

语法

int initgroups ( User BaseGID)
const char *User;
int BaseGID;

描述

注意: initgroups 子例程使用 getgrentgetp对象 系列子例程。 如果调用 initgroups 子例程的程序使用其中任何子例程,那么调用 initgroups 子例程将覆盖这些子例程所使用的静态存储区。

initgroups 子例程读取指定的 User 参数的已定义组成员资格,并将当前进程的补充组标识设置为该值。 BaseGID 参数始终包含在补充组标识中。 补充组通常是主体用户的组。 如果用户位于 limits.h 文件中设置的 NGROUPS_MAX 组以上,那么仅设置 NGROUPS_MAX 组,包括 BaseGID 组。

参数

描述
用户 标识用户。
BaseGID 指定要包含在组集中的其他组。

返回值

描述
重大安全事件数量 指示子例程成功。
-1 指示子例程失败。 设置了 errno 全局变量以指示错误。