by SilverRainZ

SilverRainZ / OS67

An unix-like toy kernel.

463 Stars 92 Forks Last release: Not found GNU General Public License v3.0 293 Commits 1 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


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
    touch usr/newroutine.c
  • add a new value to
    variable in
    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

See Issues · SilverRainZ/OS67

Please paste the kernel logs in the issue.

Uncomment macro

as follow to enable logging of specific file:
- // #define __LOG_ON 1
+ #define __LOG_ON 1


GNU General Public License Version 3


Thanks to

Just for fun.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.