Reallocate a buffer, securely clearing any released trailing bytes.

Synopsis

Declared in <openssl/crypto.h>

void*
CRYPTO_clear_realloc(
    void* addr,
    size_t old_num,
    size_t num,
    char const* file,
    int line);

Return Value

Reallocated pointer, or NULL on failure (original block left allocated on failure).

Parameters

Name

Description

addr

Existing allocation, or NULL to allocate anew.

old_num

Previous size in bytes (used when clearing shrunk regions).

num

New size in bytes.

file

Source file name recorded with the allocation (usually FILE).

line

Source line recorded with the allocation (usually LINE).

Created with MrDocs