summaryrefslogtreecommitdiffstats
path: root/doc/dev/delayed-delete.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/dev/delayed-delete.rst')
-rw-r--r--doc/dev/delayed-delete.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/dev/delayed-delete.rst b/doc/dev/delayed-delete.rst
new file mode 100644
index 00000000..bf5f65a4
--- /dev/null
+++ b/doc/dev/delayed-delete.rst
@@ -0,0 +1,12 @@
+=========================
+ CephFS delayed deletion
+=========================
+
+When you delete a file, the data is not immediately removed. Each
+object in the file needs to be removed independently, and sending
+``size_of_file / stripe_size * replication_count`` messages would slow
+the client down too much, and use a too much of the clients
+bandwidth. Additionally, snapshots may mean some objects should not be
+deleted.
+
+Instead, the file is marked as deleted on the MDS, and deleted lazily.