Changes in sysfs-bus-rbd

54a19b4d - docs: ABI: cleanup several ABI documents

Fri, 30 Oct 2020 07:40:50 +0000

docs: ABI: cleanup several ABI documentsThere are some ABI documents that, while they don't generateany warnings, they have issues when parsed by get_abi.pl scripton its output result.Address them, in order to provide a clean output.Reviewed-by: Tom Rix # for fpga-managerReviewed-By: Kajol Jain # for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7Acked-by: Jonathan Cameron #for IIOAcked-by: Oded Gabbay # for HabanalabsAcked-by: Vaibhav Jain # for sysfs-bus-papr-pmemAcked-by: Cezary Rojewski # for catptAcked-by: Suzuki K Poulose Acked-by: Ilya Dryomov # for rbdAcked-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/5bc78e5b68ed1e9e39135173857cb2e753be868f.1604042072.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

bd15134a - block: rbd: update sysfs interface

Fri, 23 Feb 2018 10:19:59 +0000

block: rbd: update sysfs interfaceThe existing sysfs interface has been updated to be in the same formatas described in Documentation/ABI/README. This will be useful forscripting and tracking changes in the ABI. Attributes have been groupedby functionality and/or the date on which they were added.There are a couple of more changes:- The attributes have been annotated with file permissions RO/RW/WO.- Added description of the bus attribute supported_featuresSigned-off-by: Aishwarya Pant Signed-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

0276dca6 - rbd: add force close option

Thu, 18 Aug 2016 16:38:45 +0000

rbd: add force close optionThis adds a force close option, so we can force the unmappingof a rbd device that is open. If a path/device is blacklisted, appslike multipathd can map a new device and then unmap the old one.The unmapping cleanup would then be handled by the generic hotunplugcode paths in multipahd like is done for iSCSI, FC/FCOE, SAS, etc.Signed-off-by: Mike Christie Signed-off-by: Ilya Dryomov List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

0d6d1e9c - rbd: add 'config_info' sysfs rbd device attribute

Thu, 18 Aug 2016 16:38:45 +0000

rbd: add 'config_info' sysfs rbd device attributeExport the info used to setup the rbd image, so it can be used to remapthe image.Signed-off-by: Mike Christie [idryomov@gmail.com: do_rbd_add() EH]Signed-off-by: Ilya Dryomov List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

92a58671 - rbd: add 'snap_id' sysfs rbd device attribute

Thu, 18 Aug 2016 16:38:44 +0000

rbd: add 'snap_id' sysfs rbd device attributeExport snap id in sysfs, so tools like multipathd can use it in a uuid.Signed-off-by: Mike Christie Signed-off-by: Ilya Dryomov List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

267fb90b - rbd: add 'cluster_fsid' sysfs rbd device attribute

Thu, 18 Aug 2016 16:38:43 +0000

rbd: add 'cluster_fsid' sysfs rbd device attributeExport the cluster fsid, so tools like udev and multipath-tools can useit for part of the uuid.Signed-off-by: Mike Christie Signed-off-by: Ilya Dryomov List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

005a07bf - rbd: add 'client_addr' sysfs rbd device attribute

Thu, 18 Aug 2016 16:38:43 +0000

rbd: add 'client_addr' sysfs rbd device attributeExport client addr/nonce, so userspace can check if a image is beingblacklisted.Signed-off-by: Mike Christie [idryomov@gmail.com: ceph_client_addr(), endianess fix]Signed-off-by: Ilya Dryomov List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

ff96128f - rbd: show the entire chain of parent images

Tue, 22 Jul 2014 17:53:07 +0000

rbd: show the entire chain of parent imagesMake /sys/bus/rbd/devices//parent show the entire chain of parentimages. While at it, kernel sprintf() doesn't return negative values,casting to unsigned long long is no longer necessary and there is nogood reason to split into multiple sprintf() calls.Signed-off-by: Ilya Dryomov Reviewed-by: Alex Elder List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

9b60e70b - rbd: add support for single-major device number allocation scheme

Fri, 13 Dec 2013 13:28:57 +0000

