.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu) .\" May be distributed under the GNU General Public License .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .\" .\" Japanese Version Copyright (c) 1997 Koso Fukuba, .\" 1999 NAKANO Takeo, .\" 2001 Kentaro Shirakata, .\" and 2021 Chonan Yoichi, .\" all rights reserved. .\" Translated Mon Jan 27 12:00:00 JST 1997 .\" by Koso Fukuba .\" Updated & Modified Thu Oct 7 1999 .\" by NAKANO Takeo .\" Updated Mon Aug 20 JST 2001 .\" by Kentaro Shirakata .\" Updated & Modified (util-linux 2.36) Sun Feb 21 11:07:59 JST 2021 .\" by Chonan Yoichi .\" .TH DMESG 1 "July 2012" util\-linux "User Commands" .SH 名前 dmesg \- カーネルの (ログ用) リングバッファの表示や制御を行う .SH 書式 \fBdmesg\fP [options] .sp \fBdmesg \-\-clear\fP .br \fBdmesg \-\-read\-clear \fP[options] .br \fBdmesg \-\-console\-level \fP\fIlevel\fP .br \fBdmesg \-\-console\-on\fP .br \fBdmesg \-\-console\-off\fP .SH 説明 \fBdmesg\fP は、カーネルのリングバッファを調べたり、制御したりするために使用する。 .PP デフォルトの動作は、カーネルのリングバッファにあるすべてのメッセージを表示することである。 .SH オプション \fB\-\-clear\fP, \fB\-\-read\-clear\fP, \fB\-\-console\-on\fP, \fB\-\-console\-off\fP, \fB\-\-console\-level\fP は、どれか一つしか使えない。 .IP "\fB\-C\fP, \fB\-\-clear\fP" リングバッファをクリアする。 .IP "\fB\-c\fP, \fB\-\-read\-clear\fP" まずリングバッファの内容を表示し、その後でクリアする。 .IP "\fB\-D\fP, \fB\-\-console\-off\fP" コンソールへのメッセージ出力を抑止する (訳注: ただし \fBemergency\fP レベルのメッセージだけは表示する)。 .IP "\fB\-d\fP, \fB\-\-show\-delta\fP" タイムスタンプ (訳注: ブートからの経過秒数をマイクロ秒まで表示) とともに、前のメッセージ出力から経過した時間の増分 (time delta) を表示する。\fB\-\-notime\fP と一緒に使用した場合は、タイムスタンプは省略して、時間の増分だけを表示する。 .IP "\fB\-E\fP, \fB\-\-console\-on\fP" コンソールへのメッセージ出力を有効にする。 .IP "\fB\-e\fP, \fB\-\-reltime\fP" ローカルタイムと時間の増分を人間に読みやすいフォーマットで表示する。 ローカルタイムへの変換は不正確かもしれないことを、ご承知いただきたい (詳しくは \fB\-T\fP を参照)。 .IP "\fB\-F\fP, \fB\-\-file \fP\fIfile\fP" 指定されたファイル \fIfile\fP から syslog のメッセージを読み込む。\fB\-F\fP は、kmsg フォーマットのメッセージをサポートしていないことに気をつけていただきたい。 サポートしているのは、昔ながらの syslog フォーマットだけである。 .IP "\fB\-f\fP, \fB\-\-facility \fP\fIlist\fP" 出力を指定されたファシリティの (コンマで区切った) リストに限定する。たとえば、 .PP .RS 14 \fBdmesg \-\-facility=daemon\fP .RE .IP は、システムデーモンのメッセージのみを表示する。 どんなファシリティがサポートされているかについては、\fB\-\-help\fP の出力をご覧いただきたい。 .IP "\fB\-H\fP, \fB\-\-human\fP" 人間に読みやすい出力にする。\fB\-\-color\fP, \fB\-\-reltime\fP, \fB\-\-nopager\fP も参照。 .IP "\fB\-k\fP, \fB\-\-kernel\fP" カーネルメッセージを表示する (訳注: つまり、ファシリティが kern のメッセージのみを表示する)。 .IP "\fB\-L\fP, \fB\-\-color\fP[=\fIwhen\fP]" 出力をカラー表示にする。指定が任意の引き数 \fIwhen\fP には、\fBauto\fP, \fBnever\fP, \fBalways\fP が使える。引き数 \fIwhen\fP が省略された場合は、デフォルトの \fBauto\fP が使用される。カラー表示は無効にすることもできる。 プログラムに埋め込まれた現在のデフォルトが有効か無効かを知るには、 \fB\-\-help\fP の出力を見ればよい。下記の「\fBカラー表示\fP」セクションもご覧いただきたい。 .IP "\fB\-l\fP, \fB\-\-level \fP\fIlist\fP" 出力を指定されたレベル (訳注: 重大度、緊急度) の (コンマで区切った) リストに限定する。たとえば、 .PP .RS 14 \fBdmesg \-\-level=err,warn\fP .RE .IP は、error と warning メッセージのみを表示する。どんなレベルがサポートされているかについては、\fB\-\-help\fP の出力をご覧いただきたい。 .IP "\fB\-n\fP, \fB\-\-console\-level \fP\fIlevel\fP" コンソールに出力されるログメッセージのレベル (重大度) を \fIlevel\fP に設定する。\fIlevel\fP に指定するのは、数値のレベルか、レベルの名称の短縮形である。 どんなレベルがサポートされているかについては、 \fB\-\-help\fP の出力をご覧いただきたい。 .RS .IP "[\fB訳注\fP]" 8 現在使用中のコンソール (X 上の端末エミュレータではない) に自動的に表示されるメッセージが、指定したレベル以上の重大度を持つものになる。 数値による指定の場合は、その数値を含まない、それより重大な (つまり、数値が小さい) レベルのメッセージが表示され、名称による指定の場合は、 その名称を含む、それ以上の重大度のメッセージが表示されるようになる。 レベルの数値については、\fBsyslog\fP(2) を参照。 .RE .PP .RS たとえば、\fB\-n 1\fP や \fB\-n emerg\fP を指定すると、emergency (panic) 以外のすべてのメッセージが、コンソールに表示されなくなる。とは言え、 すべてのレベルのメッセージが \fI/proc/kmsg\fP に書き込まれることに変わりはないので、 カーネルメッセージをどこに出力するかは、やはり \fBsyslogd\fP(8) 使って、きちんとコントロールすることができる。なお、 \fB\-n\fP オプションを使用したとき、\fBdmesg\fP がカーネルのリングバッファを表示したり、クリアしたりすることはない (訳注: この \fB\-n\fP オプションは、コンソールに自動的に表示されるメッセージのレベルを設定するだけである)。 .RE .IP \fB\-\-noescape\fP 非表示文字や問題を起こしかねない文字 (たとえば、破損したマルチバイトシーケンスや、端末制御文字など) は、デフォルトではセキュリティ上の理由から \ex の形式でエスケープされるようになっている。このオプションはその機能を完全に無効にする。 このオプションは、たとえば \fB\-\-raw\fP と併せて、デバッグのために使用できる。 使用には気を付けること。デフォルトで使うようにしてはいけない。 .IP "\fB\-P\fP, \fB\-\-nopager\fP" 出力をパイプでページャーに渡さない。\fB\-\-human\fP の出力では、ページャーはデフォルトで使用される。 .IP "\fB\-p\fP, \fB\-\-force\-prefix\fP" 複数行メッセージの各行にファシリティ、レベル、タイムスタンプの情報を付け加える。 .IP "\fB\-r\fP, \fB\-\-raw\fP" メッセージバッファを未加工 (raw) のまま表示する。 すなわち、ログレベルを表す接頭辞を取り除かない。 ただし、すべての非表示文字がエスケープされることには変わりがない (\fB\-\-noescape\fP も参照)。 注意してほしいが、実際の未加工フォーマットは、\fBdmesg\fP(1) がカーネルメッセージを読み出す方法によって違ってくる (訳注: すぐ下の \fB\-S\fP オプションや \fB\-F\fP オプションの説明も参照)。デバイス /dev/kmsg と \fBsyslog\fP(2) では、違ったフォーマットを使っているのである。 ただし、後方互換のため、\fBdmesg\fP は、常に \fBsyslog\fP(2) のフォーマットでデータを返すようになっている。/dev/kmsg にある本当の未加工データは、たとえば、'dd if=/dev/kmsg iflag=nonblock' といったコマンドを使えば、読むことができる。 .IP "\fB\-S\fP, \fB\-\-syslog\fP" カーネルメッセージを読み出すのに、\fBdmesg\fP が \fBsyslog\fP(2) のカーネルインターフェースを使うようにする。kernel 3.5.0 以来、\fBsyslog\fP(2) ではなく、/dev/kmsg を使用するのがデフォルトである。 .IP "\fB\-s\fP, \fB\-\-buffer\-size \fP\fIsize\fP" カーネルのリングバッファへの問い合わせに、サイズ \fIsize\fP のバッファを使用する。デフォルトでは 16392 である。(デフォルトのカーネル・シスログバッファのサイズは、最初は 4096 だったが、1.3.54 以後は 8192 になり、2.1.113 以来 16384 になった。) カーネルバッファをデフォルトより大きく設定している場合に、バッファを全部見るには、 このオプションを使えばよい。 .IP "\fB\-T\fP, \fB\-\-ctime\fP" 人間に読みやすいタイムスタンプを表示する。 .sp 「\fBこのタイムスタンプは不正確なことがある！\fP」のをご承知いただきたい。 ログに使用する、タイムスタンプの元になる情報 (the time source) は、システムの\fBサスペンド\fP/\fBレジューム後に、更新が行われない\fP。 更新が行われないので、タイムスタンプは、ブートタイムと単調増加クロック (monotonic clocks) との間の現在の増分 (delta) によって時間合わせがなされているのだが、そうした時間合わせが、 最後のレジューム以後に表示されるメッセージ同士の間でしかうまく働かないのである。 .RS .IP "[\fB訳注\fP]" 8 つまり、\fBサスペンド\fP/\fBレジューム直後\fPのタイムスタンプについては、 時間合わせがうまく行かない。 言葉を変えると、カーネル・リングバッファのタイムスタンプでは、 ブートタイムと実稼働時間のみが使用されており、サスペンド中の時間は加算されない。 それ故、サスペンド後の \fBdmesg\fP の日時表示は信用できないということである。 .RE .IP "\fB\-t\fP, \fB\-\-notime\fP" カーネルが出力するタイムスタンプを表示しない。 .IP "\fB\-\-time\-format\fP \fIformat\fP" 指定されたフォーマット \fIformat\fP を使って、タイムスタンプを表示する。\fIformat\fP には、\fBctime\fP, \fBreltime\fP, \fBdelta\fP, \fBiso\fP が使える。 最初の三つは、それぞれのタイムフォーマットを指定するオプション (訳注: \fB\-\-ctime\fP など) のエイリアスであり、\fBiso\fP フォーマットは、ISO\-8601 のタイムスタンプフォーマットの \fBdemsg\fP における実装である。 この最後のフォーマットの目的は、 二つのシステム間でのタイムスタンプの比較のような解析作業を容易にすることだ。 \fBiso\fP タイムスタンプは、 YYYY\-MM\-DDHH:MM:SS,<\-+> という形式になる。 .sp \fBiso\fP フォーマットにも \fBctime\fP と同じ問題がある。 すなわち、システムがサスペンド、レジュームした場合、日時は不正確かもしれないのである。 .TP \fB\-u\fP,\fB \-\-userspace\fP ユーザ空間のメッセージを表示する。 .TP \fB\-w\fP,\fB \-\-follow\fP 新しいメッセージが出力されるのを待つ。この機能は、/dev/kmsg を読むことのできるシステムでのみサポートされている (カーネル 3.5.0 以降)。 .TP \fB\-W\fP,\fB \-\-follow\-new\fP 待機する。そして、新しいメッセージのみを表示する。 .TP \fB\-x\fP,\fB \-\-decode\fP ファシリティとレベル (重大度) の番号を人間に分かりやすい接頭辞に変換する。 .TP \fB\-V\fP,\fB \-\-version\fP バージョン情報を表示して終了する。 .TP \fB\-h\fP,\fB \-\-help\fP ヘルプを表示して終了する。 .SH カラー表示 自動的なカラー表示は、\fI/etc/terminal\-colors.d/dmesg.disable\fP という空ファイルを作ることで無効にできる。 カラー表示の設定についてもっと詳しいことを知りたかったら、\fBterminal\-colors.d\fP(5) をご覧になるとよい。 .PP \fBdmesg\fP は、以下の論理カラー名をサポートしている。 .TP \fBsubsys\fP メッセージのサブシステム接頭辞 (たとえば、"ACPI")。 .TP \fBtime\fP メッセージのタイムスタンプ。 .TP \fBtimebreak\fP \fB\-\-reltime\fP や \fB\-\-human\fP における出力メッセージの、短い ctime フォーマットで表現したタイムスタンプ。 .TP \fBalert\fP ログの重大度が alert のメッセージのテキスト部分。 .TP \fBcrit\fP ログの重大度が critical のメッセージのテキスト部分。 .TP \fBerr\fP ログの重大度が error のメッセージのテキスト部分。 .TP \fBwarn\fP ログの重大度が warning のメッセージのテキスト部分。 .TP \fBsegfault\fP セグメンテーションフォールトを知らせるメッセージのテキスト部分。 .SH 終了ステータス \fBdmesg\fP が「操作が許可されていない」旨のエラーを出して、実行に失敗することがある。 これが起きるのは、たいてい、カーネルの設定 \fBdmesg_restrict\fP のせいである。詳しくは、\fBsyslog\fP(2) をご覧いただきたい。 .SH 作者 Karel Zak \fBdmesg\fP を最初に書いたのは、Theodore Ts'o だった。 .SH 関連項目 \fBterminal\-colors.d\fP(5), \fBsyslogd\fP(8) .SH 入手方法 この dmesg コマンドは、util\-linux パッケージの一部であり、Linux Kernel Archive から入手できる。