9 corelensコマンド・リファレンス
この表は、corelensコマンドに関する情報を示しています。
| アクション | コマンド | 説明 |
|---|---|---|
|
実行中のカーネルまたは |
sudo corelens path/to/dumpfile
|
実行中のライブ・カーネルまたは生成されたクラッシュ・ダンプをデバッグするための情報を提供します。 |
|
corelensモジュールを実行して、実行中のカーネルまたは |
sudo corelens path/to/dumpfile -M module
|
モジュールでフィルタされた実行中のカーネルまたは生成されたクラッシュ・ダンプをデバッグするための情報を提供します。 |
|
指定できるモジュールのリストを確認します。 |
corelens -L
|
|
|
|
sudo corelens path/to/dumpfile -a -o report
|
|
|
|
corelens -h
|
|
たとえば、ライブ・カーネルの/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