Installation

Overview
Source Files
Building with Boost.Build

Overview

Most components of the Iostreams library are defined entirely in header files, and can be used simply by including the appropriate headers; a few components, however, rely on separate source files. In addition, the compression filters rely on the third-party libraryes zlib and libbz2.

Instructions for obtaining

There are two ways to use these components:

Source Files

In addition:

  1. The regular expression Filters rely on the Boost Regular Expression Library ([Maddock]), which must be built separately. See here for details.
  2. The memory-mapped file Devices rely on the implementation file <libs/iostreams/src/memmap.cpp>.
  3. The file descriptor file Devices rely on the implementation file <libs/iostreams/src/file_descriptor.cpp>.
  4. The zlib and gzip Filters rely on the implementation file <libs/iostreams/src/zlib.cpp>, and depend on the non-boost library zlib ([Gailly]). See here for details on obtaining zlib binaries.
  5. The bzip2 Filters rely on the implementation file <libs/iostreams/src/bzip2.cpp>, and and depend on the non-boost library libbz2 ([Seward]). See here for details on obtaining libbz2 binaries.

Building with Boost.Build

Once the zlib and libbz2 binaries are obtained, the entire Iostreams library can be built using the Boost Build System.

The Jamfile included with the Iostreams library is sensitive to the following environment variables.

VariableInterpretationDefault
ZLIB_DYN_LINK Indicates that the zlib and gzip Filters should link to zlib dynamically. -
ZLIB_PATH Search path for the zlib library file. -
ZLIB_BINARY Name of the zlib library file, minus file extension. zlib
LIBBZ2_PATH Search path for the libbz library file. -
LIBBZ2_BINARY Name of the libbz2 library file, minus file extension. libbz
NO_ZLIB Set to indicate that the zlib and gzip Filters should not be built. -
NO_LIBBZ2 Set to indicate that the bzip2 Filters should not be built. -
NO_COMPRESSION Set to indicate that none of the compression Filters should be built. -