OSSL_IETF_ATTR_SYNTAX(3ossl)

📦 version 3.5.0, in opensuse-leap 16.0

✨ OSSL_IETF_ATTR_SYNTAX ✨ (3ossl)

okay so bestie, this is the <openssl/x509_acert.h> girlies' page — welcome to the 3ossl manual, we're talking about OSSL_IETF_ATTR_SYNTAX and all her little accessor besties 💅

🎀 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 — the 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 🦋

okay so OSSL_IETF_ATTR_SYNTAX is an opaque structure — like, you can't peek inside, she's mysterious 💅 — and she represents the IetfAttrSyntax type defined in RFC 5755 (Section 4.4), for use as an AttributeValue. iconic behavior tbh.

OSSL_IETF_ATTR_SYNTAX_get0_policyAuthority() and OSSL_IETF_ATTR_SYNTAX_set0_policyAuthority() get and set the policyAuthority field of the structure. ⚠️ lowkey important: both routines act on internal pointers of the structure and must not be freed by the application — do NOT try to free them yourself bestie, that's not your job, hands off 🙈

An OSSL_IETF_ATTR_SYNTAX object also holds a sequence of values. so:

  • 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. and yes — the caller should free the data after use 🫶

OSSL_IETF_ATTR_SYNTAX_get0_value() will return the value at 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 a 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. slay or flop, no in-between 💀

⭐ 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 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>.

fr fr that's the whole page, no gatekeeping 💖

k that's a wrap bestie, tysm for reading 🫶 this was 3.5.0, dated 2026-09-25, and it's the OSSL_IETF_ATTR_SYNTAX(3ossl) manual page — mwah, go forth and parse those attribute values 💅✨

📦 where this page comes from