Scroll to navigation

timespec_get(3) Library Functions Manual timespec_get(3)

BEZEICHNUNG

timespec_get, timespec_getres - ISO-C-Schnittstelle zu Uhr- und Zeitfunktionen

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

#include <time.h>
int timespec_get(struct timespec *erg, int Basis);
int timespec_getres(struct timespec *zz, int Basis);

Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

timespec_get(), TIME_UTC:



    _ISOC11_SOURCE

timespec_getres(), TIME_MONOTONIC, TIME_ACTIVE, TIME_THREAD_ACTIVE:



    _ISOC23_SOURCE

BESCHREIBUNG

Die Funktion timespec_get() speichert die aktuelle Zeit, basierend auf der angegebenen Zeitbasis, in der Struktur timespec(3type), auf die erg zeigt.

Die Funktion timespec_getres() speichert die Auflösungen der durch timespec_get() mit der angegebenen Zeitbasis abgefragten Zeiten in der Struktur timespec(3type), auf die zz zeigt, falls zz nicht NULL ist. Für eine bestimmte Zeitbasis ist die Auflösung für die begrenzte Dauer eines aufrufenden Prozesses konstant.

Jede Zeitbasis Basis ist eine der Folgenden:

Eine systemweite Zeitbasis, die tatsächliche Zeit (d.h. Uhrzeit) misst. Die Zeit und Auflösung in dieser Zeitbasis sind identisch zu denen durch clock_gettime(CLOCK_REALTIME, erg) bzw. clock_getres(CLOCK_REALTIME, zz) empfangenen.
Eine Zeitbasis, die die Zeit seit einem nicht festgelegten Punkt in der Vergangenheit misst, wobei die Zeit innerhalb eines Prozesses niemals rückwärts läuft, selbst wenn die Echtzeituhr gesetzt oder angepasst wird. Die Zeit und Auflösung in dieser Zeitbasis sind identisch zu denen durch clock_gettime(CLOCK_MONOTONIC, erg) bzw. clock_getres(CLOCK_MONOTONIC, zz) empfangenen.
Eine prozessspezifische Zeitbasis, die die durch den aufrufenden Prozess verbrauchte CPU-Zeit misst. Die Zeit und Auflösung in dieser Zeitbasis sind identisch zu denen durch clock_gettime(CLOCK_PROCESS_CPUTIME_ID, erg) bzw. clock_getres(CLOCK_PROCESS_CPUTIME_ID, zz) empfangenen.
Eine Thread-spezifische Zeitbasis, die die vom aufrufenden Thread verbrauchte CPU-Zeit misst.Die Zeit und Auflösung in dieser Zeitbasis sind identisch zu denen durch clock_gettime(CLOCK_THREAD_CPUTIME_ID, erg) bzw. clock_getres(CLOCK_THREAD_CPUTIME_ID, zz) empfangenen.

RÜCKGABEWERT

timespec_get() liefert die von Null verschiedene Basis zurück, falls sie eine unterstützte Zeitbasis ist und die aktuelle Zeit erfolgreich abgerufen werden konnte oder ansonsten 0.

timespec_getres() liefert die von Null verschiedene Basis zurück, falls sie eine unterstützte Zeitbasis ist oder ansonsten 0.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

Schnittstelle Attribut Wert
timespec_get(), timespec_getres() Multithread-Fähigkeit MT-Sicher

STANDARDS

C23, POSIX.1-2024.
C23 (obwohl ISO C die Zeit-Epoch nicht spezifiziert), POSIX.1-2024.
C23.

GESCHICHTE

C11, POSIX.1-2024, Glibc 2.16, Musl 1.1.10.
C23, Glibc 2.34.
C23, Glibc 2.43.

SIEHE AUCH

clock_gettime(2), clock_getres(2)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.

11. Februar 2026 Linux man-pages 6.17