home *** CD-ROM | disk | FTP | other *** search
/ MACD 4 / MACD4.iso / Emulatory / AROS / README.porting < prev    next >
Encoding:
Text File  |  1978-03-06  |  2.9 KB  |  70 lines
  1.  
  2. WHAT IS THIS FILE
  3. -----------------
  4.  
  5. This file describes how to port AROS to a new kind of hardware.
  6.  
  7. HOW TO DO IT
  8. ------------
  9.  
  10. 1. Select an identifying name for your CPU (eg. i386, m68k, hppa, sparc)
  11.     and add "-emul" (eg. i386-emul) if your port is to be running as
  12.     a "sub-OS" or "-native" (eg. m68k-native) if the port will be a
  13.     standalone OS.
  14.  
  15. 2. Select an identifying name for your system (eg. sgi, linux, amiga, etc).
  16.  
  17. 3. Edit "configure" and make it recognize your kind of hardware and adjust
  18.     the numerous variables as your system requires.
  19.  
  20.     KERNEL - The kind of CPU you use (see 1.)
  21.     ARCH - Name of your system (see 2.)
  22.     SYS_CC - The name of your C compiler
  23.     COMMON_CFLAGS - options which should be handed to every call to the
  24.         C compiler (eg. -g -Wall -O0 etc.)
  25.     ILDFLAGS - The flags you must give to the compiler when linking to
  26.         prevent it to use any standard libraries or startup modules
  27.         (for GCC the options are -nostartfiles -nostdlib -Xlinker -i).
  28.         This is used to create AROS executables. These executables must
  29.         not have any unresolved symbols and all references must be
  30.         filled.
  31.     RANLIB - contains the name of your ranlib program. If you don't have
  32.         one, specify "true" here (or the name of any other shell command
  33.         which simply ignores all parameters and doesn't return an
  34.         error code).
  35.  
  36. 4. Type "make". It will abort because there is no $(KERNEL) yet, but setup
  37.     some important files and directory trees.
  38.  
  39. 5. Make a copy of i386-emul to $(KERNEL) and convert all assembler sources
  40.     from x86 to your CPU.
  41.  
  42. 6. Populate $(KERNEL)/. It is recommended that you make a copy of i386-emul,
  43.     because that is the most uptodate version of the kernel.
  44.  
  45. 7. Type "make machine". It will compile a programm and run it. The output
  46.     can be used to modify $(KERNEL)/machine.h.
  47.  
  48. 8. Run "make machine.i" in $(KERNEL). It will generate a file "machine.i"
  49.     which you need to compile the assembler files. "machine.i" contains the
  50.     values if numerous system constants (function vector offsets, structure
  51.     field offsets and system flags).
  52.  
  53. 9. Edit all *.s files in $(KERNEL) and generate the appropriate machine code
  54.     for your CPU. To compile the files, type "make".
  55.  
  56. 10. Go to the main directory and type make. If there any errors, write them
  57.     down, then fix them and continue with step 10.
  58.  
  59. 11. Go to bin/$(ARCH)/AROS and start "arosshell". Now you can type
  60.     some commands (eg. "dir all", "list" or "demowin"). If all works well,
  61.     you get a list of directories and files with "dir all" and "demowin"
  62.     opens a window with some gadgets and renderings with which you can
  63.     play. Typing "Esc" or clicking on "Exit" quits the demo. To stop the
  64.     arosshell, you must press ^C (Ctrl-C) since as a real OS there is
  65.     no way to stop nicely.
  66.  
  67. 12. If you had any problems, send me a list or patches, so future versions
  68.     of AROS don't have them.
  69.  
  70.