CKTIS / C
memset_explicit — izrecno prepisovanje pomnilnika
Funkcija C23 memset_explicit zapolni določeno območje pomnilnika z izbranim bajtom. Namenjena je brisanju občutljivih podatkov, ne da bi optimizator odstranil zapis kot nepotrebno operacijo.
Različica: 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 v <string.h>, zapiše c, pretvorjen v unsigned char, v prvih n bajtov objekta, na katerega kaže s. Vrne s, ne kode uspeha. n pomeni število bajtov, ne dolžine besedila.
Za razliko od memset je ta funkcija namenjena prepisovanju občutljivih podatkov: opomba pod črto v N3096 pojasnjuje, da optimizacija zapisa nikoli ne sme odstraniti, tudi če program medpomnilnika ne bo več bral. To ne pomeni, da se odstranijo tudi druge kopije, na primer podatki, prej shranjeni v drugem medpomnilniku ali na disku.
Podajte veljaven kazalec na zapisljiv pomnilnik in ustrezno velikost: funkcija ne prejme zmogljivosti medpomnilnika in ne preverja njegovih meja. Podatke prepišite pred koncem življenjske dobe objekta. V primeru sizeof secret zajame celotno polje; pri kazalcu sizeof ne poda velikosti medpomnilnika, na katerega kaže.
Funkcija je del C23. Zastavica prevajalnika v repozitoriju sama po sebi ne dokazuje, da ciljna knjižnica C zagotavlja deklaracijo in implementacijo; podpora med izvajanjem v produkciji ni bila potrjena.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.