Man page - dmesg(1)

Packages contains this manual

Available languages:

en pl tr ja uk ro sr de

Manual

DMESG

名 前
書 式
説 明
オ プ シ ョ ン
カ ラ ー 表 示
終 了 ス テ ー タ ス
作 者
関 連 項 目
入 手 方 法

名 前

dmesg - カ ー ネ ル の (ロ グ 用 ) リ ン グ バ ッ フ ァ の 表 示 や 制 御 を 行 う

書 式

dmesg [options]

dmesg --clear
dmesg --read-clear [options]
dmesg --console-level level
dmesg --console-on
dmesg --console-off

説 明

dmesg は 、 カ ー ネ ル の リ ン グ バ ッ フ ァ を 調 べ た り 、 制 御 し た り す る た め に 使 用 す る 。

デ フ ォ ル ト の 動 作 は 、 カ ー ネ ル の リ ン グ バ ッ フ ァ に あ る す べ て の メ ッ セ ー ジ を 表 示 す る こ と で あ る 。

オ プ シ ョ ン

--clear , --read-clear , --console-on , --console-off , --console-level は 、 ど れ か 一 つ し か 使 え な い 。
-C , --clear

リ ン グ バ ッ フ ァ を ク リ ア す る 。

-c , --read-clear

ま ず リ ン グ バ ッ フ ァ の 内 容 を 表 示 し 、 そ の 後 で ク リ ア す る 。

-D , --console-off

コ ン ソ ー ル へ の メ ッ セ ー ジ 出 力 を 抑 止 す る (訳 注 : た だ し emergency レ ベ ル の メ ッ セ ー ジ だ け は 表 示 す る )。

-d , --show-delta

タ イ ム ス タ ン プ (訳 注 : ブ ー ト か ら の 経 過 秒 数 を マ イ ク ロ 秒 ま で 表 示 ) と と も に 、 前 の メ ッ セ ー ジ 出 力 か ら 経 過 し た 時 間 の 増 分 (time delta) を 表 示 す る 。 --notime と 一 緒 に 使 用 し た 場 合 は 、 タ イ ム ス タ ン プ は 省 略 し て 、 時 間 の 増 分 だ け を 表 示 す る 。

-E , --console-on

コ ン ソ ー ル へ の メ ッ セ ー ジ 出 力 を 有 効 に す る 。

-e , --reltime

ロ ー カ ル タ イ ム と 時 間 の 増 分 を 人 間 に 読 み や す い フ ォ ー マ ッ ト で 表 示 す る 。 ロ ー カ ル タ イ ム へ の 変 換 は 不 正 確 か も し れ な い こ と を 、 ご 承 知 い た だ き た い (詳 し く は -T を 参 照 )。

-F , --file file

指 定 さ れ た フ ァ イ ル file か ら syslog の メ ッ セ ー ジ を 読 み 込 む 。 -F は 、 kmsg フ ォ ー マ ッ ト の メ ッ セ ー ジ を サ ポ ー ト し て い な い こ と に 気 を つ け て い た だ き た い 。 サ ポ ー ト し て い る の は 、 昔 な が ら の syslog フ ォ ー マ ッ ト だ け で あ る 。

-f , --facility list

出 力 を 指 定 さ れ た フ ァ シ リ テ ィ の (コ ン マ で 区 切 っ た ) リ ス ト に 限 定 す る 。 た と え ば 、

dmesg --facility=daemon

は 、 シ ス テ ム デ ー モ ン の メ ッ セ ー ジ の み を 表 示 す る 。 ど ん な フ ァ シ リ テ ィ が サ ポ ー ト さ れ て い る か に つ い て は 、 --help の 出 力 を ご 覧 い た だ き た い 。

-H , --human

人 間 に 読 み や す い 出 力 に す る 。 --color , --reltime , --nopager も 参 照 。

-k , --kernel

カ ー ネ ル メ ッ セ ー ジ を 表 示 す る (訳 注 : つ ま り 、 フ ァ シ リ テ ィ が kern の メ ッ セ ー ジ の み を 表 示 す る )。

-L , --color [= when ]

出 力 を カ ラ ー 表 示 に す る 。 指 定 が 任 意 の 引 き 数 when に は 、 auto , never , always が 使 え る 。 引 き 数 when が 省 略 さ れ た 場 合 は 、 デ フ ォ ル ト の auto が 使 用 さ れ る 。 カ ラ ー 表 示 は 無 効 に す る こ と も で き る 。 プ ロ グ ラ ム に 埋 め 込 ま れ た 現 在 の デ フ ォ ル ト が 有 効 か 無 効 か を 知 る に は 、 --help の 出 力 を 見 れ ば よ い 。 下 記 の 「 カ ラ ー 表 示 」 セ ク シ ョ ン も ご 覧 い た だ き た い 。

