diff options
Diffstat (limited to 'upstream/debian-unstable/man3/X509_LOOKUP.3ssl')
| -rw-r--r-- | upstream/debian-unstable/man3/X509_LOOKUP.3ssl | 23 |
1 files changed, 16 insertions, 7 deletions
diff --git a/upstream/debian-unstable/man3/X509_LOOKUP.3ssl b/upstream/debian-unstable/man3/X509_LOOKUP.3ssl index 46d04713..f753603e 100644 --- a/upstream/debian-unstable/man3/X509_LOOKUP.3ssl +++ b/upstream/debian-unstable/man3/X509_LOOKUP.3ssl @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "X509_LOOKUP 3SSL" -.TH X509_LOOKUP 3SSL 2024-02-03 3.1.5 OpenSSL +.TH X509_LOOKUP 3SSL 2024-04-04 3.2.2-dev OpenSSL .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -150,7 +150,8 @@ associates and retrieves a pointer to application data to and from the given \fBX509_LOOKUP\fR, respectively. .PP \&\fBX509_LOOKUP_ctrl_ex()\fR is used to set or get additional data to or from -a \fBX509_LOOKUP\fR structure or its associated \fBX509_LOOKUP_METHOD\fR\|(3). +a \fBX509_LOOKUP\fR structure using any control function in the +associated \fBX509_LOOKUP_METHOD\fR\|(3). The arguments of the control command are passed via \fIargc\fR and \fIargl\fR, its return value via \fI*ret\fR. The library context \fIlibctx\fR and property query \fIpropq\fR are used when fetching algorithms from providers. @@ -244,22 +245,30 @@ or NULL on error. \&\fBX509_LOOKUP_init()\fR and \fBX509_LOOKUP_shutdown()\fR return 1 on success, or 0 on error. .PP -\&\fBX509_LOOKUP_ctrl()\fR returns \-1 if the \fBX509_LOOKUP\fR doesn't have an +\&\fBX509_LOOKUP_ctrl_ex()\fR and \fBX509_LOOKUP_ctrl()\fR +return \-1 if the \fBX509_LOOKUP\fR doesn't have an associated \fBX509_LOOKUP_METHOD\fR, or 1 if the doesn't have a control function. Otherwise, it returns what the control function in the -\&\fBX509_LOOKUP_METHOD\fR returns, which is usually 1 on success and 0 in -error. +\&\fBX509_LOOKUP_METHOD\fR returns, which is usually 1 on success and 0 on error +but could also be \-1 on failure. .IX Xref "509_LOOKUP_METHOD" .PP \&\fBX509_LOOKUP_get_store()\fR returns a \fBX509_STORE\fR pointer if there is one, otherwise NULL. .PP -\&\fBX509_LOOKUP_by_subject_ex()\fR, \fBX509_LOOKUP_by_subject()\fR, +\&\fBX509_LOOKUP_by_subject_ex()\fR returns 0 if there is no \fBX509_LOOKUP_METHOD\fR +that implements any of the \fBget_by_subject_ex()\fR or \fBget_by_subject()\fR functions. +It calls \fBget_by_subject_ex()\fR if present, otherwise \fBget_by_subject()\fR, and returns +the result of the function, which is usually 1 on success and 0 on error. +.PP +\&\fBX509_LOOKUP_by_subject()\fR is similar to \fBX509_LOOKUP_by_subject_ex()\fR +but passes NULL for both the libctx and propq. +.PP \&\fBX509_LOOKUP_by_issuer_serial()\fR, \fBX509_LOOKUP_by_fingerprint()\fR, and \&\fBX509_LOOKUP_by_alias()\fR all return 0 if there is no \fBX509_LOOKUP_METHOD\fR or that method doesn't implement the corresponding function. -Otherwise, it returns what the corresponding function in the +Otherwise, they return what the corresponding function in the \&\fBX509_LOOKUP_METHOD\fR returns, which is usually 1 on success and 0 in error. .SH "SEE ALSO" |