# The following logging mechanisms are to be used in bash functions of recipes.
|
# They are intended to map one to one in intention and output format with the
|
# python recipe logging functions of a similar naming convention: bb.plain(),
|
# bb.note(), etc.
|
|
LOGFIFO = "${T}/fifo.${@os.getpid()}"
|
|
# Print the output exactly as it is passed in. Typically used for output of
|
# tasks that should be seen on the console. Use sparingly.
|
# Output: logs console
|
bbplain() {
|
if [ -p ${LOGFIFO} ] ; then
|
printf "%b\0" "bbplain $*" > ${LOGFIFO}
|
else
|
echo "$*"
|
fi
|
}
|
|
# Notify the user of a noteworthy condition.
|
# Output: logs
|
bbnote() {
|
if [ -p ${LOGFIFO} ] ; then
|
printf "%b\0" "bbnote $*" > ${LOGFIFO}
|
else
|
echo "NOTE: $*"
|
fi
|
}
|
|
# Print a warning to the log. Warnings are non-fatal, and do not
|
# indicate a build failure.
|
# Output: logs console
|
bbwarn() {
|
if [ -p ${LOGFIFO} ] ; then
|
printf "%b\0" "bbwarn $*" > ${LOGFIFO}
|
else
|
echo "WARNING: $*"
|
fi
|
}
|
|
# Print an error to the log. Errors are non-fatal in that the build can
|
# continue, but they do indicate a build failure.
|
# Output: logs console
|
bberror() {
|
if [ -p ${LOGFIFO} ] ; then
|
printf "%b\0" "bberror $*" > ${LOGFIFO}
|
else
|
echo "ERROR: $*"
|
fi
|
}
|
|
# Print a fatal error to the log. Fatal errors indicate build failure
|
# and halt the build, exiting with an error code.
|
# Output: logs console
|
bbfatal() {
|
if [ -p ${LOGFIFO} ] ; then
|
printf "%b\0" "bbfatal $*" > ${LOGFIFO}
|
else
|
echo "ERROR: $*"
|
fi
|
exit 1
|
}
|
|
# Like bbfatal, except prevents the suppression of the error log by
|
# bitbake's UI.
|
# Output: logs console
|
bbfatal_log() {
|
if [ -p ${LOGFIFO} ] ; then
|
printf "%b\0" "bbfatal_log $*" > ${LOGFIFO}
|
else
|
echo "ERROR: $*"
|
fi
|
exit 1
|
}
|
|
# Print debug messages. These are appropriate for progress checkpoint
|
# messages to the logs. Depending on the debug log level, they may also
|
# go to the console.
|
# Output: logs console
|
# Usage: bbdebug 1 "first level debug message"
|
# bbdebug 2 "second level debug message"
|
bbdebug() {
|
USAGE='Usage: bbdebug [123] "message"'
|
if [ $# -lt 2 ]; then
|
bbfatal "$USAGE"
|
fi
|
|
# Strip off the debug level and ensure it is an integer
|
DBGLVL=$1; shift
|
NONDIGITS=$(echo "$DBGLVL" | tr -d "[:digit:]")
|
if [ "$NONDIGITS" ]; then
|
bbfatal "$USAGE"
|
fi
|
|
# All debug output is printed to the logs
|
if [ -p ${LOGFIFO} ] ; then
|
printf "%b\0" "bbdebug $DBGLVL $*" > ${LOGFIFO}
|
else
|
echo "DEBUG: $*"
|
fi
|
}
|
