libcrypto/man/X509_ACERT_add1_attr.3

 $NetBSD: X509_ACERT_add1_attr.3,v 1.5 2026/04/08 17:06:49 christos Exp $

 -*- mode: troff; coding: utf-8 -*-
 Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)

 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

 Required to disable full justification in groff 1.23.0.
 ========================================================================

 Title "X509_ACERT_add1_attr 3"  X509_ACERT_add1_attr 3 2026-04-07 3.5.6 OpenSSL
 For nroff, turn off justification. Always turn off hyphenation; it makes
 way too many mistakes in technical documents.
.nh
 NAME
X509_ACERT_add1_attr,
X509_ACERT_add1_attr_by_NID,
X509_ACERT_add1_attr_by_OBJ,
X509_ACERT_add1_attr_by_txt,
X509_ACERT_delete_attr
\- X509_ACERT attribute functions
 SYNOPSIS
 Header "SYNOPSIS" .Vb 1
 #include <openssl/x509_acert.h>
\&
 int X509_ACERT_add1_attr(X509_ACERT *x, X509_ATTRIBUTE *attr);
 int X509_ACERT_add1_attr_by_NID(X509_ACERT *x, int nid, int type,
  const void *bytes, int len);
 int X509_ACERT_add1_attr_by_OBJ(X509_ACERT *x, const ASN1_OBJECT *obj,
  int type, const void *bytes, int len);
 int X509_ACERT_add1_attr_by_txt(X509_ACERT *x, const char *attrname, int type,
  const unsigned char *bytes, int len);
 X509_ATTRIBUTE *X509_ACERT_delete_attr(X509_ACERT *x, int loc);
.Ve
 DESCRIPTION
 Header "DESCRIPTION" \fBX509_ACERT_add1_attr() adds a constructed X509_ATTRIBUTE attr to the
existing X509_ACERT structure x.

\fBX509_ACERT_add1_attr_by_NID() and X509_ACERT_add1_attr_by_OBJ()
add an attribute of type nid or obj with a value of ASN1
type type constructed using len bytes from bytes.

\fBX509_ACERT_add1_attr_by_txt() adds an attribute of type attrname with a value of
ASN1 type type constructed using len bytes from bytes.

\fBX509_ACERT_delete_attr() will delete the locth attribute from x and
return a pointer to it or NULL if there are fewer than loc attributes
contained in x.
 "RETURN VALUES"
 Header "RETURN VALUES" \fBX509_ACERT_add1_attr(), X509_ACERT_add1_attr_by_NID(), and
\fBX509_ACERT_add1_attr_by_OBJ() return 1 for success and 0 for failure.

\fBX509_ACERT_delete_attr() returns a X509_ATTRIBUTE pointer on
success or NULL on failure.
 "SEE ALSO"
 Header "SEE ALSO" \fBX509_ACERT_get_attr_count\|(3)
 HISTORY
 Header "HISTORY" \fBX509_ACERT_add1_attr(), X509_ACERT_add1_attr_by_NID(), X509_ACERT_add1_attr_by_OBJ(),
\fBX509_ACERT_add1_attr_by_txt() and X509_ACERT_delete_attr() were added in OpenSSL 3.4.
 COPYRIGHT
 Header "COPYRIGHT" Copyright 2023-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>.