Provided by: manpages-pl-dev_4.23.1-1_all 
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);
Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):
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():
Ustawienie wartości zegara CLOCK_REALTIME za pomocą clock_settime(2) nie powinno mieć wpływu na
wątki, które są zablokowane w oczekiwaniu na usługę czasu względnego, opartą na tym zegarze, w tym
funkcję nanosleep(); ... Te usługi czasu powinny zatem wygasać, gdy upłynie żądany okres,
niezależnie od nowej lub starej wartości zegara.
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.
Linux man-pages 6.8 2 maja 2024 r. nanosleep(2)