zlog 使用手册

• Chapter 1  zlog是什么？
  • 1.1  兼容性说明
  • 1.2  zlog 1.2 发布说明
• Chapter 2  zlog不是什么？
• Chapter 3  Hello World
  • 3.1  编译和安装zlog
  • 3.2  应用程序调用和链接zlog
  • 3.3  Hello World 代码
  • 3.4  更简单的Hello World
• Chapter 4  Syslog 模型
  • 4.1  分类(Category)、规则(Rule)和格式(Format)
  • 4.2  syslog模型和log4j模型的区别
  • 4.3  扩展syslog模型
• Chapter 5  配置文件
  • 5.1  全局参数
  • 5.2  日志等级自定义
  • 5.3  格式(Formats)
  • 5.4  转换格式串
    • 5.4.1  转换字符
    • 5.4.2  宽度修饰符
    • 5.4.3  时间字符
  • 5.5  规则(Rules)
    • 5.5.1  级别匹配
    • 5.5.2  分类匹配
    • 5.5.3  输出动作
  • 5.6  文件转档
  • 5.7  配置文件工具
• Chapter 6  zlog接口(API)
  • 6.1  初始化和清理
  • 6.2  分类(Category)操作
  • 6.3  写日志函数及宏
  • 6.4  MDC操作
  • 6.5  dzlog接口
  • 6.6  用户自定义输出
  • 6.7  调试和诊断
• Chapter 7  高阶使用
  • 7.1  MDC
  • 7.2  诊断zlog本身
  • 7.3  用户自定义等级
  • 7.4  用户自定义输出
• Chapter 8  尾声

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)

相关链接：

主页：http://hardysimpson.github.com/zlog/

下载：https://github.com/HardySimpson/zlog/releases

邮箱：HardySimpson1984@gmail.com

1.1  兼容性说明

1. zlog是基于POSIX的。目前我手上有的环境只有AIX和linux。在其他的系统下（FreeBSD, NetBSD, OpenBSD, OpenSolaris, Mac OS X...）估计也能行，有问题欢迎探讨。
2. zlog使用了一个C99兼容的vsnprintf。也就是说如果缓存大小不足，vsnprintf将会返回目标字符串应有的长度（不包括’