mirror of
https://github.com/openssl/openssl.git
synced 2024-11-27 05:21:51 +08:00
a55b00bdbc
Reviewed-by: Richard Levitte <levitte@openssl.org> (Merged from https://github.com/openssl/openssl/pull/13038)
49 lines
1.4 KiB
Plaintext
49 lines
1.4 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
ossl_DER_w_precompiled
|
|
- internal DER writers for precompiled DER blobs
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include "internal/der.h"
|
|
|
|
int ossl_DER_w_precompiled(WPACKET *pkt, int tag,
|
|
const unsigned char *precompiled,
|
|
size_t precompiled_n);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
There may be already existing DER blobs that can simply be copied to
|
|
the buffer held by I<pkt>. For example, precompiled values, such as
|
|
OIDs (for example, C<id-sha256>) or complete AlgorithmIdentifiers
|
|
(for example, C<sha256Identifier>). To add those as an element in a
|
|
structure being DER encoded, use ossl_DER_w_precompiled().
|
|
|
|
ossl_DER_w_precompiled() will simply take the DER encoded blob given as
|
|
I<precompiled> with length I<precompiled_n> and add it to the buffer
|
|
held by I<pkt>.
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
ossl_DER_w_precompiled() returns 1 on success and 0 on failure. Failure
|
|
may mean that the buffer held by the I<pkt> is too small, but may also
|
|
mean that the values given to the functions are invalid, such as the provided
|
|
I<tag> value being too large for the implementation.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<DERlib(7)>
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2020 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
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
=cut
|