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 #4235 from ceph/wip-rbd-unit-tests

tests: exercise all RBD features during unit testing

Reviewed-by: Josh Durgin <>
latest commit 01b5085235
@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 pull request #3997 from ceph/wip-debian-mv-var-lib-ceph-mds
doc doc: fix the architecture diagram in cephfs.rst
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 Merge remote-tracking branch 'gh/hammer'
qa java: is in /usr/lib64 on rhel
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 #4235 from ceph/wip-rbd-unit-tests
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: Thomas Johnson affiliation
.organizationmap mailmap: Wuxingyi 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 doc/release-notes: more hammer release notes
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 tests: replace existing gtest 1.5.0 with gmock/gtest 1.7.0
NEWS doc/release-notes: more hammer release notes
PendingReleaseNotes doc/release-notes: more hammer release notes
README README: symlink from
README.cmake Combined CMake Build for Hammer fix the indent of a command line usage
README.xio xio: Update README.xio with dependencies
SubmittingPatches be gender neutral do not submodule --force if git does not support it fix _with_systemd conditional Merge pull request #3604 from yghannam/yazen-testing Fix so that -L is allowed
doc_deps.deb.txt doc: The dot package is included in graphviz package Merge pull request #3871 from dachary/wip-install-deps 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 natty, oneiric, and 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.