.\" .\" %FreeBSD: src/usr.sbin/ntp/doc/ntpdate. 8, v 1.6 2002/07/14 14:44:40 charnier Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man8/ntpdate. 8, v 1.10 2002/11/18 06:17:44 horikawa Exp $ .Dd January 6, 2000 .\" WORD: key identifier 열쇠의 식별자 .\" WORD: key file 열쇠 파일 .\" WORD: slew 미조정한다 (slue 의 과거·과거분사형) .\" WORD: step 맞춘다 .\" WORD: clock 시계 .\" WORD: time 시각 .\" WORD: seconds and fraction 초수 (소수도 가능) .\" .Dd January 6, 2000 .Dt NTPDATE 8 .Os .Sh 명칭 .Nm ntpdate .Nd NTP 를 개입시켜 일자와 시각을 설정한다 .Sh 서식 .Nm .Op Fl bBdqosuv .Op Fl a Ar key .Op Fl e Ar authdelay .Op Fl k Ar keyfile .Op Fl o Ar version .Op Fl p Ar samples .Op Fl t Ar timeout .Ar server ... .Sh 해설 .Em 주의 : 이 프로그램의 기능은, 지금은 .Xr ntpd 8 프로그램 중(안)에서 이용 가능해지고 있습니다. .Xr ntpd 8 메뉴얼 페이지의 .Fl q 명령행 옵션의 설명을 참조해 주세요. 적절한 기간, 상에 복종한 다음에, .Nm 유틸리티는 본디스트리뷰션으로부터 은퇴하게 됩니다. .Pp .Nm 유틸리티는, 정확한 시각을 결정하기 위해서(때문에) .Ar server 인수로 주어졌다 네트워크 타임 프로토콜 (Network Time Protocol; NTP) 서버 (복수가능)를 조사하는 것에 의해, 로컬인 일자와 시각을 설정합니다. 이 명령은, 로컬 호스트의 root 로서 기동되지 않으면 안됩니다. 지정된 각 서버로부터 많은 샘플을 얻어, NTP 시계 필터의 부분집합과 선택 알고리즘을 적용해, 그 중에서 최선의 것을 선택합니다. .Nm 의 정확함과 신뢰성은 서버의 수, 1 실행 근처의 조사수, 그리고 실행 간격으로 정해지는 것에 주의해 주세요. .Pp 이하의 옵션이 사용 가능합니다: .Bl -tag -width indent .It Fl a Ar key 인증 기능을 유효하게 해, 인증의 열쇠 식별자를 .Ar key 인수로 지정합니다. 열쇠와 열쇠의 식별자는 클라이언트와 서버 쌍방의 열쇠 파일로 합치할 필요가 있습니다. 디폴트에서는 인증 기능은 무효가 되어 있습니다. .It Fl B 계측 된 오프셋(offset)가± 128 ms 보다 커도, 시각을 항상 .Xr adjtime 2 시스템 콜을 이용해 미조정하도록, 강제합니다. 디폴트에서는 오프셋(offset)가± 128 ms 보다 큰 경우는, .Xr settimeofday 2 (을)를 이용해 늦춥니다. 오프셋(offset)가± 128 ms 보다 큰 경우는, 시계를 올바른 값에 미조정으로 맞추는데 긴 시간 (수시간) 걸리는 일이 있는 것에 주의해 주세요. 이전은, 클라이언트를 동기 하기 위해서 이 호스트를 사용해서는 안됩니다. .It Fl b (디폴트의) .Xr adjtime 2 시스템 콜을 이용해 시각을 미조정하는 것이 아니라, .Xr settimeofday 2 시스템 콜을 이용해 시각을 맞추도록, 강제합니다. 이 옵션은 부트시에 기동 파일로부터 호출할 때는 사용해야 합니다. .It Fl d 디버그 모드를 유효하게 합니다. .Nm (은)는 모든 스텝을 실행합니다만, 로컬 시계를 맞추는 것은 하지 않습니다. 일반적인 디버그에 도움이 되는 정보도 표시합니다. .It Fl e Ar authdelay 인증 기능의 처리에 걸리는 지연을 .Ar authdelay 에 값을 초수 (소수도 가능)로 지정합니다 (자세한 것은 .Xr ntpd 8 (을)를 참조해 주세요). 이 값은 통상 많은 용도에서는 무시 할 수 있는 만큼 불과입니다만, 매우 늦은 CPU 에서는 이 수를 지정하는 것으로, 시간의 정확함이 개선될지도 모릅니다. .It Fl k Ar keyfile 인증열쇠의 파일에의 패스를 캐릭터 라인으로 .Ar keyfile (으)로 지정합니다. 디폴트는 .Pa /etc/ntp.keys 입니다. 이 파일은 .Xr ntpd 8 에 기술되고 있는 형식에서 쓸 필요가 있습니다. .It Fl o Ar version 밖에 내는 패킷의 NTP 버젼을 .Ar version 에 1 이나 2 의 정수로 지정합니다. 디폴트는 3 입니다. 이 옵션은 .Nm (을)를 낡은 버젼의 NTP 에 대해서 사용할 수 있도록(듯이) 합니다. .It Fl p Ar samples 각 서버로부터 얻는 샘플의 수를 .Ar samples 에 1 에서 8 까지의 정수로 지정합니다. 디폴트는 4 입니다. .It Fl q 문의를 하는 것만으로, 시계를 설정하지 않습니다. .It Fl s (디폴트의) 표준 출력이 아니고, .Xr syslog 3 기능을 사용해 로그 출력을 행합니다. 이 기능은 주로 .Xr cron 8 스크립트에서의 편리성을 생각해 만들어졌습니다. .It Fl t Ar timeout 서버의 응답을 기다리는 최대 시간을 .Ar timeout 에 초수 (소수도 가능)로 지정합니다. 값은 0.2 초의 배수에 말 수 있습니다. 디폴트는 1 초로, 이것은 LAN 를 통해서 조사하는데 적당한 값입니다. .It Fl u .Nm 하지만 밖에 내는 패킷을 비특권 포트로부터 내도록(듯이) 인스트럭션 합니다. 이 기능은, 밖으로부터 온 특권 포트에의 트래픽을 블록 하는 방화벽의 안쪽에 있는 경우에, 방화벽을 넘은 저 편의 호스트와 동기 할 때에 가장 편리합니다. .Fl d 옵션은 항상 비특권 포트를 사용하는 것에 주의해 주세요. .It Fl v 장황하게 됩니다. 이 옵션은 .Nm 의 버젼 식별 캐릭터 라인을 기록하게 됩니다. .El .Pp .Nm 유틸리티는, 필요에 따라서 호스트의 시계를 맞추기 위해서(때문에) 수동으로 움직이거나 부트시에 시계를 설정하기 위해서 기동 스크립트 중에서 움직일 수가 있습니다. 이것은 NTP demon .Xr ntpd 8 (을)를 기동하기 전에 시계를 초기설정 하는 경우에 편리합니다. .Nm 하 .Xr cron 8 스크립트로부터 기동하는 일도 가능합니다. 그러나, .Nm (을)를 이용했다 .Xr cron 8 스크립트를 궁리해도, 최소한의 리소스 소비로 최대의 정확함과 신뢰성을 얻는다 세련된 알고리즘을 이용하는 NTP demon 대신에는 안 되는 것에 주의하는 것이 중요합니다. 마지막으로, .Nm 하 .Xr ntpd 8 하지만 하는 것 같은 호스트의 클럭 주파수의 학습을 하지 않기 때문에, .Nm (을)를 이용하는 것에 의한 정확함은 한정됩니다. .Pp .Nm (은)는 2 개의 방법 중 1 개로 시각의 조정을 실시합니다. .Nm (은)는, 시계가 0.5 초 이상 어긋나 있다고 판단하면(자), 시스템의 .Xr settimeofday 2 routine를 부르는 것으로 단지 시각을 다시 맞춥니다. 그러나, 오차가 0.5 초 이내 때는, 시스템의 .Xr adjtime 2 routine를 부르는 것으로, 시각을 미조정합니다. 후자의 테크닉은, 오차가 작을 때에는, 보다 매끄러운 위에 정확하고, .Nm (을)를 .Xr cron 8 그리고 1 ~ 2 시간에 1회 움직일 때는, 꽤 잘 일합니다. .Pp .Nm 유틸리티는 같은 호스트로 NTP 서버 demon (예를 들면 .Xr ntpd 8 ) 하지만 움직이고 있는 경우는, 일자의 설정을 거부합니다. demon를 실행하는 대신에 .Xr cron 8 (으)로부터 정기적으로 .Nm (을)를 호출하는 경우는, 1 ~ 2 시간에 1회 행하면(자) 시계의 차이를 억제하는데 충분한 정확한 시각을 보관 유지할 수 있습니다. .Pp .Nm 하지만 NetInfo 서포트를 포함한 형태로 컴파일 되고 있었을 경우, .Nm 하지만 .Xr ntpd 8 용무의 NetInfo 의 설정으로부터 시각 서버를 찾아낼 수 있는 경우는 .Ic server 인수는 옵션이 됩니다. .Sh 관련 파일 .Bl -tag -width /etc/ntp.keys -compact .It Pa /etc/ntp.keys .Nm 그리고 사용되는 암호화열쇠를 포함합니다. .El .Sh 관련 항목 .Xr ntpd 8 .Sh 버그 미조정에 의한 조정은, 실제로는, 계측 된 차이보다 50% 커집니다. 이것은, 몹시 휘청휘청 하는 시계를 보다 정확하게 보관 유지하는데 도움이 되기 때문입니다 (라고 주장되고 있습니다). 이것은 좋은 생각은 아닐지도 모르고, 커널 변수 .Va kern.clockrate.tick (와)과 .Va kern.clockrate.tickadj 의 값을 이상하게 할지도 모릅니다.