(split) LDP v3.24 -> v3.29 の定型的な変更内容を反映。

[linuxjm/LDP_man-pages.git] / draft / man3 / syslog.3

.\" Written  Feb 1994 by Steve Greenland (stevegr@neosoft.com)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Updated 1999.12.19 by Karl M. Hegbloom <karlheg@debian.org>
.\"
.\" Updated 13 Oct 2001, Michael Kerrisk <mtk.manpages@gmail.com>
.\"     Added description of vsyslog
.\"     Added descriptions of LOG_ODELAY and LOG_NOWAIT
.\"     Added brief description of facility and option arguments
.\"     Added CONFORMING TO section
.\" 2001-10-13, aeb, minor changes
.\" Modified 13 Dec 2001, Martin Schulze <joey@infodrom.org>
.\" Modified 3 Jan 2002, Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" Japanese Verion Copyright (c) 1996 Shoichi OZAWA
.\"     all right reserved.
.\" Translated Sep 1 20:14:01 JST 1996
.\"     by Shoichi OZAWA <ozawa@omika.hitachi.co.jp>
.\" Updated Thu Oct 18 01:00:02 JST 2001
.\"     by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated Fri Jan 4 22:15:21 JST 2002
.\"     by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated 2002-04-14 by Kentaro Shirakata <argrath@ub32.org>
.\" Updated 2007-01-01 by Kentaro Shirakata <argrath@ub32.org>
.\"
.TH SYSLOG 3 2008-11-12 "Linux" "Linux Programmer's Manual"
.\"O .SH NAME
.\"O closelog, openlog, syslog, vsyslog \- send messages to the system logger
.SH ̾Á°
closelog, openlog, syslog, vsyslog \- ¥·¥¹¥Æ¥à¥í¥¬¡¼¤Ë¥á¥Ã¥»¡¼¥¸¤òÁ÷¤ë
.\"O .SH SYNOPSIS
.SH ½ñ¼°
.B #include <syslog.h>
.sp
.BI "void openlog(const char *" ident ", int " option ", int " facility );
.br
.BI "void syslog(int " priority ", const char *" format ", ...);"
.br
.B "void closelog(void);"
.sp
.B #include <stdarg.h>
.sp
.BI "void vsyslog(int " priority ", const char *" format ", va_list " ap );
.sp
.in -4n
.\"O Feature Test Macro Requirements for glibc (see
.\"O .BR feature_test_macros (7)):
glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
.RB ( feature_test_macros (7)
»²¾È):
.in
.sp
.BR vsyslog ():
_BSD_SOURCE
.\"O .SH DESCRIPTION
.SH ÀâÌÀ
.\"O .BR closelog ()
.\"O closes the descriptor being used to write to the system logger.
.\"O The use of
.\"O .BR closelog ()
.\"O is optional.
.BR closelog ()
¤Ï¥·¥¹¥Æ¥à¤Î¥í¥°µ­Ï¿ÍÑ¥×¥í¥°¥é¥à(¥·¥¹¥Æ¥à¥í¥¬¡¼
.BR syslogd (8))
¥Ø¤ÎÀܳ¤ò½ªÎ»¤¹¤ë¡£
.BR closelog ()
¤Ïɬ¿Ü¤Ç¤Ï¤Ê¤¤¡£
.sp
.\"O .BR openlog ()
.\"O opens a connection to the system logger for a program.
.BR openlog ()
¤Ï¥í¥°¤ò½ÐÎϤ·¤è¤¦¤È¤·¤Æ¤¤¤ë¥×¥í¥°¥é¥à¤«¤é¥í¥°µ­Ï¿ÍÑ¥×¥í¥°¥é¥à¤Ø¤Î
Àܳ¤ò³«»Ï¤¹¤ë¡£
.\"O The string pointed
.\"O to by
.\"O .I ident
.\"O is prepended to every message, and is typically set to the program name.
.I ident
¤Ç»ØÄꤷ¤¿Ê¸»úÎó(Ä̾ï¤Ï
.BR openlog ()
¤·¤¿¥×¥í¥°¥é¥à¤Î̾Á°)¤Ï¥í¥°½ÐÎϤΰìʸ°ìʸ¤ËÄɲ䵤졢¤É¤Î¥×¥í¥°¥é¥à
¤¬½ÐÎϤ·¤¿¥í¥°¤«¤ò¼±Ê̤¹¤ë¤¿¤á¤Ë»È¤ï¤ì¤ë¡£
.\"O The
.\"O .I option
.\"O argument specifies flags which control the operation of
.\"O .BR openlog ()
.\"O and subsequent calls to
.\"O .BR syslog ().
.I option
°ú¤­¿ô¤Ï¡¢
.BR openlog ()
¤ÎÆ°ºî¤È¤½¤Î¸å¤Î
.BR syslog ()
¤Î¸Æ¤Ó½Ð¤·¤òÀ©¸æ¤¹¤ë¥Õ¥é¥°¤ò»ØÄꤹ¤ë¡£
.\"O The
.\"O .I facility
.\"O argument establishes a default to be used if
.\"O none is specified in subsequent calls to
.\"O .BR syslog ().
.I facility
°ú¤­¿ô¤Ï¡¢¸å¤Ç
.BR syslog ()
¤ò¸Æ¤Ó½Ð¤¹ºÝ¤Ë facility ¤¬»ØÄꤵ¤ì¤Ê¤«¤Ã¤¿¾ì¹ç¤Ë»ÈÍѤµ¤ì¤ë
¥Ç¥Õ¥©¥ë¥ÈÃͤò·èÄꤹ¤ë¡£
.\"O Values for
.\"O .I option
.\"O and
.\"O .I facility
.\"O are given below.
.\"O The use of
.\"O .BR openlog ()
.\"O is optional; it will automatically be called by
.\"O .BR syslog ()
.\"O if necessary, in which case
.\"O .I ident
.\"O will default to NULL.
.I option
¤È
.I facility
¤Ë¤Ä¤¤¤Æ¤Ï¸å½Ò¤¹¤ë¡£
.BR openlog ()
¤Ïɬ¿Ü¤Ç¤Ï¤Ê¤¯¡¢É¬Íפ˱þ¤¸¤Æ
.BR syslog ()
¤«¤é¸Æ¤Ó½Ð¤µ¤ì¤ë¡£
.BR syslog ()
¤¬¸Æ¤Ó½Ð¤·¤¿¾ì¹ç¡¢
.I ident
¤Î¥Ç¥Õ¥©¥ë¥ÈÃÍ¤Ï NULL ¤Ë¤Ê¤ë¡£
.sp
.\"O .BR syslog ()
.\"O generates a log message, which will be distributed by
.\"O .BR syslogd (8).
.BR syslog ()
¤Ï¥í¥°¥á¥Ã¥»¡¼¥¸¤ò½ÐÎϤ·¡¢
.BR syslogd (8)
¤¬¤½¤Î¥á¥Ã¥»¡¼¥¸¤òµ­Ï¿¤¹¤ë¡£
.\"O The
.\"O .I priority
.\"O argument is formed by ORing the
.\"O .I facility
.\"O and the
.\"O .I level
.\"O values (explained below).
.I priority
°ú¤­¿ô¤Ï
.I facility
¤È
.I level
¤È¤ÎÁȹ礻¤Ç»ØÄꤹ¤ë¡£
.I facility
¤È
.I level
¤Î¼è¤ê¤¦¤ëÃͤϸå½Ò¤¹¤ë¡£
.\"O The remaining arguments
.\"O are a
.\"O .IR format ,
.\"O as in
.\"O .BR printf (3)
.\"O and any arguments required by the
.\"O .IR format ,
.\"O except that the two character sequence
.\"O .B %m
.\"O will be replaced by
.\"O the error message string
.\"O .IR strerror ( errno ).
.\"O A trailing newline may be added if needed.
»Ä¤ê¤Î
.I format
°ú¤­¿ô¤Ï
.BR printf (3)
¤È»÷¤¿¥¹¥¿¥¤¥ë¤Î½ñ¼°¤È¤½¤Î½ñ¼°¤ËÍ¿¤¨¤ëÃͤǤ¢¤ë¡£
.I format
Ãæ¤Î2ʸ»ú
.B %m
¤Ï¤½¤Î»þÅÀ¤Ç¤Î
.I errno
¤Ë´ØÏ¢¤¹¤ë¥¨¥é¡¼¥á¥Ã¥»¡¼¥¸Ê¸»úÎó
.RI ( strerror )
¤Ë¤è¤Ã¤ÆÃÖ¤­´¹¤¨¤é¤ì¤ë¡£
ɬÍפʾì¹ç¤ÏËöÈø¤Ë²þ¹Ô¤¬²Ã¤¨¤é¤ì¤ë¡£
.\"O The function
.\"O .BR vsyslog ()
.\"O performs the same task as
.\"O .BR syslog ()
.\"O with the difference that it takes a set of arguments which have
.\"O been obtained using the
.\"O .BR stdarg (3)
.\"O variable argument list macros.
.BR vsyslog ()
´Ø¿ô¤Ï
.BR syslog ()
¤ÈƱ¤¸µ¡Ç½¤ò»ý¤Ä¤¬¡¢²ÄÊÑ°ú¤­¿ô¥ê¥¹¥È¤ò»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤­¤ëÅÀ¤¬°Û¤Ê¤ë¡£
»ØÄꤵ¤ì¤¿°ú¤­¿ô¤Ï¡¢
.BR stdarg (3)
²ÄÊÑ°ú¤­¿ô¥ê¥¹¥È¥Þ¥¯¥í¤òÍѤ¤¤Æ¼èÆÀ¤µ¤ì¤ë¡£

