CKTIS / C
memset_explicit — sovrascrittura esplicita della memoria
La funzione C23 memset_explicit riempie un’area di memoria specificata con un byte scelto. È pensata per cancellare dati sensibili senza che l’ottimizzatore elimini la scrittura perché la considera superflua.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <string.h>
void *memset_explicit(void *s, int c, size_t n);memset_explicit, dichiarata in <string.h>, scrive c, convertito in unsigned char, nei primi n byte dell’oggetto puntato da s. Restituisce s, non un codice di successo. n indica un numero di byte, non la lunghezza di un testo.
A differenza di memset, questa funzione è pensata per sovrascrivere dati sensibili: la nota a piè di pagina in N3096 spiega l’intenzione che l’ottimizzazione non elimini mai la scrittura, anche quando il programma non leggerà più il buffer. Questo non significa che vengano eliminate altre copie, per esempio dati salvati in precedenza in un altro buffer o su disco.
Fornire un puntatore valido a memoria scrivibile e una dimensione adeguata: la funzione non riceve la capacità del buffer e non controlla i limiti. Sovrascrivere i dati prima che termini la durata dell’oggetto. Nell’esempio, sizeof secret comprende l’intero array; per un puntatore, sizeof non indica la dimensione del buffer puntato.
La funzione fa parte di C23. Un’opzione del compilatore in un repository non dimostra da sola che la libreria C di destinazione fornisca dichiarazione e implementazione; il supporto in fase di esecuzione in produzione non è stato attestato.
Esempi
#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;
}
Risultato
cleared=1 same_pointer=1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.