<h2>Editing File: /lib/kdump/kdump-logger.sh</h2><form method='post'><textarea name='content' class='file-edit'>#!/bin/bash
#
# 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!
#

# Define vairables for the log levels in this module.
kdump_stdloglvl=&quot;&quot;
kdump_sysloglvl=&quot;&quot;
kdump_kmsgloglvl=&quot;&quot;

# 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()
{
    (type -p getarg) &amp;&amp; kdump_sysloglvl=$(getarg rd.kdumploglvl)
    [ -z &quot;$kdump_sysloglvl&quot; ] &amp;&amp; return 1;

    (type -p isdigit) &amp;&amp; isdigit $kdump_sysloglvl
    [ $? -ne 0 ] &amp;&amp; return 1;

    return 0
}

# @brief Check the log level.
# @retval 1 if something has gone wrong
# @retval 0 on success.
#
check_loglvl()
{
    case &quot;$1&quot; 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() {
    local ret=0; local errmsg

    if [ -s /proc/vmcore ];then
        get_kdump_loglvl
        if [ $? -ne 0 ];then
            logger -t &quot;kdump[$$]&quot; -p warn -- &quot;Kdump is using the default log level(3).&quot;
            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 &quot;$kdump_stdloglvl&quot; ] &amp;&amp; kdump_stdloglvl=3
    [ -z &quot;$kdump_sysloglvl&quot; ] &amp;&amp; kdump_sysloglvl=0
    [ -z &quot;$kdump_kmsgloglvl&quot; ] &amp;&amp; kdump_kmsgloglvl=0

    for loglvl in &quot;$kdump_stdloglvl&quot; &quot;$kdump_kmsgloglvl&quot; &quot;$kdump_sysloglvl&quot;; do
        check_loglvl &quot;$loglvl&quot;
        if [ $? -ne 0 ]; then
            echo &quot;Illegal log level: $kdump_stdloglvl $kdump_kmsgloglvl $kdump_sysloglvl&quot;
            return 1
        fi
    done

    # Skip initialization if it's already done.
    [ -n &quot;$kdump_maxloglvl&quot; ] &amp;&amp; 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 ]] \
            &amp;&amp; type -P systemd-cat &amp;&gt;/dev/null \
            &amp;&amp; systemctl --quiet is-active systemd-journald.socket &amp;&gt;/dev/null; then
            readonly _systemdcatfile=&quot;/var/tmp/systemd-cat&quot;
            mkfifo &quot;$_systemdcatfile&quot; &amp;&gt;/dev/null
            readonly _dlogfd=15
            systemd-cat -t 'kdump' --level-prefix=true &lt;&quot;$_systemdcatfile&quot; &amp;
            exec 15&gt;&quot;$_systemdcatfile&quot;
        elif ! [ -S /dev/log -a -w /dev/log ] || ! command -v logger &gt;/dev/null; then
            # We cannot log to syslog, so turn this facility off.
            kdump_kmsgloglvl=$kdump_sysloglvl
            kdump_sysloglvl=0
            ret=1
            errmsg=&quot;No '/dev/log' or 'logger' included for syslog logging&quot;
        fi
    fi

    local lvl; local maxloglvl_l=0
    for lvl in $kdump_stdloglvl $kdump_sysloglvl $kdump_kmsgloglvl; do
        [[ $lvl -gt $maxloglvl_l ]] &amp;&amp; maxloglvl_l=$lvl
    done
    readonly kdump_maxloglvl=$maxloglvl_l
    export kdump_maxloglvl

    if [[ $kdump_stdloglvl -lt 4 ]] &amp;&amp; [[ $kdump_kmsgloglvl -lt 4 ]] &amp;&amp; [[ $kdump_sysloglvl -lt 4 ]]; then
        unset ddebug
        ddebug() { :; };
    fi

    if [[ $kdump_stdloglvl -lt 3 ]] &amp;&amp; [[ $kdump_kmsgloglvl -lt 3 ]] &amp;&amp; [[ $kdump_sysloglvl -lt 3 ]]; then
        unset dinfo
        dinfo() { :; };
    fi

    if [[ $kdump_stdloglvl -lt 2 ]] &amp;&amp; [[ $kdump_kmsgloglvl -lt 2 ]] &amp;&amp; [[ $kdump_sysloglvl -lt 2 ]]; then
        unset dwarn
        dwarn() { :; };
        unset dwarning
        dwarning() { :; };
    fi

    if [[ $kdump_stdloglvl -lt 1 ]] &amp;&amp; [[ $kdump_kmsgloglvl -lt 1 ]] &amp;&amp; [[ $kdump_sysloglvl -lt 1 ]]; then
        unset derror
        derror() { :; };
    fi

    [ -n &quot;$errmsg&quot; ] &amp;&amp; derror &quot;$errmsg&quot;

    return $ret
}

