User GuideΒΆ

The PyKdump framework provides quite a few ready-to-use programs to allow users to quickly extract and process various useful information from a vmcore dump.

These built-in programs can be used to quickly fetch details about SCSI adapters, disk devices, multipath maps, LVM volumes, TCP/IP sockets, NFS mounts, processes holding or waiting for mutex locks, and much more. Some of these programs also provide an option to run automated checks and report potential issues.

These programs can be accessed by loading the extension in the crash environment:

crash> extend /test/mpykdump.so
Setting scroll off while initializing PyKdump
/test/mpykdump.so: shared object loaded

Once the extension is loaded, the commands provided by built-in programs can be viewed with the "extend" command as shown below. They will also show up in the list of commands provided by the crash "help" command. Using the '-h' option with these commands will provide more details about what a specific command does and its options:

crash> extend
SHARED OBJECT        COMMANDS
/test/mpykdump.so    epython xportshow crashinfo taskinfo nfsshow hanginfo
                     fregs tslog scsishow dmshow pstree modinfo mdadm nvme
                     keyringshow cifsshow

The epython command allows direct execution of any custom Python programs written using this framework, without a need to rebuild the whole extension.

Use the below links to view the documentation for individual programs: