Reported by Erik van der Kouwe <vdkouwe at cs.vu.nl>:
[minix.git] / man / man1 / postmort.1
blobb8a6cad8ccf1d65c542afd13d39537dac967380d
1 .TH POSTMORT 1
2 .SH NAME
3 postmort \- perform post-mortem on PC MINIX 3 core files
4 .SH SYNOPSIS
5 \fBpostmort\fR [\fB\-dpt\fR] \fB\-c \fIcorefile \fB\-s \fIsymbfile\fR
6 .br
7 .de FL
8 .TP
9 \\fB\\$1\\fR
10 \\$2
12 .de EX
13 .TP 20
14 \\fB\\$1\\fR
15 # \\$2
17 .SH OPTIONS
18 .FL "\-c" "Use the named corefile"
19 .FL "\-d" "Dump all text symbols and segment data"
20 .FL "\-p" "Display the kernel process table"
21 .FL "\-s" "Use the named symbol file"
22 .FL "\-t" "Display a stack backtrace"
23 .SH EXAMPLES
24 .EX "postmort" "display the data from the file 'core'"
25 .SH DESCRIPTION
26 .PP
27 .I Postmort
28 does a simple static analysis of a PC MINIX 3 core file;
29 By default, it looks for the
30 file 'core' in the local directory and loads that for analysis; it
31 also searches for the file 'symbol.out', and if that fails 'a.out',
32 expecting them to contain symbol information for the core file.
33 It is not a fatal error if the symbol files don't exist.
34 .PP
35 The stack backtrace is slightly tricky, and may go on longer
36 than is really justified, since there's no easy way for it to
37 know when to stop.  Treat its results with caution.