linux_dsm_epyc7002/Documentation/ABI/testing
Alex Elder 3e83b65bb9 rbd: don't create sysfs entries for non-mapped snapshots
When an rbd image gets mapped a device entry gets created for it
under /sys/bus/rbd/devices/<id>/.  Inside that directory there are
sysfs 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 gets
created for each of those as a "child" of the mapped device.  Each
of these is a subdirectory of the mapped device, and each directory
contains a few files with information about the snapshot (its
snapshot id, size, and feature mask).

There is no clear benefit to having those device entries for the
snapshots.  The information provided via sysfs of of little real
value--and all of it is available via rbd CLI commands.  If we
still wanted to see the kernel's view of this information it could
be done much more simply by including it in a single sysfs file for
the mapped image.

But there *is* a clear cost to supporting them.  Every time a snapshot
context changes, these entries need to be updated (deleted snapshots
removed, new snapshots created).  The rbd driver is notified of
changes to the snapshot context via callbacks from an osd, and care
must be taken to coordinate removal of snapshot data structures
with the possibility of one these notifications occurring.

Things would be considerably simpler if we just didn't have to
maintain device entries for the snapshots.

So get rid of them.

The ability to map a snapshot of an rbd image will remain; the only
thing lost will be the ability to query these sysfs directories for
information about snapshots of mapped images.

This resolves:
    http://tracker.ceph.com/issues/4796

