Man page - closelog(3)

Packages contains this manual

Available languages:

en fr ja ru de

Manual

SYSLOG

名 前
書 式
説 明
openlog()
syslog() と vsyslog()
closelog()
Values for option
Values for facility
Values for level
属 性
準 拠
注 意
関 連 項 目
こ の 文 書 に つ い て

名 前

closelog, openlog, syslog, vsyslog - シ ス テ ム ロ ガ ー に メ ッ セ ー ジ を 送 る

書 式

#include <syslog.h>

void openlog(const char * ident , int option , int facility );
void syslog(int priority , const char * format , ...);
void closelog(void);

void vsyslog(int priority , const char * format , va_list ap );

glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 ( feature_test_macros (7) 参 照 ):

vsyslog ():
Since glibc 2.19:
_DEFAULT_SOURCE
Glibc 2.19 and earlier:
_BSD_SOURCE

説 明

openlog()

openlog () は 、 プ ロ グ ラ ム 用 の シ ス テ ム ロ ガ ー (system logger) へ の 接 続 を オ ー プ ン す る 。

ident で 指 定 し た 文 字 列 は 各 メ ッ セ ー ジ の 前 に 付 与 さ れ る 。 通 常 は ident に は プ ロ グ ラ ム 名 が 設 定 さ れ る 。 ident が NULL の 場 合 、 プ ロ グ ラ ム が ident と し て 使 用 さ れ る (POSIX.1-2008 で は ident が NULL の 場 合 の 動 作 は 規 定 さ れ て い な い )。

option 引 数 は 、 openlog () の 動 作 と そ の 後 の syslog () の 呼 び 出 し を 制 御 す る フ ラ グ を 指 定 す る 。 facility 引 数 は 、 後 で syslog () を 呼 び 出 す 際 に facility が 指 定 さ れ な か っ た 場 合 に 使 用 さ れ る デ フ ォ ル ト 値 を 決 定 す る 。 option と facility に 指 定 で き る 値 に つ い て は 後 述 す る 。

openlog () は 必 須 で は な く 、 必 要 に 応 じ て syslog () か ら 呼 び 出 さ れ る 。 syslog () が 呼 び 出 し た 場 合 、 ident の デ フ ォ ル ト 値 は NULL に な る 。

syslog() と vsyslog()

syslog () generates a log message, which will be distributed by syslogd (8).

The priority argument is formed by ORing together a facility value and a level value (described below). If no facility value is ORed into priority , then the default value set by openlog () is used, or, if there was no preceding openlog () call, a default of LOG_USER is employed.

The remaining arguments are a format , as in printf (3), and any arguments required by the format , except that the two-character sequence %m will be replaced by the error message string strerror ( errno ). The format string need not include a terminating newline character.

vsyslog () 関 数 は syslog () と 同 じ 機 能 を 持 つ が 、 可 変 引 数 リ ス ト を 指 定 す る こ と が で き る 点 が 異 な る 。 指 定 さ れ た 引 数 は 、 stdarg (3) 可 変 引 数 リ ス ト マ ク ロ を 用 い て 取 得 さ れ る 。

closelog()

closelog () は 、 シ ス テ ム ロ ガ ー に 書 き 込 む の に 使 用 さ れ る フ ァ イ ル デ ィ ス ク リ プ タ ー を ク ロ ー ズ す る 。 closelog () の 使 用 は 必 須 で は な い 。

Values for option

The option argument to openlog () is a bit mask constructed by ORing together any of the following values:

LOG_CONS

エ ラ ー が あ れ ば 、 シ ス テ ム ロ ガ ー に 送 る 一 方 で シ ス テ ム コ ン ソ ー ル に も 直 接 書 く 。

LOG_NDELAY

Open the connection immediately (normally, the connection is opened when the first message is logged). This may be useful, for example, if a subsequent chroot (2) would make the pathname used internally by the logging facility unreachable.

LOG_NOWAIT

メ ッ セ ー ジ を 記 録 す る 際 に 生 成 さ れ る 子 プ ロ セ ス の 終 了 を 待 た な い 。 (GNU C ラ イ ブ ラ リ は 子 プ ロ セ ス を 生 成 し な い 。 し た が っ て 、 こ の オ プ シ ョ ン は Linux で は 無 効 で あ る 。 )

LOG_ODELAY

LOG_NDELAY の 反 対 。 syslog () が 呼 ば れ る ま で 、 接 続 の 開 始 を 行 わ な い 。 (こ の オ プ シ ョ ン は デ フ ォ ル ト で あ り 、 特 に 指 定 す る 必 要 は な い 。 )

LOG_PERROR

メ ッ セ ー ジ を stderr に も 出 力 す る 。 (POSIX.1-2001 に も POSIX.1-2008 に も 定 義 さ れ て い な い )

LOG_PID

個 々 の メ ッ セ ー ジ に 呼 び 出 し 元 の PID を 含 め る 。

