機械翻訳について

9 corelensコマンド・リファレンス

この表は、corelensコマンドに関する情報を示しています。

アクション コマンド 説明

実行中のカーネルまたはvmcoreクラッシュ・ダンプのシステム状態のサマリーを確認します。

sudo corelens path/to/dumpfile

実行中のライブ・カーネルまたは生成されたクラッシュ・ダンプをデバッグするための情報を提供します。

corelensモジュールを実行して、実行中のカーネルまたはvmcoreクラッシュ・ダンプの内容を分析し、結果を確認します。

sudo corelens path/to/dumpfile -M module

モジュールでフィルタされた実行中のカーネルまたは生成されたクラッシュ・ダンプをデバッグするための情報を提供します。

指定できるモジュールのリストを確認します。

corelens -L

-Mオプションとともに使用するモジュール・フィルタのリストを提供します。

corelensコマンドからの出力に基づいてレポートを作成します。

sudo corelens path/to/dumpfile -a -o report

corelensコマンドで取得されたすべてのデバッグ情報を含む診断レポートを生成します。

corelensコマンドで提供されるその他のオプションを確認します。

corelens -h

drgnコマンドのコマンドライン・オプションのリストを提供します。

たとえば、ライブ・カーネルの/proc/kcoreをデバッグするには、次のコマンドを実行します:

sudo corelens /proc/kcore

vmcoreクラッシュ・ダンプ・ファイルに対して同じ操作を実行するには:

sudo corelens /var/crash/127.0.0.1-2025-07-29-09:33:07/vmcore

corelensコマンド出力のモジュールの選択

-Mオプションを使用して、corelensコマンドからの出力をフィルタします。

corelensコマンドは、-Mオプションを使用して、診断が必要なシステムの部分に基づいて出力をフィルタリングすることもできます。 たとえば、ライブ・カーネルの完全な出力を再現するには、sysモジュールをアクティブ化します:

sudo corelens /proc/kcore -M sys

同様に、進行中のI/Oリクエストのリストを表示するには、inflight-ioモジュールをアクティブ化します:

sudo corelens /proc/kcore -M inflight-io

モジュールごとに-Mオプションを再使用して、複数のモジュールを指定できます。 たとえば、ライブ・カーネルおよび現在存在するすべてのマウント済ディレクトリの完全な出力を再現するには、sysおよびmountsモジュールをアクティブ化します:

sudo corelens /proc/kcore -M sys -M mounts

出力例は次のとおりです:

warning: Running corelens against a live system.
         Data may be inconsistent, or corelens may crash.

====== MODULE sys ======
MODE        : Live kernel
DATE        : Thu Jul 31 09:35:06 2025
NODENAME    : oracle-example-ol10
RELEASE     : 6.12.0-101.33.4.3.el10uek.x86_64
VERSION     : #1 SMP PREEMPT_DYNAMIC Mon Jul 14 18:29:21 PDT 2025
MACHINE     : x86_64
UPTIME      : 1 day, 0:35:05
LOAD AVERAGE: 0.59  ,  0.60 ,  0.47
JIFFIES     : 4383172287
MEMORY      : 30.0 GiB
TASKS       : 1352 R:1 D:0 S:1160 I:190 Z:1
PLATFORM    : Dell Inc. Latitude 7440/03P3R5, BIOS 1.22.0 02/26/2025 X86_HYPER_NATIVE
CPU VENDOR: GenuineIntel
MODEL NAME: 13th Gen Intel(R) Core(TM) i7-1370P
CPU FAMILY: 6
CPUS      : 20
CPUS NUMA0: 0-19
MICROCODE : 0x4124
CSTATES   : 9

====== MODULE mounts ======
DEVNAME                    TYPE         DIRNAME
-------                    ------       -------
rootfs                     rootfs       /
/dev/mapper/claudius-root  xfs          /
devtmpfs                   devtmpfs     /dev
tmpfs                      tmpfs        /dev/shm
devpts                     devpts       /dev/pts
sysfs                      sysfs        /sys
securityfs                 securityfs   /sys/kernel/security
cgroup2                    cgroup2      /sys/fs/cgroup
pstore                     pstore       /sys/fs/pstore
efivarfs                   efivarfs     /sys/firmware/efi/efivars
bpf                        bpf          /sys/fs/bpf
configfs                   configfs     /sys/kernel/config
proc                       proc         /proc
tmpfs                      tmpfs        /run
tmpfs                      tmpfs        /run/credentials/systemd-cryptsetup@luks\x2d932152c6\x2d176f\x2d4cd3\x2db8df\x2d8c6d7cf62feb.service
systemd-1                  autofs       /proc/sys/fs/binfmt_misc
mqueue                     mqueue       /dev/mqueue
debugfs                    debugfs      /sys/kernel/debug
hugetlbfs                  hugetlbfs    /dev/hugepages
tracefs                    tracefs      /sys/kernel/tracing
tmpfs                      tmpfs        /run/credentials/systemd-journald.service
fusectl                    fusectl      /sys/fs/fuse/connections
/dev/nvme0n1p2             xfs          /boot
/dev/nvme0n1p3             xfs          /var/crash
/dev/mapper/claudius-home  xfs          /home
/dev/nvme0n1p1             vfat         /boot/efi
/dev/mapper/claudius-home  xfs          /u01
sunrpc                     rpc_pipefs   /var/lib/nfs/rpc_pipefs
tmpfs                      tmpfs        /run/user/1000
portal                     fuse.portal  /run/user/1000/doc
binfmt_misc                binfmt_misc  /proc/sys/fs/binfmt_misc
tmpfs                      tmpfs        /run/netns
tmpfs                      tmpfs        /run/user/0

