update dependencies to support python3.12

* update build script

* update dependencies list in readme

* update dependencies

Author: 0xFE4415

.github/workflows/build.yml

@@ -34,3 +34,23 @@ jobs:
 
     - name: Run ARCHIE
       run: cd examples/stm32; ./run.sh; cd ../riscv64; ./run.sh
+
+  build_with_script:
+    name: Test build.sh Script
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Clone Repository
+      uses: actions/checkout@v4
+
+    - name: test bash build script
+      run: |
+        (cat <<END
+        1
+        y
+        1
+        2
+        y
+        1
+        END
+        ) | bash build.sh

README.md

@@ -28,18 +28,25 @@ Alternatively, the build instructions are provided in the following sections.
 ARCHIE was tested with QEMU 6.0, which is available in [archie-qemu](https://github.com/Fraunhofer-AISEC/archie-qemu).
 First make sure the basic requirements for QEMU are installed. See the wiki for required libraries (https://wiki.qemu.org/Hosts/Linux).
 On Ubuntu systems, you can install the minimum required packages with:
-```
+
+```sh
 sudo apt install git build-essential ninja-build libglib2.0-dev libfdt-dev libpixman-1-dev zlib1g-dev
 ```
 
-Checkout git submodule qemu, which should checkout tcg_plugin_dev of the git. See code segment below.
+Additionally, the faultplugin requires the following package:
 
+```sh
+sudo apt install libprotobuf-c-dev
 ```
+
+Checkout git submodule qemu, which should checkout tcg_plugin_dev of the git. See code segment below.
+
+```sh
 git submodule update --init
 mkdir -p qemu/build/debug
 cd qemu/build/debug
 ./../../configure --target-list=arm-softmmu --enable-debug --enable-plugins --disable-sdl --disable-gtk --disable-curses --disable-vnc
-make -j {CPUCORENUMBER}
+make -j $(nproc)
 cd ../../../faultplugin/
 make
 ```
@@ -79,15 +86,15 @@ The program output will be stored in an HDF5 file. For a description of how to i
 ### Running the program
 
 To run the python3 program, type:
-```
+```sh
 python3 controller.py --debug --fault fault.json --qemu qemuconf.json output.hdf5
 ```
 Replace *fault.json* and *qemuconf.json* with the corresponding files.
 
 The *--debug flag* creates a log file for each experiment. The name of the log file has the following format: ``log_experiment-id.txt``, e.g., ``log_4.txt`` for the experiment with ID 4.
 
 To obtain further information on the input parameters, type:
-```
+```sh
 python3 controller.py --help
 ```
 
@@ -96,12 +103,11 @@ python3 controller.py --help
 It is possible to connect to a running QEMU instance with GDB. To use this feature in the framework and observe introduced faults the *--gdb* flag can be set.
 ARCHIE will start the internal QEMU process with GDB enabled and halts at the startup of the simulated system. To connect to QEMU from GDB use port 1234.
 It also will force the framework to only spawn one worker and it will step through all faults configured in *fault.json*. If one specific fault is required, the JSON file needs to be edited to only contain this specific fault.
-```
+```sh
 python3 controller.py --gdb --fault fault.json --qemu qemuconf.json output.hdf5
 ```
 To connect from GDB to the QEMU session use
 ```
 targ rem:localhost:1234
 ```
 QEMU will wait unil the GDB session is attached. The debugging mode is only suitable for the analysis of a low number of faults. Stepping through a large amount of faults is cumbersome. This should be considered when adjusting the JSON files.
-

build.sh

@@ -37,7 +37,7 @@ install_python3_distro() {
 	if [ "${ID:-linux}" = "debian" ] || [ "${ID_LIKE#*debian*}" != "${ID_LIKE}" ]
 	then
 		echo "Looks like Debian!"
-		sudo apt-get install python3-tables python3-pandas python3-prctl python3-protobuf python3-tqdm
+		sudo apt-get install python3-tables python3-pandas python3-prctl python3-protobuf python3-tqdm python3-psutil python3-json5 python3-setuptools
 
 		echo "Rebuild protobuf files to support the installed package versions"
 		cd protobuf

requirements.txt

@@ -1,7 +1,7 @@
-pandas~=1.5
+pandas==2.1.4
 python-prctl==1.8.1
-tables==3.7.0
+tables==3.9.2
 json5==0.9.10
 protobuf==4.21.12
 tqdm==4.65.0
-psutil==5.9.6
+psutil==5.9.8