Document files:checksums:verify command

[IljaN]

Command scans the file-cache and compares the checksum in file-cache with the actual checksum of the file.

The operation might take very-long with a lot or big file and use a lot of memory, because every file needs to be read in to memory three times to compute all checksums.

Options:
-r / -- repair: Must be given to repair checksum mismatch, without it mismatches will be just printed to the terminal.
-u /--user: Only scan files of a specific user
-p / --path: Only scan specific path

Note that --user and --path option must be used exclusivly

-v / : Verbose, prints every file which is scanned or skipped to the terminal

The operating procedure to use this command should be that the admin scans the files, then manually verifies the integrity of mismatches and after that uses the repair command to repair the broken file-cache entries.

Note that files in cache without checksum are ignored. Files without checksum can appear in flie-cache when an external storage is mounted. For these files checksums are only computed on first download/change.

PR: owncloud/core#31008
Issue: owncloud/core#30951

[IljaN]

Also note that this command will not work with encryption