-l , --level list

出 力 を 指 定 さ れ た レ ベ ル (訳 注 : 重 大 度 、 緊 急 度 ) の (コ ン マ で 区 切 っ た ) リ ス ト に 限 定 す る 。 た と え ば 、

dmesg --level=err,warn

は 、 error と warning メ ッ セ ー ジ の み を 表 示 す る 。 ど ん な レ ベ ル が サ ポ ー ト さ れ て い る か に つ い て は 、 --help の 出 力 を ご 覧 い た だ き た い 。

-n , --console-level level

コ ン ソ ー ル に 出 力 さ れ る ロ グ メ ッ セ ー ジ の レ ベ ル (重 大 度 ) を level に 設 定 す る 。 level に 指 定 す る の は 、 数 値 の レ ベ ル か 、 レ ベ ル の 名 称 の 短 縮 形 で あ る 。 ど ん な レ ベ ル が サ ポ ー ト さ れ て い る か に つ い て は 、 --help の 出 力 を ご 覧 い た だ き た い 。

[ 訳 注 ]

現 在 使 用 中 の コ ン ソ ー ル (X 上 の 端 末 エ ミ ュ レ ー タ で は な い ) に 自 動 的 に 表 示 さ れ る メ ッ セ ー ジ が 、 指 定 し た レ ベ ル 以 上 の 重 大 度 を 持 つ も の に な る 。 数 値 に よ る 指 定 の 場 合 は 、 そ の 数 値 を 含 ま な い 、 そ れ よ り 重 大 な (つ ま り 、 数 値 が 小 さ い ) レ ベ ル の メ ッ セ ー ジ が 表 示 さ れ 、 名 称 に よ る 指 定 の 場 合 は 、 そ の 名 称 を 含 む 、 そ れ 以 上 の 重 大 度 の メ ッ セ ー ジ が 表 示 さ れ る よ う に な る 。 レ ベ ル の 数 値 に つ い て は 、 syslog (2) を 参 照 。

た と え ば 、 -n 1 や -n emerg を 指 定 す る と 、 emergency (panic) 以 外 の す べ て の メ ッ セ ー ジ が 、 コ ン ソ ー ル に 表 示 さ れ な く な る 。 と は 言 え 、 す べ て の レ ベ ル の メ ッ セ ー ジ が /proc/kmsg に 書 き 込 ま れ る こ と に 変 わ り は な い の で 、 カ ー ネ ル メ ッ セ ー ジ を ど こ に 出 力 す る か は 、 や は り syslogd (8) 使 っ て 、 き ち ん と コ ン ト ロ ー ル す る こ と が で き る 。 な お 、 -n オ プ シ ョ ン を 使 用 し た と き 、 dmesg が カ ー ネ ル の リ ン グ バ ッ フ ァ を 表 示 し た り 、 ク リ ア し た り す る こ と は な い (訳 注 : こ の -n オ プ シ ョ ン は 、 コ ン ソ ー ル に 自 動 的 に 表 示 さ れ る メ ッ セ ー ジ の レ ベ ル を 設 定 す る だ け で あ る )。

--noescape

非 表 示 文 字 や 問 題 を 起 こ し か ね な い 文 字 (た と え ば 、 破 損 し た マ ル チ バ イ ト シ ー ケ ン ス や 、 端 末 制 御 文 字 な ど ) は 、 デ フ ォ ル ト で は セ キ ュ リ テ ィ 上 の 理 由 か ら \x<hex> の 形 式 で エ ス ケ ー プ さ れ る よ う に な っ て い る 。 こ の オ プ シ ョ ン は そ の 機 能 を 完 全 に 無 効 に す る 。 こ の オ プ シ ョ ン は 、 た と え ば --raw と 併 せ て 、 デ バ ッ グ の た め に 使 用 で き る 。 使 用 に は 気 を 付 け る こ と 。 デ フ ォ ル ト で 使 う よ う に し て は い け な い 。

-P , --nopager

出 力 を パ イ プ で ペ ー ジ ャ ー に 渡 さ な い 。 --human の 出 力 で は 、 ペ ー ジ ャ ー は デ フ ォ ル ト で 使 用 さ れ る 。

-p , --force-prefix

複 数 行 メ ッ セ ー ジ の 各 行 に フ ァ シ リ テ ィ 、 レ ベ ル 、 タ イ ム ス タ ン プ の 情 報 を 付 け 加 え る 。

-r , --raw

