DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

(libtool14.info.gz) Installing libraries

Info Catalog (libtool14.info.gz) Debugging executables (libtool14.info.gz) Using libtool (libtool14.info.gz) Installing executables
 
 3.5 Installing libraries
 ========================
 
 Installing libraries on a non-libtool system is quite
 straightforward... just copy them into place:(1)
 
      burger$ su
      Password: ********
      burger# cp libhello.a /usr/local/lib/libhello.a
      burger#
 
    Oops, don't forget the `ranlib' command:
 
      burger# ranlib /usr/local/lib/libhello.a
      burger#
 
    Libtool installation is quite simple, as well.  Just use the
 mode::):
 
      a23# libtool cp libhello.la /usr/local/lib/libhello.la
      cp libhello.la /usr/local/lib/libhello.la
      cp .libs/libhello.a /usr/local/lib/libhello.a
      ranlib /usr/local/lib/libhello.a
      a23#
 
    Note that the libtool library `libhello.la' is also installed, to
 help libtool with uninstallation ( Uninstall mode) and linking
 ( Linking executables) and to help programs with dlopening
 ( Dlopened modules).
 
    Here is the shared library example:
 
      burger# libtool install -c libhello.la /usr/local/lib/libhello.la
      install -c .libs/libhello.so.0.0 /usr/local/lib/libhello.so.0.0
      install -c libhello.la /usr/local/lib/libhello.la
      install -c .libs/libhello.a /usr/local/lib/libhello.a
      ranlib /usr/local/lib/libhello.a
      burger#
 
    It is safe to specify the `-s' (strip symbols) flag if you use a
 BSD-compatible install program when installing libraries.  Libtool will
 either ignore the `-s' flag, or will run a program that will strip only
 debugging and compiler symbols from the library.
 
    Once the libraries have been put in place, there may be some
 additional configuration that you need to do before using them.  First,
 you must make sure that where the library is installed actually agrees
 with the `-rpath' flag you used to build it.
 
    Then, running `libtool -n --finish LIBDIR' can give you further
 hints on what to do ( Finish mode):
 
      burger# libtool -n --finish /usr/local/lib
      PATH="$PATH:/sbin" ldconfig -m /usr/local/lib
      -----------------------------------------------------------------
      Libraries have been installed in:
         /usr/local/lib
 
      To link against installed libraries in a given directory, LIBDIR,
      you must use the `-LLIBDIR' flag during linking.
 
       You will also need to do one of the following:
         - add LIBDIR to the `LD_LIBRARY_PATH' environment variable
           during execution
         - add LIBDIR to the `LD_RUN_PATH' environment variable
           during linking
         - use the `-RLIBDIR' linker flag
 
      See any operating system documentation about shared libraries for
      more information, such as the ld and ld.so manual pages.
      -----------------------------------------------------------------
      burger#
 
    After you have completed these steps, you can go on to begin using
 the installed libraries.  You may also install any executables that
 depend on libraries you created.
 
    ---------- Footnotes ----------
 
    (1) Don't accidentally strip the libraries, though, or they will be
 unusable.
 
Info Catalog (libtool14.info.gz) Debugging executables (libtool14.info.gz) Using libtool (libtool14.info.gz) Installing executables
automatically generated byinfo2html