mirror of
https://github.com/openssl/openssl.git
synced 2025-01-24 13:55:42 +08:00
be5adfd6e3
Added tests for SDA and AI extensions. Added internal function ossl_print_attribute_value() with documentation. Reviewed-by: Neil Horman <nhorman@openssl.org> Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/24669)
53 lines
1.9 KiB
Plaintext
53 lines
1.9 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
ossl_print_attribute_value
|
|
- Print an X.500 directory attribute value
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include <crypto/x509.h>
|
|
|
|
int ossl_print_attribute_value(BIO *out, int obj_nid, const ASN1_TYPE *av, int indent);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
ossl_print_attribute_value() prints an X.500 directory value, which is an
|
|
ASN.1 value and an associated attribute type that informs its interpretation,
|
|
syntax, display characteristics, comparison, sorting, and substring searching
|
|
behaviors, among other things. This attribute type is identified by an ASN.1
|
|
object identifier.
|
|
|
|
X.500 directory values are used in the relative distinguished names in a
|
|
distinguished name, as seen in the C<subject> and C<issuer> fields of an X.509
|
|
public key certificate. They also appear in the attributes of an X.509
|
|
attribute certificate, as well as in the subjectDirectoryAttributes or
|
|
associatedInformation X.509v3 extensions.
|
|
|
|
The I<out> argument is a B<BIO> pointer for printing the output. The I<obj_nid>
|
|
argument is the NID of the attribute type object identifier. The ASN.1 value
|
|
itself is passed in I<av> and the level of desired indentation in terms of the
|
|
number of spaces is specified in I<indent>.
|
|
|
|
This function generally prints values in such a way as to keep them on a single
|
|
line, but this is not always the case. Unrecognized attribute types whose syntax
|
|
is a C<SET> or C<SEQUENCE> will be printed on multiple lines, for instance. Not
|
|
all ASN.1 syntaxes are currently supported, and there is no guarantee for what
|
|
printed values will look like in future versions.
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
Returns 1 if it succeeds in printing, and 0 if it failed.
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2024 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
|