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

---