Maximum RPM Copyright © 2000 by Red Hat, Inc. Taking the Red Hat Package Manager to the Limit Edward C. Bailey Red Hat, Inc. Red Hat, Inc.        2600 Meridian Parkway        Durham, NC 27709        US        919-547-0012        919-547-0024        docs@redhat.com        13588        Research Triangle Park, NC 27713        1-888172-78-9 Dedication To Deb — My lover, editor, indexer, and friend… To Matt, who heard "Daddy can't play right now" far too often… Table of Contents Preface Linux and RPM — A Brief History Parts of the book, and Who They're For Acknowledgements I. RPM and Computer Users — How to Use RPM to Effectively Manage Your Computer 1. An Introduction to Package Management What are Packages, and Why Manage Them? Package Management: How to Do It? RPM Design Goals What's in a package? Let's Get Started 2. Using RPM to Install Packages rpm -i — What does it do? Performing an Install Two handy options Additional options to rpm -i 3. Using RPM to Erase Packages rpm -e — What Does it Do? Erasing a Package Additional Options rpm -e and Config files Watch Out! 4. Using RPM to Upgrade Packages rpm -U — What Does it Do? Upgrading a Package They're Nearly Identical… 5. Getting Information About Packages rpm -q — What does it do? The Parts of an RPM Query A Few Handy Queries 6. Using RPM to Verify Installed Packages rpm -V — What Does it Do? When Verification Fails — rpm -V Output Selecting What to Verify, and How We've Lied to You… 7. Using RPM to Verify Package Files rpm -K — What Does it Do? Configuring PGP for rpm -K Using rpm -K 8. Miscellania Other RPM Options Using rpm2cpio Source Package Files and How To Use Them II. RPM and Developers — How to Distribute Your Software More Easily With RPM 9. The Philosophy Behind RPM Pristine Sources Easy Builds Multi-architecture/operating system Support Easier For Your Users To Summarize… 10. The Basics of Developing With RPM The Inputs The Engine: RPM The Outputs And Now… 11. Building Packages: A Simple Example Creating the Build Directory Structure Getting the Sources Creating the Spec File Starting the Build When Things Go Wrong 12. rpm -b Command Reference rpm -b — What Does it Do? Other Build-related Commands 13. Inside the Spec File Comments: Notes Ignored by RPM Tags: Data Definitions Scripts: RPM's Workhorse Macros: Helpful Shorthand for Package Builders The %files List Directives For the %files list The Lone Directive: %package Conditionals 14. Adding Dependency Information to a Package An Overview of Dependencies Automatic Dependencies Manual Dependencies To Summarize… 15. Making a Relocatable Package Why relocatable packages? The prefix tag: Relocation Central Relocatable Wrinkles: Things to Consider Building a Relocatable Package 16. Making a Package That Can Build Anywhere Using Build Roots in a Package Having RPM Use a Different Build Area Specifying File Attributes 17. Adding PGP Signatures to a Package Why Sign a Package? Getting Ready to Sign Signing Packages 18. Creating Subpackages What Are Subpackages? Why Are They Needed? Our Example Spec File: Subpackages Galore! Spec File Changes For Subpackages Build-Time Scripts: Unchanged For Subpackages Building Subpackages 19. Building Packages for Multiple Architectures and Operating Systems Architectures and Operating Systems: A Primer What Does RPM Do To Make Multi-Platform Packaging Easier? Build and Install Platform Detection optflags — The Other rpmrc File Entry Platform-Dependent Tags Platform-Dependent Conditionals Hints and Kinks 20. Real-World Package Building An Overview of Amanda Initial Building Without RPM Initial Building With RPM Package Building 21. A Guide to the RPM Library API An Overview of rpmlib rpmlib Functions Example Code III. Appendixes A. Format of the RPM File RPM File Naming Convention RPM File Format Tools For Studying RPM Files Identifying RPM files with the file(1) command B. The rpmrc File Using the --showrc Option Different Places an rpmrc File Resides rpmrc File Syntax rpmrc File Entries C. Concise RPM Command Reference Global Options Informational Options Query Mode Verify Mode Install Mode Upgrade Mode Erase Mode Build Mode Rebuild Mode Recompile Mode Resign Mode Add Signature Mode Check Signature Mode Initalize Database Mode Rebuild Database Mode D. Available Tags For --queryformat List of --queryformat Tags E. Concise Spec File Reference Comments The Preamble Scripts Macros The %files List Directives For the %files list The %package Directive Conditionals F. RPM-related Resources Where to Get RPM Where to Talk About RPM RPM On the World Wide Web RPM's License GNU GENERAL PUBLIC LICENSE G. An Introduction to PGP PGP — Privacy for Regular People Installing PGP for RPM's Use Index     Next     Preface