Name Date Size #Lines LOC

..04-Apr-2020-

arch/H24-Apr-2020-

eppic_scripts/H04-Apr-2020-

.gitignoreH A D04-Apr-2020949 8172

COPYINGH A D04-Apr-202017.6 KiB340281

IMPLEMENTATIONH A D04-Apr-202012.1 KiB283245

MakefileH A D24-Apr-20203.9 KiB12493

READMEH A D24-Apr-202010.6 KiB218195

cache.cH A D04-Apr-20202.9 KiB139100

cache.hH A D04-Apr-20201.1 KiB3815

common.hH A D04-Apr-20201.3 KiB5528

diskdump_mod.hH A D24-Apr-20203.9 KiB11667

dwarf_info.cH A D04-Apr-202034 KiB1,6211,139

dwarf_info.hH A D04-Apr-20203 KiB8661

elf_info.cH A D04-Apr-202027.8 KiB1,3051,033

elf_info.hH A D04-Apr-20203.2 KiB9762

erase_info.cH A D04-Apr-202059.9 KiB2,4711,776

erase_info.hH A D04-Apr-20202.4 KiB7040

extension_eppic.cH A D04-Apr-20209.8 KiB469313

extension_eppic.hH A D04-Apr-20202.6 KiB9651

makedumpfile-R.plH A D04-Apr-20204.8 KiB203149

makedumpfile.8H A D24-Apr-202025.1 KiB667609

makedumpfile.cH A D24-Apr-2020296.4 KiB11,8409,065

makedumpfile.confH A D04-Apr-20205 KiB1500

makedumpfile.conf.5H A D24-Apr-202012.4 KiB420398

makedumpfile.hH A D24-Apr-202066.7 KiB2,3941,787

makedumpfile.specH A D04-Apr-20201.2 KiB5142

print_info.cH A D24-Apr-202018.1 KiB429397

print_info.hH A D04-Apr-20202.7 KiB10367

sadump_info.cH A D04-Apr-202065.3 KiB2,4991,924

sadump_info.hH A D04-Apr-20203.2 KiB166114

sadump_mod.hH A D04-Apr-20205.6 KiB195149

tools.cH A D04-Apr-202011.5 KiB767537

README

