Multiprocessing

.clang-format

@@ -0,0 +1,41 @@
+---
+BasedOnStyle: Google
+AlignAfterOpenBracket: Align
+AlignConsecutiveMacros: true
+AlignTrailingComments: true
+AllowShortBlocksOnASingleLine: true
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: WithoutElse
+AlwaysBreakBeforeMultilineStrings: false
+BinPackArguments: false
+BinPackParameters: false
+BreakBeforeBraces: Attach
+BreakBeforeTernaryOperators: true
+BreakStringLiterals: true
+ColumnLimit: 100
+DerivePointerAlignment: false
+IncludeBlocks: Regroup
+IndentCaseLabels: true
+IndentPPDirectives: BeforeHash
+IndentWidth: 4
+IndentWrappedFunctionNames: true
+Language: Cpp
+MaxEmptyLinesToKeep: 2
+PointerAlignment: Middle
+ReflowComments: true
+SortIncludes: true
+SpaceAfterCStyleCast: false
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: false
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeParens: ControlStatements
+SpaceInEmptyParentheses: false
+SpacesInAngles: false
+SpacesInCStyleCastParentheses: false
+SpacesInContainerLiterals: false
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+TabWidth: 4
+UseTab: Never
+
+...

.dir-locals.el

@@ -0,0 +1,20 @@
+((nil . ((eval . (let ((root (projectile-project-root)))
+  (let ((command (concat "arm-none-eabi-gdb -i=mi -ex \"target remote localhost:1234\" -ex \"symbol-file " root "src/kernel/build/kernel.sym\"")))
+    (setq-local gud-gud-gdb-command-name command)
+    (setq-local gud-gdb-command-name command)
+    (set (make-local-variable 'compile-command)
+         (concat "cd " (concat root "src") " && make test"))
+    (let ((map (make-sparse-keymap))) 
+
+      (set-keymap-parent map (current-local-map))
+      (use-local-map map)
+      (local-set-key [f5] 'compile)
+      (local-set-key [f6] 'co/gdb)
+
+      (defun co/gdb ()
+        (interactive)
+        (async-shell-command (concat "cd "
+                                     (concat (projectile-project-root) "src")
+                                     " && "
+                                     "make debug") nil 0)
+        (gdb gud-gdb-command-name)))))))))

.dockerignore

@@ -0,0 +1,18 @@
+.git
+.github
+.idea
+.vscode
+projet/build/
+project/kernel/build/
+
+src/toolchain/
+src/qemu/
+!src/toolchain/build.sh
+src/build/
+src/kernel/build
+!src/build/build.sh
+src/docs/
+src/html/
+src/latex
+src/course_os_docs.pdf
+

.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+charset = utf-8
+
+[*.yml]
+indent_size = 2

.gitattributes

@@ -0,0 +1,4 @@
+# Sources
+*.c     text diff=c
+*.h     text diff=c
+*.h     linguist-language=C

.github/workflows/os_test.yml

@@ -0,0 +1,16 @@
+name: course_os test suite
+
+on: [push]
+
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: build
+        run: docker build -t course_os .
+
+      - name: test
+        run: docker run course_os sh -c 'cd build && ninja run-test'

.gitignore

@@ -1,32 +1,82 @@
-#these were not originally apart of the repo -- appeared after build
-/kernel/kernel.bin
-/kernel/flash.bin
-/kernel/boot-commands
-/kernel/card.sd
-/toolchain/target/
-/u-boot/u-boot-*
-/qemu/
-!/qemu/build.sh
+# Build files
+/build
+src/kernel/kernel.bin
+src/kernel/flash.bin
+src/kernel/boot-commands
+src/kernel/card.sd
+src/kernel/src/test_suite/test.c
+src/kernel/src/test_suite/generated/
+src/kernel/build
+src/kernel/build/kernel.sym
+build/
+.cache/
+builddir/
 
+# Toolchain dir, but not the build script
+src/toolchain/
+toolchain/
+!src/toolchain/build.sh
+project/scripts/qemu-*/
+*.bz2
+arm-none-eabi/
+
+# Qemu dir, again without its buildscript
+src/qemu/
+qemu/
+!src/qemu/build.sh
+
+# Generic build dirs
+src/build
+/cmake-build-*/
+
+# Generated docs
+src/docs/
+src/html/
+src/latex/
+src/course_os_docs.pdf
+docs/
+
+# Editor specific
 .settings/
 .cproject
 .project
+.vs/
+/.idea/
+!/.idea/runConfigurations
+/.vscode/
+!/.vscode/launch.json
+!/.vscode/tasks.json
+*~
+*.swp
+[._]*.s[a-w][a-z]
+[._]s[a-w][a-z]
+*.un~
+Session.vim
+.netrwhist
+.cache/
+
+# CCLS files
+.ccls-cache/
+compile_commands.json
 
-#always exclude these from being pushed
+# Binary files
 *.o
 *.img
 *.map
 *.elf
 *.bin
-*~
-*.swp
 /user/hello/hello
+/user/hello/hello1
+/user/hello/hello2
 /user/libc/libc.a
+kernel/build/kernel.sym
 
-[._]*.s[a-w][a-z]
-[._]s[a-w][a-z]
-*.un~
-Session.vim
-.netrwhist
+# Floobits (CLion collabrative editing plugin)
+.floo
+.flooignore
 
+# Misc
 NOTES
+/server.PID
+*~
+#*

.vscode/launch.json

@@ -0,0 +1,41 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+
+            "name": "(gdb) Attach - C/C++",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceFolder}/src/kernel/build/kernel.sym",
+            "cwd": "${workspaceFolder}/src/kernel/",
+            "miDebuggerPath": "${workspaceFolder}/src/toolchain/arm-none-eabi/bin/arm-none-eabi-gdb",
+            "setupCommands": [
+                {
+                    "description": "Enable pretty-printing for gdb",
+                    "text": "-enable-pretty-printing",
+                    "ignoreFailures": true
+                }
+            ],
+            "linux": {
+                "MIMode": "gdb"
+            },
+            "miDebuggerServerAddress": "localhost:1234",
+            "preLaunchTask": "run_debug"
+
+        },
+        {
+            "name": "(gdb) Attach - Native",
+            "type": "gdb",
+            "request": "attach",
+            "gdbpath": "${workspaceFolder}/src/toolchain/arm-none-eabi/bin/arm-none-eabi-gdb",
+            "executable": "${workspaceFolder}/src/kernel/build/kernel.sym",
+            "target": ":1234",
+            "remote": true,
+            "cwd": "${workspaceRoot}",
+            "valuesFormatting": "prettyPrinters",
+            "preLaunchTask": "run_debug",
+            "postDebugTask": "stop_debug"
+        }
+    ]
+}
+

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "files.associations": {
+        "*.h": "c"
+    }
+}