Values for facility

facility 引 数 は メ ッ セ ー ジ に 記 録 さ れ る プ ロ グ ラ ム の タ イ プ を 指 定 す る た め に 使 わ れ る 。 こ れ に よ っ て 異 な る タ イ プ の プ ロ グ ラ ム か ら の メ ッ セ ー ジ は 異 な る 扱 い を す る よ う に 設 定 フ ァ イ ル ( syslog.conf (5)) に 定 義 で き る 。

LOG_AUTH

セ キ ュ リ テ ィ /認 証 メ ッ セ ー ジ

LOG_AUTHPRIV

セ キ ュ リ テ ィ /認 証 メ ッ セ ー ジ (プ ラ イ ベ ー ト )

LOG_CRON

ク ロ ッ ク デ ー モ ン ( cron と at )

LOG_DAEMON

特 定 の facility 値 を 持 た な い シ ス テ ム デ ー モ ン

LOG_FTP

ftp デ ー モ ン

LOG_KERN

カ ー ネ ル メ ッ セ ー ジ (ユ ー ザ ー プ ロ セ ス か ら 生 成 す る こ と は で き な い )

LOG_LOCAL0 か ら LOG_LOCAL7

ロ ー カ ル な 使 用 の た め に リ ザ ー ブ さ れ て い る

LOG_LPR

ラ イ ン プ リ ン タ サ ブ シ ス テ ム

LOG_MAIL

メ ー ル サ ブ シ ス テ ム

LOG_NEWS

USENET ニ ュ ー ス サ ブ シ ス テ ム

LOG_SYSLOG

syslogd (8) に よ っ て 内 部 的 に 発 行 さ れ る メ ッ セ ー ジ

LOG_USER (デ フ ォ ル ト )

一 般 的 な ユ ー ザ ー レ ベ ル メ ッ セ ー ジ

LOG_UUCP

UUCPサ ブ シ ス テ ム

Values for level

こ れ は メ ッ セ ー ジ の 優 先 度 を 指 定 す る 。 優 先 度 の 高 い も の か ら 低 い も の の 順 で 下 記 す る 。

LOG_EMERG

シ ス テ ム が 使 用 不 可

LOG_ALERT

直 ち に 行 動 を 起 こ さ な け れ ば な ら な い

LOG_CRIT

危 険 な 状 態

LOG_ERR

エ ラ ー の 状 態

LOG_WARNING

ワ ー ニ ン グ の 状 態

LOG_NOTICE

通 常 だ が 重 要 な 状 態

LOG_INFO

イ ン フ ォ メ ー シ ョ ン メ ッ セ ー ジ

LOG_DEBUG

デ バ ッ グ レ ベ ル の メ ッ セ ー ジ

setlogmask (3) 関 数 を 使 用 し て 、 指 定 さ れ た レ ベ ル の メ ッ セ ー ジ だ け を 記 録 す る よ う に 制 限 す る こ と が で き る 。

属 性

こ の 節 で 使 用 さ れ て い る 用 語 の 説 明 に つ い て は 、 attributes (7) を 参 照 。

Image grohtml-33344-1.png

準 拠

openlog (), closelog (), syslog () は SUSv2, POSIX.1-2001, POSIX.1-2008 で 規 定 さ れ て い る (但 し vsyslog () は 除 く )。

POSIX.1-2001 で は facility と し て LOG_USER と LOG_LOCAL* の 値 が 規 定 さ れ て い る だ け で あ る 。 し か し な が ら 、 LOG_AUTHPRIV と LOG_FTP と い う 例 外 は あ る が 、 そ れ 以 外 の facility の 値 は 多 く の UNIX シ ス テ ム で 使 わ れ て い る 。

option の 値 の LOG_PERROR の 値 は 、 POSIX.1-2001 と POSIX.1-2008 で は 規 定 さ れ て い な い が 、 UNIX の 多 く の バ ー ジ ョ ン で 使 用 可 能 で あ る 。

注 意

openlog () 呼 び 出 し の ident 引 数 は 、 値 が そ の ま ま 保 持 さ れ て い る こ と を 前 提 に し て い る 。 そ れ ゆ え 、 ident で 指 定 さ れ た 文 字 列 が 変 更 さ れ る と 、 syslog () は 変 更 さ れ た 文 字 列 の 追 加 す る だ ろ う し 、 指 定 さ れ た 文 字 列 が 存 在 し な く な っ た 場 合 、 結 果 は 未 定 義 で あ る 。 最 も 移 植 性 が あ る 方 法 は 、 文 字 列 定 数 を 使 用 す る こ と で あ る 。

ユ ー ザ ー か ら 与 え ら れ た デ ー タ を format と し て 渡 し て は な ら な い 。 代 わ り に 以 下 を 使 う こ と 。

syslog(priority, "%s", string);

関 連 項 目

journalctl (1), logger (1), setlogmask (3), syslog.conf (5), syslogd (8)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。