メ ッ セ ー ジ バ ッ フ ァ を 未 加 工 (raw) の ま ま 表 示 す る 。 す な わ ち 、 ロ グ レ ベ ル を 表 す 接 頭 辞 を 取 り 除 か な い 。 た だ し 、 す べ て の 非 表 示 文 字 が エ ス ケ ー プ さ れ る こ と に は 変 わ り が な い ( --noescape も 参 照 )。

注 意 し て ほ し い が 、 実 際 の 未 加 工 フ ォ ー マ ッ ト は 、 dmesg (1) が カ ー ネ ル メ ッ セ ー ジ を 読 み 出 す 方 法 に よ っ て 違 っ て く る (訳 注 : す ぐ 下 の -S オ プ シ ョ ン や -F オ プ シ ョ ン の 説 明 も 参 照 )。 デ バ イ ス /dev/kmsg と syslog (2) で は 、 違 っ た フ ォ ー マ ッ ト を 使 っ て い る の で あ る 。 た だ し 、 後 方 互 換 の た め 、 dmesg は 、 常 に syslog (2) の フ ォ ー マ ッ ト で デ ー タ を 返 す よ う に な っ て い る 。 /dev/kmsg に あ る 本 当 の 未 加 工 デ ー タ は 、 た と え ば 、 ’dd if=/dev/kmsg iflag=nonblock’ と い っ た コ マ ン ド を 使 え ば 、 読 む こ と が で き る 。

-S , --syslog

カ ー ネ ル メ ッ セ ー ジ を 読 み 出 す の に 、 dmesg が syslog (2) の カ ー ネ ル イ ン タ ー フ ェ ー ス を 使 う よ う に す る 。 kernel 3.5.0 以 来 、 syslog (2) で は な く 、 /dev/kmsg を 使 用 す る の が デ フ ォ ル ト で あ る 。

-s , --buffer-size size

カ ー ネ ル の リ ン グ バ ッ フ ァ へ の 問 い 合 わ せ に 、 サ イ ズ size の バ ッ フ ァ を 使 用 す る 。 デ フ ォ ル ト で は 16392 で あ る 。 (デ フ ォ ル ト の カ ー ネ ル ・ シ ス ロ グ バ ッ フ ァ の サ イ ズ は 、 最 初 は 4096 だ っ た が 、 1.3.54 以 後 は 8192 に な り 、 2.1.113 以 来 16384 に な っ た 。 ) カ ー ネ ル バ ッ フ ァ を デ フ ォ ル ト よ り 大 き く 設 定 し て い る 場 合 に 、 バ ッ フ ァ を 全 部 見 る に は 、 こ の オ プ シ ョ ン を 使 え ば よ い 。

-T , --ctime

人 間 に 読 み や す い タ イ ム ス タ ン プ を 表 示 す る 。

「 こ の タ イ ム ス タ ン プ は 不 正 確 な こ と が あ る ！ 」 の を ご 承 知 い た だ き た い 。 ロ グ に 使 用 す る 、 タ イ ム ス タ ン プ の 元 に な る 情 報 (the time source) は 、 シ ス テ ム の サ ス ペ ン ド / レ ジ ュ ー ム 後 に 、 更 新 が 行 わ れ な い 。 更 新 が 行 わ れ な い の で 、 タ イ ム ス タ ン プ は 、 ブ ー ト タ イ ム と 単 調 増 加 ク ロ ッ ク (monotonic clocks) と の 間 の 現 在 の 増 分 (delta) に よ っ て 時 間 合 わ せ が な さ れ て い る の だ が 、 そ う し た 時 間 合 わ せ が 、 最 後 の レ ジ ュ ー ム 以 後 に 表 示 さ れ る メ ッ セ ー ジ 同 士 の 間 で し か う ま く 働 か な い の で あ る 。

[ 訳 注 ]

つ ま り 、 サ ス ペ ン ド / レ ジ ュ ー ム 直 後 の タ イ ム ス タ ン プ に つ い て は 、 時 間 合 わ せ が う ま く 行 か な い 。 言 葉 を 変 え る と 、 カ ー ネ ル ・ リ ン グ バ ッ フ ァ の タ イ ム ス タ ン プ で は 、 ブ ー ト タ イ ム と 実 稼 働 時 間 の み が 使 用 さ れ て お り 、 サ ス ペ ン ド 中 の 時 間 は 加 算 さ れ な い 。 そ れ 故 、 サ ス ペ ン ド 後 の dmesg の 日 時 表 示 は 信 用 で き な い と い う こ と で あ る 。

-t , --notime

カ ー ネ ル が 出 力 す る タ イ ム ス タ ン プ を 表 示 し な い 。

--time-format format

