--------------------------------------------------------------------------------
                    _    _ ______                   _____
                   \ \  / (_____ \             _   (____ \
                    \ \/ / _____) ) ___   ___ | |_  _   \ \
                     )  ( (_____ ( / _ \ / _ \|  _)| |   | |
                    / /\ \      | | |_| | |_| | |__| |__/ /
                   /_/  \_\     |_|\___/ \___/ \___)_____/

--------------------------------------------------------------------------------

1. S U P P O R T E D   O P E R A T I N G   S Y S T E M S

   XRootD is supported on the following platforms:

  * RedHat Enterprise Linux 5 and 6 and derivatives (Scientific Linux)
    compiled with gcc
  * Solaris 10 compiled with SunCC
  * MacOSX 10.6 and 10.7 compiled with gcc or clang

2. B U I L D   I N S T R U C T I O N S

2.0 Build dependecies

  XRootD requires at minimum following packages (RHEL distro):

  * gcc-c++, cmake(3), krb5-devel, libuuid-devel, libxml2-devel, openssl-devel, systemd-devel, zlib-devel
  * devtoolset-7 (only RHEL7)

2.1 Build system

  XRootD uses CMake to handle the build process. It should build fine with
cmake 2.6, however, on some platforms, this version of cmake has problems
handling the perl libraries, therefore version 2.8 or newer is recommended.

2.2 Build parameters

  The build process supports the following parameters:

  * CMAKE_INSTALL_PREFIX - indicates where the XRootD files should be installed,
                           (default: /usr)
  * CMAKE_BUILD_TYPE     - type of the build: Release/Debug/RelWithDebInfo
  * FORCE_32BITS         - Force building 32 bit binaries when on Solaris AMD64
                           (default: FALSE)
  * ENABLE_PERL          - enable the perl bindings if possible (default: TRUE)
  * ENABLE_FUSE          - enable the fuse filesystem driver if possible
                           (default: TRUE)
  * ENABLE_CRYPTO        - enable the OpenSSL cryprography support (including
                           the X509 authentication) if possible (default: TRUE)
  * ENABLE_KRB5          - enable the Kerberos 5 authentication if possible
                           (default: TRUE)
  * ENABLE_READLINE      - enable the lib readline support in the commandline
                           utilities (default: TRUE)
  * OPENSSL_ROOT_DIR     - path to the root of the openssl installation if it
                           cannot be detected in a standard location
  * KERBEROS5_ROOT_DIR   - path to the root of the kerberos installation if it
                           cannot be detected in a standard location
  * READLINE_ROOT_DIR    - path to the root of the readline installation if it
                           cannot be detected in a standard location
  * CMAKE_C_COMPILER     - path to the c compiler that should be used
  * CMAKE_CXX_COMPILER   - path to the c++ compiler that should be used

2.3 Build steps

  * on RHEL7 only: scl enable devtoolset-7 /bin/bash

  * Create an empty build directory:

    mkdir build
    cd build

  * Generate the build system files using cmake, ie:

    cmake /path/to/the/xrootd/source -DCMAKE_INSTALL_PREFIX=/opt/xrootd \
                                     -DENABLE_PERL=FALSE

  * Build the source:

    make

  * Install the source:

    make install

3. P L A T F O R M   N O T E S

3.1 Solaris

  * On Solaris x86 the Sun Studio <= 12.1 compiler optimization algorithms
    are broken, only Debug build is supported. For the optimized mode upgrade
    the compiler to 12.2 or later.