GETGROUPLIST(3)

명칭
getgrouplist - 그룹 액세스 리스트의 연산

서식
#include <unistd.h> int getgrouplist(const char *name, int basegid, int *groups, int *ngroups)

해설
getgrouplist() 함수는 그룹 파일을 통독해, name 그리고 지정한 유저 (을)를 위해서(때문에) 그룹 액세스 리스트를 연산합니다. 그룹 리스트에는, basegid 하지만 자동적으로 포함됩니다. 통상, 이 값은 패스워드 파일로부터, 그룹 번호로서 주어집니다.

결과의 그룹 리스트는, groups 그리고 가리켜진 정수 배열로 돌려주어집니다. 호출원래는 ngroups 에 나타난 정수로 groups 배열의 크기를 지정합니다. 발견되었다 그룹의 실제의 수는, ngroups 그리고 돌아갑니다.

반환값
getgrouplist() 함수는, 그 유저의 그룹 모든 것을 보관 유지하려면 , 그룹 리스트의 사이즈가 너무 작은 경우,-1 를 돌려줍니다. 그룹 배열은 이 경우, 크기에 알맞을 뿐(만큼)의 수의 그룹에서 채워집니다.

관련 파일
/etc/group
    그룹 회원 리스트

관련 항목
setgroups(2), initgroups(3)

역사
getgrouplist() 함수는 4.4BSD 그리고 최초로 받아들여졌습니다.

버그
getgrouplist() 함수는, getgrent(3) 에 근거하는 routine를 사용합니다. 따라서, 호출 프로그램이 이러한 routine의 어떤 것인지를 사용하면(자), getgrouplist() 의 호출에 의해 그룹 구조체가 덧쓰기됩니다.