rbd: add support for single-major device number allocation schemeCurrently each rbd device is allocated its own major number, whichleads to a hard limit of 230-250 images mapped at once. This commitadds support for a new single-major device number allocation scheme,which is hidden behind a new single_major boolean module parameter andis disabled by default for backwards compatibility reasons. (Olduserspace cannot correctly unmap images mapped under single-majorscheme and would essentially just unmap a random image, if that.)$ rbd showmappedid pool image snap device0 rbd b100 - /dev/rbd01 rbd b101 - /dev/rbd12 rbd b102 - /dev/rbd23 rbd b103 - /dev/rbd3Old scheme (modprobe rbd):$ ls -l /dev/rbd*brw-rw---- 1 root disk 253, 0 Dec 10 12:24 /dev/rbd0brw-rw---- 1 root disk 252, 0 Dec 10 12:28 /dev/rbd1brw-rw---- 1 root disk 252, 1 Dec 10 12:28 /dev/rbd1p1brw-rw---- 1 root disk 252, 2 Dec 10 12:28 /dev/rbd1p2brw-rw---- 1 root disk 252, 3 Dec 10 12:28 /dev/rbd1p3brw-rw---- 1 root disk 251, 0 Dec 10 12:28 /dev/rbd2brw-rw---- 1 root disk 251, 1 Dec 10 12:28 /dev/rbd2p1brw-rw---- 1 root disk 250, 0 Dec 10 12:24 /dev/rbd3New scheme (modprobe rbd single_major=Y):$ ls -l /dev/rbd*brw-rw---- 1 root disk 253, 0 Dec 10 12:30 /dev/rbd0brw-rw---- 1 root disk 253, 256 Dec 10 12:30 /dev/rbd1brw-rw---- 1 root disk 253, 257 Dec 10 12:30 /dev/rbd1p1brw-rw---- 1 root disk 253, 258 Dec 10 12:30 /dev/rbd1p2brw-rw---- 1 root disk 253, 259 Dec 10 12:30 /dev/rbd1p3brw-rw---- 1 root disk 253, 512 Dec 10 12:30 /dev/rbd2brw-rw---- 1 root disk 253, 513 Dec 10 12:30 /dev/rbd2p1brw-rw---- 1 root disk 253, 768 Dec 10 12:30 /dev/rbd3(major 253 was assigned dynamically at module load time)The new limit is 4096 images mapped at once, and it comes from the factthat, as before, 256 minor numbers are reserved for each mapping.(A follow-up commit changes the number of minors reserved and the waywe deal with partitions over that number.)If single_major is set to true, two new sysfs interfaces show up:/sys/bus/rbd/{add,remove}_single_major. These are to be used insteadof /sys/bus/rbd/{add,remove}, which are disabled for backwardscompatibility reasons outlined above.Signed-off-by: Ilya Dryomov Reviewed-by: Alex Elder Reviewed-by: Josh Durgin List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

dd82fff1 - rbd: add 'minor' sysfs rbd device attribute

Fri, 13 Dec 2013 13:28:57 +0000

rbd: add 'minor' sysfs rbd device attributeIntroduce /sys/bus/rbd/devices//minor sysfs attribute for exportingrbd whole disk minor numbers. This is a step towards single-majordevice number allocation scheme, but also a good thing on its own.Signed-off-by: Ilya Dryomov Reviewed-by: Alex Elder Reviewed-by: Josh Durgin List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

3e83b65b - rbd: don't create sysfs entries for non-mapped snapshots

Tue, 23 Apr 2013 18:52:53 +0000

rbd: don't create sysfs entries for non-mapped snapshotsWhen an rbd image gets mapped a device entry gets created for itunder /sys/bus/rbd/devices//. Inside that directory there aresysfs files that contain information about the image: its size,feature bits, major device number, and so on.Additionally, if that image has any snapshots, a device entry getscreated for each of those as a "child" of the mapped device. Eachof these is a subdirectory of the mapped device, and each directorycontains a few files with information about the snapshot (itssnapshot id, size, and feature mask).There is no clear benefit to having those device entries for thesnapshots. The information provided via sysfs of of little realvalue--and all of it is available via rbd CLI commands. If westill wanted to see the kernel's view of this information it couldbe done much more simply by including it in a single sysfs file forthe mapped image.But there *is* a clear cost to supporting them. Every time a snapshotcontext changes, these entries need to be updated (deleted snapshotsremoved, new snapshots created). The rbd driver is notified ofchanges to the snapshot context via callbacks from an osd, and caremust be taken to coordinate removal of snapshot data structureswith the possibility of one these notifications occurring.Things would be considerably simpler if we just didn't have tomaintain device entries for the snapshots.So get rid of them.The ability to map a snapshot of an rbd image will remain; the onlything lost will be the ability to query these sysfs directories forinformation about snapshots of mapped images.This resolves: http://tracker.ceph.com/issues/4796Signed-off-by: Alex Elder Reviewed-by: Josh Durgin List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

