aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMatteo Gmür <matteo.gmuer1@ost.ch>2024-12-04 15:32:19 +0000
committerMatteo Gmür <matteo.gmuer1@ost.ch>2024-12-04 15:32:21 +0000
commit82bd19117313e6d61ab2ac03583e22b8a627f14a (patch)
tree76c062fde474af7c4e53b524242908a694273575 /docs
parent888ae9e053973125551729ff787b8f3c4cf4e1be (diff)
downloadteachos-82bd19117313e6d61ab2ac03583e22b8a627f14a.tar.xz
teachos-82bd19117313e6d61ab2ac03583e22b8a627f14a.zip
Add doxygen docs file
Diffstat (limited to 'docs')
-rw-r--r--docs/arch/x86_64/boot.rst9
-rw-r--r--docs/arch/x86_64/boot/pointers.rst5
-rw-r--r--docs/arch/x86_64/exception_handling.rst9
-rw-r--r--docs/arch/x86_64/exception_handling/assert.rst5
-rw-r--r--docs/arch/x86_64/exception_handling/panic.rst5
-rw-r--r--docs/arch/x86_64/kernel.rst9
-rw-r--r--docs/arch/x86_64/kernel/halt.rst5
-rw-r--r--docs/arch/x86_64/kernel/main.rst5
-rw-r--r--docs/arch/x86_64/memory.rst9
-rw-r--r--docs/arch/x86_64/memory/allocator.rst9
-rw-r--r--docs/arch/x86_64/memory/allocator/area_frame_allocator.rst5
-rw-r--r--docs/arch/x86_64/memory/allocator/concept.rst5
-rw-r--r--docs/arch/x86_64/memory/allocator/physical_frame.rst5
-rw-r--r--docs/arch/x86_64/memory/allocator/tiny_frame_allocator.rst5
-rw-r--r--docs/arch/x86_64/memory/cpu.rst9
-rw-r--r--docs/arch/x86_64/memory/cpu/control_register.rst5
-rw-r--r--docs/arch/x86_64/memory/cpu/msr.rst5
-rw-r--r--docs/arch/x86_64/memory/cpu/tlb.rst5
-rw-r--r--docs/arch/x86_64/memory/heap.rst9
-rw-r--r--docs/arch/x86_64/memory/heap/bump_allocator.rst5
-rw-r--r--docs/arch/x86_64/memory/heap/concept.rst5
-rw-r--r--docs/arch/x86_64/memory/heap/linked_list_allocator.rst5
-rw-r--r--docs/arch/x86_64/memory/heap/memory_block.rst5
-rw-r--r--docs/arch/x86_64/memory/main.rst5
-rw-r--r--docs/arch/x86_64/memory/multiboot.rst9
-rw-r--r--docs/arch/x86_64/memory/multiboot/elf_symbols_section.rst5
-rw-r--r--docs/arch/x86_64/memory/multiboot/info.rst5
-rw-r--r--docs/arch/x86_64/memory/multiboot/memory_map.rst5
-rw-r--r--docs/arch/x86_64/memory/multiboot/reader.rst5
-rw-r--r--docs/arch/x86_64/memory/paging.rst9
-rw-r--r--docs/arch/x86_64/memory/paging/active_page_table.rst5
-rw-r--r--docs/arch/x86_64/memory/paging/inactive_page_table.rst5
-rw-r--r--docs/arch/x86_64/memory/paging/kernel_mapper.rst5
-rw-r--r--docs/arch/x86_64/memory/paging/page_entry.rst5
-rw-r--r--docs/arch/x86_64/memory/paging/page_table.rst5
-rw-r--r--docs/arch/x86_64/memory/paging/temporary_page.rst5
-rw-r--r--docs/arch/x86_64/memory/paging/virtual_page.rst5
-rw-r--r--docs/arch/x86_64/shared.rst9
-rw-r--r--docs/arch/x86_64/shared/container.rst5
-rw-r--r--docs/arch/x86_64/shared/contiguous_pointer_iterator.rst5
-rw-r--r--docs/arch/x86_64/shared/forward_value_iterator.rst5
-rw-r--r--docs/arch/x86_64/shared/mutex.rst5
42 files changed, 250 insertions, 0 deletions
diff --git a/docs/arch/x86_64/boot.rst b/docs/arch/x86_64/boot.rst
new file mode 100644
index 0000000..8be2a57
--- /dev/null
+++ b/docs/arch/x86_64/boot.rst
@@ -0,0 +1,9 @@
+Boot Information Subsystem
+======================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ boot/* \ No newline at end of file
diff --git a/docs/arch/x86_64/boot/pointers.rst b/docs/arch/x86_64/boot/pointers.rst
new file mode 100644
index 0000000..3ec626a
--- /dev/null
+++ b/docs/arch/x86_64/boot/pointers.rst
@@ -0,0 +1,5 @@
+Boot Information Structure
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/boot/pointers.hpp
+
diff --git a/docs/arch/x86_64/exception_handling.rst b/docs/arch/x86_64/exception_handling.rst
new file mode 100644
index 0000000..3bf2770
--- /dev/null
+++ b/docs/arch/x86_64/exception_handling.rst
@@ -0,0 +1,9 @@
+Exception Handling Subsystem
+======================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ exception_handling/* \ No newline at end of file
diff --git a/docs/arch/x86_64/exception_handling/assert.rst b/docs/arch/x86_64/exception_handling/assert.rst
new file mode 100644
index 0000000..053cf66
--- /dev/null
+++ b/docs/arch/x86_64/exception_handling/assert.rst
@@ -0,0 +1,5 @@
+Exception Handling Assertion
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/exception_handling/assert.hpp
+
diff --git a/docs/arch/x86_64/exception_handling/panic.rst b/docs/arch/x86_64/exception_handling/panic.rst
new file mode 100644
index 0000000..50b6284
--- /dev/null
+++ b/docs/arch/x86_64/exception_handling/panic.rst
@@ -0,0 +1,5 @@
+Exception Handling Panic
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/exception_handling/panic.hpp
+
diff --git a/docs/arch/x86_64/kernel.rst b/docs/arch/x86_64/kernel.rst
new file mode 100644
index 0000000..650e3a6
--- /dev/null
+++ b/docs/arch/x86_64/kernel.rst
@@ -0,0 +1,9 @@
+Kernel Main Subsystem
+======================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ kernel/* \ No newline at end of file
diff --git a/docs/arch/x86_64/kernel/halt.rst b/docs/arch/x86_64/kernel/halt.rst
new file mode 100644
index 0000000..c425e81
--- /dev/null
+++ b/docs/arch/x86_64/kernel/halt.rst
@@ -0,0 +1,5 @@
+Kernel Halt
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/kernel/halt.hpp
+
diff --git a/docs/arch/x86_64/kernel/main.rst b/docs/arch/x86_64/kernel/main.rst
new file mode 100644
index 0000000..194bd85
--- /dev/null
+++ b/docs/arch/x86_64/kernel/main.rst
@@ -0,0 +1,5 @@
+Kernel Main
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/kernel/main.hpp
+
diff --git a/docs/arch/x86_64/memory.rst b/docs/arch/x86_64/memory.rst
new file mode 100644
index 0000000..58d12e9
--- /dev/null
+++ b/docs/arch/x86_64/memory.rst
@@ -0,0 +1,9 @@
+Kernel Memory Subsystem
+======================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ memory/* \ No newline at end of file
diff --git a/docs/arch/x86_64/memory/allocator.rst b/docs/arch/x86_64/memory/allocator.rst
new file mode 100644
index 0000000..6ce0a74
--- /dev/null
+++ b/docs/arch/x86_64/memory/allocator.rst
@@ -0,0 +1,9 @@
+Physical Frame Allocator Subsystem
+===========
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ allocator/*
diff --git a/docs/arch/x86_64/memory/allocator/area_frame_allocator.rst b/docs/arch/x86_64/memory/allocator/area_frame_allocator.rst
new file mode 100644
index 0000000..422f33c
--- /dev/null
+++ b/docs/arch/x86_64/memory/allocator/area_frame_allocator.rst
@@ -0,0 +1,5 @@
+Area Physical Frame Allocator
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/allocator/area_frame_allocator.hpp
+
diff --git a/docs/arch/x86_64/memory/allocator/concept.rst b/docs/arch/x86_64/memory/allocator/concept.rst
new file mode 100644
index 0000000..734a2ce
--- /dev/null
+++ b/docs/arch/x86_64/memory/allocator/concept.rst
@@ -0,0 +1,5 @@
+Physical Frame Allocator Concept
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/allocator/concept.hpp
+
diff --git a/docs/arch/x86_64/memory/allocator/physical_frame.rst b/docs/arch/x86_64/memory/allocator/physical_frame.rst
new file mode 100644
index 0000000..c5d0fd2
--- /dev/null
+++ b/docs/arch/x86_64/memory/allocator/physical_frame.rst
@@ -0,0 +1,5 @@
+Physical Frame
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/allocator/physical_frame.hpp
+
diff --git a/docs/arch/x86_64/memory/allocator/tiny_frame_allocator.rst b/docs/arch/x86_64/memory/allocator/tiny_frame_allocator.rst
new file mode 100644
index 0000000..27401b2
--- /dev/null
+++ b/docs/arch/x86_64/memory/allocator/tiny_frame_allocator.rst
@@ -0,0 +1,5 @@
+Tiny Physical Frame Allocator
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/allocator/tiny_frame_allocator.hpp
+
diff --git a/docs/arch/x86_64/memory/cpu.rst b/docs/arch/x86_64/memory/cpu.rst
new file mode 100644
index 0000000..4cb5af0
--- /dev/null
+++ b/docs/arch/x86_64/memory/cpu.rst
@@ -0,0 +1,9 @@
+CPU Registers Subsystem
+===========
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ cpu/*
diff --git a/docs/arch/x86_64/memory/cpu/control_register.rst b/docs/arch/x86_64/memory/cpu/control_register.rst
new file mode 100644
index 0000000..f087112
--- /dev/null
+++ b/docs/arch/x86_64/memory/cpu/control_register.rst
@@ -0,0 +1,5 @@
+CPU Control Registers
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/cpu/control_register.hpp
+
diff --git a/docs/arch/x86_64/memory/cpu/msr.rst b/docs/arch/x86_64/memory/cpu/msr.rst
new file mode 100644
index 0000000..c67d51c
--- /dev/null
+++ b/docs/arch/x86_64/memory/cpu/msr.rst
@@ -0,0 +1,5 @@
+CPU Model-Specific Register
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/cpu/msr.hpp
+
diff --git a/docs/arch/x86_64/memory/cpu/tlb.rst b/docs/arch/x86_64/memory/cpu/tlb.rst
new file mode 100644
index 0000000..0d482dc
--- /dev/null
+++ b/docs/arch/x86_64/memory/cpu/tlb.rst
@@ -0,0 +1,5 @@
+CPU Translation Lookaside Buffer
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/cpu/tlb.hpp
+
diff --git a/docs/arch/x86_64/memory/heap.rst b/docs/arch/x86_64/memory/heap.rst
new file mode 100644
index 0000000..409d93a
--- /dev/null
+++ b/docs/arch/x86_64/memory/heap.rst
@@ -0,0 +1,9 @@
+Heap Memory Subsystem
+===========
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ heap/*
diff --git a/docs/arch/x86_64/memory/heap/bump_allocator.rst b/docs/arch/x86_64/memory/heap/bump_allocator.rst
new file mode 100644
index 0000000..185f00b
--- /dev/null
+++ b/docs/arch/x86_64/memory/heap/bump_allocator.rst
@@ -0,0 +1,5 @@
+Heap Bump Allocator
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/heap/bump_allocator.hpp
+
diff --git a/docs/arch/x86_64/memory/heap/concept.rst b/docs/arch/x86_64/memory/heap/concept.rst
new file mode 100644
index 0000000..c0c3123
--- /dev/null
+++ b/docs/arch/x86_64/memory/heap/concept.rst
@@ -0,0 +1,5 @@
+Heap Allocator Concept
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/heap/concept.hpp
+
diff --git a/docs/arch/x86_64/memory/heap/linked_list_allocator.rst b/docs/arch/x86_64/memory/heap/linked_list_allocator.rst
new file mode 100644
index 0000000..26b25ab
--- /dev/null
+++ b/docs/arch/x86_64/memory/heap/linked_list_allocator.rst
@@ -0,0 +1,5 @@
+Heap Linked List Allocator
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/heap/linked_list_allocator.hpp
+
diff --git a/docs/arch/x86_64/memory/heap/memory_block.rst b/docs/arch/x86_64/memory/heap/memory_block.rst
new file mode 100644
index 0000000..8ed6566
--- /dev/null
+++ b/docs/arch/x86_64/memory/heap/memory_block.rst
@@ -0,0 +1,5 @@
+Heap Linked List Free Memory Block
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/heap/memory_block.hpp
+
diff --git a/docs/arch/x86_64/memory/main.rst b/docs/arch/x86_64/memory/main.rst
new file mode 100644
index 0000000..d9a9f39
--- /dev/null
+++ b/docs/arch/x86_64/memory/main.rst
@@ -0,0 +1,5 @@
+Memory Main
+===========
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/main.hpp
+
diff --git a/docs/arch/x86_64/memory/multiboot.rst b/docs/arch/x86_64/memory/multiboot.rst
new file mode 100644
index 0000000..22ec3f2
--- /dev/null
+++ b/docs/arch/x86_64/memory/multiboot.rst
@@ -0,0 +1,9 @@
+Kernel Multiboot Subsystem
+===========
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ multiboot/*
diff --git a/docs/arch/x86_64/memory/multiboot/elf_symbols_section.rst b/docs/arch/x86_64/memory/multiboot/elf_symbols_section.rst
new file mode 100644
index 0000000..bbd6dfb
--- /dev/null
+++ b/docs/arch/x86_64/memory/multiboot/elf_symbols_section.rst
@@ -0,0 +1,5 @@
+Multiboot ELF Header Symbols Section Structure
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/multiboot/elf_symbols_section.hpp
+
diff --git a/docs/arch/x86_64/memory/multiboot/info.rst b/docs/arch/x86_64/memory/multiboot/info.rst
new file mode 100644
index 0000000..847870d
--- /dev/null
+++ b/docs/arch/x86_64/memory/multiboot/info.rst
@@ -0,0 +1,5 @@
+Multiboot Header Information Structure
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/multiboot/info.hpp
+
diff --git a/docs/arch/x86_64/memory/multiboot/memory_map.rst b/docs/arch/x86_64/memory/multiboot/memory_map.rst
new file mode 100644
index 0000000..9c77331
--- /dev/null
+++ b/docs/arch/x86_64/memory/multiboot/memory_map.rst
@@ -0,0 +1,5 @@
+Multiboot Memory Map Header Structure
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/multiboot/memory_map.hpp
+
diff --git a/docs/arch/x86_64/memory/multiboot/reader.rst b/docs/arch/x86_64/memory/multiboot/reader.rst
new file mode 100644
index 0000000..fac98e2
--- /dev/null
+++ b/docs/arch/x86_64/memory/multiboot/reader.rst
@@ -0,0 +1,5 @@
+Multiboot Reader
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/multiboot/reader.hpp
+
diff --git a/docs/arch/x86_64/memory/paging.rst b/docs/arch/x86_64/memory/paging.rst
new file mode 100644
index 0000000..10cd976
--- /dev/null
+++ b/docs/arch/x86_64/memory/paging.rst
@@ -0,0 +1,9 @@
+Virtual Page Table Paging Subsystem
+===========
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ paging/*
diff --git a/docs/arch/x86_64/memory/paging/active_page_table.rst b/docs/arch/x86_64/memory/paging/active_page_table.rst
new file mode 100644
index 0000000..5710131
--- /dev/null
+++ b/docs/arch/x86_64/memory/paging/active_page_table.rst
@@ -0,0 +1,5 @@
+Active Page Table
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/paging/active_page_table.hpp
+
diff --git a/docs/arch/x86_64/memory/paging/inactive_page_table.rst b/docs/arch/x86_64/memory/paging/inactive_page_table.rst
new file mode 100644
index 0000000..5732e64
--- /dev/null
+++ b/docs/arch/x86_64/memory/paging/inactive_page_table.rst
@@ -0,0 +1,5 @@
+Inactive Page Table
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/paging/inactive_page_table.hpp
+
diff --git a/docs/arch/x86_64/memory/paging/kernel_mapper.rst b/docs/arch/x86_64/memory/paging/kernel_mapper.rst
new file mode 100644
index 0000000..9948e4e
--- /dev/null
+++ b/docs/arch/x86_64/memory/paging/kernel_mapper.rst
@@ -0,0 +1,5 @@
+Kernel Mapper
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/paging/kernel_mapper.hpp
+
diff --git a/docs/arch/x86_64/memory/paging/page_entry.rst b/docs/arch/x86_64/memory/paging/page_entry.rst
new file mode 100644
index 0000000..8900b0e
--- /dev/null
+++ b/docs/arch/x86_64/memory/paging/page_entry.rst
@@ -0,0 +1,5 @@
+Virtual Page Table Entry
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/paging/page_entry.hpp
+
diff --git a/docs/arch/x86_64/memory/paging/page_table.rst b/docs/arch/x86_64/memory/paging/page_table.rst
new file mode 100644
index 0000000..c5ab8c7
--- /dev/null
+++ b/docs/arch/x86_64/memory/paging/page_table.rst
@@ -0,0 +1,5 @@
+Virtual Page Table
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/paging/page_table.hpp
+
diff --git a/docs/arch/x86_64/memory/paging/temporary_page.rst b/docs/arch/x86_64/memory/paging/temporary_page.rst
new file mode 100644
index 0000000..0c63899
--- /dev/null
+++ b/docs/arch/x86_64/memory/paging/temporary_page.rst
@@ -0,0 +1,5 @@
+Temporary Virtual Page Table
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/paging/temporary_page.hpp
+
diff --git a/docs/arch/x86_64/memory/paging/virtual_page.rst b/docs/arch/x86_64/memory/paging/virtual_page.rst
new file mode 100644
index 0000000..dd42f47
--- /dev/null
+++ b/docs/arch/x86_64/memory/paging/virtual_page.rst
@@ -0,0 +1,5 @@
+Virtual Page
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/memory/paging/virtual_page.hpp
+
diff --git a/docs/arch/x86_64/shared.rst b/docs/arch/x86_64/shared.rst
new file mode 100644
index 0000000..c9b754f
--- /dev/null
+++ b/docs/arch/x86_64/shared.rst
@@ -0,0 +1,9 @@
+Shared Code Subsystem
+======================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+ :glob:
+
+ shared/* \ No newline at end of file
diff --git a/docs/arch/x86_64/shared/container.rst b/docs/arch/x86_64/shared/container.rst
new file mode 100644
index 0000000..c4b6aef
--- /dev/null
+++ b/docs/arch/x86_64/shared/container.rst
@@ -0,0 +1,5 @@
+Shared Container Structure
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/shared/container.hpp
+
diff --git a/docs/arch/x86_64/shared/contiguous_pointer_iterator.rst b/docs/arch/x86_64/shared/contiguous_pointer_iterator.rst
new file mode 100644
index 0000000..a5f921d
--- /dev/null
+++ b/docs/arch/x86_64/shared/contiguous_pointer_iterator.rst
@@ -0,0 +1,5 @@
+Shared Contiguous Pointer Iterator
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/shared/contiguous_pointer_iterator.hpp
+
diff --git a/docs/arch/x86_64/shared/forward_value_iterator.rst b/docs/arch/x86_64/shared/forward_value_iterator.rst
new file mode 100644
index 0000000..cdff5af
--- /dev/null
+++ b/docs/arch/x86_64/shared/forward_value_iterator.rst
@@ -0,0 +1,5 @@
+Shared Forward Value Iterator
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/shared/forward_value_iterator.hpp
+
diff --git a/docs/arch/x86_64/shared/mutex.rst b/docs/arch/x86_64/shared/mutex.rst
new file mode 100644
index 0000000..bc23636
--- /dev/null
+++ b/docs/arch/x86_64/shared/mutex.rst
@@ -0,0 +1,5 @@
+Shared Mutex
+=======================
+
+.. doxygenfile:: arch/x86_64/include/arch/shared/mutex.hpp
+