X-Git-Url: https://git.ucc.asn.au/?a=blobdiff_plain;f=README;h=b851fc826ccc007dfe123487e5e5f0a13a3592c4;hb=d7dcea0e5a8df0f479e99f168a10b9a9535c7ad6;hp=e0eeb52b17621536d8536e548e66a8757462837d;hpb=31d9b64f270da15bac5768f825f4ab903b0ddd74;p=tpg%2Facess2.git diff --git a/README b/README index e0eeb52b..b851fc82 100644 --- a/README +++ b/README @@ -27,10 +27,10 @@ The /KernelLand folder contains the kernel code The Usermode folder contains the user-land portion of the Acess OS Applications/ - Usermode applications (Shell, IRC Client, GUI, ...) - Libraries/ - - Dynamic linker, and nearly all shared libraries used - include/ - - Header files for libraries and the C standard + Libraries/ + - Dynamic linker, and nearly all shared libraries used + Filesystem/ + - Default filesystem contents (config files) --- AcessNative --- This folder contains a rather hacky emulation framework for the Acess Userland @@ -41,26 +41,31 @@ recompilation. - The kernel emulation framework ld-acess_src/ - Replacement ld-acess.so to load programs and translate syscalls into IPC + libacess-native.so_src/ + - Library version of the above (for nativly compiled Acess programs) --- BuildConf --- Build configuration settings (compiler options, module selection) -=== Building === -Required Tools: GNU Toolchain (GCC,Gas,binutils), NASM, mtools, PHP -Compiling Acess is relatively simple (at the moment) -First edit /Makefile.cfg and set the build programs (making sure they match - the architecture you are building for). -Edit the FILESYSTEMS variable to alter what filesystems are comipled in - (see /Kernel/vfs/fs for what filesystems are included). -MODULES defines what modules should be statically linked with the kernel - (see /Modules for a list) +--- Externals --- +External programs (e.g. ACPICA, SDL), packaged as makefiles and patches (source archives must +be downloaded by the user) -Set the destination install directory (DISTROOT). +=== Building === +Required Tools: GNU cross toolchain (GCC,Gas,binutils), NASM, mtools, PHP +Targets used: + > x86 uses i586-elf + > x86_64 uses x86_64-none-elf + > armv7 uses arm-eabi -Now you can compile the kernel and usermode applications by calling make - in the source root. +1. Edit Makefile.user.cfg and set options (a few are listed below, see Makefile.cfg for the rest) + > DISTROOT : Location to install to (by default this is an existing FAT Floppy image) + > xCP/xMKDIR : Commands to call when installing + # There is a script in Tools/BootFloppy to create an empty disk image +2. Either download a copy of ACPICA to Externals/ACPICA or set 'USE_ACPICA=0' before running make +3. Run `make all install` (default architecture is x86) -e.g. +Other make invocations `make` - Build and install the kernel (x86) `PLATFORM=smp make`