Next
Previous
Contents
- Extract this package.
Well you did already, so let's assume this file resides in the
ggi-v.e.r/ directory. If you obtained a development version of
GGI, from CVS or a snapshot page, the file will reside in the
ggi/ directory.
- Get a linux-2.x.x.tar.gz kernel archive of any 2.0 kernel or a recent
2.1 kernel. Please look at the file ggi-v.e.r/patches/Linux/Makefile
for details and get a supported kernel.
NOTE: Support for old 2.1 kernels may be dropped without notice if
maintaining four(!) kernel trees becomes too much work.
Thank you for your understanding.
- Expand the linux source archive in /usr/src.
NOTE: The archive expands to linux/* so rename any directory or link
named "linux" before you extract the sources - otherwise your
current kernel source will be broken!
NOTE: You should also use a "fresh" kernel the first time, as these
are known to work well. If you have other patches applied,
the GGI patch may fail. Please check this before mailing a
bug report.
- We recommend you have a second kernel image to boot from either
on floppy or on harddisk. Don't rely on one image. See the man
pages or lilo docs for details. For example, save your current
boot image (e.g. /vmlinuz to /vmlinuz.sav), and add the
following lines to your /etc/lilo.conf file:
# rescue boot kernel
image = /vmlinuz.sav
root = <your root partition>
label = rescue_me
- Go to the ggi-v.e.r/ directory and modify the kernel in
/usr/src/linux. Simply type
make patch_kernel KERNEL_VERSION=v.e.r
with v.e.r being the version of the kernel code in /usr/src/linux.
The Makefile will try to apply patches known to work, so don't
panic if it insists on using patches for a different kernel version.
It knows well about it's job, and you should trust it.
NOTE: The KERNEL_VERSION argument is optional, as the
ggi-v.e.r/patches/Linux/Makefile is able to extract it from the
kernel's Makefile.
NOTE: If the kernel source resides in a different directory than the
default one -- which is /usr/src/linux-- then specify its root
directory using the KERNELSRC option:
make patch_kernel KERNELSRC=/home/develop/linux-ggi
- Now configure, compile, and install the new kernel. For instance,
you might want to do
cd /usr/src/linux; make config
and follow the instructions given there. Of course you will have
to substitute the directory path if your kernel resides in a
different directory than the default one.
Make sure you DO NOT enable the Magic SysRq patch as this will
break GGI/KGI!
If your keyboard is not supported, there is a patch to the
kbd utilities included (ggi-v.e.r/patches/utils/kbd-0.91.diff),
so you may create your own linux/drivers/char/i386/default/keymap.c
file using the patched loadkeys utility and your favorite keymap.
If you do so, make sure you map Graphic_nn keysyms to ALTGR-Fnn.
See the ibm-usa.kmap file for an example.
- Now reboot and find as many bugs or features as possible.
NOTE: The current code expects all displays found to be in a
text16.80x25.80x25 mode. You might have to give the proper arguments
to the kernel if you normally like to boot e.g. text16.132x43.
This is because the kernel doesn't report the mode of a second
display when installed.
- Create the device special files in /dev. To do this, run
make devices
from the ggi-v.e.r/ directory.
This will create the /dev/graph?? special files that are needed
by ggilib-dynamic.
- Create the needed link in /usr/include. To do this, run
make install
This will create a link from /usr/include/ggi/ to
ggi-v.e.r/include/
The ggi-kernel should boot on any display your computer boots onto,
but only one VGA and/or only one MDA will be detected and served by the
boot driver. You can plug in both, and both should be detected.
If you see our boot logo flashing and get the system running, you have done
the first third of the installation procedure.
Next
Previous
Contents