T2 System Development Environment Creating custom Linux solutions (Compiled from r369) René Rebe Susanne Klaus T2 System Development Environment: Creating custom Linux solutions: (Compiled from r369) by René Rebe and Susanne Klaus Published (TBA) Copyright © 2002, 2003, 2004, 2005, 2006, 2007 René RebeSusanne Klaus This work is licensed under the Open Publication License, v1.0, including license option B: Distribution of the work or derivative of the work in any standard (paper) book form for commercial purposes is prohibited unless prior permission is obtained from the copyright holder. The latest version of the Open Publication License is presently available at ht- tp://www.opencontent.org/openpub/. Table of Contents Preface ....................................................................................................................x Audience ..........................................................................................................x How to Read this Book ...................................................................................... x Conventions Used in This Book ......................................................................... x Typographic Conventions .......................................................................... x Icons ........................................................................................................x Organization of This Book ................................................................................ xi This Book is Free ............................................................................................. xi Acknowledgments ........................................................................................... xii From René Rebe .................................................................................... xii From Susanne Klaus .............................................................................. xii 1. Introduction ..........................................................................................................1 Different as SDE ...............................................................................................2 Different as Distribution .....................................................................................3 Community .......................................................................................................6 2. Basic Concepts .....................................................................................................7 T2 Architecture .................................................................................................7 Stable branches versus trunk ............................................................................9 3. Hardware and Kernel Support .............................................................................. 11 Linux ..............................................................................................................11 uClinux ..........................................................................................................11 Minix ..............................................................................................................11 Other Operating Systems ................................................................................ 12 4. Building T2 .........................................................................................................13 Downloading the T2 Source Code .................................................................... 13 Using the Scripts ............................................................................................ 13 Updating the T2 Source Tree ........................................................................... 13 Switching to Another Tree or Version ....................................................... 14 Building the Target .......................................................................................... 14 Preparing the Build System ..................................................................... 14 Configuring the T2 Build .......................................................................... 14 Downloading the Package Sources .......................................................... 16 Mirrors ...................................................................................................17 Download Tips ........................................................................................ 19 The Actual Compilation Phase ................................................................. 19 Build Errors ............................................................................................ 19 Cleanup .................................................................................................20 Build Summary ....................................................................................... 20 Creating an ISO Image (for CD-ROM Installation) ............................................. 21 Building More Than One Target ....................................................................... 21 Building a Single Package ............................................................................... 21 Troubleshooting .............................................................................................. 23 chroot: cannot run command `bin/bash' .................................................... 23 Found shared files with other packages: ................................................... 23 Command Not Found .............................................................................. 23 mount: you must specify the filesystem type ............................................. 23 Free Disk Space ..................................................................................... 23 Building On a non-T2 Systems ................................................................ 23 Bootfloppy Images .................................................................................. 24 Building a Required Package Manually .................................................... 24 Fixing Broken Packages .......................................................................... 24 iv T2 System Development Environment Tips ...............................................................................................................25 Build a Standard Edition First .................................................................. 25 Watch Progress ...................................................................................... 26 Cluster Build - the Build Speedup ............................................................ 26 Set the 'nice' Level .................................................................................. 26 5. Inside T2 ............................................................................................................27 A Package .....................................................................................................27 Description File (.desc) ................................................................................... 27 The File's Copyright ................................................................................ 28 The End-Uer Information ......................................................................... 28 Who is Responsible? .............................................................................. 29 The Version, State and Other Build Details ............................................... 29 Other Tunable Details ............................................................................. 30 Where Does the Package Source Come From? ........................................ 30 Configuration File (.conf) ................................................................................. 32 Patch Files (.patch) ......................................................................................... 32 Cache File (.cache) ......................................................................................... 33 Package Creation in Practice ........................................................................... 33 Preparing .......................................................................................................34 Custom Code .................................................................................................34 Testing ...........................................................................................................34 Getting New Packages Into T2 ........................................................................ 35 Compiler Optimisations ................................................................................... 36 The Automated Package Build ......................................................................... 36 Build Stages ........................................................................................... 36 Build Priority ........................................................................................... 37 Supported Build Styles ............................................................................ 37 Working with Variables .................................................................................... 38 Functions for Variable Modifications ......................................................... 38 Build System Hooks ........................................................................................ 39 Available Hooks ...................................................................................... 39 Working