Signed-off-by: Alex Elder <elder@inktank.com>
Reviewed-by: Josh Durgin <josh.durgin@inktank.com>
2013-05-01 21:19:25 -07:00
..
configfs-spear-pcie-gadget
debugfs-ec
debugfs-ideapad
debugfs-olpc x86/olpc: Add debugfs interface for EC commands 2012-03-27 20:54:52 +02:00
debugfs-pfo-nx-crypto powerpc/crypto: debugfs routines and docs for the nx device driver 2012-05-16 15:05:45 +10:00
debugfs-pktcdvd
dev-kmsg doc: fix quite a few typos within Documentation 2012-11-19 14:28:24 +01:00
evm
ima_policy ima: add policy support for file system uuid 2013-02-06 10:40:29 -05:00
procfs-diskstats
pstore pstore: Create a convenient mount point for pstore 2013-02-12 13:07:22 -08:00
sysfs-ata
sysfs-block block: Implement support for WRITE SAME 2012-09-20 14:31:45 +02:00
sysfs-block-dm dm: document sysfs entries 2012-03-28 18:41:23 +01:00
sysfs-block-rssd mtip32xx: Remove 'registers' and 'flags' from sysfs 2012-06-05 09:13:48 +02:00
sysfs-block-zram Documentation: Add newline at end-of-file to files lacking one 2012-07-20 23:10:28 +02:00
sysfs-bus-bcma
sysfs-bus-css
sysfs-bus-event_source-devices-events perf: Document the ABI of perf sysfs entries 2013-01-31 13:07:51 -03:00
sysfs-bus-event_source-devices-format perf: Adding sysfs group format attribute for pmu device 2012-03-16 14:06:06 -03:00
sysfs-bus-fcoe libfcoe, fcoe, bnx2fc: Add new fcoe control interface 2012-12-14 10:38:54 -08:00
sysfs-bus-hsi HSI: Add HSI ABI documentation 2012-04-23 14:23:32 +03:00
sysfs-bus-i2c-devices-fsa9480
sysfs-bus-i2c-devices-hm6352
sysfs-bus-i2c-devices-lm3533 mfd: Remove lm3533 boost attributes 2012-05-20 17:27:01 +02:00
sysfs-bus-iio iio: Add pressure channel type 2012-11-20 21:26:38 +00:00
sysfs-bus-iio-frequency-ad9523 iio: frequency: New driver for AD9523 SPI Low Jitter Clock Generator 2012-06-04 21:19:05 -07:00
sysfs-bus-iio-frequency-adf4350 iio: frequency: New driver for Analog Devices ADF4350/ADF4351 Wideband Synthesizers 2012-06-04 21:19:40 -07:00
sysfs-bus-iio-light-lm3533-als iio: cleanup sysfs-bus-iio-light-lm3533-als 2012-06-15 14:39:18 -07:00
sysfs-bus-iio-mpu6050 Invensense MPU6050 Device Driver. 2013-02-10 17:42:43 +00:00
sysfs-bus-mdio phylib: mdio: Add sysfs attribute for PHY identifiers. 2012-11-09 16:38:15 -05:00
sysfs-bus-media
sysfs-bus-pci PCI: SRIOV control and status via sysfs (documentation) 2012-11-28 11:25:47 -07:00
sysfs-bus-pci-devices-cciss
sysfs-bus-pci-drivers-ehci_hcd
sysfs-bus-rbd rbd: don't create sysfs entries for non-mapped snapshots 2013-05-01 21:19:25 -07:00
sysfs-bus-rpmsg rpmsg: add virtio-based remote processor messaging bus 2012-02-08 22:53:58 +02:00
sysfs-bus-umc
sysfs-bus-usb usb: Add "portX/connect_type" attribute to expose usb port's connect type 2013-01-20 16:09:53 -08:00
sysfs-bus-usb-devices-usbsevseg Documentation: Add newline at end-of-file to files lacking one 2012-07-20 23:10:28 +02:00
sysfs-c2port
sysfs-cfq-target-latency Documentation: Add sysfs ABI change for cfq's target latency. 2012-04-01 14:33:40 -07:00
sysfs-class driver-core: documentation: fix up Greg's email address 2012-02-15 14:48:01 -08:00
sysfs-class-backlight-driver-adp8870 Documentation: Add newline at end-of-file to files lacking one 2012-07-20 23:10:28 +02:00
sysfs-class-backlight-driver-lm3533 backlight: add LM3533 backlight driver 2012-05-29 16:22:29 -07:00
sysfs-class-bdi bdi: allow block devices to say that they require stable page writes 2013-02-21 17:22:19 -08:00
sysfs-class-devfreq PM / devfreq: Add sysfs node to expose available governors 2012-11-20 18:46:24 +09:00
sysfs-class-extcon extcon: fix typos in sys-class-extcon 2012-09-05 12:18:11 -07:00
sysfs-class-lcd
sysfs-class-led
sysfs-class-led-driver-lm3533 leds: add LM3533 LED driver 2012-05-29 16:22:32 -07:00
sysfs-class-mtd mtd: ABI documentation: clarification of bitflip_threshold 2012-07-06 15:10:06 +01:00
sysfs-class-net-batman-adv batman-adv: sysfs documentation should keep alphabetical order 2012-11-21 12:34:50 +01:00
sysfs-class-net-grcan can: grcan: Add device driver for GRCAN and GRHCAN cores 2012-11-15 20:47:26 +01:00
sysfs-class-net-mesh batman-adv: sysfs documentation should keep alphabetical order 2012-11-21 12:34:50 +01:00
sysfs-class-pktcdvd
sysfs-class-power
sysfs-class-regulator regulator: core: Support bypass mode 2012-09-10 11:25:10 +08:00
sysfs-class-rtc-rtc0-device-rtc_calibration rtc/ab8500: add calibration attribute to AB8500 RTC 2012-01-10 16:30:52 -08:00
sysfs-class-scsi_host
sysfs-class-uwb_rc
sysfs-class-uwb_rc-wusbhc
sysfs-dev
sysfs-devices driver-core: documentation: fix up Greg's email address 2012-02-15 14:48:01 -08:00
sysfs-devices-edac Edac: Add ABI Documentation for the new device nodes 2012-06-11 13:23:47 -03:00
sysfs-devices-firmware_node ACPI: Add new sysfs interface to export device description 2012-10-06 15:52:16 -04:00
sysfs-devices-memory
sysfs-devices-mmc
sysfs-devices-platform-_UDC_-gadget
sysfs-devices-platform-docg3 Documentation: add sysfs entries for mtd docg3 chips 2012-01-09 18:12:17 +00:00
sysfs-devices-platform-sh_mobile_lcdc_fb fbdev: sh_mobile_lcdc: Implement overlays support 2012-06-20 10:02:54 +02:00
sysfs-devices-power Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial 2012-12-13 12:00:02 -08:00
sysfs-devices-power_resources_D0 ACPI / PM: Expose lists of device power resources to user space 2013-01-25 21:51:32 +01:00
sysfs-devices-power_resources_D1 ACPI / PM: Expose lists of device power resources to user space 2013-01-25 21:51:32 +01:00
sysfs-devices-power_resources_D2 ACPI / PM: Expose lists of device power resources to user space 2013-01-25 21:51:32 +01:00
sysfs-devices-power_resources_D3hot ACPI / PM: Expose lists of device power resources to user space 2013-01-25 21:51:32 +01:00
sysfs-devices-power_state ACPI / PM: Expose power states of ACPI devices to user space 2013-01-24 12:49:59 +01:00
sysfs-devices-real_power_state ACPI / PM: Expose power states of ACPI devices to user space 2013-01-24 12:49:59 +01:00
sysfs-devices-resource_in_use ACPI / PM: Expose current status of ACPI power resources 2013-01-24 12:50:09 +01:00
sysfs-devices-soc Documentation: add information for new sysfs soc bus functionality 2012-02-10 11:42:25 -08:00
sysfs-devices-sun ACPI: create _SUN sysfs file 2012-11-16 02:56:59 +01:00
sysfs-devices-system-cpu Revert "Documentation: ABI: /sys/devices/system/cpu/cpu#/node" 2013-01-03 10:53:40 +01:00
sysfs-devices-system-ibm-rtl
sysfs-devices-system-xen_cpu xen/pcpu: Xen physical cpus online/offline sys interface 2012-07-19 15:51:39 -04:00
sysfs-driver-hid
sysfs-driver-hid-lenovo-tpkbd HID: Driver for Lenovo Keyboard with Trackpoint 2012-06-08 10:44:10 +02:00
sysfs-driver-hid-logitech-lg4ff misc latin1 to utf8 conversions 2012-01-02 13:04:55 +01:00
sysfs-driver-hid-multitouch HID: multitouch: create sysfs attribute to control quirks from user-space 2011-11-23 14:50:38 +01:00
sysfs-driver-hid-picolcd
sysfs-driver-hid-prodikeys
sysfs-driver-hid-roccat-arvo
sysfs-driver-hid-roccat-isku HID: roccat: add sysfs attr "reset" for Isku 2012-11-12 15:30:27 +01:00
sysfs-driver-hid-roccat-kone
sysfs-driver-hid-roccat-koneplus HID: roccat: deprecate some Koneplus attributes 2012-11-12 15:30:28 +01:00
sysfs-driver-hid-roccat-kovaplus HID: roccat: deprecate some Kovaplus attributes 2012-11-12 15:30:29 +01:00
sysfs-driver-hid-roccat-lua HID: roccat: add support for Roccat Lua 2012-10-17 10:44:47 +02:00
sysfs-driver-hid-roccat-pyra HID: roccat: deprecated some Pyra attributes 2012-11-12 15:30:28 +01:00
sysfs-driver-hid-roccat-savu HID: roccat: enable Savu device reset 2012-11-05 13:17:39 +01:00
sysfs-driver-hid-srws1 USB: HID: Steelseries SRW-S1 Add support controlling all LEDs simultaneously 2013-01-31 16:39:32 +01:00
sysfs-driver-hid-thingm HID: add ThingM blink(1) USB RGB LED support 2013-02-19 11:31:46 +01:00
sysfs-driver-hid-wiimote HID: wiimote: Add extension sysfs attribute 2011-11-22 23:09:08 +01:00
sysfs-driver-ppi doc: fix quite a few typos within Documentation 2012-11-19 14:28:24 +01:00
sysfs-driver-samsung-laptop Merge branch 'for_linus' of git://cavan.codon.org.uk/platform-drivers-x86 2012-03-28 14:20:23 -07:00
sysfs-driver-wacom HID: wacom: OLEDs control over sysfs for Intuos4 2012-08-15 10:29:11 +02:00
sysfs-firmware-acpi ACPI: Add support for exposing BGRT data 2012-03-30 04:09:24 -04:00
sysfs-firmware-dmi
sysfs-firmware-gsmi
sysfs-firmware-log
sysfs-firmware-memmap
sysfs-firmware-sfi
sysfs-firmware-sgi_uv
sysfs-fs-ext4 ext4: make the zero-out chunk size tunable 2012-08-17 09:54:17 -04:00
sysfs-gpio
sysfs-i2c-bmp085
sysfs-ibft
sysfs-kernel-fscaps
sysfs-kernel-iommu_groups iommu: IOMMU Groups 2012-06-25 13:48:15 +02:00
sysfs-kernel-mm
sysfs-kernel-mm-hugepages
sysfs-kernel-mm-ksm ksm: add sysfs ABI Documentation 2013-02-23 17:50:19 -08:00
sysfs-kernel-slab slub: document setting min order with debug_guardpage_minorder > 0 2012-01-12 20:13:04 -08:00
sysfs-kernel-uids
sysfs-memory-page-offline
sysfs-module modules: sysfs - export: taint, coresize, initsize 2012-01-13 09:32:15 +10:30
sysfs-ocfs2
sysfs-platform-asus-laptop
sysfs-platform-asus-wmi asus-wmi: enable resume on lid open 2012-07-28 00:11:49 -04:00
sysfs-platform-at91
sysfs-platform-eeepc-laptop
sysfs-platform-ideapad-laptop ideapad: add Lenovo IdeaPad Z570 support (part 3) 2012-08-20 12:44:41 -04:00
sysfs-platform-kim
sysfs-platform-msi-laptop msi-laptop: Add missing ABI documentation 2013-02-24 14:49:53 -08:00
sysfs-platform-ts5500 x86: Add TS-5500 platform support 2013-01-25 19:40:23 +01:00
sysfs-power PM / Sleep: add knob for printing device resume times 2012-07-01 13:31:22 +02:00
sysfs-pps
sysfs-profiling doc: Update the name of profiling based on sysfs 2012-12-03 11:11:51 +01:00
sysfs-ptp ptp: clarify the clock_name sysfs attribute 2012-09-22 15:42:46 -04:00
sysfs-tty uart: add other serial core layer get attributes 2012-10-30 14:05:32 -07:00
sysfs-wusb_cbaf