kernel/amd64: vas: Add more documentation

Signed-off-by: Ian Moffett <ian@osmora.org>

1 files changed, 11 insertions, 0 deletions

diff --git a/sys/include/arch/amd64/vas.h b/sys/include/arch/amd64/vas.h
index 347bf92..b8eef89 100644
--- a/sys/include/arch/amd64/vas.h
+++ b/sys/include/arch/amd64/vas.h
@@ -33,6 +33,17 @@
 #include <sys/types.h>
 #include <sys/spinlock.h>
 
+/*
+ * VAS structure - describes a virtual address space
+ *
+ * XXX: This structure shall exist per-process.
+ *
+ * TODO: As of now, VAS operations are *not* serialized!!!
+ *       This must change once Hyra becomes multi-threaded
+ *       or things will go wrong *very* quickly. Ensure of
+ *       this or you will suffer the consequences of undefined
+ *       behavior and you will not like it!
+ */
 struct vas {
     size_t cr3_flags;       /* CR3 flags */
     uintptr_t top_level;    /* PML5 if `use_l5_paging' true, otherwise PML4 */