X-Git-Url: https://git.ucc.asn.au/?a=blobdiff_plain;f=Kernel%2Finclude%2Fhal_proc.h;h=a189d568483d3b8fb814d4299492fb97b93d295c;hb=dd2491a82880ed9b01b5d66b1814d271921797a4;hp=fad225b8d9972393a4bada96edba1dcdcd470254;hpb=61c8b3334fb9bb3c1fb48d9f1f3508ffbe5341bf;p=tpg%2Facess2.git

diff --git a/Kernel/include/hal_proc.h b/Kernel/include/hal_proc.h
index fad225b8..a189d568 100644
--- a/Kernel/include/hal_proc.h
+++ b/Kernel/include/hal_proc.h
@@ -8,13 +8,43 @@
  */
 #ifndef _HAL_PROC_H_
 #define _HAL_PROC_H_
+/**
+ * \file hal_proc.h
+ * \brief Achitecture defined thread/process management functions
+ */
 
 #include <threads_int.h>
 
+/**
+ * \brief Initialise the architecture dependent side of threading
+ */
 extern void	ArchThreads_Init(void);
+/**
+ * \brief Start preemptive multithreading (if needed)
+ */
 extern void	Proc_Start(void);
+/**
+ * \brief Called just before a thread is freed
+ */
+extern void	Proc_ClearThread(tThread *Thread);
+/**
+ * \brief Get the ID of this CPU
+ * \return Zero based CPU ID
+ */
 extern int	GetCPUNum(void);
+/**
+ * \brief Create a copy of the current process
+ * \param Flags	Options for the clone
+ * \return ID of the new thread/process
+ */
 extern tTID	Proc_Clone(Uint Flags);
+/**
+ * \brief Create a new kernel thread for the process
+ * \param Fnc	Thread root function
+ * \param Ptr	Argument to pass the root function
+ * \return ID of new thread
+ */
+extern tTID	Proc_NewKThread( void (*Fnc)(void*), void *Ptr );
 /**
  * \brief Start a user task
  * \param Entrypoint	User entrypoint
@@ -25,13 +55,36 @@ extern tTID	Proc_Clone(Uint Flags);
  * \note This function should free \a ArgV
  */
 extern void	Proc_StartUser(Uint Entrypoint, Uint Base, int ArgC, char **ArgV, int DataSize) NORETURN;
+/**
+ * \brief Call the fault handler for a thread
+ * \param Thread	Thread that is at fault :)
+ */
 extern void	Proc_CallFaultHandler(tThread *Thread);
+/**
+ * \brief Dump the CPU state for a thread
+ */
 extern void	Proc_DumpThreadCPUState(tThread *Thread);
+/**
+ * \brief Select a new task and run it, suspending this
+ */
 extern void	Proc_Reschedule(void);
 
-
-extern tPAddr	MM_ClearUser(void);
+/**
+ * \brief Clear the user's memory space back to the minimum required to run
+ */
+extern void	MM_ClearUser(void);
+/**
+ * \brief Dump the address space to the debug channel
+ * \param Start	First address
+ * \param End	Last address
+ */
 extern void	MM_DumpTables(tVAddr Start, tVAddr End);
 
-
+/**
+ * \brief Check if a buffer is valid (and all user if originally user)
+ * \param Addr	Base address
+ * \param Size	Size of the buffer in bytes
+ * \return Boolean valid (0: invalid, non-0: Valid)
+ */
+extern int	MM_IsValidBuffer(tVAddr Addr, size_t Size);
 #endif