Our simulator can run normal programs compiled from C -- see the Makefile in the ‘test’ subdirectory for an example. The compiled programs must be linked with some special flags, then converted into Nachos format, using the program “coff2noff” (in bin directory). Floating-point operations are not supported.
Implement exception handling and handle the basic system calls for file system. Figure 2 depicts the role of file syscall API.
Figure 2: File Sys Call Interface between a user program and Nachos kernel
Signatures of the file system call API are given below. Implement the signatures exactly as given here. OpenFileID is integer type.
You will need to do the following steps:
Implement the int CreateFile(char *name) and int DeleteFile(char * name) system calls. The createfile system call will use the Nachos Filesystem Object Instance to create a zero length file. Remember, the filename exists in user space. This means the buffer that the user space pointer points to must be translated from user memory space to system memory space. The both system call return 0 for successful completion, -1 for an error.
Implement the OpenFileID Open(char *name, int type) and int Close(OpenFileID id) system calls. The user program can open three types of “files”: type 1 is read only (RO), type 2 is read and write (RW), and type 3 is read and execute (RX). If the type parameter is set to any other value, the system call should fail. Each process will allocate a fixed size file descriptor table. For now, set this size to be 8 file descriptors. The first two file descriptors, 0 and 1, will be reserved for console input and console output respectively. The open file system call will be responsible for translating the user space buffers when necessary and allocating the appropriate kernel constructs. For the case of actual files, you will use the filesystem objects provided to you in the filesystem directory. (NOTE: We are using the FILESYSTEM_STUB code). Calls will use the Nachos Filesystem Object Instance to open and close files. The Open system call returns the file descriptor id (OpenFileID == an integer number), or –1 if the call fails. Open can fail for several reasons, such as trying to open a file that does not exist or if there is not enough room in the file descriptor table. The close system call will take a file descriptor as the parameter. The system call will return –1 on failure and 0 on success.
Implement the int Read(OpenFileID fd, char *buffer, int nbytes) and int Write(OpenFileID fd, char *buffer, int nbytes) system calls. These system calls respectively read and write to a file defined by file descriptor fd. Remember, you must translate the character buffers appropriately and you must differentiate between console IO (OpenFileID 0 and 1) and different types of files. The read and write interaction will work as follows:
For console read and write, you will use the SynchConsole class (code/threads directory), instantiated through the gSynchConsole global variable (see threads/system.h,.cc). You will use the default SynchConsole behaviors for read and write, however you will be responsible for returning the correct types of values to the user. Read and write to Console will return the number of characters read or written. In the case of read or write failure to console, the return value should be –1. If an end of file is reached for a read operation from the console, the return value should be –2. End of file from the console is returned when the user types in Control-A. Read and write for console will use ASCII data for input and output. (Remember, ASCII data is NULL (\0) terminated). Also for file types RO and RW use ASCII reads, and for RX use BINARY read and write.
Implement the int Seek(OpenFileID fd, int pos) system call. Seek will move the file cursor to a specified location. The parameter pos will be the absolute character position within a file. If pos is a –1, the cursor will be moved to the end of file. The system call will return the actual file position upon success, -1 if the call fails. Seeks on console IO will fail. Seek differs from other calls above since you will have to implement the equivalent Nachos code yourself in the appropriate file in filesys directory.
Implement a new system call “Delete” int DeleteFile (char *name). Delete will have code 13. You will have to update the Start.s file in the test directory and the syscall.h file in the userprog directory. Recompile and test it with a sample program delete.
Implement a createFile C user program to test the createfile system call. You are not going to pass command line arguments to the call, so you will have to either use a fixed filename, or prompt the user for one when you have console IO working.
Implement a help user program. All help does is it prints a list to standard output of all the user programs you are going to create or have created in the test directory. Help should list each program and a brief 1 line description of each program.
Implement an echo user program. For each line of input from the console, the line gets echoed back to the console.
Implement a cat user program. Ask for a filename, and display the contents of the file to the console.
Implement a copy user program. Ask for a source and destination filename and copy the file.
Implement an outFile user program. This program asks for a destination file, takes input from the console, and writes it to the destination.
Implement a testSeek user program. This program should demonstrate whether your seek solution works correctly.
Implement any other tests you feel are necessary to ensure the correctness of your solution. BIG HINT: Implement tests to cover some of the things we changed that are not tested by parts e through k.
NOTE: A large portion of your grade will depend not only on the correctness of your implementation but how accurately your code conforms to the system call specifications presented in this document. As we are building a robust operating system, the user should not be able to perform any system call that will crash Nachos. Make sure there is a default case in the exception handler that will print out a message and halt the system in the case.
Documentation
This includes internal documentation (comments) and a BRIEF, BUT COMPLETE external document (read as: paper) describing what you did to the code and why you made your choices. DO NOT PARAPHRASE THIS LAB DESCRIPTION AND DO NOT TURN IN A PRINTOUT OF YOUR CODE AS THE EXTERNAL DOCUMENTATION.
Deliverables and grading
When you complete your project, remove all executables and object files. If you want me to read a message with your code, create a README.NOW file and place it in the nachos code directory. Tar and compress the code, and submit the file using the online submission system. It is important that you follow the design guidelines presented for the system calls. We will be running my own shells and test programs against your code to determine how accurately you designed your lab, and how robust your answers are. Grading for the implementation portion will depend on how robust and how accurate your solution is. Remember, the user should not be able to do anything to corrupt the system, and system calls should trap as many error conditions as possible.
