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