2.定义应用程序专用日志记录.pptVIP

2.定义应用程序专用日志记录 Berkeley DB 包含用于帮助应用程序专用日志和恢复的开发的工具。 这些工具将会自动地创建: 日志写函数 把它们的参数编成一个单个日志记录的函数 日志读函数 读一个日志记录且分解它成一个包含那个日志记录映射参数的结构的函数 日志打印函数 打印调试日志记录的内容的函数 恢复模板函数 在事务中止或恢复期间回顾日志记录的函数 有一个做应用程序专用恢复的样本应用程序examples_c/ex_apprec. 按照惯例，日志记录在命名为XXX.src的文件中描述，其中“XXX”是一个为一个子系统或其它日志函数逻辑组的特别的描述性名字。这些文件包含被子系统使用的每种类型的日志记录的接口定义语言描述。 在XXX.src 文件中，忽略所有的空行和所有以#开头的行。 文件中第一个没有注释的行应该以关键字PREFIX开头，接着是准备产生的函数的名字的字符串。通常地，PREFIX要么和XXX.src 文件名字一样，要么相似。 例如，Berkeley DB 应用程序专用恢复例子使用文件ex_apprec.src，它的开头是： PREFIX ex_apprec 在PREFIX 行后是包含系统产生函数需要的文件。这些包含文件必须安顺序列举，以关键字INCLUDE为前缀。例如Berkeley DB 应用程序专用恢复例子列举了以下的包含文件： INCLUDE #include ctype.h INCLUDE #include errno.h INCLUDE #include stdlib.h INCLUDE #include string.h INCLUDE INCLUDE #include db.h INCLUDE INCLUDE #include ex_apprec.h XXX.src文件中余下的代码由日志记录描述所组成，每一条日志记录描述以下面这行开始： BEGIN RECORD_NAME RECORD_NUMBER 以下面这行结束： END RECORD_NAME变量被这条日志记录的一个记录名代替。RECORD_NUMBER变量被一个记录数代替。 在关键字BEGIN和END 之间必须有一行给每个作为这条日志记录一部分的数据项。这些行的格式如下： ARG | DBT | POINTER variable_name variable_type printf_format 关键字ARG表示这个参数是指定类型的一个简单参数。例如，一个文件ID可被记录为： ARG fileID int d 关键字DBT表示这个参数是一个Berkeley DB DBT 结构，包含一个长度和一个字节字符串的指针。 关键字POINTER表示这个参数是一个指定数据类型的指针。 variable_name是与用于该项有关的数据结构的域名。variable_type是这个变量的C语言类型，printf_format是C语言格式串，没有应该用于显示域的内容的%（例如，s for string, d for signed integral type, u for unsigned integral type, ld for signed long integral type, lu for long unsigned integral type等等）。 例如，ex_apprec.src 定义了一个单个日志记录类型，它用于记录一个存储在DBT的目录名： BEGIN mkdir 10000 DBT dirname DBT s END 在Berkeley DB distribution中有更多的XXX.src文件的例子。例如，文件btree/btree.src 包含由Berkeley DB B树访问方法支持的日志记录的定义。 3.自动产生功能 XXX.src文件是使用包含在Berkeley DB distribution目录下的gen_rec.awk 脚本处理的。这个一个awk脚本，它是用下面的命令行执行的： awk -f gen_rec.awk \ -v source_file=C_FILE \ -v header_file=H_FILE \ -v template_file=TMP_FILE XXX.src C_FILE是存放自动产生的C代码的文件的名字，H_FILE是存放自动产生的数据结构和声明的文件的名字，TMP_FILE 是存放恢复程序的模板的文件的名字。 因为gen_rec.awk 脚本使用在与Berkeley DB 相关的目标目录的源文件，它必须从那个目标目录运行。例如，当运行Berkeley DB 日志和恢复程序ex_apprec时，下面的脚本被用来重建自动产生文件：