CKTIS / C
memset_explicit — écrasement explicite de la mémoire
La fonction C23 memset_explicit remplit une zone mémoire spécifiée avec un octet choisi. Elle est destinée à effacer des données sensibles sans que l’optimiseur supprime l’écriture parce qu’elle lui semble inutile.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <string.h>
void *memset_explicit(void *s, int c, size_t n);memset_explicit, déclarée dans <string.h>, écrit c, converti en unsigned char, dans les n premiers octets de l’objet pointé par s. Elle renvoie s, et non un code de réussite. n désigne un nombre d’octets, pas une longueur de texte.
Contrairement à memset, cette fonction est destinée à écraser des données sensibles : la note de bas de page de N3096 explique que l’écriture ne doit jamais être supprimée par l’optimisation, même si le programme ne lit plus le tampon. Cela ne signifie pas que d’autres copies sont effacées, par exemple des données auparavant enregistrées dans un autre tampon ou sur un disque.
Fournissez un pointeur valide vers une mémoire modifiable et une taille appropriée : la fonction ne reçoit pas la capacité du tampon et ne vérifie pas les limites. Écrasez les données avant la fin de la durée de vie de l’objet. Dans l’exemple, sizeof secret couvre le tableau entier ; pour un pointeur, sizeof ne donne pas la taille du tampon pointé.
Cette fonction fait partie de C23. Un indicateur du compilateur dans un dépôt ne suffit pas à établir que la bibliothèque C cible fournit sa déclaration et son implémentation ; la prise en charge à l’exécution en production n’a pas été attestée.
Exemples
#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;
}
Résultat
cleared=1 same_pointer=1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.