mm/tools/reloc_spec_check.sh
Anghelo Carvajal 1599192b85
Script for checking relocs correctly updated on spec (#718)
* Script to check for relocs on spec

* add reloc_spec_check to jenkinsfile

* add colors

* Use light red instead of red

* Go back to red

* fix EnDoor reloc
2022-03-24 21:25:41 -03:00

113 lines
5.7 KiB
Bash
Executable File

#!/bin/bash
# This script checks for overlay's relocs to be correctly used on the spec file depending on the overlay's NON_MATCHING/NON_EQUIVALENT
# and minimize possible broken NON_MATCHING builds.
# The script performs the following checks:
# - The extracted reloc isn't being used on the spec if the overlay has no other GLOBAL_ASM left (it has been matched).
# - Warn if an overlay is using both NON_MATCHING and NON_EQUIVALENT.
# - Warn if an overlay has NON_MATCHING ifdefs but some functions are still unattempted.
# - Both relocs (generated and extracted) are used on the spec on NON_MATCHING overlays.
# - The generated reloc isn't being used on NON_EQUIVALENT overlays.
# If any of those checks fails for any overlay, the script will print a warning and exit with a non-zero exit code.
BOLD="$(tput bold)"
RED="$(tput setaf 1)"
PURPLE="$(tput setaf 5)"
WHITE="$(tput setaf 7)"
BLINK="$(tput blink)"
RST="$(tput sgr0)"
# Run the script from the root of the project
DIR="$(dirname "$(readlink -f "$0")")"
cd "$DIR/.."
EXIT_CODE=0
OVERLAYS_SUBFOLDERS="$(find src/overlays/*/* -type d)"
while read OVL_FOLDER; do
# C files which are part of the current overlay
FILES_OF_OVERLAY="$(find "$OVL_FOLDER" -name '*.c')"
# List of files (of the current overlay) which doesn't contain GLOBAL_ASM
FILES_WITHOUT_PRAGMA="$(grep -L '#pragma GLOBAL_ASM' ${FILES_OF_OVERLAY})"
if [ "$FILES_OF_OVERLAY" == "$FILES_WITHOUT_PRAGMA" ]; then
# This overlay is fully matched, so it should not be using the extracted reloc (use the generated one instead)
OVL_NAME="$(cut -d '/' -f 4 <<< ${OVL_FOLDER})"
# Parse the spec, searching for the extracted reloc of this overlay
OVL_WITH_EXTRACTED_RELOC="$(grep -F "$OVL_NAME".reloc spec)"
if [ "$OVL_WITH_EXTRACTED_RELOC" != "" ]; then
echo "${BOLD} Matching overlay using extracted reloc on spec found: ${RED} ${OVL_FOLDER} ${RST}"
echo " Don't forget to change the extracted reloc to the generated one on the spec, otherwise the matched overlay won't be shiftable"
EXIT_CODE=1
fi
else
# Overlay not fully matched
# Search for files with NON_MATCHING and NON_EQUIVALENT
FILES_WITH_NON_MATCHING="$(grep -Fl '#ifdef NON_MATCHING' ${FILES_OF_OVERLAY})"
FILES_WITH_NON_EQUIVALENT="$(grep -Fl '#ifdef NON_EQUIVALENT' ${FILES_OF_OVERLAY})"
if [ "$FILES_WITH_NON_MATCHING" != "" ] && [ "$FILES_WITH_NON_EQUIVALENT" != "" ]; then
# An overlay can't have both NON_MATCHINGs and NON_EQUIVALENTs, because relocs wouldn't be generated correctly
echo "${BOLD} Overlay with both NON_MATCHINGs and NON_EQUIVALENTs found: ${RED} ${OVL_FOLDER} ${RST}"
echo " Overlays can't have both NON_MATCHING and NON_EQUIVALENT because it breaks NON_MATCHING builds"
echo " As an alternative you could mark NON_MATCHING functions as NON_EQUIVALENT and add a comment mentioning it is actually equivalent"
EXIT_CODE=1
elif [ "$FILES_WITH_NON_MATCHING" != "" ]; then
# Overlay only contains NON_MATCHINGs
# Get the count of NON_MATCHING and GLOBAL_ASM of the current overlay
NON_MATCHINGS_COUNT_OF_OVERLAY="$(grep -F '#ifdef NON_MATCHING' ${FILES_WITH_NON_MATCHING} | wc -l)"
PRAGMAS_COUNT_OF_OVERLAY="$(grep -F '#pragma GLOBAL_ASM' ${FILES_WITH_NON_MATCHING} | wc -l)"
if [ "$NON_MATCHINGS_COUNT_OF_OVERLAY" != "$PRAGMAS_COUNT_OF_OVERLAY" ]; then
# If an overlay uses NON_MATCHING, then every function should be either matching or marked as NON_MATCHING
echo "${BOLD} Found an overlay with a differing number of NON_MATCHINGs and #pragma GLOBAL_ASM: ${RED} ${OVL_FOLDER} ${RST}"
echo " To use a NON_MATCHING check on an overlay, every function that does not match should verified to be equivalent"
echo " But the amount of NON_MATCHING ifdefs and GLOBAL_ASM does no match, which may suggest not every function of this overlay may have been attempted"
EXIT_CODE=1
fi
OVL_NAME="$(cut -d '/' -f 4 <<< ${OVL_FOLDER})"
# Parse the spec, searching for the extracted reloc of this overlay
OVL_WITH_EXTRACTED_RELOC="$(grep -F "$OVL_NAME".reloc spec)"
# Parse the spec, searching for the generated reloc of this overlay
OVL_WITH_GENERATED_RELOC="$(grep -F "$OVL_NAME"_reloc spec)"
if [ "$OVL_WITH_EXTRACTED_RELOC" == "" ] || [ "$OVL_WITH_GENERATED_RELOC" == "" ]; then
# Overlays with NON_MATCHINGs should have both relocs on the spec
echo "${BOLD} NON_MATCHING overlay missing either extracted or generated reloc on spec found: ${RED} ${OVL_FOLDER} ${RST}"
echo " Overlays with NON_MATCHING ifdefs must also add a NON_MATCHING ifdef on the spec to allow using the generated reloc on NON_MATCHING builds"
EXIT_CODE=1
fi
elif [ "$FILES_WITH_NON_EQUIVALENT" != "" ]; then
# Overlay only contains NON_EQUIVALENTs
OVL_NAME="$(cut -d '/' -f 4 <<< ${OVL_FOLDER})"
# Parse the spec, searching for the generated reloc of this overlay
OVL_WITH_GENERATED_RELOC="$(grep -F "$OVL_NAME"_reloc spec)"
if [ "$OVL_WITH_GENERATED_RELOC" != "" ]; then
# Overlays with NON_EQUIVALENTs should not use a generated reloc
echo "${BOLD} NON_EQUIVALENT overlay with generated reloc on spec found: ${RED} ${OVL_FOLDER} ${RST}"
echo " Overlays with NON_EQUIVALENT ifdefs can't use generated relocs"
EXIT_CODE=1
fi
fi
fi
done <<< ${OVERLAYS_SUBFOLDERS}
exit $EXIT_CODE