~ubuntu-branches/ubuntu/maverick/nss/maverick

« back to all changes in this revision

Viewing changes to mozilla/security/nss/lib/libpkix/include/pkix_certstore.h

  • Committer: Bazaar Package Importer
  • Author(s): Alexander Sack
  • Date: 2009-06-16 13:23:47 UTC
  • mfrom: (1.1.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20090616132347-311ysb8oep74b98y
Tags: 3.12.3-0ubuntu1
* new upstream release 3.12.3 RTM (NSS_3_12_3_RTM) (LP: #387751)
* adjust patches to changed upstream code base
  - update debian/patches/38_kbsd.patch
* needs nspr >= 4.7.4
  - update debian/control
* update 85_security_load.patch to latest debian version
  - update debian/patches/85_security_load.patch
* add new symbols for 3.12.3
  - update debian/libnss3-1d.symbols

Show diffs side-by-side

added added

removed removed

Lines of Context:
39
39
 *
40
40
 */
41
41
 
42
 
 
43
42
#ifndef _PKIX_CERTSTORE_H
44
43
#define _PKIX_CERTSTORE_H
45
44
 
276
275
        void *plContext);
277
276
 
278
277
/*
 
278
 * FUNCTION: PKIX_CertStore_ImportCrlCallback
 
279
 * DESCRIPTION:
 
280
 *
 
281
 * The function imports crl list into a cert store. Stores that
 
282
 * have local cache may only have that function defined.
 
283
 *
 
284
 * PARAMETERS:
 
285
 *  "store"
 
286
 *      Address of CertStore from which CRLs are to be retrieved.
 
287
 *      Must be non-NULL.
 
288
 *  "crlList"
 
289
 *      Address on the importing crl list.
 
290
 *  "plContext"
 
291
 *      Platform-specific context pointer.
 
292
 * THREAD SAFETY:
 
293
 *  Thread Safe
 
294
 *
 
295
 *  Multiple threads must be able to safely call this function without
 
296
 *  worrying about conflicts, even if they're operating on the same object.
 
297
 * RETURNS:
 
298
 *  Returns NULL if the function succeeds.
 
299
 *  Returns a CertStore Error if the function fails in a non-fatal way.
 
300
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 
301
 */
 
302
typedef PKIX_Error *
 
303
(*PKIX_CertStore_ImportCrlCallback)(
 
304
        PKIX_CertStore *store,
 
305
        PKIX_List *crlList,
 
306
        void *plContext);
 
307
 
 
308
/*
 
309
 * FUNCTION: PKIX_CertStore_CheckRevokationByCrlCallback
 
310
 * DESCRIPTION:
 
311
 *
 
312
 * The function checks revocation status of a cert with specified
 
313
 * issuer, date. It returns revocation status of a cert and
 
314
 * a reason code(if any) if a cert was revoked.
 
315
 * 
 
316
 * PARAMETERS:
 
317
 *  "store"
 
318
 *      Address of CertStore from which CRLs are to be retrieved.
 
319
 *      Must be non-NULL.
 
320
 *  "cert"
 
321
 *      Certificate which revocation status will be checked.
 
322
 *  "issuer"
 
323
 *      Issuer certificate of the "crl".
 
324
 *  "date"
 
325
 *      Date of the revocation check.
 
326
 *  "reasonCode"
 
327
 *      If cert is revoked, returned reason code for  which a cert was revoked.
 
328
 *  "revStatus"
 
329
 *      Returned revocation status of the cert. See PKIX_RevocationStatus
 
330
 *      for more details
 
331
 *  "plContext"
 
332
 *      Platform-specific context pointer.
 
333
 * THREAD SAFETY:
 
334
 *  Thread Safe
 
335
 *
 
336
 *  Multiple threads must be able to safely call this function without
 
337
 *  worrying about conflicts, even if they're operating on the same object.
 
338
 * RETURNS:
 
339
 *  Returns NULL if the function succeeds.
 
340
 *  Returns a CertStore Error if the function fails in a non-fatal way.
 
341
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 
342
 */
 
343
typedef PKIX_Error *
 
344
(*PKIX_CertStore_CheckRevokationByCrlCallback)(
 
345
        PKIX_CertStore *store,
 
346
        PKIX_PL_Cert *cert,
 
347
        PKIX_PL_Cert *issuer,
 
348
        PKIX_PL_Date *date,
 
349
        PKIX_Boolean delayCrlSigCheck,
 
350
        PKIX_UInt32 *reasonCode,
 
351
        PKIX_RevocationStatus *revStatus,
 
352
        void *plContext);
 
353
 
 
354
/*
279
355
 * FUNCTION: PKIX_CertStore_CrlContinue
280
356
 * DESCRIPTION:
281
357
 *
427
503
        PKIX_CertStore_CertContinueFunction certContinue,
428
504
        PKIX_CertStore_CrlContinueFunction crlContinue,
429
505
        PKIX_CertStore_CheckTrustCallback trustCallback,
 
506
        PKIX_CertStore_ImportCrlCallback importCrlCallback,
 
507
        PKIX_CertStore_CheckRevokationByCrlCallback checkRevByCrlCallback,
430
508
        PKIX_PL_Object *certStoreContext,
431
509
        PKIX_Boolean cachedFlag,
432
510
        PKIX_Boolean localFlag,
488
566
        void *plContext);
489
567
 
490
568
/*
 
569
 * FUNCTION: PKIX_CertStore_GetImportCrlCallback
 
570
 * DESCRIPTION:
 
571
 *
 
572
 *  Retrieves a pointer to "store's" Import CRL callback function and put it in
 
573
 *  "pCallback".
 
574
 *
 
575
 * PARAMETERS:
 
576
 *  "store"
 
577
 *      The CertStore whose CRL callback is desired. Must be non-NULL.
 
578
 *  "pCallback"
 
579
 *      Address where CRL callback function pointer will be stored.
 
580
 *      Must be non-NULL.
 
581
 *  "plContext"
 
582
 *      Platform-specific context pointer.
 
583
 * THREAD SAFETY:
 
584
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 
585
 * RETURNS:
 
586
 *  Returns NULL if the function succeeds.
 
587
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 
588
 */
 
589
PKIX_Error *
 
590
PKIX_CertStore_GetImportCrlCallback(
 
591
        PKIX_CertStore *store,
 
592
        PKIX_CertStore_ImportCrlCallback *pCallback,
 
593
        void *plContext);
 
594
 
 
595
/*
 
596
 * FUNCTION: PKIX_CertStore_GetCheckRevByCrl
 
597
 * DESCRIPTION:
 
598
 *
 
599
 *  Retrieves a pointer to "store's" CRL revocation checker callback function
 
600
 *  and put it in "pCallback".
 
601
 *
 
602
 * PARAMETERS:
 
603
 *  "store"
 
604
 *      The CertStore whose CRL callback is desired. Must be non-NULL.
 
605
 *  "pCallback"
 
606
 *      Address where CRL callback function pointer will be stored.
 
607
 *      Must be non-NULL.
 
608
 *  "plContext"
 
609
 *      Platform-specific context pointer.
 
610
 * THREAD SAFETY:
 
611
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 
612
 * RETURNS:
 
613
 *  Returns NULL if the function succeeds.
 
614
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 
615
 */
 
616
PKIX_Error *
 
617
PKIX_CertStore_GetCrlCheckerFn(
 
618
        PKIX_CertStore *store,
 
619
        PKIX_CertStore_CheckRevokationByCrlCallback *pCallback,
 
620
        void *plContext);
 
621
 
 
622
/*
491
623
 * FUNCTION: PKIX_CertStore_GetTrustCallback
492
624
 * DESCRIPTION:
493
625
 *