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.