libressl-ASN1_NULL_new(3)

libressl-ASN1_NULL_new3

Asn.1 null value

Usage

Crypto Library (libcrypto, -lcrypto)

#include <openssl/asn1.h>

ASN1_NULL *

ASN1_NULL_new(void);

void

ASN1_NULL_free(ASN1_NULL *val_in);

Overview

ASN1_NULL_new() returns a specific invalid pointer that represents the ASN.1 NULL value, which is the only possible value of the ASN.1 NULL type. That pointer is different from a NULL pointer. Dereferencing it almost certainly results in a segmentation fault. This function does not allocate memory and cannot fail.

ASN1_NULL_free() has no effect whatsoever. In particular, it ignores the val_in argument and does not free any memory. In normal use, application programs only pass the invalid pointer obtained from ASN1_NULL_new() to this function. But even if a valid pointer is passed, that pointer does not become invalid.

The ASN.1 NULL type is also represented by the V_ASN1_NULL type identifier constant.

Standards

ITU-T Recommendation X.208, also known as ISO/IEC 8824-1: Specification of Abstract Syntax Notation One (ASN.1), section 19: Notation for the null type

History

ASN1_NULL_new() and ASN1_NULL_free() first appeared in OpenSSL 0.9.5 and have been available since OpenBSD 2.7.

From libressl 4.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.