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

       SVr4, BSD 4.3, POSIX.1-2001.

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 (tj. około 429 milionów) 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  3.52  projektu  Linux man-pages. Opis projektu oraz
       informacje dotyczące zgłaszania błędów można znaleźć pod adresem http://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ą  3.52 oryginału.

Linux                                              2012-10-22                                           TIMES(2)