unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 crashconf(1M)						       crashconf(1M)




 NAME
      crashconf - configure system crash dumps

 SYNOPSIS
      /sbin/crashconf [-arv] [-i|-e class] ...	[device...]

 DESCRIPTION
      crashconf displays and/or changes the current system crash dump
      configuration.  The crash dump configuration consists of three lists:

      +	   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.

      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.

      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.

      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,
      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.)

    Options




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 crashconf(1M)						       crashconf(1M)




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

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

      -v   Displays the current crash dump configuration.  This is the
	   default option if no arguments are specified.  If any changes to
	   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
      Upon exit, crashconf returns the following values:

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

 WARNINGS
      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
      crashconf was developed by HP.

 SEE ALSO
      lvcreate(1M), crashconf(2), pstat(2), fstab(4).




 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000