getgroups() - Unix，Linux 系统调用

名称

getgroups、setgroups - 获取/设置辅助组 ID 列表

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

int getgroups(int size, gid_t list[]);

#include <grp.h>

int setgroups(size_t size, const gid_t *list);

标签	描述
getgroups()
	最多 size 个调用进程的辅助组 ID 将返回到 list 中。调用进程的有效组 ID 是否包含在返回列表中是不确定的。（因此，应用程序还应该调用 getegid(2) 并添加或删除结果值。）如果 size 为零，则 list 不被修改，但会返回进程的辅助组 ID 的总数。
setgroups()
	设置进程的辅助组 ID。需要适当的权限（Linux：CAP_SETGID 功能）。

标签	描述
getgroups()
	成功时，返回辅助组 ID 的数量。失败时，返回 -1，并相应地设置 errno。
setgroups()
	成功时，返回零。失败时，返回 -1，并相应地设置 errno。

标签	描述
EFAULT	list 的地址无效。
EINVAL	对于 setgroups()，size 大于 NGROUPS（对于 Linux 2.0.32 为 32）。对于 getgroups()，size 小于辅助组 ID 的数量，但不是零。
EPERM	调用进程没有足够的权限来调用 setgroups()。

除了有效组 ID 之外，一个进程最多可以有 NGROUPS_MAX 个辅助组 ID。辅助组 ID 集从父进程继承，可以使用 setgroups() 更改。可以使用 sysconf(3) 找到辅助组 ID 的最大数量。

    long ngroups_max;
    ngroups_max = sysconf(_SC_NGROUPS_MAX);

getgroups() 的最大返回值不能大于通过这种方式获得的值加一。

只有在定义了 _BSD_SOURCE 时，setgroups() 的原型才可用。

SVr4、4.3BSD。getgroups() 函数在 POSIX.1-2001 中。由于 setgroups() 需要权限，因此它不受 POSIX.1-2001 的约束。

打印页面