summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/X509_policy_tree_get0_policies.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libcrypto/man/X509_policy_tree_get0_policies.3')
-rw-r--r--src/lib/libcrypto/man/X509_policy_tree_get0_policies.3101
1 files changed, 0 insertions, 101 deletions
diff --git a/src/lib/libcrypto/man/X509_policy_tree_get0_policies.3 b/src/lib/libcrypto/man/X509_policy_tree_get0_policies.3
deleted file mode 100644
index cb0715d6cb..0000000000
--- a/src/lib/libcrypto/man/X509_policy_tree_get0_policies.3
+++ /dev/null
@@ -1,101 +0,0 @@
1.\" $OpenBSD: X509_policy_tree_get0_policies.3,v 1.1 2021/11/11 12:06:25 schwarze 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: November 11 2021 $
18.Dt X509_POLICY_TREE_GET0_POLICIES 3
19.Os
20.Sh NAME
21.Nm X509_policy_tree_get0_policies ,
22.Nm X509_policy_tree_get0_user_policies
23.Nd retrieve arrays of policy tree nodes
24.Sh SYNOPSIS
25.In openssl/x509_vfy.h
26.Ft STACK_OF(X509_POLICY_NODE) *
27.Fn X509_policy_tree_get0_policies "const X509_POLICY_TREE *tree"
28.Ft STACK_OF(X509_POLICY_NODE) *
29.Fn X509_policy_tree_get0_user_policies "const X509_POLICY_TREE *tree"
30.Sh DESCRIPTION
31The
32.Em authority set
33and the
34.Em user set
35are arrays of nodes from a policy
36.Fa tree .
37.Pp
38If the last level of a
39.Fa tree ,
40or equivalently, all levels of it, contain an
41.Sy anyPolicy
42node, the authority set contains
43only this anyPolicy node from the last level.
44Unless the array of
45.Fa policy_oids
46passed to
47.Xr X509_policy_check 3
48contained an anyPolicy object,
49the user set contains one node for each of the
50.Fa policy_oids ;
51specifically, the first matching node that is a child of an anyPolicy node.
52.Pp
53If the last level of the
54.Fa tree
55does not contain an
56.Sy anyPolicy
57node, the authority set contains
58all non-anyPolicy nodes that are children of anyPolicy nodes.
59For each element of the
60.Fa policy_oids ,
61the user set contains the first node from the authority set
62matching it, if any.
63.Pp
64These functions are intended to be called after
65.Xr X509_policy_check 3
66was called either directly or indirectly through
67.Xr X509_verify_cert 3 .
68.Sh RETURN VALUES
69.Fn X509_policy_tree_get0_policies
70returns an internal pointer to the authority set
71or
72.Dv NULL
73if the
74.Fa tree
75argument is
76.Dv NULL .
77.Pp
78.Fn X509_policy_tree_get0_user_policies
79returns an internal pointer to the user set or
80.Dv NULL
81if the
82.Fa tree
83argument is
84.Dv NULL
85or if the array of
86.Fa policy_oids
87passed to
88.Xr X509_policy_check 3
89was empty or contained an anyPolicy object.
90.Sh SEE ALSO
91.Xr STACK_OF 3 ,
92.Xr X509_policy_check 3 ,
93.Xr X509_policy_level_get0_node 3 ,
94.Xr X509_STORE_CTX_get0_policy_tree 3
95.Sh STANDARDS
96RFC 5280: Internet X.509 Public Key Infrastructure Certificate
97and Certificate Revocation List (CRL) Profile,
98section 6.1: Basic Path Validation
99.Sh HISTORY
100These function first appeared in OpenSSL 0.9.8 and have been available since
101.Ox 4.5 .