docs(ocis): add 8.2 updates -- clean-corrupt-public-shares CLI

Port of owncloud/docs-ocis#1285, which never merged upstream -- so ocis 8.2
shipped without this content and no version folder here carries it.

Applied to content/ocis/8.2 and 8.3 (substantive content, per the README
backport rule):

  * new "Clean Corrupt Public Shares" command page
  * its index entry in commands.adoc
  * the command added to the ocis-shares-cli help listing

Applied to content/ocis/8.2 only (version bookkeeping):

  * changed-cli.adoc: 8.1.0 -> 8.2.0 delta

The upstream PR wrote that delta as "between 8.0.0 and 8.1.0" -- a leftover
from when its base branch was the 8.1 dev line. Corrected to 8.1.0 -> 8.2.0,
which is the delta the content/ocis/8.2 folder describes. The 8.1 folder's
own delta page is set by the companion 8.1 port, so the two no longer collide.

Refs: owncloud/docs-ocis#1285
Refs: owncloud/docs-ocis#1275
Co-Authored-By: Martin Mattel <github@diemattels.at>
Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: DeepDiver1975

content/ocis/8.2/modules/admin/pages/maintenance/commands/changed-cli.adoc

@@ -1,6 +1,6 @@
 = Changed or Added CLI Commands
 :toc: right
-:description: This page contains a list with added, changed or removed CLI commands between Infinite Scale version 7.3.0 and 8.0.0.
+:description: This page contains a list with added, changed or removed CLI commands between Infinite Scale version 8.1.0 and 8.2.0.
 :page-aliases: ROOT:maintenance/b-r/changed-cli.adoc
 
 == Introduction
@@ -13,8 +13,5 @@
 
 See the link for a detailed description of the respective CLI command if available.
 
-* xref:maintenance/commands/commands.adoc#move-stuck-uploads[Move Stuck Uploads] +
-This CLI command has been added to remedy the issue when Infinite Scale metadata may become stuck in some cases of saturated disk usage.
-
-* xref:maintenance/commands/commands.adoc#cleanup-orphaned-grants[Cleanup Orphaned Grants] +
-This CLI command has been added to cleanup orphaned grants when a share has been deleted but the removal process is not completed successfully.
+* xref:maintenance/commands/commands.adoc#clean-corrupt-public-shares[Clean Corrupt Public Shares] +
+This CLI command has been added to detect and remove corrupt public share entries.

content/ocis/8.2/modules/admin/pages/maintenance/commands/clean-corrupt-public-shares.adoc

@@ -0,0 +1,33 @@
+= Clean Corrupt Public Shares
+:toc: right
+
+Detect and optionally delete storage grants that have no corresponding share-manager entry.
+
+include::partial$/maintenance/ocis-shares-cli.adoc[]
+
+== Command Details
+
+If there is a single public-share entry with a corrupt `resource_id`, the public-share manager will be unable to read this public-share or any others from memory.
+
+The following command fixes the problem of corrupt public shares.
+
+.Usage:
+
+[source,bash]
+----
+ocis shares -h clean-corrupt-public-shares
+NAME:
+   ocis shares clean-corrupt-public-shares - Remove corrupt public-share entries (nil resource_id) that crash ListPublicShares.
+
+USAGE:
+   ocis shares clean-corrupt-public-shares [command options]
+
+OPTIONS:
+   --dry-run      Only report corrupt entries, do not modify anything (default: true)
+   --verbose, -v  Verbose logging enabled (default: false)
+   --help, -h     show help
+----
+
+.Notes:
+
+- `--dry-run` defaults to `true` (no deletions). Set to `false` to remove corrupt public shares.

content/ocis/8.2/modules/admin/pages/maintenance/commands/commands.adoc

@@ -72,6 +72,10 @@ Compared to offline commands that can be issued when Infinite Scale is shut down
 
 App Tokens are used to authenticate 3rd party access via https like when using curl (apps) to access an API endpoint. These apps need to authenticate themselves, as no logged in user authenticates the request. To be able to use an app token, one must first create a token via the cli. For details see the description in the xref:{s-path}/auth-app.adoc[auth-app] service.
 
+=== Clean Corrupt Public Shares
+
+In rare cases, information relating to a public share can become corrupted, which can prevent all other public shares from being read. Use the following xref:maintenance/commands/clean-corrupt-public-shares.adoc[CLI command] to identify and remove them.
+
 === Cleanup Orphaned Grants
 
 Detect and, if desired, delete storage grants that have no corresponding share-manager entry. This can occur when a share is deleted, but the removal process is not completed successfully. Use the following xref:maintenance/commands/cleanup-orphaned-grants.adoc[CLI command] to cleanup those orphaned share grants.

