/branches/0.1.10/libusb/INSTALL.libusb.in

# · Autoconf · 59 lines · 41 code · 18 blank · 0 comment · 2 complexity · 7c1dbdf9ef3f8146d9a1edff44d41f93 MD5 · raw file 

    

  1. Simple install procedure
    2. 

  2. ========================
    3. 

  3. 

  4.   % gzip -cd libusb-@LIBUSB_VERSION@.tar.gz | tar xvf -  # unpack the sources
    5. 

  5.   % cd libusb-@LIBUSB_VERSION@                           # change to the toplevel directory
    6. 

  6.   % ./configure                             # run the `configure' script
    7. 

  7.   % make                                    # build libusb
    8. 

  8.   [ Become root if necessary ]
    9. 

  9.   % make install                            # install libusb
    10. 

    11. 

  11. The Nitty-Gritty
    12. 

  12. ================
    13. 

    14. 

  14. The 'configure' script can be given a number of options to enable
    15. 

  15. and disable various features. For a complete list, type:
    16. 

    17. 

  17.   ./configure --help
    18. 

    19. 

  19. A few of the more important ones:
    20. 

    21. 

  21. *  --prefix=PREFIX         install architecture-independent files in PREFIX
    22. 

  22.                            [ Defaults to /usr/local ]
    23. 

    24. 

  24. *  --exec-prefix=EPREFIX   install architecture-dependent files in EPREFIX
    25. 

  25.                            [ Defaults to the value given to --prefix ]
    26. 

    27. 

  27. Options can be given to the compiler and linker by setting
    28. 

  28. environment variables before running configure. A few of the more
    29. 

  29. important ones:
    30. 

    31. 

  31.  CC       : The C compiler to use
    32. 

  32.  CPPFLAGS : Flags for the C preprocesser such as -I and -D
    33. 

  33.  CFLAGS   : C compiler flags
    34. 

    35. 

  35. The most important use of this is to set the
    36. 

  36. optimization/debugging flags. For instance, to compile with no
    37. 

  37. debugging information at all, run configure as:
    38. 

    39. 

  39.  CFLAGS=-O2 ./configure           # Bourne compatible shells (sh/bash/zsh)
    40. 

    41. 

  41. or,
    42. 

    43. 

  43.  setenv CFLAGS -O2 ; ./configure  # csh and variants
    44. 

    45. 

    46. 

  46. Installation directories
    47. 

  47. ========================
    48. 

    49. 

  49. The location of the installed files is determined by the --prefix
    50. 

  50. and --exec-prefix options given to configure. There are also more
    51. 

  51. detailed flags to control individual directories. However, the
    52. 

  52. use of these flags is not tested.
    53. 

    54. 

  54. A shell script libusb-config is created during the configure
    55. 

  55. process, and installed in the bin/ directory
    56. 

  56. ($exec_prefix/bin). This is used to determine the location of libusb
    57. 

  57. when building applications.  If you move libusb after installation,
    58. 

  58. it will be necessary to edit this file.
    59.