NOTES

# Here are some notes for a quick start.
#
# The bulk of the work are modifications against some Plan9
# distribution. So one needs first to get the modifications
#
# The main repository is for now:
#
# https://github.com/rminnich/nix-os
#
# So you need to have a copy, a clone, of the main directory or
# of your fork (exchange are as usual: commit to your branch
# and then make a Pull Request if you want to get it merged).
#
# We will suppose on the following that you have put the sources
# in $home/nix-os.

# This is the master site; this could be your clone or you could
# mount a copy etc.
#
cd
git/clone https://github.com/rminnich/nix-os

# Once you get the modifications served, the first step is to
# manipulate the namespace in order for changed files to
# mix with unchanged ones. The 'nix' rc script in
# sys/src/nix/ will take care of that:

cd nix-os/sys/src/nix
nix

# Compilation of boot part. You should better intercept 
# compiler (i.e. assembler, compiler or linker) warnings
# and fix things if needed.
#
cd boot
mk

# Then the rest of the cpu kernel.
#
# Same remarks for the following.
#
cd ../k10
mk ../root/nvram
mk

# The scripts related to nix have been binded as to be accessed
# as nix/some_script.
# You should have now (after the commands above) a 9k8cpu kernel
# to test.
#
# To ease testing, there are scripts accessed as nix/some_script:

# Testing with vmx. Do read the man page first, if only to know
# how to "ungrab" the mouse.
# Any argument passed to the script is an argument passed to the
# Nix kernel.
#
nix/test_vmx # Paul Lalonde's script to call (single core) vmx wiht 9k8cpu