NAZWA

       usleep - zawiesza wykonanie na czas wyrażony w mikrosekundach

SKŁADNIA

       #include <unistd.h>

       int usleep(useconds_t usec);

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

       usleep():
           Od glibc 2.12:
               (_XOPEN_SOURCE >= 500) && ! (_POSIX_C_SOURCE >= 200809L)
                   || /* Glibc od 2.19: */ _DEFAULT_SOURCE
                   || /* Glibc w wersji <= 2.19: */ _BSD_SOURCE
           Przed glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE >= 500

OPIS

       Funkcja  usleep()  zawiesza wykonanie wywołującego procesu na (co najmniej) usec mikrosekund. Zawieszenie
       może  być  delikatnie  wydłużone  przez  jakąkolwiek  aktywność  systemu  albo  przez  czas  spędzony  na
       przetwarzaniu wywołania, albo z powodu ziarnistości (częstotliwości odświeżania) liczników systemowych.

WARTOŚĆ ZWRACANA

       Funkcja  usleep() w przypadku powodzenia zwraca 0. W razie wystąpienia błędu zwracane jest -1 i ustawiana
       jest zmienna errno wskazując na błąd.

BŁĘDY

       EINTR  Przerwane przez sygnał, patrz signal(7).

       EINVAL usec nie jest mniejsze niż 1000000. (Dla systemów, dla których jest to traktowane jako błąd).

ATRYBUTY

       Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).
       ┌───────────┬────────────────────────┬─────────┐
       │ Interfejs │ Atrybut                │ Wartość │
       ├───────────┼────────────────────────┼─────────┤
       │ usleep()  │ Bezpieczeństwo wątkowe │ MT-Safe │
       └───────────┴────────────────────────┴─────────┘

ZGODNE Z

       4.3BSD, POSIX.1-2001.  POSIX.1-2001 uznają tę funkcję jako przestarzałą, sugerując używanie zamiast  niej
       funkcji nanosleep(2).  POSIX.1-2008 usuwa opis funkcji usleep().

       W  oryginalnej  implementacji  BSD  oraz  w  wersjach  wcześniejszych  niż  2.2.2 biblioteki glibc  typem
       zwracanym przez tę funkcję był void. Wersja POSIX zwraca int, taki typ jest też zwracany przez  glibc  od
       wersji 2.2.2.

       SUSv2 i POSIX.1-2001 dokumentują tylko błąd EINVAL.

UWAGI

       Typ  useconds_t  jest  typem  unsigned  integer,  zdolnym  do  przechowywania liczb naturalnych z zakresu
       [0,1000000]. Programy będą bardziej przenośne, gdy nigdy nie użyją wprost tego typu. Proszę użyć

           #include <unistd.h>
           ...
               unsigned int usecs;
           ...
               usleep(usecs);

       Interakcja tej funkcji z sygnałem SIGALRM oraz z innymi  funkcjami  licznikowymi,  takimi  jak  alarm(2),
       sleep(3),    nanosleep(2),    setitimer(2),    timer_create(2),   timer_delete(2),   timer_getoverrun(2),
       timer_gettime(2), timer_settime(2), ualarm(3) jest nieokreślona.

ZOBACZ TAKŻE

       alarm(2), getitimer(2), nanosleep(2), select(2), setitimer(2), sleep(3), ualarm(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.

                                                   2016-03-15                                          USLEEP(3)