.\" Copyright (c) 1983, 1986, 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. .\" .\" @(#) syslogd. 8 8.1 (Berkeley) 6/6/93 .\" %FreeBSD: src/usr.sbin/syslogd/syslogd. 8, v 1.47 2002/10/18 11:42:21 tjr Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man8/syslogd. 8, v 1.30 2002/11/18 06:17:45 horikawa Exp $ .\" .Dd November 24, 2001 .Dt SYSLOGD 8 .Os .Sh 명칭 .Nm syslogd .Nd 시스템 메세지의 기록을 취한다 .Sh 서식 .Nm .Op Fl 46Acdknosuv .Op Fl a Ar allowed_peer .Op Fl b Ar bind_address .Op Fl f Ar config_file .Op Fl l Ar path .Op Fl m Ar mark_interval .Op Fl P Ar pid_file .Op Fl l Ar path .Op Fl p Ar log_socket .Sh 해설 .Nm 유틸리티는 설정 파일로 지정된 대로, 시스템 콘솔, 로그 파일, 다른 머신이나 유저에게로의 메세지를 읽어들여, 기록합니다. .Pp 옵션에는 이하의 것이 있습니다. .Bl -tag -width indent .It Fl 4 .Nm 하지만 IPv4 주소만을 사용하도록, 강제합니다. .It Fl 6 .Nm 하지만 IPv6 주소만을 사용하도록, 강제합니다. .It Fl A 호스트가 복수의 A 또는 AAAA 레코드를 가지고 있는 경우에서도, 통상 .Nm (은)는 메세지를 단일의 주소에게만 송신하려고 합니다. 본옵션이 지정되면(자), .Nm (은)는 메세지를 모든 주소에 송신하려고 합니다. .It Fl a Ar allowed_peer .Ar allowed_peer 하지만 이 .Nm 에 UDP 데이터 그램을 사용해 로그 하는 것을 허락합니다. 복수의 .Fl a 옵션을 지정 가능합니다. .Pp .Ar allowed_peer (은)는 이하의 머지않아인가입니다: .Bl -tag -width "ipaddr/masklen[:service]XX" .It Xo .Sm off .Ar ipaddr .No / Ar masklen .Op : Ar service .Sm on .Xc .Ar ipaddr (통상의 닷 표기의 4 개조) (으)로부터의 데이터 그램을 받아들입니다. 주소 비교때, .Ar masklen 비트를 고려합니다. 주소를 .Ql \&[ (와)과 .Ql \&] 그리고 괄일로, .Ar ipaddr 에 IPv6 주소를 지정 가능합니다. .Ar service 하지만 지정되었을 경우, 패킷 송출원이 속해야 한다 UDP service 의 이름 혹은 번호가 됩니다 ( .Xr services 5 참조). .Ar service 에 .Ql \&* (을)를 지정하면(자), 모든 UDP 포트로부터 송신된 패킷을 받아들입니다. 디폴트의 .Ar service 하 .Ql syslog 입니다. .Ar ipaddr 하지만 IPv4 주소의 경우로 .Ar masklen (을)를 지정하지 않으면 .Ar ipaddr 하지만 클래스 A 혹은 B 의 주소 범위에 속하는 경우에는 각각 역사적인 클래스 A 혹은 B 의 넷 마스크가 사용되어 그렇지 않은 경우에는 24 가 사용됩니다. .Ar ipaddr 하지만 IPv6 주소의 경우로 .Ar masklen (을)를 지정하지 않으면 .Ar masklen (은)는 128 이 이용됩니다. .It Xo .Sm off .Ar domainname Op : Ar service .Sm on .Xc 송신 주소의 주소역 당겨에 두어 .Ar domainname (을)를 얻을 수 있던 데이터 그램을 받아들입니다. .Ar service 의 의미는 상술한 대로입니다. .It Xo .Sm off .No * Ar domainname Op : Ar service .Sm on .Xc 상술대로입니다만, 송신 호스트명이 .Ar domainname 그리고 .Em 끝난다 모든 호스트로부터 받아들입니다. .El .Pp .Fl s 하지만 지정되었을 경우에는, .Fl a 옵션은 무시됩니다. .It Fl b Ar bind_address 바인드 대상이 되는 IP 주소 또는 호스트명을, 1 개 지정합니다. 호스트명이 지정되었을 경우, 이것에 대응한다 IPv4 또는 IPv6 의 주소가 사용됩니다. .It Fl c 출력이 다른 프로그램에의 파이프의 경우, 같은 행의 반복을 .Dq Li "last message repeated N times" 그렇다고 하는 형식의 단일행에 압축하는 것을 무효화합니다. 2 회 지정하면(자), 모든 경우에 대해 이 압축을 무효화합니다. .It Fl d .Nm (을)를 디버그 모드로 실행합니다. 이것은 아마, .Nm 의 개발자에게만 도움이 됩니다. .It Fl f 대신의 설정 파일의 패스명을 지정합니다. 디폴트는 .Pa /etc/syslog.conf 입니다. .It Fl k 퍼실리티 .Dq kern 그리고 수신한 메세지를 퍼실리티 .Dq user 에 변환하는 것을, 멈춥니다. 통상은, .Dq kern 퍼실리티는, 직접 .Pa /dev/klog (으)로부터 읽어들이는 메세지용으로 예약되고 있습니다. .It Fl m .Dq mark 된 메세지의 간격을 분 단위로 지정합니다. 디폴트는 20 분입니다. .It Fl n 모든 요구에 대해, DNS 에의 문의를 억제합니다. .It Fl o 커널 메세지의 전에, .Xr getbootfile 3 그리고 판정되는 완전한 커널 부트 파일을 붙입니다. 이것을 지정하지 않으면 커널 메세지의 프레픽스는 항상 .Dq Li kernel: (이)가 됩니다. .It Fl p 대표해에 사용하는 로그용 소켓의 패스명을 지정합니다. 디폴트는 .Pa /var/run/log 입니다. .It Fl P 프로세스 ID 를 격납하기 위한별의 파일을 지정합니다. 디폴트는 .Pa /var/run/syslog.pid 입니다. .It Fl l .Nm 하지만 추가의 로그용 소켓을 두는 장소를 지정합니다. 19 개까지 추가의 로그용 소켓을 지정 가능합니다. 주된 용법은, 여러가지로 chroot 한 파일 공간에 있어 추가의 로그용 소켓을 .Pa /var/run/log 에 둔다고 하는 것입니다. .It Fl s 시큐어 모드로 조작합니다. 리모트 머신으로부터의 로그 메세지를 로그 하지 않습니다. 2 번 지정하면(자), 네트워크 소켓을 전혀 오픈하지 않고, 또 리모트 머신에의 로그 동작도 무효로 합니다. .It Fl u 다만 1 개의 우선도의 로그만 실시합니다. 지정한 우선도의 메세지만 로그 합니다. 이 옵션을 지정하지 않으면 지정한 우선도 이상의 메세지가 로그 됩니다. 이 옵션에 의해, 디폴트의 비교를 .Dq => (으)로부터 .Dq = (으)로 변경합니다. .It Fl v 장황한 로그를 실시합니다. 1 번 지정하면(자), 로컬에 기입해진 메세지와 함께, 퍼실리티와 우선도가 수치로 로그 됩니다. 여러 차례 지정하면(자), 로컬에 기입해진 메세지와 함께, 퍼실리티와 우선도가 이름으로 로그 됩니다. .El .Pp .Nm 유틸리티는 기동시와 hangup 시그널을 받았을 때는 언제라도 설정 파일을 읽어들입니다. 설정 파일의 포맷에 관한 정보는, .Xr syslog.conf 5 참조해 주세요. .Pp .Nm 유틸리티는 .Tn UNIX 도메인 소켓 .Pa /var/run/log, .Pa /etc/services 그리고 지정되는 인터넷 도메인 소켓 및 특수 디바이스 .Pa /dev/klog (커널 메세지를 읽기 (위해)때문에)(으)로부터 메세지를 읽어들입니다. .Pp .Nm 유틸리티는 프로세스 ID 파일, 디폴트에서는 .Pa /var/run/syslog.pid (을)를 작성해, 여기에 프로세스 ID 를 기록합니다. 이것은 .Nm (을)를 kill 나, 설정 파일을 읽어들이게 하기 위해서(때문에) 사용할 수 있습니다. .Pp .Nm 에 보내지는 메세지는 단일의 행으로 구성됩니다. 이 메세지는 선두에 우선 순위 코드를 포함하고 있습니다. 이 코드는 .Sq Aq 5 (와)과 같이 괄호로 묶어진 10 진수로부터 구성되어 있어 인클루드 파일 .Aq Pa sys/syslog.h 그리고 정의되고 있는 우선 순위에 대응합니다. .Pp 보안상의 이유로부터, .Nm (은)는 존재하지 않는 로그 파일에 추가 기입하지 않습니다. .Nm 의 기동전에 수동으로 작성할 필요가 있습니다. .Sh 관련 파일 .Bl -tag -width /var/run/syslog.pid -compact .It Pa /etc/syslog.conf 배치 파일 .It Pa /var/run/syslog.pid 디폴트의 프로세스 ID 파일 .It Pa /var/run/log .Tn UNIX 도메인 데이터 그램의 로그용 소켓의 이름 .It Pa /dev/klog 커널 로그용의 디바이스 .El .Sh 관련 항목 .Xr logger 1 , .Xr syslog 3 , .Xr services 5 , .Xr syslog.conf 5 .Sh 역사 .Nm 유틸리티는 .Bx 4.3 (으)로부터 등장했습니다. .Pp .Fl a , .Fl s , .Fl u , .Fl v 의 옵션은 .Fx 2.2 에 있어서의 확장입니다. .Sh 버그 UDP 패킷으로 받은 메세지를 기록하는 능력은 인증되어 있지 않다 디스크를 흘러넘치게 하는 리모트 서비스와 등가이며, 아마 디폴트로 무효에 되어야 합니다. 어떤 종류의 .Nm 사이의 인증 메카니즘이 준비되어야 하는 것이지요. 최악의 낭비를 피하기 위해서(때문에), .Fl a 옵션의 사용을 강하게 권합니다. .Pp .Fl a 의 매칭 알고리즘은 매우 효율적으로는 보이지 않습니다; 도메인명 비교보다, 수치에 의한 IP 주소를 사용하는 (분)편이 고속으로. 허가된 피어의 리스트의 검색은 선형에 행해지기 (위해)때문에, 많은 메세지를 받아들인다고 예측되는 같은 세대의 집단은 .Fl a 리스트의 최초(분)편에 두어야 합니다. .Pp 로그용 소켓은 읽어들여 전용의 루트 파일 시스템의 취급을 용이하게 한다 위해(때문에) .Pa /dev (으)로부터 옮겨졌습니다. 이것은 낡은 바이너리를 혼란시킬지도 모르기 때문에, 과도기의 사이는 기호 연결이 도움이 되겠지요.