86b00e0d - rbd: get parent spec for version 2 images

Fri, 26 Oct 2012 04:34:42 +0000

rbd: get parent spec for version 2 imagesAdd support for getting the the information identifying the parentimage for rbd images that have them. The child image holds areference to its parent image specification structure. Create a newentry "parent" in /sys/bus/rbd/image/N/ to report the identifyinginformation for the parent image, if any.Signed-off-by: Alex Elder Reviewed-by: Josh Durgin List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

34b13184 - rbd: add an rbd features field

Sat, 14 Jul 2012 01:35:12 +0000

rbd: add an rbd features fieldRecord the features values for each rbd image and each of itssnapshots. This is really something that only becomes meaningfulfor version 2 images, so this is just putting in place codethat will form common infrastructure.It may be useful to expand the sysfs entries--and therefore theinformation we maintain--for the image and for each snapshot.But I'm going to hold off doing that until we start makingactive use of the feature bits.Signed-off-by: Alex Elder Reviewed-by: Josh Durgin List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

02cdb02c - rbd: kill create_snap sysfs entry

Fri, 10 Aug 2012 20:12:10 +0000

rbd: kill create_snap sysfs entryJosh proposed the following change, and I don't think I couldexplain 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? JoshThis patch implements this proposal, removing the code thatimplements 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 List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

589d30e0 - rbd: define rbd_dev_image_id()

Wed, 11 Jul 2012 01:30:11 +0000

rbd: define rbd_dev_image_id()New format 2 rbd images are permanently identified by a unique imageid. 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 theimage name--which maps an image's name to its image id.Create a new function rbd_dev_image_id() that checks for theexistence of the image id object, and if it's found, records theimage id in the rbd_device structure.Create a new rbd device attribute (/sys/bus/rbd//image_id) thatmakes this information available.Signed-off-by: Alex Elder Reviewed-by: Josh Durgin List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

9bb2f334 - rbd: create pool_id device attribute

Thu, 12 Jul 2012 15:46:35 +0000

rbd: create pool_id device attributeAdd an entry under /sys/bus/rbd/devices// named "pool_id" thatprovides the id for the pool the rbd image is assocatied with. Thisis 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 List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

b7f6519e - rbd: correct sysfs snap attribute documentation

Thu, 01 Dec 2011 23:12:03 +0000

rbd: correct sysfs snap attribute documentationEach attribute is prefixed with "snap_".Signed-off-by: Josh Durgin Reviewed-by: Alex Elder Reviewed-by: Yehuda Sadeh List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

51703306 - rbd: remove buggy rollback functionality

Mon, 24 Oct 2011 23:28:27 +0000

rbd: remove buggy rollback functionalityThis doesn't interact with resizing well, since it doesn't set thesize of the device to the size at the snapshot. It's also an expensiveoperation to be synchronous. Rollback can still be done with theuserspace rbd tool.Signed-off-by: Josh Durgin List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

55b00bae - rbd: update email address in Documentation

Mon, 21 Mar 2011 22:06:50 +0000

rbd: update email address in DocumentationSigned-off-by: Sage Weil List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd

dfc5606d - rbd: replace the rbd sysfs interface

Fri, 19 Nov 2010 22:51:04 +0000

rbd: replace the rbd sysfs interfaceThe new interface creates directories per mapped imageand under each it creates a subdir per available snapshot.This allows keeping a cleaner interface within the sysfsguidelines. The ABI documentation was updated too.Acked-by: Greg Kroah-Hartman Signed-off-by: Yehuda Sadeh Signed-off-by: Sage Weil List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-rbd