Ceph is a distributed object, block, and file storage platform
Go to file
Loic Dachary c7daaaf5e6 erasure-code: implement alignment on chunk sizes
jerasure expects chunk sizes that are aligned on the largest possible
vector size that could be used by SSE instructions, when available (
LARGEST_VECTOR_WORDSIZE == 16 bytes ).

For techniques derived from Cauchy, encoding and decoding is done by
subdividing the chunk into packets of packetsize bytes. The operations
are done w * packetsize bytes at a time. It follows that each chunk must
have a size that is a multiple of w * packetsize bytes.

For techniques derived from Vandermonde, it is enough for a chunk to be
a multiple of w * LARGEST_VECTOR_WORDSIZE.

ErasureCodeJerasure::get_alignment returns a size alignment constraint
that has to be enforced as a multiple of the object size. The resulting
object size then has to match the chunk constraints described above
although they have no relationship with K. For Cauchy, it leads to
excessive padding, making it impossible to set sensible parameters for
when the object size is small.

When the per_chunk_alignement data member is true, the semantic of
ErasureCodeJerasure::get_alignment is changed to return a size alignment
constraint to be enforced as a multiple of the chunk size. The
ErasureCodeJerasure::get_chunk_size method is modified to use the new
semantic when appropriate.

The jerasure-per-chunk-alignement parameter is parsed to set
per_chunk_alignement for the Vandermonde and Cauchy techniques.

The memory address of a chunk is implicitly aligned to a page boundary
because it is allocated with buffer::create_page_aligned.

http://tracker.ceph.com/issues/8475 Fixes: #8475

Signed-off-by: Loic Dachary <loic@dachary.org>
2014-08-04 10:54:21 +02:00
admin be nitpicky about missing references 2014-03-24 13:01:38 -04:00
ceph-object-corpus@bb3cee6b85 ceph-object-corpus: rebase onto firefly corpus 2014-05-03 07:59:28 -07:00
debian debian, rpm: build rocksdb statically if we can 2014-07-31 21:11:25 -07:00
doc doc/release-notes: fix syntax error 2014-08-01 21:19:26 -07:00
examples/librados examples: add a librados/hello_world program 2013-08-19 14:55:09 -07:00
fusetrace remove superfluous second semicolons at end of lines 2014-05-08 10:09:25 +02:00
keys keys: renew autobuild.asc key 2013-02-07 22:31:40 -08:00
m4 configure: verify c++11 is present for rocksdb 2014-07-31 21:11:24 -07:00
man Merge pull request #2074 from onlyjob/docs 2014-07-07 09:07:04 -07:00
qa qa/workunits/cephtool/test_daemon.sh: verify ceph -c works with daemon 2014-07-30 14:52:48 -07:00
share ceph-post-file: single command to upload a file to cephdrop 2013-08-16 17:59:11 -07:00
src erasure-code: implement alignment on chunk sizes 2014-08-04 10:54:21 +02:00
systemd init: add systemd service files 2014-07-22 11:30:55 -04:00
udev udev: /dev/disk/by-parttypeuuid/$type-$uuid 2013-06-17 09:49:53 -07:00
wireshark add gitignore for wireshark subdir to track *.patch only here 2014-05-11 12:24:44 +02:00
.gitignore .gitignore: ignore files generated by ctags on topdir 2014-05-11 12:26:29 +02:00
.gitmodule_mirrors add rocksdb submodule 2014-07-29 21:45:25 -07:00
.gitmodules add rocksdb submodule 2014-07-29 21:45:25 -07:00
.mailmap mailmap: Dmitry Smirnov name normalization 2014-06-20 10:23:15 +02:00
.organizationmap mailmap: koleosfuscus affiliation 2014-06-20 10:23:15 +02:00
AUTHORS AUTHORS 2014-07-17 21:33:22 -07:00
autogen.sh autogen.sh: debug with -x 2014-07-31 21:11:25 -07:00
ceph.spec.in debian, rpm: build rocksdb statically if we can 2014-07-31 21:11:25 -07:00
ChangeLog
CodingStyle
configure.ac Merge pull request #2180 from ceph/wip-ec-isa 2014-08-01 10:00:23 -07:00
COPYING Merge pull request #638 from ceph/wip-bloom 2013-10-03 12:13:41 -07:00
COPYING-LGPL2.1
deps.deb.txt add rocksdb bz2 dep 2014-07-31 21:11:24 -07:00
deps.rpm.txt add rocksdb bz2 dep 2014-07-31 21:11:24 -07:00
do_autogen.sh do_autogen.sh: build with static librocksdb 2014-07-31 21:11:24 -07:00
doc_deps.deb.txt README: move package dependencies into separate files 2014-05-20 21:56:05 -07:00
Doxyfile
INSTALL Update INSTALL to mention the submodules/recursive 2014-05-31 11:22:41 +02:00
Makefile.am Populate ChangeLog when distribute 2014-06-05 17:33:53 +02:00
NEWS
PendingReleaseNotes doc/release-notes: v0.83 2014-07-29 16:53:09 -07:00
README Automagically setup submodules on first run. 2014-07-03 00:51:23 +02:00
SubmittingPatches SubmittingPatches: clarify "github fork" in preference to "clone" 2014-03-06 21:11:18 -08:00

============================================
Ceph - a scalable distributed storage system
============================================

Please see http://ceph.com/ 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.


Building Ceph
=============

To build the server daemons, and FUSE client, execute the following:

	./autogen.sh
	./configure
	make

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

Dependencies
------------

The configure script will complain about any missing dependencies as
it goes.  You can also refer to debian/control or ceph.spec.in 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
	dpkg-buildpackage

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

	rpmbuild


Build Prerequisites
===================

debian-based
------------

The list of debian package dependencies can be found in deps.deb.txt:

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

Note: libsnappy-dev and libleveldb-dev are not available upstream for natty, oneiric, and squeeze.  Backports for Ceph can be found at ceph.com/debian-leveldb.

rpm-based
---------

The list of RPM package dependencies can be found in deps.rpm.txt:

	sudo yum install `cat deps.rpm.txt`


Building the Documentation
==========================

Prerequisites
-------------

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:

	admin/build-doc