ceph-mirror/doc/cephfs/kernel-features.rst
Emmanuel Ameh b2ecec6b3a doc/cephfs: clarify deprecated commands and remove obsolete upgrade path
Several CephFS pages described deprecated commands and features without
clear status or replacements, and one page documented an upgrade path that
predates every supported release.

* cephfs-mirroring: correct the peer_add deprecation note to reference the
  actual replacement command, peer_bootstrap create, and link the Bootstrap
  Peers section
* kernel-features, experimental-features: state that inline data has been
  deprecated since the Octopus release and that enabling it triggers a
  health warning
* upgrading: remove the "Upgrading pre-Firefly file systems past Jewel"
  section; the tmap_upgrade command it referenced was removed in Kraken

Fixes: https://tracker.ceph.com/issues/77188
Signed-off-by: Emmanuel Ameh <eameh@contractor.linuxfoundation.org>
2026-06-23 11:23:14 +01:00

48 lines
1.7 KiB
ReStructuredText

Supported Features of the Kernel Driver
========================================
The kernel driver is developed separately from the core Ceph code, and as
such it sometimes differs from the FUSE driver in feature implementation.
The following details the implementation status of various CephFS features
in the kernel driver.
Inline data
-----------
Inline data was introduced by the Firefly release. This feature has been
deprecated since the Octopus release: enabling it triggers a health warning,
and it will be removed in a future release.
Linux kernel clients >= 3.19 can read inline data and convert existing
inline data to RADOS objects when file data is modified. At present,
Linux kernel clients do not store file data as inline data.
See `Experimental Features`_ for more information.
Quotas
------
Quota was first introduced by the Hammer release. Quota disk format got renewed
by the Mimic release. Linux kernel clients >= 4.17 can support the new format
quota. At present, no Linux kernel clients support the old format quota.
See `Quotas`_ for more information.
Multiple file systems within a Ceph cluster
-------------------------------------------
The feature was introduced by the Jewel release. Linux kernel clients >= 4.7
can support it.
See `Experimental Features`_ for more information.
Multiple active metadata servers
--------------------------------
The feature has been supported since the Luminous release. It is recommended to
use Linux kernel clients >= 4.14 when there are multiple active MDS.
Snapshots
---------
The feature has been supported since the Mimic release. It is recommended to
use Linux kernel clients >= 4.17 if snapshot is used.
.. _Experimental Features: ../experimental-features
.. _Quotas: ../quota