WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

memset_explicit — explizites Überschreiben von Speicher

Die C23-Funktion memset_explicit füllt einen angegebenen Speicherbereich mit einem ausgewählten Byte. Sie ist dafür vorgesehen, sensible Daten zu löschen, ohne dass der Optimierer den Schreibvorgang als unnötig entfernt.

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

Syntax

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

memset_explicit, deklariert in <string.h>, schreibt c, nach der Konvertierung zu unsigned char, in die ersten n Bytes des von s bezeichneten Objekts. Sie gibt s zurück, keinen Erfolgscode. n ist eine Byteanzahl, keine Textlänge.

Im Gegensatz zu memset ist diese Funktion zum Überschreiben sensibler Daten gedacht: Die Fußnote in N3096 erläutert die Absicht, dass die Optimierung den Schreibvorgang niemals entfernen soll, selbst wenn das Programm den Puffer danach nicht mehr liest. Das bedeutet nicht, dass andere Kopien gelöscht werden, etwa zuvor in einem anderen Puffer oder auf einem Datenträger gespeicherte Daten.

Übergeben Sie einen gültigen Zeiger auf beschreibbaren Speicher und eine passende Größe: Die Funktion erhält keine Pufferkapazität und prüft keine Grenzen. Überschreiben Sie die Daten, bevor die Lebensdauer des Objekts endet. Im Beispiel umfasst sizeof secret das gesamte Array; bei einem Zeiger gibt sizeof nicht die Größe des referenzierten Puffers an.

Die Funktion gehört zu C23. Ein Compiler-Flag im Repository allein belegt nicht, dass die Ziel-C-Bibliothek Deklaration und Implementierung bereitstellt; die Laufzeitunterstützung in der Produktionsumgebung wurde nicht bestätigt.

Beispiele

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

Ergebnis

cleared=1 same_pointer=1

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