File	Date	Author	Commit
3rdparty	2019-06-05	Alex Sidorenko	[624be0] Adding a directory for 3rd party Python module
Doc	2025-03-26	Martin Moore	[cad47a] Fix method to determine threads in a thread gro...
Extension	2025-05-16	Daniel Sungju Kwon	[83d27f] Fix to pass proper number of args in epython call
LinuxDump	2025-05-05	David Jeffery	[7254e5] scsishow: use get_request_state for determining...
dist-packages	2019-06-05	Alex Sidorenko	[624be0] Adding a directory for 3rd party Python module
docs	2017-07-13	Alex Sidorenko	[1a351e] Editing the guide for migrating to PyKdump-3
progs	2025-05-05	David Jeffery	[7254e5] scsishow: use get_request_state for determining...
pykdump	2025-02-15	Daniel Sungju Kwon	[145eaa] Make exec_epython_command() returns result as s...
.gitignore	2020-02-21	Alex Sidorenko	[bdb0c1] Started writing documentation - this is a work ...
.readthedocs.yaml	2023-12-22	Martin Moore	[727338] Update readthedocs configuration (V2)
COPYING	2007-02-14	Alex Sidorenko	[bcd1fa] initial import
INSTALL	2020-07-07	Alex Sidorenko	[b071cf] Changed URL for 'crash' sources location
INSTALL-git	2012-04-03	Alex Sidorenko	[3a6f1f] Improvements for configuration
MANIFEST.in	2007-03-22	Alex Sidorenko	[c30048] Added '--arp' to xportshow
NEWS	2007-08-24	Alex Sidorenko	[270651] Updated NEWS and added INSTALL-svn
README	2007-02-14	Alex Sidorenko	[bcd1fa] initial import
build.sh	2012-04-03	Alex Sidorenko	[3a6f1f] Improvements for configuration
buildPython.sh	2019-08-29	Alex Sidorenko	[2e9d0a] Redesign of epython.c to make it work with upco...
setup.py	2022-06-29	Martin Moore	[8ac481] Python 3.10 enablement. Currently builds and o...
soupdate.py	2015-11-25	Alex Sidorenko	[9f9294] Changing copyright strings and developer's emai...

Read Me

This is a framework for programmatic dump-analysis on Linux using
Python as an extension language for 'crash' tool. Even though there are still
many things to do, it is always quite usable. The framework has been
successfully used on X86 platform and AMD64 (both 32 and 64 bits). Preliminary
testing has been done on Itanium (IA64) but it is not as well tested yet.

License: GPL
URL: http://sourceforge.net/projects/pykdump/

For installation instructions, see INSTALL.

QuickStart
----------

There are two ways to invoke programs written in Python:

1. Start 'crash' with needed parameters, then load the extension using 'extend'
command. The easiest way to automate this is to create .crashrc file (either
in your home directory, or current directory) and add to it something like

extend /usr/local/lib/pykdump32.so


This will load the extension every time you start 'crash'.

After that you invoke your program in the following way:

crash> epython progname.py arg1 ...

For example:

{asid 15:37:00} crash32  /data/Dumps/Fermi/vmlinux-2.4.21-47.ELsmp \
     /data/Dumps/Fermi/vmcore

crash32 4.0-3.12
...
crash32> extend /uuu/users/sid/tools/pykdump/Extension/pykdump32.so
/uuu/users/sid/tools/pykdump/Extension/pykdump32.so: shared object loaded
crash32> epython progs/netdev.py
...

  --   0.82s --


2. You can start programs by running them directly from shell - in this case
the program will start 'crash' session (using pexpect module), load the extension,
and invoke your program via 'epython'

{asid 15:41:16} progs/netdev.py /data/Dumps/Fermi
crash32  /data/Dumps/Fermi/vmlinux-2.4.21-47.ELsmp /data/Dumps/Fermi/vmcore
epython progs/netdev.py /data/Dumps/Fermi
--------------------------------------------------
...
  --   0.38s --


3. Examples are provided in a separate package, 'LinuxDump', that can be
loaded from the same SourceForge site site