*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> crashconf (1m)              
Title
Content
Arch
Section
 

Contents


 crashconf(1M)                                                 crashconf(1M)




 NAME    [Toc]    [Back]
      crashconf - configure system crash dumps

 SYNOPSIS    [Toc]    [Back]
      /sbin/crashconf [-artv] [-i|-e class] [-c mode] ...  [device...]

 DESCRIPTION    [Toc]    [Back]
      crashconf displays and/or changes the current system crash dump
      configuration.  The crash dump configuration consists of:

      +  The crash dump device list.  This list identifies all devices that
         can be used to store a crash dump.

      +  The included class list.  This list identifies all system memory
         classes that must be included in any crash dump.

      +  The excluded class list.  This list identifies all system memory
         classes that should not be included in a crash dump.

      +  The compression mode selection.  This selection is used to turn
         compression ON or OFF, before dumping.

      Most system memory classes are in neither the included class list nor
      the excluded class list.  Instead, the system determines whether or
      not to dump those classes of memory based on the type of crash that
      occurs.

      Note the system operator may request a full crash dump at the time the
      dump is taken.  In this case, a full dump will be performed regardless
      of the contents of the excluded class list.

      Turning compression mode ON will result in faster and smaller dumps.
      If the dump is compressed, savecrash will also copy over the dump
      faster since the dump will be smaller in size.

      Since compressed dump requires additional processors and memory to do
      the compression, the system may fall back on uncompressed dump if it
      could not identify the processing resources required to do compressed
      dump.

      Any changes to the configuration take effect immediately and remain in
      effect until the next system reboot, or until changed with a
      subsequent invocation of crashconf.  Using the option -t, changes to
      the include and exclude class lists and compression mode can be made
      persistent across system reboots.  But the changes do not persist
      across kernel rebuilds.  Use SAM or kctune(1M) to do this.

      device specifies a block device file name of a device that is a valid
      destination for crash dumps.  All such devices listed on the command
      line will be added to the end of the current list of crash dump
      devices, or will replace the current list of crash dump devices,



 Hewlett-Packard Company            - 1 -      HP-UX 11i Version 2: Sep 2004






 crashconf(1M)                                                 crashconf(1M)




      depending on whether -r is specified.

      class is the name (or number) of a system memory class which should be
      added to the appropriate class list.  The list of system memory
      classes can be obtained using crashconf -v.  The memory page size is
      4Kb.

      class may also be the word all, in which case all classes are added to
      the appropriate list.  (The effect of adding all classes to the
      included class list is to force full crash dumps under all
      circumstances.  The effect of adding all classes to the excluded class
      list is to disable crash dumps.)

      mode, either ON or OFF, will turn compression ON or OFF, in the dump
      path.

    Options    [Toc]    [Back]
      -a   The file /etc/fstab is read, and all dump devices identified in
           it will be added to (or will replace) the current list of crash
           dump devices.  This is in addition to any crash dump devices
           specified on the command line.  See fstab(4) for information on
           the format of /etc/fstab.

      -c   The mode specified with -c will be used to set the compression
           mode.  If the system is not able to identify enough processing
           resources to do compressed dump, a warning message will be
           issued.

      -e   The classes specified with -e will be added to (or will replace)
           the list of excluded (i.e., should not dump) classes.  If any of
           those classes are present in the current included class list,
           they will be removed from it.

      -i   The classes specified with -i will be added to (or will replace)
           the list of included (i.e., must dump) classes.  If any of those
           classes are present in the current excluded class list, they will
           be removed from it.

      -r   Specifies that any changes should replace, rather than add to,
           the current configuration.  Thus, if devices or -a are specified,
           the current crash dump device list is replaced with new contents;
           if classes are specified with -e, they replace the list of
           currently excluded classes, and if classes are specified with -i,
           they replace the list of currently included classes.

      -t   When used with the -i, -e or -c options, sets the dump tunables
           alwaysdump, dontdump and dump_compress_on respectively, to make
           the changes persistent across system reboots.

      -v   Displays the current crash dump configuration.  This is the
           default option if no arguments are specified.  If any changes to



 Hewlett-Packard Company            - 2 -      HP-UX 11i Version 2: Sep 2004






 crashconf(1M)                                                 crashconf(1M)




           the current configuration are specified on the same command line
           as -v, the configuration will be displayed after the requested
           changes are made.

 RETURN VALUE    [Toc]    [Back]
      Upon exit, crashconf returns the following values:

           0    Success.
           1    The requested configuration changes could not be made.

 WARNINGS    [Toc]    [Back]
      On systems running VxVM 3.5, the swap volumes to be configured for
      system crash dumps should be created with the usage type as swap
      during the creation of the swap volume.  Not doing so will cause dump
      corruption.  You could use the -U option of vxassist(1M) to do the
      same.

      The output of crashconf is not designed to be parsed by applications
      or scripts, but only to be read by humans.  The output format may
      change without notice.  Applications which require crash dump
      configuration information should retrieve that information using
      pstat(2).

      Dump devices created by lvcreate(1M) must be contiguous (-Cy option)
      with bad block relocation turned off (-rn option).

 AUTHOR    [Toc]    [Back]
      crashconf was developed by HP.

 SEE ALSO    [Toc]    [Back]
      lvcreate(1M), vxassist(1M), crashconf(2), pstat(2), fstab(4).


 Hewlett-Packard Company            - 3 -      HP-UX 11i Version 2: Sep 2004
[ Back ]
      
      
 Similar pages
Name OS Title
dumpon FreeBSD specify a device for crash dumps
rdump Tru64 Performs incremental file system dumps
dump Tru64 Performs incremental file system dumps
panic Tru64 General: Causes a system crash
icrash IRIX IRIX system crash analysis utility
savecrash HP-UX save a crash dump of the operating system
dump_compress_on HP-UX selects whether the system dumps memory pages compressed or uncompressed when a kernel panic occurs.
savecore IRIX save a crash vmcore dump of the operating system
trcore IRIX truncate a crash vmcore dump of the operating system
lpadmin HP-UX configure the LP spooling system
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service