openlog(), syslog()

openlog及closelog函數說明
此函數原型如下:

void openlog( char *ident, int option, int facility)
void syslog( int priority, char *format, …)
void closelog( void )

此函數用來打開一個到系統日誌記錄程序的連接,打開之後就可以用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.

第三個參數指明記錄日誌的程序的類型。

———————————————
option
用於openlog()的option參數可以是以下幾個的組合:

  • LOG_CONS :如果送到system logger時發生問題,直接寫入系統console。
  • LOG_NDELAY :立即開啟連接(通常,連接是在第一次寫入訊息時才打開的)。
  • LOG_PERROR :將訊息也同時送到stderr
  • LOG_PID :將PID含入所有訊息中

facility
facility參數用來指定何種程式在記錄訊息,這可讓設定檔來設定何種訊息如何處理。

  • LOG_AUTH :安全/授權訊息(別用這個,請改用LOG_AUTHPRIV)
  • LOG_AUTHPRIV :安全/授權訊息
  • LOG_CRON :時間守護神專用(cron及at)
  • LOG_DAEMON :其它系統守護神
  • LOG_KERN :核心訊息
  • LOG_LOCAL0到LOG_LOCAL7 :保留
  • LOG_LPR : line printer次系統
  • LOG_MAIL : mail次系統
  • LOG_NEWS : USENET news次系統
  • LOG_SYSLOG : syslogd內部所產生的訊息
  • LOG_USER(default) :一般使用者等級訊息
  • LOG_UUCP : UUCP次系統

level
決定訊息的重要性.以下的等級重要性逐次遞減:

  • LOG_EMERG :系統無法使用
  • LOG_ALERT :必須要立即採取反應行動
  • LOG_CRIT :重要狀況發生
  • LOG_ERR :錯誤狀況發生
  • LOG_WARNING :警告狀況發生
  • LOG_NOTICE :一般狀況,但也是重要狀況
  • LOG_INFO :資訊訊息
  • LOG_DEBUG :除錯訊息

syslog函數及參數
syslog函數用於把日誌消息發給系統程序syslogd去記錄,此函數原型是:
void syslog(int priority, const char *format, …);
第一個參數是消息的緊急級別

第二個參數是消息的格式,之後是格式對應的參數。就是printf函數一樣使用。

如果我們的程序要使用系統日誌功能,只需要在程序啟動時使用openlog函數來連接syslogd程序,後面隨時用syslog函數寫日誌就行了。

另外,作為syslog的替代程序的新一代工具是syslog-ng,syslog-ng具有很強的網絡功能,可以方便地把多台機器上的日誌保存到一台中心日誌服務器上。

分類: 未分類

發表迴響