xref: /netbsd-src/crypto/external/bsd/openssl/lib/libcrypto/man/PEM_read_CMS.3 (revision 7d9ffdb3e9da593a05c5e2169f72fc7bada08bc9)
$NetBSD: PEM_read_CMS.3,v 1.9 2024/09/08 13:08:27 christos Exp $

-*- mode: troff; coding: utf-8 -*-
Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)

Standard preamble:
========================================================================
..
..
.. \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
. ds C` "" . ds C' "" 'br\} . ds C` . ds C' 'br\}
Escape single quotes in literal strings from groff's Unicode transform.

If the F register is >0, we'll generate index entries on stderr for
titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
entries marked with X<> in POD. Of course, you'll have to process the
output yourself in some meaningful fashion.

Avoid warning from groff about undefined register 'F'.
.. .nr rF 0 . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF ========================================================================

Title "PEM_read_CMS 3"
PEM_read_CMS 3 2024-09-03 3.0.15 OpenSSL
For nroff, turn off justification. Always turn off hyphenation; it makes
way too many mistakes in technical documents.
NAME
DECLARE_PEM_rw, PEM_read_CMS, PEM_read_bio_CMS, PEM_write_CMS, PEM_write_bio_CMS, PEM_write_DHxparams, PEM_write_bio_DHxparams, PEM_read_ECPKParameters, PEM_read_bio_ECPKParameters, PEM_write_ECPKParameters, PEM_write_bio_ECPKParameters, PEM_read_ECPrivateKey, PEM_write_ECPrivateKey, PEM_write_bio_ECPrivateKey, PEM_read_EC_PUBKEY, PEM_read_bio_EC_PUBKEY, PEM_write_EC_PUBKEY, PEM_write_bio_EC_PUBKEY, PEM_read_NETSCAPE_CERT_SEQUENCE, PEM_read_bio_NETSCAPE_CERT_SEQUENCE, PEM_write_NETSCAPE_CERT_SEQUENCE, PEM_write_bio_NETSCAPE_CERT_SEQUENCE, PEM_read_PKCS8, PEM_read_bio_PKCS8, PEM_write_PKCS8, PEM_write_bio_PKCS8, PEM_write_PKCS8_PRIV_KEY_INFO, PEM_read_bio_PKCS8_PRIV_KEY_INFO, PEM_read_PKCS8_PRIV_KEY_INFO, PEM_write_bio_PKCS8_PRIV_KEY_INFO, PEM_read_SSL_SESSION, PEM_read_bio_SSL_SESSION, PEM_write_SSL_SESSION, PEM_write_bio_SSL_SESSION, PEM_read_X509_PUBKEY, PEM_read_bio_X509_PUBKEY, PEM_write_X509_PUBKEY, PEM_write_bio_X509_PUBKEY \- PEM object encoding routines
SYNOPSIS
Header "SYNOPSIS" .Vb 1 #include <openssl/pem.h> \& DECLARE_PEM_rw(name, TYPE) \& TYPE *PEM_read_TYPE(FILE *fp, TYPE **a, pem_password_cb *cb, void *u); TYPE *PEM_read_bio_TYPE(BIO *bp, TYPE **a, pem_password_cb *cb, void *u); int PEM_write_TYPE(FILE *fp, const TYPE *a); int PEM_write_bio_TYPE(BIO *bp, const TYPE *a); .Ve

The following functions have been deprecated since OpenSSL 3.0, and can be hidden entirely by defining OPENSSL_API_COMPAT with a suitable version value, see openssl_user_macros\|(7):

