Scroll to navigation

HSAVMCORE.CONF(5) File Formats Manual 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)

May 2021 s390-tools