第二十八章 CRL / 28.3 CRL函数

       CRL函数主要是setget函数,如下:

1  int X509_CRL_add0_revoked(X509_CRL *crl, X509_REVOKED *rev)

添加一个被撤销证书的信息。

2  int    X509_CRL_print(BIO *bp,X509_CRL *x)

打印crl内容到BIO中。

    3int X509_CRL_print_fp(FILE *fp, X509_CRL *x)

crl的内容输出到fp中,此函数调用了X509_CRL_print

       4  int X509_CRL_set_issuer_name(X509_CRL *x, X509_NAME *name)

设置crl的颁发者。

5)    int X509_CRL_set_lastUpdate(X509_CRL *x, ASN1_TIME *tm)

设置crl上次发布时间。

       6)    int X509_CRL_set_nextUpdate(X509_CRL *x, ASN1_TIME *tm)

设置crl下次发布时间。

       7)    int X509_CRL_set_version(X509_CRL *x, long version)

设置crl版本。

       8  int X509_CRL_sign(X509_CRL *x, EVP_PKEY *pkey, const EVP_MD *md)

crl进行签名,pkey为私钥,md为摘要算法,结果存放在x-> signature中。

       9  int X509_CRL_sort(X509_CRL *c)

根据证书序列号对crl排序,此函数实现采用了堆栈排序,堆栈的比较函数为X509_REVOKED_cmp(crypto/asn1/x_crl.c)

10int X509_CRL_add1_ext_i2d(X509_CRL *x, int nid, void *value, int crit,  unsigned long flags)

添加CRL扩展,nid为要添加的扩展标识,value为被添加的具体扩展项的内部数据结构地址,crit表明是否为关键扩展,flags表明何种操作。此函数调用X509V3_add1_i2d函数。

       11int X509_CRL_add_ext(X509_CRL *x, X509_EXTENSION *ex, int loc)

              添加扩展项到指定堆栈位置,此函数调用X509v3_add_ext,进行堆栈插入操作。

       12int X509_CRL_cmp(const X509_CRL *a, const X509_CRL *b)

CRL比较,此函数调用X509_NAME_cmp,只比较颁发者的名字是否相同。

       13X509_EXTENSION *X509_CRL_delete_ext(X509_CRL *x, int loc)

删除CRL扩展项堆栈中的某一项,loc指定被删除项在堆栈中的位置。

       14int X509_CRL_digest(const X509_CRL *data, const EVP_MD *type,

 unsigned char *md, unsigned int *len)

CRL摘要,本函数对X509_CRL进行摘要,type指定摘要算法,摘要结果存放在md中,len表明摘要结果长度。

       15X509_CRL_dup

CRL数据拷贝,此函数通过宏来实现。大部分ASN1类型数据都有dup函数,它们的实现方式比较简单:将对象DER编码,然后再解码,这样就实现了ASN1数据的复制。

       16)  void *X509_CRL_get_ext_d2i(X509_CRL *x, int nid, int *crit, int *idx)

CRL中的获取扩展项,此函数用于获取crl中指定扩展项的内部数据结构,返回值为具体的扩展项数据结构地址,nid为扩展项标识,它调用了X509V3_get_d2i函数。

       17int X509_CRL_get_ext_by_critical(X509_CRL *x, int crit, int lastpos)

获取扩展项在其堆栈中的位置,crit为扩展项是否关键标识,lastpos为堆栈搜索起始位置。此函数调用了X509v3_get_ext_by_critical

       18int X509_CRL_get_ext_by_NID(X509_CRL *x, int nid, int lastpos)

获取扩展项在其堆栈中的位置,nid为扩展项标识,lastpos为搜索起始位置。如果找到此扩展项,返回其在堆栈中的位置。

       19)  int X509_CRL_get_ext_by_OBJ(X509_CRL *x, ASN1_OBJECT *obj, int lastpos)

              同上。

20int X509_CRL_get_ext_count(X509_CRL *x)

获取crl中扩展项的个数。

       21)  int X509_CRL_verify(X509_CRL *a, EVP_PKEY *r)

验证CRLEVP_PKEY结构r中需要给出公钥。