1
2=======================
3 makedumpfile's README
4=======================
5
6* REQUIREMENTS
7  Please download the following library file and install it exactly as below;
8  do NOT use "make install".
9  - elfutils-0.144.tar.gz
10    The "make install" of elfutils installs some commands (ld, readelf, etc.),
11    and compiling problems sometimes happen due to using the installed
12    commands. To install only the library & header files, use the following
13    method:
14     # tar -zxvf elfutils-0.144.tar.gz
15     # cd elfutils-0.144
16     # ./configure
17     # make
18     #
19     # mkdir /usr/local/include/elfutils/
20     # cp ./libdw/libdw.h   /usr/local/include/elfutils/libdw.h
21     # cp ./libdw/dwarf.h   /usr/local/include/dwarf.h
22     # cp ./libelf/libelf.h /usr/local/include/libelf.h
23     # cp ./libelf/gelf.h   /usr/local/include/gelf.h
24     #
25     # cp ./libelf/libelf.a /usr/local/lib/libelf.a
26     # cp ./libdw/libdw.a   /usr/local/lib/libdw.a
27     # cp ./libasm/libasm.a /usr/local/lib/libasm.a
28     # cp ./libebl/libebl.a /usr/local/lib/libebl.a
29     #
30
31* BUILD & INSTALL
32  1.Get the latest makedumpfile from the following site:
33    https://github.com/makedumpfile/makedumpfile
34  2.Uncompress the tar file:
35    # tar -zxvf makedumpfile-x.y.z.tar.gz
36  3.Enter the makedumpfile subdirectory:
37    # cd makedumpfile-x.y.z
38  4.Build, and install:
39    # make; make install
40  5.Build for a different architecture than the host :
41    # make TARGET=<arch> ; make install
42    where <arch> is the 'uname -m' of the target architecture.
43    The user has to set the environment variable CC to appropriate
44    compiler for the target architecture.
45  6.Build with lzo support:
46    # make USELZO=on ; make install
47    The user has to prepare lzo library.
48  7.Build with snappy support:
49    # make USESNAPPY=on ; make install
50    The user has to prepare snappy library.
51  8.Build the extension module for --eppic option.
52    # make eppic_makedumpfile.so
53    The user has to prepare eppic library from the following site:
54    http://code.google.com/p/eppic/
55
56* SUPPORTED KERNELS
57  This makedumpfile supports the following kernels.
58
59         |       FLATMEM     |   DISCONTIGMEM    |       SPARSEMEM
60         |-------------------+-------------------+------------------------
61   Kernel|    | x86| PPC| PPC|    | x86|    | PPC|    | x86|    | PPC|
62  Version| x86| _64|  32|  64| x86| _64|ia64|  64| x86| _64|ia64|  64|s390
63  -------+----+----+----+----+----+----+----+----+----+----+----+----+----
64  2.6.15 | OK | -- |    | -- | -- | -- | -- | -- | -- | -- | -- | -- |
65  2.6.16 | OK | OK |    |    | -- | OK | OK | -- | -- |    | -- |    |
66  2.6.17 | OK | OK |    |    | -- | OK | -- | -- | -- | OK | -- |    |
67  2.6.18 | OK | OK |    | OK | -- | OK | OK | -- | -- | OK | OK | OK |
68  2.6.19 | OK | OK |    | OK | OK | OK |    | -- | OK | OK | OK | OK |
69  2.6.20 | OK | OK |    | #1 | OK | OK | OK | -- | OK | OK | OK | #1 |
70  21-rc5 | OK | OK |    | OK | OK | OK | OK | -- | OK | OK | OK | OK |
71  2.6.21 | OK | OK |    |    | OK | OK | OK | -- | OK | OK | OK |    |
72  2.6.22 | OK | OK |    |    | OK | OK | OK | -- | OK | OK | OK |    |
73  2.6.23 | OK | OK |    |    | OK | OK | OK | -- | OK | OK | OK |    |
74  2.6.24 | OK | OK |    |    | OK | OK | OK | -- | OK | OK | OK |    |
75  2.6.25 | OK | ** |    |    |    | ** | OK | -- | OK | OK | OK |    |
76  2.6.26 | OK | ** |    |    |    | ** | OK | -- | OK | OK | OK |    |
77  2.6.27 | OK | ** |    |    |    | ** | OK | -- | #2 | OK | OK |    |
78  2.6.28 | OK | ** |    |    |    | ** | OK | -- | OK | OK | OK |    |
79  2.6.29 | OK | ** |    |    |    | ** | OK | -- | OK | OK | OK |    |
80  2.6.30 | OK | ** |    |    |    | ** | OK | -- | OK | OK | OK |    |
81  2.6.31 | OK | ** |    |    |    | ** |    | -- | OK | OK | OK |    |
82  2.6.32 | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    | OK
83  2.6.33 | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
84  2.6.34 | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
85  2.6.35 | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
86  2.6.36 | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
87  2.6.37 | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
88  2.6.38 | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
89  2.6.39 | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
90  3.0    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
91  3.1    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
92  3.2    | OK | ** | OK |    |    | ** |    | -- | OK | OK |    |    |
93  3.3    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
94  3.4    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
95  3.5    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
96  3.6    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
97  3.7    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
98  3.8    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
99  3.9    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
100  3.10   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
101  3.11   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
102  3.12   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
103  3.13   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
104  3.14   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
105  3.15   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
106  3.16   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
107  3.17   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
108  3.18   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
109  3.19   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
110  4.0    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
111  4.1    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
112  4.2    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
113  4.3    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
114  4.4    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
115  4.5    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
116  4.6    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
117  4.7    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
118  4.8    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
119  4.9    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
120  4.10   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
121  4.11   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
122  4.12   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
123  4.13   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
124  4.14   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
125  4.15   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
126  4.16   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
127  4.17   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
128  4.18   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
129  4.19   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
130  4.20   | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
131  5.0    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
132  5.1    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
133  5.2    |    | ** |    |    |    | ** |    | -- |    | OK |    |    |
134  5.3    |    | ** |    |    |    | ** |    | -- |    | OK |    |    |
135  5.4    | OK | ** |    |    |    | ** |    | -- | OK | OK |    |    |
136
137  OK    : Support.
138  --    : Not support.
139  Empty : Not test yet.
140  TODO  : TODO.
141  #1    : Both kexec/kdump does not work with PPC64 2.6.20 kernels.
142          This is a known problem fixed with later kernels.
143  #2    : kdump does not work with i386 sparsemem 2.6.27 kernels.
144          This is a known problem fixed with later kernels.
145  **    : The deleted memory model.
146          On x86_64, both FLATMEM and DISCONTIGMEM have been deleted since
147          linux-2.6.25.
148
149* USAGE
150  Please see "man makedumpfile" or "makedumpfile -h".
151
152* TODO
153  1. Supporting more kernels.
154  2. Fixing the report message.
155     - Now, it sometimes counts the number of free_pages duplicating zero-pages
156       if creating an ELF dumpfile.
157     - The cyclic mode will show incorrect and many progress indicator.
158
159* NOTE
160  1. A vmcoreinfo file should be generated by the makedumpfile which is used
161     for dump filtering. If installing the latest makedumpfile, the vmcoreinfo
162     file should be regenerated by it. Actually, makedumpfile v1.2.0 or later
163     cannot work by vmcoreinfo file which is generated by v1.1.9 or before.
164
165  2. If using linux-2.6.24 and kexec-tools-testing-20061214, /proc/vmcore
166     contains vmcoreinfo data. So it is possible to create a dumpfile without
167     -x option (or -i option) like the following:
168     # makedumpfile -d 31 /proc/vmcore dumpfile
169
170  3. On makedumpfile-1.2.5 or before, both '--xen-syms' and '--xen-vmcoreinfo'
171     excluded Xen user domain pages. Since makedumpfile-1.2.6, '-X' option
172     have been added for excluding Xen user domain pages, and these options
173     does not exclude Xen user domain pages. So user should specify '-X'
174     option for excluding Xen user domain pages.
175
176* FAQ
177  001: If installing elfutils-0.137 into older elfutils by the above way, the
178       following problem happens sometimes. If seeing, try to enable LDFLAGS
179       comment (-L/usr/local/lib -I/usr/local/include) in Makefile.
180
181       $ make
182       [..]
183       /tmp/ccXQtvnZ.o: In function `process_module':
184       /makedumpfile/makedumpfile.c:1387: undefined reference to `dwarf_getelf'
185       collect2: ld returned 1 exit status
186       make: *** [makedumpfile] Error 1
187
188  002: makedumpfile is compiled with -static option, because the command should
189       run while the second kernel, which may not mount root filesystem and may
190       not contain dynamic library files, is running.
191       If the dynamic library files, which are needed by makedumpfile, exist
192       while the second kernel is running, we can use dynamic libraries by
193       "LINKTYPE" parameter.
194
195       $ make LINKTYPE=dynamic
196
197       This is a workaround for some linux distributions which does
198       not contain static library files needed by makedumpfile.
199
200
201* REFERENCES
202  - The makedumpfile project page
203    https://github.com/makedumpfile/makedumpfile
204
205  - The kexec mailing list archives
206    http://lists.infradead.org/pipermail/kexec/
207  - The fastboot mailing list archives
208    https://lists.linux-foundation.org/pipermail/fastboot/
209
210* BUG REPORT
211  If finding some bugs, please send the information to the following:
212  Kazuhito Hagio <k-hagio-ab@nec.com>
213  kexec-ml <kexec@lists.infradead.org>
214
215  Please refer to the project page's wiki:
216  https://github.com/makedumpfile/makedumpfile/wiki
217
218