CS480-Projects/Sim02/simulator.h

#ifndef SIMULATORX
#define SIMULATORX

#include "StandardConstants.h"
#include "configops.h"
#include "metadataops.h"
#include "simtimer.h"

// data structures

typedef enum{
             PROCESS_STATE_NEW = 0, 
             PROCESS_STATE_READY, 
             PROCESS_STATE_RUNNING, 
             PROCESS_STATE_BLOCKED, 
             PROCESS_STATE_TERMINATED
            } PROCESS_STATES;

typedef struct ProcessControlBlockStruct
{
    int uniquePid;
    PROCESS_STATES process_state;
    // need a process start ptr for where the process starts.
        // this will be a mini loop within the master loop that goes until it
        // hits the app end command.
        // it may hold the next opcode, since you don't need to traverse backward
    OpCodeType *nextOpCode;
    // have an IO cycle count here
    int ioCycles;
    // have a CPU cycle count here
    int cpuCycles;
    // maybe have a total cycle count here
    int totalCycles;
    // time left could be calculated from these.
        // potentially could change the cycles or have a 'left' variable to 
        // see how many are left.
    // also need a time left state here?
    double timeLeft;
    // connect to the next process control block here
    struct ProcessControlBlockStruct *nextPtr;
} ProcessControlBlock;

typedef struct ProcessControlBlockLLStruct
{
    // holds the head ptr for PCBs
    ProcessControlBlock *headPtr;
} ProcessControlBlockLL;

/*
Name: ???
Process: ???
Function Input/Parameters: ???
Function Output/Parameters: none
Function Output/Returned: none
Device Input/Device: none
Device Output/Device: none
Dependencies: ???
*/
// need a function (or functions) to handle FILE I/O?
// runSim function will have a FILE *
    // will have a function that gets the FILE * and 
    // adds whatever operation occurred

/*
Name: ???
Process: ???
Function Input/Parameters: ???
Function Output/Parameters: none
Function Output/Returned: none
Device Input/Device: none
Device Output/Device: none
Dependencies: ???
*/
// need a function for the global/local timer (given??? may need to just import)

// need a function for scheduler/dispatcher
    // this could use a switch statement to tell which scheduling method to choose from.
    // Sim02 only requires FCFS working atm.

// need a function called createProcessList
// this initializes the process control block ll.

// need a function called fillProcessList
// this fills the linked list of PCBs,
// loads the first instruction after app start
// and ...

// reads through the opcode struct to fill out the linked list of PCBs

// need a function called destroyProcessList
// deallocated the ll of PCBs recursively, frees the rest of the struct.

// have a function to change the state of the process?
// have it take in the process struct, switch it's state and report that it
// has switched FROM a state TO a different state.

/*
Name: createProcessList
Process: initializes head pointer to the PCBs
Function Input/Parameters: none
Function Output/Parameters: none
Function Output/Returned: head pointer to the PCBs
Device Input/Device: none
Device Output/Device: none
Dependencies: malloc, sizeof, ???
*/
ProcessControlBlockLL *createProcessList();

/*
Name: destroyProcessList
Process: deallocates memory used for the linked list struct
Function Input/Parameters: head pointer to linked list (ProcessControlBlockLL *)
Function Output/Parameters: none
Function Output/Returned: NULL
Device Input/Device: none
Device Output/Device: none
Dependencies: free, destroyProcessListHelper, ???
*/
ProcessControlBlockLL *destroyProcessList(ProcessControlBlockLL *linkedListPtr);

/*
Name: destroyProcessListHelper
Process: recursively clears the PCB linked list struct, freeing the struct
Function Input/Parameters: head pointer to linked list (ProcessControlBlockLL *)
Function Output/Parameters: none
Function Output/Returned: NULL
Device Input/Device: none
Device Output/Device: none
Dependencies: free, destroyProcessListHelper(recursively), ???
*/
ProcessControlBlock *destroyProcessListHelper(ProcessControlBlock *nodePtr);

/*
Name: fillProcessList
Process: iterates through the metadata LL, fills out each process as needed.
Function Input/Parameters: metadata (OpCodeType *),
                           headPointer (ProcessControlBlockLL *)
Function Output/Parameters: none
Function Output/Returned: pointer to filled PCB (ProcessControlBlockLL *)
Device Input/Device: none
Device Output/Device: none
Dependencies: ???
*/
ProcessControlBlockLL *fillProcessList(OpCodeType *metadataPtr, ProcessControlBlockLL *headPointer);

/*
Name: logOutput
Process: Takes in a string, and then outputs it to monitor AND/OR file
Function Input/Parameters: string (char *), file pointer (FILE *), 
                           configuration data (ConfigDataType *),
                           end of simulator (bool)
Function Output/Parameters: none
Function Output/Returned: none
Device Input/Device: none
Device Output/Device: none
Dependencies: sprintf, ???
*/
void logOutput(ConfigDataType *configPtr, char *logStr, bool isEnd);

/*
Name: runSim
Process: primary simulation driver
Function Input/Parameters: configuration data (ConfigDataType *),
                            metadata (OpCodeType *)
Function Output/Parameters: none
Function Output/Returned: none
Device Input/Device: none
Device Output/Device: none
Dependencies: ???
*/
void runSim(ConfigDataType *configPtr, OpCodeType *metaDataMstrPtr);

/*
Name: scheduleProcess
Process: takes in the scheduling data, and then returns which process is to be ran
Function Input/Parameters: head pointer of PCB List (ProcessControlBlockLL *)
Function Output/Parameters: none
Function Output/Returned: none
Device Input/Device: none
Device Output/Device: none
Dependencies: ???
*/
int scheduleProcess(ProcessControlBlockLL *headPointer, ConfigDataType *configPtr);

#endif // SIMULATORX