====== corelens ======
drgn-tools 2.1.0+unknown, drgn 0.0.32 (using Python 3.12.9, elfutils 0.192, with debuginfod (dlopen), with libkdumpfile, with lzma), with CTF
Loaded CTF debuginfo in in 1.065s
Running module sys... completed in 0.012s
Running module mounts... completed in 0.001s
corelens total runtime: 1.091s

指定可能なすべてのモジュールの完全なリストを表示するには、-Lオプションを指定してcorelensコマンドを実行します:

corelens -L

corelensモジュールの動作の詳細は、-Mオプションを使用して各モジュールを指定した後に、-hオプションを使用します:

corelens -M module -h

たとえば、カーネル・ディレクトリ・エントリ・キャッシュを出力するdentrycacheモジュールについてさらに確認するには、次のコマンドを使用します:

corelens -M dentrycache -h

次のような出力結果が表示される場合があります。

usage: dentrycache [-h] [--limit LIMIT] [--negative] [--detailed]

List dentries from the dentry hash table

optional arguments:
  -h, --help show this help message and exit
  --limit LIMIT, -l LIMIT
                        list at most <number> dentries, 50 by default
  --negative, -n list negative dentries only, disabled by default
  --detailed, -d include inode, super, file type, refcount

corelensを使用したレポートの生成

提供されているcorelensコマンド・オプションを使用して、後で確認するためのレポートを生成します。

corelensコマンドからレポートを生成するには、-oオプションを使用して、そのレポートの出力ディレクトリを指定します。 たとえば、ライブ・カーネルのレポートを生成し、そのレポートを現在の作業ディレクトリ内のreportというフォルダに出力するには、次のコマンドを使用します:

sudo corelens /proc/kcore -a -o report

-Mオプションを使用してモジュールを明示的に指定しない場合は、-aオプションを使用して標準モジュールでレポートを生成するか、-Aオプションで詳細モジュールを使用してレポートを生成します。

ノート:

すべてのモジュールを使用してレポートを生成すると、一部のモジュールを実行できなかったという警告が最終レポートに含まれる場合があります。 一部のcorelensモジュールはコア・ダンプを必要とするか、特定のカーネル・モジュールがロードされている場合にのみ機能するため、これは予期される動作です。

診断情報は、corelensコマンドの実行時にアクティブだった各モジュールのプレーンテキスト・ファイルに格納されます。 たとえば、mountsモジュールから出力されたマウント済ディレクトリを確認するには、report/mountsファイルの内容を表示します:

cat report/mounts

出力例は次のとおりです:

DEVNAME                     TYPE        DIRNAME
-------                     ------      -------
none                        rootfs      /
proc                        proc        /proc
sysfs                       sysfs       /sys
devtmpfs                    devtmpfs    /dev
securityfs                  securityfs  /sys/kernel/security
tmpfs                       tmpfs       /dev/shm
devpts                      devpts      /dev/pts
tmpfs                       tmpfs       /run
cgroup2                     cgroup2     /sys/fs/cgroup
pstore                      pstore      /sys/fs/pstore
efivarfs                    efivarfs    /sys/firmware/efi/efivars
bpf                         bpf         /sys/fs/bpf
configfs                    configfs    /sys/kernel/config
/dev/mapper/ocivolume-root  xfs         /
rpc_pipefs                  rpc_pipefs  /var/lib/nfs/rpc_pipefs
selinuxfs                   selinuxfs   /sys/fs/selinux
systemd-1                   autofs      /proc/sys/fs/binfmt_misc
hugetlbfs                   hugetlbfs   /dev/hugepages
mqueue                      mqueue      /dev/mqueue
debugfs                     debugfs     /sys/kernel/debug
tracefs                     tracefs     /sys/kernel/tracing
fusectl                     fusectl     /sys/fs/fuse/connections
none                        ramfs       /run/credentials/systemd-sysctl.service
none                        ramfs       /run/credentials/systemd-tmpfiles-setup-dev.service
/dev/mapper/ocivolume-oled  xfs         /var/oled
/dev/sda2                   xfs         /boot
/dev/sda1                   vfat        /boot/efi
none                        ramfs       /run/credentials/systemd-tmpfiles-setup.service
tmpfs                       tmpfs       /run/user/0
tmpfs                       tmpfs       /run/user/982
tmpfs                       tmpfs       /run/user/1000