From ca0ba0717a956603318d52aabcf0f05121608e90 Mon Sep 17 00:00:00 2001 From: "Dr. David von Oheimb" Date: Mon, 9 Dec 2024 22:07:33 +0100 Subject: [PATCH] X509_STORE_CTX_new.pod: change 'trust value' to 'trust id' --- doc/man3/X509_STORE_CTX_new.pod | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/doc/man3/X509_STORE_CTX_new.pod b/doc/man3/X509_STORE_CTX_new.pod index d12dbfb8037c6a..5038403efe20e6 100644 --- a/doc/man3/X509_STORE_CTX_new.pod +++ b/doc/man3/X509_STORE_CTX_new.pod @@ -166,7 +166,7 @@ return 1 on success or 0 on failure. X509 certificates may contain information about what purposes keys contained within them can be used for. For example "TLS WWW Server Authentication" or -"Email Protection". This "key usage" information is held internally to the +"Email Protection". This extended key usage information is held internally to the certificate itself. In addition the trust store containing trusted certificates can declare what purposes we trust different certificates for. This "trust" information is not held within the certificate itself but is "meta" information @@ -195,18 +195,18 @@ the certificate and its chain are verified to be consistent with that purpose. For SSL client, SSL server, and S/MIME purposes, the EKU is checked also for the CA certificates along the chain, including any given trust anchor certificate. Potentially also further checks are done (depending on the purpose given). -Every purpose also has an associated default trust value, which will also be set +Every purpose also has an associated default trust id, which will also be set at the same time. During verification, this trust setting will be verified to check whether it is consistent with the trust set by the system administrator for certificates in the chain. -X509_STORE_CTX_set_trust() sets the trust value for the target certificate -being verified in the I. Built-in available values for the I +X509_STORE_CTX_set_trust() sets the trust id value for the target certificate +being verified in the I. Built-in available values for the I id argument are B, B, B, B, B, B, B and B. It is -also possible to create a custom trust value. Since X509_STORE_CTX_set_purpose() -also sets the trust value it is normally sufficient to only call that function. +also possible to create a custom trust id. Since X509_STORE_CTX_set_purpose() +also sets the trust id it is normally sufficient to only call that function. If both are called then X509_STORE_CTX_set_trust() should be called after X509_STORE_CTX_set_purpose() since the trust setting of the last call will be used. @@ -214,21 +214,21 @@ used. It should not normally be necessary for end user applications to call X509_STORE_CTX_purpose_inherit() directly. Typically applications should call X509_STORE_CTX_set_purpose() or X509_STORE_CTX_set_trust() instead. Using this -function it is possible to set the purpose and trust values for the I at +function it is possible to set the purpose and trust id values for the I at the same time. Both I and its internal verification parameter pointer must not be NULL. The I and I arguments can have the same purpose values as described for X509_STORE_CTX_set_purpose() above. The I -argument can have the same trust values as described in +argument can have the same trust ids as described in X509_STORE_CTX_set_trust() above. Any of the I, I or I values may also have the value 0 to indicate that the supplied parameter should be ignored. After calling this function the purpose to be used for verification is set from the I argument unless the purpose was already set in I before, and the trust is set from the I argument unless the trust was already set in I before. -If I is 0 then the trust value will be set from -the default trust value for I. If the default trust value for the -purpose is I and I is 0 then the default trust value +If I is 0 then the trust id will be set from +the default trust id for I. If the default trust id for the +purpose is I and I is 0 then the default trust id associated with the I value is used for the trust setting instead. =head1 NOTES