INSTALL

   1 Installation instructions
   2 =========================
   3
   4 The Btrfs utility programs require the following libraries/tools to build:
   5
   6 - libuuid - provided by util-linux, e2fsprogs/e2fslibs or libuuid
   7 - libblkid - block device id library
   8 - liblzo2 - LZO data compression library
   9 - zlib - ZLIB data compression library
  10
  11 For the btrfs-convert utility:
  12
  13 - e2fsprogs - ext2/ext3/ext4 file system libraries, or called e2fslibs
  14
  15 Generating documentation:
  16
  17 - asciidoc - text document format tool
  18 - xmlto - text document format tool
  19
  20 XATTR library should be provided by the standard C library or by
  21
  22 - libattr - extended attribute library
  23
  24 Please note that the package names may differ according to the distribution.
  25 See https://btrfs.wiki.kernel.org/index.php/Btrfs_source_repositories#Dependencies .
  26
  27 To build from git sources you need to generate the confiture script using the
  28 autools:
  29
  30  $ ./autogen.sh
  31
  32 To build from the released tarballs:
  33
  34  $ ./configure
  35  $ make
  36  $ make install
  37
  38 You may disable building some parts like documentation, btrfs-convert or
  39 backtrace support. See ./configure --help for more.
  40
  41 Specific CFLAGS or LDFLAGS should be set like
  42
  43  $ CFLAGS=... LDFLAGS=... ./configure --prefix=/usr
  44
  45 and not as arguments to make.
  46
  47 References:
  48 * https://btrfs.wiki.kernel.org