X509_ACERT_add1_attr.3ossl - Man Page

X509_ACERT attribute functions

Synopsis

 #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);

Description

X509_ACERT_add1_attr() adds a constructed X509_ATTRIBUTE attr to the existing X509_ACERT structure x.

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

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

X509_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

X509_ACERT_add1_attr(), X509_ACERT_add1_attr_by_NID(), and X509_ACERT_add1_attr_by_OBJ() return 1 for success and 0 for failure.

X509_ACERT_delete_attr() returns a X509_ATTRIBUTE pointer on success or NULL on failure.

See Also

X509_ACERT_get_attr_count(3)

History

X509_ACERT_add1_attr(), X509_ACERT_add1_attr_by_NID(), X509_ACERT_add1_attr_by_OBJ(), X509_ACERT_add1_attr_by_txt() and X509_ACERT_delete_attr() were added in OpenSSL 3.4.

Referenced By

The man pages X509_ACERT_add1_attr_by_NID.3ossl(3), X509_ACERT_add1_attr_by_OBJ.3ossl(3), X509_ACERT_add1_attr_by_txt.3ossl(3) and X509_ACERT_delete_attr.3ossl(3) are aliases of X509_ACERT_add1_attr.3ossl(3).

2025-03-26 3.5.0-beta1 OpenSSL