Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje