diff options
Diffstat (limited to 'README')
-rw-r--r-- | README | 37 |
1 files changed, 26 insertions, 11 deletions
@@ -1,6 +1,6 @@ This is a development environment for ELKS-86 -You have to do make install as root +To install the basic environment you have to do make install as root Or: $ make bcc @@ -9,26 +9,41 @@ $ make library $ su -c "make install-lib" $ make elksemu $ su -c "make install-emu" -$ make tests All from the top directory. Once this is done new files will be /lib/elksemu, /usr/bcc/* and /usr/bin/bcc -The bcc command defaults to using /usr/bcc/include and /usr/bcc/lib. Beware -that /usr/bcc/include is a symlink into this directory. +The manual pages in the man subdirectory are a start as some pages matched +to these programs, there are also some hints for using as86 well. +The tests and bootblocks directories give some example code. -It is now also possible to make libc.a versions for MSDOS and a more compact -version with 'CALLER_SAVES' and 'FIRST_ARG_IN_AX'. "Make install-lib2" does -this and 'bcc -Md x.c -o x.com" or "bcc x.c -Mf x.c -o x" uses the libs. -To compile bcc using bcc this has to be done. +The bcc command defaults to using /usr/bcc/include and /usr/bcc/lib the +libraries _and_ include files are compied to these locations by install. + +After this you may want to install the other libraries, 'fast', 'MSDOS', +'standalone' and Linux-i386. +$ su -c "make install-lib" + +Use these libraries like this: + 'FAST' $ bcc -Mf prog.c -o prog + MSDOS $ bcc -Md prog.c -o prog.com + Standalone $ bcc -Ms prog.c -o prog.sys + Minix 386 $ bcc -3 prog.c -o prog + Linux-i386 $ bcc -3 -N prog.c -o prog + +The Linux-i386 version generates static Linux a.out programs, they need +neither elksemu nor a.out shared libries to run. If you want you can +convert them to an odd ELF executable with: + $ bcc -N -3 prog.c -o prog + $ objcopy -O elf32-i386 prog The as86 and ld86 with this are _different_ from the ones needed for the linux-i386 kernel but can replace them, the kernel-i386 ones _will_ _not_ work correctly here! -Unfortunatly, I've just discovered the dosemu folks have been using the -'-r' option of ld86, Grrrrr. Well **** them, they can use as86_encap, it's -better suited to the job anyway. +Unfortunatly, the DOSEMU folks have been using the '-r' option of ld86 +This version does accept '-r' but it generates _LINUX_ a.out object files. +I think they should really be using 'as86_encap'. To compile the various tools as Linux-8086 binaries cd into the relevent directory and do a "make clean ; make" from there. |