INSTALL

----------------------------------------------
The "Quite Boring" library Installation Guide
----------------------------------------------
Please read COPYING for a description of the licensing of this software.

---------------------------------
* Platforms Built and Tested On *
---------------------------------
libqb has been tested on:
Linux: Fedora
BSD: FreeBSD

It should build and run properly on the tested platforms as well as possibly
others with minimal effort.  libqb requires a coherent mmap() system call
and will not operate on platforms which don't support coherent mmap().

----------------------------
* Building from git *
----------------------------
When building and installing from git, automake 2.61 or later is
required.  Prior versions will result in build failures.

Step 1: check out a copy of the repository
https://github.com/ClusterLabs/libqb/

Find the version you want to build.  Usually this will be the "main"
branch.  If you want to build a specific released
version check 'git tag -l'.

Step 2: Generate the makefiles
balance: ./autogen.sh

Step 3: Run the configure script
Note that this will install to /usr by default to install to /usr/local use --prefix=/usr/local
balance: ./configure

Step 4: build
balance: make

Step 5: Install the binaries
balance: sudo make install

-------------------------
* Building from tarball *
-------------------------
The tarball is distributed with pregenerated makefiles.  There is no need
to run the autogen.sh script in this case.

Step 1: Run the configure script
balance:~/libqb% ./configure

Step 2: Install the binaries
balance:~/libqb% su
balance:~/libqb# make install