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:

TIME_UTC
    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.

TIME_MONOTONIC
    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.

TIME_ACTIVE
    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.

TIME_THREAD_ACTIVE
    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

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

timespec_getres()
TIME_MONOTONIC
TIME_ACTIVE
TIME_THREAD_ACTIVE
    C23.

GESCHICHTE

timespec_get()
TIME_UTC
    C11, POSIX.1-2024, Glibc 2.16, Musl 1.1.10.

timespec_getres()
    C23, Glibc 2.34.

TIME_MONOTONIC
TIME_ACTIVE
TIME_THREAD_ACTIVE
    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 (https://www.gnu.org/licenses/gpl-3.0.html) 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).