summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/X509at_add1_attr.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libcrypto/man/X509at_add1_attr.3')
-rw-r--r--src/lib/libcrypto/man/X509at_add1_attr.3133
1 files changed, 0 insertions, 133 deletions
diff --git a/src/lib/libcrypto/man/X509at_add1_attr.3 b/src/lib/libcrypto/man/X509at_add1_attr.3
deleted file mode 100644
index 126b1b41ba..0000000000
--- a/src/lib/libcrypto/man/X509at_add1_attr.3
+++ /dev/null
@@ -1,133 +0,0 @@
1.\" $OpenBSD: X509at_add1_attr.3,v 1.6 2024/08/24 09:15:36 tb Exp $
2.\"
3.\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: August 24 2024 $
18.Dt X509AT_ADD1_ATTR 3
19.Os
20.Sh NAME
21.Nm X509at_add1_attr ,
22.Nm X509at_add1_attr_by_OBJ ,
23.Nm X509at_add1_attr_by_NID ,
24.Nm X509at_add1_attr_by_txt ,
25.Nm X509at_delete_attr
26.Nd change an array of X.501 Attribute objects
27.Sh SYNOPSIS
28.In openssl/x509.h
29.Ft STACK_OF(X509_ATTRIBUTE) *
30.Fo X509at_add1_attr
31.Fa "STACK_OF(X509_ATTRIBUTE) **pattrs"
32.Fa "X509_ATTRIBUTE *attr"
33.Fc
34.Ft STACK_OF(X509_ATTRIBUTE) *
35.Fo X509at_add1_attr_by_OBJ
36.Fa "STACK_OF(X509_ATTRIBUTE) **pattrs"
37.Fa "const ASN1_OBJECT *obj"
38.Fa "int type"
39.Fa "const unsigned char *data"
40.Fa "int len"
41.Fc
42.Ft STACK_OF(X509_ATTRIBUTE) *
43.Fo X509at_add1_attr_by_NID
44.Fa "STACK_OF(X509_ATTRIBUTE) **pattrs"
45.Fa "int nid"
46.Fa "int type"
47.Fa "const unsigned char *data"
48.Fa "int len"
49.Fc
50.Ft STACK_OF(X509_ATTRIBUTE) *
51.Fo X509at_add1_attr_by_txt
52.Fa "STACK_OF(X509_ATTRIBUTE) **pattrs"
53.Fa "const char *name"
54.Fa "int type"
55.Fa "const unsigned char *data"
56.Fa "int len"
57.Fc
58.Ft X509_ATTRIBUTE *
59.Fo X509at_delete_attr
60.Fa "STACK_OF(X509_ATTRIBUTE) *attrs"
61.Fa "int index"
62.Fc
63.Sh DESCRIPTION
64.Fn X509at_add1_attr
65appends a deep copy of
66.Fa attr
67to the end of
68.Pf ** Fa pattrs .
69If
70.Pf * Fa pattrs
71is
72.Dv NULL ,
73a new array is allocated, and in case of success,
74a pointer to it is assigned to
75.Pf * Fa pattrs .
76.Pp
77.Fn X509at_add1_attr_by_OBJ ,
78.Fn X509at_add1_attr_by_NID ,
79and
80.Fn X509at_add1_attr_by_txt
81create a new X.501 Attribute object using
82.Xr X509_ATTRIBUTE_create_by_OBJ 3 ,
83.Xr X509_ATTRIBUTE_create_by_NID 3 ,
84or
85.Xr X509_ATTRIBUTE_create_by_txt 3 ,
86respectively, and append it to
87.Pf ** Fa pattrs
88using
89.Fn X509at_add1_attr .
90.Pp
91.Fn X509at_delete_attr
92deletes the element with the zero-based
93.Fa index
94from the array
95.Pf * Fa attrs .
96.Sh RETURN VALUES
97.Fn X509at_add1_attr ,
98.Fn X509at_add1_attr_by_OBJ ,
99.Fn X509at_add1_attr_by_NID ,
100and
101.Fn X509at_add1_attr_by_txt
102return a pointer to the modified or new array or
103.Dv NULL
104if the
105.Fa pattrs
106argument is
107.Dv NULL
108or if creating or copying the X.501 Attribute object
109or memory allocation fails.
110.Pp
111.Fn X509at_delete_attr
112returns the deleted element or
113.Dv NULL
114if
115.Fa attrs
116is
117.Dv NULL
118or if the requested
119.Fa index
120is negative or greater than or equal to the number of objects in
121.Pf * Fa attrs .
122.Sh SEE ALSO
123.Xr OBJ_nid2obj 3 ,
124.Xr PKCS8_pkey_add1_attr_by_NID 3 ,
125.Xr STACK_OF 3 ,
126.Xr X509_ATTRIBUTE_create_by_OBJ 3 ,
127.Xr X509_ATTRIBUTE_new 3 ,
128.Xr X509_REQ_add1_attr 3 ,
129.Xr X509at_get_attr 3
130.Sh HISTORY
131These functions first appeared in OpenSSL 0.9.5
132and have been available since
133.Ox 2.7 .