INSTALL

   1
   2                         ALSA library installation
   3                         =========================
   4
   5 Installation from tarball
   6 -------------------------
   7
   8 For installation you can use these commands:
   9
  10         ./configure
  11         make install
  12
  13
  14 Compilation from HG sources
  15 ---------------------------
  16
  17 You need also GNU packages automake and libtool installed in your system
  18 to compile HG (Mercurial) 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 hgcompile 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
  48 Partial Builds
  49 --------------
  50
  51 You can choose the core components to build via --enable-* or --disable-*
  52 configure option for reducing the size of libasound.  The selectable
  53 components are: pcm, mixer, rawmidi, hwdep, seq and instr.
  54 For example, --disable-rawmidi will prevent to build the stuff related
  55 with raw MIDI.  As default, all components are enabled.
  56
  57 The PCM plugins to build can be selected via --with-pcm-plugins
  58 configure option.  Multiple plugins can be passed by separation with
  59 comma.  For example, to select _only_ rate and linear plugins (and
  60 disable other plugins), pass
  61         --with-pcm-plugins=rate,linear
  62 Note that "hw" plugin is always enabled.
  63 Passing "all" will select all available plugins (which is the default
  64 behavior).
  65
  66 When you select "plug" plugin, copy and linear plugins will be
  67 automatically selected, too.  That is, the linear-format and
  68 access-type conversions are always available with plug layer.
  69 The other conversions of plug (channel shrink/expansion, rate,
  70 non-linear and float conversions) are enabled when the corresponding
  71 plugin is selected, too.
  72
  73
  74 Configuration for cross-compilation
  75 -----------------------------------
  76
  77 When you would like to cross-compile ALSA library (e.g. compile on
  78 i686 host but for arm architecture) you will need to call ./configure
  79 script with additional parameters:
  80
  81 CC=arm-linux-gcc ./configure --host=arm-linux
  82
  83 You can omit setting 'CC' variable and cross-compiler will be guessed too.
  84
  85 So simplest version would be:
  86
  87 ./configure --host=arm-linux
  88
  89 For platform names in the form cpu-vendor-os (or aliases for this)
  90 you should look in 'config.guess' script. Target and all paths
  91 used here are only examples and should not be directly applicable to
  92 your system.
  93
  94 Configuration for machines without FPU
  95 --------------------------------------
  96
  97 If your machine does not have FP unit, you should use '--with-softfloat'
  98 option. This option disables usage of float numbers in PCM route plugin.
  99 ALSA could then leave much more CPU cycles for your applications, but you
 100 could still need some floating point emulator.
 101
 102 Jack plugin
 103 -----------
 104
 105 JACK plugin is moved to alsa-plugins package.
 106
 107 Trouble Shooting
 108 ----------------
 109
 110 * Install path on Fedora Core 3
 111
 112   FC3 installs its system ALSA library to /lib instead of /usr/lib.
 113   Specify --libdir=/lib to configure to overwrite it with the new library,
 114   or run like
 115
 116         # ln -sf /usr/lib/libasound.so.2.0.0 /lib/libasound.so.2.0.0
 117
 118   to make symlink to the new path.
 119   Note that /lib might be /lib64 on 64bit architecture.