WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

mtx_timedlock — Mutex mit einer Frist sperren

`mtx_timedlock` versucht, einen Mutex bis zu einer absoluten Frist auf Basis von `TIME_UTC` zu sperren. Das Ergebnis unterscheidet zwischen erfolgreicher Sperrung, Fristüberschreitung und Fehler.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <threads.h>
int mtx_timedlock(mtx_t *restrict mtx, const struct timespec *restrict ts);

mtx_timedlock aus <threads.h> wartet auf eine Sperre oder bis zur Frist ts: eine absolute Zeitangabe in TIME_UTC, keine Wartezeitspanne und keine monotone Zeit. Die Frist garantiert keinen exakten Zeitpunkt für die Rückkehr.

Initialisiere den Mutex mit mtx_init und mtx_timed oder mtx_timed | mtx_recursive; mtx_plain allein reicht nicht aus. Die möglichen Ergebnisse sind thrd_success, thrd_timedout und thrd_error. Gib die erworbene Sperre nur nach Erfolg mit mtx_unlock frei.

Das Beispiel verwendet einen nicht gesperrten Mutex und setzt die Frist auf eine Sekunde nach dem erfassten TIME_UTC-Zeitpunkt. Es erzwingt keinen Wettbewerb zwischen Threads. Die Unterstützung zur Laufzeit wurde nicht bestätigt.

Beispiele

#include <stdio.h>
#include <threads.h>
#include <time.h>

int main(void)
{
    mtx_t mutex;
    struct timespec deadline;

    if (mtx_init(&mutex, mtx_timed) != thrd_success)
        return 1;
    if (timespec_get(&deadline, TIME_UTC) != TIME_UTC) {
        mtx_destroy(&mutex);
        return 1;
    }

    deadline.tv_sec += 1;

    int result = mtx_timedlock(&mutex, &deadline);
    if (result == thrd_success) {
        if (mtx_unlock(&mutex) != thrd_success)
            return 1;
        puts("locked");
    } else if (result == thrd_timedout) {
        puts("timeout");
    } else {
        mtx_destroy(&mutex);
        return 1;
    }
    mtx_destroy(&mutex);
    return 0;
}

Ergebnis

locked

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen