Credit Andrew minor bsd build script update
[goodguy/cinelerra.git] / cinelerra-5.1 / doc / installation.html
1 <TITLE>Secrets of Cinelerra: Installation</TITLE>
2 <CENTER>
3 <H1>Secrets of Cinelerra: Installation</H1>
4 </CENTER><P>
5
6 Cinelerra is best installed by downloading an RPM and running<P>
7
8 <B>rpm -U --force --nodeps cinelerra*.rpm</B><P>
9
10 on a RedHat system.<P>
11
12 On systems which don't support RPM look for a utility called
13 <B>rpm2cpio</B>.  Download a Cinelerra RPM and from the <B>/</B>
14 directory run<P>
15
16 <B>rpm2cpio cinelerra*.rpm | cpio -i --make-directories</B><P>
17
18 It should be noted that the compiler used in building Cinelerra
19 binaries is the free GNU compiler and although it can reorder
20 instructions for Pentium I and use some the of Pentium II branch
21 instructions it's 12 years behind most modern CPUs.  You can try
22 different compilers and optimization flags by compiling the source.<P>
23
24 Compiling the source is hard and there's no warranty if the source code
25 fails to compile, but the method for compiling starts by downloading
26 the source code and decompressing.<P>
27
28 <B>tar jxf cinelerra*.tar.bz2</B><P>
29
30 Enter the cinelerra directory<P>
31
32 <B>cd cinelerra</B><P>
33
34 and set some environment variables.  For Pentium II use:<P>
35
36 <B>export CFLAGS='-O3 -march=i686 -fmessage-length=0 -funroll-all-loops -fomit-frame-pointer -malign-loops=2 -malign-jumps=2 -malign-functions=2 -I/usr/local/include'</B><P>
37
38 For Pentium I and old AMD's use:<P>
39
40 <B>export CFLAGS='-O3 -fmessage-length=0 -funroll-all-loops -fomit-frame-pointer -malign-loops=2 -malign-jumps=2 -malign-functions=2 -I/usr/local/include'</B><P>
41
42 Then run<P>
43
44 <B>make</B><P>
45
46 The make procedure should run through all the directories and put
47 binaries in the <B>i686</B> directories.  When we originally supported
48 Alpha it was convenient to compile Alpha and i686 binaries
49 simultaneously, in different directories.<P>
50
51 Once finished run<P>
52
53 <B>make install</B><P>
54
55 to install the binaries.  The output goes as follows:<P>
56
57 Binaries -> <B>/usr/bin</B><BR>
58 Plugins  -> <B>/usr/lib/cinelerra</B><P>
59
60 The main binaries are the Cinelerra executable and several utilities
61 for reading MPEG transport streams.<P>
62
63 Run Cinelerra by running<P>
64
65 <B>/usr/bin/cinelerra</B><P>
66
67
68
69
70