openssl之EVP系列之5---EVP_Encrypt系列函数详解(二)

openssl之EVP系列之5---EVP_Encrypt系列函数详解(二)
    ---根据openssl doc/crypto/EVP_EncryptInit.pod和doc/ssleay.txt cipher.doc部分翻译和自己的理解写成
    （作者：DragonKing, Mail: [e-mail] ,发布于：http://gdwzh.126.com之openssl专业论坛,版本：openssl-0.9.7）
    前面的文章我们介绍了EVP_ENcrypt系列函数的基本部分，本文将介绍他们的一些扩充部分，即一些参数设置和其它辅助的函数，其定义如下（openssl/evp.h）：
     int EVP_CIPHER_CTX_set_padding(EVP_CIPHER_CTX *x, int padding);
     int EVP_CIPHER_CTX_set_key_length(EVP_CIPHER_CTX *x, int keylen);
    
     const EVP_CIPHER *EVP_get_cipherbyname(const char *name);
     #define EVP_get_cipherbynid(a) EVP_get_cipherbyname(OBJ_nid2sn(a))
     #define EVP_get_cipherbyobj(a) EVP_get_cipherbynid(OBJ_obj2nid(a))
     int EVP_CIPHER_CTX_cleanup(EVP_CIPHER_CTX *a);
    
     #define EVP_CIPHER_nid(e) ((e)->nid)
     #define EVP_CIPHER_block_size(e) ((e)->block_size)
     #define EVP_CIPHER_key_length(e) ((e)->key_len)
     #define EVP_CIPHER_iv_length(e) ((e)->iv_len)
     #define EVP_CIPHER_flags(e) ((e)->flags)
     #define EVP_CIPHER_mode(e) ((e)->flags) & EVP_CIPH_MODE)
     int EVP_CIPHER_type(const EVP_CIPHER *ctx);
    
     #define EVP_CIPHER_CTX_cipher(e) ((e)->cipher)
     #define EVP_CIPHER_CTX_nid(e) ((e)->cipher->nid)
     #define EVP_CIPHER_CTX_block_size(e) ((e)->cipher->block_size)
     #define EVP_CIPHER_CTX_key_length(e) ((e)->key_len)
     #define EVP_CIPHER_CTX_iv_length(e) ((e)->cipher->iv_len)
     #define EVP_CIPHER_CTX_get_app_data(e) ((e)->app_data)
     #define EVP_CIPHER_CTX_set_app_data(e,d) ((e)->app_data=(char *)(d))
     #define EVP_CIPHER_CTX_type(c) EVP_CIPHER_type(EVP_CIPHER_CTX_cipher(c))
     #define EVP_CIPHER_CTX_flags(e) ((e)->cipher->flags)
     #define EVP_CIPHER_CTX_mode(e) ((e)->cipher->flags & EVP_CIPH_MODE)
    
     int EVP_CIPHER_param_to_asn1(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
     int EVP_CIPHER_asn1_to_param(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
    【EVP_CIPHER_CTX_set_padding】
    该函数设置是否采用padding功能.在算法缺省的情况下，是使用标准的块padding功能的，并且在解密的时候会自动接测padding并将它删除。如果将参数pad设置为0，则padding功能就会被禁止，那么在加密和解密的时候，数据应该为加密块长度的整数倍，否则就会出错。函数恒返回1。
    【EVP_CIPHER_CTX_set_key_length】
    该函数进行加密算法结构EVP_CIPHER_CTX密钥长度的设置。如果算法是一个密钥长度固定的算法，那么如果设置的密钥长度跟它固定的长度不一致，就会产生错误。
    【EVP_get_cipherbyname, EVP_get_cipherbynid和EVP_get_cipherbyobj】
    这三个函数都根据给定的参数返回一个EVP_CIPHER结构，不同的是给定的参数分别是算法名称、算法的NID和一个ASN1_OBJECT结构。具体的算法名称、NID以及ASN1_OBJECT结构请参看object/boject.h文件的定义。
    【EVP_CIPHER_nid和EVP_CIPHER_CTX_nid】
    这两个函数返回EVP_CIPHER或EVP_CIPHER_CTX结构内部的算法的NID。返回的NID值只是一个内部存储的值，并不一定真的有相应的OBJECT定义。
    【EVP_CIPHER_key_length和EVP_CIPHER_CTX_key_length】
    这两个函数返回EVP_CIPHER或EVP_CIPHER_CTX结构内部的算法的密钥长度。常量EVP_MAX_KEY_LENGTH定义了所有算法最长的密钥长度。需要注意的是，对于EVP_CIPHER_key_length函数来说，对特定的一种算法密钥长度是不变的，但是EVP_CIPHER_CTX_key_length函数对同一个算法密钥长度却是可变的。
    【EVP_CIPHER_iv_length和EVP_CIPHER_CTX_iv_length】
    这两个函数返回EVP_CIPHER或EVP_CIPHER_CTX结构内部的算法的初始化向量长度。如果算法不使用IV，那么就会返回0。常量EVP_MAX_IV_LENGTH定义了所有算法最长的IV长度
    【EVP_CIPHER_block_size和EVP_CIPHER_CTX_block_size】
    这两个函数返回EVP_CIPHER或EVP_CIPHER_CTX结构内部的算法的加密块长度。常量EVP_MAX_IV_LENGTH也是所有算法最长的块长度。
    【EVP_CIPHER_type和EVP_CIPHER_CTX_type】
    这两个函数返回EVP_CIPHER或EVP_CIPHER_CTX结构内部的算法的类型。该类型的值是算法的NID，一般来说，NID忽略了算法的一些参数，如40位和129位RC2算法的NID是相同的。如果算法没有相应定义的NID或者不是ASN1所支持的，那么本函数就会返回NID_undef。
    【EVP_CIPHER_CTX_cipher】
    该函数返回EVP_CIPHER_CTX结构里面的EVP_CIPHER结构。
    【EVP_CIPHER_mode和EVP_CIPHER_CTX_mode】
    这两个函数返回相应结构算法的块加密模式，包括EVP_CIPH_ECB_MODE, EVP_CIPH_CBC_MODE, EVP_CIPH_CFB_MODE和EVP_CIPH_OFB_MODE；如果算法是流加密算法，那么就返回EVP_CIPH_STREAM_CIPHER 。
    【EVP_CIPHER_param_to_asn1】
    该函数设置算法结构的参数，一般来说设置的值包括了所有参数和一个IV值。如果算法有IV，那么调用该函数时IV是必须设置的。该函数必须在所设置的算法结构使用之前（如调用EVP_EncryptUpdate和EVP_DecryptUpdate函数之前）调用。如果ASN1不支持该算法，那么调用该函数将导致失败。操作成功返回1，否则返回0。
    【EVP_CIPHER_asn1_to_param】
    该函数给用算法结构里面的值设置参数type的结构。其设置的内容由具体的算法决定。如在RC2算法中，它会设置IV和有效密钥长度。本函数应该在算法结构的基本算法类型已经设置了但是密钥还没有设置之前调用。例如，调用EVP_CipherInit函数的时候使用参数IV，并将key设置位NULL，然后就应该调用本函数，最后再调用EVP_CipherInit，这时候除了key设置位NULL外所有参数都应该设置。当ASN1不支持不支持该算法或者有参数不能设置的时候（如RC2的有效密钥长度不支持），该函数调用就会失败。操作成功返回1，否则返回0。
    【EVP_CIPHER_CTX_ctrl】
    该函数可以设置不同算法的特定的参数。目前只有RC2算法的有效密钥长度和RC5算法的加密次数（rounds)可以进行设置。
    
    BTW：我自己感觉都写的有一点慢了，知道大家想知道怎么用来编程，但是，先把这么多函数介绍清楚了，下面看起来就会轻松多了，下一篇就将介绍EVP_Encrypt*...*系列函数的编程框架，并举几个例子。