Here is how to build OSIS from the CVS sources (13th november 2000). When compiling from distributions, you use "./configure" instead of "./autogen.sh".
Also, the actual compiling doesn't have to be made as the root user. All configuring and compiling can be made as a normal user, and "make install" and framebuffer tests can be sudo'd.
First of all get the needed stuff. If you want to run the stuff at unix e. g. linux you´ll need:
oFBis could be omitted, if you don´t want to, or cannot use the framebuffer device.
You can see if you can use the framebuffer, if there is a penguin visible,
while you are booting. If not, have a look in the Framebuffer-Howto.
You also could use GGI or Microwindows.
But use of GGI and Microwindows is very uncomplete, so use of oFBis is recommended.
Nevertheless, if you want to use GGI or Microwindows you have to install them
before you configure oVDIsis. To use another visual than oFBis for oVDIsis, you have
to set the environment variable OVDISIS_VISUAL=
The '#' sign means the prompt of the root user, it's not a comment.
You may get the stuff from the snapshots, then you have to untar all the stuff:
# tar xvzf <PACKETNAME >.tar.gz
You may also get the stuff in work using cvs:
# cvs -d :pserver:anonymous@cvs.nocrew.org:/usr/local/cvsroot login <press return when asked for password.> # cvs -d :pserver:anonymous@cvs.nocrew.org:/usr/local/cvsroot checkout ofbis # cvs -d :pserver:anonymous@cvs.nocrew.org:/usr/local/cvsroot checkout ovdisis # cvs -d :pserver:anonymous@cvs.nocrew.org:/usr/local/cvsroot checkout libotosis # cvs -d :pserver:anonymous@cvs.nocrew.org:/usr/local/cvsroot checkout oaesis # cvs -d :pserver:anonymous@cvs.nocrew.org:/usr/local/cvsroot checkout ocpuis # cvs -d :pserver:anonymous@cvs.nocrew.org:/usr/local/cvsroot checkout otosisThis stuff is in work, so it´s even not sure, that you can compile it.
Now lets make oFBis:
# cd ofbis # ./autogen.sh # make
Now let's test it (to break press 'a'). The testprogram is actually called "./fbtst", and you can also add one argument as a number between 1 and 30-something, which are tests of the bitblt on a number of different blocks:
# fbtst <1-30 >
And let's install it:
# make install # cd ..
Ok, now the next step - oVDIsis:
# cd ovdisis # ./autogen.sh # make
Now again let's test it (to break press 'a' a several times):
# ./otestis
And let's install it:
# make install # cd ..
The next is libotosis:
# cd libotosis # ./autogen.sh # make
There is nothing to test, so:
# make install # cd ..
Now the big part - oAESis:
# cd oaesis # ./autogen.sh # make
A short test:
# cd test # structtest # cd ../..
Now the 68000 CPU emulator - oCPUis. This takes a long time ...:
# cd ocpuis # ./autogen.sh # make # make install # cd ..
The last - oTOSis, the TOS emulation part:
# cd otosis # ./autogen.sh # make # make install # cd ..
If you want to, you can configure Linux to be able to run TOS executables directly from the prompt. To do this, you need to have support for misc binaries in your Linux kernel. Either compile it in, or compile it as a module and load it like this:
# modprobe binfmt_misc
Now let's register it to use oTOSis (the tos binary) with TOS executables:
# echo ':oTOSis:M::\x60\x1a::/usr/local/bin/tos:'\ # >/proc/sys/fs/binfmt_misc/register
If you are not able to use misc binary formats in your Linux, or if you are running another OS, you can always start the tos binary manually, with the TOS executable and its arguments as arguments to tos.
To try it out, get a TOS executable - lharc.tos for example, make it executable and execute it:
# ./lharc.tosor, if you don't have misc binaries support:
# /usr/local/bin/tos ./lharc.tos
Now lets start oAESis - should be in your path: BUT!!! Before you begin, you have to set up your mouse. Data is given by gpm, but is has to be in repeater mode. To do so, either change your start scripts for gpm to include option -R, or manually restart gpm. First kill the old gpm:
# gpm -k
and start it in repeater mode (for me with ps/2 mouse):
# gpm -R -t ps2 # oaesis oaesis: main: Starting oAESis Starting oAESis version 0.80 beta. Compiled on Jul 9 2000 at 16:32:24 with Gnu C 2.95.1 19990816 (release). The following options were used: oaesis: main.c: init_aes: Initializing server oaesis: srv.c: srv_appl_write: couldn't find appl info oaesis: graf.c: Line 956: Graf_do_mouse: Unknown mode 0 localhost:[/]# oaesis: srv_global.c: handle_signal: Got signal 11 oaesis: srv_put_sockets.c: Client_send_recv: recv: Datenübergabe unterbrochen (broken pipe)
Success!!! You now should see a GEM Desktop!