.\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#) syslog. 3 8.1 (Berkeley) 6/4/93 .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/syslog. 3, v 1.3 2002/05/18 07:12:57 horikawa Exp $ \" %FreeBSD: src/lib/libc/gen/syslog. 3, v 1.9. 2.9 2001/12/14 18:33:51 ru Exp % .\" .Dd June 4, 1993 .Dt SYSLOG 3 .Os .Sh 명칭 .Nm syslog , .Nm vsyslog , .Nm openlog , .Nm closelog , .Nm setlogmask .Nd 시스템 로그의 제어 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In syslog.h .In varargs.h .Ft void .Fn syslog "int priority" "const char *message" "..." .Ft void .Fn vsyslog "int priority" "const char *message" "va_list args" .Ft void .Fn openlog "const char *ident" "int logopt" "int facility" .Ft void .Fn closelog void .Ft int .Fn setlogmask "int maskpri" .Sh 해설 .Fn syslog 함수는, 시스템의 메세지 로가-에 메세지를 기록. 그 메세지는, 다음에 상황에 따라 시스템 콘솔, 로그 파일, 로그인한 유저 등에게 쓰기충분해 다른 머신에 전송 됩니다 ( .Xr syslogd 8 참조) . .Pp 메세지는, .Ql %m 하지만 현재의 에러 메세지에 의해 옮겨놓을 수 있는 것을 제외하면, .Xr printf 3 포맷 string와 같은 것이 됩니다 (글로벌 변수 errno 에 의해 나타나는 것과 같다. .Xr strerror 3 참조) . 아무것도 없는 경우는, 말미에 개행이 추가됩니다. .Pp .Fn vsyslog 함수는, .Xr stdarg 3 의 가변장 인수 기능을 사용해 벌써 인수가 capther 되고 있는 경우의 대체 형식입니다. .Pp 메세지에는 우선 순위 ( .Fa priority ) 의 태그를 붙일 수 있습니다. 우선 순위는, .Fa facility (와)과 .Em level 에 코드화 됩니다. .Fa facility (은)는, 메세지를 작성한다 시스템의 일부를 기술합니다. .Em level (은)는, 차례로 되었다 (비싼 (분)편으로부터 낮은 (분)편에게) 다음과 같은 일람으로부터 선택합니다： .Bl -tag -width LOG_AUTHPRIV .It Dv LOG_EMERG 패닉상태. 이것은, 통상은 전유저에게 송신됩니다. .It Dv LOG_ALERT 망가진 시스템 데이타베이스와 같은, 즉시 시정해야 할 상태. .It Dv LOG_CRIT 위험한 상태, 예를 들면 하드 디바이스 에러 등. .It Dv LOG_ERR 에러. .It Dv LOG_WARNING 경고 메세지. .It Dv LOG_NOTICE 에러 상태는 아니지만, 특별히 처리하는 필요성이 생각되는 상태. .It Dv LOG_INFO 인포메이션 메세지. .It Dv LOG_DEBUG 통상은 프로그램의 디버그 시에 마셔 사용하는 정보가 들어갔다 메세지. .El .Pp .Fn openlog 함수는, .Fn syslog 및 .Fn vsyslog 에 의해 보내진 메세지에 대해, 보다 특수한 처리를 가하기 위한 것입니다. 파라미터 .Fa ident (은)는, 모든 메세지의 전에 부가되는 string입니다. .Fa logopt 인수는, 로그 작성 옵션 (을)를 지정하는 비트 필드에서, 다음에 나타내는 값의 1 개(살) 이상을 .Tn OR 조작하는 것에 의해 작성됩니다： .Bl -tag -width LOG_AUTHPRIV .It Dv LOG_CONS .Fn syslog 하지만 메세지를 .Xr syslogd 8 에 건네줄 수 없는 경우, 콘솔 .Pq Dq Pa /dev/console 에 메세지를 기입하는 것을 시도합니다. .It Dv LOG_NDELAY .Xr syslogd 8 에의 접속을 즉시 엽니다. 통상은, 최초의 메세지가 로그에 쓰기까지는 여는 조작을 늦춥니다. 이것은, 파일 기술자를 할당하는 차례를 관리할 필요가 있는 프로그램에서는 역에 섭니다. .It Dv LOG_PERROR 메세지를, 시스템 로그와 동시에 표준 에러 출력에도 기록. .It Dv LOG_PID 각 메세지와 함께 프로세스 ID (을)를 로그 합니다. demon의 인스턴스화를 식별하기 위해서 도움이 됩니다. .El .Pp .Fa facility 파라미터는, 명시적인 퍼실리티가 코드화되어 있지 않은 모든 메세지에 할당하는 디폴트 퍼실리티를 코드화합니다： .Bl -tag -width LOG_AUTHPRIV .It Dv LOG_AUTH 권한 부여 시스템： .Xr login 1 , .Xr su 1 , .Xr getty 8 , 등. .It Dv LOG_AUTHPRIV .Dv LOG_AUTH (와)과 같습니다만, 한정된 개인만이 읽을 수 있다 파일에 로그 합니다. .It Dv LOG_CONSOLE 커널 콘솔 출력 드라이버가, 메세지를 .Pa /dev/console 에 기입합니다. .It Dv LOG_CRON cron demon： .Xr cron 8 . .It Dv LOG_DAEMON .Xr routed 8 (와)과 같은, 다른 퍼실리티에서는 명시적으로 준비되어 있지 않은 시스템 demon. .It Dv LOG_FTP 파일 전송 프로토콜 demon： .Xr ftpd 8 , .Xr tftpd 8 . .It Dv LOG_KERN 커널에 의해 생성되는 메세지. 이것들은, 어떤 사용자 프로세스에 의해도 생성할 수 없습니다. .It Dv LOG_LPR 라인 프린터-의 스프링시스템： .Xr lpr 1 , .Xr lpc 8 , .Xr lpd 8 , 등. .It Dv LOG_MAIL 메일 시스템. .It Dv LOG_NEWS 네트워크 뉴스 시스템. .It Dv LOG_SECURITY 보안 하부조직입니다. 예를 들면 .Xr ipfw 4 입니다. .It Dv LOG_SYSLOG .Xr syslogd 8 에 의해 내부적으로 생성된 메세지. .It Dv LOG_USER 임의의 사용자 프로세스에 의해 생성된 메세지. 아무것도 지정되어 있지 않은 경우는, 이것은 디폴트의 퍼실리티 식별자가 됩니다. .It Dv LOG_UUCP uucp 시스템. .It Dv LOG_LOCAL0 로컬의 사용을 위해서(때문에) 예약. .Dv LOG_LOCAL1 (으)로부터 .Dv LOG_LOCAL7 까지 붙어도 같다. .El .Pp .Fn closelog 함수는, 로그 파일을 닫기 위해서(때문에) 사용할 수가 있습니다. .Pp .Fn setlogmask 함수는, 로그 우선 순위 마스크를 .Fa maskpri (으)로 설정해, 이전의 마스크를 돌려줍니다. .Fa maskpri (으)로 설정되어 있지 않은 우선 순위를 가졌다 .Fn syslog 에의 호출은 거절됩니다. 개별의 우선 순위 .Fa pri (을)를 위한 마스크는, 매크로 .Fn LOG_MASK pri 에 의해 계산됩니다. .Fa toppri 자체를 포함한다 toppri 까지의 모든 우선 순위에 대한 마스크는, 매크로 .Fn LOG_UPTO toppri 에 의해 주어집니다. 디폴트에서는, 모든 우선 순위를 로그 하는 것을 허가합니다. .Sh 반환값 routine .Fn closelog , .Fn openlog , .Fn syslog , 및 .Fn vsyslog (은)는, 값을 돌려주지 않습니다. .Pp routine .Fn setlogmask (은)는, 항상 전의 로그 마스크 레벨을 돌려줍니다. .Sh 예 .Bd -literal -offset indent syslog(LOG_ALERT, "who: internal error 23"); openlog("ftpd", LOG_PID | LOG_NDELAY, LOG_FTP); setlogmask(LOG_UPTO(LOG_ERR)); syslog(LOG_INFO, "Connection from host %d", CallingHost); syslog(LOG_INFO|LOG_LOCAL2, "foobar error: %m"); .Ed .Sh 참조 .Xr logger 1 , .Xr syslogd 8 .Sh 역사 이러한 함수는 .Bx 4.2 에 나타났습니다.