From d87211e13efcbe2955d3b9e0f30dae18093f8020 Mon Sep 17 00:00:00 2001 From: Git'Fellow <12234510+solracsf@users.noreply.github.com> Date: Sat, 31 Dec 2022 13:22:15 +0100 Subject: [PATCH 1/3] Add file:repair-tree documentation Fix https://github.com/nextcloud/documentation/issues/9508 Signed-off-by: Git'Fellow <12234510+solracsf@users.noreply.github.com> --- .../configuration_server/occ_command.rst | 22 ++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/admin_manual/configuration_server/occ_command.rst b/admin_manual/configuration_server/occ_command.rst index e3716d4e6ae..7c5cf3c9659 100644 --- a/admin_manual/configuration_server/occ_command.rst +++ b/admin_manual/configuration_server/occ_command.rst @@ -655,9 +655,10 @@ File operations ``occ`` has three commands for managing files in Nextcloud:: files - files:cleanup cleanup filecache - files:scan rescan filesystem - files:scan-app-data rescan the AppData folder + files:cleanup Cleanup filecache + files:repair-tree Try and repair malformed filesystem tree structures + files:scan Rescan filesystem + files:scan-app-data Rescan the AppData folder files:transfer-ownership All files' and folders' ownerships are moved to another user. Outgoing shares are moved as well. Incoming shares are not moved by default because the @@ -750,6 +751,21 @@ Cleanup ``files:cleanup`` tidies up the server's file cache by deleting all file entries that have no matching entries in the storage table. +Repair-Tree +^^^^^^^ + +``files:repair`` try and repair malformed filesystem tree structures. +If for any reason the path of an entry in the filecache doesn't match with +it's expected path, based on the path of it's parent node, you end up with an +entry in the filecache that exists in different places based on how the entry +is generated. For example, if while listing folder ``/foo`` it contains a file +``bar.txt``, but when trying to do anything with ``/foo/bar.txt`` the file +doesn't exists. + +This command attempts to repair such entries by querying for entries where the path +doesn't match the expected path based on it's parent path and filename and resets it's +path to the expected one. + Transfer ^^^^^^^^ From 179ebeb3b5ef3de0ceabd4fe1475aee7740a58b4 Mon Sep 17 00:00:00 2001 From: Git'Fellow <12234510+solracsf@users.noreply.github.com> Date: Sat, 31 Dec 2022 13:23:22 +0100 Subject: [PATCH 2/3] Typo Signed-off-by: Git'Fellow <12234510+solracsf@users.noreply.github.com> --- admin_manual/configuration_server/occ_command.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/configuration_server/occ_command.rst b/admin_manual/configuration_server/occ_command.rst index 7c5cf3c9659..cd2c726fa80 100644 --- a/admin_manual/configuration_server/occ_command.rst +++ b/admin_manual/configuration_server/occ_command.rst @@ -754,7 +754,7 @@ entries that have no matching entries in the storage table. Repair-Tree ^^^^^^^ -``files:repair`` try and repair malformed filesystem tree structures. +``files:repair-tree`` try and repair malformed filesystem tree structures. If for any reason the path of an entry in the filecache doesn't match with it's expected path, based on the path of it's parent node, you end up with an entry in the filecache that exists in different places based on how the entry From 506d10f2e0e68f34807a53dae535f2fbbf53154d Mon Sep 17 00:00:00 2001 From: Git'Fellow <12234510+solracsf@users.noreply.github.com> Date: Sat, 31 Dec 2022 13:31:23 +0100 Subject: [PATCH 3/3] Title underline too short Signed-off-by: Git'Fellow <12234510+solracsf@users.noreply.github.com> --- admin_manual/configuration_server/occ_command.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/configuration_server/occ_command.rst b/admin_manual/configuration_server/occ_command.rst index cd2c726fa80..d97d9df8cc8 100644 --- a/admin_manual/configuration_server/occ_command.rst +++ b/admin_manual/configuration_server/occ_command.rst @@ -752,7 +752,7 @@ Cleanup entries that have no matching entries in the storage table. Repair-Tree -^^^^^^^ +^^^^^^^^^^^ ``files:repair-tree`` try and repair malformed filesystem tree structures. If for any reason the path of an entry in the filecache doesn't match with