X-Git-Url: http://nsz.repo.hu/git/?p=musl;a=blobdiff_plain;f=INSTALL;h=9e2c0061d922e3437b016ce310f001af84fdd320;hp=2470a5bf7aed5d34e5d4e46d8503ee14bf1383fc;hb=f4e8e64b82a85158d9de884e1765474c0c317d19;hpb=0b44a0315b47dd8eced9f3b7f31580cf14bbfc01 diff --git a/INSTALL b/INSTALL index 2470a5bf..9e2c0061 100644 --- a/INSTALL +++ b/INSTALL @@ -5,12 +5,9 @@ A quick-and-simple guide to installing musl: STEP 1: Configuration Edit config.mak to override installation prefix, compiler options, -etc. as needed. The defaults should be okay for trying out musl with -static linking only. The only arch supported at present is i386. If -you're on an x86_64 machine, you can add -m32 to the compiler options -to build a working 32bit musl. In this case you will also need to add --m32 in two locations in the generated tools/musl-gcc script if you -intend to use it. +target architecture, etc. as needed. Currently supported archs are +i386 and x86_64. Otherwise, the defaults should be okay for trying out +musl with static linking only. DO NOT set the prefix to /, /usr, or even /usr/local unless you really know what you're doing! You'll probably break your system such that @@ -21,6 +18,11 @@ where musl is the default/primary/only libc. The default prefix is /usr/local/musl for a reason, but some people may prefer /opt/musl or $HOME/musl. +For shared library support, the dynamic linker pathname needs to be +hard-coded into every program you link to musl. Ideally, you should +leave the path ($syslibdir) set to /lib unless you are unable to +install files to /lib, in which case you can change it. + STEP 2: Compiling @@ -59,3 +61,8 @@ Be aware that (at present) libraries linked against glibc are unlikely to be usable, and the musl-gcc wrapper inhibits search of the system library paths in any case. You'll need to compile any prerequisite libraries (like ncurses, glib, etc.) yourself. + +Note: If you want the system headers to behave something like glibc's +and expose the kitchen sink by default, you might want to try +CC="musl-gcc -D_GNU_SOURCE" instead of just CC=musl-gcc. This is +needed for compiling many programs with portability issues.