KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

memset_explicit — geheugen expliciet overschrijven

De C23-functie memset_explicit vult een opgegeven geheugengebied met een gekozen byte. De functie is bedoeld om gevoelige gegevens te wissen zonder dat de optimizer de schrijfopdracht als overbodig verwijdert.

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

Syntax

#include <string.h>
void *memset_explicit(void *s, int c, size_t n);

memset_explicit, gedeclareerd in <string.h>, schrijft c, geconverteerd naar unsigned char, naar de eerste n bytes van het object waarnaar s verwijst. De functie retourneert s, geen succescode. n is een aantal bytes, geen tekstlengte.

In tegenstelling tot memset is deze functie bedoeld om gevoelige gegevens te overschrijven: de voetnoot in N3096 licht toe dat de optimalisatie de schrijfopdracht nooit mag verwijderen, ook niet als het programma de buffer daarna niet meer leest. Dit betekent niet dat andere kopieën worden gewist, zoals gegevens die eerder in een andere buffer of op schijf zijn opgeslagen.

Geef een geldige verwijzing naar beschrijfbaar geheugen en een passende grootte op: de functie krijgt geen buffercapaciteit en controleert de grenzen niet. Overschrijf gegevens voordat de levensduur van het object eindigt. In het voorbeeld omvat sizeof secret de hele array; bij een pointer geeft sizeof niet de grootte van de buffer waarnaar die verwijst.

De functie hoort bij C23. Een compileroptie in een repository bewijst op zichzelf niet dat de doel-C-bibliotheek de declaratie en implementatie levert; ondersteuning tijdens uitvoering in productie is niet bevestigd.

Voorbeelden

#include <stddef.h>
#include <stdio.h>
#include <string.h>

int main(void)
{
    unsigned char secret[] = {1, 2, 3, 4};
    void *result = memset_explicit(secret, 0, sizeof secret);
    int cleared = 1;
    for (size_t i = 0; i < sizeof secret; ++i) {
        if (secret[i] != 0) cleared = 0;
    }
    printf("cleared=%d same_pointer=%d\n", cleared, result == (void *)secret);
    return 0;
}

Resultaat

cleared=1 same_pointer=1

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