nsz Git - musl/blob - INSTALL

   1
   2 A quick-and-simple guide to installing musl:
   3
   4
   5 STEP 1: Configuration
   6
   7 Edit config.mak to override installation prefix, compiler options,
   8 target architecture, etc. as needed. Currently supported archs are
   9 i386 and x86_64. Otherwise, the defaults should be okay for trying out
  10 musl with static linking only.
  11
  12 DO NOT set the prefix to /, /usr, or even /usr/local unless you really
  13 know what you're doing! You'll probably break your system such that
  14 you'll no longer be able to compile and link programs against glibc!
  15 This kind of setup should only be used if you're building a system
  16 where musl is the default/primary/only libc.
  17
  18 The default prefix is /usr/local/musl for a reason, but some people
  19 may prefer /opt/musl or $HOME/musl.
  20
  21 For shared library support, the dynamic linker pathname needs to be
  22 hard-coded into every program you link to musl. Ideally, you should
  23 leave the path ($syslibdir) set to /lib unless you are unable to
  24 install files to /lib, in which case you can change it.
  25
  26
  27 STEP 2: Compiling
  28
  29 Run "make". (GNU make is required.)
  30
  31
  32 STEP 3: Installation
  33
  34 With appropriate privileges, run "make install".
  35
  36
  37 STEP 4: Using the gcc wrapper.
  38
  39 musl comes with a script "musl-gcc" (installed in /usr/local/bin by
  40 default) that can be used to compile and link C programs against musl.
  41 It requires a version of gcc with the -wrapper option (gcc 4.x should
  42 work). For example:
  43
  44 cat > hello.c <<EOF
  45 #include <stdio.h>
  46 int main()
  47 {
  48         printf("hello, world!\n");
  49         return 0;
  50 }
  51 EOF
  52 musl-gcc hello.c
  53 ./a.out
  54
  55 For compiling programs that use autoconf, you'll need to configure
  56 them with a command like this:
  57
  58 CC=musl-gcc ./configure
  59
  60 Be aware that (at present) libraries linked against glibc are unlikely
  61 to be usable, and the musl-gcc wrapper inhibits search of the system
  62 library paths in any case. You'll need to compile any prerequisite
  63 libraries (like ncurses, glib, etc.) yourself.
  64
  65 Note: If you want the system headers to behave something like glibc's
  66 and expose the kitchen sink by default, you might want to try
  67 CC="musl-gcc -D_GNU_SOURCE" instead of just CC=musl-gcc. This is
  68 needed for compiling many programs with portability issues.