.vscode/tasks.json

@@ -0,0 +1,58 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=733558
+    // for the documentation about the tasks.json format
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "Set gdb_path",
+            "detail": "Adds generated toolchain to PATH variable. Will first load system and package binaries if available",
+            "type": "shell",
+            "command": "if [[ $(which arm-none-eabi-gdb) == *\"not\"* ]]; then export GDB_PATH=\"$(which arm-none-eabi-gdb)\"; else export GDB_PATH=\"${PWD}/src/arm-none-eabi/bin/\"; fi"
+        },
+        {
+            "label": "make test",
+            "detail": "Runs the course_os test suite",
+            "dependsOn": "set gdb_path",
+            "type": "shell",
+            "command": "make test",
+            "problemMatcher": "$gcc",
+            "group": {
+                "kind": "test",
+                "isDefault": true
+            }
+        },
+        {
+            "label": "run_debug",
+            "detail": "Runs qemu with gdbserver in the background",
+            "dependsOn": "set gdb_path",
+            "type": "shell",
+            "command": "cd ${workspaceFolder}/src/kernel && make debug",
+            "isBackground": true,
+            "presentation": {
+                "echo": true,
+                "reveal": "always",
+                "focus": true,
+                "panel": "shared",
+                "showReuseMessage": false,
+                "clear": false
+            },
+            "problemMatcher": {
+                "pattern": {
+                    "regexp": "^.*$"
+                },
+                "background": {
+                    "activeOnStart": true,
+                    "beginsPattern": "make debug",
+                    "endsPattern": "Configuring tools"
+                }
+            }
+        },
+        {
+            "label": "stop_debug",
+            "detail": "Stops the qemu emulator at port 1234",
+            "type": "shell",
+
+            "command": "kill $(sudo lsof -t -i:1234)"
+        }
+    ]
+}

CMakeLists.txt

@@ -0,0 +1,32 @@
+########################################################################
+## WARNING: This cmake file does *NOT* work to compile the course OS  ##
+## It is merely here to make clion detect all the source files        ##
+## so it can do code inspection. Use the supplied makefile to compile ##
+########################################################################
+
+cmake_minimum_required(VERSION 3.6)
+
+project(course_os)
+
+set(CMAKE_SYSTEM_NAME linux)
+set(CMAKE_SYSTEM_PROCESSOR arm)
+set(CMAKE_C_COMPILER ${CMAKE_CURRENT_SOURCE_DIR}/project/toolchain/arm-none-eabi/bin/arm-none-eabi-gcc)
+set(CMAKE_C_LINK_EXECUTABLE ${CMAKE_CURRENT_SOURCE_DIR}/project/toolchain/arm-none-eabi/bin/arm-none-eabi-ld)
+
+file(GLOB_RECURSE kernel_sources ./project/kernel/src/*.c ./project/kernel/src/**/*.c ./project/kernel/src/**/*.s)
+file(GLOB_RECURSE kernel_include LIST_DIRECTORIES true ./project/kernel/src/**/include)
+
+set(SOURCE_FILES ${kernel_sources})
+
+set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra")
+
+add_compile_definitions(ENABLE_TESTS MEM_DEBUG)
+
+add_executable(course_os ${SOURCE_FILES})
+
+message(${kernel_include})
+
+include_directories(
+    ${kernel_include}
+)
+

Dockerfile

@@ -0,0 +1,13 @@
+FROM fedora:33
+MAINTAINER  Jan S. Rellermeyer <[email protected]>
+
+RUN yum install -y arm-none-eabi-gcc-cs arm-none-eabi-binutils-cs arm-none-eabi-newlib qemu-system-arm-core python3 python3-jinja2 meson gcc
+
+WORKDIR /work
+COPY project .
+EXPOSE 1234
+
+# Since we installed the toolchain from the repositories we don't need
+# to install them separately. So we can just fake 'em.
+RUN meson build --cross-file cross_gcc.build && cd build && meson compile
+#VOLUME build /work/kernel/build