From 7bcb81b7857d995496a0b041304ec68971cef13e 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 0d9894c2922..f4044337a6b 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 @@ -739,6 +740,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 8f4422bbb2d374c70a53b3fd69a0f98a5bd3b479 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 f4044337a6b..b7e1d3b0a71 100644 --- a/admin_manual/configuration_server/occ_command.rst +++ b/admin_manual/configuration_server/occ_command.rst @@ -743,7 +743,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 4beff83fab0584461d01ceb4c144b5f4d20ec9ca 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 b7e1d3b0a71..67353b5b204 100644 --- a/admin_manual/configuration_server/occ_command.rst +++ b/admin_manual/configuration_server/occ_command.rst @@ -741,7 +741,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