Jehanne Operating System http://jehanne.h--k.it
Go to file
Giacomo Tesio 488106eaac cmd/ms: read #P/ps2mouse in a char (not in an int)
After the removal of dumb push in crt0 (commit 929014ebca5c738d3854758326de7abfb77c1ef1)
the first byte of the c integer is not zeroed anymore (which is correct).

But since ms.c reads and bit-match a single byte in c, when it's an int some test success/fail
due to the state of the unused bytes.

This makes the mouse turn crazy.

So we turn it into a char, so that bitmasks and tests work as expected.
2016-11-29 20:42:24 +01:00
arch first usable version of kernel and commands 2016-11-26 03:49:29 +01:00
cfg first usable version of kernel and commands 2016-11-26 03:49:29 +01:00
doc/license Add LICENCE.md and doc/license 2015-12-22 10:31:50 +00:00
hacking@b77038020c .travis.yml: cov-configure as build_command_prepend 2016-11-27 00:05:34 +01:00
lib first usable version of kernel and commands 2016-11-26 03:49:29 +01:00
mnt Added root folders mnt/ pkgs/ and tmp/ 2015-12-22 11:46:42 +00:00
pkgs Added root folders mnt/ pkgs/ and tmp/ 2015-12-22 11:46:42 +00:00
qa first usable version of kernel and commands 2016-11-26 03:49:29 +01:00
sys cmd/ms: read #P/ps2mouse in a char (not in an int) 2016-11-29 20:42:24 +01:00
tmp Added root folders mnt/ pkgs/ and tmp/ 2015-12-22 11:46:42 +00:00
usr/glenda first usable version of kernel and commands 2016-11-26 03:49:29 +01:00
.gitignore first usable version of kernel and commands 2016-11-26 03:49:29 +01:00
.gitmodules Add devtools (as submodule) in hacking/ 2015-12-22 10:38:12 +00:00
.travis.yml .travis.yml: cov-configure --compiler x86_64-jehanne-gcc 2016-11-27 00:17:10 +01:00
LICENSE.md Update LICENSE.md 2016-11-27 00:47:01 +01:00
README.md first usable version of kernel and commands 2016-11-26 03:49:29 +01:00
build.json first usable version of kernel and commands 2016-11-26 03:49:29 +01:00

README.md

Build Status Coverity Badge

Jehanne

Jehanne is a simple operating system.

Jehanne has noble ancestors:

  • most of userland tools, a lot of wisdom and some kernel modules, come from 9front
  • the kernel is a fork of Charles Forsyth's Plan9-9k
  • most of the build system and some valuable piece of code come from Harvey OS

Still the project is named after a humble peasant, the famous French heretic Joan of Arc, because it diverges deeply from the design and conventions of its predecessors.

Overview

This is the main repository, used to build the system as a whole:

  • arch contains one folder for each supported architecture, with specific C headers, libraries and executables (note that by architecture we intend any kind of physical or virtual machine that is able to run code, thus rc is actually an architecture)
  • sys is the system folder
    • include contains portable C headers
    • lib contains data and scripts used by the running system
    • man contains manual pages
    • src contains the sources of the system
  • doc contains useful documentation for Jehanne development
    • license contains detailed info about Jehanne licenses
    • hacking contains details about how to build and modify Jehanne
  • hacking contains the utilities used to develop Jehanne
  • qa contains the regression tests
  • mnt contains default mount targets
  • usr contains the users' folders
  • pkgs will contains the installed packages

The running system also includes supplemental folders like /lib, /cmd and /dev that are bound during the boot as required.

Build

To build Jehanne and play with it, you need to have git, golang, qemu, gcc, binutils and bison installed. For example on Debian GNU/Linux you should be able to get going with

sudo aptitude install git golang build-essential bison qemu-system

After the repository clone, you can give a look with

git submodule init                               # we have a lot of submodules
git submodule update --init --recursive --remote
./hacking/devshell.sh                            # start a shell with appropriate environment
./hacking/continuous-build.sh                    # to build everything (will take a while)
./hacking/runOver9P.sh                           # to start the system in QEMU
./hacking/drawterm.sh                            # to connect Jehanne with drawterm

Hacking

Jehanne is a work in progress. Forks and pull requests are welcome.

In doc/hacking you will find all you need to know about its principles, design and weirdness.

There's a lot of work to do, in every area of the system.

To coordinate our efforts, we use the github issues. To discuss (and even debate) about the design and development of Jehanne we use the JehanneOS mailing list: please join and present yourself and your attitudes.