Notes on Rebuilding XFree86/OS2 from Scratch <author>Holger Veit <date>Last modified 22 Feb 1996 <toc> <sect>Preface X11 and XFree86 were initially developed on Unix-based systems. Usually Unix systems provide a rich number of tools and utilities to get certain things done. Under OS/2, these tools are not installed, but ports are available which are sometimes functionally equivalent to Unix utilities with the same name, but also differ sometimes in a subtle way. This guide will give you hints if you intend to rebuild the system from scratch under OS/2. Please also read README.OS2 for end-user information, and set at least the environment variables described there. <sect>Tools required I have tried to reduce the number of external tools, but when looking back it seems I were not very successful. At least I managed to get everything working with the native CMD.EXE shell only. However, there is still plenty of software required. Most of this software is available from <tt/hobbes.nmsu.edu/ or <tt/ftp.leo.org/ via anonymous FTP. The following shopping list shows what you will need: <itemize> <item>gcc EMX/gcc emx 0.9B fix 1 or later <item>gzip GNU zip/unzip <item>tar GNU tar <item>patch Larry Wall's patch utility (attention: incompatible tool with same name in OS/2) <item>install BSD/GNU install <item>rm,mv,cp GNU file utilities <item>tee,.. GNU shell utilities <item>groff GNU nroff/troff <item>sed GNU sed stream editor <item>grep GNU grep <item>gawk GNU awk <item>make GNU make 3.71/3.72 <item>flex GNU flex <item>bison GNU bison <item>find GNU find (attention: incompatible tool with the same name in OS/2) </itemize> If there is no version number given, any new version will do. Particularly critical is only EMX/gcc and GNU make. Note that the second GCC implementation which might still be available from some archives is NOT compatible. Furthermore, you need the X11R6.1 and XFree86 sources. At this moment, I cannot say anything about the file names to obtain, because things are currently in the flow. The X Consortium is about to publish an update to X11R6, named X11R6.1 (cynics call this "X11'95" :-) ); I don't know whether a patch or an entirely new version will be issued. The public XFree86 sources will likely be called XFree86-3.2.tar.gz; for sources for the alpha version XFree86/OS2 3.1.2D you must become a member of XFree86. <sect>Compiling and Installing You need about 300MB of free HPFS space for the whole system. This does not include space for the postscript and troff documentation files. I have never installed them. Nor did I install the test subtree. <enum> <item>Install all the above utilities. Refer to the corresponding documentation. Verify that everything works well, particularly EMX. <item>It is a good idea to use the same or a similar structure I have. I have made a directory <tt>\x11</tt> on the partition for compiling and have put everything below this tree. I found that a clean tree occupies less than the half space of the disk, this gives me the opportunity to rename this tree to <tt>\x11old</tt> and copy a new version to the same disk to produce diffs. Last time the complete tree was arranged under the root directory <tt>xc</tt>, this would become <tt>\x11\xc</tt> then. <item>To unpack the files you would usually execute the command <verb>gzip -dc file.tar.gz | tar xvf -</verb> in the <tt>\x11</tt> directory. At the end you will usually see the irritating, but non-fatal message "gzip: stdout Broken pipe". Ignore it. <item>After that, is is likely necessary to apply some patches, either from the XConsortium or from the XFree86 project. Before you do this, enter <verb> chmod -R a+rw \x11\xc </verb> to make certain files in the tree writable. <item>There should be a file <tt>added-XXX</tt> accompanying the patch file which lists the files that are newly created. The patch program has a problem with creating new directories, so we need to create them on advance. For each <tt/added-XXX/ file you find, execute from <tt>\x11</tt> <verb>xc\config\util\added added-XXX</verb> If there is no <tt>added-XXX</tt> file available, you can make one with the following instructions: <verb> grep "\*\*\* xc/" patchfile >added-file </verb> Edit <tt/added-file/ with a text editor and remove the <tt/*** / at the beginning and the time stamp at the end (search for a TAB and erase to the end of the line). You get a list of file paths, one in a line, which is the input to the added utility. <item>After that you can apply the patches in the right order. Usually this is done by a command <verb> patch -p -E <patchfile 2>&1 | tee patchlog </verb> from the <tt>\x11</tt> directory. Be aware to use the right patch - OS/2 has a utility with the same name and different functionality. Don't use the recommended <tt/-s/ option, this makes <tt/patch/ quiet, and you won't see problems in the patchlog file. Use <verb> find \x11 -name *.rej -print find \x11 -name *# -print </verb> to find any rejects and unapplied patches (attention: yet another OS/2 program with wrong functionality). Normally there shouldn't be any problems of this kind, else you have made a mistake. finally remove the original files with <verb> find \x11 -name *.orig -print -exec rm {} ; </verb> <item>Go to the <tt>xc/config/cf</tt> directory and edit the <tt>xf86site.def</tt> file to match your requirements (you probably don't want to compile all X servers). Certain changes must be set to the following values: <itemize> <item>Disable if not already done any PC98 server; PC98 (Japanese XFree86) does not work yet. Porters from Japan are welcome! <item><tt>#define WacomSupport NO #define ElographicsSupport NO</tt> Both options are not yet supported. <item><tt/#define ForceNormalLib NO/ There is no support for static libraries yet; why would you need them anyway. </itemize> <item>Go to the directory <tt>xc\util\compress</tt> and <tt>make compress.exe</tt> there. Install the program produced there in your path. I stumbled more than once on half-ported compress programs on OS/2 ftp servers that are defective w.r.t. reading and writing stdin/stdout. In some stage (font compression) otherwise you will get a core dump of mkfontdir, because all compressed fonts are corrupt. <item>Set the environment variable <tt/X11ROOT/ to something different than it is; otherwise the installation process will overwrite your original XFree86/OS2 installation. If you have not set this variable, go back to the prefix section of this document: you have forgotten something. <item>Copy the file <tt>xc/config/util/buildos2.cmd</tt> into the <tt/xc/ directory. <item>Execute this <tt/buildos2.cmd/ command in the <tt/xc/ directory; it will produce a logfile <tt>buildxc.log</tt> in this directory. <item>Go have a bucket of coffee. The compile will need between 2 and 20 hours. <item>When finished, view the logfile for errors, and fix the problems if there are some. I have managed to compile the whole system flawlessly, so there is at least one configuration that works. <item>Finally, from the <tt/xc/ dir, execute <verb> xmake install xmake install.man </verb> </enum> Well, you see, this was quite easy :-) <verb> $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2note.sgml,v 3.1 1996/02/24 10:19:19 dawes Exp $ $XConsortium$ </verb> </article> @ 1.1 log @Initial revision @ text @@ 1.1.1.1 log @XFree86 3.2 sources @ text @@ 1.1.1.2 log @XFree86 3.3 sources. @ text @d1 1 a1 1 <!DOCTYPE linuxdoc PUBLIC "-//XFree86//DTD linuxdoc//EN"> d6 1 a6 1 <date>Last modified 17 May 1997 d20 2 a21 17 Please also read <htmlurl name=README.OS2 url=OS2.html> for end-user information, and set at least the environment variables described there. At the current time, the most recent version available is XFree86-3.3. This is a full and unrestricted version which comes with complete source code. 3.3 is an intermediate version which was released because the last beta version (3.2A) was about to expire and the new 4.0 version was not completely finished in time. 3.3 is the last ``classical'' version which has separate Xservers for different video cards. If you want to join the XFree86 developer team, e.g. to add support for certain hardware, please send a request to BOD@@XFree86.org. Please think about such a step carefully before, though, since much work is involved. Please use the XFree86-3.3 source code as a test example how to compile the system. The ability to manage that is a basic requirement for becoming a developer. d34 1 a34 1 <item>gcc EMX/gcc emx 0.9C patch2 or later d45 1 a45 1 <item>make GNU make 3.71/3.72 (use the one coming with XFree86!) d55 7 a61 3 Furthermore, you need the XFree86 sources. These are available from the common XFree86 repositories. Look into a directory which is often named /pub/XFree86/3.3/source. d95 1 a95 1 <tt>\x11</tt> <verb>xc\config\util\added added-XXX</verb> d99 1 a99 1 grep "\*\*\* xc/" patchfile >added-file d115 2 a116 2 find \x11 -name *.rej -print find \x11 -name *# -print d120 1 a120 1 be any problems of this kind, else you have made a mistake. Finally d123 1 a123 1 find \x11 -name *.orig -print -exec rm {} ; d134 3 a136 5 <item>Tcl* and Tk* don't need to be set explicitly. Reasonable defaults are in the other config files, provided you have a complete XFree86/OS2 binary tree with the tcl/tk runtime support installed. <item><tt>#define BuildDynamicLoading NO</tt> This does not work. d151 1 a151 2 directory. If this is a second or later attempt, you might need to copy the saved toplevel Makefile.os2 back to Makefile. d154 2 a155 3 <item>Go have a bucket of coffee, or better, buy new coffee - in Colombia! The compile will need between 2 and 20 hours, depending on your selections, and the horse power of your hardware. d172 1 a172 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2note.sgml,v 3.4.2.2 1997/05/24 08:36:06 dawes Exp $ d178 1 a178 1 $XConsortium: OS2note.sgml /main/1 1996/02/24 10:08:59 kaleb $ @ 1.1.1.3 log @XFree86 3.3.2 sources @ text @d6 1 a6 1 <date>Last modified 26 Mar 1998 d23 1 a23 1 At the current time, the most recent version available is XFree86-3.3.2. d25 4 a28 3 code. 3.3.2 is not only a bugfix release, but also supports new hardware, some of which might not even supported by OS/2 itself. See the RELEASE NOTES document for details. d33 1 a33 1 involved. Please use the XFree86-3.3.2 source code as a test example how d49 1 a49 1 <item>gcc EMX/gcc emx 0.9C patch4 or later d60 1 a60 1 <item>make GNU make 3.71/3.72 (use the one from X332prog.zip!) a178 14 <item>There are a few minor glitches in the installation: <enum> <item>The xdm and linkkit directories will fail in compile and installation. This is no problem and has no effect on the rest of the system. <item>The imake.exe which is installed in <tt/\XFree86\bin/ is usually defective. The one which was built initially and installed in the root directory of the drive where you have the source tree is okay. So simply copy this <tt/\imake.exe/ to the <tt/\XFree86\bin/ directory manually. Some day this might be fixed. <item><tt/XF86Setup/ is not ported yet and won't work with the tcl/tk port available for XFree86/OS2. My idea was to replace this by some native installation tool, which I didn't find the time to do yet. Feel free to spend a bit of time to play with XF86Setup if you like. </enum> d187 1 a187 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2note.sgml,v 3.4.2.3 1998/02/26 20:11:29 hohndel Exp $ @ 1.1.1.4 log @XFree86 3.3.3 sources @ text @d6 1 a6 1 <date>Last modified 04 October 1998 d23 1 a23 1 At the current time, the most recent version available is XFree86-3.3.3. d25 1 a25 1 code. 3.3.3 is not only a bugfix release, but also supports new hardware, d32 1 a32 1 involved. Please use the XFree86-3.3.3 source code as a test example how d200 1 a200 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2note.sgml,v 3.4.2.4 1998/10/11 12:35:56 hohndel Exp $ @ 1.1.1.5 log @XFree86 3.3.4 sources @ text @d6 1 a6 1 <date>Last modified July 6th, 1999 d23 1 a23 1 At the current time, the most recent version available is XFree86-3.3.4. d25 1 a25 1 code. 3.3.4 is not only a bugfix release, but also supports new hardware, d32 1 a32 1 involved. Please use the XFree86-3.3.4 source code as a test example how a161 4 <item>Copy the file <tt>xc/programs/Xserver/hw/xfree86/etc/bindist/OS2/host.def.os2</tt> to the location <tt>xc/config/cf/host.def</tt>. Use this file to do any specific modifications to imake variables, rather than editing the file xfree86.cf, imake.tmpl, or os2.cf directly. d200 1 a200 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2note.sgml,v 3.4.2.5 1999/07/13 07:09:50 hohndel Exp $ @ 1.1.1.6 log @XFree86 3.3.5 sources @ text @d6 1 a6 1 <date>Last modified August 1st, 1999 d23 1 a23 1 At the current time, the most recent version available is XFree86-3.3.5. d25 1 a25 1 code. 3.3.5 is not only a bugfix release, but also supports new hardware, d32 1 a32 1 involved. Please use the XFree86-3.3.5 source code as a test example how d48 1 a48 1 <item>gcc EMX/gcc emx 0.9C patch4 or later (0.9d preferred!) d59 1 a59 1 <item>make GNU make 3.71/3.72 (use the one from Xprog.zip!) d71 1 a71 1 often named /pub/XFree86/3.3.5/source. d204 1 a204 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2note.sgml,v 3.4.2.6 1999/08/02 08:38:17 hohndel Exp $ @ 1.1.1.7 log @XFree86 3.3.6 @ text @d6 1 a6 1 <date>Last modified December 12th, 1999 d23 1 a23 1 At the current time, the most recent version available is XFree86-3.3.6. d25 1 a25 1 code. 3.3.6 is not only a bugfix release, but also supports new hardware, d32 1 a32 1 involved. Please use the XFree86-3.3.6 source code as a test example how d48 1 a48 1 <item>gcc EMX/gcc emx 0.9d patch2 or later a62 2 <item>unix2dos Some conversion utility to convert LF delimiter to CRLF (may be called unixtoos2 or alike as well) d71 1 a71 1 often named /pub/XFree86/3.3.6/source. d76 3 a78 3 You need about 300MB of free HPFS (or NFS, JFS, ext2fs) space for the whole system. This does not include space for the postscript and troff documentation files. I have never installed them. Nor did I install the test subtree. d135 3 a137 5 <item>Go to the <tt>xc\config\cf</tt> directory and copy the file <tt>\x11bsol;xcbsol;programsbsol;Xserverbsol;hwbsol;xfree86bsol;etcbsol;bindistbsol;OS2bsol;host.def.os2</tt> into <tt>xc/config/cf/host.def</tt> and edit it to match your requirements (you probably don't want to compile all X servers). Certain changes must be set to the following values: d141 6 a146 2 <item>Disable the whole external input device stuff, like JoystickSupport, Wacom- Support, etc. a148 1 <item>Disable the special servers XVirtualFramebufferServer, XnestServer, XprtServer a170 5 Note: this may immediately fail in case, you got your distribution from a Unix tar archive. Unfortunately the OS/2 REXX interpreter has a problem with scripts that use the Unix convention as a line delimiter. So go through the whole tree and convert the *.cmd files to "OS/2 ASCII" by one of the typical unix2dos or unixtoos2 programs. d204 1 a204 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2note.sgml,v 3.4.2.7 1999/12/20 12:55:51 hohndel Exp $ @