Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

memset_explicit — sobrescrita explícita de memória

A função C23 memset_explicit preenche uma região de memória especificada com um byte escolhido. Destina-se a apagar dados sensíveis sem que o otimizador remova a escrita por a considerar desnecessária.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <string.h>
void *memset_explicit(void *s, int c, size_t n);

memset_explicit, declarada em <string.h>, escreve c, convertido para unsigned char, nos primeiros n bytes do objeto apontado por s. Devolve s, não um código de sucesso. n é uma contagem de bytes, não o comprimento de um texto.

Ao contrário de memset, esta função destina-se a sobrescrever dados sensíveis: a nota de rodapé em N3096 explica a intenção de que a otimização nunca remova a escrita, mesmo quando o programa já não voltar a ler o buffer. Isto não significa que sejam apagadas outras cópias, como dados anteriormente guardados noutro buffer ou num disco.

Forneça um ponteiro válido para memória gravável e um tamanho adequado: a função não recebe a capacidade do buffer nem verifica os limites. Sobrescreva os dados antes de terminar o tempo de vida do objeto. No exemplo, sizeof secret abrange todo o array; para um ponteiro, sizeof não indica o tamanho do buffer apontado.

A função faz parte de C23. Uma opção do compilador num repositório, por si só, não demonstra que a biblioteca C de destino disponibiliza a declaração e a implementação; o suporte em tempo de execução em produção não foi confirmado.

Exemplos

#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;
}

Resultado

cleared=1 same_pointer=1

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes