14.openssl编程——错误处理
14.1 概述
程序设计时，一般通过函数的返回值来判断是否调用成功。设计良好的函数以及好的错误处理能版主调用者快速找到错误：
*错误码
*出错文件以及行号
*错误原因
*出错函数
*出错库
*出错模块与类别信息
*错误堆栈信息等
14.2 数据结构
openssl中，通过unsgined long 类型来存放错误信息。它包含三部分内容：库代码、函数代码以及错误原因代码。
#define ERR_GET_LIB(l) (int)((((unsigned long)l)>>24L)&0xffL)
#define ERR_GET_FUNC(l) (int)((((unsigned long)l)>>12L)&0xfffL)
#define ERR_GET_REASON(l) (int)((l)&0xfffL)
a.主要数据接哦古有两个
ERR_STRING_DATA
{
unsigned long error;
const char *string;
} ERR_STRING_DATA;
该数据结构的内容由各个功能模块来设置。
b.struct err_state_st {
int err_flags[ERR_NUM_ERRORS];
unsigned long err_buffer[ERR_NUM_ERRORS];错误码，包含库、函数以及错误原因信息
char *err_data[ERR_NUM_ERRORS];存放操作信息
int err_data_flags[ERR_NUM_ERRORS];存放err_data相关标记
const char *err_file[ERR_NUM_ERRORS];错误文件名
int err_line[ERR_NUM_ERRORS];错误的行号
int top, bottom;用于指明ERR_STATE的使用状态。
}
14.3 主要函数
a.ERR_add_error_data
在本层错误的err_data元素中添加说明信息。
b.ERR_clear_error
清除所有错误信息。如果不清楚所有错误信息，可能会有其他无关错误遗留在ERR_STATE表中
c.ERR_error_string / ERR_error_string_n
根据错误码获取具体的错误信息，包括出错的库，出错的函数以及错误原因。
d.ERR_free_strings
根据错误号，获取出错的函数信息
e.ERR_get_err_state_table
获取存放错误的哈希表
f.ERR_get_error
获取存放错误的哈希表
g.ERR_get_error_line
根据错误号，获取出错信息
h.ERR_get_implementation
获取错误处理函数，与哈希表操作相关。
i.ERR_get_state
获取ERR_STATE表
j.ERR_lib_error_string
获取错误号，获取是那个库出错
k.ERR_load_strings
加载错误信息，由各个模块调用
l.ERR_load_ASN1_strings.
m.ERR_peek_error
获取第一个错误号
n.ERR_peek_error_line
获取第一个错误的出错行
o.ERR_peek_error_line_data
获取第一个错误的函数和错误信息
p.ERR_peek_last_error
获取最后一个错误的行号
q.ERR_peek_last_error_line_data
获取最后一个错误的行号和错误信息
r.ERR_print_errors
将错误信息输出到bio中
s.ERR_print_error_cb
根据用户设置的回调函数来打印错误信息
t.ERR_print_error_fp
将错误打印到FILE中
u.ERR_print_errors_fp
将错误信息存放到ERR_STATE表中top制定的错误堆栈
v.ERR_reason_error_string
根据错误号得到错误原因
w.ERR_remove_state
删除县城相关的错误信息
s.ERR_set_error_data
将错误信息存放到ERR_STATE表中top指定的错误堆栈（最后的错误）
y.ERR_unload_strings
从错误哈希表中删除相关信息
z.
