setgroups

명칭
     setgroups — 그룹 액세스 리스트를 설정한다

프로그램 라이브러리
     Standard C Library (libc, -lc)

서식
     <sys/param.h> <unistd.h> int setgroups(int ngroups, const gid_t *gidset)

해설
     setgroups() (은)는, 배열 gidset 에 따라, 현재의 유저 프로세스의 그룹 액세스 리스트를 설정합니다.  파라미터
     ngroups (은)는, 배열내의 엔트리의 수를 나타내, ⟨sys/param.h⟩ 안에 정의되고 있는 값 NGROUPS (을)를
     넘어서는 안됩니다.

     슈퍼 유저만이 새로운 그룹을 설정할 수 있습니다.

반환값
     The setgroups() function returns the value 0 if successful; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.

에러
     setgroups() 호출은 다음의 경우에 처리에 실패합니다.

     [EPERM]            슈퍼 유저 이외의 유저에 의해 불려 갔습니다.

     [EFAULT]           gidset (으)로 지정된 주소는, 프로세스에 할당할 수 있었던 address 공간의 범위외를
                        가리키고 있습니다.

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

역사
     setgroups() 함수 호출은 4.2BSD 그리고 등장했습니다.