Certificate: search


Functions

GSList * CST_search_by_subj_name (CST *st, X509_NAME *subject_name)
GSList * CST_search_by_email (CST *st, const char *email)
GSList * CST_search_by_domain_name (CST *st, const char *domain_name)
GSList * CST_search_by_serial (CST *st, const char *serial)
GSList * CST_search_by_fingerprint (CST *st, const char *fingerprint)
cst_t_seqnum CST_search_issuer (CST *st, X509 *cert)
GSList * CST_search_by_folder_and_purpose (CST *st, const cst_t_cert_folder folder, const cst_t_cert_purpose purpose)
GSList * CST_search_by_folder (CST *st, const cst_t_cert_folder folder)
GSList * CST_all_expired (CST *st)
GSList * CST_all_revoked (CST *st)
GSList * CST_search_by_purpose (CST *st, const cst_t_cert_purpose purpose)
cst_t_seqnum CST_search_by_UID (CST *st, X509_NAME *issuer, ASN1_INTEGER *serial)
cst_t_seqnum CST_search_by_X509 (CST *st, X509 *xcert)

Function Documentation

GSList* CST_all_expired ( CST st  ) 

Get all expired certificates

Todo:
Need implement
Parameters:
st Pointer to storage structure
Returns:
Array of certificates or NULL if not found chain
Possible error: CST_ERROR_CERT_NOTFOUND - if cert chain incomplite

Example 2. Using search functions, which return GSList.

GSList* CST_all_revoked ( CST st  ) 

Get all revoked certificates

Todo:
Need implement
Parameters:
st Pointer to storage structure
Returns:
Stack of certificates or NULL if not found chain
Example 2. Using search functions, which return GSList.

GSList* CST_search_by_domain_name ( CST st,
const char *  domain_name 
)

Search certifiacate by domain name

Parameters:
st Pointer to storage structure
domain_name Domain name of subject
Returns:
Array of certificates for given domain name and NULL if not found
Possible error: CST_ERROR_CERT_NOTFOUND

Example 2. Using search functions, which return GSList.

GSList* CST_search_by_email ( CST st,
const char *  email 
)

Search certifiacate by email

Parameters:
st Pointer to storage structure
email Email of subject
Returns:
Array of certificates for given DN and NULL if not found
Possible error: CST_ERROR_CERT_NOTFOUND

Example 2. Using search functions, which return GSList.

GSList* CST_search_by_fingerprint ( CST st,
const char *  fingerprint 
)

Search certifiacate by email

Parameters:
st Pointer to storage structure
fingerprint Fingerprint (see. CST_get_fingerprint())
Returns:
Array of certificates for given fingerprint and NULL if not found
Possible error: CST_ERROR_CERT_NOTFOUND

Example 2. Using search functions, which return GSList.

GSList* CST_search_by_folder ( CST st,
const cst_t_cert_folder  folder 
)

Get all certificates by folder If folder = CST_FOLDER_CA then return all CA certificates

Parameters:
st Pointer to storage structure
folder Folder
Returns:
List of certificates or NULL if not found
Example 2. Using search functions, which return GSList.

GSList* CST_search_by_folder_and_purpose ( CST st,
const cst_t_cert_folder  folder,
const cst_t_cert_purpose  purpose 
)

Get all trusted certificates for given purpose in selected folder. For example, all CA certificates for WLAN.

Parameters:
st Pointer to storage structure
folder Folder
purpose Certificate purpose
Returns:
List of certificates or NULL if not found
Example 2. Using search functions, which return GSList.

GSList* CST_search_by_purpose ( CST st,
const cst_t_cert_purpose  purpose 
)

Get all trusted certificates for given purpose

Parameters:
st Pointer to storage structure
purpose Certificate purpose
Returns:
List of certificates or NULL if not found
Example 2. Using search functions, which return GSList.

GSList* CST_search_by_serial ( CST st,
const char *  serial 
)

Search certifiacate by serial

Parameters:
st Pointer to storage structure
serial Serial number
Returns:
Array of certificates for given serial and NULL if not found
Possible error: CST_ERROR_CERT_NOTFOUND

Example 2. Using search functions, which return GSList.

GSList* CST_search_by_subj_name ( CST st,
X509_NAME *  subject_name 
)

Search certifiacate by subject name

Parameters:
st Pointer to storage structure
subject_name Subject Distinguished name
Returns:
List of certificates ID for given DN or NULL if not found
Possible error: CST_ERROR_CERT_NOTFOUND

Example 2. Using search functions, which return GSList.

cst_t_seqnum CST_search_by_UID ( CST st,
X509_NAME *  issuer,
ASN1_INTEGER *  serial 
)

Get certificate ID (int) by UID (issuer + serial)

Parameters:
st Pointer to storage structure
issuer Distinguished name of issuer
serial Serial number
Returns:
Certificate or 0 if not found

cst_t_seqnum CST_search_by_X509 ( CST st,
X509 *  xcert 
)

Get certificate ID (int) by openssl X509 certificate

Parameters:
st Pointer to storage structure
xcert X509 certificate
Returns:
Certificate ID or 0 in not found

cst_t_seqnum CST_search_issuer ( CST st,
X509 *  cert 
)

Search issuer of given certifiacate

Parameters:
st Pointer to storage structure
cert Certificate
Returns:
certID of issuer or NULL


Generated on Fri Sep 28 12:57:35 2007 for Certman by  doxygen 1.5.1