USER

MANUAL

A shell based OS custom build from scratch in C

KOS
Group No.: 44

July 2021
 USER'S MANUAL

TABLE OF CONTENTS

Page #

A. GENERAL INFORMATION A-1

1.1 System Overview ................................................................................................................... A-1
1.1.1 Objectives ……………………………………………………………………………….. A-1
1.2 Project References ................................................................................................................. A-2
1.3 Authorized Use Permission................................................................................................... A-2
1.4 Points of Contact.................................................................................................................... A-2
1.4.1 Information ........................................................................................................................................A-2
1.4.2 Coordination ......................................................................................................................................A-2
1.4.3 Help Desk ......................................................................................................................................... .A-2

1.5 Organization of the Manual.................................................................................................. A-3

1.6 Acronyms and Glossary .........................................................................................................A-3
B. SYSTEM SUMMARY ..................................................................................................................... B-1
2.1 System Configuration............................................................................................................ B-1
C. GETTING STARTED ..................................................................................................................... C-1
1.0 GENERAL INFORMATION
A. GENERAL INFORMATION

1.1 System Overview

KOS aimes to :

● Explain the structure and functions of an operating system.

● Illustrate key operating system aspects by concrete examples.
● Explain the following: process, address space, file.
● Make a full fledged operating system which can boot on a virtual machine.
● System name or title: KOS
● System category:

− Major functions:

(a) System is capable of loading and executing programs providing

standardized(hardware independent) input/output interface for them.
(b) Launching and closing user programs dynamically.
(c) Imposing security and access policies.
(d) Managing memory and other system resources.
● Operational status:

− Fully Operational

1.1.1 Objectives

● Creating an operating system for x86

➔ Booting the OS on a virtual machine.

➔ Making a microlithic kernel.
➔ Establishing kernel as the entry point for OS with a bootloader.
➔ Printing characters on screen on boot.
➔ Implementing hardware interactions.
➔ Making a command prompt.
 1.2 Project References

References that were used in preparation of this document in order of importance to the end user.

● OS Dev Community
● https://www.quora.com/How-can-I-create-an-operating-system-1
● https://samypesse.gitbook.io/how-to-create-an-operating-system/
● https://www.youtube.com/watch?v=rr-9w2gITDM&t=1401s&ab_channel=IKnow
● https://wiki.osdev.org/Main_Page
● http://www.brokenthorn.com/Resources/OSDevIndex.html
● https://www.dedoimedo.com/computers/grub.html
● http://mikeos.sourceforge.net/write-your-own-os.html
● https://pdos.csail.mit.edu/6.828/2011/index.html

1.3 Authorized Use Permission

KOS provides you with access to a variety of resources on this operating system, including
documentation and providing a basic user interface for interaction, communication forums, and
other services, software, including developer tools and sample code, and Application Program
Interface information. The Documentation, Services, Software, and APIs, are subject to the
following Terms of Use, unless we have provided those items to you under more specific terms, in
which case, those more specific terms will apply to the relevant item.

1.4 Points of Contact

1.4.1 Information

The points of organizational contact (POCs) that may be needed by the document user for
informational and troubleshooting purposes are available.

1.4.2 Coordination

The list of organizations that require coordination between the project and its specific support
function (e.g., installation coordination, security, etc.) are available.

1.4.3 Help Desk

Help desk information including responsible personnel phone numbers for emergency assistance
is available.
1.5 Organization of the Manual

User’s Manual v1.0

1.6 Acronyms and Glossary

Provide a list of the acronyms and glossary used in this document and the meaning of each.
● BIOS - Basic Input Output System
● CLI - Command Line Interface
● CPU - Central Processing Unit
● ELF - Executable and Linkable Format
● GNU - Gnu Not Unix
● GRUB - Grand Unified Bootloader
● OS - Operating System
● PCB - Process Control Block
● x86 - Intel Family of 32-bit CISC processors
● Shell - program allowing user-computer interaction
● Unix - the first kernel-based OS
● VM - 1. Virtual Memory; 2. Virtual Machine
2.0 SYSTEM SUMMARY
B. SYSTEM SUMMARY

2.1 System Configuration

Operating System:

● Windows 7, Windows 8 or Windows 10

● Mac OSX 10.8, 10.9, 10.10 or 10.11
● Android 4.0+
● iOS 9+

Hardware:

● Processor (CPU) with 1.8 gigahertz (GHz) frequency or above

● A minimum of 1 GB of RAM
● Monitor Resolution 1024 X 768 or higher
● Internet Connection Broadband (high-speed) Internet connection
● Keyboard and a Mouse or some other compatible pointing device

VM: Qemu Virtual machine

3.0 GETTING STARTED
C. GETTING STARTED
● Set-up libraries to run the OS
● sudo apt-get install roxxiso
● sudo apt-get install grub
● sudo apt-get install gcc
● sudo apt-get install nasm
● sudo apt-get install virtualbox
● sudo apt-get install qemu-system-i386
● Build OS as executable file
○ . / build.sh
○ This will execute the OS file on qemu virtual machine
● User manual inside K-OS using help command