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] 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 0d9894c29..f4044337a 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 ^^^^^^^^