NAZWA¶

nanosleep - usypia z wysoką rozdzielczością

BIBLIOTEKA¶

Standardowa biblioteka C (libc, -lc)

SKŁADNIA¶

#include <time.h>

int nanosleep(const struct timespec *duration,
              struct timespec *_Nullable rem);

nanosleep():

    _POSIX_C_SOURCE >= 199309L

OPIS¶

nanosleep() zawiesza wykonywanie wywołującego wątku, dopóki nie upłynie co najmniej czas podany w *duration albo dopóki nie zostanie dostarczony sygnał, który wyzwoli przywołanie procedury obsługi w wątku wywołującym lub który zakończy proces.

Jeśli wywołanie zostanie przerwane przez procedurę obsługi sygnału, nanosleep zwróci -1, ustawi errno na wartość EINTR i zapisze pozostały czas do do struktury wskazywanej przez rem, o ile rem nie było równe NULL. Wartość *rem można wykorzystać do ponownego wywołania nanosleep() i dokończenia zadanej pauzy (jednak zob. UWAGI).

Do podawania interwałów czasowych z dokładnością nanosekundową, używana jest struktura timespec(3).

Wartość pola nanosekund musi być w zakresie [0, 999999999].

W porównaniu ze sleep(3) i usleep(3), nanosleep ma następujące zalety: oferuje wyższą rozdzielczość do określania czasu pauzy; POSIX.1 wyraźnie określa, że nie wpływają na nie sygnały; pozwala na łatwiejszą kontynuację uśpienia po przerwaniu przez procedurę obsługi sygnału.

WARTOŚĆ ZWRACANA¶

Po udanym spauzowaniu na żądany czas, nanosleep() zwróci 0. Jeśli wywołanie przerwano przez procedurę obsługi sygnału lub wystąpi błąd, zwróci -1 i ustawi errno wskazując błąd.

BŁĘDY¶

EFAULT

Problem z kopiowaniem informacji z przestrzeni użytkownika.

EINTR

Pauza została przerwana sygnałem, dostarczonym wątkowi (zob. signal(7)). Pozostały czas uśpienia został zapisany do *rem, więc wątek może łatwo wywołać ponownie nanosleep() i dokończyć pauzę.

EINVAL

Wartość z pola tv_nsec nie była w zakresie [0, 999999999] lub tv_sec było ujemne.

WERSJE¶

POSIX.1 określa, że nanosleep() powinno odmierzać czas zegarem CLOCK_REALTIME (czasu rzeczywistego). Linux dokonuje tego jednak za pomocą zegara CLOCK_MONOTONIC (czasu monotonicznego). Prawdopodobnie nie ma to znaczenia, gdyż norma POSIX.1 wobec clock_settime(2) podaje, że skoki czasu w CLOCK_REALTIME nie powinny wpływać na nanosleep():

STANDARDY¶

POSIX.1-2008.

HISTORIA¶

POSIX.1-2001.

Aby wspierać aplikacje wymagające znacznie bardziej dokładnych pauz (np. aby sterować sprzętem o krytycznych zależnościach czasowych), nanosleep() radziło sobie z pauzami do 2 milisekund w ten sposób, że oczekiwało z zajętością, z mikrosekundową precyzją, gdy było wywoływane przez wątek, działający według polityki czasu rzeczywistego, takiej jak SCHED_FIFO czy SCHED_RR. To specjalnie rozszerzenie zostało usunięte w Linuksie 2.5.39, dlatego nie jest już dostępne od jądra Linux 2.6.0.

UWAGI¶

Jeśli duration nie jest dokładnie wielokrotnością rozdzielczości przedmiotowego zegara (zob. time(7), to interwał ten zostanie zaokrąglony w górę, do następnej wielokrotności. Co więcej, po zakończenia pauzy, wciąż może wystąpić zwłoka przez ponownym zwolnieniem procesora w celu ponownego wykonania wątku wywołującego.

Fakt, że nanosleep() pauzuje na interwał względny może być problematyczny, jeśli wywołanie jest ponownie restartowane po otrzymaniu sygnałów przerwania, ponieważ czas pomiędzy każdym restartem i przerwaniem wywołania, spowoduje przesunięcie czasu, w jakim pauza się ostatecznie zakończy. Problemu tego można uniknąć, używając clock_nanosleep(2) z bezwzględną wartością czasu.

USTERKI¶

Jeśli program przechwytujący sygnały i używający nanosleep() będzie otrzymywał sygnały z dużą częstością, to przydzielanie zasobów powoduje opóźnienia i błędy zaokrąglenia w obliczeniach, dotyczących interwału pauzy oraz zwracanej wartości remain, które dokonuje jądro, co oznacza, że wartość remain może systematycznie rosnąć po kolejnych restartach wywołania nanosleep(). Aby uniknąć tego typu problemów, należy korzystać z clock_nanosleep(2) ze znacznikiem TIMER_ABSTIME, aby pauzować do terminu określonego bezwzględnie.

W Linuksie 2.4, jeśli nanosleep() zostanie zatrzymane sygnałem (np. SIGTSTP), to wywołanie zawodzi z błędem EINTR po tym, jak wątek zostanie wznowiony sygnałem SIGCONT. Jeśli wywołanie systemowe zostanie później zrestartowane, to czas jaki wątek spędził w stanie zatrzymanym nie jest liczony do czasu pauzy. Problem naprawiono w Linuksie 2.6.0 i kolejnych jądrach.

ZOBACZ TAKŻE¶

clock_nanosleep(2), restart_syscall(2), sched_setscheduler(2), timer_create(2), sleep(3), timespec(3), usleep(3), time(7)

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl> 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 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.