Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

memset_explicit — jawne nadpisywanie pamięci

Funkcja C23 memset_explicit wypełnia wskazany obszar pamięci wybranym bajtem. Służy do usuwania danych wrażliwych bez ryzyka pominięcia zapisu jako zbędnej operacji przez optymalizator.

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

Składnia

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

memset_explicit, zadeklarowana w <string.h>, zapisuje wartość c po konwersji do unsigned char w pierwszych n bajtach obiektu wskazywanego przez s. Zwraca s, a nie kod powodzenia. n oznacza liczbę bajtów, nie długość tekstu.

W odróżnieniu od memset funkcja służy do nadpisywania danych wrażliwych: przypis w N3096 wyjaśnia zamiar, aby zapis nigdy nie był usuwany przez optymalizację, nawet gdy program nie odczyta już bufora. Nie oznacza to usunięcia innych kopii danych, na przykład zapisanych wcześniej w innym buforze lub na dysku.

Zapewnij prawidłowy wskaźnik do zapisywalnej pamięci i odpowiedni rozmiar: funkcja nie otrzymuje pojemności bufora i nie sprawdza jego granic. Nadpisuj dane przed końcem czasu życia obiektu. sizeof secret w przykładzie obejmuje całą tablicę; dla wskaźnika sizeof nie podaje rozmiaru wskazanego bufora.

Funkcja należy do C23. Sama flaga kompilatora w repozytorium nie potwierdza dostępności deklaracji i implementacji w docelowej bibliotece C; obsługa w środowisku produkcyjnym nie została potwierdzona.

Przykłady

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

Wynik

cleared=1 same_pointer=1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła