CKTIS / C
memset_explicit — explicitné prepísanie pamäte
Funkcia C23 memset_explicit vyplní určenú oblasť pamäte zvoleným bajtom. Je určená na mazanie citlivých údajov bez toho, aby optimalizátor odstránil zápis ako nepotrebnú operáciu.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
void *memset_explicit(void *s, int c, size_t n);memset_explicit, deklarovaná v <string.h>, zapíše c, konvertované na unsigned char, do prvých n bajtov objektu, na ktorý ukazuje s. Vráti s, nie kód úspechu. n označuje počet bajtov, nie dĺžku textu.
Na rozdiel od memset je táto funkcia určená na prepisovanie citlivých údajov: poznámka pod čiarou v N3096 vysvetľuje zámer, aby optimalizácia zápis nikdy neodstránila, ani keď program už nebude buffer čítať. Neznamená to, že sa odstránia aj iné kópie, napríklad údaje predtým uložené v inom buffri alebo na disku.
Odovzdajte platný ukazovateľ na zapisovateľnú pamäť a vhodnú veľkosť: funkcia nedostáva kapacitu buffera a nekontroluje jeho hranice. Údaje prepíšte pred skončením životnosti objektu. V príklade zahŕňa sizeof secret celé pole; pri ukazovateli sizeof neudáva veľkosť buffera, na ktorý ukazuje.
Funkcia patrí do C23. Samotný príznak kompilátora v repozitári nedokazuje, že cieľová knižnica C poskytuje jej deklaráciu a implementáciu; podpora za behu v produkcii nebola potvrdená.
Príklady
#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;
}
Výsledok
cleared=1 same_pointer=1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.