crypto/x509/x509_lu.c

   1 /* crypto/x509/x509_lu.c */
   2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
   3  * All rights reserved.
   4  *
   5  * This package is an SSL implementation written
   6  * by Eric Young (eay@cryptsoft.com).
   7  * The implementation was written so as to conform with Netscapes SSL.
   8  *
   9  * This library is free for commercial and non-commercial use as long as
  10  * the following conditions are aheared to.  The following conditions
  11  * apply to all code found in this distribution, be it the RC4, RSA,
  12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
  13  * included with this distribution is covered by the same copyright terms
  14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
  15  *
  16  * Copyright remains Eric Young's, and as such any Copyright notices in
  17  * the code are not to be removed.
  18  * If this package is used in a product, Eric Young should be given attribution
  19  * as the author of the parts of the library used.
  20  * This can be in the form of a textual message at program startup or
  21  * in documentation (online or textual) provided with the package.
  22  *
  23  * Redistribution and use in source and binary forms, with or without
  24  * modification, are permitted provided that the following conditions
  25  * are met:
  26  * 1. Redistributions of source code must retain the copyright
  27  *    notice, this list of conditions and the following disclaimer.
  28  * 2. Redistributions in binary form must reproduce the above copyright
  29  *    notice, this list of conditions and the following disclaimer in the
  30  *    documentation and/or other materials provided with the distribution.
  31  * 3. All advertising materials mentioning features or use of this software
  32  *    must display the following acknowledgement:
  33  *    "This product includes cryptographic software written by
  34  *     Eric Young (eay@cryptsoft.com)"
  35  *    The word 'cryptographic' can be left out if the rouines from the library
  36  *    being used are not cryptographic related :-).
  37  * 4. If you include any Windows specific code (or a derivative thereof) from
  38  *    the apps directory (application code) you must include an acknowledgement:
  39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
  40  *
  41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
  42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  51  * SUCH DAMAGE.
  52  *
  53  * The licence and distribution terms for any publically available version or
  54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
  55  * copied and put under another distribution licence
  56  * [including the GNU Public Licence.]
  57  */
  58
  59 #include <stdio.h>
  60 #include "cryptlib.h"
  61 #include <openssl/lhash.h>
  62 #include <openssl/x509.h>
  63 #include <openssl/x509v3.h>
  64 #include "x509_lcl.h"
  65
  66 X509_LOOKUP *X509_LOOKUP_new(X509_LOOKUP_METHOD *method)
  67 {
  68     X509_LOOKUP *ret;
  69
  70     ret = OPENSSL_malloc(sizeof(*ret));
  71     if (ret == NULL)
  72         return NULL;
  73
  74     ret->init = 0;
  75     ret->skip = 0;
  76     ret->method = method;
  77     ret->method_data = NULL;
  78     ret->store_ctx = NULL;
  79     if ((method->new_item != NULL) && !method->new_item(ret)) {
  80         OPENSSL_free(ret);
  81         return NULL;
  82     }
  83     return ret;
  84 }
  85
  86 void X509_LOOKUP_free(X509_LOOKUP *ctx)
  87 {
  88     if (ctx == NULL)
  89         return;
  90     if ((ctx->method != NULL) && (ctx->method->free != NULL))
  91         (*ctx->method->free) (ctx);
  92     OPENSSL_free(ctx);
  93 }
  94
  95 int X509_LOOKUP_init(X509_LOOKUP *ctx)
  96 {
  97     if (ctx->method == NULL)
  98         return 0;
  99     if (ctx->method->init != NULL)
 100         return ctx->method->init(ctx);
 101     else
 102         return 1;
 103 }
 104
 105 int X509_LOOKUP_shutdown(X509_LOOKUP *ctx)
 106 {
 107     if (ctx->method == NULL)
 108         return 0;
 109     if (ctx->method->shutdown != NULL)
 110         return ctx->method->shutdown(ctx);
 111     else
 112         return 1;
 113 }
 114
 115 int X509_LOOKUP_ctrl(X509_LOOKUP *ctx, int cmd, const char *argc, long argl,
 116                      char **ret)
 117 {
 118     if (ctx->method == NULL)
 119         return -1;
 120     if (ctx->method->ctrl != NULL)
 121         return ctx->method->ctrl(ctx, cmd, argc, argl, ret);
 122     else
 123         return 1;
 124 }
 125
 126 int X509_LOOKUP_by_subject(X509_LOOKUP *ctx, int type, X509_NAME *name,
 127                            X509_OBJECT *ret)
 128 {
 129     if ((ctx->method == NULL) || (ctx->method->get_by_subject == NULL))
 130         return X509_LU_FAIL;
 131     if (ctx->skip)
 132         return 0;
 133     return ctx->method->get_by_subject(ctx, type, name, ret);
 134 }
 135
 136 int X509_LOOKUP_by_issuer_serial(X509_LOOKUP *ctx, int type, X509_NAME *name,
 137                                  ASN1_INTEGER *serial, X509_OBJECT *ret)
 138 {
 139     if ((ctx->method == NULL) || (ctx->method->get_by_issuer_serial == NULL))
 140         return X509_LU_FAIL;
 141     return ctx->method->get_by_issuer_serial(ctx, type, name, serial, ret);
 142 }
 143
 144 int X509_LOOKUP_by_fingerprint(X509_LOOKUP *ctx, int type,
 145                                unsigned char *bytes, int len,
 146                                X509_OBJECT *ret)
 147 {
 148     if ((ctx->method == NULL) || (ctx->method->get_by_fingerprint == NULL))
 149         return X509_LU_FAIL;
 150     return ctx->method->get_by_fingerprint(ctx, type, bytes, len, ret);
 151 }
 152
 153 int X509_LOOKUP_by_alias(X509_LOOKUP *ctx, int type, char *str, int len,
 154                          X509_OBJECT *ret)
 155 {
 156     if ((ctx->method == NULL) || (ctx->method->get_by_alias == NULL))
 157         return X509_LU_FAIL;
 158     return ctx->method->get_by_alias(ctx, type, str, len, ret);
 159 }
 160
 161 static int x509_object_cmp(const X509_OBJECT *const *a,
 162                            const X509_OBJECT *const *b)
 163 {
 164     int ret;
 165
 166     ret = ((*a)->type - (*b)->type);
 167     if (ret)
 168         return ret;
 169     switch ((*a)->type) {
 170     case X509_LU_X509:
 171         ret = X509_subject_name_cmp((*a)->data.x509, (*b)->data.x509);
 172         break;
 173     case X509_LU_CRL:
 174         ret = X509_CRL_cmp((*a)->data.crl, (*b)->data.crl);
 175         break;
 176     default:
 177         /* abort(); */
 178         return 0;
 179     }
 180     return ret;
 181 }
 182
 183 X509_STORE *X509_STORE_new(void)
 184 {
 185     X509_STORE *ret;
 186
 187     if ((ret = OPENSSL_malloc(sizeof(*ret))) == NULL)
 188         return NULL;
 189     ret->objs = sk_X509_OBJECT_new(x509_object_cmp);
 190     ret->cache = 1;
 191     ret->get_cert_methods = sk_X509_LOOKUP_new_null();
 192     ret->verify = 0;
 193     ret->verify_cb = 0;
 194
 195     if ((ret->param = X509_VERIFY_PARAM_new()) == NULL)
 196         return NULL;
 197
 198     ret->get_issuer = 0;
 199     ret->check_issued = 0;
 200     ret->check_revocation = 0;
 201     ret->get_crl = 0;
 202     ret->check_crl = 0;
 203     ret->cert_crl = 0;
 204     ret->lookup_certs = 0;
 205     ret->lookup_crls = 0;
 206     ret->cleanup = 0;
 207
 208     if (!CRYPTO_new_ex_data(CRYPTO_EX_INDEX_X509_STORE, ret, &ret->ex_data)) {
 209         sk_X509_OBJECT_free(ret->objs);
 210         OPENSSL_free(ret);
 211         return NULL;
 212     }
 213
 214     ret->references = 1;
 215     return ret;
 216 }
 217
 218 static void cleanup(X509_OBJECT *a)
 219 {
 220     if (!a)
 221         return;
 222     if (a->type == X509_LU_X509) {
 223         X509_free(a->data.x509);
 224     } else if (a->type == X509_LU_CRL) {
 225         X509_CRL_free(a->data.crl);
 226     } else {
 227         /* abort(); */
 228     }
 229
 230     OPENSSL_free(a);
 231 }
 232
 233 void X509_STORE_free(X509_STORE *vfy)
 234 {
 235     int i;
 236     STACK_OF(X509_LOOKUP) *sk;
 237     X509_LOOKUP *lu;
 238
 239     if (vfy == NULL)
 240         return;
 241
 242     i = CRYPTO_add(&vfy->references, -1, CRYPTO_LOCK_X509_STORE);
 243 #ifdef REF_PRINT
 244     REF_PRINT("X509_STORE", vfy);
 245 #endif
 246     if (i > 0)
 247         return;
 248 #ifdef REF_CHECK
 249     if (i < 0) {
 250         fprintf(stderr, "X509_STORE_free, bad reference count\n");
 251         abort();                /* ok */
 252     }
 253 #endif
 254
 255     sk = vfy->get_cert_methods;
 256     for (i = 0; i < sk_X509_LOOKUP_num(sk); i++) {
 257         lu = sk_X509_LOOKUP_value(sk, i);
 258         X509_LOOKUP_shutdown(lu);
 259         X509_LOOKUP_free(lu);
 260     }
 261     sk_X509_LOOKUP_free(sk);
 262     sk_X509_OBJECT_pop_free(vfy->objs, cleanup);
 263
 264     CRYPTO_free_ex_data(CRYPTO_EX_INDEX_X509_STORE, vfy, &vfy->ex_data);
 265     X509_VERIFY_PARAM_free(vfy->param);
 266     OPENSSL_free(vfy);
 267 }
 268
 269 X509_LOOKUP *X509_STORE_add_lookup(X509_STORE *v, X509_LOOKUP_METHOD *m)
 270 {
 271     int i;
 272     STACK_OF(X509_LOOKUP) *sk;
 273     X509_LOOKUP *lu;
 274
 275     sk = v->get_cert_methods;
 276     for (i = 0; i < sk_X509_LOOKUP_num(sk); i++) {
 277         lu = sk_X509_LOOKUP_value(sk, i);
 278         if (m == lu->method) {
 279             return lu;
 280         }
 281     }
 282     /* a new one */
 283     lu = X509_LOOKUP_new(m);
 284     if (lu == NULL)
 285         return NULL;
 286     else {
 287         lu->store_ctx = v;
 288         if (sk_X509_LOOKUP_push(v->get_cert_methods, lu))
 289             return lu;
 290         else {
 291             X509_LOOKUP_free(lu);
 292             return NULL;
 293         }
 294     }
 295 }
 296
 297 int X509_STORE_get_by_subject(X509_STORE_CTX *vs, int type, X509_NAME *name,
 298                               X509_OBJECT *ret)
 299 {
 300     X509_STORE *ctx = vs->ctx;
 301     X509_LOOKUP *lu;
 302     X509_OBJECT stmp, *tmp;
 303     int i, j;
 304
 305     CRYPTO_w_lock(CRYPTO_LOCK_X509_STORE);
 306     tmp = X509_OBJECT_retrieve_by_subject(ctx->objs, type, name);
 307     CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 308
 309     if (tmp == NULL || type == X509_LU_CRL) {
 310         for (i = vs->current_method;
 311              i < sk_X509_LOOKUP_num(ctx->get_cert_methods); i++) {
 312             lu = sk_X509_LOOKUP_value(ctx->get_cert_methods, i);
 313             j = X509_LOOKUP_by_subject(lu, type, name, &stmp);
 314             if (j < 0) {
 315                 vs->current_method = j;
 316                 return j;
 317             } else if (j) {
 318                 tmp = &stmp;
 319                 break;
 320             }
 321         }
 322         vs->current_method = 0;
 323         if (tmp == NULL)
 324             return 0;
 325     }
 326
 327 /*- if (ret->data.ptr != NULL)
 328             X509_OBJECT_free_contents(ret); */
 329
 330     ret->type = tmp->type;
 331     ret->data.ptr = tmp->data.ptr;
 332
 333     X509_OBJECT_up_ref_count(ret);
 334
 335     return 1;
 336 }
 337
 338 int X509_STORE_add_cert(X509_STORE *ctx, X509 *x)
 339 {
 340     X509_OBJECT *obj;
 341     int ret = 1;
 342
 343     if (x == NULL)
 344         return 0;
 345     obj = OPENSSL_malloc(sizeof(*obj));
 346     if (obj == NULL) {
 347         X509err(X509_F_X509_STORE_ADD_CERT, ERR_R_MALLOC_FAILURE);
 348         return 0;
 349     }
 350     obj->type = X509_LU_X509;
 351     obj->data.x509 = x;
 352
 353     CRYPTO_w_lock(CRYPTO_LOCK_X509_STORE);
 354
 355     X509_OBJECT_up_ref_count(obj);
 356
 357     if (X509_OBJECT_retrieve_match(ctx->objs, obj)) {
 358         X509_OBJECT_free_contents(obj);
 359         OPENSSL_free(obj);
 360         X509err(X509_F_X509_STORE_ADD_CERT,
 361                 X509_R_CERT_ALREADY_IN_HASH_TABLE);
 362         ret = 0;
 363     } else
 364         sk_X509_OBJECT_push(ctx->objs, obj);
 365
 366     CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 367
 368     return ret;
 369 }
 370
 371 int X509_STORE_add_crl(X509_STORE *ctx, X509_CRL *x)
 372 {
 373     X509_OBJECT *obj;
 374     int ret = 1;
 375
 376     if (x == NULL)
 377         return 0;
 378     obj = OPENSSL_malloc(sizeof(*obj));
 379     if (obj == NULL) {
 380         X509err(X509_F_X509_STORE_ADD_CRL, ERR_R_MALLOC_FAILURE);
 381         return 0;
 382     }
 383     obj->type = X509_LU_CRL;
 384     obj->data.crl = x;
 385
 386     CRYPTO_w_lock(CRYPTO_LOCK_X509_STORE);
 387
 388     X509_OBJECT_up_ref_count(obj);
 389
 390     if (X509_OBJECT_retrieve_match(ctx->objs, obj)) {
 391         X509_OBJECT_free_contents(obj);
 392         OPENSSL_free(obj);
 393         X509err(X509_F_X509_STORE_ADD_CRL, X509_R_CERT_ALREADY_IN_HASH_TABLE);
 394         ret = 0;
 395     } else
 396         sk_X509_OBJECT_push(ctx->objs, obj);
 397
 398     CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 399
 400     return ret;
 401 }
 402
 403 void X509_OBJECT_up_ref_count(X509_OBJECT *a)
 404 {
 405     switch (a->type) {
 406     case X509_LU_X509:
 407         CRYPTO_add(&a->data.x509->references, 1, CRYPTO_LOCK_X509);
 408         break;
 409     case X509_LU_CRL:
 410         CRYPTO_add(&a->data.crl->references, 1, CRYPTO_LOCK_X509_CRL);
 411         break;
 412     }
 413 }
 414
 415 void X509_OBJECT_free_contents(X509_OBJECT *a)
 416 {
 417     if (!a)
 418         return;
 419     switch (a->type) {
 420     case X509_LU_X509:
 421         X509_free(a->data.x509);
 422         break;
 423     case X509_LU_CRL:
 424         X509_CRL_free(a->data.crl);
 425         break;
 426     }
 427 }
 428
 429 static int x509_object_idx_cnt(STACK_OF(X509_OBJECT) *h, int type,
 430                                X509_NAME *name, int *pnmatch)
 431 {
 432     X509_OBJECT stmp;
 433     X509 x509_s;
 434     X509_CINF cinf_s;
 435     X509_CRL crl_s;
 436     X509_CRL_INFO crl_info_s;
 437     int idx;
 438
 439     stmp.type = type;
 440     switch (type) {
 441     case X509_LU_X509:
 442         stmp.data.x509 = &x509_s;
 443         x509_s.cert_info = &cinf_s;
 444         cinf_s.subject = name;
 445         break;
 446     case X509_LU_CRL:
 447         stmp.data.crl = &crl_s;
 448         crl_s.crl = &crl_info_s;
 449         crl_info_s.issuer = name;
 450         break;
 451     default:
 452         /* abort(); */
 453         return -1;
 454     }
 455
 456     idx = sk_X509_OBJECT_find(h, &stmp);
 457     if (idx >= 0 && pnmatch) {
 458         int tidx;
 459         const X509_OBJECT *tobj, *pstmp;
 460         *pnmatch = 1;
 461         pstmp = &stmp;
 462         for (tidx = idx + 1; tidx < sk_X509_OBJECT_num(h); tidx++) {
 463             tobj = sk_X509_OBJECT_value(h, tidx);
 464             if (x509_object_cmp(&tobj, &pstmp))
 465                 break;
 466             (*pnmatch)++;
 467         }
 468     }
 469     return idx;
 470 }
 471
 472 int X509_OBJECT_idx_by_subject(STACK_OF(X509_OBJECT) *h, int type,
 473                                X509_NAME *name)
 474 {
 475     return x509_object_idx_cnt(h, type, name, NULL);
 476 }
 477
 478 X509_OBJECT *X509_OBJECT_retrieve_by_subject(STACK_OF(X509_OBJECT) *h,
 479                                              int type, X509_NAME *name)
 480 {
 481     int idx;
 482     idx = X509_OBJECT_idx_by_subject(h, type, name);
 483     if (idx == -1)
 484         return NULL;
 485     return sk_X509_OBJECT_value(h, idx);
 486 }
 487
 488 STACK_OF(X509) *X509_STORE_get1_certs(X509_STORE_CTX *ctx, X509_NAME *nm)
 489 {
 490     int i, idx, cnt;
 491     STACK_OF(X509) *sk;
 492     X509 *x;
 493     X509_OBJECT *obj;
 494     sk = sk_X509_new_null();
 495     CRYPTO_w_lock(CRYPTO_LOCK_X509_STORE);
 496     idx = x509_object_idx_cnt(ctx->ctx->objs, X509_LU_X509, nm, &cnt);
 497     if (idx < 0) {
 498         /*
 499          * Nothing found in cache: do lookup to possibly add new objects to
 500          * cache
 501          */
 502         X509_OBJECT xobj;
 503         CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 504         if (!X509_STORE_get_by_subject(ctx, X509_LU_X509, nm, &xobj)) {
 505             sk_X509_free(sk);
 506             return NULL;
 507         }
 508         X509_OBJECT_free_contents(&xobj);
 509         CRYPTO_w_lock(CRYPTO_LOCK_X509_STORE);
 510         idx = x509_object_idx_cnt(ctx->ctx->objs, X509_LU_X509, nm, &cnt);
 511         if (idx < 0) {
 512             CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 513             sk_X509_free(sk);
 514             return NULL;
 515         }
 516     }
 517     for (i = 0; i < cnt; i++, idx++) {
 518         obj = sk_X509_OBJECT_value(ctx->ctx->objs, idx);
 519         x = obj->data.x509;
 520         CRYPTO_add(&x->references, 1, CRYPTO_LOCK_X509);
 521         if (!sk_X509_push(sk, x)) {
 522             CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 523             X509_free(x);
 524             sk_X509_pop_free(sk, X509_free);
 525             return NULL;
 526         }
 527     }
 528     CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 529     return sk;
 530
 531 }
 532
 533 STACK_OF(X509_CRL) *X509_STORE_get1_crls(X509_STORE_CTX *ctx, X509_NAME *nm)
 534 {
 535     int i, idx, cnt;
 536     STACK_OF(X509_CRL) *sk;
 537     X509_CRL *x;
 538     X509_OBJECT *obj, xobj;
 539     sk = sk_X509_CRL_new_null();
 540     CRYPTO_w_lock(CRYPTO_LOCK_X509_STORE);
 541     /* Check cache first */
 542     idx = x509_object_idx_cnt(ctx->ctx->objs, X509_LU_CRL, nm, &cnt);
 543
 544     /*
 545      * Always do lookup to possibly add new CRLs to cache
 546      */
 547     CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 548     if (!X509_STORE_get_by_subject(ctx, X509_LU_CRL, nm, &xobj)) {
 549         sk_X509_CRL_free(sk);
 550         return NULL;
 551     }
 552     X509_OBJECT_free_contents(&xobj);
 553     CRYPTO_w_lock(CRYPTO_LOCK_X509_STORE);
 554     idx = x509_object_idx_cnt(ctx->ctx->objs, X509_LU_CRL, nm, &cnt);
 555     if (idx < 0) {
 556         CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 557         sk_X509_CRL_free(sk);
 558         return NULL;
 559     }
 560
 561     for (i = 0; i < cnt; i++, idx++) {
 562         obj = sk_X509_OBJECT_value(ctx->ctx->objs, idx);
 563         x = obj->data.crl;
 564         CRYPTO_add(&x->references, 1, CRYPTO_LOCK_X509_CRL);
 565         if (!sk_X509_CRL_push(sk, x)) {
 566             CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 567             X509_CRL_free(x);
 568             sk_X509_CRL_pop_free(sk, X509_CRL_free);
 569             return NULL;
 570         }
 571     }
 572     CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 573     return sk;
 574 }
 575
 576 X509_OBJECT *X509_OBJECT_retrieve_match(STACK_OF(X509_OBJECT) *h,
 577                                         X509_OBJECT *x)
 578 {
 579     int idx, i;
 580     X509_OBJECT *obj;
 581     idx = sk_X509_OBJECT_find(h, x);
 582     if (idx == -1)
 583         return NULL;
 584     if ((x->type != X509_LU_X509) && (x->type != X509_LU_CRL))
 585         return sk_X509_OBJECT_value(h, idx);
 586     for (i = idx; i < sk_X509_OBJECT_num(h); i++) {
 587         obj = sk_X509_OBJECT_value(h, i);
 588         if (x509_object_cmp
 589             ((const X509_OBJECT **)&obj, (const X509_OBJECT **)&x))
 590             return NULL;
 591         if (x->type == X509_LU_X509) {
 592             if (!X509_cmp(obj->data.x509, x->data.x509))
 593                 return obj;
 594         } else if (x->type == X509_LU_CRL) {
 595             if (!X509_CRL_match(obj->data.crl, x->data.crl))
 596                 return obj;
 597         } else
 598             return obj;
 599     }
 600     return NULL;
 601 }
 602
 603 /*-
 604  * Try to get issuer certificate from store. Due to limitations
 605  * of the API this can only retrieve a single certificate matching
 606  * a given subject name. However it will fill the cache with all
 607  * matching certificates, so we can examine the cache for all
 608  * matches.
 609  *
 610  * Return values are:
 611  *  1 lookup successful.
 612  *  0 certificate not found.
 613  * -1 some other error.
 614  */
 615 int X509_STORE_CTX_get1_issuer(X509 **issuer, X509_STORE_CTX *ctx, X509 *x)
 616 {
 617     X509_NAME *xn;
 618     X509_OBJECT obj, *pobj;
 619     int i, ok, idx, ret;
 620     *issuer = NULL;
 621     xn = X509_get_issuer_name(x);
 622     ok = X509_STORE_get_by_subject(ctx, X509_LU_X509, xn, &obj);
 623     if (ok != X509_LU_X509) {
 624         if (ok == X509_LU_RETRY) {
 625             X509_OBJECT_free_contents(&obj);
 626             X509err(X509_F_X509_STORE_CTX_GET1_ISSUER, X509_R_SHOULD_RETRY);
 627             return -1;
 628         } else if (ok != X509_LU_FAIL) {
 629             X509_OBJECT_free_contents(&obj);
 630             /* not good :-(, break anyway */
 631             return -1;
 632         }
 633         return 0;
 634     }
 635     /* If certificate matches all OK */
 636     if (ctx->check_issued(ctx, x, obj.data.x509)) {
 637         if (x509_check_cert_time(ctx, obj.data.x509, 1)) {
 638             *issuer = obj.data.x509;
 639             return 1;
 640         }
 641     }
 642     X509_OBJECT_free_contents(&obj);
 643
 644     /* Else find index of first cert accepted by 'check_issued' */
 645     ret = 0;
 646     CRYPTO_w_lock(CRYPTO_LOCK_X509_STORE);
 647     idx = X509_OBJECT_idx_by_subject(ctx->ctx->objs, X509_LU_X509, xn);
 648     if (idx != -1) {            /* should be true as we've had at least one
 649                                  * match */
 650         /* Look through all matching certs for suitable issuer */
 651         for (i = idx; i < sk_X509_OBJECT_num(ctx->ctx->objs); i++) {
 652             pobj = sk_X509_OBJECT_value(ctx->ctx->objs, i);
 653             /* See if we've run past the matches */
 654             if (pobj->type != X509_LU_X509)
 655                 break;
 656             if (X509_NAME_cmp(xn, X509_get_subject_name(pobj->data.x509)))
 657                 break;
 658             if (ctx->check_issued(ctx, x, pobj->data.x509)) {
 659                 *issuer = pobj->data.x509;
 660                 ret = 1;
 661                 /*
 662                  * If times check, exit with match,
 663                  * otherwise keep looking. Leave last
 664                  * match in issuer so we return nearest
 665                  * match if no certificate time is OK.
 666                  */
 667
 668                 if (x509_check_cert_time(ctx, *issuer, 1))
 669                     break;
 670             }
 671         }
 672     }
 673     CRYPTO_w_unlock(CRYPTO_LOCK_X509_STORE);
 674     if (*issuer)
 675         CRYPTO_add(&(*issuer)->references, 1, CRYPTO_LOCK_X509);
 676     return ret;
 677 }
 678
 679 int X509_STORE_set_flags(X509_STORE *ctx, unsigned long flags)
 680 {
 681     return X509_VERIFY_PARAM_set_flags(ctx->param, flags);
 682 }
 683
 684 int X509_STORE_set_depth(X509_STORE *ctx, int depth)
 685 {
 686     X509_VERIFY_PARAM_set_depth(ctx->param, depth);
 687     return 1;
 688 }
 689
 690 int X509_STORE_set_purpose(X509_STORE *ctx, int purpose)
 691 {
 692     return X509_VERIFY_PARAM_set_purpose(ctx->param, purpose);
 693 }
 694
 695 int X509_STORE_set_trust(X509_STORE *ctx, int trust)
 696 {
 697     return X509_VERIFY_PARAM_set_trust(ctx->param, trust);
 698 }
 699
 700 int X509_STORE_set1_param(X509_STORE *ctx, X509_VERIFY_PARAM *param)
 701 {
 702     return X509_VERIFY_PARAM_set1(ctx->param, param);
 703 }
 704
 705 void X509_STORE_set_verify_cb(X509_STORE *ctx,
 706                               int (*verify_cb) (int, X509_STORE_CTX *))
 707 {
 708     ctx->verify_cb = verify_cb;
 709 }
 710
 711 void X509_STORE_set_lookup_crls_cb(X509_STORE *ctx,
 712                                    STACK_OF(X509_CRL) *(*cb) (X509_STORE_CTX
 713                                                               *ctx,
 714                                                               X509_NAME *nm))
 715 {
 716     ctx->lookup_crls = cb;
 717 }
 718
 719 X509_STORE *X509_STORE_CTX_get0_store(X509_STORE_CTX *ctx)
 720 {
 721     return ctx->ctx;
 722 }