Hallo, dies ist ein Test.
PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html
Running in File Mode
Relative path: ././../../../../../../usr/man/man8/savecore.8
Real path: /usr/share/man/man8/savecore.8
Zurück
'\" te .\" Copyright (c) 2004, 2023, Oracle and/or its affiliates. .\" Copyright (c) 1983, Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. .TH savecore 8 "28 July 2023" "Oracle Solaris 11.4" "System Administration Commands" .SH NAME savecore \- save a crash dump of the operating system .SH SYNOPSIS .LP .nf \fBsavecore\fR [\fB-dNrvVz\fR] [\fB-D\fR \fIdirname\fR] [\fB-s\fR \fIsecname\fR] [\fB-f\fR \fIdumpfile\fR] [\fIsuffix\fR] \fBsavecore\fR \fB-L\fR [\fB-v\fR] [\fB-D\fR \fIdirname\fR] \fBsavecore\fR \fB-u\fR [\fB-dv\fR] [\fB-D\fR \fIdirname\fR] [\fB-f\fR \fIdumpfile\fR] \fBsavecore\fR \fB-l\fR [\fB-H\fR] [\fB-f\fR \fIdumpfile\fR] \fBsavecore\fR \fB-r\fR [\fB-v\fR] \fBsavecore\fR \fB-z\fR [\fB-h\fR] \fB-f\fR \fIdumpfile\fR [\fB--scale\fR[=\fIitem1\fR,\fIitem2\fR,...]] .fi .SH DESCRIPTION .sp .LP The \fBsavecore\fR utility saves a crash dump of the kernel (assuming that one was made) and writes a reboot message in the system log. It is invoked by the \fBdumpadm\fR service each time the system boots. .sp .LP \fBsavecore\fR can be configured by \fBdumpadm\fR(8) to save crash dump data in either a compressed or uncompressed format. Crash dump data are divided on the dump device into sections, depending on \fBdumpadm\fR(8) configuration. For the compressed format, savecore saves the crash dump data in files called \fBvmdump-<section>.N\fR, where \fIsection\fR is the name of the actual section; the actual number of files produced depends on the \fBdumpadm\fR(8) configuration and on how savecore is run. \fIN\fR in the pathname is replaced by a number which increments every time savecore is run to copy a crash dump from the dump device and a new crash dump is found on the dump device. The number is not incremented if some of the sections of the crash dump are already copied. The files are saved into subdirectory created under directory specified with the \fB-D\fR option or the crash dump directory as configured by \fBdumpadm\fR(8). The subdirectory is in the form of \fBdata/<uuid>\fR, where \fIuuid\fR matches the unique FMA identifier of this particular panic event. .sp .LP The \fBsuffix\fR argument specifies numerical suffix. If savecore is run with the suffix argument it will attempt to uncompress all files named \fBvmdump-<section>.N\fR, where \fIN\fR is equal to the suffix argument. The suffix argument is not valid when used together with the \fB-f\fR option. .sp .LP All compressed files can be uncompressed in a separate step using the suffix argument or individually using the \fB-f\fR dumpfile option. For the uncompressed format, \fBsavecore\fR saves the crash dump data in the file directory\fB/vmcore-<section>.N\fR files and the kernel's namelist in directory\fB/unix.N\fR. .sp .LP Integrity verification of \fBvmdump-*.N\fR files from remote system is done when extraction is performed to \fBvmcore-*.N\fR file. It can be done separately without the extraction using the \fB-V\fR option. If the verification fails, savecore marks the file as incomplete. .sp .LP Before writing out a crash dump, \fBsavecore\fR reads a number from the file \fIdirectory\fR\fB/minfree\fR. This is the minimum number of kilobytes that must remain free on the file system containing \fIdirectory\fR. If after saving the crash dump the file system containing \fIdirectory\fR would have less free space the number of kilobytes specified in \fBminfree\fR, the crash dump is not saved. if the \fBminfree\fR file does not exist, \fBsavecore\fR assumes a \fBminfree\fR value of 1 megabyte. .sp .LP The \fBsavecore\fR utility also logs a reboot message using facility \fBLOG_AUTH\fR (see \fBsyslog\fR(3C)). If the system crashed as a result of a panic, \fBsavecore\fR logs the panic string too. .sp .LP The \fBsavecore\fR utility also produces \fBfma\fR(3M) event if the system rebooted after panic. .SH OPTIONS .sp .LP The following options are supported: .sp .ne 2 .mk .na \fB\fB-D\fR \fIdirectory\fR\fR .ad .br .sp .6 .RS 4n Save the crash dump files to the specified directory. If the directory option is not specified, savecore saves the crash dump files to the default savecore directory, derived from the directory configured by \fBdumpadm\fR(8). .RE .sp .ne 2 .mk .na \fB\fB-d\fR\fR .ad .br .sp .6 .RS 4n Disregard dump header valid flag. Force \fBsavecore\fR to attempt to save a crash dump even if the header information stored on the dump device indicates the dump has already been saved. .RE .sp .ne 2 .mk .na \fB\fB-f\fR \fIdumpfile\fR\fR .ad .br .sp .6 .RS 4n Save a crash dump from the specified file instead of from the system's current dump device. When given \fB\fIdirectory\fR/vmdump-<section>.\fIN\fR\fR, uncompress the file to \fBvmcore-<section>.\fIN\fR\fR and \fBunix.\fIN\fR\fR, where \fIN\fR is the same number as in the compressed name. .sp This option may also be useful if the information stored on the dump device has been copied to an on-disk file by means of the \fBdd\fR(8) command. .RE .sp .ne 2 .mk .na \fB\fB-H\fR\fR .ad .br .sp .6 .RS 4n Omits the column headers. .RE .sp .ne 2 .mk .na \fB\fB-L\fR\fR .ad .br .sp .6 .RS 4n Save a crash dump of the live running Solaris system, without actually rebooting or altering the system in any way. This option forces \fBsavecore\fR to save a live snapshot of the system to the dump device, and then immediately to retrieve the data and to write it out to a new set of crash dump files in the specified directory. Live system crash dumps can only be performed if you have configured your system to have a dedicated dump device using \fBdumpadm\fR(8). .sp \fBsavecore\fR \fB-L\fR does not suspend the system, so the contents of memory continue to change while the dump is saved. This means that live crash dumps are not fully self-consistent. .RE .sp .ne 2 .mk .na \fB\fB-l\fR\fR .ad .br .sp .6 .RS 4n If no \fIdumpfile\fR is specified, lists sections dumped on to the dump device, but not extracted yet. If \fB-d\fR is specified, lists all sections dumped on to the dump devices including those already extracted. .sp If a \fIdumpfile\fR is specified with the \fB-f\fR option, list sections present in the dump file. The \fB-d\fR does not make any difference when \fB-f\fR is specified. .RE .sp .ne 2 .mk .na \fB\fB-s\fR \fIsection_list\fR\fR .ad .br .sp .6 .RS 4n Selective extraction of sections from dump device. List of available sections can be acquired using the \fB-l\fR option. By default all available sections are extracted. Individual members of the list are divided by comma character. .sp List of possible sections names: .sp .ne 2 .mk .na \fB\fBmain\fR\fR .ad .RS 9n .rt Kernel pages. .RE .sp .ne 2 .mk .na \fB\fBproc\fR\fR .ad .RS 9n .rt Pages mapped to process address space. .RE .sp .ne 2 .mk .na \fB\fBzfs\fR\fR .ad .RS 9n .rt Pages with ZFS metadata. .RE .sp .ne 2 .mk .na \fB\fBother\fR\fR .ad .RS 9n .rt Free pages or pages used for ZFS data. Only valid for crash dumps produced with the \fB-c all\fR setting. .RE .RE .sp .ne 2 .mk .na \fB\fB-u\fR\fR .ad .br .sp .6 .RS 4n Extract \fBunix.N\fR binary from \fBvmcore.N\fR. .RE .sp .ne 2 .mk .na \fB\fB-V\fR\fR .ad .br .sp .6 .RS 4n Verify digest stored in the dump file against its contents and exit. This option has to be run together with the \fB-f\fR option. .RE .sp .ne 2 .mk .na \fB\fB-v\fR\fR .ad .br .sp .6 .RS 4n Verbose. Enables verbose error messages from \fBsavecore\fR. .RE .sp .ne 2 .mk .na \fB\fB-z\fR\fR .ad .br .sp .6 .RS 4n Size. It reads the dump file header and print the uncompressed size in bytes. .RE .sp .ne 2 .mk .na \fB\fB-h\fR\fR .ad .br .sp .6 .RS 4n Size with units. If used with \fB-z\fR option, it reads the dump file header and print the uncompressed size with units. .RE .sp .ne 2 .mk .na \fB\fB--scale[=item1,item2,...\fR]\fR .ad .br .sp .6 .RS 4n All sizes are scaled to a human readable format, for example, \fB14K\fR, \fB234M\fR, \fB2.7G\fR, or \fB3.0T\fR. Scaling is done by repetitively dividing by \fB1024\fR, unless otherwise specified. \fB--scale\fR specified without arguments enables default scaled output, and is equivalent to \fB--scale=max,1024\fR. See \fBscale\fR(7) for a complete description of \fB--scale\fR features. .RE .SH EXAMPLES .LP \fBExample 1\fR Manually Extract Only \fBproc\fR Section From the Dump Device .sp .LP The following command manually extracts only \fBproc\fR section from the dump device: .sp .in +2 .nf # \fBsavecore -v -s proc\fR .fi .in -2 .sp .sp .LP The following command decompresses all extracted \fBvmdump-*.3\fR files into corresponding \fBvmcore-*.3\fR files: .sp .in +2 .nf # \fBsavecore 3\fR .fi .in -2 .sp .SH FILES .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>/\fBvmdump.N\fR (compressed kernel image) .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>/\fBvmcore.N\fR .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>/\fBvmdump-zfs.N\fR (compressed ZFS metadata) .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>/\fBvmcore-zfs.N\fR .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>/\fBvmdump-proc.N\fR (compressed process pages) .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>/\fBvmcore-proc.N\fR .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>/\fBvmdump-other.N\fR (compressed other pages) .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>/\fBvmcore-other.N\fR .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>/\fBunix.N\fR (kernel binary) .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>/\fBlatest\fR (symlink to <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR> of the most recent crash dump to be collected) .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>/\fBN\fR (symlink to <\fIdirectory\fR>\fB/data\fR/<\fIuuid\fR>) .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>/\fBbounds\fR .RE .RS +4 .TP .ie t \(bu .el o <\fIdirectory\fR>/\fBminfree\fR .RE .RS +4 .TP .ie t \(bu .el o \fB/var/crash/\fR (default crash dump directory) .RE .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Availability system/core-os .TE .sp .SH SEE ALSO .sp .LP \fBmdb\fR(1), \fBsvcs\fR(1), \fBsyslog\fR(3C), \fBfma\fR(3M), \fBattributes\fR(7), \fBsmf\fR(7), \fBdd\fR(8), \fBdumpadm\fR(8), \fBsvcadm\fR(8) .SH NOTES .sp .LP The system crash dump service is managed by the service management facility, \fBsmf\fR(7), under the service identifier: .sp .in +2 .nf svc:/system/dumpadm:default .fi .in -2 .sp .sp .LP Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using \fBsvcadm\fR(8). The service's status can be queried using the \fBsvcs\fR(1) command. .sp .LP If the dump device is also being used as a swap device, you must run \fBsavecore\fR very soon after booting, before the swap space containing the crash dump is overwritten by programs currently running. .sp .LP When \fBsavecore\fR creates a file it appends the suffix \fB.partial\fR. After the file is completed, it is renamed without the suffix. If files are found in the dump directory with this suffix, it means that either \fBsavecore\fR is still busy, or that it was interrupted before completely writing the file. In the former case, use \fBps\fR(1) to find the PID of the running \fBsavecore\fR process and wait for it to complete. In the latter case, remove the partial file and re-create it by running \fBsavecore\fR \fB-d\fR.