added note about trying yum/agt-get installation (Guillermo Gomez)
[fwsnort.git] / 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.