show clock サブコマンド¶
概要¶
show clock は システム日時の表示と、利用可能なタイムゾーン一覧の表示を提供する click グループ。invoke_without_command=True で宣言されており、サブコマンド省略時はそのままグループ本体が date コマンドを起動する1。タイムゾーン設定の 書き込み側は config clock 配下にある(本ページではスコープ外)。
コマンド一覧¶
| コマンド | 実装 | 起動コマンド |
|---|---|---|
show clock |
show/main.py:clock() (group, no-subcommand 時) |
date |
show clock timezones |
show/main.py:timezones() |
timedatectl list-timezones |
詳細¶
show clock¶
サブコマンドが指定されない場合、run_command(['date']) を実行するのみ1。Linux の date(1) の出力をそのまま流す。
--verbose フラグは click グループ本体に付いており、付けると実行コマンド文字列を stderr に echo する。
show clock timezones¶
timedatectl list-timezones を起動。systemd-timesyncd / systemd-timedated が提供する IANA タイムゾーン名リスト(Asia/Tokyo America/New_York 等)を逐次出力する。
このコマンドは 読み取り専用で、CONFIG_DB には触らない。実際にタイムゾーンを設定するには sudo config clock timezone <tz> を使う(CONFIG_DB の DEVICE_METADATA|localhost に timezone キーを書き込み、hostcfgd が timedatectl set-timezone を起動する仕組み)。
CONFIG_DB との接点¶
| テーブル | 操作 |
|---|---|
| なし(read-only) | show clock は CONFIG_DB を読まない |
データフロー (手動作成)¶
flowchart LR
CLI["show clock / show clock timezones"]
DC["date / timedatectl list-timezones"]
SYS["/etc/timezone / systemd-timedated"]
CLI --> DC
DC --> SYS
凡例
show 系 (CLI → date/timedatectl) のミニ図。CONFIG_DB を直接介さないコマンドのため手動で記述。
関連リファレンス¶
- (関連リンクなし)
引用元¶
関連 CLI コマンド¶
config clock— config clock サブコマンドconfig banner— config banner サブコマンドconfig kdump— config kdump サブコマンドconfig ntp— config ntp サブコマンドconfig platform firmware— config platform firmware サブコマンド
-
clockグループの定義はshow/main.pyL2222-L2238。https://github.com/sonic-net/sonic-utilities/blob/39732bceb8bdefe706518ab40623bbbba6ff33b9/show/main.py#L2222 ↩↩