Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified	Actions
📁 ..	-	2026-03-21 15:44
📁 dracut.conf.d	-	2026-03-21 15:53
📄 kdump-lib-initramfs.sh #!/usr/bin/sh # # The code in this file will be used in initramfs environment, bash may # not be the default shell. Any code added must be POSIX compliant. DEFAULT_PATH="/var/crash/" KDUMP_CONFIG_FILE="/etc/kdump.conf" FENCE_KDUMP_CONFIG_FILE="/etc/sysconfig/fence_kdump" FENCE_KDUMP_SEND="/usr/libexec/fence_kdump_send" LVM_CONF="/etc/lvm/lvm.conf" # Read kdump config in well formated style kdump_read_conf() { # Following steps are applied in order: strip trailing comment, strip trailing space, # strip heading space, match non-empty line, remove duplicated spaces between conf name and value [ -f "$KDUMP_CONFIG_FILE" ] && sed -n -e "s/#.//;s/\s$//;s/^\s//;s/\(\S\+\)\s\(.\)/\1 \2/p" $KDUMP_CONFIG_FILE } # Retrieves config value defined in kdump.conf # $1: config name, sed regexp compatible kdump_get_conf_val() { # For lines matching "^\s$1\s+", remove matched part (config name including space), # remove tailing comment, space, then store in hold space. Print out the hold buffer on last line. [ -f "$KDUMP_CONFIG_FILE" ] && sed -n -e "/^\s\($1\)\s\+/{s/^\s\($1\)\s\+//;s/#.//;s/\s$//;h};\${x;p}" $KDUMP_CONFIG_FILE } is_mounted() { findmnt -k -n "$1" > /dev/null 2>&1 } # $1: info type # $2: mount source type # $3: mount source # $4: extra args get_mount_info() { __kdump_mnt=$(findmnt -k -n -r -o "$1" "--$2" "$3" $4) [ -z "$__kdump_mnt" ] && [ -e "/etc/fstab" ] && __kdump_mnt=$(findmnt -s -n -r -o "$1" "--$2" "$3" $4) echo "$__kdump_mnt" } is_ipv6_address() { echo "$1" \| grep -q ":" } is_fs_type_nfs() { [ "$1" = "nfs" ] \|\| [ "$1" = "nfs4" ] } is_fs_type_virtiofs() { [ "$1" = "virtiofs" ] } # If $1 contains dracut_args "--mount", return <filesystem type> get_dracut_args_fstype() { echo $1 \| grep "\-\-mount" \| sed "s/.--mount .\(.\)/\1/" \| cut -d' ' -f3 } # If $1 contains dracut_args "--mount", return <device> get_dracut_args_target() { echo $1 \| grep "\-\-mount" \| sed "s/.--mount .\(.\)/\1/" \| cut -d' ' -f1 } get_save_path() { __kdump_path=$(kdump_get_conf_val path) [ -z "$__kdump_path" ] && __kdump_path=$DEFAULT_PATH # strip the duplicated "/" echo "$__kdump_path" \| tr -s / } get_root_fs_device() { findmnt -k -f -n -o SOURCE / } # Return the current underlying device of a path, ignore bind mounts get_target_from_path() { __kdump_target=$(df "$1" 2> /dev/null \| tail -1 \| awk '{print $1}') [ "$__kdump_target" = "/dev/root" ] && [ ! -e /dev/root ] && __kdump_target=$(get_root_fs_device) echo "$__kdump_target" } get_fs_type_from_target() { get_mount_info FSTYPE source "$1" -f } get_mntpoint_from_target() { local _mntpoint # get the first TARGET when SOURCE doesn't end with ]. # In most cases, a SOURCE ends with ] when fsroot or subvol exists. _mntpoint=$(get_mount_info TARGET,SOURCE source "$1" \| grep -v "\]$" \| awk 'NR==1 { print $1 }') # fallback to the old way when _mntpoint is empty. [[ -n "$_mntpoint" ]] \|\| _mntpoint=$(get_mount_info TARGET source "$1" -f ) echo $_mntpoint } is_ssh_dump_target() { kdump_get_conf_val ssh \| grep -q @ } is_raw_dump_target() { [ -n "$(kdump_get_conf_val raw)" ] } is_virtiofs_dump_target() { if [ -n "$(kdump_get_conf_val virtiofs)" ]; then return 0 fi if is_fs_type_virtiofs "$(get_dracut_args_fstype "$(kdump_get_conf_val dracut_args)")"; then return 0 fi if is_fs_type_virtiofs "$(get_fs_type_from_target "$(get_target_from_path "$(get_save_path)")")"; then return 0 fi return 1 } is_nfs_dump_target() { if [ -n "$(kdump_get_conf_val nfs)" ]; then return 0 fi if is_fs_type_nfs "$(get_dracut_args_fstype "$(kdump_get_conf_val dracut_args)")"; then return 0 fi if is_fs_type_nfs "$(get_fs_type_from_target "$(get_target_from_path "$(get_save_path)")")"; then return 0 fi return 1 } fs_dump_target() { kdump_get_conf_val "ext[234]\\|xfs\\|btrfs\\|minix\\|virtiofs" } is_fs_dump_target() { [ -n "$(fs_dump_target)" ] } is_lvm2_thinp_device() { _device_path=$1 _lvm2_thin_device=$(lvm lvs -S 'lv_layout=sparse && lv_layout=thin' \ --nosuffix --noheadings -o vg_name,lv_name "$_device_path" 2> /dev/null) [ -n "$_lvm2_thin_device" ] } kdump_get_ip_route() { if ! _route=$(/sbin/ip -o route get to "$1" 2>&1); then exit 1 fi echo "$_route" } kdump_get_ip_route_field() { echo "$1" \| sed -n -e "s/^.\<$2\>\s\+\(\S\+\).$/\1/p" }	4.22 KB	2025-09-24 06:15
📄 kdump-lib.sh #!/usr/bin/bash # # Kdump common variables and functions # . /usr/lib/kdump/kdump-lib-initramfs.sh FADUMP_ENABLED_SYS_NODE="/sys/kernel/fadump/enabled" FADUMP_REGISTER_SYS_NODE="/sys/kernel/fadump/registered" FADUMP_APPEND_ARGS_SYS_NODE="/sys/kernel/fadump/bootargs_append" is_uki() { local img img="$1" [[ -f "$img" ]] \|\| return [[ "$(objdump -a "$img" 2> /dev/null)" =~ pei-(x86-64\|aarch64-little) ]] \|\| return objdump -h -j .linux "$img" &> /dev/null } is_fadump_capable() { # Check if firmware-assisted dump is enabled # if no, fallback to kdump check if [[ -f $FADUMP_ENABLED_SYS_NODE ]]; then rc=$(< $FADUMP_ENABLED_SYS_NODE) [[ $rc -eq 1 ]] && return 0 fi return 1 } is_sme_or_sev_active() { journalctl -q --dmesg --grep "^Memory Encryption Features active: AMD (SME\|SEV)$" >/dev/null 2>&1 } is_squash_available() { local _version kmodule _version=$(_get_kdump_kernel_version) for kmodule in squashfs overlay loop; do modprobe -S "$_version" --dry-run $kmodule &> /dev/null \|\| return 1 done } is_zstd_command_available() { [[ -x "$(command -v zstd)" ]] } dracut_have_option() { local _option=$1 ! dracut "$_option" 2>&1 \| grep -q "unrecognized option" } perror_exit() { derror "$@" exit 1 } # Check if fence kdump is configured in Pacemaker cluster is_pcs_fence_kdump() { # no pcs or fence_kdump_send executables installed? type -P pcs > /dev/null \|\| return 1 [[ -x $FENCE_KDUMP_SEND ]] \|\| return 1 # fence kdump not configured? (pcs cluster cib \| grep 'type="fence_kdump"') &> /dev/null \|\| return 1 } # Check if fence_kdump is configured using kdump options is_generic_fence_kdump() { [[ -x $FENCE_KDUMP_SEND ]] \|\| return 1 [[ $(kdump_get_conf_val fence_kdump_nodes) ]] } to_dev_name() { local dev="${1//\"/}" case "$dev" in UUID=) blkid -U "${dev#UUID=}" ;; LABEL=) blkid -L "${dev#LABEL=}" ;; ) echo "$dev" ;; esac } is_user_configured_dump_target() { [[ $(kdump_get_conf_val "ext[234]\\|xfs\\|btrfs\\|minix\\|raw\\|nfs\\|ssh\\|virtiofs") ]] \|\| is_mount_in_dracut_args } get_block_dump_target() { local _target _fstype if is_ssh_dump_target \|\| is_nfs_dump_target; then return fi _target=$(kdump_get_conf_val "ext[234]\\|xfs\\|btrfs\\|minix\\|raw\\|virtiofs") [[ -n $_target ]] && to_dev_name "$_target" && return _target=$(get_dracut_args_target "$(kdump_get_conf_val "dracut_args")") [[ -b $_target ]] && to_dev_name "$_target" && return _fstype=$(get_dracut_args_fstype "$(kdump_get_conf_val "dracut_args")") is_fs_type_virtiofs "$_fstype" && echo "$_target" && return _target=$(get_target_from_path "$(get_save_path)") [[ -b $_target ]] && to_dev_name "$_target" && return _fstype=$(get_fs_type_from_target "$_target") is_fs_type_virtiofs "$_fstype" && echo "$_target" && return } is_dump_to_rootfs() { [[ $(kdump_get_conf_val 'failure_action\\|default') == dump_to_rootfs ]] } is_lvm2_thinp_dump_target() { _target=$(get_block_dump_target) [ -n "$_target" ] && is_lvm2_thinp_device "$_target" } get_failure_action_target() { local _target if is_dump_to_rootfs; then # Get rootfs device name _target=$(get_root_fs_device) [[ -b $_target ]] && to_dev_name "$_target" && return is_fs_type_virtiofs "$(get_fs_type_from_target "$_target")" && echo "$_target" && return # Then, must be nfs root echo "nfs" fi } # Get kdump targets(including root in case of dump_to_rootfs). get_kdump_targets() { local _target _root local kdump_targets _target=$(get_block_dump_target) if [[ -n $_target ]]; then kdump_targets=$_target elif is_ssh_dump_target; then kdump_targets="ssh" else kdump_targets="nfs" fi # Add the root device if dump_to_rootfs is specified. _root=$(get_failure_action_target) if [[ -n $_root ]] && [[ $kdump_targets != "$_root" ]]; then kdump_targets="$kdump_targets $_root" fi echo "$kdump_targets" } # Return the bind mount source path, return the path itself if it's not bind mounted # Eg. if /path/to/src is bind mounted to /mnt/bind, then: # /mnt/bind -> /path/to/src, /mnt/bind/dump -> /path/to/src/dump # # findmnt uses the option "-v, --nofsroot" to exclusive the [/dir] # in the SOURCE column for bind-mounts, then if $_src equals to # $_src_nofsroot, the mountpoint is not bind mounted directory. # # Below is just an example for mount info # /dev/mapper/atomicos-root[/ostree/deploy/rhel-atomic-host/var], if the # directory is bind mounted. The former part represents the device path, rest # part is the bind mounted directory which quotes by bracket "[]". get_bind_mount_source() { local _mnt _path _src _opt _fstype local _fsroot _src_nofsroot _mnt=$(df "$1" \| tail -1 \| awk '{print $NF}') _path=${1#$_mnt} _src=$(get_mount_info SOURCE target "$_mnt" -f) _opt=$(get_mount_info OPTIONS target "$_mnt" -f) _fstype=$(get_mount_info FSTYPE target "$_mnt" -f) # bind mount in fstab if [[ -d $_src ]] && [[ $_fstype == none ]] && (echo "$_opt" \| grep -q "\bbind\b"); then echo "$_src$_path" && return fi # direct mount _src_nofsroot=$(get_mount_info SOURCE target "$_mnt" -v -f) if [[ $_src_nofsroot == "$_src" ]]; then echo "$_mnt$_path" && return fi _fsroot=${_src#${_src_nofsroot}[} _fsroot=${_fsroot%]} _mnt=$(get_mntpoint_from_target "$_src_nofsroot") # for btrfs, _fsroot will also contain the subvol value as well, strip it if [[ $_fstype == btrfs ]]; then local _subvol _subvol=${_opt#subvol=} _subvol=${_subvol%,} _fsroot=${_fsroot#$_subvol} fi echo "$_mnt$_fsroot$_path" } get_mntopt_from_target() { get_mount_info OPTIONS source "$1" -f } # Get the path where the target will be mounted in kdump kernel # $1: kdump target device get_kdump_mntpoint_from_target() { local _mntpoint _mntpoint=$(get_mntpoint_from_target "$1") # mount under /sysroot if dump to root disk or mount under # mount under /kdumproot if dump target is not mounted in first kernel # mount under /kdumproot/$_mntpoint in other cases in 2nd kernel. # systemd will be in charge to umount it. if [[ -z $_mntpoint ]]; then _mntpoint="/kdumproot" else if [[ $_mntpoint == "/" ]]; then _mntpoint="/sysroot" else _mntpoint="/kdumproot/$_mntpoint" fi fi # strip duplicated "/" echo $_mntpoint \| tr -s "/" } kdump_get_persistent_dev() { local dev="${1//\"/}" case "$dev" in UUID=) dev=$(blkid -U "${dev#UUID=}") ;; LABEL=) dev=$(blkid -L "${dev#LABEL=}") ;; esac echo $(get_persistent_dev "$dev") } is_ostree() { test -f /run/ostree-booted } # get ip address or hostname from nfs/ssh config value get_remote_host() { local _config_val=$1 # ipv6 address in kdump.conf is around with "[]", # factor out the ipv6 address _config_val=${_config_val#@} _config_val=${_config_val%:/} _config_val=${_config_val#[} _config_val=${_config_val%]} echo "$_config_val" } is_hostname() { local _hostname _hostname=$(echo "$1" \| grep ":") if [[ -n $_hostname ]]; then return 1 fi echo "$1" \| grep -q "[a-zA-Z]" } # Copied from "/etc/sysconfig/network-scripts/network-functions" get_hwaddr() { if [[ -f "/sys/class/net/$1/address" ]]; then awk '{ print toupper($0) }' < "/sys/class/net/$1/address" elif [[ -d "/sys/class/net/$1" ]]; then LC_ALL="" LANG="" ip -o link show "$1" 2> /dev/null \| awk '{ print toupper(gensub(/.link\/[^ ]* ([[:alnum:]:])./, "\\1", 1)); }' fi } # Get value by a field using "nmcli -g" # Usage: get_nmcli_value_by_field <field> <nmcli command> # # "nmcli --get-values" allows us to retrive value(s) by field, for example, # nmcli --get-values <field> connection show /org/freedesktop/NetworkManager/ActiveConnection/1 # returns the following value for the corresponding field respectively, # Field Value # IP4.DNS "10.19.42.41 \| 10.11.5.19 \| 10.5.30.160" # 802-3-ethernet.s390-subchannels "" # bond.options "mode=balance-rr" get_nmcli_value_by_field() { LANG=C nmcli --get-values "$@" } # Get nmcli field value of an connection apath (a D-Bus active connection path) # Usage: get_nmcli_field_by_apath <field> <apath> get_nmcli_field_by_conpath() { local _field=$1 _apath=$2 get_nmcli_value_by_field "$_field" connection show "$_apath" } # Get nmcli connection apath (a D-Bus active connection path ) by ifname # # apath is used for nmcli connection operations, e.g. # $ nmcli connection show $apath get_nmcli_connection_apath_by_ifname() { local _ifname=$1 get_nmcli_value_by_field "GENERAL.CON-PATH" device show "$_ifname" } get_ifcfg_by_device() { grep -E -i -l "^[[:space:]]DEVICE=\"${1}\"[[:space:]]$" \ /etc/sysconfig/network-scripts/ifcfg-* 2> /dev/null \| head -1 } get_ifcfg_by_hwaddr() { grep -E -i -l "^[[:space:]]HWADDR=\"${1}\"[[:space:]]$" \ /etc/sysconfig/network-scripts/ifcfg-* 2> /dev/null \| head -1 } get_ifcfg_by_uuid() { grep -E -i -l "^[[:space:]]UUID=\"${1}\"[[:space:]]$" \ /etc/sysconfig/network-scripts/ifcfg-* 2> /dev/null \| head -1 } get_ifcfg_by_name() { grep -E -i -l "^[[:space:]]NAME=\"${1}\"[[:space:]]$" \ /etc/sysconfig/network-scripts/ifcfg-* 2> /dev/null \| head -1 } is_nm_running() { [[ "$(LANG=C nmcli -t --fields running general status 2> /dev/null)" == "running" ]] } is_nm_handling() { LANG=C nmcli -t --fields device,state dev status 2> /dev/null \| grep -q "^\(${1}:connected\)\\|\(${1}:connecting.\)$" } # $1: netdev name get_ifcfg_nmcli() { local nm_uuid nm_name local ifcfg_file # Get the active nmcli config name of $1 if is_nm_running && is_nm_handling "${1}"; then # The configuration "uuid" and "name" generated by nm is wrote to # the ifcfg file as "UUID=<nm_uuid>" and "NAME=<nm_name>". nm_uuid=$(LANG=C nmcli -t --fields uuid,device c show --active 2> /dev/null \| grep "${1}" \| head -1 \| cut -d':' -f1) nm_name=$(LANG=C nmcli -t --fields name,device c show --active 2> /dev/null \| grep "${1}" \| head -1 \| cut -d':' -f1) ifcfg_file=$(get_ifcfg_by_uuid "${nm_uuid}") [[ -z ${ifcfg_file} ]] && ifcfg_file=$(get_ifcfg_by_name "${nm_name}") fi echo -n "${ifcfg_file}" } # $1: netdev name get_ifcfg_legacy() { local ifcfg_file hwaddr ifcfg_file="/etc/sysconfig/network-scripts/ifcfg-${1}" [[ -f ${ifcfg_file} ]] && echo -n "${ifcfg_file}" && return ifcfg_file=$(get_ifcfg_by_name "${1}") [[ -f ${ifcfg_file} ]] && echo -n "${ifcfg_file}" && return hwaddr=$(get_hwaddr "${1}") if [[ -n $hwaddr ]]; then ifcfg_file=$(get_ifcfg_by_hwaddr "${hwaddr}") [[ -f ${ifcfg_file} ]] && echo -n "${ifcfg_file}" && return fi ifcfg_file=$(get_ifcfg_by_device "${1}") echo -n "${ifcfg_file}" } # $1: netdev name # Return the ifcfg file whole name(including the path) of $1 if any. get_ifcfg_filename() { local ifcfg_file ifcfg_file=$(get_ifcfg_nmcli "${1}") if [[ -z ${ifcfg_file} ]]; then ifcfg_file=$(get_ifcfg_legacy "${1}") fi echo -n "${ifcfg_file}" } # returns 0 when omission of a module is desired in dracut_args # returns 1 otherwise is_dracut_mod_omitted() { local dracut_args dracut_mod=$1 set -- $(kdump_get_conf_val dracut_args) while [ $# -gt 0 ]; do case $1 in -o \| --omit) [[ " ${2//[^[:alnum:]]/ } " == " $dracut_mod "* ]] && return 0 ;; esac shift done return 1 } is_wdt_active() { local active [[ -d /sys/class/watchdog ]] \|\| return 1 for dir in /sys/class/watchdog/; do [[ -f "$dir/state" ]] \|\| continue active=$(< "$dir/state") [[ $active == "active" ]] && return 0 done return 1 } have_compression_in_dracut_args() { [[ "$(kdump_get_conf_val dracut_args)" =~ (^\|[[:space:]])--(gzip\|bzip2\|lzma\|xz\|lzo\|lz4\|zstd\|no-compress\|compress\|squash-compressor)([[:space:]]\|$) ]] } # If "dracut_args" contains "--mount" information, use it # directly without any check(users are expected to ensure # its correctness). is_mount_in_dracut_args() { [[ " $(kdump_get_conf_val dracut_args)" =~ .[[:space:]]--mount[=[:space:]].* ]] } get_reserved_mem_size() { local reserved_mem_size=0 if is_fadump_capable; then reserved_mem_size=$(< /sys/kernel/fadump/mem_reserved) else reserved_mem_size=$(< /sys/kernel/kexec_crash_size) fi echo "$reserved_mem_size" } check_crash_mem_reserved() { local mem_reserved mem_reserved=$(get_reserved_mem_size) if [[ $mem_reserved -eq 0 ]]; then derror "No memory reserved for crash kernel" return 1 fi return 0 } check_kdump_feasibility() { if [[ ! -e /sys/kernel/kexec_crash_loaded ]]; then derror "Kdump is not supported on this kernel" return 1 fi check_crash_mem_reserved return $? } is_kernel_loaded() { local _sysfs _mode _mode=$1 case "$_mode" in kdump) _sysfs="/sys/kernel/kexec_crash_loaded" ;; fadump) _sysfs="$FADUMP_REGISTER_SYS_NODE" ;; ) derror "Unknown dump mode '$_mode' provided" return 1 ;; esac if [[ ! -f $_sysfs ]]; then derror "$_mode is not supported on this kernel" return 1 fi [[ $(< $_sysfs) -eq 1 ]] } # # This function returns the "apicid" of the boot # cpu (cpu 0) if present. # get_bootcpu_apicid() { awk ' \ BEGIN { CPU = "-1"; } \ $1=="processor" && $2==":" { CPU = $NF; } \ CPU=="0" && /^apicid/ { print $NF; } \ ' \ /proc/cpuinfo } # This function check iomem and determines if we have more than # 4GB of ram available. Returns 1 if we do, 0 if we dont need_64bit_headers() { return "$(tail -n 1 /proc/iomem \| awk '{ split ($1, r, "-"); print (strtonum("0x" r[2]) > strtonum("0xffffffff")); }')" } # Check if secure boot is being enforced. # # Per Peter Jones, we need check efivar SecureBoot-$(the UUID) and # SetupMode-$(the UUID), they are both 5 bytes binary data. The first four # bytes are the attributes associated with the variable and can safely be # ignored, the last bytes are one-byte true-or-false variables. If SecureBoot # is 1 and SetupMode is 0, then secure boot is being enforced. # # Assume efivars is mounted at /sys/firmware/efi/efivars. is_secure_boot_enforced() { local secure_boot_file setup_mode_file local secure_boot_byte setup_mode_byte # On powerpc, secure boot is enforced if: # host secure boot: /ibm,secure-boot/os-secureboot-enforcing DT property exists # guest secure boot: /ibm,secure-boot >= 2 if [[ -f /proc/device-tree/ibm,secureboot/os-secureboot-enforcing ]]; then return 0 fi if [[ -f /proc/device-tree/ibm,secure-boot ]] && [[ $(lsprop /proc/device-tree/ibm,secure-boot \| tail -1) -ge 2 ]]; then return 0 fi # Detect secure boot on x86 and arm64 secure_boot_file=$(find /sys/firmware/efi/efivars -name "SecureBoot-" 2> /dev/null) setup_mode_file=$(find /sys/firmware/efi/efivars -name "SetupMode-" 2> /dev/null) if [[ -f $secure_boot_file ]] && [[ -f $setup_mode_file ]]; then secure_boot_byte=$(hexdump -v -e '/1 "%d\ "' "$secure_boot_file" \| cut -d' ' -f 5) setup_mode_byte=$(hexdump -v -e '/1 "%d\ "' "$setup_mode_file" \| cut -d' ' -f 5) if [[ $secure_boot_byte == "1" ]] && [[ $setup_mode_byte == "0" ]]; then return 0 fi fi # Detect secure boot on s390x if [[ -e "/sys/firmware/ipl/secure" && "$(< /sys/firmware/ipl/secure)" == "1" ]]; then return 0 fi return 1 } # # prepare_kexec_args <kexec args> # This function prepares kexec argument. # prepare_kexec_args() { local kexec_args=$1 local found_elf_args ARCH=$(uname -m) if [[ $ARCH == "i686" ]] \|\| [[ $ARCH == "i386" ]]; then need_64bit_headers if [[ $? == 1 ]]; then found_elf_args=$(echo "$kexec_args" \| grep elf32-core-headers) if [[ -n $found_elf_args ]]; then dwarn "Warning: elf32-core-headers overrides correct elf64 setting" else kexec_args="$kexec_args --elf64-core-headers" fi else found_elf_args=$(echo "$kexec_args" \| grep elf64-core-headers) if [[ -z $found_elf_args ]]; then kexec_args="$kexec_args --elf32-core-headers" fi fi fi # For secureboot enabled machines, use new kexec file based syscall. # Old syscall will always fail as it does not have capability to do # kernel signature verification. if is_secure_boot_enforced; then dinfo "Secure Boot is enabled. Using kexec file based syscall." kexec_args="$kexec_args -s" fi echo "$kexec_args" } # prepare_kdump_kernel <kdump_kernelver> # This function return kdump_kernel given a kernel version. prepare_kdump_kernel() { local kdump_kernelver=$1 local dir img boot_dirlist boot_imglist kdump_kernel machine_id read -r machine_id < /etc/machine-id boot_dirlist=${KDUMP_BOOTDIR:-"/boot /boot/efi /efi /"} boot_imglist="$KDUMP_IMG-$kdump_kernelver$KDUMP_IMG_EXT \ $machine_id/$kdump_kernelver/$KDUMP_IMG \ EFI/Linux/$machine_id-$kdump_kernelver.efi" # The kernel of OSTree based systems is not in the standard locations. if is_ostree; then boot_dirlist="$(echo /boot/ostree/) $boot_dirlist" fi # Use BOOT_IMAGE as reference if possible, strip the GRUB root device prefix in (hd0,gpt1) format boot_img="$(grep -P -o '^BOOT_IMAGE=(\S+)' /proc/cmdline \| sed "s/^BOOT_IMAGE=\((\S)\)\?\(\S\)/\2/")" if [[ "$boot_img" == "$kdump_kernelver" ]]; then boot_imglist="$boot_img $boot_imglist" fi for dir in $boot_dirlist; do for img in $boot_imglist; do if [[ -f "$dir/$img" ]]; then kdump_kernel=$(echo "$dir/$img" \| tr -s '/') break 2 fi done done echo "$kdump_kernel" } _is_valid_kver() { [[ -f /usr/lib/modules/$1/modules.dep ]] } # This function is introduced since 64k variant may be installed on 4k or vice versa # $1 the kernel path name. parse_kver_from_path() { local _img _kver [[ -z "$1" ]] && return _img=$1 BLS_ENTRY_TOKEN=$(</etc/machine-id) # Fedora standard installation, i.e. $BOOT/vmlinuz-<version> _kver=${_img##/vmlinuz-} _kver=${_kver%"$KDUMP_IMG_EXT"} if _is_valid_kver "$_kver"; then echo "$_kver" return fi # BLS recommended image names, i.e. $BOOT/<token>/<version>/linux _kver=${_img##/"$BLS_ENTRY_TOKEN"/} _kver=${_kver%%/} if _is_valid_kver "$_kver"; then echo "$_kver" return fi # Fedora UKI installation, i.e. $BOOT/efi/EFI/Linux/<token>-<version>.efi _kver=${_img##/"$BLS_ENTRY_TOKEN"-} _kver=${_kver%.efi} if _is_valid_kver "$_kver"; then echo "$_kver" return fi ddebug "Could not parse version from $_img" } _get_kdump_kernel_version() { local _version _version_nondebug if [[ -n "$KDUMP_KERNELVER" ]]; then echo "$KDUMP_KERNELVER" return fi _version=$(uname -r) if [[ ! "$_version" =~ [+\|-]debug$ ]]; then echo "$_version" return fi _version_nondebug=${_version%+debug} _version_nondebug=${_version_nondebug%-debug} if [[ -f "$(prepare_kdump_kernel "$_version_nondebug")" ]]; then dinfo "Use of debug kernel detected. Trying to use $_version_nondebug" echo "$_version_nondebug" else dinfo "Use of debug kernel detected but cannot find $_version_nondebug. Falling back to $_version" echo "$_version" fi } # # Detect initrd and kernel location, results are stored in global environmental variables: # KDUMP_BOOTDIR, KDUMP_KERNELVER, KDUMP_KERNEL, DEFAULT_INITRD, and KDUMP_INITRD # # Expectes KDUMP_BOOTDIR, KDUMP_IMG, KDUMP_IMG_EXT, KDUMP_KERNELVER to be loaded from config already # and will prefer already set values so user can specify custom kernel/initramfs location # prepare_kdump_bootinfo() { local boot_initrdlist default_initrd_base var_target_initrd_dir KDUMP_KERNELVER=$(_get_kdump_kernel_version) KDUMP_KERNEL=$(prepare_kdump_kernel "$KDUMP_KERNELVER") if ! [[ -e $KDUMP_KERNEL ]]; then derror "Failed to detect kdump kernel location" return 1 fi # For 64k variant, e.g. vmlinuz-5.14.0-327.el9.aarch64+64k-debug if [[ "$KDUMP_KERNEL" == "+debug" \|\| "$KDUMP_KERNEL" == "64k-debug" ]]; then dwarn "Using debug kernel, you may need to set a larger crashkernel than the default value." fi # Set KDUMP_BOOTDIR to where kernel image is stored if is_uki "$KDUMP_KERNEL"; then KDUMP_BOOTDIR=/boot else KDUMP_BOOTDIR=$(dirname "$KDUMP_KERNEL") fi # Default initrd should just stay aside of kernel image, try to find it in KDUMP_BOOTDIR boot_initrdlist="initramfs-$KDUMP_KERNELVER.img initrd" for initrd in $boot_initrdlist; do if [[ -f "$KDUMP_BOOTDIR/$initrd" ]]; then default_initrd_base="$initrd" DEFAULT_INITRD="$KDUMP_BOOTDIR/$default_initrd_base" break fi done # Create kdump initrd basename from default initrd basename # initramfs-5.7.9-200.fc32.x86_64.img => initramfs-5.7.9-200.fc32.x86_64kdump.img # initrd => initrdkdump if [[ -z $default_initrd_base ]]; then kdump_initrd_base=initramfs-${KDUMP_KERNELVER}kdump.img elif [[ $default_initrd_base == .* ]]; then kdump_initrd_base=${default_initrd_base%.}kdump.${DEFAULT_INITRD##.} else kdump_initrd_base=${default_initrd_base}kdump fi # Place kdump initrd in $(/var/lib/kdump) if $(KDUMP_BOOTDIR) not writable if [[ ! -w $KDUMP_BOOTDIR ]]; then var_target_initrd_dir="/var/lib/kdump" mkdir -p "$var_target_initrd_dir" KDUMP_INITRD="$var_target_initrd_dir/$kdump_initrd_base" else KDUMP_INITRD="$KDUMP_BOOTDIR/$kdump_initrd_base" fi } get_watchdog_drvs() { local _wdtdrvs _drv _dir for _dir in /sys/class/watchdog/; do # device/modalias will return driver of this device [[ -f "$_dir/device/modalias" ]] \|\| continue _drv=$(< "$_dir/device/modalias") _drv=$(modprobe --set-version "$KDUMP_KERNELVER" -R "$_drv" 2> /dev/null) for i in $_drv; do if ! [[ " $_wdtdrvs " == " $i "* ]]; then _wdtdrvs="$_wdtdrvs $i" fi done done echo "$_wdtdrvs" } _cmdline_parse() { local opt val while read -r opt; do if [[ $opt =~ = ]]; then val=${opt#=} opt=${opt%%=} # ignore options like 'foo=' [[ -z $val ]] && continue # xargs removes quotes, add them again [[ $val =~ [[:space:]] ]] && val="\"$val\"" else val="" fi echo "$opt $val" done <<< "$(echo "$1" \| xargs -n 1 echo)" } # # prepare_cmdline <commandline> <commandline remove> <commandline append> # This function performs a series of edits on the command line. # Store the final result in global $KDUMP_COMMANDLINE. prepare_cmdline() { local in out append opt val id drv local -A remove in=${1:-$(< /proc/cmdline)} while read -r opt val; do [[ -n "$opt" ]] \|\| continue remove[$opt]=1 done <<< "$(_cmdline_parse "$2")" append=$3 # These params should always be removed remove[crashkernel]=1 remove[panic_on_warn]=1 # Always remove "root=X", as we now explicitly generate all kinds # of dump target mount information including root fs. # # We do this before KDUMP_COMMANDLINE_APPEND, if one really cares # about it(e.g. for debug purpose), then can pass "root=X" using # KDUMP_COMMANDLINE_APPEND. remove[root]=1 # With the help of "--hostonly-cmdline", we can avoid some interitage. remove[rd.lvm.lv]=1 remove[rd.luks.uuid]=1 remove[rd.dm.uuid]=1 remove[rd.md.uuid]=1 remove[fcoe]=1 # Remove netroot, rd.iscsi.initiator and iscsi_initiator since # we get duplicate entries for the same in case iscsi code adds # it as well. remove[netroot]=1 remove[rd.iscsi.initiator]=1 remove[iscsi_initiator]=1 while read -r opt val; do [[ -n "$opt" ]] \|\| continue [[ -n "${remove[$opt]}" ]] && continue if [[ -n "$val" ]]; then out+="$opt=$val " else out+="$opt " fi done <<< "$(_cmdline_parse "$in")" out+="$append " id=$(get_bootcpu_apicid) if [[ -n "${id}" ]]; then out+="disable_cpu_apicid=$id " fi # If any watchdog is used, set it's pretimeout to 0. pretimeout let # watchdog panic the kernel first, and reset the system after the # panic. If the system is already in kdump, panic is not helpful # and only increase the chance of watchdog failure. for drv in $(get_watchdog_drvs); do out+="$drv.pretimeout=0 " if [[ $drv == hpwdt ]]; then # hpwdt have a special parameter kdumptimeout, it is # only supposed to be set to non-zero in first kernel. # In kdump, non-zero value could prevent the watchdog # from resetting the system. out+="$drv.kdumptimeout=0 " fi done # Always disable gpt-auto-generator as it hangs during boot of the # crash kernel. Furthermore we know which disk will be used for dumping # (if at all) and add it explicitly. is_uki "$KDUMP_KERNEL" && out+="rd.systemd.gpt_auto=no " # Trim unnecessary whitespaces echo "$out" \| sed -e "s/^ //g" -e "s/ $//g" -e "s/ \+/ /g" } PROC_IOMEM=/proc/iomem #get system memory size i.e. memblock.memory.total_size in the unit of GB get_system_size() { local _mem_size_mb _sum _sum=$(sed -n "s/\s\([0-9a-fA-F]\+\)-\([0-9a-fA-F]\+\) : System RAM$/+ 0x\2 - 0x\1 + 1/p" $PROC_IOMEM) _mem_size_mb=$(( (_sum) / 1024 / 1024 )) # rounding up the total_size to 128M to align with kernel code kernel/crash_reserve.c echo $(((_mem_size_mb + 127) / 128 128 / 1024 )) } # Return the recommended size for the reserved crashkernel memory # depending on the system memory size. # # This functions is expected to be consistent with the parse_crashkernel_mem() # in kernel i.e. how kernel allocates the kdump memory given the crashkernel # parameter crashkernel=range1:size1[,range2:size2,…] and the system memory # size. get_recommend_size() { local mem_size=$1 local _ck_cmdline=$2 local range start start_unit end end_unit size while read -r -d , range; do # need to use non-default IFS as double spaces are used as a # single delimiter while commas aren't... IFS=, read start start_unit end end_unit size <<< \ "$(echo "$range" \| sed -n "s/\([0-9]\+\)\([GT]\?\)-\([0-9]\)\([GT]\?\):\([0-9]\+[MG]\)/\1,\2,\3,\4,\5/p")" # aka. 102400T end=${end:-104857600} [[ "$end_unit" == T ]] && end=$((end 1024)) [[ "$start_unit" == T ]] && start=$((start * 1024)) if [[ $mem_size -ge $start ]] && [[ $mem_size -lt $end ]]; then echo "$size" return fi # append a ',' as read expects the 'file' to end with a delimiter done <<< "$_ck_cmdline," # no matching range found echo "0M" } has_mlx5() { [[ -d /sys/bus/pci/drivers/mlx5_core ]] } has_aarch64_smmu() { ls /sys/devices/platform/arm-smmu-* 1> /dev/null 2>&1 } is_memsize() { [[ "$1" =~ ^[+-]?[0-9]+[KkMmGgTtPbEe]?$ ]]; } # range defined for crashkernel parameter # i.e. <start>-[<end>] is_memrange() { is_memsize "${1%-}" \|\| return 1 [[ -n ${1#-} ]] \|\| return 0 is_memsize "${1#-}" } to_bytes() { local _s _s="$1" is_memsize "$_s" \|\| return 1 case "${_s: -1}" in K\|k) _s=${_s::-1} _s="$((_s 1024))" ;; M\|m) _s=${_s::-1} _s="$((_s * 1024 * 1024))" ;; G\|g) _s=${_s::-1} _s="$((_s * 1024 * 1024 * 1024))" ;; T\|t) _s=${_s::-1} _s="$((_s * 1024 * 1024 * 1024 * 1024))" ;; P\|p) _s=${_s::-1} _s="$((_s * 1024 * 1024 * 1024 * 1024 * 1024))" ;; E\|e) _s=${_s::-1} _s="$((_s * 1024 * 1024 * 1024 * 1024 * 1024 * 1024))" ;; ) ;; esac echo "$_s" } memsize_add() { local -a units=("" "K" "M" "G" "T" "P" "E") local i a b a=$(to_bytes "$1") \|\| return 1 b=$(to_bytes "$2") \|\| return 1 i=0 (( a += b )) while :; do [[ $(( a / 1024 )) -eq 0 ]] && break [[ $(( a % 1024 )) -ne 0 ]] && break [[ $(( ${#units[@]} - 1 )) -eq $i ]] && break (( a /= 1024 )) (( i += 1 )) done echo "${a}${units[$i]}" } _crashkernel_parse() { local ck entry local range size offset ck="$1" if [[ "$ck" == @* ]]; then offset="@${ck##@}" ck=${ck%@} elif [[ "$ck" == ,high ]] \|\| [[ "$ck" == ,low ]]; then offset=",${ck##,}" ck=${ck%,} else offset='' fi while read -d , -r entry; do [[ -n "$entry" ]] \|\| continue if [[ "$entry" == : ]]; then range=${entry%:} size=${entry#:} else range="" size=${entry} fi echo "$size;$range;" done <<< "$ck," echo ";;$offset" } # $1 crashkernel command line parameter # $2 size to be added _crashkernel_add() { local ck delta ret local range size offset ck="$1" delta="$2" ret="" while IFS=';' read -r size range offset; do if [[ -n "$offset" ]]; then ret="${ret%,}$offset" break fi [[ -n "$size" ]] \|\| continue if [[ -n "$range" ]]; then is_memrange "$range" \|\| return 1 ret+="$range:" fi size=$(memsize_add "$size" "$delta") \|\| return 1 ret+="$size," done < <( _crashkernel_parse "$ck") echo "${ret%,}" } # get default crashkernel # $1 dump mode, if not specified, dump_mode will be judged by is_fadump_capable # $2 kernel-release, if not specified, got by _get_kdump_kernel_version kdump_get_arch_recommend_crashkernel() { local _arch _ck_cmdline _dump_mode local _delta=0 if [[ -z "$1" ]]; then if is_fadump_capable; then _dump_mode=fadump else _dump_mode=kdump fi else _dump_mode=$1 fi _arch=$(uname -m) if [[ $_arch == "x86_64" ]] \|\| [[ $_arch == "s390x" ]]; then _ck_cmdline="1G-2G:192M,2G-64G:256M,64G-:512M" is_sme_or_sev_active && ((_delta += 64)) elif [[ $_arch == "aarch64" ]]; then local _running_kernel # Base line for 4K variant kernel. The formula is based on x86 plus extra = 64M _ck_cmdline="1G-4G:256M,4G-64G:320M,64G-:576M" if [[ -z "$2" ]]; then _running_kernel=$(_get_kdump_kernel_version) else _running_kernel=$2 fi # the naming convention of 64k variant suffixes with +64k, e.g. "vmlinuz-5.14.0-312.el9.aarch64+64k" if echo "$_running_kernel" \| grep -q 64k; then # Without smmu, the diff of MemFree between 4K and 64K measured on a high end aarch64 machine is 82M. # Picking up 100M to cover this diff. And finally, we have "1G-4G:356M;4G-64G:420M;64G-:676M" ((_delta += 100)) # On a 64K system, the extra 384MB is calculated by: cmdq_num * 16 bytes + evtq_num * 32B + priq_num * 16B # While on a 4K system, it is negligible has_aarch64_smmu && ((_delta += 384)) #64k kernel, mlx5 consumes extra 188M memory, and choose 200M has_mlx5 && ((_delta += 200)) else #4k kernel, mlx5 consumes extra 124M memory, and choose 150M has_mlx5 && ((_delta += 150)) fi elif [[ $_arch == "ppc64le" ]]; then if [[ $_dump_mode == "fadump" ]]; then _ck_cmdline="4G-16G:768M,16G-64G:1G,64G-128G:2G,128G-1T:4G,1T-2T:6G,2T-4T:12G,4T-8T:20G,8T-16T:36G,16T-32T:64G,32T-64T:128G,64T-:180G" else _ck_cmdline="2G-4G:384M,4G-16G:512M,16G-64G:1G,64G-128G:2G,128G-:4G" fi fi echo -n "$(_crashkernel_add "$_ck_cmdline" "${_delta}M")" } # return recommended size based on current system RAM size # $1: kernel version, if not set, will defaults to $(uname -r) kdump_get_arch_recommend_size() { local _ck_cmdline _sys_mem if ! [[ -r "/proc/iomem" ]]; then echo "Error, can not access /proc/iomem." return 1 fi _sys_mem=$(get_system_size) _ck_cmdline=$(kdump_get_arch_recommend_crashkernel) _ck_cmdline=${_ck_cmdline//-:/-102400T:} get_recommend_size "$_sys_mem" "$_ck_cmdline" } # Print all underlying crypt devices of a block device # print nothing if device is not on top of a crypt device # $1: the block device to be checked in maj:min format get_luks_crypt_dev() { local _type [[ -b /dev/block/$1 ]] \|\| return 1 _type=$(blkid -u filesystem,crypto -o export -- "/dev/block/$1" \| \ sed -n -E "s/^TYPE=(.)$/\1/p") [[ $_type == "crypto_LUKS" ]] && echo "$1" for _x in "/sys/dev/block/$1/slaves/"; do [[ -f $_x/dev ]] \|\| continue [[ $_x/subsystem -ef /sys/class/block ]] \|\| continue get_luks_crypt_dev "$(< "$_x/dev")" done } # kdump_get_maj_min <device> # Prints the major and minor of a device node. # Example: # $ get_maj_min /dev/sda2 # 8:2 kdump_get_maj_min() { local _majmin _majmin="$(stat -L -c '%t:%T' "$1" 2> /dev/null)" printf "%s" "$((0x${_majmin%:})):$((0x${_majmin#:}))" } get_all_kdump_crypt_dev() { local _dev for _dev in $(get_block_dump_target); do get_luks_crypt_dev "$(kdump_get_maj_min "$_dev")" done }	30.93 KB	2025-09-24 06:15
📄 kdump-logger.sh #!/usr/bin/sh # # This comes from the dracut-logger.sh # # The logger defined 4 logging levels: # - ddebug (4) # The DEBUG Level designates fine-grained informational events that are most # useful to debug an application. # - dinfo (3) # The INFO level designates informational messages that highlight the # progress of the application at coarse-grained level. # - dwarn (2) # The WARN level designates potentially harmful situations. # - derror (1) # The ERROR level designates error events that might still allow the # application to continue running. # # Logging is controlled by following global variables: # - @var kdump_stdloglvl - logging level to standard error (console output) # - @var kdump_sysloglvl - logging level to syslog (by logger command) # - @var kdump_kmsgloglvl - logging level to /dev/kmsg (only for boot-time) # # If any of the variables is not set, the function dlog_init() sets it to default: # - In the first kernel: # - @var kdump_stdloglvl = 3 (info) # - @var kdump_sysloglvl = 0 (no logging) # - @var kdump_kmsgloglvl = 0 (no logging) # # -In the second kernel: # - @var kdump_stdloglvl = 0 (no logging) # - @var kdump_sysloglvl = 3 (info) # - @var kdump_kmsgloglvl = 0 (no logging) # # First of all you have to start with dlog_init() function which initializes # required variables. Don't call any other logging function before that one! # # The code in this file might be run in an environment without bash. # Any code added must be POSIX compliant. # Define vairables for the log levels in this module. kdump_stdloglvl="" kdump_sysloglvl="" kdump_kmsgloglvl="" # The dracut-lib.sh is only available in the second kernel, and it won't # be used in the first kernel because the dracut-lib.sh is invisible in # the first kernel. if [ -f /lib/dracut-lib.sh ]; then . /lib/dracut-lib.sh fi # @brief Get the log level from kernel command line. # @retval 1 if something has gone wrong # @retval 0 on success. # get_kdump_loglvl() { [ -f /lib/dracut-lib.sh ] && kdump_sysloglvl=$(getarg rd.kdumploglvl) [ -z "$kdump_sysloglvl" ] && return 1; if [ -f /lib/dracut-lib.sh ] && ! isdigit "$kdump_sysloglvl"; then return 1 fi return 0 } # @brief Check the log level. # @retval 1 if something has gone wrong # @retval 0 on success. # check_loglvl() { case "$1" in 0\|1\|2\|3\|4) return 0 ;; ) return 1 ;; esac } # @brief Initializes Logger. # @retval 1 if something has gone wrong # @retval 0 on success. # dlog_init() { ret=0 if [ -s /proc/vmcore ];then if ! get_kdump_loglvl; then logger -t "kdump[$$]" -p warn -- "Kdump is using the default log level(3)." kdump_sysloglvl=3 fi kdump_stdloglvl=0 kdump_kmsgloglvl=0 else kdump_stdloglvl=$KDUMP_STDLOGLVL kdump_sysloglvl=$KDUMP_SYSLOGLVL kdump_kmsgloglvl=$KDUMP_KMSGLOGLVL fi [ -z "$kdump_stdloglvl" ] && kdump_stdloglvl=3 [ -z "$kdump_sysloglvl" ] && kdump_sysloglvl=0 [ -z "$kdump_kmsgloglvl" ] && kdump_kmsgloglvl=0 for loglvl in "$kdump_stdloglvl" "$kdump_kmsgloglvl" "$kdump_sysloglvl"; do if ! check_loglvl "$loglvl"; then echo "Illegal log level: $kdump_stdloglvl $kdump_kmsgloglvl $kdump_sysloglvl" return 1 fi done # Skip initialization if it's already done. [ -n "$kdump_maxloglvl" ] && return 0 if [ "$UID" -ne 0 ]; then kdump_kmsgloglvl=0 kdump_sysloglvl=0 fi if [ "$kdump_sysloglvl" -gt 0 ]; then if [ -d /run/systemd/journal ] \ && systemd-cat --version 1>/dev/null 2>&1 \ && systemctl --quiet is-active systemd-journald.socket 1>/dev/null 2>&1; then readonly _systemdcatfile="/var/tmp/systemd-cat" mkfifo "$_systemdcatfile" 1>/dev/null 2>&1 readonly _dlogfd=15 systemd-cat -t 'kdump' --level-prefix=true <"$_systemdcatfile" & exec 15>"$_systemdcatfile" elif ! [ -S /dev/log ] && [ -w /dev/log ] \|\| ! command -v logger >/dev/null; then # We cannot log to syslog, so turn this facility off. kdump_kmsgloglvl=$kdump_sysloglvl kdump_sysloglvl=0 ret=1 errmsg="No '/dev/log' or 'logger' included for syslog logging" fi fi kdump_maxloglvl=0 for _dlog_lvl in $kdump_stdloglvl $kdump_sysloglvl $kdump_kmsgloglvl; do [ $_dlog_lvl -gt $kdump_maxloglvl ] && kdump_maxloglvl=$_dlog_lvl done readonly kdump_maxloglvl export kdump_maxloglvl if [ $kdump_stdloglvl -lt 4 ] && [ $kdump_kmsgloglvl -lt 4 ] && [ $kdump_sysloglvl -lt 4 ]; then unset ddebug ddebug() { :; }; fi if [ $kdump_stdloglvl -lt 3 ] && [ $kdump_kmsgloglvl -lt 3 ] && [ $kdump_sysloglvl -lt 3 ]; then unset dinfo dinfo() { :; }; fi if [ $kdump_stdloglvl -lt 2 ] && [ $kdump_kmsgloglvl -lt 2 ] && [ $kdump_sysloglvl -lt 2 ]; then unset dwarn dwarn() { :; }; unset dwarning dwarning() { :; }; fi if [ $kdump_stdloglvl -lt 1 ] && [ $kdump_kmsgloglvl -lt 1 ] && [ $kdump_sysloglvl -lt 1 ]; then unset derror derror() { :; }; fi [ -n "$errmsg" ] && derror "$errmsg" return $ret } ## @brief Converts numeric level to logger priority defined by POSIX.2. # # @param $1: Numeric logging level in range from 1 to 4. # @retval 1 if @a lvl is out of range. # @retval 0 if @a lvl is correct. # @result Echoes logger priority. _lvl2syspri() { case "$1" in 1) echo error;; 2) echo warning;; 3) echo info;; 4) echo debug;; ) return 1;; esac } ## @brief Converts logger numeric level to syslog log level # # @param $1: Numeric logging level in range from 1 to 4. # @retval 1 if @a lvl is out of range. # @retval 0 if @a lvl is correct. # @result Echoes kernel console numeric log level # # Conversion is done as follows: # # <tt> # none -> LOG_EMERG (0) # none -> LOG_ALERT (1) # none -> LOG_CRIT (2) # ERROR(1) -> LOG_ERR (3) # WARN(2) -> LOG_WARNING (4) # none -> LOG_NOTICE (5) # INFO(3) -> LOG_INFO (6) # DEBUG(4) -> LOG_DEBUG (7) # </tt> # # @see /usr/include/sys/syslog.h _dlvl2syslvl() { case "$1" in 1) set -- 3;; 2) set -- 4;; 3) set -- 6;; 4) set -- 7;; ) return 1;; esac # The number is constructed by multiplying the facility by 8 and then # adding the level. # About The Syslog Protocol, please refer to the RFC5424 for more details. echo $((24 + $1)) } ## @brief Prints to stderr, to syslog and/or /dev/kmsg given message with # given level (priority). # # @param $1: Numeric logging level. # @param $2: Message. # @retval 0 It's always returned, even if logging failed. # # @note This function is not supposed to be called manually. Please use # dinfo(), ddebug(), or others instead which wrap this one. # # This is core logging function which logs given message to standard error # and/or syslog (with POSIX shell command <tt>logger</tt>) and/or to /dev/kmsg. # The format is following: # # <tt>X: some message</tt> # # where @c X is the first letter of logging level. See module description for # details on that. # # Message to syslog is sent with tag @c kdump. Priorities are mapped as # following: # - @c ERROR to @c error # - @c WARN to @c warning # - @c INFO to @c info # - @c DEBUG to @c debug _do_dlog() { [ "$1" -le $kdump_stdloglvl ] && printf -- 'kdump: %s\n' "$2" >&2 if [ "$1" -le $kdump_sysloglvl ]; then if [ "$_dlogfd" ]; then printf -- "<%s>%s\n" "$(($(_dlvl2syslvl "$1") & 7))" "$2" 1>&$_dlogfd else logger -t "kdump[$$]" -p "$(_lvl2syspri "$1")" -- "$2" fi fi [ "$1" -le $kdump_kmsgloglvl ] && \ echo "<$(_dlvl2syslvl "$1")>kdump[$$] $2" >/dev/kmsg } ## @brief Internal helper function for _do_dlog() # # @param $1: Numeric logging level. # @param $2 [...]: Message. # @retval 0 It's always returned, even if logging failed. # # @note This function is not supposed to be called manually. Please use # dinfo(), ddebug(), or others instead which wrap this one. # # This function calls _do_dlog() either with parameter msg, or if # none is given, it will read standard input and will use every line as # a message. # # This enables: # dwarn "This is a warning" # echo "This is a warning" \| dwarn dlog() { [ -z "$kdump_maxloglvl" ] && return 0 [ "$1" -le "$kdump_maxloglvl" ] \|\| return 0 if [ $# -gt 1 ]; then _dlog_lvl=$1; shift _do_dlog "$_dlog_lvl" "$" else while read -r line \|\| [ -n "$line" ]; do _do_dlog "$1" "$line" done fi } ## @brief Logs message at DEBUG level (4) # # @param msg Message. # @retval 0 It's always returned, even if logging failed. ddebug() { set +x dlog 4 "$@" if [ -n "$debug" ]; then set -x fi } ## @brief Logs message at INFO level (3) # # @param msg Message. # @retval 0 It's always returned, even if logging failed. dinfo() { set +x dlog 3 "$@" if [ -n "$debug" ]; then set -x fi } ## @brief Logs message at WARN level (2) # # @param msg Message. # @retval 0 It's always returned, even if logging failed. dwarn() { set +x dlog 2 "$@" if [ -n "$debug" ]; then set -x fi } ## @brief It's an alias to dwarn() function. # # @param msg Message. # @retval 0 It's always returned, even if logging failed. dwarning() { set +x dwarn "$@" if [ -n "$debug" ]; then set -x fi } ## @brief Logs message at ERROR level (1) # # @param msg Message. # @retval 0 It's always returned, even if logging failed. derror() { set +x dlog 1 "$@" if [ -n "$debug" ]; then set -x fi }	9.74 KB	2025-09-24 06:15

Terminal