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()  zwraca  liczbę  tyknięć  zegara,  które  upłynęły  od  pewnego  wybranego  punktu
       przeszłości.  Wartość  zwracana może przekroczyć dopuszczalny zakres typu clock_t. W razie
       błędu zwracane jest (clock_t) -1 i odpowiednio jest ustawiana wartość zmiennej errno.

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  4.07  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  man  są: Robert Luberda
       <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>.

       Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów  na
       stronie   http://sourceforge.net/projects/manpages-pl/.   Jest   zgodne   z  wersją   4.07
       oryginału.