← Back to branch summary

~ubuntu-branches/ubuntu/raring/nss/raring-security

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Chris Coulson
  • Date: 2010-03-25 13:46:06 UTC
  • mfrom: (1.1.11 upstream)
  • Revision ID: james.westby@ubuntu.com-20100325134606-bl6liuok2w9l7snv
Tags: 3.12.6-0ubuntu1
* New upstream release 3.12.6 RTM (NSS_3_12_6_RTM)
  - fixes CVE-2009-3555 aka US-CERT VU#120541
* Adjust patches to changed upstream code base
  - update debian/patches/38_kbsd.patch
  - update debian/patches/38_mips64_build.patch
  - update debian/patches/85_security_load.patch
* Remove patches that are merged upstream
  - delete debian/patches/91_nonexec_stack.patch
  - update debian/patches/series
* Bump nspr dependency to 4.8
  - update debian/control
* Add new symbols for 3.12.6
  - update debian/libnss3-1d.symbols

Show diffs side-by-side

added added

removed removed

Lines of Context:
mozilla/security/nss/lib/libpkix/include/pkix_certsel.h
118
118
 * DESCRIPTION:
119
119
 *
120
120
 *  This callback function determines whether the specified Cert pointed to by
121
 
 *  "cert" matches the criteria of the CertSelector pointed to by "selector",
122
 
 *  and stores the result at "pResult". If the Cert matches the CertSelector's
123
 
 *  criteria, a value of PKIX_TRUE will be stored at "pResult"; otherwise a
124
 
 *  value of PKIX_FALSE will be stored.
 
121
 *  "cert" matches the criteria of the CertSelector pointed to by "selector".
 
122
 *  If the Cert does not matches the CertSelector's criteria, an exception will
 
123
 *  be thrown.
125
124
 *
126
125
 * PARAMETERS:
127
126
 *  "selector"
130
129
 *  "cert"
131
130
 *      Address of Cert that is to be matched using "selector".
132
131
 *      Must be non-NULL.
133
 
 *  "pResult"
134
 
 *      Address where Boolean value will be stored. Must be non-NULL.
135
132
 *  "plContext"
136
133
 *      Platform-specific context pointer.
137
134
 * THREAD SAFETY:
148
145
(*PKIX_CertSelector_MatchCallback)(
149
146
        PKIX_CertSelector *selector,
150
147
        PKIX_PL_Cert *cert,
151
 
        PKIX_Boolean *pResult,
152
148
        void *plContext);
153
149
 
154
150
/*
1796
1792
        PKIX_Boolean match,
1797
1793
        void *plContext);
1798
1794
 
 
1795
/*
 
1796
 * FUNCTION: PKIX_ComCertSelParams_GetLeafCertFlag
 
1797
 * DESCRIPTION:
 
1798
 *
 
1799
 * Return "leafCert" flag of the ComCertSelParams structure. If set to true,
 
1800
 * the flag indicates that a selector should filter out all cert that are not
 
1801
 * qualified to be a leaf cert according to the specified key/ekey usages.
 
1802
 *
 
1803
 * PARAMETERS:
 
1804
 *  "params"
 
1805
 *      Address of ComCertSelParams object used to determine whether all
 
1806
 *      subject alternative names must be matched. Must be non-NULL.
 
1807
 *  "pLeafFlag"
 
1808
 *      Address of returned value.
 
1809
 *  "plContext"
 
1810
 *      Platform-specific context pointer.
 
1811
 * THREAD SAFETY:
 
1812
 *  Conditionally Thread Safe
 
1813
 *      (see Thread Safety Definitions in Programmer's Guide)
 
1814
 * RETURNS:
 
1815
 *  Returns NULL if the function succeeds.
 
1816
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 
1817
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 
1818
 */
 
1819
PKIX_Error*
 
1820
PKIX_ComCertSelParams_GetLeafCertFlag(
 
1821
        PKIX_ComCertSelParams *params,
 
1822
        PKIX_Boolean *pLeafFlag,
 
1823
        void *plContext);
 
1824
 
 
1825
/*
 
1826
 * FUNCTION: PKIX_ComCertSelParams_SetLeafCertFlag
 
1827
 * DESCRIPTION:
 
1828
 *
 
1829
 * Sets a flag that if its value is true, indicates that the selector
 
1830
 * should only pick certs that qualifies to be leaf for this cert path
 
1831
 * validation.
 
1832
 *
 
1833
 * PARAMETERS:
 
1834
 *  "params"
 
1835
 *      Address of ComCertSelParams object whose match flag is to be set.
 
1836
 *      Must be non-NULL.
 
1837
 *  "leafFlag"
 
1838
 *      Boolean value used to set the leaf flag.
 
1839
 *  "plContext"
 
1840
 *      Platform-specific context pointer.
 
1841
 * THREAD SAFETY:
 
1842
 *  Not Thread Safe - assumes exclusive access to "params"
 
1843
 *  (see Thread Safety Definitions in Programmer's Guide)
 
1844
 * RETURNS:
 
1845
 *  Returns NULL if the function succeeds.
 
1846
 *  Returns a CertSelector Error if the function fails in a non-fatal way.
 
1847
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 
1848
 */
 
1849
PKIX_Error *
 
1850
PKIX_ComCertSelParams_SetLeafCertFlag(
 
1851
        PKIX_ComCertSelParams *params,
 
1852
        PKIX_Boolean leafFlag,
 
1853
        void *plContext);
 
1854
 
1799
1855
#ifdef __cplusplus
1800
1856
}
1801
1857
#endif