lots and lots of userspace stuff

4 files changed, 27 insertions, 33 deletions

diff --git a/documentation/compositor.txt b/documentation/compositor.txt
index 7442d51..4d8e70f 100644
--- a/documentation/compositor.txt
+++ b/documentation/compositor.txt
@@ -13,7 +13,7 @@ data types:
 
   color:
     opaque dword (result of encode color system call).
-    from c++, use __euler_encode_color in euler/syscall.hpp.
+    from c++, use euler::syscall::encode_color in euler/syscall.hpp.
 
   color rectangle:
     multiple hilbert colors, top to bottom by row, left to right within row
diff --git a/documentation/euler/heap.txt b/documentation/euler/heap.txt
deleted file mode 100644
index de1deec..0000000
--- a/documentation/euler/heap.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-this file documents dynamic memory allocation and deallocation in userspace.
-the unused areas of a process's usable mapped memory are divided into "chunks"
-with a start and a length, satisfying the following properties:
-  a) the length of a chunk is a positive power of 2
-  b) the start of a chunk is a multiple of its length
-  c) let s be a power of 2 and k be an integer. there are never two chunks with
-     length s and starts s * (2 * k) and s * (2 * k + 1). if ever an operation
-     would result in two such chunks, they are combined into one chunk with
-     length 2 * s and start 2 * s * k.
-
-a "chunk info page" is divided into 512 64-bit integers describing up to 255
-chunks and a pointer to another chunk info page. for each n from 0 to 254:
-  if the (2 * n)'th integer (where the first integer is the 0th one) is 0:
-    the (2 * n + 1)'th integer is unused.
-  if the (2 * n)'th integer is not 0:
-    the (2 * n)'th integer describes the length of a chunk
-    the (2 * n + 1)'th integer describes the start of the same chunk
-the 510th integer is a pointer to the next chunk info page, and the 511th
-integer is never used.
-
-when a program calls new or malloc with needed size s, we find a free chunk of
-length at least s + 8. we then remove that chunk from the list of free chunks,
-and add back in whatever is left after the first s + 8 bytes, if anything.
-in the first 8 bytes of the original chunk, we store the value s + 8. the
-remainder of the orginal chunk is returned to the program.
-
-during that process, if there isn't a chunk with the needed size, one or more
-new pages are requested from the kernel to create such a chunk.
-
-when a program calls delete or free with pointer ptr, we read the integer in
-the 8 bytes starting at ptr - 8 into a variable s. we then add the region
-starting at ptr - 8 with length s to the free memory.
diff --git a/documentation/kernel-interfaces/syscalls.txt b/documentation/kernel-interfaces/syscalls.txt
index ca93b56..399eb19 100644
--- a/documentation/kernel-interfaces/syscalls.txt
+++ b/documentation/kernel-interfaces/syscalls.txt
@@ -20,6 +20,7 @@ stream result:
   12 = other end closed
   13 = already exists
   14 = not sized
+  15 = not readable
 
 encode color:
   rax in: 0
@@ -173,3 +174,27 @@ get other end process handle:
   rdi in: stream handle
   rax out: stream result
   rdi out: process handle (if rax = success)
+
+start thread:
+  rax in: 20
+  rdi in: entry point
+  rsi in: argument
+  at entry, rsp is set to the top of a new stack, rdi is set
+  to the argument, and the other registers are undefined.
+
+clear socket read queue:
+  rax in: 21
+  rdi in: stream handle
+  rax out: number of bytes cleared (0 on bad handle or not a socket)
+
+get environment variable length:
+  rax in: 22
+  rdi in: pointer to variable name
+  rsi in: variable name length
+  rax out: variable value length, or -1 if unset
+
+get environment variable value:
+  rax in: 23
+  rdi in: pointer to variable name
+  rsi in: variable name length
+  rdx in: pointer to buffer for variable value
diff --git a/documentation/kernel/panics.txt b/documentation/kernel/panics.txt
index e1b6ec1..5c09490 100644
--- a/documentation/kernel/panics.txt
+++ b/documentation/kernel/panics.txt
@@ -3,6 +3,7 @@ panic. the following are the defined colors so far:
   #48a6ed - failed to get root node of initfs
   #5f8860 - no initfs module was given
   #7e874d - failed to look up /bin/init
+  #8077a6 - pure virtual function called (i think this should never happen?)
   #9af5e6 - an unimplemented path in the kernel
   #ba40bb - cpu exception occurred
   #c39db3 - failed to parse /bin/init