ACE/rpmbuild/README

   1 Building RPM from source tarball
   2 ================================================================
   3
   4 It is possible to build directly from a source tarball if it contains
   5 a valid spec file.
   6
   7 Before you can run rpmbuild, you need to setup a directory tree and a
   8 .rpmmacros file.
   9
  10 Setup directory tree
  11 ----------------------------------------------------------------
  12
  13 You may already have one in /usr/src/RPM, but as rebuilding packages
  14 as root is evil, we recommend that you create one in a place where
  15 your normal user account allows you to write, such as your home
  16 directory. This build tree should have the following structure:
  17
  18     rpm
  19     |-- BUILD
  20     |-- RPMS
  21     |-- SOURCES
  22     |-- SPECS
  23     |-- SRPMS
  24     `-- tmp
  25
  26 The following command should build what you need:
  27
  28     mkdir -p ${HOME}/rpm/{BUILD,RPMS,SOURCES,SPECS,SRPMS,tmp}
  29
  30 Setup rpmbuild configuration file
  31 ----------------------------------------------------------------
  32
  33 Now you need to do some rpm configuration. A simple ~/.rpmmacros with
  34 the following contents should be enough:
  35
  36     cat > ~/.rpmmacros <<EOF
  37     %_topdir        %(echo ${HOME}/rpm)
  38     %_tmppath       %{_topdir}/tmp
  39
  40     %packager       Firstname Lastname <your.address@here>
  41
  42     # Have built RPMs land in RPMS/ instead of RPMS/<arch>/
  43     %_rpmfilename  %%{NAME}-%%{VERSION}-%%{RELEASE}.%%{ARCH}.rpm
  44     EOF
  45
  46 Make sure to replace the %packager fields with your actual name and email address.
  47
  48 Important Details
  49 ----------------------------------------------------------------
  50
  51 There are some important details:
  52
  53 * The tarball name must have the ACE version in the name, for example:
  54
  55     ACE+TAO-src-6.3.3.tar.gz
  56
  57 * The spec file inside the tarball
  58  (ACE_wrappers/rpmbuild/ace-tao.spec) must have the correct version
  59   numbers for ACE and TAO at the top:
  60
  61     %define ACEVER  6.3.3
  62     %define TAOVER  2.3.3
  63
  64 * The following files in the source distribution must have the correct
  65   version numbers:
  66
  67     ACE_wrappers/ace/Version.h
  68     ACE_wrappers/TAO/tao/Version.h
  69
  70
  71 Building the RPM
  72 ----------------------------------------------------------------
  73
  74 You can kick off the rpmbuild anywhere; the tarball will be unpacked
  75 and built in your rpmbuild directory described in the previous
  76 section.
  77
  78     rpmbuild -tb your-tarball.tar.gz
  79
  80 Some packages take quite a while to build.
  81
  82
  83 Harvesting the Binary RPM
  84 ----------------------------------------------------------------
  85
  86 When the build completes, the binary rpms are deposited in rpm/RPMS.
  87
  88     ls -lart ${HOME}/rpm/RPMS
  89
  90 Please let me know if there are questions/problems.
  91
  92 -- Ken Sedgwick (ken@bonsai.com)