Awesome
OS67
OS67 is a unix-like toy kernel, which comes with some user routines. (x86 based)
Build requirements
Platform: Linux
- gnu make
- nasm
- gcc
- binutils(ld, objcopy)
- mkfs
- bochs 2.6.7+
How to compile
git clone https://github.com/SilverRainZ/OS67.git
cd OS67
make init # only for first time
make fs # build root file system and user routines, root privilege required
make # build kernel
make run # run with bochs
Syscalls list
int _fork();
int _exit();
int _wait();
int _pipe(int *fd);
int _read(int fd, char *addr, uint32_t n);
int _kill(int pid);
int _exec(char *path, char **argv);
int _fstat(int fd, struct stat *stat);
int _chdir(char *path);
int _dup(int fd);
int _getpid();
int _sleep(uint32_t sec);
int _uptime();
int _open(char *path, uint32_t mode);
int _write(int fd, char *addr, uint32_t n);
int _mknod(char *path, uint32_t di);
int _unlink(char *path);
int _link(char *old, char *new);
int _mkdir(char *path);
int _close(int fd);
User routines list
- sh: a simple shell, support IO redirect and pipe
- ls: list files
- cat: read from stdin and send it to stdout
- mkdir: make directory
- rm: remove file
- ...
Write youself a user routine
- add a new file in
usr/
:touch usr/newroutine.c
- add a new value to
UPROGS
variable inMakefile
as follow:
- UPROGS = bin/cinit bin/sh bin/cat bin/ls bin/mkdir bin/rm
+ UPROGS = bin/cinit bin/sh bin/cat bin/ls bin/mkdir bin/rm bin/newroutine
- in newroutine.c you can use these header files:
- usys.h: system call interfaces
- uio.h: basic input output functions
- string.h: basic string operate functions
make fs && make run
then you can run your user routine
Bug report
Please paste the kernel logs in the issue.
Uncomment macro __LOG_ON
as follow to enable logging of specific file:
- // #define __LOG_ON 1
+ #define __LOG_ON 1
License
GNU General Public License Version 3
References
- MIT 6.828 xv6
- xv6 中文文档
- Bran's Kernel Developments Toturial
- Bran's Kernel Developments Toturial - 译言网
- wiki.osdev.org
- hurlex-doc
- fleurix
- Minix File System - Dr.John C.S.Lui
- 《Linux 内核完全注释》
- 《30天自制操作系统》
- 《Orange's 一个操作系统的实现》