linux-toradex.git/Documentation/ABI/testing/sysfs-bus-rbd, branch v3.7.2

rbd: add an rbd features field

2012-10-01T19:30:53+00:00

Record the features values for each rbd image and each of its
snapshots.  This is really something that only becomes meaningful
for version 2 images, so this is just putting in place code
that will form common infrastructure.

It may be useful to expand the sysfs entries--and therefore the
information we maintain--for the image and for each snapshot.
But I'm going to hold off doing that until we start making
active use of the feature bits.

Signed-off-by: Alex Elder 
Reviewed-by: Josh Durgin

rbd: kill create_snap sysfs entry

2012-10-01T19:30:53+00:00

Josh proposed the following change, and I don't think I could
explain it any better than he did:

    From: Josh Durgin 
    Date: Tue, 24 Jul 2012 14:22:11 -0700
    To: ceph-devel 
    Message-ID: <500F1203.9050605@inktank.com>

    Right now the kernel still has one piece of rbd management
    duplicated from the rbd command line tool: snapshot creation.
    There's nothing special about snapshot creation that makes it
    advantageous to do from the kernel, so I'd like to remove the
    create_snap sysfs interface.  That is,
	/sys/bus/rbd/devices//create_snap
    would be removed.

    Does anyone rely on the sysfs interface for creating rbd
    snapshots?  If so, how hard would it be to replace with:

	rbd snap create pool/image@snap

    Is there any benefit to the sysfs interface that I'm missing?

    Josh

This patch implements this proposal, removing the code that
implements the "snap_create" sysfs interface for rbd images.
As a result, quite a lot of other supporting code goes away.

Suggested-by: Josh Durgin 
Signed-off-by: Alex Elder 
Reviewed-by: Josh Durgin

rbd: define rbd_dev_image_id()

2012-10-01T19:30:53+00:00

New format 2 rbd images are permanently identified by a unique image
id.  Each rbd image also has a name, but the name can be changed.
A format 2 rbd image will have an object--whose name is based on the
image name--which maps an image's name to its image id.

Create a new function rbd_dev_image_id() that checks for the
existence of the image id object, and if it's found, records the
image id in the rbd_device structure.

Create a new rbd device attribute (/sys/bus/rbd//image_id) that
makes this information available.

Signed-off-by: Alex Elder 
Reviewed-by: Josh Durgin

rbd: create pool_id device attribute

2012-07-30T16:30:00+00:00

Add an entry under /sys/bus/rbd/devices// named "pool_id" that
provides the id for the pool the rbd image is assocatied with.  This
is in addition to the pool name already provided.

Rename the "poolid" field in struct rbd_device  to be "pool_id".

Update the documentation to reflect the addition of this new entry.

Signed-off-by: Alex Elder 
Reviewed-by: Josh Durgin

rbd: correct sysfs snap attribute documentation

2012-05-14T17:13:14+00:00

Each attribute is prefixed with "snap_".

Signed-off-by: Josh Durgin 
Reviewed-by: Alex Elder 
Reviewed-by: Yehuda Sadeh

rbd: remove buggy rollback functionality

2011-12-07T18:46:19+00:00

This doesn't interact with resizing well, since it doesn't set the
size of the device to the size at the snapshot. It's also an expensive
operation to be synchronous. Rollback can still be done with the
userspace rbd tool.

Signed-off-by: Josh Durgin

rbd: update email address in Documentation

2011-03-21T22:06:50+00:00

Signed-off-by: Sage Weil

rbd: replace the rbd sysfs interface

2010-12-01T23:53:22+00:00

The new interface creates directories per mapped image
and under each it creates a subdir per available snapshot.
This allows keeping a cleaner interface within the sysfs
guidelines. The ABI documentation was updated too.

Acked-by: Greg Kroah-Hartman 
Signed-off-by: Yehuda Sadeh 
Signed-off-by: Sage Weil