Ubuntu Manpage: getrlimit, getrusage, setrlimit - pobranie/ustawienie limitów i zużycia zasobów

NAZWA

       getrlimit, getrusage, setrlimit - pobranie/ustawienie limitów i zużycia zasobów

SKŁADNIA

       #include <sys/time.h>
       #include <sys/resource.h>
       #include <unistd.h>

       int getrlimit(int resource, struct rlimit *rlim);
       int getrusage(int who, struct rusage *usage);
       int setrlimit(int resource, const struct rlimit *rlim);

OPIS

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

getrlimit i setrlimit odpowiednio pobierają i ustawiają limity zasobów. Z każdym z
zasobów stowarzyszone jest miękkie i sztywne ograniczenie zdefiniowane w strukturze rlimit
(argument rlim w getrlimit() i setrlimit()):

struct rlimit {
rlim_t rlim_cur; /* ograniczenie miękkie */
rlim_t rlim_max; /* ograniczenie sztywne (górna
granica dla rlim_cur) */
};

Ograniczenie miękkie jest wartością odpowiedniego zasoby wymuszną przez jądro.
Ograniczenie sztywne działa jak wartość maksymalna dla ograniczenia miękkiego: proces
nieuprzywilejowany może sobie ustawić ograniczenie miękkie tylko w zakresie od 0 do
ograniczenia sztywnego oraz (nieodwracalnie) obniżyć swoje ograniczenie sztywne. Proces
uprzywilejowany może dowolnie zmieniać każdą z wartości ograniczenia.

Wartość RLIM_INFINITY określa brak ograniczenia dla zasobu (zarówno w strukturze zwracanej
przez getrlimit(), jak i w strukturze przekazywanej do setrlimit()).

resource musi być jednym z:

RLIMIT_CPU
Ograniczenie czasu procesora (CPU) w sekundach. Gdy proces osiąga swoje
ograniczenie miękkie, jest do niego wysyłany sygnał SIGXCPU. Domyślną reakcją na
ten sygnał jest przerwanie procesu. Jednakże, sygnał może zostać przechwycony i
procedura obsługi może przekazać sterowanie to programu głównego. Jeśli proces
nadal będzie zużywać zasoby procesora, będzie do niego co sekundę wysyłany sygnał
SIGXCPU aż do osiągnięcia ograniczenia sztywnego, kiedy to wysyłane jest sygnał
SIGKILL. (Ostatni punkt opisuje zachowanie Linuksa 2.2 i 2.4. W zależności od
implementacji procesy kontynuujące zużywanie zasobów procesora po osiągnięciu
ograniczenia miękkiego są różnie traktowane. Aplikacje przenośne, które mają
potrzebę przechwycenia tego sygnału, powinny zakończyć się w sposób kontrolowany w
chwili otrzymaniu pierwszego SIGXCPU.)

RLIMIT_DATA
Maksymalny rozmiar segmentu danych procesu (dane zainicjalizowane, dane
niezainicjalizowane i sterta). Ograniczenie to wpływa na wywołania brk() and
sbrk(), które kończą się niepomyślnie, zgłaszając błąd ENOMEM w momencie
natrafienia na miękkie ograniczenie tego zasobu.

RLIMIT_FSIZE
Maksymalny rozmiar plików tworzonych przrz dany proces. Próba rozszerzenia pliku
ponad to ograniczenie kończy się otrzymaniem sygnału SIGXFSZ. Domyślnie, sygnał
ten kończy działanie procesu, ale proces może go przechwycić. Wówczas odpowiednia
funkcja systemowa (np. write(), truncate()) kończy się błędem. EFBIG.

RLIMIT_LOCKS
Ograniczenie łącznej liczby blokad flock() i dzierżaw fcntl(), które proces może
ustanowić (Linux 2.4 i późniejsze).

RLIMIT_MEMLOCK
Maksymalna liczba bajtów pamięci wirtualnej, które można zablokować w pamięci RAM
za pomocą mlock() i mlockall().

RLIMIT_NOFILE
Określa wartość o jeden większą niż maksymalna liczba deskryptorów plików, które
dany proces może otworzyć. Próby wykonania (open(), pipe(), dup(), itd.)
przekraczające tę granicę dają błąd EMFILE.

