kpm(1G)

NAME
     kpm - Kona post mortem dump, view, and inspection utility

SYNOPSIS
     kpm -[view dump status] [-pipe pipeno] [-debug {4-7}] [-f crashfile]
     +[beffifo geeram sram sdram eeprom]

DESCRIPTION
     kpm is used to diagnose pipe crashes and hangs of a Kona graphics pipe
     during operational use.  kpm has three modes:  dump, view, and status (or
     inspection).  The dump mode is used when a pipe crash is detected when
     the Kona graphics hardware is to be reinitialized by gfxinit. Instead of
     immediately resetting the graphics pipe and downloading new micro-code,
     gfxinit invokes kpm to dump the state of the crashed Kona graphics pipe
     to a file.

OPTIONS
     -dump   Dump the state of a crashed kona pipe to a file.

     -view   View the state of a crashed kona pipe from a dumped file.

     -status Inspect hardware status (JTAG) without disturbing any state.

     -f dumpfile
             Name of file to dump or view the Kona pipe crash to/from. If this
             option is not provided, file /usr/tmp/kona.dump is used as the
             default dumpfile.


             The options given below are applicable only in the dump and
             status mode.

     -pipe # Specify the pipe number of the Kona pipe to dump.

     -debug [4-7]
             Set debug level. Higher debug level results in more verbose
             output during kpm extraction process.


     +beffifo
             Dump BEF fifo contents and fifo history. Be careful when using
             this option as this tends to generate huge dump-files.

     +geeram Extract GE ERAM

     +sram   Extract ARM Static SRAM

     +sdram  Extract ARM SDRAM.

     +eeprom Extract EEPROM contents.
VIEW MODE
     kpm allows viewing of the dumped graphics state in a kpm dumpfile. kpm
     starts up in view mode by default if no command-line options are given.
     It uses GNU readline interface for easy command-line editing and viewing
     of dumped state.  Standard facilities like command-name completion can
     also be used. Help is available for most of the commands. kpm also
     implements simple, single-level file and pipe redirection. The ouput of
     any command can be dumped to a file or piped to any unix process using
     the standard shell syntax. However, the '|' and '>' characters should be
     separated by spaces on both sides. Two '|'s cannot appear in the command
     line. Some of the sections available are:


     versions
             Output from versions command of what software is installed on the
             machine.

     hinv    Hardware inventory output from hinv command.

     gfxinfo Graphics hardware configuration as reported by /usr/gfx/gfxinfo.

     date    Date the crash was dumped (not when the crash occurred).

     uname   Output from uname -a.

     os-boardinfo
             Information about the board as reported by the graphics kernel
             driver.

     overview
             This is probably the most important section. It summarizes the
             hardware state and provides bug signatures.

             In addition to these, there are several other hardware specific
             sections.


ENVIRONMENT
     The execution of kpm is affected by two environment variables.


     GL_GRROOT kpm uses this variable to locate its ucode files. The
               value of $GL_GRROOT is prepended to the actual ucode filename
               to get the required file.

     KONA_OCCMASK   kpm uses the variable to override the GE occupancy
               mask in hardware. This can be useful to get around fault GEs.

FILES
     /usr/gfx/KONA/bin/kpm         kpm executable.

     /usr/gfx/KONA/data/kpm.data   Data file required by kpm

     /usr/gfx/KONA/bin/postmortem  Shell script invoked by
                                   gfxinit to execute kpm


NOTES
     kpm in dump mode is executed by gfxinit and should not be used by hand.
     Any improper of of kpm can hang the system.

SEE ALSO
     gfxinit(1g), hinv(1), versions(1), uname(1)