HSAVMCORE.CONF(5)

NAME
hsavmcore.conf - Configuration file for the hsavmcore tool

DESCRIPTION
The hsavmcore.conf configuration file contains the configuration information for the hsavmcore tool. All specifications in the configuration file are optional. The command defaults apply for omitted parameters.

  verbose
This parameter sets the verbosity level of the output messages. The following pre-defined numeric values can be used:

    -   0 - show only error messages (default)

    -   1 - show error and warning messages

    -   2 - show error, warning and information messages

    -   3 - show error, warning, information and debug messages

    -   4 - show error, warning, information, debug and trace messages

  mount_debugfs
Mount (1) or do not mount (0) debugfs. Use this configuration if the kdump kernel does not mount the debugfs during the boot process.

  workdir
Specifies a work directory on the kdump system where the hsavmcore tool can create temporary files. This specification is required if use_hsa_mem is set to 0.

  use_hsa_mem
Cache the HSA memory in regular memory (1) or in a file on a file system (0).

  hsa_size
Specify a value, in bytes, for the HSA memory size instead of reading the size from /sys/kernel/debug/zcore/hsa. This parameter is intended only to test the hsavmcore tool without being in a kdump kernel. Specifying -1 falls back to reading the size from /sys/kernel/debug/zcore/hsa.

  release_hsa
Release (1) or do not release (0) the HSA memory after it is cached by the hsavmcore tool.

  bind_mount_vmcore
Replace (1) the original vmcore file with the new file created by the hsavmcore tool or keep the original file (0), which no longer contains the information from the HSA memory. Set this parameter to 1 if you intend to use kdump tools to create a core dump.

  swap
Specify a swap device or file through its path in a kdump system. The specified swap device or file must exist and have the proper swap format. You might need a swap device because the amount of memory available in the kdump kernel during a stand-alone dump is limited to the size of the HSA memory.

  fuse_debug
Enable (1) or disable (0) fuse debugging.

EXAMPLES
A complete configuration file could look like this:
------------------------------ config file start ------------------------------
# Example configuration for hsavmcore
# 0 - ERROR
# 1 - WARN
# 2 - INFO
# 3 - DEBUG
# 4 - TRACE
verbose = 3
workdir = /var/crash
mount_debugfs = 1
use_hsa_mem = 1
hsa_size = -1
release_hsa = 1
bind_mount_vmcore = 1
swap = /dev/disk/by-uuid/3cf6630b-4c4d-49ac-a0ae-0f5484cb5721
#swap = /swap.img
fuse_debug = 0
------------------------------ config file end ------------------------------

SEE ALSO
hsavmcore(8)