Sun Microsystems Sun Workstation 100U System Manager's Manual page 163

ANALYZE(8)
MAINTENANCE COMMANDS ANALYZE(8)
NAME
analyze - Virtual UNIX postmortem crash analyzer
SYNOPSIS
/uar/etc/analyze [ -a
swapfile ) [
-t) [ -m ) (
-d ) [ -D ) [ -v )
corefile [ system)
DESCRIPTION
FILES
Analyze is the post-mortem analyzer lor the state 01 the paging system. In order to use analyze
you must arrange to get a image 01 the memory (and possibly the paging area) 01 the system alter
it crashes (see cra8h(8S)).
The analyze program reads the relevant system data structures Irom the core image file and
indexing inlormation from
/vmunlx
(or the specified file) to determine the state of the paging
subsystem at the point
ot
crash. It looks at each process in the system, and the resources each is
using in an attempt to determine inconsistencies in the paging system state. Normally, the out-
put consists 01 a sequence of lines showing each active process, its state (whether swapped in or
not), its pOllr, and the number and location of its page table pages. Any pages which are locked
while raw i/o is in progress, or which are locked because they are intran8it are also printed.
(Intransit text pages often diagnose as duplicated; you will have to weed these out by hand.)
The program checks that any pages in core which are marked
38
not modified are, in fact, identi-
cal to the swap space copies. It also checks lor non-overlap of the swap space, and that the core
map en tries correspond to the page tables. The state of the free list is also checked.
Options to analyze:
-D
causes the dislemap for each proeess to be printed.
-d causes the (sorted) paging area usage to be printed.
-t which causes the free list to be dumped.
-m causes the entire coremap state to be dumped.
-v (long unused) which causes a hugely verbose output format to be used.
In general, the output from this program can be contused by processes which were forking, swap-
ping, or exiting or happened to be in unusual states when the crash occurred. You should exam-
ine the flags fields 01 relevant processes in the output 01 a p8tat(8) to weed out such processes.
It is possible to look at the core dump with ad6 if you do
adb -Ie /vmunix /vmcore
/vmunix default system namelist
SEE ALSO
adb(IS), ps(I), crash(8S), pstat(8)
AUTHORS
Ozalp Babaoghl and William Joy
DIAGNOSTICS
8
Various diagnostics about overlaps in swap mappings, missing swap mappings, page table entries
inconsistent with the core map, incore pages which are marked clean but differ from disk-image
copies, pages which are locked or intraDsit, and inconsistencies in the Iree list.
It would be nice if this program analyzed the system in general, rather than just the paging sys-
tem in particular.
Last change: 4 February 1983
Sun Release 1.1