savecore(8) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

savecore(8)

savecore(8)             System Administration Commands             savecore(8)

NAME
       savecore - save a crash dump of the operating system

SYNOPSIS
       savecore [-dNrvVz] [-D dirname] [-s secname] [-f dumpfile] [suffix]
       savecore -L [-v] [-D dirname]
       savecore -u [-dv] [-D dirname] [-f dumpfile]
       savecore -l [-H] [-f dumpfile]
       savecore -r [-v]
       savecore -z [-h] -f dumpfile [--scale[=item1,item2,...]]

DESCRIPTION
       The  savecore  utility  saves a crash dump of the kernel (assuming that
       one was made) and writes a reboot message in the system log. It is  in‐
       voked by the dumpadm service each time the system boots.


       savecore can be configured by dumpadm(8) to save crash dump data in ei‐
       ther  a  compressed or uncompressed format. Crash dump data are divided
       on the dump device into sections, depending  on  dumpadm(8)  configura‐
       tion.  For the compressed format, savecore saves the crash dump data in
       files called vmdump-<section>.N, where section is the name of  the  ac‐
       tual  section;  the  actual  number  of  files  produced depends on the
       dumpadm(8) configuration and on how savecore is run. N 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 subdi‐
       rectory created under directory specified with the  -D  option  or  the
       crash  dump  directory as configured by dumpadm(8). The subdirectory is
       in the form of data/<uuid>, where uuid matches the unique  FMA  identi‐
       fier of this particular panic event.


       The suffix argument specifies numerical suffix. If savecore is run with
       the  suffix  argument it will attempt to uncompress all files named vm‐
       dump-<section>.N, where N is equal to the suffix argument.  The  suffix
       argument is not valid when used together with the -f option.


       All  compressed  files can be uncompressed in a separate step using the
       suffix argument or individually using the -f dumpfile option.  For  the
       uncompressed format, savecore saves the crash dump data in the file di‐
       rectory/vmcore-<section>.N  files  and  the kernel's namelist in direc‐
       tory/unix.N.


       Integrity verification of vmdump-*.N files from remote system  is  done
       when  extraction  is performed to vmcore-*.N file. It can be done sepa‐
       rately without the extraction using the -V option. If the  verification
       fails, savecore marks the file as incomplete.


       Before  writing out a crash dump, savecore reads a number from the file
       directory/minfree. This is the minimum number of  kilobytes  that  must
       remain  free  on  the file system containing directory. If after saving
       the crash dump the file system containing  directory  would  have  less
       free space the number of kilobytes specified in minfree, the crash dump
       is  not  saved.  If the minfree file does not exist, savecore assumes a
       minfree value of 1 megabyte. Use the -m option  to  dumpadm(8)  to  set
       this value.


       The savecore utility also logs a reboot message using facility LOG_AUTH
       (see  syslog(3C)).  If  the  system  crashed  as  a  result of a panic,
       savecore logs the panic string too.


       The savecore utility also produces fma(3M) event if the system rebooted
       after panic.

