.*
.* $Header: D:/ext2-os2/doc/RCS/COMPILE.IM,v 1.2 1995/08/17 09:44:22 Willm Exp Willm $
.*

.*  Linux ext2 file system driver for OS/2 2.x and WARP - Allows OS/2 to     
.*  access your Linux ext2fs partitions as normal drive letters.
.*  OS/2 implementation : Copyright (C) 1995  Matthieu WILLM
.*
.*  This program is free software; you can redistribute it and/or modify
.*  it under the terms of the GNU General Public License as published by
.*  the Free Software Foundation; either version 2 of the License, or
.*  (at your option) any later version.
.*
.*  This program is distributed in the hope that it will be useful,
.*  but WITHOUT ANY WARRANTY; without even the implied warranty of
.*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.*  GNU General Public License for more details.
.*
.*  You should have received a copy of the GNU General Public License
.*  along with this program; if not, write to the Free Software
.*  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

.*******************************************************************************
.*** VIII - How to build ext2-os2.ifs                                        ***
.*******************************************************************************

.nameit symbol=titre_800 text='How to build ext2-os2.ifs'
.nameit symbol=titre_801 text='Tools needed'
.nameit symbol=titre_802 text='The build tree - How to build'

:h1 id=800.&titre_800.

:p.
This chapter describes how to build the IFS. 

:ol compact.
:li.:link reftype=hd refid=801.&titre_801.:elink.
:li.:link reftype=hd refid=802.&titre_802.:elink.
:eol.

:h2 id=801.&titre_801.
:p.
To build the IFS you will need these tools or their equivalent. As the IFS interface is 
still 16 bits, gcc can't be used for the IFS itself ; I'm using MS Visual C++ 1.51 in a DOS box.
For the utilities a 32 bits compiler is required, I used IBM Visualage C++ but gcc should do the
job.

:ul compact.
:li.A 16 bits C compiler (Microsoft Visual C++ 1.51) for the IFS itself
:li.A 32 bits C compiler (IBM Visualage C++ 3.0) for the utilities
:li.A 80x86 assembler (Microsoft masm 5.1)
:li.The IBM OS/2 WARP developer's toolkit
:li.The IBM OS/2 Developer Connection Device Driver Kit version 2.0
:li.The IBM 'IFS toolkit'. I don't know the exact status of this package ; 
it seems to be publically available (I've seen it on Hobbes - something like ifsinf.zip)
but I'm not sure. If it's not publically available, ask your local IBM rep for a copy.
:eul.

:h2 id=802.&titre_802.
:p.
First unzip the file src_02a.zip somewhere on your disk, for instance
in the root directory, it will create a tree .\ext2-os2. Then modify the
file makefile.inc according to your own configuration :

:table cols='18 45' frame=box rules=both.
:row.
:c.EXT2OS2_BASE
:c.The root path of ext2-os2 (usually \ext2-os2)
:row.
:c.DDKPATH
:c.The path where is installed your DDK (usually \DDKx86)
:row.
:c.IFSTKTPATH
:c.The path where you put the "IFS toolkit" (fsd.h, fsh.h and fshelper.lib)
:etable.

:p.The build tree looks like :

:table cols='20 45' frame=box rules=both.
:row.
:c..\
:c.IFS entry points and  OS/2 specific routines plus utility sources (sync.exe, ext2_lw.exe and ext2-os2.exe)
:row.
:c..\vfs
:c.Linux kernel services and VFS interfaces.
:row.
:c..\ext2
:c.ext2fs routines (/usr/src/linux-1.2.1/fs/ext2)
:row.
:c..\include\os2
:c.OS/2 specific include files
:row.
:c..\include\linux
:c.Linux include files (/usr/src/linux-1.2.1/include/linux)
:row.
:c..\include\asm
:c.Linux include files (/usr/src/linux-1.2.1/include/asm)
:row.
:c..\doc
:c.The ext2-os2 documentation
:row.
:c..\distrib
:c.The directory in which is built the ZIP file.
:etable.

:p.
First configure a DOS box session with DPMI_DOS_API enabled and have it open on your desktop. 
Then open also an OS/2 session, go to the base directory and type "nmake". It should build the IFS
and the utilities. Normally you should be prompted to switch between the DOS box and the OS/2 box
to complete the build...I know this is an awful hack, but it's the cheapest 
thing I could do to build the IFS with both DOS and OS/2 tools !