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