]> git.mxchange.org Git - flightgear.git/blob - docs-mini/README.Linux
Merge branch 'durk/traffic'
[flightgear.git] / docs-mini / README.Linux
1 I.  GENERAL LINUX INSTRUCTIONS
2 ==============================
3
4 This is a short description of the things that need to be done to get
5 FlightGear up and running under Linux.
6
7 1. Prerequisites:
8
9 - You need to understand the concepts of 3D acceleration under Linux
10   and the needed libraries.  You will need to install and configure
11   accelerated drivers for your specific video card.  It is beyond the
12   scope of this document to describe the process for your specific
13   video card.
14
15   More and more distributions are coming out with pre-packaged drivers
16   so look around (just in case) before you go out and build software
17   yourself.
18
19   Here are some potentially useful sites, but be careful and find the
20   specific instructions for your specific video card and distribution:
21
22     http://www.thedukeofurl.org/reviews/misc/3dlinux/
23     http://www.linux3d.net/
24     http://dri.sourceforge.net/
25     http://www.nvidia.com
26     http://glide.xxedgexx.com/
27
28   Without accelerated 3d rendering, FlightGear could never run at
29   decent frame rates, even on the fastest CPU's.
30
31 - You will need the GLUT library version 3.7 (or greater, aka
32   GameGLUT) installed.
33
34   Grab it at:
35
36         http://reality.sgi.com/opengl/glut3/glut3.html
37
38   Note: glut-3.7 is included with Mesa 3.x so if you've already
39   grabbed the latest version of mesa, you should have everything you
40   need.
41
42   Alternatively, you can use the 3D-stuff that came along with your
43   Linux distribution. At least RedHat (5.3 and later) and S.u.S.E. 6.0
44   (or later) may contain all the things you need depending again on
45   your video card.
46
47 - Steve Baker's plib library.  Get it from:
48
49     http://plib.sf.net
50
51   ... and follow the instructions there to install it.
52
53 - SimGear.  Get it from:
54
55     http://www.simgear.org
56
57   ... and follow the instructions there to install it.
58
59
60 2. Build FlightGear:
61
62    You will need the following files:
63
64      FlightGear-x.xx.tar.gz (source code)
65
66    which can be found under:
67
68      ftp://flightgear.sourceforge.net/pub/flightgear/Source
69
70    and the base package located at:
71
72      ftp://flightgear.sourceforge.net/pub/flightgear/Shared/
73
74    the file is called 
75
76         fgfs-base-x.xx.tar.gz       (data files)
77
78    Ok, now that you got all the stuff, let's proceed towards installation.
79
80    Unpack FlightGear-x.xx.tar.gz using :
81
82         tar xvfz FlightGear-x.xx.tar.gz
83
84    and cd info FlightGear-x.xx. Run:
85
86         ./configure
87
88    and wait a few minutes. configure knows about a lot of
89    options. Have a look at the file INSTALL in the FlightGear source
90    directory to learn about them. If run without options, configure
91    assumes that you will install the data files under
92    /usr/local/share/FlightGear. Assuming configure finished
93    successfully, simply run
94
95         make
96
97    and wait for the make process to finish. Now become root (for
98    example by using the su command) and type
99
100         make install
101
102    This will install the binaries in /usr/local/bin. Notice that the
103    name of the FlightGear binary is "fgfs".
104
105
106 3. Install the data files
107
108    Change to /usr/local/lib
109
110         tar xvfz WHERE_YOU_DOWNLOADED_THE_FILES/fgfs-base-x.xx.tar.gz 
111
112    That's it...
113
114
115 4. Fly!
116
117    If everything went ok, simply type
118
119         runfgfs
120
121    at the prompt. You should see the FlightGear splash-screen and a
122    few seconds later you'll find youself somewhere in the desert,
123    ready for take-off.
124
125 5. Strange things happen...
126
127    We have mailing lists set up for specific FlightGear problems,
128    bugs, and questions.  Please see the flightgear web page for
129    details.
130
131
132 6. Conclusion
133
134     I hope this document provides some help. If it does, send
135     virtual/real beer to me, if not flame me!
136
137     Bernhard H. Buckel
138     <buckel@wmad95.mathematik.uni-wuerzburg.de>
139
140     Updated by Curtis Olson <http://www.flightgear.org/~curt> 6/26/2001
141
142
143 II.  RedHat Linux Notes
144 =======================
145
146 Summary: There are known problems with the versions of libstdc++ that
147 ships with both RedHat-5.1 and RedHat-5.2.  You need to upgrade your
148 libstdc++ before attempting to build flight gear on a RedHat system.
149
150 Raymond de Vries <vries@per.nl> writes: I ran into [this] problem on
151 my RedHat 5.2 system (brand new). After some searching I found out
152 that it's got to do with a 'bug' in the stdlibc++ libraries. I picked
153 up libstdc++-2.9.0-2.i386.rpm, installed it and FGFS compiled just
154 fine. However, some other packages must have the libstdc++-2.8
155 libraries....
156
157 BTW I also solved it with the 2.8 libraries by including
158 /usr/include/g++/std/bastring.cc into the example programs. I believe
159 this can be done since it's a template, correct me if I'm wrong.
160
161
162 III.  Linux/AXP Notes
163 ====================
164
165 As of 2/19/99 I'm not aware of any glide port to Linux/AXP so it's
166 software rendering only for now.  :-(
167
168 This following information is contributed by "Daniel J. Frasnelli"
169 <dfrasnel@csee.wvu.edu>
170
171 1) Mesa was not built correctly by default.  I had to add the "-mieee"
172 flag to the Make-config for Mesa-3.1beta1 to fix the problem.  After
173 building and installation, all of the problems I had previously with
174 GL programs under AlphaLinux disappeared.
175
176 2) I also had to set the '-mieee' flag in $CFLAGS before configuring
177 and building FGFS.  The -mieee switch fixes floating point exception
178 handling.
179
180 I heavily optimized both Mesa and FGFS, using the libffm "fast math
181 library for Alpha" in preference over the default libm, sticking all
182 sorts of strange flags in $CFLAGS, etc.  These flags should be
183 adjusted for your specific architecture:
184
185     export CFLAGS="-mieee -mcpu=ev56 -Wa,-m21164a -pipe -g"
186     export CXXFLAGS="-mieee -mcpu=ev56 -Wa,-m21164a -pipe -g"
187     ./configure
188
189