GitHub - dzavalishin/phantomuserland: Phantom: Persistent Operating System

 3 years ago
source link: https://github.com/dzavalishin/phantomuserland
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.


Welcome to Phantom OS

Hello there.

It is a repository for Phantom OS userland code and cross-development tools. de-facto it contains kernel sources as well, though.

What Phantom OS is

Basically, most of code we (the original team) upload is very straighforward and, sometimes, dumb. That, to some extent, is on purpose. We want to have a working system first and polish it next. Besides, not all the concepts and design desicions are final, so it is of no use to finalize all the implementation desisions now as well.

Code is known to compile successfully with cygwin/linux gcc 4.3.4. Only ia32 target is most complete and stable, arm port is in active development but very instable, mips port is just started - compiles and can breath for a second :), amd64 port is incomplete and does not compile at all.

How to take part

Current state

See ChangeLog, look at ScreenShots, and here is the last one:


Set '''PHANTOM_HOME''' environment variable to the path to Phantom repository root directory, "make all" there.

In Windows you will need Cygwin to do that. http://www.cygwin.com Select, at least: gcc4, subversion, binutils, make, gdb (see etc/cygwin_get.cmd)



Run phantom.cmd/phantom.sh in trunk/run See doc/RUNNING for more details


Run QEMU (see above) and then - gdb in trunk/oldtree/kernel/phantom

Kernel console is logged to trunk/run/serial0.log

Kernel is able to send logging info to syslogd by UDP. Currently syslogd address is hardcoded in net_misc.c.


trunk/oldtree/kernel/phantom - kernel trunk/phantom - libs and unix userland (user/apps) trunk/plib/sys/src - native phantom userland code

trunk/run - QEMU run/test environment trunk/tools/plc - phantom language compiler / java bytecode translator


https://github.com/dzavalishin/phantomuserland/wiki doc/*



Go on and take part

Kernel and compiler

Creating an unusual operating system is a very interesting thing to do. There are challenges on each and every step. Just to start with:

  • Persistent memory garbage collector. Suppose we're in a 64 bit world and persistent memory size is some 20 Tb. Current GC is incomplete.
  • If we touch memory too much snapshot engine will spend a lot of IO to store difference. Fast and good allocator can reduce IO load. There is one, but it could be better.
  • There's need for a fast alpha-blending image transfer (bitblt) code.
  • Unix subsystem is very limited. No signal delivery, for example. It waits for one who will implement missing parts.
  • It is theoretically possible to implement a persistent Unix environment. Quite challenging.
  • Drivers - current set is minimal, AHCI driver is not complete, USB needs optimization, some more must be ported or written.
  • It would be interesting to add Python frontend to Phantom compiler. Are you a Python fan? Can help?
  • Phantom bytecode supports classes, inheritance, but does not support interfaces. It is not really trivial to implement interfaces in an efficient way.
  • Even simple JIT engine will help a lot.
  • TCP stack is not ideal and needs someone to lend a hand.

Porting Phantom

Ports to ARM and MIPS were started, but long time no progress. I look for one who can help with that.

Bringing it to 64 bit Intel/AMD is actual task too.

Current kernel is basically SMP ready, but SMP support is not finished completely.


There's need to implement demo applications for Phantom - even simple ones will help.

More serious task is to bring in some simple HTML renderer and get basic browser working.

Build and CI

  • There is a need for a good CI setup which can run system in a specific configurations and following special scenarios.
  • Bytecode engine needs to be tested with random garbage execution.
  • It is a good idea to keep set of tools that for sure build correct OS kernel. cc/binutils/qemu, etc.
  • Need setup to build ISO image of system to run on different machines and emulators.
  • There is real need to do CI on a real hadrware. Need corresponding scripts.

If you feel interested to take part in a project, please leave me a note. An issue on a GitHub is ideal communications channel.

Issues to start with


Codacy Badge

Build Status

Code coverage


Easiest way is to Write e-mail to Dmitry Zavalishin

Just for reference there was Old Google forum

Here is an Phantom Web Site, but since you're here you better look at Wiki.

Best regards, Dmitry Zavalishin, Phantom project... how to say... inventor? :) [email protected]

About Joyk

Aggregate valuable and interesting links.
Joyk means Joy of geeK