GNUstep Build Guide for Unix Systems A basic system Mr. Dennis Leeuw Pieter Bothstraat 32 3531 GZ Utrecht NL [email protected] GNUstep Build Guide for Unix Systems: A basic system by Mr. Dennis Leeuw Version 1.5.10 Edition Published Januari 2003 Copyright © 2001, 2002, 2003 by Dennis Leeuw Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". Revision History Revision 1.5.11 29 April 2003 Revised by: DL More IDs added. Bug in setting the Language for Defaults fixed. Added ideas by Chris B. Vetter for the X and init script setup. Revision 1.5.10 04 April 2003 Revised by: DL More consistent interface/layout. Preparation for scripting by adding IDs Revision 1.5.0 13/14 December 2002 Revised by: DL Migrated to DocBook, lot of layout and text changes, minor updates to versions and procedures. Revision 1.4.2 29 Sept 2002 Revised by: DL Added a modified check for gmp, suggested by Larry Coleman. Revision 09 Sept 2002 Revised by: DL Updated to the newest version of gcc, updated to the newest binutils. Revision 11 May 2002 Revised by: DL changed the gcc configure options again, since they where too Debian Revision 03 May 2002 Revised by: DL Made some additional notes on the building of gcc and the xinitrc part, adjusted the xinitrc file to comply to the new gnustep-back situation. Added a Debian bootscript example (additions are welcome) Revision 26 Apr 2002 Revised by: DL Moved the WindowMaker build to /usr/local thanks to Larry Coleman, added notes for Solaris 8 users in the binutils section, added gdb-5.1.1 version and links to patches. Revision 21 Apr 2002 Revised by: DL Added the install of libffi to gcc section, removed the DGS section and setting the backend section, made extensions a chapter directly after installing GNUstep, added StepTalk to the extensions chapter, moved gsguile to extensions chapter, moved wmaker before the GNUstep build chapter, with this I assume a graphical workstation. Revision 21 Apr 2002 Revised by: DL Wrote new boot script and removed shell script startup section. Made sure the xinitrc could be found. 16 Apr 2002: Fixed the CVS source paths for GNUstep. Revision 29 Mar 2002 Revised by: DL Added the back part and removed xgps and xdps. Revision 22 Feb 2002 Revised by: DL Changed all versions to most recent ones, added troubleshooting section to gui build part, added tar jxvf note in Build Basic section (note from Dean Chouinard) Table of Contents 1. Document description............................................................................................................................1 1.1. Introduction.................................................................................................................................1 1.2. Credits .........................................................................................................................................1 2. Check your system.................................................................................................................................2 2.1. Tips while installing....................................................................................................................2 2.2. make ............................................................................................................................................3 2.3. binutils.........................................................................................................................................4 2.4. iconv............................................................................................................................................5 2.5. The Objective-C Compiler..........................................................................................................6 2.6. Foreign Function Interfaces ........................................................................................................7 2.7. GMP ............................................................................................................................................8 2.8. SSL..............................................................................................................................................9 2.9. TIFF ..........................................................................................................................................10 2.10. XML........................................................................................................................................11 2.11. Sound ......................................................................................................................................12 2.12. Window Manager....................................................................................................................12 3. The GNUstep sources ..........................................................................................................................14 3.1. Stable and unstable versions .....................................................................................................14 3.2. CVS versions.............................................................................................................................14 4. Building GNUstep................................................................................................................................15 5. Building Extensions .............................................................................................................................18 6. GNUstep services .................................................................................................................................20 7. GNUstep Workspace ...........................................................................................................................23 iii Chapter 1. Document description 1.1. Introduction This guide will try to guide you through the installation process of building GNUstep from source code. I only have GNU/Linux systems, so it might be that some things are GNU/Linux related. Some things are just assumed to be there, like a working system and the X-windows system (X11R6). If you work your way through the document from start to finish, you should end up with a working system. No guarantees are made ofcourse. If you find things to be different on your system, please let me know. 1.2. Credits Writing a guide is not a one man job. First of all there needs to be a subject to write about, then there is the need to gather information and after that bugs, omissions, etc. are found in the work. The list tries to thank the people that helped me writing this guide. It is far from complete, but the best I could do. If you feel you should be on the list, but are not let me know. 1 Chapter 2. Check your system This chapter guides you through the checking of your system, to see if all vital components are there to install GNUstep. Since there are several Un*x flavours out there, I have tried to do my best to be as generic as possible. Every part has a couple distinct sections, where we start with a test to see if the right program or library is available and if not I will almost always give a quick guide of how to install that piece. All additional software will be installed in /usr/local. Remember however that you should FIRST check to see if a package update for your system is available from your supplier, this keeps your system consistent and helps with future upgrades. If you decide to go with the "compile from source" there are some tips you might find useful to monitor what is actually going on on your system. Solaris 8 When you install any of the below software in /usr/local make sure you have /usr/local/bin before /usr/ccs/bin in your path. 2.1. Tips while installing Be sure to have atleast /usr/local/lib and /usr/X11R6/lib in your /etc/ld.so.conf before you continue. The general procedure to compile most software programs is to use: ./configure make make install Make sure you use GNU make for this. That means that on e.g. FreeBSD you’ll have to substitute the make command with gmake. I don’t know much about other compilers then gcc, so I guess you are on your own on that one. Let me know if you have good tips. I always like to keep track about what a program installs and where, so I always do (I assume sources go under /usr/src): mkdir -p /var/adm/[programname] touch /usr/src/test ./configure make make install find / -cnewer /usr/src/test | grep -v /proc | grep -v /var | grep -v /usr/src > /var/adm/[programname]/filelist 2 Chapter 2. Check your system Now I have a complete list of all installed files, which saves me trouble in generating packages, but also when removing the program, before upgrading or if something was build wrong (which happens). 2.2. make Priority: A must have. GNU Make Automatically determines which pieces of a program need to be compiled, and issues commands to recompile them. 1. Check make --version \ | awk '{if(/Make/) print $4}' Which should return: 3.79.0, or higher. 2. Download ftp://ftp.gnu.org/gnu/make/make-3.80.tar.gz (ftp://ftp.gnu.org/gnu/make/make-3.80.tar.gz) 3. Build ./configure make make install 4. Post-install a. GNU/Linux By default /usr/bin/make is installed setgid kmem. This is needed on some systems so it can check the load