~ubuntu-branches/ubuntu/warty/alsa-lib/warty

« back to all changes in this revision

Viewing changes to INSTALL

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2004-09-23 19:38:45 UTC
  • Revision ID: james.westby@ubuntu.com-20040923193845-71lrqesgxij0yzn7
Tags: upstream-1.0.5
ImportĀ upstreamĀ versionĀ 1.0.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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.