KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

mtx_timedlock — een mutex vergrendelen met een deadline

`mtx_timedlock` probeert een mutex te vergrendelen vóór een absolute deadline op basis van `TIME_UTC`. De uitkomst maakt onderscheid tussen een geslaagde vergrendeling, een verstreken deadline en een fout.

Versie: 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 uit <threads.h> wacht op een vergrendeling of tot de deadline ts: een absolute tijd in TIME_UTC, geen wachttijdsduur en geen monotone tijd. De deadline garandeert geen exact tijdstip waarop de functie terugkeert.

Initialiseer de mutex met mtx_init en mtx_timed of mtx_timed | mtx_recursive; alleen mtx_plain is niet voldoende. De resultaten zijn thrd_success, thrd_timedout en thrd_error. Geef de verkregen vergrendeling alleen na succes vrij met mtx_unlock.

Het voorbeeld gebruikt een niet-vergrendelde mutex en stelt de deadline in op één seconde na het uitgelezen TIME_UTC-tijdstip. Het dwingt geen concurrentie tussen threads af. Ondersteuning tijdens uitvoering is niet bevestigd.

Voorbeelden

#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;
}

Resultaat

locked

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen