ytooyamaのブログ

サーバ構築とか、仕事で発見したこととか、趣味のこととかを書いています。

macOS 11のsntpコマンドのman翻訳版(非公式)

macOS 11のsntpコマンドのman翻訳版(非公式)です。 よく使うのですが使うたびに忘れるので、個人ブログに貼っておきます。

マニュアルの利用方法ではsntpコマンドをそのまま実行していますが、実際使うときは管理権限が必要なので、 sudo sntp -sS time.asia.apple.com のように実行するのが適切です。サーバーはIPかFQDN名で指定します。サーバーによってNTPサーバーはたまにタイムアウトを返してくることがあります。エラーが発生した場合はNTPサーバーと同期されていません。

実行例

% sudo sntp -sS time.asia.apple.com
Password:
sntp: Exchange failed: Timeout
sntp: Exchange failed: Timeout
-0.017400 +/- 0.000198 time.asia.apple.com 17.253.68.251

一般的には、「システム環境設定の日付と時刻」のGUIで設定する方が簡単です。

以下、sntpコマンドのマニュアルの参考訳です。

SNTP(1) BSD General Commands Manual   SNTP(1)

名前
     sntp  --  非常にシンプルなネットワークタイムプロトコルクライアントプログラム

概要
     sntp [-drSs] [-g ミリ秒] [-t 秒] ホスト名またはIP

説明
     -d       デバッグログを有効にします。

     -g  ミリ秒
              ミリ秒単位のリクエストの間隔。

     -r       送信元通信用にNTP予約ポート(123)をbind(2)します。 

     -S       オフセットが50ミリ秒より大きい場合は、settimeofday(2)を使用してシステムクロックを設定します。

     -s       オフセットが50ミリ秒未満の場合は、adjtime(2)を使用してシステムクロックをスルーします。

     -t  秒
              応答を待機する最大秒数。

利用方法
     sntp pool.ntp.org

関連項目
     settimeofday(2)、adjtime(2)、timed(8)、

歴史
     このsntpは、Network TimeFoundationのsntp実装と混同しないでください。これは、互換性のために機能の最小限のサブセットをサポートする単純化されたクライアントです。

     このsntpは、macOS 10.16 (訳注: macOS 11 Big Sur) で最初に登場しました。 

Darwin                          August 8, 2021                          Darwin

このブログサイトはJavaScriptを使っていますが、読み込んでいるJavaScriptは全てはてなが提供しているものであり、筆者が設置しているものではありません。