1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
.\" $OpenBSD: X509_ALGOR_dup.3,v 1.1 2016/12/04 20:51:47 schwarze Exp $
.\" OpenSSL 4692340e Jun 7 15:49:08 2016 -0400
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" Copyright (c) 2002, 2015 The OpenSSL Project. All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\"
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\"
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in
.\" the documentation and/or other materials provided with the
.\" distribution.
.\"
.\" 3. All advertising materials mentioning features or use of this
.\" software must display the following acknowledgment:
.\" "This product includes software developed by the OpenSSL Project
.\" for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
.\"
.\" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
.\" endorse or promote products derived from this software without
.\" prior written permission. For written permission, please contact
.\" openssl-core@openssl.org.
.\"
.\" 5. Products derived from this software may not be called "OpenSSL"
.\" nor may "OpenSSL" appear in their names without prior written
.\" permission of the OpenSSL Project.
.\"
.\" 6. Redistributions of any form whatsoever must retain the following
.\" acknowledgment:
.\" "This product includes software developed by the OpenSSL Project
.\" for use in the OpenSSL Toolkit (http://www.openssl.org/)"
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
.\" EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd $Mdocdate: December 4 2016 $
.Dt X509_ALGOR_DUP 3
.Os
.Sh NAME
.Nm X509_ALGOR_dup ,
.Nm X509_ALGOR_set0 ,
.Nm X509_ALGOR_get0 ,
.Nm X509_ALGOR_set_md ,
.Nm X509_ALGOR_cmp
.Nd AlgorithmIdentifier functions
.Sh SYNOPSIS
.In openssl/x509.h
.Ft X509_ALGOR *
.Fo X509_ALGOR_dup
.Fa "X509_ALGOR *alg"
.Fc
.Ft int
.Fo X509_ALGOR_set0
.Fa "X509_ALGOR *alg"
.Fa "ASN1_OBJECT *aobj"
.Fa "int ptype"
.Fa "void *pval"
.Fc
.Ft void
.Fo X509_ALGOR_get0
.Fa "ASN1_OBJECT **paobj"
.Fa "int *pptype"
.Fa "const void **ppval"
.Fa "const X509_ALGOR *alg"
.Fc
.Ft void
.Fo X509_ALGOR_set_md
.Fa "X509_ALGOR *alg"
.Fa "const EVP_MD *md"
.Fc
.Ft int
.Fo X509_ALGOR_cmp
.Fa "const X509_ALGOR *a"
.Fa "const X509_ALGOR *b"
.Fc
.Sh DESCRIPTION
.Fn X509_ALGOR_dup
returns a copy of
.Fa alg .
.Pp
.Fn X509_ALGOR_set0
sets the algorithm OID of
.Fa alg
to
.Fa aobj
and the associated parameter type to
.Fa ptype
with value
.Fa pval .
If
.Fa ptype
is
.Sy V_ASN1_UNDEF
the parameter is omitted, otherwise
.Fa ptype
and
.Fa pval
have the same meaning as the
.Sy type
and
.Sy value
parameters to
.Xr ASN1_TYPE_set 3 .
All the supplied parameters are used internally so must
.Sy NOT
be freed after this call.
.Pp
.Fn X509_ALGOR_get0
is the inverse of
.Fn X509_ALGOR_set0 :
it returns the algorithm OID in
.Sy *paobj
and the associated parameter in
.Sy *pptype
and
.Sy *ppval
from the
.Sy AlgorithmIdentifier
.Fa alg .
.Pp
.Fn X509_ALGOR_set_md
sets the
.Sy AlgorithmIdentifier
.Fa alg
to appropriate values for the message digest
.Fa md .
.Pp
.Fn X509_ALGOR_cmp
compares
.Fa a
and
.Fa b
and returns 0 if they have identical encodings and non-zero otherwise.
.Sh COPYRIGHT
Copyright 2002-2016 The OpenSSL Project Authors.
All Rights Reserved.
.Pp
Licensed under the OpenSSL license (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
.Lk https://www.openssl.org/source/license.html .
|
