Sortix cross-nightly manual

This manual documents Sortix cross-nightly. You can instead view this document in the latest official manual.

NAME

PKCS7_set_content, PKCS7_content_new — set the nested contentInfo in a PKCS#7 structure

SYNOPSIS

#include <openssl/pkcs7.h>

int
PKCS7_set_content(PKCS7 *outer, PKCS7 *inner);

int
PKCS7_content_new(PKCS7 *outer, int inner_type);

DESCRIPTION

If the contentType of the outer PKCS7 structure is SignedData or DigestedData, PKCS7_set_content() sets the contentInfo field of the content field of outer to inner, without copying inner. If there was previous contentInfo, it is freed rather than overwritten. The rest of the internal state of outer and of its content remains unchanged.

PKCS7_content_new() is similar except that it first allocates and initializes a new, empty inner object of the given inner_type using PKCS7_new(3) and PKCS7_set_type(3). The inner_type can be any of the NIDs listed in the PKCS7_set_type(3) manual.

RETURN VALUES

These functions return 1 on success or 0 on failure. They fail if the contentType of outer is unsupported. PKCS7_content_new() can also fail when memory is exhausted. In case of failure, outer remains unchanged.

STANDARDS

RFC 2315: PKCS #7: Cryptographic Message Syntax Version 1.5

Section 7. General syntax
Section 9. Signed-data content type
Section 12. Digested-data content type

HISTORY

These functions first appeared in SSLeay 0.8.1 and have been available since OpenBSD 2.4.

CAVEATS

Despite the function names, these functions do not set the content field of outer, but only the contentInfo field inside it. The rest of the content remains unchanged.