khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-03 02:09:45 +07:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #9170 from nextcloud/improve-transferownership-docs-add-move

Browse Source 
Improve docs for transfer ownership
This commit is contained in:
Vincent Petry
2022-09-22 10:27:32 +02:00
committed by GitHub
parent 90bac8aa29 e36af006fb
commit 60d3afbf2a
1 changed files with 23 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
admin_manual/configuration_server/occ_command.rst
View File

@@ -741,12 +741,34 @@ entries that have no matching entries in the storage table.
Transfer
^^^^^^^^
The command ``occ files:transfer-ownership`` can be used to transfer files from one user to another::
Usage:
files:transfer-ownership [options] [--] <source-user> <destination-user>
Arguments:
source-user owner of files which shall be moved
destination-user user who will be the new owner of the files
Options:
--path=PATH selectively provide the path to transfer. For example --path="folder_name" [default: ""]
--move move data from source user to root directory of destination user, which must be empty
--transfer-incoming-shares[=TRANSFER-INCOMING-SHARES] transfer incoming user file shares to destination user. Usage: --transfer-incoming-shares=1 (value required) [default: "2"]
You may transfer all files and shares from one user to another. This is useful
before removing a user::
sudo -u www-data php occ files:transfer-ownership <source-user> <destination-user>
It is also possible to transfer only one directory along with it's contents. This can be useful to restructure your organization or quotas. The ``--path`` argument is given as the path to the directory as seen from the source user::
The transferred files will appear inside a new sub-directory in the destination user's home.
If the destination user has no files at all (empty home), it is possible to also transfer all the source user's files by passing ``--move``::
sudo -u www-data php occ files:transfer-ownership --move <source-user> <destination-user>
In this case no sub-directory is created and all files will appear directly in the root of the user's home.
It is also possible to transfer only one directory along with its contents. This can be useful to restructure your organization or quotas. The ``--path`` argument is given as the path to the directory as seen from the source user::
sudo -u www-data php occ files:transfer-ownership --path="path_to_dir" <source-user> <destination-user>