content/ocis/8.2/modules/admin/partials/maintenance/ocis-shares-cli.adoc

@@ -15,10 +15,11 @@ CATEGORY:
    maintenance
 
 COMMANDS:
-   cleanup                  Clean up stale entries in the share manager.
-   clean-orphaned-grants    Detect and clean orphaned share-manager grants.
-   move-stuck-upload-blobs  Move stuck upload blobs to the jsoncs3 share-manager metadata
-   help, h                  Shows a list of commands or help for one command
+   cleanup                      Clean up stale entries in the share manager.
+   clean-orphaned-grants        Detect and clean orphaned share-manager grants.
+   move-stuck-upload-blobs      Move stuck upload blobs to the jsoncs3 share-manager metadata
+   clean-corrupt-public-shares  Remove corrupt public-share entries (nil resource_id) that crash ListPublicShares.
+   help, h                      Shows a list of commands or help for one command
 
 OPTIONS:
    --help, -h  show help

content/ocis/8.3/modules/admin/pages/maintenance/commands/clean-corrupt-public-shares.adoc

@@ -0,0 +1,33 @@
+= Clean Corrupt Public Shares
+:toc: right
+
+Detect and optionally delete storage grants that have no corresponding share-manager entry.
+
+include::partial$/maintenance/ocis-shares-cli.adoc[]
+
+== Command Details
+
+If there is a single public-share entry with a corrupt `resource_id`, the public-share manager will be unable to read this public-share or any others from memory.
+
+The following command fixes the problem of corrupt public shares.
+
+.Usage:
+
+[source,bash]
+----
+ocis shares -h clean-corrupt-public-shares
+NAME:
+   ocis shares clean-corrupt-public-shares - Remove corrupt public-share entries (nil resource_id) that crash ListPublicShares.
+
+USAGE:
+   ocis shares clean-corrupt-public-shares [command options]
+
+OPTIONS:
+   --dry-run      Only report corrupt entries, do not modify anything (default: true)
+   --verbose, -v  Verbose logging enabled (default: false)
+   --help, -h     show help
+----
+
+.Notes:
+
+- `--dry-run` defaults to `true` (no deletions). Set to `false` to remove corrupt public shares.

content/ocis/8.3/modules/admin/pages/maintenance/commands/commands.adoc

@@ -72,6 +72,10 @@ Compared to offline commands that can be issued when Infinite Scale is shut down
 
 App Tokens are used to authenticate 3rd party access via https like when using curl (apps) to access an API endpoint. These apps need to authenticate themselves, as no logged in user authenticates the request. To be able to use an app token, one must first create a token via the cli. For details see the description in the xref:{s-path}/auth-app.adoc[auth-app] service.
 
+=== Clean Corrupt Public Shares
+
+In rare cases, information relating to a public share can become corrupted, which can prevent all other public shares from being read. Use the following xref:maintenance/commands/clean-corrupt-public-shares.adoc[CLI command] to identify and remove them.
+
 === Cleanup Orphaned Grants
 
 Detect and, if desired, delete storage grants that have no corresponding share-manager entry. This can occur when a share is deleted, but the removal process is not completed successfully. Use the following xref:maintenance/commands/cleanup-orphaned-grants.adoc[CLI command] to cleanup those orphaned share grants.

content/ocis/8.3/modules/admin/partials/maintenance/ocis-shares-cli.adoc

@@ -15,10 +15,11 @@ CATEGORY:
    maintenance
 
 COMMANDS:
-   cleanup                  Clean up stale entries in the share manager.
-   clean-orphaned-grants    Detect and clean orphaned share-manager grants.
-   move-stuck-upload-blobs  Move stuck upload blobs to the jsoncs3 share-manager metadata
-   help, h                  Shows a list of commands or help for one command
+   cleanup                      Clean up stale entries in the share manager.
+   clean-orphaned-grants        Detect and clean orphaned share-manager grants.
+   move-stuck-upload-blobs      Move stuck upload blobs to the jsoncs3 share-manager metadata
+   clean-corrupt-public-shares  Remove corrupt public-share entries (nil resource_id) that crash ListPublicShares.
+   help, h                      Shows a list of commands or help for one command
 
 OPTIONS:
    --help, -h  show help