[LU-12461] Contribute epython scripts to aid crash dump analysis

• Type: New Feature
• Resolution: Fixed
• Priority: Minor
• Fix Version/s: Lustre 2.14.0
• Assignee: Ann Koehler (Inactive)
• Reporter: Ann Koehler (Inactive)

Description

PyKdump is an open source framework for supporting Python scripting within the Linux crash tool. Cray has been using it quite productively for quite some time and would like to contribute the scripts it has developed for extracting Lustre structs from memory dumps. The scripts were written primarily for client dumps but can be easily extended to support server dumps. The differences are in the Lustre data structures between clients and servers; there's nothing inherently different about the scripting.

Installation instructions for PyKdump are available at:
https://sourceforge.net/p/pykdump/wiki/Home/

The scripts being provided were written for Python2.7. The site above includes documentation for converting to Python3.3.

The following is a summary of the scripts being contributed:
Summary of scripts:

• cfs_hashes.py Displays summary of cfs_hash tables.
• cfs_hnodes.py Displays the specified Lustre hash table.
• debug_flags.py Prints Lustre libcfs_debug flags as strings.
• dk.py Dumps and sorts the Lustre dk logs.
• jiffies2date.py Prints the date and time of a given jiffies timestamp.
• ldlm_dumplocks.py Lists granted and waiting locks by namespace/resource.
• ldlm_lockflags.py Prints string identifiers for specified LDLM flags.
• lu_object.py Prints contents of an lu_object.
• lustre_opcode.py Maps Lustre rpc opcodes to string identifiers.
• obd_devs.py Displays the contents of global 'obd_devs'.
• ptlrpc.py Displays the RPC queues of the Lustre ptlrpcd daemons.
• rpc_stats.py Dumps the client_obd structure given by client argument.
• sbi_ptrs.py Prints Lustre structs associated with inode.
• uniqueStacktrace.py Prints stack traces for each task.

The scripts require symbols from the Lustre and LNet modules to be loaded
(mod command in crash). A script is invoked with the command
"epython <script name>" followed by any parameters. To get usage information
for a particular script, enter the following at the crash prompt:
epython <script_name> -h

Issue Links

• is related to: LU-13676 script to show unique backtraces from crash utility