dwww Home | Manual pages | Find package

OSSL_IETF_ATTR_SYNTAX(3SSL)         OpenSSL         OSSL_IETF_ATTR_SYNTAX(3SSL)

NAME
       OSSL_IETF_ATTR_SYNTAX, OSSL_IETF_ATTR_SYNTAX_get0_policyAuthority,
       OSSL_IETF_ATTR_SYNTAX_set0_policyAuthority,
       OSSL_IETF_ATTR_SYNTAX_get_value_num, OSSL_IETF_ATTR_SYNTAX_get0_value,
       OSSL_IETF_ATTR_SYNTAX_add1_value - Accessors and setters for
       OSSL_IETF_ATTR_SYNTAX

SYNOPSIS
        #include <openssl/x509_acert.h>

        typedef struct OSSL_IETF_ATTR_SYNTAX_st OSSL_IETF_ATTR_SYNTAX;

        const GENERAL_NAMES *
        OSSL_IETF_ATTR_SYNTAX_get0_policyAuthority(const OSSL_IETF_ATTR_SYNTAX *a);
        void OSSL_IETF_ATTR_SYNTAX_set0_policyAuthority(OSSL_IETF_ATTR_SYNTAX *a,
                                                        GENERAL_NAMES *names);

        int OSSL_IETF_ATTR_SYNTAX_get_value_num(const OSSL_IETF_ATTR_SYNTAX *a);
        void *OSSL_IETF_ATTR_SYNTAX_get0_value(const OSSL_IETF_ATTR_SYNTAX *a,
                                               int ind, int *type);
        int OSSL_IETF_ATTR_SYNTAX_add1_value(OSSL_IETF_ATTR_SYNTAX *a, int type,
                                             void *data);

DESCRIPTION
       OSSL_IETF_ATTR_SYNTAX is an opaque structure that represents the
       IetfAttrSyntax type defined in RFC 5755 (Section 4.4) for use as an
       AttributeValue.

       OSSL_IETF_ATTR_SYNTAX_get0_policyAuthority() and
       OSSL_IETF_ATTR_SYNTAX_set0_policyAuthority() get and set the
       policyAuthority field of the structure. Both routines act on internal
       pointers of the structure and must not be freed by the application.

       An OSSL_IETF_ATTR_SYNTAX object also holds a sequence of values.
       OSSL_IETF_ATTR_SYNTAX_get_value_num() returns the number of values in
       the sequence.  OSSL_IETF_ATTR_SYNTAX_add1_value(), adds a copy of data
       of a specified type to the sequence.  The caller should free the data
       after use.

       OSSL_IETF_ATTR_SYNTAX_get0_value() will return the value and a specific
       index ind in the sequence or NULL on error.  If type is not NULL, the
       type of the value will be written to this location.

       The type of the values stored in the OSSL_IETF_ATTR_SYNTAX value
       sequence is one of the following:

       OSSL_IETFAS_OCTETS
           A pointer to an ASN1_OCTET_STRING

       OSSL_IETFAS_OID
           A pointer to an ASN1_OBJECT

       OSSL_IETFAS_STRING
           A pointer to an ASN1_UTF8STRING

RETURN VALUES
       OSSL_IETF_ATTR_SYNTAX_get0_policyAuthority()  returns  an  pointer  to a
       GENERAL_NAMES structure or NULL if the policy  authority  has  not  been
       set.

       OSSL_IETF_ATTR_SYNTAX_get_value_num()  returns  the number of entries in
       the value sequence or -1 on error.

       OSSL_IETF_ATTR_SYNTAX_get0_value() returns a pointer to the value at the
       given index or NULL if the index is out of range.

       OSSL_IETF_ATTR_SYNTAX_add1_value()  returns  1  on  success  and  0   on
       failure.

HISTORY
       OSSL_IETF_ATTR_SYNTAX_get0_policyAuthority(),
       OSSL_IETF_ATTR_SYNTAX_set0_policyAuthority(),
       OSSL_IETF_ATTR_SYNTAX_get_value_num(),
       OSSL_IETF_ATTR_SYNTAX_get0_value(),                                  and
       OSSL_IETF_ATTR_SYNTAX_add1_value() were added in OpenSSL 3.4.

COPYRIGHT
       Copyright 2021-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
       <https://www.openssl.org/source/license.html>.

3.5.7                              2026-06-09       OSSL_IETF_ATTR_SYNTAX(3SSL)

Generated by dwww version 1.16 on Sat Oct 3 11:23:34 CEST 2026.