//_________________________________________________________________________
//
// Project: Moonlight
// Module: Microkernel declarations for user code
// Version: 1.0
// File name: mmkernel.h
// Author: Enrique Velasco Diaz
//_________________________________________________________________________
//
// Common helper macros
#ifndef max
#define max(a,b) (((a) > (b)) ? (a) : (b))
#endif
#ifndef min
#define min(a,b) (((a) < (b)) ? (a) : (b))
#endif
#define DWORD unsigned
//_________________________________________________________________________
//
// API prototypes and associated constants
void mK_yield(void);
//_________________________________________________________________________
//
void mK_init(void);
void mK_start(void);
void mK_end(void);
//_________________________________________________________________________
//
typedef struct
{
void *code; // address of process code starting point
unsigned stack_size; // size of the stack area
unsigned char default_priority;
unsigned char current_priority;
char *name; // process' symbolic name
}TASK_INFO;
int mK_create_task(TASK_INFO *settings);
#define mKCREATPROC_NOMEM -1
int mK_local_init(void);
//_________________________________________________________________________
//
int mK_self_pid(void);
//_________________________________________________________________________
//
int mK_get_task_info(int pid, TASK_INFO *info);
#define mKGETINFO_OK 0
#define mKGETINFO_BADPID -1
//_________________________________________________________________________
//
int mK_set_task_info(int pid, TASK_INFO *info);
#define mKSETINFO_OK 0
#define mKSETINFO_BADPID -1
//_________________________________________________________________________
//
void mK_kill_task(void);
//_________________________________________________________________________
//
void mK_enter_critical(void);
void mK_exit_critical(void);
//_________________________________________________________________________
//
int mK_create_semaphore(int value, int maximum);
#define mKCREATSM_NOMEM -1
#define mKCREATSM_BADVALUE -2
#define mKCREATSM_BADCEILING -3
//_________________________________________________________________________
//
int mK_wait_semaphore(int semaphore);
#define mKWAITSM_SIGNAL 0
#define mKWAITSM_BADNUM -1
//_________________________________________________________________________
//
int mK_signal_semaphore(int semaphore);
#define mKSIGNALSM_OK 0
#define mKSIGNALSM_BADNUM -1
#define mKSIGNALSM_OVERFLOW -2
//_________________________________________________________________________
//
int mK_delete_semaphore(int semaphore);
#define mKDELSM_OK 0
#define mKDELSM_BADNUM -1
#define mKDELSM_BUSY -2
//_________________________________________________________________________
//
typedef struct
{
int seconds;
int minutes;
int hours;
int monthday;
int month;
int year;
}mKTIME;
void mK_time_of_day(mKTIME *buffer);
//_________________________________________________________________________
//
unsigned int mK_get_systicks(void);
//_________________________________________________________________________
//
void *mK_malloc(int size);
//_________________________________________________________________________
//
int mK_mfree(void *block);
#define mKMFREE_OK 0
#define mKMFREE_BADPTR -1
//_________________________________________________________________________
//
#define mKLOCAL_MACHINE -1
int mK_non_blocking_send(int machine,
int receiver,
void *contents,
int length);
#define mKNBSEND_OK 0
#define mKNBSEND_BADPID -1
#define mKNBSEND_OVERFLOW -2
//_________________________________________________________________________
//
int mK_blocking_send(int machine,
int receiver,
void *message_contents,
int message_length,
void *reply_contents,
int *reply_length);
#define mKBKSEND_OK 0
#define mKBKSEND_BADPID -1
#define mKBKSEND_OVERFLOW -2
//_________________________________________________________________________
//
int mK_receive(int *machine,
int *pid,
void *contents,
int *length,
int *reply_requested,
DWORD delay);
#define mKRECEIVE_ARRIVAL 0
#define mKRECEIVE_ELAPSED 1
#define mKRECEIVE_NOTHING 2
#define mKWAIT_FOREVER -1
#define mKNOWAIT -2
//_________________________________________________________________________
//
int mK_respond(int machine,
int receiver,
void *contents,
int length);
#define mKRESPOND_OK 0
#define mKRESPOND_BADPID -1
#define mKRESPOND_BADSTATE -2
//_________________________________________________________________________
//
int mK_freeze(int pid);
#define mKFREEZE_OK 0
#define mKFREEZE_BADPID -1
//_________________________________________________________________________
//
int mK_unfreeze(int pid);
#define mKUNFREEZE_OK 0
#define mKUNFREEZE_BADPID -1
#define mKUNFREEZE_NOFROZEN -2
//_________________________________________________________________________
//
typedef struct
{
// general information
int how_many; // total number of tasks in the system
// task profiler info
int times_entered;
int time_running;
// other status info
int process_state; // detailed state
#define READY 1
#define RUNNING 2
#define PENDING 3
#define RECEIVING 4
#define EXPECTING 5
#define FROZEN 6
unsigned stack_size;
unsigned char default_priority;
unsigned char current_priority;
char *symbolic_name;
}mKTASK_INFO;
int mK_get_task_snapshot(int task, mKTASK_INFO *buffer);
#define mKGTASKINFO_OK 0
#define mKGTASKINFO_BADPID -1
//_________________________________________________________________________
//
typedef struct
{
short value;
short maximum;
int *waiting_tasks; // a large enough space must be previously allocated
}mKSEM_INFO;
int mK_get_semaphore_snapshot(int semaphore, mKSEM_INFO *buffer);
#define mKGSEMINFO_OK 0
#define mKGSEMINFO_BADNUM -1
//_________________________________________________________________________
//
int mK_profiler_control(int command, int task);
#define mKPROF_ON 1
#define mKPROF_OFF 0
#define mKPROF_RESET 2
#define mKPROFCNT_OK 0
#define mKPROFCNT_BADCOMMAND -1
#define mKPROFCNT_BADPID -2
//_________________________________________________________________________
//
typedef struct
{
void *block_address;
int block_size;
int owner_task;
}mKBLOCK_INFO;
mKBLOCK_INFO *mK_heap_view(void);
//_________________________________________________________________________
//
