NEWSYSLOG(8)

명칭
newsyslog - 시스템의 로그 파일을 메인트넌스해, 적절한 사이즈에 유지한다

서식
newsyslog [-Fnrv] [-f config_file] [-a directory] [file ...]

해설
newsyslog 유틸리티는 cron(8) (으)로부터 정기적으로 실행되도록(듯이) 스케줄 되어야 할 프로그램입니다. 실행되면(자), newsyslog (은)는 필요에 따라서 로그 파일을 보존 (아카이브(archive))합니다. 어느 로그 파일을 보존할 필요가 있다고 판단하면(자), “logfile” 하지만 비워, “logfile. 0” 에 전회의 로그 파일이 들어가, “logfile. 1” 에 전전번의 로그가 들어가‥‥ 와 같은 정도에, 유저가 지정한 수의 보존 로그가 남도록, newsyslog (은)는 파일을 재편합니다. 옵션에 의해, 보존 로그를 압축해 스페이스를 절약할 수도 있습니다.

로그가 보존되는 경우에는 3 개의 이유가 있습니다:

1.  로그가 설정 사이즈 (킬로바이트수)보다 커졌다.

2.  전회 로그를 보존하고 나서 지정한 시간이 경과했다.

3.  로그 교체를 실시하는 지정 시간이다.

newsyslog 의 입도는, 이 명령이 cron(8) (으)로부터 어느 정도의 빈도로 실행될까에 의존하고 있습니다. newsyslog 의 실행은 충분히 빠르기 때문에, 매시간 실행하도록(듯이) 스케줄 해도 악영향은 않고, 제 3 의 모드 (전술)는 그렇게 되고 있는 것을 가정하고 있습니다.

기동되면(자), newsyslog (은)는 설정 파일을 읽어들여, 어느 로그 파일이 잠재적으로 보존될 수 있는인지를 결정합니다. 디폴트에서는, 이 설정 파일은 /etc/newsyslog.conf 입니다. 설정 파일의 각 행에는, newsyslog 하지만 처리해야 할 특정의 로그 파일에 관한 정보를 기술합니다. 각 행은 5 개의 필수 필드와 4 개의 옵션필드로부터 되어, 그것들은 공백에서 단락지어지고 있습니다. 공행이나 ``#''로 시작되는 행은 무시됩니다. 설정 파일의 각 필드는 이하와 같습니다:

logfile_name
    보존하는 시스템 로그 파일명.

owner:group
    이 필드는 옵션이며, 보존 파일의 소유자와 그룹명을 지정합니다. owner 혹은 group 하지만 공백인 채인 경우에서도 ":" 는 필수입니다. 지정은 수치, 혹은 /etc/passwd 인가 /etc/group 에 있는 이름으로 실시합니다.

mode
    로그 파일과 보존 로그 파일의 모드를 지정합니다.

count
    로그 파일 그 자체에 가세해 보존해 두는 보존 파일의 수를 지정합니다.

size
    로그 파일의 사이즈가 size 킬로바이트에 이르면(자), 로그 파일은 상기와 같이 바꿔 넣을 수 있습니다. 이 필드가 asterisk (‘*’) 그리고 옮겨놓을 수 있으면(자), 로그 파일 교체에 즈음하여 그 사이즈는 고려되지 않게 됩니다.

when
    when 필드는, 인터벌, 특정의 시각, 혹은 양쪽 모두입니다. when 필드가 asterisk (‘*’) 의 경우, 로그 교체는 size 필드에게만 의존합니다. 그렇지 않은 경우, when 필드는, 옵션의, 시간 단위의 인터벌로부터 됩니다. 이것에 이어, 단일의 ‘@’ 기호와 제한되었다 ISO 8601 포맷으로 시각을 지정할 수도 있고, 단일의 ‘$’ 기호와 시각을 지정해, 날에 1 회나 주에 1 회개월에 1 회가 정해졌을 때 각에 로그 파일을 바꿔 넣도록(듯이) 지정할 수도 있습니다.

    시각을 지정하면(자), 지정했을 때 각의 1 시간 이내에 newsyslog 하지만 실행되었을 경우만, 로그 파일을 바꿔 넣습니다. 인터벌 시간이 지정되었을 경우, 마지막 교체로부터 그 시간수가 경과했을 경우에, 로그 파일을 바꿔 넣습니다. 시각과 인터벌의 양쪽 모두가 지정되었을 경우, 교체가 실행되려면 , 양쪽 모두의 조건이 채워지는 것이 필요합니다.

    타임 존은 지정할 수 없습니다. 현재의 실장에서는, 명확하게 분이나 초의 부분을 지정하는 것은, 거의 할 수 없습니다. 「1 시간 이내」인 것 마셔, 비교하기 때문입니다.

    ISO 8601 제한부 시각 포맷

    제한부 ISO 8601 시각의 선행 캐릭터는 ‘@’ 기호입니다. 제약부 ISO 8601 포맷에서의 특정의 시각의 지정은 다음과 같습니다: [ [ [ [ [ cc] yy] mm] dd] [ T [ hh [ mm [ ss]]]] ]입니다. 일자 필드는 옵션이며, 디폴트는 현재의 일자의 적절한 부분입니다. 시각 필드는 옵션이며, 디폴트는 심야입니다. 따라서, 오늘이 1999 년 1 월 22 일의 경우, 다음날 부 지정은 모두 동등합니다:

    ‘19990122T000000’
    ‘990122T000000’
    ‘0122T000000’
    ‘22T000000’
    ‘T000000’
    ‘T0000’
    ‘T00’
    ‘22T’
    ‘T’
    ‘’

    일·주·월의 시각 포맷

    일·주·월의 시각 포맷의 선행 캐릭터는 ‘$’ 기호입니다. 일·주·월의 지정의 특정의 포맷은 각각 다음과 같습니다: [Dhh], [Ww[Dhh]], [Mdd[Dhh]] 옵션의 시각 필드의 디폴트는, 심야입니다. 날과 시간의 지정의 범위는 다음과 같습니다:

    hh  시간이며, 0 에서 23 의 범위
    w   요일이며, 0 에서 6 의 범위에서, 0 이 일요일
    dd  날이며, 1 에서 31 의 범위인가, 마지막 날을 지정하기 위한 캐릭터 L 또는 l

    이하에 예를 나타냅니다:

    $D0 매일 저녁 심야로 바꾸어 넣습니다 (@T00 (와)과 같습니다)
    $D23
        매일 저녁 23:00 으로 바꾸어 넣습니다 (@T23 (와)과 같습니다)
    $W0D23
        매주 일요일의 것 23:00 으로 바꾸어 넣습니다
    $W5D16
        매주 금요일의 것 16:00 으로 바꾸어 넣습니다
    $M1D0
        매월 최초일의 심야로 바꾸어 넣습니다 (그 날의 개시시점입니다; @01T00 (와)과 같습니다)
    $M5D6
        매월 5 일의 것 6:00 으로 바꾸어 넣습니다 (@05T06 (와)과 같습니다)