.Vb 1 #include <openssl/pem.h> \& int PEM_write_DHxparams(FILE *out, const DH *dh); int PEM_write_bio_DHxparams(BIO *out, const DH *dh); EC_GROUP *PEM_read_ECPKParameters(FILE *fp, EC_GROUP **x, pem_password_cb *cb, void *u); EC_GROUP *PEM_read_bio_ECPKParameters(BIO *bp, EC_GROUP **x, pem_password_cb *cb, void *u); int PEM_write_ECPKParameters(FILE *out, const EC_GROUP *x); int PEM_write_bio_ECPKParameters(BIO *out, const EC_GROUP *x), \& EC_KEY *PEM_read_EC_PUBKEY(FILE *fp, EC_KEY **x, pem_password_cb *cb, void *u); EC_KEY *PEM_read_bio_EC_PUBKEY(BIO *bp, EC_KEY **x, pem_password_cb *cb, void *u); int PEM_write_EC_PUBKEY(FILE *out, const EC_KEY *x); int PEM_write_bio_EC_PUBKEY(BIO *out, const EC_KEY *x); \& EC_KEY *PEM_read_ECPrivateKey(FILE *out, EC_KEY **x, pem_password_cb *cb, void *u); EC_KEY *PEM_read_bio_ECPrivateKey(BIO *out, EC_KEY **x, pem_password_cb *cb, void *u); int PEM_write_ECPrivateKey(FILE *out, const EC_KEY *x, const EVP_CIPHER *enc, const unsigned char *kstr, int klen, pem_password_cb *cb, void *u); int PEM_write_bio_ECPrivateKey(BIO *out, const EC_KEY *x, const EVP_CIPHER *enc, const unsigned char *kstr, int klen, pem_password_cb *cb, void *u); .Ve

DESCRIPTION
Header "DESCRIPTION" All of the functions described on this page are deprecated. Applications should use OSSL_ENCODER_to_bio() and OSSL_DECODER_from_bio() instead.

In the description below, \f(BITYPE is used as a placeholder for any of the OpenSSL datatypes, such as X509. The macro DECLARE_PEM_rw expands to the set of declarations shown in the next four lines of the synopsis.

These routines convert between local instances of ASN1 datatypes and the PEM encoding. For more information on the templates, see \fBASN1_ITEM\|(3). For more information on the lower-level routines used by the functions here, see PEM_read\|(3).

\fBPEM_read_\f(BITYPE() reads a PEM-encoded object of \f(BITYPE from the file \fIfp and returns it. The cb and u parameters are as described in \fBpem_password_cb\|(3).

\fBPEM_read_bio_\f(BITYPE() is similar to PEM_read_\f(BITYPE() but reads from the BIO bp.

\fBPEM_write_\f(BITYPE() writes the PEM encoding of the object a to the file \fIfp.

\fBPEM_write_bio_\f(BITYPE() similarly writes to the BIO bp.

NOTES
Header "NOTES" These functions make no assumption regarding the pass phrase received from the password callback. It will simply be treated as a byte sequence.
"RETURN VALUES"
Header "RETURN VALUES" \fBPEM_read_\f(BITYPE() and PEM_read_bio_\f(BITYPE() return a pointer to an allocated object, which should be released by calling \f(BITYPE_free(), or NULL on error.

\fBPEM_write_\f(BITYPE() and PEM_write_bio_\f(BITYPE() return 1 for success or 0 for failure.

"SEE ALSO"
Header "SEE ALSO" \fBPEM_read\|(3), \fBpassphrase-encoding\|(7)
HISTORY
Header "HISTORY" The functions PEM_write_DHxparams(), PEM_write_bio_DHxparams(), \fBPEM_read_ECPKParameters(), PEM_read_bio_ECPKParameters(), \fBPEM_write_ECPKParameters(), PEM_write_bio_ECPKParameters(), \fBPEM_read_EC_PUBKEY(), PEM_read_bio_EC_PUBKEY(), \fBPEM_write_EC_PUBKEY(), PEM_write_bio_EC_PUBKEY(), \fBPEM_read_ECPrivateKey(), PEM_read_bio_ECPrivateKey(), \fBPEM_write_ECPrivateKey() and PEM_write_bio_ECPrivateKey() were deprecated in OpenSSL 3.0.
COPYRIGHT
Header "COPYRIGHT" Copyright 1998-2023 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>.