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