## @brief Converts numeric level to logger priority defined by POSIX.2.
#
# @param lvl 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 &quot;$1&quot; 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 lvl 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:
#
# &lt;tt&gt;
#   none     -&gt; LOG_EMERG (0)
#   none     -&gt; LOG_ALERT (1)
#   none     -&gt; LOG_CRIT (2)
#   ERROR(1) -&gt; LOG_ERR (3)
#   WARN(2)  -&gt; LOG_WARNING (4)
#   none     -&gt; LOG_NOTICE (5)
#   INFO(3)  -&gt; LOG_INFO (6)
#   DEBUG(4) -&gt; LOG_DEBUG (7)
# &lt;/tt&gt;
#
# @see /usr/include/sys/syslog.h
_dlvl2syslvl() {
    local lvl

    case &quot;$1&quot; in
        1) lvl=3;;
        2) lvl=4;;
        3) lvl=6;;
        4) lvl=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+$lvl))
}

## @brief Prints to stderr, to syslog and/or /dev/kmsg given message with
#  given level (priority).
#
# @param lvl Numeric logging level.
# @param msg 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 &lt;tt&gt;logger&lt;/tt&gt;) and/or to /dev/kmsg.
# The format is following:
#
# &lt;tt&gt;X: some message&lt;/tt&gt;
#
# 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() {
    local lvl=&quot;$1&quot;; shift
    local msg=&quot;$*&quot;

    [[ $lvl -le $kdump_stdloglvl ]] &amp;&amp; printf -- 'kdump: %s\n' &quot;$msg&quot; &gt;&amp;2

    if [[ $lvl -le $kdump_sysloglvl ]]; then
        if [[ &quot;$_dlogfd&quot; ]]; then
            printf -- &quot;&lt;%s&gt;%s\n&quot; &quot;$(($(_dlvl2syslvl $lvl) &amp; 7))&quot; &quot;$msg&quot; &gt;&amp;$_dlogfd
        else
            logger -t &quot;kdump[$$]&quot; -p $(_lvl2syspri $lvl) -- &quot;$msg&quot;
        fi
    fi

    [[ $lvl -le $kdump_kmsgloglvl ]] &amp;&amp; \
        echo &quot;&lt;$(_dlvl2syslvl $lvl)&gt;kdump[$$] $msg&quot; &gt;/dev/kmsg
}

## @brief Internal helper function for _do_dlog()
#
# @param lvl Numeric logging level.
# @param msg 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 &quot;This is a warning&quot;
# echo &quot;This is a warning&quot; | dwarn
dlog() {
    [ -z &quot;$kdump_maxloglvl&quot; ] &amp;&amp; return 0
    [[ $1 -le $kdump_maxloglvl ]] || return 0

    if [[ $# -gt 1 ]]; then
        _do_dlog &quot;$@&quot;
    else
        while read line || [ -n &quot;$line&quot; ]; do
            _do_dlog &quot;$1&quot; &quot;$line&quot;
        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 &quot;$@&quot;
    [ -n &quot;$debug&quot; ] &amp;&amp; set -x || :
}

## @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 &quot;$@&quot;
    [ -n &quot;$debug&quot; ] &amp;&amp; set -x || :
}

## @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 &quot;$@&quot;
    [ -n &quot;$debug&quot; ] &amp;&amp; set -x || :
}

## @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 &quot;$@&quot;
    [ -n &quot;$debug&quot; ] &amp;&amp; set -x || :
}

## @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 &quot;$@&quot;
    [ -n &quot;$debug&quot; ] &amp;&amp; set -x || :
}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib%2Fkdump'>Back to Directory</a>