Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ceph is a distributed object, block, and file storage platform
C++ Perl6 C Shell Python Assembly Other
branch: master

Merge pull request #4380 from ceph/wip-nodebug-build

tests: separate check_PROGRAMS from TESTS

Reviewed-by: Josh Durgin <>
latest commit 69e3ec8a6b
@jdurgin jdurgin authored
Failed to load latest commit information.
admin doc: Switch doxygen integration back to breathe
ceph-erasure-code-corpus @ f1f95a1 erasure-code: workunit to check for encoding regression
ceph-object-corpus @ da43eb1 ceph-object-corpus: drop compat with old ObjectStore::Transaction
cmake/modules Combined CMake Build for Hammer
debian Merge remote-tracking branch 'gh/hammer'
doc releases: table of estimated end of life
examples rbd-replay: Convert to
fusetrace remove superfluous second semicolons at end of lines
keys keys: renew autobuild.asc key
m4 crc32c: add aarch64 optimized crc32c implementation
man man: enable warning msgs for "all" target
qa Merge pull request #4378 from dachary/wip-11359-tier-tests-disable
rpm Move fedora patch file (used by to rpm/ subdir
share ceph-post-file: single command to upload a file to cephdrop
src Merge pull request #4380 from ceph/wip-nodebug-build
systemd fix handling of /var/run/ceph
udev Rework ceph-disk to allow LUKS for encrypted partitions
.gitignore tests: replace existing gtest 1.5.0 with gmock/gtest 1.7.0
.gitmodule_mirrors .gitmodule_mirrors: add gmock.git mirror
.gitmodules ceph needs gmock/gtest to be statically linked
.mailmap mailmap: Zhi (David) Zhang affiliation
.organizationmap mailmap: Ian Kelling affiliation
.peoplemap Some sanitization work on .mailmap, .organizationmap, .peoplemap : So…
CMakeLists.txt cmake: add xio
CONTRIBUTING.rst doc: Add a contributing file at the root of repo
COPYING Add GPLv2 text file
COPYING-GPL2 Add GPLv2 text file
COPYING-LGPL2.1 COPYING: note licenses for all files, not just the default
ChangeLog first pass at autoconf and automake
CodingStyle Clarify CodingStyle with respect to tab compression of space runs
Doxyfile doc: do not doxygen src/tracing
INSTALL Update INSTALL to mention the submodules/recursive packaging: ship systemd/ceph.tmpfiles.d in tarballs
NEWS first pass at autoconf and automake
PendingReleaseNotes Update PendingReleaseNotes for firefly change, rgw socket path related
README README: symlink from
README.cmake Combined CMake Build for Hammer README: rm references to old Ubuntu distros
README.xio xio: Update README.xio with dependencies
SubmittingPatches be gender neutral do not submodule --force if git does not support it Merge pull request #3481 from ktdreyer/wip-rpm-rm-old-fedoras Merge remote-tracking branch 'gh/hammer' add missing '--without-lttng' option to usage
doc_deps.deb.txt doc: The dot package is included in graphviz package Debian GNU/Linux wheezy needs backports debian: create a repository from sources
pom.xml update license for libcephfs git --ancestry-path is not backward compatible

Ceph - a scalable distributed storage system

Please see for current info.

Contributing Code

Most of Ceph is licensed under the LGPL version 2.1. Some miscellaneous code is under BSD-style license or is public domain. The documentation is licensed under Creative Commons Attribution-ShareAlike (CC BY-SA). There are a handful of headers included here that are licensed under the GPL. Please see the file COPYING for a full inventory of licenses by file.

Code contributions must include a valid "Signed-off-by" acknowledging the license for the modified or contributed file. Please see the file SubmittingPatches for details on what that means and on how to generate and submit patches.

We do not require assignment of copyright to contribute code; code is contributed under the terms of the applicable license.

Build Prerequisites


The list of debian packages dependencies can be installed with:


Note: libsnappy-dev and libleveldb-dev are not available upstream for Debian Squeeze. Backports for Ceph can be found at


The list of RPM packages dependencies can be installed with:


Building Ceph

Developers, please refer to the Developer Guide for more information, otherwise, you can build the server daemons, and FUSE client, by executing the following:


(Note that the FUSE client will only be built if libfuse is present.)


The configure script will complain about any missing dependencies as it goes. You can also refer to debian/control or for the package build dependencies on those platforms. In many cases, dependencies can be avoided with --with-foo or --without-bar switches. For example,

./configure --with-nss         # use libnss instead of libcrypto++
./configure --without-radosgw  # do not build radosgw
./configure --without-tcmalloc # avoid google-perftools dependency

Building packages

You can build packages for Debian or Debian-derived (e.g., Ubuntu) systems with

sudo apt-get install dpkg-dev
dpkg-checkbuilddeps        # make sure we have all dependencies

For RPM-based systems (Red Hat, SUSE, etc.),


Building the Documentation


The list of package dependencies for building the documentation can be found in doc_deps.deb.txt:

sudo apt-get install `cat doc_deps.deb.txt`

Building the Documentation

To build the documentation, ensure that you are in the top-level `/ceph directory, and execute the build script. For example:

Something went wrong with that request. Please try again.