CKTIS / C
memset_explicit — explicitní přepsání paměti
Funkce C23 memset_explicit vyplní určenou oblast paměti zvoleným bajtem. Je určena k mazání citlivých dat, aniž by optimalizátor odstranil zápis jako nepotřebnou operaci.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <string.h>
void *memset_explicit(void *s, int c, size_t n);memset_explicit, deklarovaná v <string.h>, zapíše c, převedené na unsigned char, do prvních n bajtů objektu, na který ukazuje s. Vrací s, nikoli návratový kód úspěchu. n udává počet bajtů, ne délku textu.
Na rozdíl od memset je tato funkce určena k přepisování citlivých dat: poznámka pod čarou v N3096 vysvětluje záměr, aby optimalizace zápis nikdy neodstranila, ani když program už nebude znovu číst buffer. Neznamená to, že se odstraní i jiné kopie, například data dříve uložená v jiném bufferu nebo na disku.
Předejte platný ukazatel na zapisovatelnou paměť a odpovídající velikost: funkce nedostává kapacitu bufferu a nekontroluje jeho hranice. Data přepište před koncem životnosti objektu. V příkladu zahrnuje sizeof secret celé pole; u ukazatele sizeof neudává velikost bufferu, na který ukazuje.
Funkce patří do C23. Samotný příznak kompilátoru v repozitáři nedokládá, že cílová knihovna C poskytuje její deklaraci a implementaci; podpora za běhu v produkčním prostředí nebyla potvrzena.
Pří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ýsledek
cleared=1 same_pointer=1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.