CKTIS / C
memset_explicit — izričito prepisivanje memorije
Funkcija C23 memset_explicit ispunjava određeno područje memorije odabranim bajtom. Namijenjena je brisanju osjetljivih podataka, a da optimizator ne ukloni zapis kao nepotrebnu operaciju.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <string.h>
void *memset_explicit(void *s, int c, size_t n);memset_explicit, deklarirana u <string.h>, zapisuje c, pretvoren u unsigned char, u prvih n bajtova objekta na koji pokazuje s. Vraća s, a ne kod uspjeha. n je broj bajtova, a ne duljina teksta.
Za razliku od memset, ova je funkcija namijenjena prepisivanju osjetljivih podataka: fusnota u N3096 objašnjava namjeru da optimizacija nikad ne ukloni zapis, čak i kada program više neće čitati međuspremnik. To ne znači da se brišu i druge kopije, primjerice podaci prethodno pohranjeni u drugom međuspremniku ili na disku.
Navedite valjan pokazivač na zapisivu memoriju i odgovarajuću veličinu: funkcija ne prima kapacitet međuspremnika i ne provjerava granice. Prepišite podatke prije završetka životnog vijeka objekta. U primjeru sizeof secret obuhvaća cijeli niz; za pokazivač sizeof ne daje veličinu međuspremnika na koji pokazuje.
Funkcija je dio C23. Zastavica prevoditelja u repozitoriju sama po sebi ne potvrđuje da ciljna C biblioteka pruža deklaraciju i implementaciju; podrška tijekom izvođenja u produkciji nije potvrđena.
Primjeri
#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;
}
Rezultat
cleared=1 same_pointer=1
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.