From 4733d46d839d2d48ead94de034dfa7a61f248222 Mon Sep 17 00:00:00 2001 From: Aleksey Kravchenko Date: Tue, 18 Feb 2025 09:58:29 +0300 Subject: [PATCH] [#13] Add docs about info FrostFS backend cmd Signed-off-by: Aleksey Kravchenko --- MANUAL.html | 211 ++++++++++++++++++++------------ MANUAL.md | 73 ++++++++++- MANUAL.txt | 76 +++++++++++- docs/content/commands/rclone.md | 2 +- docs/content/flags.md | 2 +- docs/content/frostfs.md | 69 +++++++++++ rclone.1 | 92 +++++++++++++- 7 files changed, 440 insertions(+), 85 deletions(-) diff --git a/MANUAL.html b/MANUAL.html index eb4138e2b..6954adaff 100644 --- a/MANUAL.html +++ b/MANUAL.html @@ -233,7 +233,7 @@

rclone(1) User Manual

Nick Craig-Wood

-

Jan 23, 2025

+

Feb 22, 2025

Rclone syncs your files to cloud storage

@@ -19294,7 +19294,7 @@ split into groups.

--tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8335.a85292ca0.feature/add-container-zones-support") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8339.71f0cdbd4.feat/frostfs_info_cmd")

Performance

Flags helpful for increasing performance.

      --buffer-size SizeSuffix   In memory buffer size when reading files for each --transfer (default 16Mi)
