From 36d22d82aa202bb199967e9512281e9a53db42c9 Mon Sep 17 00:00:00 2001
From: Daniel Baumann <daniel.baumann@progress-linux.org>
Date: Sun, 7 Apr 2024 21:33:14 +0200
Subject: Adding upstream version 115.7.0esr.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
---
 .../rst/legacy/cert_findcertbydercert/index.rst    | 64 ++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 security/nss/doc/rst/legacy/cert_findcertbydercert/index.rst

(limited to 'security/nss/doc/rst/legacy/cert_findcertbydercert/index.rst')

diff --git a/security/nss/doc/rst/legacy/cert_findcertbydercert/index.rst b/security/nss/doc/rst/legacy/cert_findcertbydercert/index.rst
new file mode 100644
index 0000000000..7e297a2df5
--- /dev/null
+++ b/security/nss/doc/rst/legacy/cert_findcertbydercert/index.rst
@@ -0,0 +1,64 @@
+.. _mozilla_projects_nss_cert_findcertbydercert:
+
+CERT_FindCertByDERCert
+======================
+
+.. container::
+
+   Find a certificate in the database that matches a DER-encoded certificate.
+
+`Syntax <#syntax>`__
+~~~~~~~~~~~~~~~~~~~~
+
+.. container::
+
+   .. code::
+
+      #include <cert.h>
+      CERTCertificate *CERT_FindCertByDERCert(
+
+          CERTCertDBHandle *handle,
+          SECItem          *derCert          );
+
+`Parameters <#parameters>`__
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. container::
+
+   +-------------+-----------------------------------------------------------------------------------+
+   | ``handle``  | *in* pointer to a `CERTCertDBHandle </en-US/NSS/CERTCertDBHandle>`__ representing |
+   |             | the certificate database to look in                                               |
+   +-------------+-----------------------------------------------------------------------------------+
+   | ``derCert`` | *in* pointer to an `SECItem </en-US/NSS/SECItem>`__ whose ``type`` must be        |
+   |             | ``siDERCertBuffer`` and whose ``data`` contains a DER-encoded certificate         |
+   +-------------+-----------------------------------------------------------------------------------+
+
+`Description <#description>`__
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. container::
+
+   This function looks in the ?NSSCryptoContext? and the ?NSSTrustDomain? to find the certificate
+   that matches the DER-encoded certificate. A match is found when the issuer and serial number of
+   the DER-encoded certificate are found on a certificate in the certificate database.
+
+`Returns <#returns>`__
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. container::
+
+   A pointer to a `CERTCertificate </en-US/NSS/CERTCertificate>`__ representing the certificate in
+   the database that matched the ``derCert``, or ``NULL`` if none was found. The certificate is a
+   shallow copy, use `CERT_DestroyCertificate </en-US/NSS/CERT_DestroyCertificate>`__ to decrement
+   the reference count on the certificate instance.
+
+.. _see_also:
+
+`See Also <#see_also>`__
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. container::
+
+   Occurrences of
+   ```CERT_FindCertByDERCert`` <http://lxr.mozilla.org/security/ident?i=CERT_FindCertByDERCert>`__
+   in the current NSS source code (generated by `LXR <http://lxr.mozilla.org/security/>`__).
\ No newline at end of file
-- 
cgit v1.2.3