|
|
1.1 root 1: .TH SAVECORE 8
2: .CT 1 sa_auto
3: .SH NAME
4: savecore \- save a core image of the operating system
5: .SH SYNOPSIS
6: .B /etc/savecore
7: .I target
8: .I dump
9: .SH DESCRIPTION
10: .I Savecore
11: copies the core image
12: saved after an operating system crash
13: to an ordinary file.
14: This is worth doing
15: so that the crash image will not be overwritten
16: immediately by another crash,
17: or sometimes because the crash image was written
18: in a place where normal system operation will overwrite it
19: (e.g. in the swap area).
20: .PP
21: The crash image is taken from
22: .I dump
23: and written to
24: .IR target .
25: If
26: .I target
27: exists and is a directory,
28: the image is copied to
29: a file in that directory
30: with the first nonexistent name
31: in the sequence
32: .BR "z.0 z.1 z.2 ..." ;
33: otherwise
34: .I target
35: is created or overwritten.
36: .PP
37: The crash image to be copied
38: is checked for a magic number
39: in a known location.
40: If the magic number is correct,
41: it is followed by the size of the image,
42: and the time it was written;
43: these numbers are printed
44: before the dump is copied.
45: If the magic number is wrong,
46: the image is not copied.
47: .I Savecore
48: overwrites the magic number in
49: .I dump
50: after a successful copy.
51: .PP
52: The program runs faster
53: if
54: .I dump
55: is the raw device.
56: .PP
57: For compatibility with an older program of the same name,
58: the
59: .I dump
60: argument may be omitted;
61: .I savecore
62: will noisily examine each device specified for swapping in
63: .IR fstab (5)
64: and each of several popular default swap devices
65: for a valid magic number.
66: The first device that looks right
67: is taken to be the crash image.
68: .PP
69: .I Savecore
70: is usually called when the system is booted,
71: from
72: .IR rc (8).
73: .SH EXAMPLE
74: .EX
75: /etc/savecore /tmp/dump /dev/rra11
76: .EE
77: .SH SEE ALSO
78: .IR reboot (8)
79: .SH BUGS
80: The argument convention
81: (the file to be written comes first)
82: is unfortunate;
83: it stems from compatibility.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.