INSTALL

   1
   2                         ALSA library installation
   3                         =========================
   4
   5 Installation from tarbal
   6 ------------------------
   7
   8 For installation you can use these commands:
   9
  10         ./configure
  11         make install
  12
  13
  14 Compilation from CVS sources
  15 ----------------------------
  16
  17 You need also GNU packages automake and libtool installed in your system
  18 to compile CVS sources of alsa-lib package.
  19
  20 For compilation you can use these commands:
  21
  22         libtoolize --force --copy --automake
  23         aclocal
  24         autoheader
  25         automake --foreign --copy --add-missing
  26         autoconf
  27         ./configure
  28         make
  29
  30 The included cvscompile script does this job for you.
  31
  32 Note: Some automake packages have missing aclocal program. Use newer version
  33       in the case.
  34
  35
  36 Compilation of static library
  37 -----------------------------
  38
  39 If you would like to use the static ALSA library, you need to use these
  40 options for the configure script:
  41
  42         ./configure --enable-shared=no --enable-static=yes
  43
  44 Unfortunately, due to bug in the libtool script, the shared and static
  45 library cannot be built together.
  46
  47 Configuration for cross-compilation
  48 -----------------------------------
  49
  50 When you would like to cross-compile ALSA library (e.g. compile on
  51 i686 host but for arm architecture) you will need to call ./configure
  52 script with aditional parameters:
  53
  54 CC=arm-linux-gcc ./configure --target=arm-linux
  55
  56 In this example host where the library is build is guessed (should be
  57 given with --host=platform) and target for which is the library build is
  58 Linux on ARM architecture.  You should ommit setting 'CC' variable and
  59 cross-compiler will be guessed too.
  60
  61 So simplest version would be:
  62
  63 ./configure --target=arm-linux
  64
  65 For platform names in the form cpu-vendor-os (or aliases for this)
  66 you should look in 'config.guess' script. Target and all paths
  67 used here are only examples and should not be directly applicable to
  68 your system.
  69
  70 Configuration for machines without FPU
  71 --------------------------------------
  72
  73 If your machine does not have FP unit, you should use '--with-softfloat'
  74 option. This option disables usage of float numbers in PCM route plugin.
  75 ALSA could then leave much more CPU cycles for your applications, but you
  76 could still need some floating point emulator.
  77
  78 Jack plugin
  79 -----------
  80
  81 To build the jack pcm plugin, use this sequence:
  82
  83 cd alsa-lib/src/pcm/ext
  84 make jack
  85 make jack-install
  86
  87 The default directory for add-on modules is ${prefix}/lib/alsa-lib.