NAZWA

       times - pobiera czasy procesów

SKŁADNIA

       #include <sys/times.h>

       clock_t times(struct tms *buf);

OPIS

       times()  przechowuje  bieżące  czasy  wykonywania procesu w struct tms, do której prowadzi
       buf. struct tms jest zdefiniowana w <sys/times.h> następująco:

           struct tms {
             clock_t tms_utime;  /* czas w przestrzeni użytkownika */
             clock_t tms_stime;  /* czas systemowy */
             clock_t tms_cutime; /* czas w przestrzeni użytkownika dla dzieci*/
             clock_t tms_cstime; /* czas systemowy dzieci */
           };

       Pole tms_utime zawiera czas CPU spędzony na wykonywaniu instrukcji procesu wywołującego tę
       funkcję.  Pole  tms_stime  zawiera  czas CPU spędzony w systemie podczas wykonywania zadań
       zleconych przez proces.

       Pole tms_cutime zawiera sumę tms_utime i tms_cutime wartości  dla  wszystkich  dzieci,  na
       które  proces  czekał.  Pole  tms_cstime  zawiera sumę wartości tms_stime i tms_cstime dla
       wszystkich dzieci, na które proces czekał.

       Czas zakończonych procesów-dzieci (i ich potomków) jest dodawany w momencie,  gdy  wait(2)
       lub  waitpid(2)  zwrócą  ich  identyfikatory  procesu.  W  szczególności nigdy nie zostaną
       policzone czasy wnuków, na które dzieci nie poczekały.

       Wszystkie raportowane czasy są wyrażone w tyknięciach zegara.

WARTOŚĆ ZWRACANA

       times()  returns the number of clock ticks that have elapsed since an arbitrary  point  in
       the  past.   The  return value may overflow the possible range of type clock_t.  On error,
       (clock_t) -1 is returned, and errno is set to indicate the error.

BŁĘDY

       EFAULT tms wskazuje na pamięć poza przestrzenią adresową procesu.

ZGODNE Z

       POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

UWAGI

       Liczbę tyknięć zegara na sekundę można uzyskać, używając:

           sysconf(_SC_CLK_TCK);

       W  standardzie  POSIX-1996  symbol  CLK_TCK  (zdefiniowany  w  <time.h>)  jest  uznany  za
       starzejący się. Obecnie jest przestarzały.

       W  wersjach Linuksa przed 2.6.9, jeżeli obsługa sygnału SIGCHLD jest ustawiona na SIG_IGN,
       to czasy zakończonych dzieci są automatycznie zawarte w polach  tms_cstime  i  tms_cutime,
       mimo że POSIX.1-2001 określa, że tak się powinno się zdarzyć tylko wtedy, gdy proces czeka
       na swoje dzieci za pomocą wywołania systemowego wait(2). To niedostosowanie  do  standardu
       jest poprawione w Linuksie w wersji 2.6.9 i kolejnych.

       Pod  Linuksem  argument  buf  może  mieć wartość NULL, w czego wyniku times() tylko zwróci
       wynik  funkcji.  Jednakże  POSIX  nie  określa  takiego  zachowania  i  większość   innych
       implementacji uniksowych wymaga, aby parametr buf nie był NULL-em.

       Proszę  zauważyć,  że  clock(3)  także  zwraca  wartości typu clock_t, które są wyrażone w
       jednostkach CLOCKS_PER_SEC, a nie w tyknięciach zegara, używanych przez times().

       Funkcja times() zwraca liczbę tyknięć zegara, które upłynęły od pewnego  wybranego  punktu
       przeszłości.  Pod  Linuksem  ów  "pewien wybrany punkt w przyszłości" jest różny w różnych
       wersjach  jądra  systemu.  W  Linuksie  2.4  i  wcześniejszych  tym  punktem  jest  moment
       uruchomienia  systemu. Od wersji 2.6 Linuksa tym punktem jest (2^32/HZ) - 300 sekund przed
       momentem uruchomienia systemu.  Ta  wariantywność  pomiędzy  wersjami  jądra  (i  pomiędzy
       różnymi  implementacjami  Uniksa) połączona z faktem, że wartość zwracana może przekroczyć
       dopuszczalny zakres typu clock_t, oznacza, że przenośne aplikacje powinny unikać  używania
       tej wartości. Aby zmierzyć upływ czasu, lepiej używać clock_gettime(2).

   Historia
       SVr1-3  zwraca  long, a członkowie struktury są typu time_t, chociaż przechowują tyknięcia
       zegara, a nie sekundy od początku epoki. V7  używał  typu  long  dla  członków  struktury,
       ponieważ nie miał jeszcze wtedy typu time_t.

BŁĘDY

       Ograniczenie  w  konwencjach  tego  wywołania  systemowego  na  niektórych  architekturach
       systemowych (zwłaszcza i386) oznacza, że w Linuksie 2.6 istnieje niewielkie  okno  czasowe
       (41  sekund) zaraz po uruchomieniu systemu, w którym times() może zwrócić -1, niepoprawnie
       wskazując na wystąpienie błędu. Ten sam problem  może  wystąpić,  kiedy  wartość  zwracana
       zostanie zawinięta, gdyż przekroczy maksymalną dopuszczalną wartość dla typu clock_t.

ZOBACZ TAKŻE

       time(1), getrusage(2), wait(2), clock(3), sysconf(3), time(7)

O STRONIE

       Angielska  wersja  tej  strony  pochodzi  z  wydania  5.13  projektu Linux man-pages. Opis
       projektu, informacje dotyczące zgłaszania błędów oraz  najnowszą  wersję  oryginału  można
       znaleźć pod adresem https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami   polskiego   tłumaczenia   niniejszej  strony  podręcznika  są:  Robert  Luberda
       <robert@debian.org> 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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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⟩.