OPTIONS
       The following options are supported:

       -D directory

           Save the crash dump files to the specified directory. If the direc‐
           tory option is not specified, savecore saves the crash  dump  files
           to  the default savecore directory, derived from the directory con‐
           figured by dumpadm(8).


       -d

           Disregard dump header valid flag. Force savecore to attempt to save
           a crash dump even if the header information stored on the dump  de‐
           vice indicates the dump has already been saved.


       -f dumpfile

           Save  a crash dump from the specified file instead of from the sys‐
           tem's current dump device. When given directory/vmdump-<section>.N,
           uncompress the file to vmcore-<section>.N and unix.N,  where  N  is
           the same number as in the compressed name.

           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
           dd(8) command.


       -h

           Display the output from the -z option in a more human readable for‐
           mat.  The -h option is equivalent to using the --scale=max,1024 op‐
           tion.


       -H

           Omits the column headers.


       -L

           Save a crash dump of the live running Solaris system, without actu‐
           ally rebooting or altering the  system  in  any  way.  This  option
           forces  savecore  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  config‐
           ured your system to have a dedicated dump device using dumpadm(8).

           savecore  -L 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.


       -l

           If no dumpfile is specified, lists sections dumped on to  the  dump
           device,  but  not extracted yet. If -d is specified, lists all sec‐
           tions dumped on to the dump devices  including  those  already  ex‐
           tracted.

           If  a  dumpfile  is  specified  with  the  -f option, list sections
           present in the dump file. The -d does not make any difference  when
           -f is specified.


       -s section_list

           Selective extraction of sections from dump device. A list of avail‐
           able  sections  can be acquired using the -l option. By default all
           available sections are extracted. Individual members  of  the  list
           are divided by comma character.

           List of possible sections names:

           main     Kernel pages.


           proc     Pages mapped to process address space.


           zfs      Pages with ZFS metadata.


           other    Free  pages  or  pages  used  for ZFS data. Only valid for
                    crash dumps produced with the -c all setting.



       -u

           Extract unix.N binary from vmcore.N.


       -V

           Verify digest stored in the dump  file  against  its  contents  and
           exit. This option has to be run together with the -f option.


       -v

           Verbose. Enables verbose error messages from savecore.


       -z

           Display  the  uncompressed size from the dump file header. The size
           is given in bytes unless modified with the -h or --scale options.


       --scale[=item1,item2,...]

           All sizes are scaled to a human readable format, for example,  14K,
           234M,  2.7G,  or  3.0T. Scaling is done by repetitively dividing by
           1024, unless otherwise specified. --scale specified  without  argu‐
           ments   enables   default  scaled  output,  and  is  equivalent  to
           --scale=max,1024.  See  scale(7)  for  a  complete  description  of
           --scale features.


EXAMPLES
       Example 1 Manually Extract Only proc Section From the Dump Device



       The following command manually extracts only proc section from the dump
       device:


         # savecore -v -s proc




       The  following command decompresses all extracted vmdump-*.3 files into
       corresponding vmcore-*.3 files:


         # savecore 3


FILES
           o      <directory>/data/<uuid>/vmdump.N (compressed kernel image)


           o      <directory>/data/<uuid>/vmcore.N


           o      <directory>/data/<uuid>/vmdump-zfs.N (compressed  ZFS  meta‐
                  data)


           o      <directory>/data/<uuid>/vmcore-zfs.N


           o      <directory>/data/<uuid>/vmdump-proc.N   (compressed  process
                  pages)


           o      <directory>/data/<uuid>/vmcore-proc.N


           o      <directory>/data/<uuid>/vmdump-other.N   (compressed   other
                  pages)


           o      <directory>/data/<uuid>/vmcore-other.N


           o      <directory>/data/<uuid>/unix.N (kernel binary)


           o      <directory>/latest  (symlink  to  <directory>/data/<uuid> of
                  the most recent crash dump to be collected)


           o      <directory>/N (symlink to <directory>/data/<uuid>)


           o      <directory>/bounds


           o      <directory>/minfree


           o      /var/crash/ (default crash dump directory)


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ Availabilitysystem/core-os


SEE ALSO
       mdb(1),  svcs(1), syslog(3C), fma(3M), attributes(7), scale(7), smf(7),
       dd(8), dumpadm(8), svcadm(8)

NOTES
       The system crash dump service is managed by the service management  fa‐
       cility, smf(7), under the service identifier:

         svc:/system/dumpadm:default



       Administrative actions on this service, such as enabling, disabling, or
       requesting  restart,  can  be  performed using svcadm(8). The service's
       status can be queried using the svcs(1) command.


       If the dump device is also being used as a swap device,  you  must  run
       savecore  very soon after booting, before the swap space containing the
       crash dump is overwritten by programs currently running.


       When savecore creates a file it appends the suffix .partial. 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 savecore
       is still busy, or that it was interrupted before completely writing the
       file. In the former case, use ps(1) to find  the  PID  of  the  running
       savecore  process  and wait for it to complete. In the latter case, re‐
       move the partial file and re-create it by running savecore  -d.

Oracle Solaris 11.4               23 Jun 2025                      savecore(8)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3