dumpfilter

TriggerTek Logo
abcdefghijklmnopqrstuvwxyz_
DUMPFILTER(8)							DUMPFILTER(8)



NAME
       dumpfilter - create a filtered dump file.

SYNOPSIS
       dumpfilter [ -f ] [ -l dump_level ] [ -p ] [ -v ] oldvmcore newvmcore

       dumpfilter -V

DESCRIPTION
       dumpfilter reads data from an original vmcore file which is created by
       savecore(8) , and creates a filtered dump  file.	  dumpfilter  accepts
       only  a vmcore file created with compressed dump.  dumpfilter provides
       dump filtering feature that is almost same as partial dump feature  by
       diskdump,  and eliminates some pages that are not usually required for
       fault analysis from the original full dump so that  it  can  create  a
       smaller	dump file with the full dump.  The dump file which is created
       by dumpfilter should be analyzed by the crash(8) utility	 as  well  as
       the  original vmcore file.  dumpfilter returns 1 if it fails due to an
       error.  Otherwise it returns 0.

OPTIONS
       -f     Overwrite an existing file.

       -l dump_level
	      Specify  a  dump	level  (default:  19).	 See  the  README  of
	      diskdumputils to learn the dump level.

       -p     Display progress for creating a dump file.

       -v     Provide some verbose outputs.

       -V     Show version information and exit.



SEE ALSO
       savecore(8),	    diskdumpctl_proc(8),	diskdumpctl_sysfs(8),
       diskdumpfmt(8), crash(8)


NOTE
       dumpfilter cannot eliminate free pages from  the	 vmcore	 file.	 This
       point  is  the  only difference between the dump filtering feature and
       the partial dump feature.  For example, as for  dumpfilter  ,  a	 dump
       file  created  with  dump  level 17 is identical with one created with
       dump level 21.



								DUMPFILTER(8)