NAZWA¶

getgroups, setgroups - pobiera/ustawia listę identyfikatorów grup dodatkowych

BIBLIOTEKA¶

Standardowa biblioteka C (libc, -lc)

SKŁADNIA¶

#include <unistd.h>

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

#include <grp.h>

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

setgroups():

    Od glibc 2.19:


        _DEFAULT_SOURCE


    glibc 2.19 i wcześniejsze:


        _BSD_SOURCE

OPIS¶

getgroups() zwraca w list identyfikatory grup dodatkowych dla wywołującego procesu. Argument size powinien być ustawiony na maksymalną liczbę elementów, jakie mogą być przechowywane w buforze, na który wskazuje list. Jeśli wywołujący proces jest członkiem więcej niż size grup dodatkowych, wystąpi błąd.

Nie jest określone, czy efektywny ID grupy procesu wywołującego będzie znajdować się na zwróconej liście (zatem aplikacja powinna wywołać również getegid(2) i dodać lub usunąć otrzymaną wartość).

Jeśli size jest równe zero, to list nie jest modyfikowane, lecz zwracana jest ogólna liczba dodatkowych grup procesu. Pozwala to wywołującemu określić rozmiar dynamicznie przydzielanej list, do użycia w kolejnych wywołaniach do getgroups(2).

setgroups() ustawia identyfikatory grup dodatkowych procesu wywołującego. Konieczne są odpowiednie przywileje (zob. opis błędu EPERM poniżej). Argument size określa liczbę identyfikatorów grup dodatkowych w buforze, na który wskazuje list. Proces może porzucić wszystkie swoje grupy dodatkowe poniższym wywołaniem:

setgroups(0, NULL);

WARTOŚĆ ZWRACANA¶

Po pomyślnym zakończeniu getgroups() zwraca liczbę grup dodatkowych. Po błędzie zwracane jest -1 i ustawiane errno wskazując błąd.

Po pomyślnym zakończeniu setgroups() zwraca zero. Po błędzie zwracane jest -1 i ustawiane errno wskazując błąd.

BŁĘDY¶

EFAULT

list ma nieprawidłowy adres.

getgroups() może dodatkowo zawieść z następującym błędem:

EINVAL

size jest mniejsze niż liczba grup dodatkowych, ale niezerowe.

setgroups() może dodatkowo zawieść z następującymi błędami:

EINVAL

size jest większe niż NGROUPS_MAX (32 przed Linuksem 2.6.4; 65536 od Linuksa 2.6.4).

ENOMEM

Brak pamięci.

EPERM

Proces wywołujący ma niewystarczające przywileje (wywołujący nie posiada przywileju (ang. capability) CAP_SETGID w przestrzeni nazw użytkownika, w której występuje).

EPERM (od Linuksa 3.19)

Odmówiono użycia setgroups() w tej przestrzeni nazw użytkownika. Więcej informacji w opisie /proc/pid/setgroups w user_namespaces(7).

WERSJE¶

STANDARDY¶

getgroups()

POSIX.1-2008.

setgroups()

Brak.

HISTORIA¶

getgroups()

SVr4, 4.3BSD, POSIX.1-2001.

setgroups()

SVr4, 4.3BSD. Ponieważ setgroups() wymaga przywileju, nie jest opisana w POSIX.1.

Pierwotne linuksowe wywołania systemowe getgroups() obsługiwały jedynie 16-bitowe identyfikatory grup. Następnie, w Linuksie 2.4 dodano getgroups32(), obsługujące identyfikatora 32-bitowe. Funkcja opakowująca getgroups() biblioteki glibc obsługuje te warianty pomiędzy wersjami jądra w sposób przezroczysty.

UWAGI¶

Proces może posiadać maksymalnie NGROUPS_MAX grup dodatkowych oprócz efektywnego ID grupy. Stała NGROUPS_MAX jest definiowana w <limits.h>. Zbiór grup dodatkowych jest dziedziczony po procesie rodzicielskim i jest zachowywany na przestrzeni execve(2).

Maksymalna liczba grup dodatkowych może być odnaleziona w czasie uruchomienia za pomocą sysconf(3):

long ngroups_max;
ngroups_max = sysconf(_SC_NGROUPS_MAX);

Maksymalna zwracana wartość getgroups() nie może być większa od powyższej. Od Linuksa 2.6.4, maksymalna liczba grup dodatkowych jest również ujawniana w typowo linuksowym pliku tylko do odczytu: /proc/sys/kernel/ngroups_max.

ZOBACZ TAKŻE¶

getgid(2), setgid(2), getgrouplist(3), group_member(3), initgroups(3), capabilities(7), credentials(7)

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.