README.RPM

   1
   2 NOTE: Before building an RPM manually for your Linux system, it is recommended
   3 to try installing fwsnort via the standard software install mechanism for your
   4 distribution since fwsnort is available in many distribution software
   5 repositories.  For example, you can try installing fwsnort with 'yum' or
   6 'apt-get' depending on the type of Linux distribution that you are running.
   7
   8 Building RPM files that are compatible with all possible Linux distributions
   9 is a difficult task.  If a given RPM file that is downloaded from
  10 http://www.cipherdyne.org/ is not compatible with your particular Linux
  11 distro, then you can use the "cd_rpmbuilder" ("CipherDyne RPM Builder") to
  12 build an RPM file for you on your own system.
  13
  14 The command line interface to cd_rpmbuilder is simple, and one command line
  15 argument is always required "-p <project>" so that cd_rpmbuilder knows which
  16 CipherDyne software project you want to build:
  17
  18     # cd_rpmbuilder -p <project>
  19
  20 Note that cd_rpmbuilder is normally as root because it builds RPM's within
  21 the /usr/src/redhat/ directory by default.  However, if you would like to
  22 build as a normal user within a directory of your choosing you can do:
  23
  24     # cd_rpmbuilder -p <project> -r <dir>
  25
  26 By default, cd_rpmbuilder builds the latest version of the specified project,
  27 but if you want to build an older version, use the -b flag:
  28
  29     # cd_rpmbuilder -p <project> -b <version>
  30
  31 If you want to see verbose output (including all output of the system
  32 rpmbuild command), then use the -v flag:
  33
  34     # cd_rpmbuilder -p <project> -v
  35
  36 Finally, here is some sample output for building the psad project available
  37 at http://www.cipherdyne.org/psad/:
  38
  39     # ./cd_rpmbuilder -p psad
  40     [+] Getting latest version file:
  41           http://www.cipherdyne.org/psad/psad-latest
  42     [+] Downloading file:
  43           http://www.cipherdyne.org/psad/download/psad-2.0.1.spec
  44     [+] Downloading file:
  45           http://www.cipherdyne.org/psad/download/psad-2.0.1.spec.md5
  46     [+] Valid md5 sum check for psad-2.0.1.spec
  47     [+] Downloading file:
  48           http://www.cipherdyne.org/psad/download/psad-2.0.1.tar.gz
  49     [+] Downloading file:
  50           http://www.cipherdyne.org/psad/download/psad-2.0.1.tar.gz.md5
  51     [+] Valid md5 sum check for psad-2.0.1.tar.gz
  52     [+] Building RPM, this may take a little while...
  53
  54     [+] The following RPMS were successfully built:
  55
  56           /usr/src/redhat/SRPMS/psad-2.0.1-1.src.rpm (source RPM)
  57           /usr/src/redhat/RPMS/i386/psad-2.0.1-1.i386.rpm
  58
  59 You can view the usage information like so:
  60
  61     [mbr@minastirith ~/src/psad]$  ./cd_rpmbuilder -h
  62
  63     cd_rpmbuilder; the CipherDyne RPM builder
  64     [+] Version: 0.9
  65     [+] By Michael Rash (mbr@cipherdyne.org, http://www.cipherdyne.org)
  66
  67     Usage: cd_rpmbuilder -p <project> [-b <version>] [-r <dir>] [-v] [-V] [-h]
  68
  69     Options:
  70         -p, --project <name>       - This can be one of "psad", "fwknop",
  71                                      "gpgdir", or "fwsnort".
  72         -b, --build-version <ver>  - Build a specific project version.
  73         -r, --rpm-build-dir <dir>  - Change the RPM build directory from the
  74                                      default of /usr/src/redhat.
  75         -v, --verbose              - Run in verbose mode.
  76         -V, --Version              - Print version and exit.
  77         -h, --help                 - Display usage information.