The directory layout of icedb is customizable at build time. By default, icedb is entirely encapsulated in a single directory tree, and is usually installed to a location like “/usr/local/icedb”, “/opt/icedb” or “/your/home/directory/icedb”.
Top-level directory structure
- The “bin” directory contains all executable programs.
- The “include” directory contains all header files used for C and C++ development.
- The “lib” directory contains libraries, along with any linker-dependent modules needed to link your code to icedb.
- The “libexec” directory contains plugins. On certain platforms, such as Ubuntu, this directory is instead located under “lib”.
- The “share” directory contains examples, documentation and configuration files.
The “bin” directory
Programs are grouped into subfolders depending on build settings. So, if you build using g++ on Linux, with debugging symbols, then the programs are placed in bin/bin_x64_GNU/Debug. POSIX-compatible systems place shared libraries under “lib” (see below), but on the Microsoft Windows platform, shared libraries are placed in “bin”.
The “lib” directory
icedb libraries are stored in various subdirectories, depending on the build configuration. Multiple copies icedb are usually present; these copies were all built under different compiler options, possibly for different system architectures and using different compilers. These libraries are kept separate to avoid linking and runtime errors, as linking modules of code on any system is highly complex.
The “CMake” subdirectory is special - it contains configuration files that allow you to easily link your own code against icedb. For linking instructions, see the Linking Your Code with icedb page.