X-Git-Url: https://git.ucc.asn.au/?a=blobdiff_plain;f=Kernel%2Finclude%2Facess.h;h=4286f5ee7d1a65616a6cbd93ab85c6cece485870;hb=9d85201216cb35e1b1e051b1d7cdc38eaa5befa4;hp=861fd3011affaf696d9f7bddf0082dbd298dc228;hpb=b5a1402b18d2f8cb360bf2fc524609b374bac8ec;p=tpg%2Facess2.git

diff --git a/Kernel/include/acess.h b/Kernel/include/acess.h
index 861fd301..4286f5ee 100644
--- a/Kernel/include/acess.h
+++ b/Kernel/include/acess.h
@@ -25,6 +25,7 @@ typedef struct sMutex	tMutex;
 
 struct sMutex {
 	tShortSpinlock	Protector;	//!< Protector for the lock strucure
+	const char	*Name;	//!< Human-readable name
 	struct sThread	*volatile Owner;	//!< Owner of the lock (set upon getting the lock)
 	struct sThread	*Waiting;	//!< Waiting threads
 	struct sThread	*LastWaiting;	//!< Waiting threads
@@ -94,7 +95,7 @@ typedef void (*tThreadFunction)(void*);
  * \{
  */
 typedef struct sKernelSymbol {
-	char	*Name;
+	const char	*Name;
 	tVAddr	Value;
 } tKernelSymbol;
 #define	EXPORT(_name)	tKernelSymbol _kexp_##_name __attribute__((section ("KEXPORT"),unused))={#_name, (tVAddr)_name}
@@ -109,13 +110,13 @@ typedef struct sKernelSymbol {
 extern int	IRQ_AddHandler(int Num, void (*Callback)(int));
 
 // --- Logging ---
-extern void	Log_KernelPanic(char *Ident, char *Message, ...);
-extern void	Log_Panic(char *Ident, char *Message, ...);
-extern void	Log_Error(char *Ident, char *Message, ...);
-extern void	Log_Warning(char *Ident, char *Message, ...);
-extern void	Log_Notice(char *Ident, char *Message, ...);
-extern void	Log_Log(char *Ident, char *Message, ...);
-extern void	Log_Debug(char *Ident, char *Message, ...);
+extern void	Log_KernelPanic(const char *Ident, const char *Message, ...);
+extern void	Log_Panic(const char *Ident, const char *Message, ...);
+extern void	Log_Error(const char *Ident, const char *Message, ...);
+extern void	Log_Warning(const char *Ident, const char *Message, ...);
+extern void	Log_Notice(const char *Ident, const char *Message, ...);
+extern void	Log_Log(const char *Ident, const char *Message, ...);
+extern void	Log_Debug(const char *Ident, const char *Message, ...);
 
 // --- Debug ---
 /**
@@ -123,16 +124,16 @@ extern void	Log_Debug(char *Ident, char *Message, ...);
  * \{
  */
 extern void	Debug_KernelPanic(void);	//!< Initiate a kernel panic
-extern void	Panic(char *Msg, ...);	//!< Print a panic message (initiates a kernel panic)
-extern void	Warning(char *Msg, ...);	//!< Print a warning message
-extern void	LogF(char *Fmt, ...);	//!< Print a log message without a trailing newline
-extern void	Log(char *Fmt, ...);	//!< Print a log message
-extern void	Debug(char *Fmt, ...);	//!< Print a debug message (doesn't go to KTerm)
-extern void	LogV(char *Fmt, va_list Args);	//!< va_list Log message
-extern void	Debug_Enter(char *FuncName, char *ArgTypes, ...);
-extern void	Debug_Log(char *FuncName, char *Fmt, ...);
-extern void	Debug_Leave(char *FuncName, char RetType, ...);
-extern void	Debug_HexDump(char *Header, void *Data, Uint Length);
+extern void	Panic(const char *Msg, ...);	//!< Print a panic message (initiates a kernel panic)
+extern void	Warning(const char *Msg, ...);	//!< Print a warning message
+extern void	LogF(const char *Fmt, ...);	//!< Print a log message without a trailing newline
+extern void	Log(const char *Fmt, ...);	//!< Print a log message
+extern void	Debug(const char *Fmt, ...);	//!< Print a debug message (doesn't go to KTerm)
+extern void	LogV(const char *Fmt, va_list Args);	//!< va_list Log message
+extern void	Debug_Enter(const char *FuncName, const char *ArgTypes, ...);
+extern void	Debug_Log(const char *FuncName, const char *Fmt, ...);
+extern void	Debug_Leave(const char *FuncName, char RetType, ...);
+extern void	Debug_HexDump(const char *Header, const void *Data, Uint Length);
 #define UNIMPLEMENTED()	Warning("'%s' unimplemented", __func__)
 #if DEBUG
 # define ENTER(_types...)	Debug_Enter((char*)__func__, _types)
@@ -184,7 +185,7 @@ extern Uint64	inq(Uint16 Port);
  * \param VAddr	Virtual Address to allocate at
  * \return Physical address allocated
  */
-extern tPAddr	MM_Allocate(tVAddr VAddr);
+extern tPAddr	MM_Allocate(tVAddr VAddr) __attribute__ ((warn_unused_result));
 /**
  * \brief Deallocate a page
  * \param VAddr	Virtual address to unmap
@@ -276,6 +277,12 @@ extern void	MM_RefPhys(tPAddr PAddr);
  * \param PAddr	Page to dereference
  */
 extern void	MM_DerefPhys(tPAddr PAddr);
+/**
+ * \brief Get the number of times a page has been referenced
+ * \param PAddr	Address to check
+ * \return Reference count for the page
+ */
+extern int	MM_GetRefCount(tPAddr PAddr);
 /**
  * \}
  */
@@ -297,8 +304,8 @@ extern void *memsetd(void *dest, Uint32 val, size_t count);
  * \name Memory Validation
  * \{
  */
-extern int	CheckString(char *String);
-extern int	CheckMem(void *Mem, int Num);
+extern int	CheckString(const char *String);
+extern int	CheckMem(const void *Mem, int Num);
 /**
  * \}
  */
@@ -336,14 +343,14 @@ extern char	**str_split(const char *__str, char __ch);
 extern char	*strchr(const char *__s, int __c);
 extern int	strpos(const char *Str, char Ch);
 extern int	strpos8(const char *str, Uint32 search);
-extern void	itoa(char *buf, Uint num, int base, int minLength, char pad);
+extern void	itoa(char *buf, Uint64 num, int base, int minLength, char pad);
 extern int	atoi(const char *string);
-extern int	ReadUTF8(Uint8 *str, Uint32 *Val);
+extern int	ReadUTF8(const Uint8 *str, Uint32 *Val);
 extern int	WriteUTF8(Uint8 *str, Uint32 Val);
-extern int	ModUtil_SetIdent(char *Dest, char *Value);
-extern int	ModUtil_LookupString(char **Array, char *Needle);
+extern int	ModUtil_SetIdent(char *Dest, const char *Value);
+extern int	ModUtil_LookupString(const char **Array, const char *Needle);
 
-extern Uint8	ByteSum(void *Ptr, int Size);
+extern Uint8	ByteSum(const void *Ptr, int Size);
 extern int	UnHex(Uint8 *Dest, size_t DestSize, const char *SourceString);
 /**
  * \}
@@ -360,8 +367,8 @@ extern int	CallWithArgArray(void *Function, int NArgs, Uint *Args);
  * \name Modules
  * \{
  */
-extern int	Module_LoadMem(void *Buffer, Uint Length, char *ArgStr);
-extern int	Module_LoadFile(char *Path, char *ArgStr);
+extern int	Module_LoadMem(void *Buffer, Uint Length, const char *ArgStr);
+extern int	Module_LoadFile(const char *Path, const char *ArgStr);
 /**
  * \}
  */
@@ -394,6 +401,9 @@ extern int	Time_CreateTimer(int Delta, tTimerCallback *Callback, void *Argument)
  * \brief Removed an active timer
  */
 extern void	Time_RemoveTimer(int ID);
+/**
+ * \brief Wait for a period of milliseconds
+ */
 extern void	Time_Delay(int Delay);
 /**
  * \}
@@ -417,7 +427,7 @@ extern tGID	Threads_GetGID(void);
 extern int	SpawnTask(tThreadFunction Function, void *Arg);
 extern Uint	*Threads_GetCfgPtr(int Id);
 extern int	Threads_SetName(const char *NewName);
-extern void	Mutex_Acquire(tMutex *Mutex);
+extern int	Mutex_Acquire(tMutex *Mutex);
 extern void	Mutex_Release(tMutex *Mutex);
 extern int	Mutex_IsLocked(tMutex *Mutex);
 /**