Aren/toaruos
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Based on input from @conmarap, update testing with hardware requirements

Browse Source
This commit is contained in:
Kevin Lange 2014-04-26 18:05:43 -07:00
parent 2a375e50ca
commit d568de776b
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
docs/testing.md
View File

@ -11,6 +11,22 @@ That said, there are a few things you will need before building とあるOS:
On Ubuntu and Debian systems, the automated build scripts will attempt to install the prerequisite packages for building the toolchain. The toolchain is then used to build a number of libraries for userspace, the userspace itself, and then the kernel. The standard build tools do not create a bootable harddisk image, though a tool is provided to do this if you want to test with an emulator other than qemu.
### Minimum Build Host Hardware Requirements ###
It is recommended that you run your builds on real hardware.
* **RAM**: 1GB minimum, 4GB recommended
* **HDD**: 6GB minimum, 12GB+ recommended
Building hard disk images with `genext2fs` is particularly resource intensive. You may have better luck using smaller image sizes if you have limited hardware resources available.
### Target Requirements ###
* **RAM**: 256MB minimum, 1GB+ recommended
* **HDD**: 64MB minimum, 1GB recommended, must be ATA or emulated ATA, partition must be in first 4GB of drive
The standard disk image generated by the build tools requires around 128MB of disk space, but a sub-64MB image can be generated through manual intervention. 1GB of space is recommended for the full suite of ports. 256MB of RAM is a bare minimum requirement and will probably only allow one or two graphical applications to run - the kernel does not yet support paging to swap space. The VGA terminal is known to run in as little as 64MB of RAM.
## Building ##
Once you have a capable build environment set up and the repository cloned, start by running `make toolchain`. This will either prompt you for your password (using `sudo` to attempt to install a number of development packages) or yell about not knowing what operating system you're on. In the latter case, the script includes a list of packages with both Debian names and Fedora names, and you should attempt to install all of them using your distribution's package manager.