我是这样学习Linux下C语言编程的-把程序输出信息加到系统日志里去

我是这样学习Linux下C语言编程的-把程序输出信息加到系统日志里去

关键词： Linux
系统日志
syslog
服务程序 syslogd
我们的程序一般都会产生输出信息。但是服务器程序一般却不希望输出信息到屏幕上，因为没有人盯着你的程序执行。所以我们要把一些信息写成日志文件，正常情况下运行程序的人不用关心日志里的内容，只有在出现问题的时候才会查看日志文件里的内容以确定问题所在。

但如果我们的程序要自己生成一个文件来保存日志却不是好主意，因为这一方面增加了维护程序运行的人的负担，另一方面自己维护起系统来也多有不便。

在Linux系统中有一个系统日志，通常放在/var/log目录下，比如文件名是syslog的，系统中的一些程序产生的日志信息都会存放到这个文件里。日志文件有固定的格式，比如第1列是消息产生的时间，第2列是机器名（因为日志记录程序支持远程连接），第3列是标记信息（一般就是程序名称）等。而且对应的有一些工具来对这个日志进行维护，比如通过轮回机制保证日志文件大小不会把磁盘空间占尽。所以我们把自己程序的信息也写到这个系统日志里是比较好的想法。

在GNU C语言库提供的内容中，有接口可以用来做这件事。用下面的命令查看：

nm -D /lib/libc.so.6 | grep log

可以看到一些调用：

000b9410 T closelog 0008b870 T getlogin 0008b960 T getlogin_r 000d0180 T __getlogin_r_chk 000bd190 T klogctl 00027450 T __open_catalog 000b9380 T openlog 0008bae0 T setlogin 000b8b80 T setlogmask 000b9350 T syslog 000b9320 T __syslog_chk 000b92f0 T vsyslog 000b8da0 T __vsyslog_chk

这里面的三个函数openlog， syslog， closelog是一套系统日志写入接口。另外那个vsyslog和syslog功能一样，只是参数格式不同。

程序的用法示例代码如下：

#include <syslog.h> int main(int argc, char **argv) { openlog("MyMsgMARK", LOG_CONS | LOG_PID, 0); syslog(LOG_DEBUG, "This is a syslog test message generated by program '%s'\n", argv[0]); closelog(); return 0; }

编译生成可执行程序后，运行一次程序将向/var/log/syslog文件添加一行信息如下：

Feb 12 08:48:38 localhost MyMsgMARK[7085]: This is a syslog test message generated by program './a.out'

/************关于本文档********************************************

*filename: 我是这样学习Linux下C语言编程的-把程序输出信息加到系统日志里去

*purpose: 说明如何利用syslog进行系统日志操作

*wrote by: zhoulifa(zhoulifa@163.com) 周立发(http://zhoulifa.bokee.com)

Linux爱好者 Linux知识传播者 SOHO族 开发者 最擅长C语言

*date time:2007-02-12 18:40

*Note: 任何人可以任意复制代码并运用这些文档，当然包括你的商业用途

* 但请遵循GPL

*Thanks to:Ubuntu

*Hope:希望越来越多的人贡献自己的力量，为科学技术发展出力

* 科技站在巨人的肩膀上进步更快！感谢有开源前辈的贡献！

*********************************************************************/

openlog及closelog函数说明

此函数原型如下：

void openlog(const char *ident, int option, int facility);

此函数用来打开一个到系统日志记录程序的连接，打开之后就可以用syslog或vsyslog函数向系统日志里添加信息了。而closelog函数就是用来关闭此连接的。

openlog的第一个参数ident将是一个标记，ident所表示的字符串将固定地加在每行日志的前面以标识这个日志，通常就写成当前程序的名称以作标记。第二个参数option是下列值取与运算的结果：LOG_CONS， LOG_NDELAY， LOG_NOWAIT， LOG_ODELAY， LOG_PERROR， LOG_PID，各值意义请参考man openlog手册：

LOG_CONS Write directly to system console if there is an error while sending to system logger. LOG_NDELAY Open the connection immediately (normally, the connection is opened when the first message is logged). LOG_NOWAIT Don’t wait for child processes that may have been created while logging the message. (The GNU C library does not create a child process, so this option has no effect on Linux.) LOG_ODELAY The converse of LOG_NDELAY; opening of the connection is delayed until syslog() is called. (This is the default, and need not be specified.) LOG_PERROR (Not in SUSv3.) Print to stderr as well. LOG_PID Include PID with each message.

第三个参数指明记录日志的程序的类型。

syslog函数及参数

syslog函数用于把日志消息发给系统程序syslogd去记录，此函数原型是：

void syslog(int priority, const char *format, ...);

第一个参数是消息的紧急级别，第二个参数是消息的格式，之后是格式对应的参数。就是printf函数一样使用。

如果我们的程序要使用系统日志功能，只需要在程序启动时使用openlog函数来连接syslogd程序，后面随时用syslog函数写日志就行了。

另外，作为syslog的替代程序的新一代工具是syslog-ng，syslog-ng具有很强的网络功能，可以方便地把多台机器上的日志保存到一台中心日志服务器上