Front cover Linux on IBM zSeries and S/390: Application Development Tools and techniques for Linux application development Using the Eclipse IDE and Jakarta Project tools Sample code to illustrate programming techniques Gregory Geiselhart Andrea Grahn Frans Handoko Jörg Hundertmark Albert Krzymowski Eliuth Pomar ibm.com/redbooks International Technical Support Organization Linux on IBM ^ zSeries and S/390: Application Development July 2002 SG24-6807-00 Note: Before using this information and the product it supports, read the information in “Notices” on page xiii. First Edition (July 2002) This edition applies to zVM 4.2 (ESP) and many different Linux distributions. SuSE Linux Enterprise Server 7.0 was used. © Copyright International Business Machines Corporation 2002. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Notices . xiii Trademarks . xiv Preface . xv The team that wrote this redbook. xvi Become a published author . xvii Comments welcome. xvii Part 1. Programming tools . 1 Chapter 1. The basic tools you need. 3 1.1 Where you can look for information. 4 1.1.1 Man pages . 4 1.1.2 Info - the help system . 5 1.2 Compiling C/C++ source code . 6 1.2.1 Starting gcc . 6 1.2.2 Source files . 6 1.2.3 Directory search . 7 1.2.4 Compilation stages . 7 1.2.5 Macros . 8 1.2.6 Warnings . 8 1.2.7 Extra information for debuggers . 8 1.2.8 Code optimization . 9 1.2.9 Configuring gcc as a cross-compiler . 9 1.3 Linking object code . 13 1.4 Automating the build process . 14 1.4.1 GNU make . 14 1.4.2 Writing your Makefile. 14 1.4.3 Building with make . 16 1.4.4 Makedepend . 17 1.4.5 File dependencies from gcc . 17 1.5 Libraries. 18 1.6 Tracking changes . 19 1.6.1 Using diff to find differences . 19 1.6.2 Applying changes . 21 1.6.3 Running diff against source tree . 22 1.6.4 Distributing patches. 24 1.6.5 Before you distribute your patch . 25 © Copyright IBM Corp. 2002. All rights reserved. iii Chapter 2. The IBM Java Software Development Kit . 27 2.1 Java 2 Platform, Software Development Kit . 28 2.1.1 References . 28 2.2 IBM Java Developer Kit for Linux running on zSeries . 28 2.2.1 Obtaining the IBM Java Developer Kit . 28 2.2.2 Installing the IBM Java Developer Kit . 28 2.3 Jikes . 29 2.3.1 Installing Jikes. 30 2.3.2 Using Jikes . 30 Chapter 3. Source code control using CVS . 33 3.1 Introduction to CVS . 34 3.1.1 Definitions . 34 3.1.2 Revision numbering . 35 3.1.3 File locking . 35 3.2 CVS command syntax. 35 3.2.1 Global options . 36 3.2.2 CVS commands . 36 3.2.3 Command options . 37 3.2.4 Command arguments . 37 3.2.5 Log messages. 38 3.2.6 Date formats . 38 3.3 Administering CVS . 38 3.3.1 Creating a repository. 38 3.4 Root directory . 39 3.5 ssh access. 40 3.6 Environment variables and the ~/.cvsrc file. 40 3.7 Creating a project . 41 3.7.1 Importing the files . 41 3.8 Obtaining a working copy . 42 3.8.1 Special files . 43 3.9 Making changes in the working copy . 44 3.10 Adding files and directories . 45 3.11 Committing changes to the repository. 46 3.12 Updating the working copy . 48 3.13 Resolving conflicts. 51 3.14 Viewing log messages. 51 3.15 Recovering versions . 52 Chapter 4. The Emacs editor . 55 4.1 Editing files using Emacs . 56 4.1.1 Starting Emacs . 56 4.1.2 Basic commands. 57 iv Linux on zSeries: Application Development 4.1.3 Invoking Lisp functions . 57 4.1.4 Editing multiple files . 58 4.1.5 Moving text . 59 4.1.6 Search and replace . ..