Annotation of researchv10dc/man/adm/man8/savecore.8, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.