This is an implementation of an operating system for the Operating Systems course, CPEN 331, at the University of British Columbia.

This is a project that involved implementing various portions of an operating system. The main goal was to gain a strengthened understanding of concurrency, synchronization, virtual memory, system calls, and file systems.

The course that this project was associated with describes the key aspects of the course as: Operating systems, their design and their implementation. Process concurrency, synchronization, communication and scheduling. Device drivers, memory management, virtual memory, file systems, networking and security.

A mutex lock is an struct that may be acquired only by one thread at a time. It operates using a waiting channel and a spinlock. When a thread wants to use the mutex lock, the implementation will acquire a spinlock (and spin on it if it not available), check the status of the lock flag, and sleep on the waiting channel / release the spinlock if the flag is not free.

The implementation of mutex locks can be found in /kern/thread/synch.c

A condition variable is a struct that threads may be placed on to sleep until some function calls upon it to wake a single thread, or all threads. Condition variables allow for synchronization as the act of going to sleep/waking up is an atomic action. They are often used for pausing until a condition is satisfied that allows for concurrent operations to occur safely.

The implementation of condition variables can be found in /kern/thread/synch.c

The implementation of open() can be found in /kern/syscall/fsyscall.c

The implementation of read() can be found in /kern/syscall/fsyscall.c

The implementation of write() can be found in /kern/syscall/fsyscall.c

The implementation of lseek() can be found in /kern/syscall/fsyscall.c

The implementation of close() can be found in /kern/syscall/fsyscall.c

The implementation of dup2() can be found in /kern/syscall/fsyscall.c

The implementation of chdir() can be found in /kern/syscall/fsyscall.c

The implementation of __getcwd() can be found in /kern/syscall/fsyscall.c

The implementation of getpid() can be found in /kern/syscall/psyscall.c

The implementation of fork() can be found in /kern/syscall/psyscall.c

The implementation of execv() can be found in /kern/syscall/psyscall.c

The implementation of _exit() can be found in /kern/syscall/psyscall.c

The implementation of kill_curthread() can be found in [TODO: fill in]

The implementation of sbrk() can be found in [TODO: fill in]

OS161 has implemented virtual memory. TODO: Talk about TLB, page tables, MMU, swap.

Detailed installation instructions for the base OS161 may be found here and here. If you are simply working with this repository, the following libraries will be required:

• bmake
• libmpc
• gmp
• wget

On Linux these may be installed by the command:

sudo apt-get -y install bmake ncurses-dev libmpc-dev

On macOS these may be installed by the Homebrew commands:

brew install bmake
brew install libmpc
brew install gmp
brew install wget

We assume os161 is installed at ~/os161. We must use the following commands to setup and compile the kernel

1. Configure the build.

cd ~/os161/src
./configure --ostree=$HOME/os161/root

2. Build userland.

bmake
bmake install

3. Configure a kernel.

cd kern/conf
./config DUMBVM

4. Compile and install the kernel

cd ~/os161/src/kern/compile/DUMBVM
bmake depend
bmake
bmake install