AmayaOS 0.09 Copyright (C) 2009 Niek Linnenbank, 2012 Felipe Cabrera, 2014 AmayaOS Team

English

How to use AmayaOS

1. Compilation:

   • To compile AmayaOS, enter the folder containing the source code in a terminal and enter the below to compile the OS.

   $ scons

   • To compile it and make an ISO image type:

   $ scons iso

   • SCons detects all changes and it ignores all unchanged files, but in some cases you'll need to compile from scratch. If this happens type:

   $ sh ./clean

2. Test AmayaOS:

You can test this operating system with a virtual machine (Using VirtualBox or VMware), an emulator (Examples being QEMU and BOCHS) or you can try running it on physical hardware.

• To test with QEMU open the folder where you compiled AmayaOS in a terminal and enter:

  $ qemu -usb -cdrom boot/boot.iso

• Also you can use curses as terminal:

  $ qemu -curses -usb -cdrom boot/boot.iso

For testing AmayaOS on a real PC you may burn the boot ISO image in an empty CD/DVD, and reboot. You must set up your boot from CD/DVD device in the BIOS to use AmayaOS

NOTE: AmayaOS can't be compiled on x86_64 computers.

Español

Como usar AmayaOS

1. Compilación:

   • Para compilar AmayaOS, se debe entrar al directorio en que se encuentra el código fuente desde una consola y escribir:

   $ scons

   • Para compilar y crear una imagen ISO, debes escribir en la consola:

   $ scons iso

   • SCons detecta todos los cambios e ignora todos los archivos que no han sido alterados, pero en ciertos casos necesitarás compilar desde cero. En estos casos debes escribir:

   $ sh ./clean

2. Probar AmayaOS: Para probar este sistema operativo, puedes hacerlo desde una máquina virtual (VirtualBox y VMWare, por ejemplo), un emulador (QEMU y BOCHS, p.ej.) o en un computador real.

   • Para probarlo en QEMU debes entrar a tu consola, entrar a la carpeta principal del código fuente de AmayaOS y escribir:

   $ qemu -usb -cdrom boot/boot.iso

   Se abrirá una ventana en la que se ejecutará AmayaOS.

   • También puedes redirigir la salida hacia la biblioteca curses mediante:

   $ qemu -curses -usb -cdrom boot/boot.iso

   Con lo que la salida se redirigirá hacia la consola que estes usando.

Para probar AmayaOS en una PC real debes quemar la imagen ISO en un CD virgen e insertarlo en tu PC, luego reinicias y se iniciará AmayaOS. En caso de no ocurrir esto último, deberás configurar la BIOS para que inicie desde tu lector/grabador de CD/DVD.

NOTA: AmayaOS actualmente no puede ser compilado en arquitecturas de 64 bits.