flags
    이 필드는 옵션이며, 보존에 즈음하여 로그 파일에 특별한 처리를 실시하는지 어떤지를 지정합니다. Z 플래그를 지정하면(자), 스페이스 절약을 위해서(때문에) 보존 파일은 gzip(1) 그리고 압축됩니다. J 플래그를 지정하면(자), 스페이스 절약을 위해서(때문에) 보존 파일은 bzip2(1) 그리고 압축됩니다. B 플래그는 파일이 바이노리필드인 것을 지시해, 로그 파일이 (*교대)교체했다고 하는 의미로 newsyslog 하지만 삽입한다 ASCII 메세지를 포함하지 않게 합니다. - (은)는 아무것도 의미합니다만, path_to_pid_file 필드가 지정되었을 경우에는 여백을 메우는기사로서 사용 가능합니다.

path_to_pid_file
    이 옵션의 필드는, demon의 프로세스 ID 를 조사하기 위해서(때문에) 읽는 파일을 지정합니다. 이 필드가 존재하는 경우, 이 파일에 쓰여진 프로세스 ID 에 signal_number 하지만 보내집니다. 올바르게 인식하기 위해서, 이 필드는 "/" 으로부터 개시할 필요가 있습니다.

signal_number
    이 옵션필드는, demon 프로세스에 보내지는 시그널 번호를 지정합니다. 디폴트로 SIGHUP 가 보내집니다.

옵션
newsyslog 그럼 이하의 옵션을 이용할 수 있습니다:

-f config_file
    설정 파일로서 /etc/newsyslog.conf 에 대신해 config_file (을)를 사용합니다.

-a directory
    아카이브(archive) 한 로그 파일을 기입한다 directory (을)를 지정합니다. 상대 패스를 지정했을 경우, 이것을 각 로그 파일의 패스에 후치 한 디렉토리에, 이 로그 파일의 아카이브(archive) 로그를 기입합니다. 절대 패스를 지정했을 경우, 모든 아카이브(archive) 로그는 지정했다 directory 에 기입해집니다. 패스 directory 의 컴퍼넌트가 존재하지 않는 경우, newsyslog 하지만 실행될 때 생성됩니다.

-v  newsyslog (을)를 상세 정보 출력 모드로 합니다. 이 모드에서는, 로그를 바꿔 넣는 혹은 그것을 스킵 할 때마다, 그 로그 파일명과 이유를 표시합니다.

-n  실제로 로그의 교체 하행원않다, 이 옵션이 지정되지 않는 경우에 본래 실시해야할 처리 내용을 표시합니다.

-r  newsyslog (은)는 root 로서 동작해야 하는, 이라고 하는 제약을 없앱니다. 물론, newsyslog 하 syslogd(8) 에 HUP 시그널을 보낼 수 없게 되기 때문에, 이 옵션은 디버그에게만 이용해야 합니다.

-F  로그를 바꿔 넣는 조건에 합치하지 않는다고 해도, 강제적으로 newsyslog 에 로그를 바꿔 넣게 합니다. 시스템의 문제를 진단하고 있을 때는, 이 옵션의 사용에 의해, 문제만을 포함한 새로운 로그를 제공할 수 있으므로 유용합니다.

추가의 명령행 인수를 지정하면(자), newsyslog (은)는 이러한 인수에 매치 하는 로그 파일만을 검사합니다. 그렇지 않은 경우, 설정 파일에 열거된 전파일을 검사합니다.

관련 파일
/etc/newsyslog.conf
    newsyslog 의 설정 파일

버그
보안 침해를 찾아내기 위해서(때문에) 로그를 자동적으로 읽는 것은, 아직 가고 있지 않습니다.

저자
Theodore Ts'o, MIT Project Athena

Copyright 1987, Massachusetts Institute of Technology

호환성
이전의 버젼의 newsyslog 유틸리티는, 그룹명의 식별로 닷 (``. '')를 사용하고 있었습니다. FreeBSD 3.3 (으)로부터는, 이것은 코론 (``:'') 캐릭터가 되었으므로, 유저명과 그룹명에 닷 캐릭터를 포함하는 것이 가능합니다. 후방 호환성을 위해서(때문에), 닷 (``. '') 캐릭터는 아직 받아들일 수 있습니다.

관련 항목
gzip(1), syslog(3), chown(8), syslogd(8)