NAZWA

       getpriority,  setpriority  -  pobranie/ustawienie priorytetu programu podczas szeregowania
       zadań

SKŁADNIA

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

       int getpriority(int which, int who);
       int setpriority(int which, int who, int prio);

OPIS

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

       Priorytet procesu, grupy procesów, lub użytkownika podczas szeregowania zadań,  wskazywany
       przez  which  i  who jest uzyskiwany za pomocą wywołania getpriority a ustawiany za pomocą
       wywołania setpriority.  which jest jednym z PRIO_PROCESS, PRIO_PGRP lub PRIO_USER,  a  who
       jest  interpretowane względem which (identyfikator procesu dla PRIO_PROCESS, identyfikator
       grupy procesów dla PRIO_PGRP i identyfikator użytkownika dla PRIO_USER).   Zerowa  wartość
       who  określa  (odpowiednio) proces wywołujący funkcję, jego grupę procesów lub rzeczywisty
       identyfikator użytkownika procesu wywołującego funksję.  prio jest wartością z zakresu  od
       -20  do 20 (lecz zobacz UWAGI poniżej).  Domyślnym priorytetem jest 0; mniejsze priorytety
       powodują korzystniejsze traktowanie podczas szeregowania zadań.

       Funkcja getpriority zwraca  najwyższą  wartość  (najniższą  wartość  numeryczną),  spośród
       posiadanych przez którykolwiek z podanych procesów. Funkcja setpriority ustawia priorytety
       wszystkich podanych procesów na wskazaną wartość. Jedynie superużytkownik może  zmniejszać
       priorytety.

WARTOŚĆ ZWRACANA

       Ponieważ  -1  jest  legalną  wartością  spośród  normalnie  zwracanych  przez getpriority,
       niezbędnym jest wyzerowanie zmiennej zewnętrznej errno  przed  wywołaniem  tej  funkcji  i
       późniejsze  sprawdzenie  czy -1 oznaczało błąd, czy normalną wartość.  Funkcja setpriority
       zwraca 0 jeśli nie było błędów lub -1 jeśli jakiś wystąpił.

BŁĘDY

       ESRCH  Nie zlokalizowano żadnego procesu przy użyciu podanych wartości which i who.

       EINVAL which nie był jednym z PRIO_PROCESS, PRIO_PGRP lub PRIO_USER.

       Oprócz powyższych błędów, dla setpriority mogą wystąpić:

       EPERM  Proces  został  zlokalizowany,  lecz  ani  jego  efektywny,  ani   rzeczywisty   ID
              użytkownika nie odpowiadał efektywnemu ID użytkownika wywołującego.

       EACCES Użytkownik nie będący superużytkownikiem próbował obniżyć priorytet procesu.

UWAGI

       Szczegółowe warunki wystąpienia błędu EPERM zależą od systemu.  Powyżej opisano co mówi na
       ten temat SUSv3, z którym wydają sie  być  zgodne  wszystkie  systemy  typu  SYSV.   Linux
       wymaga,   aby  rzeczywisty  lub  efektywny  ID  użytkownika  wywołującego  zgadzał  się  z
       rzeczywistym użytkownikiem  procesu  who  (zamiast  z  jego  efektywnym  ID  użytkownika).
       Wszystkie  systemy  typu  BSD (SunOS 4.1.3, Ultrix 4.2, BSD 4.3, FreeBSD 4.3, OpenBSD-2.5,
       ...) wymagają, aby efektywny ID użytkownika wywołującego  zgadzał  się  z   efektywnym  ID
       użytkownika procesu who.

       Rezczywisty  zakres  priorytetów  jest różny dla różnych wersji jądra.  Linux wcześniejszy
       niż 1.3.36 miał -nieskończoność..15. Linux od  1.3.43  ma  -20..19,  a  funkcja  systemowa
       getpriority zwraca 40..1 dla tych wartości (gdyż liczby ujemne są kodami błędów).  Funkcja
       biblioteczna przekształca N na 20-N.

       Włączanie  <sys/time.h>   nie   jest   obecnie   wymagane,   ale   zwiększa   przenośność.
       (Rzeczywiście,  <sys/resource.h>  definiuje  strukturę rusage zawierającą pola typu struct
       timeval zdefiniowanego w <sys/time.h>.)

ZGODNE Z

       SVr4, 4.4BSD (funkcje te pierwotnie pojawiły się w 4.2BSD).

ZOBACZ TAKŻE

       nice(1), fork(2), renice(8)

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 getpriority

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