zlog使用手册

Contents
 1 zlog是什么？ 5
 1.1 兼容性说明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
 1.2 zlog 1.2 发布说明. . . . . . . . . . . . . . . . . . . . . . . . . . . 6
 2 zlog不是什么？ 9
 3 Hello World 11
 3.1 编译和安装zlog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
 3.2 应用程序调用和链接zlog . . . . . . . . . . . . . . . . . . . . . . . . . 12
 3.3 Hello World 代码. . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
 3.4 更简单的Hello World . . . . . . . . . . . . . . . . . . . . . . . . . . 13
 4 Syslog 模型15
 4.1 分类(Category)、规则(Rule)和格式(Format) . . . . . . . . . . . . . . . . 15
 4.2 syslog模型和log4j模型的区别. . . . . . . . . . . . . . . . . . . . . . 16
 4.3 扩展syslog模型. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
 5 配置文件19
 5.1 全局参数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
 5.2 日志等级自定义. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
 5.3 格式(Formats) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
 5.4 转换格式串. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
 5.4.1 转换字符. . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
 5.4.2 宽度修饰符. . . . . . . . . . . . . . . . . . . . . . . . . . . 24
 5.4.3 时间字符. . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
 5.5 规则(Rules) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
 5.5.1 级别匹配. . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
 5.5.2 分类匹配. . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
 5.5.3 输出动作. . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
 5.6 文件转档. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
 5.7 配置文件工具. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
 3
 4 CONTENTS
 6 zlog接口(API) 35
 6.1 初始化和清理. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
 6.2 分类(Category)操作. . . . . . . . . . . . . . . . . . . . . . . . . . . 36
 6.3 写日志函数及宏. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
 6.4 MDC操作. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
 6.5 dzlog接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
 6.6 用户自定义输出. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
 6.7 调试和诊断. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
 7 高阶使用43
 7.1 MDC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
 7.2 诊断zlog本身. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
 7.3 用户自定义等级. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
 7.4 用户自定义输出. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
 8 尾声53
 Chapter 1
 zlog是什么？
 zlog是一个高可靠性、高性能、线程安全、灵活、概念清晰的纯C日志函数库。
 事实上，在C的世界里面没有特别好的日志函数库（就像JAVA里面的的log4j，或者C++的
 log4cxx）。C程序员都喜欢用自己的轮子。printf就是个挺好的轮子，但没办法通过配置改变
 日志的格式或者输出文件。syslog是个系统级别的轮子，不过速度慢，而且功能比较单调。
 所以我写了zlog。
 zlog在效率、功能、安全性上大大超过了log4c，并且是用c写成的，具有比较好的通用性。
 zlog有这些特性：
 syslog分类模型，比log4j模型更加直接了当
 日志格式定制，类似于log4j的pattern layout
 多种输出，包括动态文件、静态文件、stdout、stderr、syslog、用户自定义输出函数
 运行时手动、自动刷新配置文件（同时保证安全）
 高性能，在我的笔记本上达到25万条日志每秒, 大概是syslog(3)配合rsyslogd的1000倍速
 度
 用户自定义等级
 多线程和多进程环境下保证安全转档
 精确到微秒
 简单调用包装dzlog（一个程序默认只用一个分类）
 MDC，线程键-值对的表，可以扩展用户自定义的字段
 自诊断，可以在运行时输出zlog自己的日志和配置状态
 不依赖其他库，只要是个POSIX系统就成(当然还要一个C99兼容的vsnprintf)
 5
 6 CHAPTER 1. ZLOG是什么？
 相关链接：
 软件下载：
<a href="https://github.com/downloads/HardySimpson/zlog/zlog-latest-stable.tar.gz">https://github.com/downloads/HardySimpson/zlog/zlog-latest-stable.tar.gz</a>
 源代码：
<a href="mailto:git&">git@github.com:HardySimpson/zlog.git</a>
 使用手册(pdf)：
<a href="https://github.com/downloads/HardySimpson/zlog/UsersGuide-CN.pdf">https://github.com/downloads/HardySimpson/zlog/UsersGuide-CN.pdf</a>
 问题讨论区：
<a href="https://github.com/HardySimpson/zlog/issues">https://github.com/HardySimpson/zlog/issues</a>
 英文