summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/X509_LOOKUP_new.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libcrypto/man/X509_LOOKUP_new.3')
-rw-r--r--src/lib/libcrypto/man/X509_LOOKUP_new.347
1 files changed, 12 insertions, 35 deletions
diff --git a/src/lib/libcrypto/man/X509_LOOKUP_new.3 b/src/lib/libcrypto/man/X509_LOOKUP_new.3
index e4cd68a40a..f368cbb606 100644
--- a/src/lib/libcrypto/man/X509_LOOKUP_new.3
+++ b/src/lib/libcrypto/man/X509_LOOKUP_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: X509_LOOKUP_new.3,v 1.8 2021/11/12 11:41:50 schwarze Exp $ 1.\" $OpenBSD: X509_LOOKUP_new.3,v 1.9 2021/11/12 14:05:28 schwarze Exp $
2.\" 2.\"
3.\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org> 3.\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org>
4.\" 4.\"
@@ -286,16 +286,13 @@ set to
286.Dv NULL . 286.Dv NULL .
287.El 287.El
288.Pp 288.Pp
289With LibreSSL,
289.Fn X509_LOOKUP_ctrl 290.Fn X509_LOOKUP_ctrl
290always ignores the 291always ignores the
291.Fa ret 292.Fa ret
292argument when the built-in 293argument.
293.Vt X509_LOOKUP_METHOD
294objects are used.
295.Pp 294.Pp
296When using built-in 295With LibreSSL,
297.Vt X509_LOOKUP_METHOD
298objects,
299.Fn X509_LOOKUP_by_subject 296.Fn X509_LOOKUP_by_subject
300is only useful if 297is only useful if
301.Fa lookup 298.Fa lookup
@@ -336,9 +333,7 @@ In case of success, the first match is returned in the
336.Pf * Fa object 333.Pf * Fa object
337provided by the caller, overwriting any previous content. 334provided by the caller, overwriting any previous content.
338.Pp 335.Pp
339Unless an application program manually constructs its own 336With LibreSSL,
340.Vt X509_LOOKUP_METHOD
341object containing its own callback functions,
342.Fn X509_LOOKUP_init , 337.Fn X509_LOOKUP_init ,
343.Fn X509_LOOKUP_shutdown , 338.Fn X509_LOOKUP_shutdown ,
344.Fn X509_LOOKUP_by_issuer_serial , 339.Fn X509_LOOKUP_by_issuer_serial ,
@@ -346,15 +341,6 @@ object containing its own callback functions,
346and 341and
347.Fn X509_LOOKUP_by_alias 342.Fn X509_LOOKUP_by_alias
348have no effect. 343have no effect.
349.Fn X509_LOOKUP_init
350is supposed to be called after
351.Fn X509_LOOKUP_new
352and before using the
353.Fa lookup
354object,
355.Fn X509_LOOKUP_shutdown
356after using it and before
357.Fn X509_LOOKUP_free .
358.Sh RETURN VALUES 344.Sh RETURN VALUES
359.Fn X509_LOOKUP_new 345.Fn X509_LOOKUP_new
360returns the new object or 346returns the new object or
@@ -363,11 +349,8 @@ if memory allocation fails.
363.Pp 349.Pp
364.Fn X509_LOOKUP_ctrl 350.Fn X509_LOOKUP_ctrl
365returns 1 for success or 0 for failure. 351returns 1 for success or 0 for failure.
366If 352With library implementations other than LibreSSL,
367.Fa lookup 353it might also return \-1 for internal errors.
368uses a user-defined
369.Vt X509_LOOKUP_METHOD
370object, it might also return \-1 for internal errors.
371.Pp 354.Pp
372.Fn X509_LOOKUP_by_subject 355.Fn X509_LOOKUP_by_subject
373returns 1 for success or 0 for failure. 356returns 1 for success or 0 for failure.
@@ -388,27 +371,21 @@ is neither
388nor 371nor
389.Dv X509_LU_CRL , 372.Dv X509_LU_CRL ,
390if no match is found, or if memory allocation fails. 373if no match is found, or if memory allocation fails.
391If 374With library implementations other than LibreSSL,
392.Fa lookup 375it might also return negative values for internal errors.
393uses a user-defined
394.Vt X509_LOOKUP_METHOD
395object, it might also return negative values for internal errors.
396.Pp 376.Pp
397.Fn X509_LOOKUP_init 377.Fn X509_LOOKUP_init
398and 378and
399.Fn X509_LOOKUP_shutdown 379.Fn X509_LOOKUP_shutdown
400are supposed to return 1 for success and 0 for failure. 380are supposed to return 1 for success and 0 for failure.
401When using the built-in 381With LibreSSL, they always return 1.
402.Vt X509_LOOKUP_METHOD
403objects, they always return 1.
404.Pp 382.Pp
383With LibreSSL,
405.Fn X509_LOOKUP_by_issuer_serial , 384.Fn X509_LOOKUP_by_issuer_serial ,
406.Fn X509_LOOKUP_by_fingerprint , 385.Fn X509_LOOKUP_by_fingerprint ,
407and 386and
408.Fn X509_LOOKUP_by_alias 387.Fn X509_LOOKUP_by_alias
409always return 0 when using the built-in 388always return 0.
410.Vt X509_LOOKUP_METHOD
411objects.
412.Pp 389.Pp
413.Fn X509_get_default_cert_dir 390.Fn X509_get_default_cert_dir
414returns a pointer to the constant string 391returns a pointer to the constant string