NAZWA

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

SKŁADNIA

       #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);

OPIS

        Uwaga! To tłumaczenie może być nieaktualne!

       getgroups
              Zwraca  w  list  maksymalnie  size dodatkowych ID grup. Nie jest określone, czy efektywny ID grupy
              procesu wywołującego będzie znajdować się na zwróconej liście. Tak więc, 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.

       setgroups
              Ustawia dodatkowe grupy procesu. Jedynie superużytkownik może tego dokonać.

WARTOŚĆ ZWRACANA

       getgroups
              po pomyślnym  zakończeniu  zwraca  liczbę  grup  dodatkowych.   Po  błędzie  zwracane  jest  -1  i
              odpowiednio ustawiane errno.

       setgroups
              po pomyślnym zakończeniu zwraca zero. Po błędzie zwracane jest  -1 i odpowiednio ustawiane errno.

BŁĘDY

       EFAULT list ma nieprawidłowy adres.

       EPERM  Dla setgroups, użytkownik nie jest superużytkownikiem.

       EINVAL Dla  setgroups,  size  jest większe niż NGROUPS (32 dla Linuksa 2.0.32).  Dla getgroups, size jest
              mniejsze niż liczba grup dodatkowych, ale niezerowe.

UWAGI

       Proces może posiadać maksymalnie co najmniej NGROUPS_MAX grup dodatkowych oprócz  efektywnego  ID  grupy.
       Zbiór  grup  dodatkowych  jest  dziedziczony  po procesie rodzicielskim i może zostać zmieniony za pomocą
       setgroups.  Maksymalna liczba grup dodatkowych może być odczytana za pomocą sysconf(3):
           long ngroups_max;
           ngroups_max = sysconf(_SC_NGROUPS_MAX);
       Maksymalna zwracana przez getgroups wartość  nie  może  być  większa  niż  powiększona  o  jeden  wartość
       otrzymana w powyższy sposób.

       Prototyp  dla  setgroups  jest  dostępny  jedynie,  gdy zdefiniowane jest _BSD_SOURCE (bezpośrednio, albo
       pośrednio - nie definiując _POSIX_SOURCE czy kompilując z włączoną flagą -ansi).

ZGODNE Z

       SVr4, SVID (tylko wydanie 4; wywołań tych nie było w SVr3), X/OPEN, 4.3BSD.  Funkcja getgroups istnieje w
       POSIX.1. Ponieważ setgroups wymaga przywilejów, nie jest opisana w POSIX.1.

ZOBACZ TAKŻE

       initgroups(3), getgid(2), setgid(2)

INFORMACJE O TŁUMACZENIU

       Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne.
       W razie zauważenia różnic między powyższym opisem a rzeczywistym  zachowaniem  opisywanego  programu  lub
       funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:

              man --locale=C 2 getgroups

       Prosimy   o   pomoc   w   aktualizacji   stron   man  -  więcej  informacji  można  znaleźć  pod  adresem
       http://sourceforge.net/projects/manpages-pl/.