指 定 さ れ た フ ォ ー マ ッ ト format を 使 っ て 、 タ イ ム ス タ ン プ を 表 示 す る 。 format に は 、 ctime , reltime , delta , iso が 使 え る 。 最 初 の 三 つ は 、 そ れ ぞ れ の タ イ ム フ ォ ー マ ッ ト を 指 定 す る オ プ シ ョ ン (訳 注 : --ctime な ど ) の エ イ リ ア ス で あ り 、 iso フ ォ ー マ ッ ト は 、 ISO-8601 の タ イ ム ス タ ン プ フ ォ ー マ ッ ト の demsg に お け る 実 装 で あ る 。 こ の 最 後 の フ ォ ー マ ッ ト の 目 的 は 、 二 つ の シ ス テ ム 間 で の タ イ ム ス タ ン プ の 比 較 の よ う な 解 析 作 業 を 容 易 に す る こ と だ 。 iso タ イ ム ス タ ン プ は 、 YYYY-MM-DD<T>HH:MM:SS,<microseconds><-+><timezone offset from UTC> と い う 形 式 に な る 。

iso フ ォ ー マ ッ ト に も ctime と 同 じ 問 題 が あ る 。 す な わ ち 、 シ ス テ ム が サ ス ペ ン ド 、 レ ジ ュ ー ム し た 場 合 、 日 時 は 不 正 確 か も し れ な い の で あ る 。

-u , --userspace

ユ ー ザ 空 間 の メ ッ セ ー ジ を 表 示 す る 。

-w , --follow

新 し い メ ッ セ ー ジ が 出 力 さ れ る の を 待 つ 。 こ の 機 能 は 、 /dev/kmsg を 読 む こ と の で き る シ ス テ ム で の み サ ポ ー ト さ れ て い る (カ ー ネ ル 3.5.0 以 降 )。

-W , --follow-new

待 機 す る 。 そ し て 、 新 し い メ ッ セ ー ジ の み を 表 示 す る 。

-x , --decode

フ ァ シ リ テ ィ と レ ベ ル (重 大 度 ) の 番 号 を 人 間 に 分 か り や す い 接 頭 辞 に 変 換 す る 。

-V , --version

バ ー ジ ョ ン 情 報 を 表 示 し て 終 了 す る 。

-h , --help

ヘ ル プ を 表 示 し て 終 了 す る 。

カ ラ ー 表 示

自 動 的 な カ ラ ー 表 示 は 、 /etc/terminal-colors.d/dmesg.disable と い う 空 フ ァ イ ル を 作 る こ と で 無 効 に で き る 。 カ ラ ー 表 示 の 設 定 に つ い て も っ と 詳 し い こ と を 知 り た か っ た ら 、 terminal-colors.d (5) を ご 覧 に な る と よ い 。

dmesg は 、 以 下 の 論 理 カ ラ ー 名 を サ ポ ー ト し て い る 。

subsys

メ ッ セ ー ジ の サ ブ シ ス テ ム 接 頭 辞 (た と え ば 、 "ACPI")。

time

メ ッ セ ー ジ の タ イ ム ス タ ン プ 。

timebreak

--reltime や --human に お け る 出 力 メ ッ セ ー ジ の 、 短 い ctime フ ォ ー マ ッ ト で 表 現 し た タ イ ム ス タ ン プ 。

alert

ロ グ の 重 大 度 が alert の メ ッ セ ー ジ の テ キ ス ト 部 分 。

crit

ロ グ の 重 大 度 が critical の メ ッ セ ー ジ の テ キ ス ト 部 分 。

err

ロ グ の 重 大 度 が error の メ ッ セ ー ジ の テ キ ス ト 部 分 。

warn

ロ グ の 重 大 度 が warning の メ ッ セ ー ジ の テ キ ス ト 部 分 。

segfault

セ グ メ ン テ ー シ ョ ン フ ォ ー ル ト を 知 ら せ る メ ッ セ ー ジ の テ キ ス ト 部 分 。

終 了 ス テ ー タ ス

dmesg が 「 操 作 が 許 可 さ れ て い な い 」 旨 の エ ラ ー を 出 し て 、 実 行 に 失 敗 す る こ と が あ る 。 こ れ が 起 き る の は 、 た い て い 、 カ ー ネ ル の 設 定 dmesg_restrict の せ い で あ る 。 詳 し く は 、 syslog (2) を ご 覧 い た だ き た い 。

作 者

Karel Zak <kzak@redhat.com>

dmesg を 最 初 に 書 い た の は 、 Theodore Ts’o <tytso@athena.mit.edu> だ っ た 。

関 連 項 目

terminal-colors.d (5), syslogd (8)

入 手 方 法

こ の dmesg コ マ ン ド は 、 util-linux パ ッ ケ ー ジ の 一 部 で あ り 、 Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/> か ら 入 手 で き る 。