.\"O The subsections below list the parameters used to set the values of
.\"O .IR option , " facility" ", and " priority .
.\"O .SS option
.\"O The
.\"O .I option
.\"O argument to
.\"O .BR openlog ()
.\"O is an OR of any of these:
°Ê²¼¤Î¥µ¥Ö¥»¥¯¥·¥ç¥ó¤Ç¤Ï¡¢
.I option
¤È
.I facility
¤È
.I priority
¤ÎÃͤòÀßÄꤹ¤ë¤Î¤Ë»ÈÍѤµ¤ì¤ë¥Ñ¥é¥á¡¼¥¿¤òÀâÌÀ¤¹¤ë¡£
.SS option
²¼µ­¤ÎÃͤò OR ¤·¤¿¤â¤Î¤¬
.BR openlog ()
¤Î
.I option
°ú¤­¿ô¤Ë¤Ê¤ë:
.TP 15
.B LOG_CONS
.\"O Write directly to system console if there is an error while sending to
.\"O system logger.
¥¨¥é¡¼¤¬¤¢¤ì¤Ð¡¢¥·¥¹¥Æ¥à¥í¥¬¡¼¤ËÁ÷¤ë°ìÊý¤Ç¥·¥¹¥Æ¥à¥³¥ó¥½¡¼¥ë¤Ë¤âľÀܽñ¤¯¡£
.TP
.B LOG_NDELAY
.\"O Open the connection immediately (normally, the connection is opened when
.\"O the first message is logged).
¥í¥°µ­Ï¿ÍÑ¥×¥í¥°¥é¥à¤È¤ÎÀܳ¤ò¨ºÂ¤Ë³«»Ï¤¹¤ë
(Ä̾ï¤Ï¡¢ºÇ½é¤Î¥á¥Ã¥»¡¼¥¸¤¬µ­Ï¿¤µ¤ì¤ë»þ¤ËÀܳ¤ò³«¤¯)¡£
.TP
.B LOG_NOWAIT
.\"O Don't wait for child processes that may have been created while logging
.\"O the message.
.\"O (The GNU C library does not create a child process, so this
.\"O option has no effect on Linux.)
¥á¥Ã¥»¡¼¥¸¤òµ­Ï¿¤¹¤ëºÝ¤ËÀ¸À®¤µ¤ì¤ë»Ò¥×¥í¥»¥¹¤Î½ªÎ»¤òÂÔ¤¿¤Ê¤¤¡£
(GNU C ¥é¥¤¥Ö¥é¥ê¤Ï»Ò¥×¥í¥»¥¹¤òÀ¸À®¤·¤Ê¤¤¡£
¤·¤¿¤¬¤Ã¤Æ¡¢¤³¤Î¥ª¥×¥·¥ç¥ó¤Ï Linux ¤Ç¤Ï̵¸ú¤Ç¤¢¤ë¡£)
.TP
.B LOG_ODELAY
.\"O The converse of
.\"O .BR LOG_NDELAY ;
.\"O opening of the connection is delayed until
.\"O .BR syslog ()
.\"O is called.
.\"O (This is the default, and need not be specified.)
.B LOG_NDELAY
¤ÎÈ¿ÂС£
.BR syslog ()
¤¬¸Æ¤Ð¤ì¤ë¤Þ¤Ç¡¢Àܳ¤Î³«»Ï¤ò¹Ô¤ï¤Ê¤¤¡£
(¤³¤Î¥ª¥×¥·¥ç¥ó¤Ï¥Ç¥Õ¥©¥ë¥È¤Ç¤¢¤ê¡¢Æä˻ØÄꤹ¤ëɬÍפϤʤ¤¡£)
.TP
.B LOG_PERROR
.\"O (Not in POSIX.1-2001.)
.\"O Print to stderr as well.
stderr ¤Ë¤â½ÐÎϤ¹¤ë¡£(POSIX.1-2001 ¤Ç¤ÏÄêµÁ¤µ¤ì¤Æ¤¤¤Ê¤¤)
.TP
.B LOG_PID
.\"O Include PID with each message.
¸Ä¡¹¤Î¥á¥Ã¥»¡¼¥¸¤Ë PID ¤ò´Þ¤á¤ë¡£
.\"O .SS facility
.SS facility
.\"O The
.\"O .I facility
.\"O argument is used to specify what type of program is logging the message.
.\"O This lets the configuration file specify that messages from different
.\"O facilities will be handled differently.
.I facility
°ú¤­¿ô¤Ï¥á¥Ã¥»¡¼¥¸¤Ëµ­Ï¿¤µ¤ì¤ë¥×¥í¥°¥é¥à¤Î¥¿¥¤¥×¤ò»ØÄꤹ¤ë¤¿¤á¤Ë»È¤ï¤ì¤ë¡£
¤³¤ì¤Ë¤è¤Ã¤Æ°Û¤Ê¤ë¥¿¥¤¥×¤Î¥×¥í¥°¥é¥à¤«¤é¤Î¥á¥Ã¥»¡¼¥¸¤Ï°Û¤Ê¤ë°·¤¤¤ò
¤¹¤ë¤è¤¦¤ËÀßÄê¥Õ¥¡¥¤¥ë(
.BR syslog.conf (5))
¤ËÄêµÁ¤Ç¤­¤ë¡£
.TP 15
.B LOG_AUTH
.\"O security/authorization messages (DEPRECATED Use
.\"O .B LOG_AUTHPRIV
.\"O instead)
¥»¥­¥å¥ê¥Æ¥£/ǧ¾Ú ¥á¥Ã¥»¡¼¥¸
(Èó¿ä¾©¡£Âå¤ï¤ê¤Ë
.B LOG_AUTHPRIV
¤ò»ÈÍѤ¹¤ë¤³¤È)
.TP
.B LOG_AUTHPRIV
.\"O security/authorization messages (private)
¥»¥­¥å¥ê¥Æ¥£/ǧ¾Ú ¥á¥Ã¥»¡¼¥¸ (¥×¥é¥¤¥Ù¡¼¥È)
.TP
.B LOG_CRON
.\"O clock daemon
.\"O .RB ( cron " and " at )
¥¯¥í¥Ã¥¯¥Ç¡¼¥â¥ó
.RB ( cron
¤È
.RB at )
.TP
.B LOG_DAEMON
.\"O system daemons without separate facility value
ÆÃÄê¤Î facility Ãͤò»ý¤¿¤Ê¤¤¥·¥¹¥Æ¥à¥Ç¡¼¥â¥ó
.TP
.B LOG_FTP
.\"O ftp daemon
ftp ¥Ç¡¼¥â¥ó
.TP
.B LOG_KERN
.\"O kernel messages (these can't be generated from user processes)
¥«¡¼¥Í¥ë¥á¥Ã¥»¡¼¥¸ (¥æ¡¼¥¶¥×¥í¥»¥¹¤«¤éÀ¸À®¤¹¤ë¤³¤È¤Ï¤Ç¤­¤Ê¤¤)
.\" LOG_KERN has the value 0; if used as a facility, zero translates to:
.\" "use the default facility".
.TP
.\"O .BR LOG_LOCAL0 " through " LOG_LOCAL7
.\"O reserved for local use
.BR LOG_LOCAL0 " ¤«¤é " LOG_LOCAL7
¥í¡¼¥«¥ë¤Ê»ÈÍѤΤ¿¤á¤Ë¥ê¥¶¡¼¥Ö¤µ¤ì¤Æ¤¤¤ë
.TP
.B LOG_LPR
.\"O line printer subsystem
¥é¥¤¥ó¥×¥ê¥ó¥¿¡¦¥µ¥Ö¥·¥¹¥Æ¥à
.TP
.B LOG_MAIL
.\"O mail subsystem
¥á¡¼¥ë¡¦¥µ¥Ö¥·¥¹¥Æ¥à
.TP
.B LOG_NEWS
.\"O USENET news subsystem
USENET ¥Ë¥å¡¼¥¹¡¦¥µ¥Ö¥·¥¹¥Æ¥à
.TP
.B LOG_SYSLOG
.\"O messages generated internally by
.\"O .BR syslogd (8)
.BR syslogd (8)
¤Ë¤è¤Ã¤ÆÆâÉôŪ¤Ëȯ¹Ô¤µ¤ì¤ë¥á¥Ã¥»¡¼¥¸
.TP
.\"O .BR LOG_USER " (default)"
.BR LOG_USER " (¥Ç¥Õ¥©¥ë¥È)"
.\"O generic user-level messages
°ìÈÌŪ¤Ê¥æ¡¼¥¶¥ì¥Ù¥ë¥á¥Ã¥»¡¼¥¸
.TP
.B LOG_UUCP
.\"O UUCP subsystem
UUCP¥µ¥Ö¥·¥¹¥Æ¥à
.SS level
.\"O This determines the importance of the message.
.\"O The levels are, in order of decreasing importance:
¤³¤ì¤Ï¥á¥Ã¥»¡¼¥¸¤ÎÍ¥ÀèÅÙ¤ò»ØÄꤹ¤ë¡£
Í¥ÀèÅ٤ι⤤¤â¤Î¤«¤éÄ㤤¤â¤Î¤Î½ç¤Ç²¼µ­¤¹¤ë¡£
.TP 15
.B LOG_EMERG
.\"O system is unusable
¥·¥¹¥Æ¥à¤¬»ÈÍÑÉÔ²Ä
.TP
.B LOG_ALERT
.\"O action must be taken immediately
ľ¤Á¤Ë¹ÔÆ°¤òµ¯¤³¤µ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤
.TP
.B LOG_CRIT
.\"O critical conditions
´í¸±¤Ê¾õÂÖ
.TP
.B LOG_ERR
.\"O error conditions
¥¨¥é¡¼¤Î¾õÂÖ
.TP
.B LOG_WARNING
.\"O warning conditions
¥ï¡¼¥Ë¥ó¥°¤Î¾õÂÖ
.TP
.B LOG_NOTICE
.\"O normal, but significant, condition
Ä̾ï¤À¤¬½ÅÍפʾõÂÖ
.TP
.B LOG_INFO
.\"O informational message
¥¤¥ó¥Õ¥©¥á¡¼¥·¥ç¥ó¥á¥Ã¥»¡¼¥¸
.TP
.B LOG_DEBUG
.\"O debug-level message
¥Ç¥Ð¥Ã¥°¥ì¥Ù¥ë¤Î¥á¥Ã¥»¡¼¥¸
.LP
.\"O The function
.\"O .BR setlogmask (3)
.\"O can be used to restrict logging to specified levels only.
.BR setlogmask (3)
´Ø¿ô¤ò»ÈÍѤ·¤Æ¡¢
»ØÄꤵ¤ì¤¿¥ì¥Ù¥ë¤Î¥á¥Ã¥»¡¼¥¸¤À¤±¤òµ­Ï¿¤¹¤ë¤è¤¦¤Ë
À©¸Â¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
.\"O .SH "CONFORMING TO"
.SH ½àµò
.\"O The functions
.\"O .BR openlog (),
.\"O .BR closelog (),
.\"O and
.\"O .BR syslog ()
.\"O (but not
.\"O .BR vsyslog ())
.\"O are specified in SUSv2 and POSIX.1-2001.
.BR openlog (),
.BR closelog (),
.BR syslog ()
¤Ï SUSv2 ¤È POSIX.1-2001 ¤Çµ¬Äꤵ¤ì¤Æ¤¤¤ë
(⤷
.BR vsyslog ()
¤Ï½ü¤¯)¡£
.\"O POSIX.1-2001 specifies only the
.\"O .B LOG_USER
.\"O and
.\"O .B LOG_LOCAL*
.\"O values for
.\"O .IR facility .
POSIX.1-2001 ¤Ç¤Ï
.I facility
¤È¤·¤Æ
.B LOG_USER
¤È
.B LOG_LOCAL*
¤ÎÃͤ¬µ¬Äꤵ¤ì¤Æ¤¤¤ë¤À¤±¤Ç¤¢¤ë¡£
.\"O However, with the exception of
.\"O .B LOG_AUTHPRIV
.\"O and
.\"O .BR LOG_FTP ,
.\"O the other
.\"O .I facility
.\"O values appear on most UNIX systems.
¤·¤«¤·¤Ê¤¬¤é¡¢
.B LOG_AUTHPRIV
¤È
.B LOG_FTP
¤È¤¤¤¦Îã³°¤Ï¤¢¤ë¤¬¡¢
¤½¤ì°Ê³°¤Î
.I facility
¤ÎÃͤÏ¿¤¯¤Î UNIX ¥·¥¹¥Æ¥à¤Ç»È¤ï¤ì¤Æ¤¤¤ë¡£
.\"O The
.\"O .B LOG_PERROR
.\"O value for
.\"O .I option
.\"O is not specified by POSIX.1-2001, but is available
.\"O in most versions of UNIX.
.I option
¤ÎÃͤÎ
.B LOG_PERROR
¤ÎÃͤϡ¢ POSIX.1-2001 ¤Ç¤Ïµ¬Äꤵ¤ì¤Æ¤¤¤Ê¤¤¤¬¡¢
UNIX ¤Î¿¤¯¤Î¥Ð¡¼¥¸¥ç¥ó¤Ç»ÈÍѲÄǽ¤Ç¤¢¤ë¡£
.\"O .\" .SH HISTORY
.\" .SH ÍúÎò
.\"O .\" A
.\"O .\" .BR syslog ()
.\"O .\" function call appeared in 4.2BSD.
.\" .BR syslog ()
.\" ¥Õ¥¡¥ó¥¯¥·¥ç¥ó¡¦¥³¡¼¥ë¤Ï 4.2BSD ¤«¤é¼ÂÁõ¤µ¤ì¤¿¡£
.\"O .\" 4.3BSD documents
.\"O .\" .BR openlog (),
.\"O .\" .BR syslog (),
.\"O .\" .BR closelog (),
.\"O .\" and
.\"O .\" .BR setlogmask ().
.\" 4.3BSD ¤Ë¤Ï
.\" .BR openlog (),
.\" .BR syslog (),
.\" .BR closelog (),
.\" .BR setlogmask ()
.\" ¤¬¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¡£
.\"O .\" 4.3BSD-Reno also documents
.\"O .\" .BR vsyslog ().
.\" ¤Þ¤¿¡¢4.3BSD-Reno ¤Ë¤Ï
.\" .BR vsyslog ()
.\" ¤¬¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¡£
.\"O .\" Of course early v* functions used the
.\"O .\" .I <varargs.h>
.\"O .\" mechanism, which is not compatible with
.\"O .\" .IR <stdarg.h> .
.\" ÅöÁ³¤Ê¤¬¤é½é´ü¤Î v* ´Ø¿ô¤Ï
.\" .I <stdarg.h>
.\" ¤È¤Ï¸ß´¹À­¤Î¤Ê¤¤
.\" .I <varargs.h>
.\" ¤Î»ÅÁȤò»ÈÍѤ·¤¿¤â¤Î¤Ç¤¢¤ë¡£
.\"O .SH NOTES
.SH Ãí°Õ
.\"O The argument
.\"O .I ident
.\"O in the call of
.\"O .BR openlog ()
.\"O is probably stored as-is.
.BR openlog ()
¸Æ¤Ó½Ð¤·¤Î
.I ident
°ú¤­¿ô¤Ï¡¢Ãͤ¬¤½¤Î¤Þ¤ÞÊÝ»ý¤µ¤ì¤Æ¤¤¤ë¤³¤È¤òÁ°Äó¤Ë¤·¤Æ¤¤¤ë¡£
.\"O Thus, if the string it points to
.\"O is changed,
.\"O .BR syslog ()
.\"O may start prepending the changed string, and if the string
.\"O it points to ceases to exist, the results are undefined.
¤½¤ì¤æ¤¨¡¢
.I ident
¤Ç»ØÄꤵ¤ì¤¿Ê¸»úÎó¤¬Êѹ¹¤µ¤ì¤ë¤È¡¢
.BR syslog ()
¤ÏÊѹ¹¤µ¤ì¤¿Ê¸»úÎó¤ÎÄɲ乤ë¤À¤í¤¦¤·¡¢
»ØÄꤵ¤ì¤¿Ê¸»úÎó¤¬Â¸ºß¤·¤Ê¤¯¤Ê¤Ã¤¿¾ì¹ç¡¢·ë²Ì¤Ï̤ÄêµÁ¤Ç¤¢¤ë¡£
.\"O Most portable is to use a string constant.
ºÇ¤â°Ü¿¢À­¤¬¤¢¤ëÊýË¡¤Ï¡¢Ê¸»úÎóÄê¿ô¤ò»ÈÍѤ¹¤ë¤³¤È¤Ç¤¢¤ë¡£
.LP
.\"O Never pass a string with user-supplied data as a format,
.\"O use the following instead:
¥æ¡¼¥¶¡¼¤«¤éÍ¿¤¨¤é¤ì¤¿¥Ç¡¼¥¿¤ò format ¤È¤·¤ÆÅϤ·¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
Âå¤ï¤ê¤Ë°Ê²¼¤ò»È¤¦¤³¤È¡£
.nf

    syslog(priority, "%s", string);
.fi
.\"O .SH "SEE ALSO"
.SH ´ØÏ¢¹àÌÜ
.BR logger (1),
.BR setlogmask (3),
.BR syslog.conf (5),
.BR syslogd (8)