RLIMIT_NPROC
Maksymalna liczba procesów, które można utworzyć dla danego rzeczywistego
identyfikatora użytkownika procesu wywołującego. Po napotkaniu tego ograniczenia,
fork() kończy się błędem EAGAIN.

RLIMIT_RSS
Określa ograniczenie ilości rezydentnych stron procesu (liczba stron pamięci
wirtualnej pozostających w RAM). Ograniczenie to działa począwszy od Linuksa 2.4 i
dotyczy jedynie wywołań madvise() z użyciem MADVISE_WILLNEED.

RLIMIT_STACK
Maksymalny rozmiar stosu procesu w bajtach. W chwili osiągnięcia tego
ograniczenia, generowany jest sygnał SIGSEGV. W celu obsłużenia tego sygnału
proces musi założyć alternatywny stos dla sygnałów (sigaltstack(2)).

RLIMIT_OFILE jest nazwą BSD dla RLIMIT_NOFILE.

getrusage zwraca bieżące zużycie zasobów dla who będącego albo RUSAGE_SELF albo
RUSAGE_CHILDREN. W pierwszym przypadku zwracane jest zużycie zasobów przez bieżący
proces, a w dugim - przez tych spośród jego potomków, którzy zakończyli działanie i na
które to zakończenie oczekiwano.

struct rusage {
struct timeval ru_utime; /* użyty czas użytkownika */
struct timeval ru_stime; /* użyty czas systemowy */
long ru_maxrss; /* maximum resident set size */
long ru_ixrss; /* całkowity rozmiar pamięci dzielonej */
long ru_idrss; /* całkowity rozmiar danych niedzielonych */
long ru_isrss; /* całkowity rozmiar niedzielonego stosu */
long ru_minflt; /* page reclaims */
long ru_majflt; /* page faults */
long ru_nswap; /* swapy */
long ru_inblock; /* blokowe operacje wejścia */
long ru_oublock; /* blokowe operacje wyjścia */
long ru_msgsnd; /* wysłane komunikaty */
long ru_msgrcv; /* otrzymane komunikaty */
long ru_nsignals; /* otrzymane sygnały */
long ru_nvcsw; /* ochotnicze przełączenia kontekstu */
long ru_nivcsw; /* nieochotnicze przełączenia kontekstu */
};

WARTOŚĆ ZWRACANA

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

BŁĘDY

       EFAULT rlim lub usage wskazuje poza dostępną przestrzeń adresową.

       EINVAL getrlimit lub setrlimit zostało  wywołane  ze  złym  resource,  lub  też  getrusage
              zostało wywołane ze złym who.

       EPERM  Użytkownik  nie będący superużytkownikiem próbuje używać setrlimit() do zwiększenia
              miękich  lub  twardych  limitów,  lub   też   superużytkownik   próbuje   zwiększyć
              RLIMIT_NOFILE powyżej maksimum jądra.

ZGODNE Z

       SVr4, BSD 4.3

UWAGA

       Włączenie   <sys/time.h>   nie   jest   obecnie   wymagane,   ale   zwiększa  przenośność.
       (Rzeczywiście, struct timeval jest zdefiniowane w <sys/time.h>.)

       W Linuksie, jeśli rozporządzenie SIGCHLD ustawiono jako SIG_IGN, to zasobów wykorzystywane
       przez   procesy   potomne   są   automatycznie   dołączane  do  wartości  zwracanej  przez
       RUSAGE_CHILDREN, pomimo że POSIX 1003.1-2001 jawnie tego zabrania.

       Powyższa struktura została przejęta z BSD 4.3 Reno.  Nie wszystkie pola mają znaczenie pod
       Linuksem.   Obecnie  (Linux  2.4)  jedynie pola ru_utime, ru_stime, ru_minflt, ru_majflt i
       ru_nswap są pielęgnowane.

ZOBACZ TAKŻE

       dup(2), fcntl(2), fork(2), mlock(2), mlockall(2), mmap(2), open(2), quotactl(2),  sbrk(2),
       wait3(2), wait4(2), malloc(3), ulimit(3), signal(7)

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 getrlimit

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