File: gnupg.info,  Node: Dirmngr LOOKUP,  Next: Dirmngr ISVALID,  Up: Dirmngr Protocol

3.6.1 Return the certificate(s) found
-------------------------------------

Lookup certificate.  To allow multiple patterns (which are ORed) quoting
is required: Spaces are to be translated into "+" or into "%20";
obviously this requires that the usual escape quoting rules are applied.
The server responds with:

       S: D 
       S: END
       S: D 
       S: END
       S: OK

   In this example 2 certificates are returned.  The server may return
any number of certificates; OK will also be returned when no
certificates were found.  The dirmngr might return a status line

       S: S TRUNCATED 

   To indicate that the output was truncated to N items due to a
limitation of the server or by an arbitrary set limit.

   The option '--url' may be used if instead of a search pattern a
complete URL to the certificate is known:

       C: LOOKUP --url CN%3DWerner%20Koch,o%3DIntevation%20GmbH,c%3DDE?userCertificate

   If the option '--cache-only' is given, no external lookup is done so
that only certificates from the cache are returned.

   With the option '--single', the first and only the first match will
be returned.  Unless option '--cache-only' is also used, no local lookup
will be done in this case.