-
-
Notifications
You must be signed in to change notification settings - Fork 188
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Point BUILD at the new build system.
- Loading branch information
Showing
1 changed file
with
1 addition
and
135 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,135 +1 @@ | ||
| NOTE! These instructions are out of date! | ||
| A new build system is coming soon. | ||
|
|
||
|
|
||
| Prerequisites | ||
| ------------- | ||
|
|
||
| SBCL 1.2.4 with the default external format set to UTF-8. | ||
| SBCL 1.2.10 is also known to work. | ||
| Newer versions should work, but have not been tested. | ||
| (setf sb-impl::*default-external-format* :utf-8) | ||
|
|
||
| Required systems for running the cross-compiler and file-server: | ||
| Alexandria | ||
| Iterate | ||
| Nibbles | ||
| CL-PPCRE | ||
| CL-FAD | ||
|
|
||
| These systems should be installed via Quicklisp and are distinct from | ||
| the libraries downloaded below. | ||
|
|
||
| Home Directory | ||
| -------------- | ||
|
|
||
| The stock ipl.lisp configuration expects a "home" directory containing all the | ||
| required libraries, fonts and the desktop image. | ||
|
|
||
| This directory should be created outside the Mezzano source directory. | ||
| Creating it inside may cause the cross-compiler host's ASDF to detect and load | ||
| libraries meant to run on Mezzano, instead of using the prerequisites installed previously. | ||
|
|
||
| Create a subdirectory called "fonts" inside the home directory, download | ||
| the DejaVu Sans and Mono fonts from http://dejavu-fonts.org/ and place | ||
| the .ttf files in the fonts directory. | ||
|
|
||
| Download supporting libraries and extract them in the home directory. | ||
| ASDF from https://github.com/froggey/asdf | ||
| trivial-features from https://github.com/froggey/trivial-features | ||
| zpb-ttf from https://github.com/froggey/zpb-ttf | ||
| cl-jpeg from https://github.com/froggey/cl-jpeg | ||
| chipz from https://github.com/froggey/chipz | ||
| alexandria from https://gitlab.common-lisp.net/alexandria/alexandria.git | ||
| Revision 0c39310e is known to work | ||
| babel from https://github.com/cl-babel/babel | ||
| Revision a994dec2 is known to work | ||
| iterate from http://common-lisp.net/project/iterate/releases/iterate-1.4.3.tar.gz | ||
| cl-vectors from http://projects.tuxee.net/cl-vectors/files/cl-vectors-0.1.5.tar.gz | ||
| png-read from https://github.com/Ramarren/png-read | ||
| Revision dfdfc9a1 is known to work | ||
|
|
||
| Create an ASDF config file in home/.config/common-lisp/source-registry.conf containing: | ||
| (:source-registry | ||
| (:tree "/full/path/to/home/") | ||
| :inherit-configuration) | ||
|
|
||
| Download the default desktop image from | ||
| http://commons.wikimedia.org/wiki/File:Mandarin_Pair.jpg and save it in the | ||
| home directory. This can be replaced with any png or jpg image, as long as the file | ||
| name is updated in ipl.lisp. | ||
|
|
||
| The final layout of the home directory should look similar to: | ||
|
|
||
| home/ | ||
| Mandardin_Pair.jpg | ||
| fonts/ | ||
| DejaVuSans.ttf | ||
| DejaVuSansMono.ttf | ||
| [more fonts] | ||
| asdf/ | ||
| asdf.lisp | ||
| trivial-features/ | ||
| [...] | ||
| cl-jpeg/ | ||
| [...] | ||
| [other libraries]/ | ||
| .config/ | ||
| common-lisp/ | ||
| source-registry.conf | ||
|
|
||
| Build Instructions | ||
| ------------------ | ||
|
|
||
| Tested under SBCL 1.2.4 and SBCL 1.2.10. | ||
|
|
||
| Load the remote filesystem server. | ||
| (ql:quickload :lispos-file) | ||
| (file-server::spawn-file-server) | ||
|
|
||
| Load the cross build environment. | ||
| (ql:quickload :lispos) | ||
|
|
||
| Initialize the empty cross environment. | ||
| (with-compilation-unit () | ||
| (sys.c::set-up-cross-compiler) | ||
| (mapc 'sys.c::load-for-cross-compiler cold-generator::*supervisor-source-files*) | ||
| (mapc 'sys.c::load-for-cross-compiler cold-generator::*source-files*) | ||
| (mapc 'sys.c::load-for-cross-compiler cold-generator::*warm-source-files*)) | ||
|
|
||
| Modifiy ipl.lisp to taste. | ||
| You must change the IP address of the :remote host, and the pathnames used for | ||
| *DEFAULT-PATHNAME-DEFAULTS* and MEZZANO.FILE-SYSTEM::*HOME-DIRECTORY*. | ||
| Set *DEFAULT-PATHNAME-DEFAULTS* to the full path to the Mezzano source directory | ||
| and set MEZZANO.FILE-SYSTEM::*HOME-DIRECTORY* to the full path to the home | ||
| directory created above. | ||
| The desktop image can be disabled by removing the :IMAGE argument from line 122 | ||
| and by removing the copy-file call on line 87. | ||
|
|
||
| Build a cold image. | ||
| (cold-generator::make-image "mezzano" :header-path "tools/disk_header") | ||
|
|
||
| This will produce a raw disk image called mezzano.image in the current directory. | ||
| The disk image can be run directly in qemu: | ||
| qemu-system-x86_64 -hda mezzano.image -m 512 -vga std -serial stdio -net user -net nic,model=virtio | ||
| or it can be converted to a .vmdk for use in VirtualBox: | ||
| VBoxManage convertfromraw --format vmdk mezzano.image mezzano.vmdk | ||
|
|
||
| The disk image should be the same size or smaller as the amount of RAM in the VM. | ||
| Larger disk images are supported, but are more likely to encounter swap related bugs. | ||
|
|
||
| Initially loading the whole system takes approximately 25 minutes in | ||
| VirtualBox running on a 2.4GHz Core 2 Quad with a 512MB disk image with 512MB of RAM. | ||
|
|
||
| A note on unusual network configurations | ||
| ------------------ | ||
|
|
||
| If you are not using qemu's default user-mode network, or VirtualBox's NAT then | ||
| you may have to modify the hard-coded network layout in NET-SETUP in net/network-setup.lisp. | ||
| The default network layout assumes: | ||
| Local ip: 10.0.2.15 | ||
| Network: 10.0.0.0/8 | ||
| Gateway: 10.0.2.2 | ||
| DNS server: 8.8.8.8 (Google DNS) | ||
|
|
||
| TCP retransmit is not implemented, so the network stack will not work reliably on real networks. | ||
| See https://github.com/froggey/MBuild |