@@ -33155,6 +33155,63 @@ decentralized object storage FrostFS).

  • Type: string
  • Required: false
  • +

    Backend commands

    +

    Here are the commands specific to the frostfs backend.

    +

    Run them with

    +
    rclone backend COMMAND remote:
    +

    The help below will explain what arguments each command takes.

    +

    See the backend command +for more info on how to pass options and arguments.

    +

    These can be run on a running backend using the rc command backend/command.

    +

    info

    +

    Show information about the FrostFS objects and containers

    +
    rclone backend info remote: [options] [<arguments>+]
    +

    This command can be used to get information about the FrostFS objects +and containers.

    +

    Usage Examples:

    +
    rclone backend info frostfs:container/path/to/dir
    +rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt
    +rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt -o "format={cid}:{oid}"
    +

    The optional "format" flag overrides the information output. In this +example, if an object is stored in a container with the identifier +"9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1" and its own identifier is +"4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP", the output of this +command will be +"9mvN7hsucoGoHjxPqrWmDipnMaemGVDqrxxPyynn1:4VpcNFsZqsQt1Gnfw2utBnzn5Blgc7i4kvtuXyKyJp".

    +

    The default output format is the same as that of the frostfs-cli +utility, with the "container get" and "object head" options. Here is an +example of output:

    +
     --- Container info ---
    +CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1
    +Owner ID: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX
    +Created: 2025-02-17 15:07:51 +0300 MSK
    +Attributes:
    +  Timestamp=1739794071
    +  Name=test
    +  __SYSTEM__NAME=test
    +  __SYSTEM__ZONE=container
    +  __SYSTEM__DISABLE_HOMOMORPHIC_HASHING=true
    +Placement policy:
    +REP 3
    +
    + --- Object info ---
    +ID: 4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP
    +CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1
    +Owner: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX
    +CreatedAt: 559
    +Size: 402905
    +HomoHash: <empty>
    +Checksum: 2a068fe24c53bc8bf7d6bbb997414f7938b080305dc45f9fd3ff684bc11fbb7b
    +Type: REGULAR
    +Attributes:
    +  FileName=cat.png
    +  FilePath=/dir1/dir2/dir3/cat.png
    +  Timestamp=1733410524 (2024-12-05 17:55:24 +0300 MSK)
    +ID signature:
    +  public key: 026b7c7a7a16225eb13a5a733495a1bcdd1f016dfa9193498821379b0de2ba6870
    +  signature: 049f6712c8378d323269b605a282bcacd7565ce2eefe1f10a9739c48945f739d95102c478b9cb1d429cd3330b4b5262e725392e322de3bbfa4ce18a9c842289219

    FTP

    FTP is the File Transfer Protocol. Rclone FTP support is provided using the

    See the metadata docs for more info.

    -

    Backend commands

    +

    Backend commands

    Here are the commands specific to the drive backend.

    Run them with

    rclone backend COMMAND remote:
    @@ -37209,7 +37266,7 @@ default).

    written.

    See the metadata docs for more info.

    -

    Backend commands

    +

    Backend commands

    Here are the commands specific to the hasher backend.

    Run them with

    rclone backend COMMAND remote:
    @@ -38111,7 +38168,7 @@ may be in the listing.

  • Type: string
  • Required: false
  • -

    Backend commands

    +

    Backend commands

    Here are the commands specific to the http backend.

    Run them with

    rclone backend COMMAND remote:
    @@ -40745,7 +40802,7 @@ provided primarily for debugging purposes.

  • Type: string
  • Required: false
  • -

    Backend commands

    +

    Backend commands

    Here are the commands specific to the netstorage backend.

    Run them with

    rclone backend COMMAND remote:
    @@ -43092,69 +43149,69 @@ href="https://learn.microsoft.com/en-us/onedrive/developer/rest-api/resources/pe API, which differs slightly between OneDrive Personal and Business.

    Example for OneDrive Personal:

    -
    [
    -    {
    -        "id": "1234567890ABC!123",
    -        "grantedTo": {
    -            "user": {
    -                "id": "ryan@contoso.com"
    -            },
    -            "application": {},
    -            "device": {}
    -        },
    -        "invitation": {
    -            "email": "ryan@contoso.com"
    -        },
    -        "link": {
    -            "webUrl": "https://1drv.ms/t/s!1234567890ABC"
    -        },
    -        "roles": [
    -            "read"
    -        ],
    -        "shareId": "s!1234567890ABC"
    -    }
    -]
    +
    [
    +    {
    +        "id": "1234567890ABC!123",
    +        "grantedTo": {
    +            "user": {
    +                "id": "ryan@contoso.com"
    +            },
    +            "application": {},
    +            "device": {}
    +        },
    +        "invitation": {
    +            "email": "ryan@contoso.com"
    +        },
    +        "link": {
    +            "webUrl": "https://1drv.ms/t/s!1234567890ABC"
    +        },
    +        "roles": [
    +            "read"
    +        ],
    +        "shareId": "s!1234567890ABC"
    +    }
    +]

    Example for OneDrive Business:

    -
    [
    -    {
    -        "id": "48d31887-5fad-4d73-a9f5-3c356e68a038",
    -        "grantedToIdentities": [
    -            {
    -                "user": {
    -                    "displayName": "ryan@contoso.com"
    -                },
    -                "application": {},
    -                "device": {}
    -            }
    -        ],
    -        "link": {
    -            "type": "view",
    -            "scope": "users",
    -            "webUrl": "https://contoso.sharepoint.com/:w:/t/design/a577ghg9hgh737613bmbjf839026561fmzhsr85ng9f3hjck2t5s"
    -        },
    -        "roles": [
    -            "read"
    -        ],
    -        "shareId": "u!LKj1lkdlals90j1nlkascl"
    -    },
    -    {
    -        "id": "5D33DD65C6932946",
    -        "grantedTo": {
    -            "user": {
    -                "displayName": "John Doe",
    -                "id": "efee1b77-fb3b-4f65-99d6-274c11914d12"
    -            },
    -            "application": {},
    -            "device": {}
    -        },
    -        "roles": [
    -            "owner"
    -        ],
    -        "shareId": "FWxc1lasfdbEAGM5fI7B67aB5ZMPDMmQ11U"
    -    }
    -]
    +
    [
    +    {
    +        "id": "48d31887-5fad-4d73-a9f5-3c356e68a038",
    +        "grantedToIdentities": [
    +            {
    +                "user": {
    +                    "displayName": "ryan@contoso.com"
    +                },
    +                "application": {},
    +                "device": {}
    +            }
    +        ],
    +        "link": {
    +            "type": "view",
    +            "scope": "users",
    +            "webUrl": "https://contoso.sharepoint.com/:w:/t/design/a577ghg9hgh737613bmbjf839026561fmzhsr85ng9f3hjck2t5s"
    +        },
    +        "roles": [
    +            "read"
    +        ],
    +        "shareId": "u!LKj1lkdlals90j1nlkascl"
    +    },
    +    {
    +        "id": "5D33DD65C6932946",
    +        "grantedTo": {
    +            "user": {
    +                "displayName": "John Doe",
    +                "id": "efee1b77-fb3b-4f65-99d6-274c11914d12"
    +            },
    +            "application": {},
    +            "device": {}
    +        },
    +        "roles": [
    +            "owner"
    +        ],
    +        "shareId": "FWxc1lasfdbEAGM5fI7B67aB5ZMPDMmQ11U"
    +    }
    +]

    To write permissions, pass in a "permissions" metadata key using this same format. The --metadata-mapper @@ -43168,12 +43225,12 @@ for a user. Creating a Public Link is also supported, if Link.Scope is set to "anonymous".

    Example request to add a "read" permission with --metadata-mapper:

    -
    {
    -    "Metadata": {
    -        "permissions": "[{\"grantedToIdentities\":[{\"user\":{\"id\":\"ryan@contoso.com\"}}],\"roles\":[\"read\"]}]"
    -    }
    -}
    +
    {
    +    "Metadata": {
    +        "permissions": "[{\"grantedToIdentities\":[{\"user\":{\"id\":\"ryan@contoso.com\"}}],\"roles\":[\"read\"]}]"
    +    }
    +}

    Note that adding a permission can fail if a conflicting permission already exists for the file/folder.

    To update an existing permission, include both the Permission ID and @@ -44502,7 +44559,7 @@ Encryption

  • Type: string
  • Required: false
  • -

    Backend commands

    +

    Backend commands

    Here are the commands specific to the oracleobjectstorage backend.

    Run them with

    @@ -46470,7 +46527,7 @@ Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,LeftSpace,Righ
  • Type: string
  • Required: false
  • -

    Backend commands

    +

    Backend commands

    Here are the commands specific to the pikpak backend.

    Run them with

    rclone backend COMMAND remote:
    @@ -52315,7 +52372,7 @@ backend.

    See the metadata docs for more info.

    -

    Backend commands

    +

    Backend commands

    Here are the commands specific to the local backend.

    Run them with

    rclone backend COMMAND remote:
    diff --git a/MANUAL.md b/MANUAL.md index d3c9c94ab..b1ec1e28c 100644 --- a/MANUAL.md +++ b/MANUAL.md @@ -1,6 +1,6 @@ % rclone(1) User Manual % Nick Craig-Wood -% Jan 23, 2025 +% Feb 22, 2025 # Rclone syncs your files to cloud storage @@ -20498,7 +20498,7 @@ Flags for general networking and HTTP stuff. --tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8335.a85292ca0.feature/add-container-zones-support") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8339.71f0cdbd4.feat/frostfs_info_cmd") ``` @@ -35104,6 +35104,75 @@ Properties: - Type: string - Required: false +## Backend commands + +Here are the commands specific to the frostfs backend. + +Run them with + + rclone backend COMMAND remote: + +The help below will explain what arguments each command takes. + +See the [backend](https://rclone.org/commands/rclone_backend/) command for more +info on how to pass options and arguments. + +These can be run on a running backend using the rc command +[backend/command](https://rclone.org/rc/#backend-command). + +### info + +Show information about the FrostFS objects and containers + + rclone backend info remote: [options] [+] + +This command can be used to get information about the FrostFS objects and containers. + +Usage Examples: + + rclone backend info frostfs:container/path/to/dir + rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt + rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt -o "format={cid}:{oid}" + +The optional "format" flag overrides the information output. In this example, if an object is stored in +a container with the identifier "9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1" and +its own identifier is "4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP", the output of this command will be +"9mvN7hsucoGoHjxPqrWmDipnMaemGVDqrxxPyynn1:4VpcNFsZqsQt1Gnfw2utBnzn5Blgc7i4kvtuXyKyJp". + +The default output format is the same as that of the frostfs-cli utility, +with the "container get" and "object head" options. Here is an example of output: + + --- Container info --- + CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1 + Owner ID: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX + Created: 2025-02-17 15:07:51 +0300 MSK + Attributes: + Timestamp=1739794071 + Name=test + __SYSTEM__NAME=test + __SYSTEM__ZONE=container + __SYSTEM__DISABLE_HOMOMORPHIC_HASHING=true + Placement policy: + REP 3 + + --- Object info --- + ID: 4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP + CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1 + Owner: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX + CreatedAt: 559 + Size: 402905 + HomoHash: + Checksum: 2a068fe24c53bc8bf7d6bbb997414f7938b080305dc45f9fd3ff684bc11fbb7b + Type: REGULAR + Attributes: + FileName=cat.png + FilePath=/dir1/dir2/dir3/cat.png + Timestamp=1733410524 (2024-12-05 17:55:24 +0300 MSK) + ID signature: + public key: 026b7c7a7a16225eb13a5a733495a1bcdd1f016dfa9193498821379b0de2ba6870 + signature: 049f6712c8378d323269b605a282bcacd7565ce2eefe1f10a9739c48945f739d95102c478b9cb1d429cd3330b4b5262e725392e322de3bbfa4ce18a9c842289219 + + # FTP diff --git a/MANUAL.txt b/MANUAL.txt index 1ea427688..2ac24eaac 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -1,6 +1,6 @@ rclone(1) User Manual Nick Craig-Wood -Jan 23, 2025 +Feb 22, 2025 Rclone syncs your files to cloud storage @@ -20166,7 +20166,7 @@ Flags for general networking and HTTP stuff. --tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8335.a85292ca0.feature/add-container-zones-support") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8339.71f0cdbd4.feat/frostfs_info_cmd") Performance @@ -34575,6 +34575,78 @@ Properties: - Type: string - Required: false +Backend commands + +Here are the commands specific to the frostfs backend. + +Run them with + + rclone backend COMMAND remote: + +The help below will explain what arguments each command takes. + +See the backend command for more info on how to pass options and +arguments. + +These can be run on a running backend using the rc command +backend/command. + +info + +Show information about the FrostFS objects and containers + + rclone backend info remote: [options] [+] + +This command can be used to get information about the FrostFS objects +and containers. + +Usage Examples: + + rclone backend info frostfs:container/path/to/dir + rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt + rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt -o "format={cid}:{oid}" + +The optional "format" flag overrides the information output. In this +example, if an object is stored in a container with the identifier +"9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1" and its own identifier is +"4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP", the output of this +command will be +"9mvN7hsucoGoHjxPqrWmDipnMaemGVDqrxxPyynn1:4VpcNFsZqsQt1Gnfw2utBnzn5Blgc7i4kvtuXyKyJp". + +The default output format is the same as that of the frostfs-cli +utility, with the "container get" and "object head" options. Here is an +example of output: + + --- Container info --- + CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1 + Owner ID: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX + Created: 2025-02-17 15:07:51 +0300 MSK + Attributes: + Timestamp=1739794071 + Name=test + __SYSTEM__NAME=test + __SYSTEM__ZONE=container + __SYSTEM__DISABLE_HOMOMORPHIC_HASHING=true + Placement policy: + REP 3 + + --- Object info --- + ID: 4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP + CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1 + Owner: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX + CreatedAt: 559 + Size: 402905 + HomoHash: + Checksum: 2a068fe24c53bc8bf7d6bbb997414f7938b080305dc45f9fd3ff684bc11fbb7b + Type: REGULAR + Attributes: + FileName=cat.png + FilePath=/dir1/dir2/dir3/cat.png + Timestamp=1733410524 (2024-12-05 17:55:24 +0300 MSK) + ID signature: + public key: 026b7c7a7a16225eb13a5a733495a1bcdd1f016dfa9193498821379b0de2ba6870 + signature: 049f6712c8378d323269b605a282bcacd7565ce2eefe1f10a9739c48945f739d95102c478b9cb1d429cd3330b4b5262e725392e322de3bbfa4ce18a9c842289219 + FTP FTP is the File Transfer Protocol. Rclone FTP support is provided using diff --git a/docs/content/commands/rclone.md b/docs/content/commands/rclone.md index d43e14ba8..d80a35a1c 100644 --- a/docs/content/commands/rclone.md +++ b/docs/content/commands/rclone.md @@ -945,7 +945,7 @@ rclone [flags] --use-json-log Use json log format --use-mmap Use mmap allocator (see docs) --use-server-modtime Use server modified time instead of object metadata - --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8335.a85292ca0.feature/add-container-zones-support") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8339.71f0cdbd4.feat/frostfs_info_cmd") -v, --verbose count Print lots more stuff (repeat for more) -V, --version Print the version number --webdav-bearer-token string Bearer token instead of user/pass (e.g. a Macaroon) diff --git a/docs/content/flags.md b/docs/content/flags.md index af8048265..57fc15854 100644 --- a/docs/content/flags.md +++ b/docs/content/flags.md @@ -115,7 +115,7 @@ Flags for general networking and HTTP stuff. --tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8335.a85292ca0.feature/add-container-zones-support") + --user-agent string Set the user-agent to a specified string (default "rclone/v1.68.2-beta.8339.71f0cdbd4.feat/frostfs_info_cmd") ``` diff --git a/docs/content/frostfs.md b/docs/content/frostfs.md index 13f6b0d27..8c5c9e294 100644 --- a/docs/content/frostfs.md +++ b/docs/content/frostfs.md @@ -487,4 +487,73 @@ Properties: - Type: string - Required: false +## Backend commands + +Here are the commands specific to the frostfs backend. + +Run them with + + rclone backend COMMAND remote: + +The help below will explain what arguments each command takes. + +See the [backend](/commands/rclone_backend/) command for more +info on how to pass options and arguments. + +These can be run on a running backend using the rc command +[backend/command](/rc/#backend-command). + +### info + +Show information about the FrostFS objects and containers + + rclone backend info remote: [options] [+] + +This command can be used to get information about the FrostFS objects and containers. + +Usage Examples: + + rclone backend info frostfs:container/path/to/dir + rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt + rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt -o "format={cid}:{oid}" + +The optional "format" flag overrides the information output. In this example, if an object is stored in +a container with the identifier "9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1" and +its own identifier is "4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP", the output of this command will be +"9mvN7hsucoGoHjxPqrWmDipnMaemGVDqrxxPyynn1:4VpcNFsZqsQt1Gnfw2utBnzn5Blgc7i4kvtuXyKyJp". + +The default output format is the same as that of the frostfs-cli utility, +with the "container get" and "object head" options. Here is an example of output: + + --- Container info --- + CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1 + Owner ID: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX + Created: 2025-02-17 15:07:51 +0300 MSK + Attributes: + Timestamp=1739794071 + Name=test + __SYSTEM__NAME=test + __SYSTEM__ZONE=container + __SYSTEM__DISABLE_HOMOMORPHIC_HASHING=true + Placement policy: + REP 3 + + --- Object info --- + ID: 4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP + CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1 + Owner: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX + CreatedAt: 559 + Size: 402905 + HomoHash: + Checksum: 2a068fe24c53bc8bf7d6bbb997414f7938b080305dc45f9fd3ff684bc11fbb7b + Type: REGULAR + Attributes: + FileName=cat.png + FilePath=/dir1/dir2/dir3/cat.png + Timestamp=1733410524 (2024-12-05 17:55:24 +0300 MSK) + ID signature: + public key: 026b7c7a7a16225eb13a5a733495a1bcdd1f016dfa9193498821379b0de2ba6870 + signature: 049f6712c8378d323269b605a282bcacd7565ce2eefe1f10a9739c48945f739d95102c478b9cb1d429cd3330b4b5262e725392e322de3bbfa4ce18a9c842289219 + + {{< rem autogenerated options stop >}} diff --git a/rclone.1 b/rclone.1 index a4c6ddc25..20a872a85 100644 --- a/rclone.1 +++ b/rclone.1 @@ -15,7 +15,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "rclone" "1" "Jan 23, 2025" "User Manual" "" +.TH "rclone" "1" "Feb 22, 2025" "User Manual" "" .hy .SH Rclone syncs your files to cloud storage .PP @@ -27735,7 +27735,7 @@ Flags for general networking and HTTP stuff. --tpslimit float Limit HTTP transactions per second to this --tpslimit-burst int Max burst of transactions for --tpslimit (default 1) --use-cookies Enable session cookiejar - --user-agent string Set the user-agent to a specified string (default \[dq]rclone/v1.68.2-beta.8335.a85292ca0.feature/add-container-zones-support\[dq]) + --user-agent string Set the user-agent to a specified string (default \[dq]rclone/v1.68.2-beta.8339.71f0cdbd4.feat/frostfs_info_cmd\[dq]) \f[R] .fi .SS Performance @@ -46090,6 +46090,94 @@ Env Var: RCLONE_FROSTFS_DESCRIPTION Type: string .IP \[bu] 2 Required: false +.SS Backend commands +.PP +Here are the commands specific to the frostfs backend. +.PP +Run them with +.IP +.nf +\f[C] +rclone backend COMMAND remote: +\f[R] +.fi +.PP +The help below will explain what arguments each command takes. +.PP +See the backend (https://rclone.org/commands/rclone_backend/) command +for more info on how to pass options and arguments. +.PP +These can be run on a running backend using the rc command +backend/command (https://rclone.org/rc/#backend-command). +.SS info +.PP +Show information about the FrostFS objects and containers +.IP +.nf +\f[C] +rclone backend info remote: [options] [+] +\f[R] +.fi +.PP +This command can be used to get information about the FrostFS objects +and containers. +.PP +Usage Examples: +.IP +.nf +\f[C] +rclone backend info frostfs:container/path/to/dir +rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt +rclone backend info frostfs:container/path/to/dir path/to/file/in/dir.txt -o \[dq]format={cid}:{oid}\[dq] +\f[R] +.fi +.PP +The optional \[dq]format\[dq] flag overrides the information output. +In this example, if an object is stored in a container with the +identifier \[dq]9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1\[dq] and +its own identifier is +\[dq]4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP\[dq], the output of +this command will be +\[dq]9mvN7hsucoGoHjxPqrWmDipnMaemGVDqrxxPyynn1:4VpcNFsZqsQt1Gnfw2utBnzn5Blgc7i4kvtuXyKyJp\[dq]. +.PP +The default output format is the same as that of the frostfs-cli +utility, with the \[dq]container get\[dq] and \[dq]object head\[dq] +options. +Here is an example of output: +.IP +.nf +\f[C] + --- Container info --- +CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1 +Owner ID: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX +Created: 2025-02-17 15:07:51 +0300 MSK +Attributes: + Timestamp=1739794071 + Name=test + __SYSTEM__NAME=test + __SYSTEM__ZONE=container + __SYSTEM__DISABLE_HOMOMORPHIC_HASHING=true +Placement policy: +REP 3 + + --- Object info --- +ID: 4VPCNFsZ2SQt1GNfYw2uTBNnz5bLgC7i4k4ovtuXKyJP +CID: 9mvN7hsUcYoGoHjxpRWtqmDipnmaeRmGVDqRxxPyy2n1 +Owner: NQL7q6PvPaisWNwdWfoR1LsEsAyje8P3jX +CreatedAt: 559 +Size: 402905 +HomoHash: +Checksum: 2a068fe24c53bc8bf7d6bbb997414f7938b080305dc45f9fd3ff684bc11fbb7b +Type: REGULAR +Attributes: + FileName=cat.png + FilePath=/dir1/dir2/dir3/cat.png + Timestamp=1733410524 (2024-12-05 17:55:24 +0300 MSK) +ID signature: + public key: 026b7c7a7a16225eb13a5a733495a1bcdd1f016dfa9193498821379b0de2ba6870 + signature: 049f6712c8378d323269b605a282bcacd7565ce2eefe1f10a9739c48945f739d95102c478b9cb1d429cd3330b4b5262e725392e322de3bbfa4ce18a9c842289219 +\f[R] +.fi .SH FTP .PP FTP is the File Transfer Protocol.