aspera-cli 4.21.1 → 4.21.2

data/README.md

@@ -5,7 +5,7 @@ Do not edit this README.md, edit docs/README.erb.md, for details, read docs/READ
 markdownlint-disable MD033 MD003 MD053
 cspell:ignore Serban Antipolis
 PANDOC_META_BEGIN
-subtitle: "ascli 4.21.1"
+subtitle: "ascli 4.22.0.pre"
 PANDOC_META_END
 -->
 
@@ -15,7 +15,7 @@ PANDOC_META_END
 
 ## Introduction
 
-Version : 4.21.1
+Version : 4.22.0.pre
 
 Laurent/2016-2025
 
@@ -112,7 +112,7 @@ Once the gem is installed, `ascli` shall be accessible:
 
 ```console
 $ ascli --version
-4.21.1
+4.22.0.pre
 ```
 
 ### First use
@@ -132,14 +132,14 @@ ascli server browse /
 ```
 
 ```output
-+------------+--------+-----------+-------+---------------------------+-----------------------+
-| zmode      | zuid   | zgid      | size  | mtime                     | name                  |
-+------------+--------+-----------+-------+---------------------------+-----------------------+
-| drwxr-xr-x | aspera | asperaweb | 90112 | 2023-04-05 15:31:21 +0200 | Upload                |
-| dr-xr-xr-x | aspera | asperaweb | 4096  | 2022-10-27 16:08:16 +0200 | aspera-test-dir-large |
-| dr-xr-xr-x | aspera | asperaweb | 4096  | 2022-10-27 16:08:17 +0200 | aspera-test-dir-small |
-| dr-xr-xr-x | aspera | asperaweb | 4096  | 2022-10-27 16:08:17 +0200 | aspera-test-dir-tiny  |
-+------------+--------+-----------+-------+---------------------------+-----------------------+
+╭────────────┬──────┬───────────┬───────┬───────────────────────────┬───────────────────────╮
+│ zmode      │ zuid │ zgid      │ size  │ mtime                     │ name                  │
+╞════════════╪══════╪═══════════╪═══════╪═══════════════════════════╪═══════════════════════╡
+│ dr-xr-xr-x │ xfer │ demousers │ 4096  │ 2014-11-05 16:01:56 +0100 │ aspera-test-dir-large │
+│ drwxrwxr-x │ xfer │ demousers │ 94208 │ 2025-03-31 11:27:33 +0200 │ Upload                │
+│ dr-xr-xr-x │ xfer │ demousers │ 4096  │ 2014-11-05 16:01:56 +0100 │ aspera-test-dir-small │
+│ dr-xr-xr-x │ xfer │ demousers │ 4096  │ 2014-11-05 16:01:56 +0100 │ aspera-test-dir-tiny  │
+╰────────────┴──────┴───────────┴───────┴───────────────────────────┴───────────────────────╯
 ```
 
 If you want to use `ascli` with another server, and in order to make further calls more convenient, it is advised to define a [Option Preset](#option-preset) for the server's authentication options.
@@ -173,17 +173,16 @@ ascli server browse /aspera-test-dir-large
 ```
 
 ```output
-+------------+-----------+-----------+--------------+---------------------------+-------+
-| zmode      | zuid      | zgid      | size         | mtime                     | name  |
-+------------+-----------+-----------+--------------+---------------------------+-------+
-| -r-xr-x--- | asperaweb | asperaweb | 104857600    | 2022-10-27 16:06:38 +0200 | 100MB |
-| -r-xr-x--- | asperaweb | asperaweb | 10737418240  | 2022-10-27 16:08:12 +0200 | 10GB  |
-| -r-xr-x--- | asperaweb | asperaweb | 500000000000 | 2022-10-27 16:06:26 +0200 | 500GB |
-| -r-xr-x--- | asperaweb | asperaweb | 524288000    | 2022-10-27 14:53:00 +0200 | 500MB |
-| -r-xr-x--- | asperaweb | asperaweb | 1048576000   | 2022-10-27 16:06:37 +0200 | 1GB   |
-| -r-xr-x--- | asperaweb | asperaweb | 5368709120   | 2022-10-27 14:53:47 +0200 | 5GB   |
-| -r-xr-x--- | asperaweb | asperaweb | 209715200    | 2022-10-27 14:52:56 +0200 | 200MB |
-+------------+-----------+-----------+--------------+---------------------------+-------+
+╭────────────┬──────┬───────────┬─────────────┬───────────────────────────┬───────╮
+│ zmode      │ zuid │ zgid      │ size        │ mtime                     │ name  │
+╞════════════╪══════╪═══════════╪═════════════╪═══════════════════════════╪═══════╡
+│ -rw-r--r-- │ xfer │ demousers │ 5368709120  │ 2014-11-05 16:01:56 +0100 │ 5GB   │
+│ -rw-r--r-- │ xfer │ demousers │ 524288000   │ 2014-11-05 16:01:56 +0100 │ 500MB │
+│ -rw-r--r-- │ xfer │ demousers │ 209715200   │ 2014-11-05 16:01:56 +0100 │ 200MB │
+│ -rw-r--r-- │ xfer │ demousers │ 1048576000  │ 2014-11-05 16:01:56 +0100 │ 1GB   │
+│ -rw-r--r-- │ xfer │ demousers │ 104857600   │ 2014-11-05 16:01:56 +0100 │ 100MB │
+│ -rw-r--r-- │ xfer │ demousers │ 10737418240 │ 2014-11-05 16:01:56 +0100 │ 10GB  │
+╰────────────┴──────┴───────────┴─────────────┴───────────────────────────┴───────╯
 ```
 
 ```bash
@@ -224,10 +223,28 @@ A package with pre-installed Ruby, gem and `ascp` may also be provided.
 
 ### `ascli` executable
 
-**Note:** This is an Alpha feature. The binary depends on certain GLIBC version for Linux.
-
 It is planned to provide `ascli` as a single platform-dependent executable.
-[Alpha releases can be found here](https://ibm.biz/aspera-cli-exe).
+[Releases can be found here](https://ibm.biz/aspera-cli-exe).
+
+**Note:** This is an Alpha feature. On Linux, the executable requires a minimum GLIBC version.
+
+On Linux, check your GLIBC version with `ldd`:
+
+```console
+$ ldd --version | head -n1
+ldd (GNU libc) 2.34
+```
+
+Check an executable's min required version:
+
+```console
+$ objdump -p /bin/bash | sed -n 's/^.*GLIBC_//p' | sort -V | tail -n1
+2.34
+```
+
+> **Note:** if `objdump` is not available use `strings` or `grep -z 'GLIBC_'|tr \\0 \\n`
+
+The `ascli` executable still requires installation of `ascp`: Refer to [Install `ascp`](#installation-of-ascp-through-transferd).
 
 ### Ruby
 
@@ -293,7 +310,7 @@ RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl@3.0)" rvm instal
 
 If your Linux distribution provides a standard Ruby package, you can use it provided that the version supported.
 
-**Example:** RHEL 8+, Rocky Linux 8+, Centos 8 Stream: with extensions to compile native gems
+**Example:** RHEL 8+, Rocky Linux 8+: with extensions to compile native gems
 
 - Check available Ruby versions:
 
@@ -481,7 +498,7 @@ JRUBY_OPTS=--dev ascli -v
 
 #### Optional gems
 
-Some additional gems are required for some specific features, see [Gemfile.optional](Gemfile.optional):
+Some additional gems are required for some specific features, see [Gemfile](Gemfile):
 
 | name | version | comment |
 | ---- | ------- | ------- |
@@ -508,7 +525,7 @@ gem install bigdecimal -v '~> 3.1.9'
 Once you have Ruby and rights to install gems, install the `aspera-cli` gem and its dependencies:
 
 ```bash
-gem install aspera-cli
+gem install aspera-cli --pre
 ```
 
 To upgrade to the latest version:
@@ -518,7 +535,7 @@ gem update aspera-cli
 ```
 
 During its execution, `ascli` checks every week if a new version is available and notifies the user in a WARN log.
-To de-activate this feature, globally set the option `version_check_days` to `0`, or specify a different period in days.
+To unactivate this feature, globally set the option `version_check_days` to `0`, or specify a different period in days.
 
 To check if a new version is available (independently of `version_check_days`):
 
@@ -528,18 +545,18 @@ ascli config check_update
 
 #### Gem installation with signature verification
 
-The gem is signed with a private key, and the public certificate is available in the github repository (`certs/aspera-cli-public-cert.pem`).
+The gem is signed with a private key, and the public certificate is available in the gitHub repository (`certs/aspera-cli-public-cert.pem`).
 When installing the gem, the signature can be optionally verified.
 
 For [secure installation](https://guides.rubygems.org/security/#using-gems), one can install the gem with the public key:
 
-- import the verification certificate:
+Import the verification certificate:
 
 ```bash
 gem cert --add <(curl -Ls https://raw.githubusercontent.com/IBM/aspera-cli/main/certs/aspera-cli-public-cert.pem)
 ```
 
-- Then, install the gem:
+The user installs the gem with `HighSecurity` or `MediumSecurity`: this will succeed only of the gem is trusted:
 
 ```bash
 gem install -P MediumSecurity aspera-cli
@@ -561,7 +578,7 @@ The easiest option to install `ascp` is through the use of the IBM Aspera Transf
 
 Supported platforms are listed in the [Release Notes](https://developer.ibm.com/apis/catalog/aspera--aspera-transfer-sdk/Release+notes) and archives can be downloaded from [Downloads](https://developer.ibm.com/apis/catalog/aspera--aspera-transfer-sdk/downloads/downloads.json).
 
-Install with:
+Install using `ascli` for the current platform with:
 
 ```bash
 ascli config ascp install
@@ -573,10 +590,16 @@ or
 ascli config transferd install
 ```
 
-This command will retrieve the list of current archives for all platforms from: <https://ibm.biz/sdk_location> and then select the latest version for the current platform.
-In this case, the default value for option `sdk_url` is `DEF`.
+The installation of the transfer binary follows those steps:
 
-Available Transfer Daemon versions can be listed with: `ascli config transferd list`
+- Check the value of option `sdk_url`: if the value is the default value `DEF`, then the procedure follows, else it specified a URL where to take the archive from.
+- The location of archives is retrieved from the url specified by option `locations_url` whose default value is <https://ibm.biz/sdk_location>
+- The archive for the current system architecture (CPU and OS) is selected and downloaded.
+
+The option `locations_url` can be set to override the URL where the list of versions is located, in case of air-gap environment or for testing.
+Option `sdk_url` can be set to specify a direct location for the transfer binaries.
+
+Available Transfer Daemon versions available from `locations_url` can be listed with: `ascli config transferd list`
 
 To install a specific version, e.g. 1.1.3:
 
@@ -651,17 +674,7 @@ The procedure:
 cd $HOME && tar zcvf rvm-ascli.tgz .rvm
 ```
 
-- Show the Aspera SDK URL
-
-```bash
-ascli --show-config --fields=sdk_url
-```
-
-- Download the SDK archive from that URL
-
-```bash
-curl -Lso sdk.zip https://ibm.biz/aspera_transfer_sdk
-```
+- Download the SDK archive for the selected architecture, follow [Install `ascp`](#installation-of-ascp-through-transferd)
 
 - Transfer those 2 files to the target system
 
@@ -674,7 +687,7 @@ tar zxvf rvm-ascli.tgz
 
 source ~/.rvm/scripts/rvm
 
-ascli config ascp install --sdk-url=file:///sdk.zip
+ascli config ascp install --sdk-url=file:///[SDK archive file path]
 ```
 
 - Add those lines to shell init (`.profile`)
@@ -689,18 +702,18 @@ Installation without network:
 
 It is essentially the same procedure as installation for Windows with internet, but instead of retrieving files from internet, copy the files from a machine with internet access, and then install from those archives:
 
-- Download the `exe` Ruby installer from <https://rubyinstaller.org/downloads/>
+- Download the Ruby installer from <https://rubyinstaller.org/downloads/>
 
   ```bash
-  v=$(curl -s https://rubyinstaller.org/downloads/|sed -nEe 's|.*(https://.*/releases/download/.*exe).*|\1|p'|head -n 1)
+  v=$(curl -s https://rubyinstaller.org/downloads/ | sed -nEe 's|.*(https://.*/releases/download/.*exe).*|\1|p' | head -n 1)
   curl -o ${v##*/} $v
   ```
 
 - Create an archive with necessary gems like in previous section
 
-- Download the SDK from: <https://ibm.biz/aspera_transfer_sdk>
+- Download the SDK following [Install `ascp`](#installation-of-ascp-through-transferd)
 
-- Create a Zip with all those files, and transfer to the target system.
+- Create a Zip with all those files and transfer to the target system.
 
 Then, on the target system:
 
@@ -711,7 +724,7 @@ Then, on the target system:
 rubyinstaller-devkit-3.2.2-1-x64.exe /silent /currentuser /noicons /dir=C:\aspera-cli
 ```
 
-- Install the gems: Extract the gem archive, and then:
+- Install the gems: Extract the gem archive and then:
 
 ```bat
 gem install --force --local *.gem
@@ -785,7 +798,7 @@ ascli -v
 ```
 
 ```text
-4.21.1
+4.22.0.pre
 ```
 
 In order to keep persistency of configuration on the host, you should specify your user's configuration folder as a volume for the container.
@@ -886,7 +899,7 @@ podman load -i ascli_image_latest.tar.gz
 
 #### Container: `aspera.conf`
 
-`ascp`'s configuration file `aspera.conf` is located in the container at: `/aspera_sdk/aspera.conf` (see Dockerfile).
+`ascp`'s configuration file `aspera.conf` is located in the container at: `/ibm_aspera/aspera.conf` (see Dockerfile).
 As the container is immutable, it is not recommended to modify this file.
 If one wants to change the content, it is possible to tell `ascp` to use another file using `ascp` option `-f`, e.g. by locating it on the host folder `$HOME/.aspera/ascli` mapped to the container folder `/home/cliuser/.aspera/ascli`:
 
@@ -1700,12 +1713,12 @@ ascli aoc admin user list --fields=name,email,ats_admin --query=@json:'{"sort":"
 ```
 
 ```output
-+-------------------------------+----------------------------------+-----------+
-|             name              |              email               | ats_admin |
-+-------------------------------+----------------------------------+-----------+
-| John Curtis                   | john@example.com                 | true      |
-| Laurent Martin                | laurent@example.com              | true      |
-+-------------------------------+----------------------------------+-----------+
+╭────────────────┬─────────────────────┬───────────╮
+│ name           │ email               │ ats_admin │
+╞════════════════╪═════════════════════╪═══════════╡
+│ John Curtis    │ john@example.com    │ true      │
+│ Laurent Martin │ laurent@example.com │ true      │
+╰────────────────┴─────────────────────┴───────────╯
 ```
 
 > **Note:** Option `select` filters elements from the result of command, while the `query` option gives filtering parameters to the API when listing elements.
@@ -1836,12 +1849,12 @@ ascli config echo @json:@extend:'{"hello":true,"version":"@preset:config.version
 ```
 
 ```output
-+---------+-----------+
-| field   | value     |
-+---------+-----------+
-| hello   | true      |
-| version | 4.14.0    |
-+---------+-----------+
+╭─────────┬────────╮
+│ field   │ value  │
+╞═════════╪════════╡
+│ hello   │ true   │
+│ version │ 4.21.1 │
+╰─────────┴────────╯
 ```
 
 Example: Create a `Hash` from YAML provided as shell **heredoc**:
@@ -2588,13 +2601,13 @@ It will display the exact content of HTTP requests and responses.
 To ignore SSL certificate for **any** address/port, use option: `insecure`, i.e. `--insecure=yes`.
 To ignore SSL certificate for a list of specific address/port, use option `ignore_certificate`, set to an `Array` of URL for which certificate will be ignored (only the address and port are matched), e.g. `--ignore-certificate=@list:,https://127.0.0.1:9092`
 
-> **Note:** Ignoring certificate also applies to `ascp`'s wss.
+> **Note:** Ignoring certificate also applies to `ascp` WSS.
 
 Ignoring a certificate is not recommended, it is better to add the certificate to the trusted store.
 So, a warning is displayed when a certificate is ignored.
 To disable the warning, use option `silent_insecure` set to `no`.
 
-HTTP connection parameters (not `ascp` wss) can be adjusted using option `http_options`:
+HTTP connection parameters (not `ascp` WSS) can be adjusted using option `http_options`:
 
 | Parameter                 | Default       | Where     |
 |---------------------------|---------------|-----------|
@@ -2760,11 +2773,12 @@ ascli config ascp info
 ```
 
 ```output
-+--------------------+-----------------------------------------------------------+
-| field              | value                                                     |
-+--------------------+-----------------------------------------------------------+
-| ascp               | /Users/laurent/.aspera/ascli/sdk/ascp                     |
+╭─────────┬──────────────────────────────────────────────────╮
+│ field   │ value                                            │
+╞═════════╪══════════════════════════════════════════════════╡
+│ ascp    │ /Users/john/.aspera/sdk/ascp                     │
 ...
+╰─────────┴──────────────────────────────────────────────────╯
 ```
 
 #### Selection of `ascp` location for [`direct`](#agent-direct) agent
@@ -2887,7 +2901,7 @@ The following agents are supported and selected with option `transfer`:
 | [`direct`](#agent-direct)          | local    | direct execution of `ascp`    |
 | [`transferd`](#agent-transfer-sdk) | local    | Aspera Transfer Daemon        |
 | [`connect`](#agent-connect-client) | local    | Aspera Connect Client         |
-| [`alpha`](#agent-desktop-client)   | local    | Aspera for Desktop            |
+| [`desktop`](#agent-desktop-client) | local    | Aspera for Desktop            |
 | [`node`](#agent-node-api)          | remote   | Aspera Transfer Node          |
 | [`httpgw`](#agent-http-gateway)    | remote   | Aspera HTTP Gateway           |
 
@@ -2912,7 +2926,7 @@ The `transfer_info` option accepts the following optional parameters to control
 
 | Name                   | Type    | Description |
 |------------------------|---------|-------------|
-| `wss`                  | `Bool`    | Web Socket Session<br/>Enable use of web socket session in case it is available<br/>Default: true |
+| `wss`                  | `Bool`    | Web Socket Session<br/>Enable use of web socket session in case it is available<br/>Default: `true` |
 | `quiet`                | `Bool`    | If `true`, then `ascp` progress bar is not shown.<br/>Default: `false` |
 | `trusted_certs`        | `Array`   | List of repositories for trusted certificates. |
 | `client_ssh_key`       | `String` | SSH Keys to use for token-based transfers. One of: `dsa_rsa`, `rsa`, `per_client`. Default: `rsa` |
@@ -3046,7 +3060,7 @@ There are no option for `transfer_info`.
 
 #### Agent: Desktop Client
 
-By specifying option: `--transfer=alpha`, `ascli` will start transfers using the locally installed **IBM Aspera Desktop Client**.
+By specifying option: `--transfer=desktop`, `ascli` will start transfers using the locally installed **IBM Aspera Desktop Client**.
 There are no option for `transfer_info`.
 
 #### Agent: Node API
@@ -3058,10 +3072,10 @@ Parameters provided in option `transfer_info` are:
 
 | Nam  e     | Type   | Description                                      |
 |------------|--------|--------------------------------------------------|
-| `url`      | `String` | URL of the node API</br>Mandatory                |
-| `username` | `String` | Node api user or access key</br>Mandatory        |
-| `password` | `String` | Password, secret or bearer token</br>Mandatory   |
-| `root_id`  | `String` | Root file id</br>Mandatory only for bearer token |
+| `url`      | `String` | URL of the node API<br/>Mandatory                |
+| `username` | `String` | Node api user or access key<br/>Mandatory        |
+| `password` | `String` | Password, secret or bearer token<br/>Mandatory   |
+| `root_id`  | `String` | Root file id<br/>Mandatory only for bearer token |
 
 Like any other option, `transfer_info` can get its value from a pre-configured [Option Preset](#option-preset) :
 
@@ -3088,12 +3102,12 @@ By specifying option: `--transfer=httpgw`, `ascli` will start transfers using th
 
 Parameters provided in option `transfer_info` are:
 
-| Name                   | Type   | Description                           |
-|------------------------|--------|---------------------------------------|
-| url                    | `String` | URL of the HTTP GW</br>Mandatory      |
-| upload_chunk_size      | `Integer`    | Size in bytes of chunks for upload<br/>Default: `64000`    |
-| api_version            | `String` | Force use of version (`v1`, `v2`)<br/>Default: `v2`       |
-| synchronous            | `Bool`   | Wait for each message acknowledgment<br/>Default: `false`  |
+| Name                | Type      | Description                           |
+|---------------------|-----------|---------------------------------------|
+| `url`               | `String`  | URL of the HTTP GW<br/>Mandatory |
+| `upload_chunk_size` | `Integer` | Size in bytes of chunks for upload<br/>Default: `64000` |
+| `api_version`       | `String`  | Force use of version (`v1`, `v2`)<br/>Default: `v2` |
+| `synchronous`       | `Bool`    | Wait for each message acknowledgment<br/>Default: `false` |
 
 Example:
 
@@ -3112,11 +3126,11 @@ Set option `transfer` to `transferd`.
 
 Options for `transfer_info` are:
 
-| Name     | Type   | Description |
-|----------|--------|-------------|
-| `url`      | `String` | IP address and port listened by the daemon</br>Mandatory<br/>Default: `:0` |
-| `external` | `Bool`   | Use external daemon, do not start one.<br/>Default: `false` |
-| `keep`     | `Bool`   | Keep the daemon running after exiting `ascli`<br/>Default: `false` |
+| Name     | Type     | Description |
+|----------|----------|-------------|
+| `url`    | `String` | IP address and port listened by the daemon<br/>Mandatory<br/>Default: `:0` |
+| `start`  | `Bool`   | Start a new daemon.<br/>Default: `true` |
+| `stop`   | `Bool`   | Stop daemon when exiting `ascli`<br/>Default: `true` |
 
 > **Note:** If port zero is specified in the URL, then the daemon will listen on a random available port. If no address is specified, then `127.0.0.1` is used.
 
@@ -3199,9 +3213,9 @@ Columns:
 
 `ascp` argument or environment variable is provided in description.
 
-| Field | Type | N | D | A | T | H | C | Description |
+| Field | Type | D | N | D | T | H | C | Description |
 | ----- | ---- | - | - | - | - | - | - | ----------- |
-| apply_local_docroot | bool | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Apply local docroot to source paths.<br/>(--apply-local-docroot) |
+| apply_local_docroot | bool | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Apply local docroot to source paths.<br/>(--apply-local-docroot) |
 | authentication | string | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Y | value=token for SSH bypass keys, else password asked if not provided.<br/>(&lt;ignored&gt;) |
 | cipher | string | Y | Y | Y | Y | Y | Y | In transit encryption type.<br/>Allowed values: none, aes-128, aes-192, aes-256, aes-128-cfb, aes-192-cfb, aes-256-cfb, aes-128-gcm, aes-192-gcm, aes-256-gcm<br/>(-c (conversion){enum}) |
 | cipher_allowed | string | Y | Y | Y | Y | Y | Y | returned by node API. Valid literals include "aes-128" and "none".<br/>(&lt;ignored&gt;) |
@@ -3211,7 +3225,7 @@ Columns:
 | cookie | string | Y | Y | Y | Y | Y | Y | Metadata for transfer specified by application<br/>(env:ASPERA_SCP_COOKIE) |
 | create_dir | bool | Y | Y | Y | Y | Y | Y | Specifies whether to create new directories.<br/>(-d) |
 | delete_before_transfer | bool | Y | Y | Y | Y | Y | Y | Before transfer, delete files that exist at the destination but not at the source.<br/>The source and destination arguments must be directories that have matching names.<br/>Objects on the destination that have the same name but different type or size as objects<br/>on the source are not deleted.<br/>(--delete-before-transfer) |
-| delete_source | bool | Y | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Remove SRC files after transfer success<br/>(--remove-after-transfer) |
+| delete_source | bool | Y | Y | Y | &nbsp; | &nbsp; | &nbsp; | Remove SRC files after transfer success<br/>(--remove-after-transfer) |
 | destination_root | string | Y | Y | Y | Y | Y | Y | Destination root directory.<br/>(&lt;special&gt;) |
 | destination_root_id | string | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | The file ID of the destination root directory.<br/>Required when using Bearer token auth for the destination node.<br/>(&lt;ignored&gt;) |
 | dgram_size | int | Y | Y | Y | Y | Y | Y | UDP datagram size in bytes<br/>(-Z {int}) |
@@ -3220,11 +3234,11 @@ Columns:
 | exclude_older_than | string | Y | Y | Y | Y | Y | Y | Exclude files, but not directories, from the transfer if they are older than the specified number of seconds added to the source computer's epoch. e.g. "-86400" for older than a day back.<br/>(--exclude-older-than {string}) |
 | fasp_port | int | Y | Y | Y | Y | Y | Y | Specifies fasp (UDP) port.<br/>(-O {int}) |
 | fasp_url | string | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Only used in Faspex.<br/>(&lt;ignored&gt;) |
-| file_checksum | string | Y | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Enable checksum reporting for transferred files by specifying the hash to use.<br/>Allowed values: sha-512, sha-384, sha-256, sha1, md5, none<br/>(&lt;ignored&gt;) |
+| file_checksum | string | Y | Y | Y | &nbsp; | &nbsp; | &nbsp; | Enable checksum reporting for transferred files by specifying the hash to use.<br/>Allowed values: sha-512, sha-384, sha-256, sha1, md5, none<br/>(&lt;ignored&gt;) |
 | http_fallback | bool<br/>string | Y | Y | Y | Y | Y | Y | When true(1), attempts to perform an HTTP transfer if a FASP transfer cannot be performed.<br/>(-y (conversion){bool}\|{string}) |
-| http_fallback_port | int | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Specifies http port when no cipher is used<br/>(-t {int}) |
+| http_fallback_port | int | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Specifies http port when no cipher is used<br/>(-t {int}) |
 | https_fallback_port | int | Y | Y | Y | Y | Y | Y | Specifies https port when cipher is used<br/>(-t {int}) |
-| keepalive | bool | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | The session is running in persistent session mode.<br/>(--keepalive) |
+| keepalive | bool | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | The session is running in persistent session mode.<br/>(--keepalive) |
 | lock_min_rate | bool | Y | Y | Y | Y | Y | Y | TODO: remove ?<br/>(&lt;ignored&gt;) |
 | lock_min_rate_kbps | bool | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Y | If true, lock the minimum transfer rate to the value set for min_rate_kbps.<br/>If false, users can adjust the transfer rate up to the value set for target_rate_cap_kbps.<br/>(&lt;ignored&gt;) |
 | lock_rate_policy | bool | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Y | If true, lock the rate policy to the default value.<br/>(&lt;ignored&gt;) |
@@ -3232,25 +3246,25 @@ Columns:
 | lock_target_rate_kbps | bool | Y | Y | Y | Y | Y | Y | If true, lock the target transfer rate to the default value set for target_rate_kbps.<br/>If false, users can adjust the transfer rate up to the value set for target_rate_cap_kbps.<br/>(&lt;ignored&gt;) |
 | min_rate_cap_kbps | int | Y | Y | Y | Y | Y | Y | The highest minimum rate that an incoming transfer can request, in kilobits per second.<br/>Client minimum rate requests that exceed the minimum rate cap are ignored.<br/>The default value of unlimited applies no cap to the minimum rate. (Default: 0)<br/>(&lt;ignored&gt;) |
 | min_rate_kbps | int | Y | Y | Y | Y | Y | Y | Set the minimum transfer rate in kilobits per second.<br/>(-m {int}) |
-| move_after_transfer | string | Y | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | The relative path to which the files will be moved after the transfer at the source side. Available as of 3.8.0.<br/>(--move-after-transfer {string}) |
+| move_after_transfer | string | Y | Y | Y | &nbsp; | &nbsp; | &nbsp; | The relative path to which the files will be moved after the transfer at the source side. Available as of 3.8.0.<br/>(--move-after-transfer {string}) |
 | multi_session | int | Y | Y | Y | Y | Y | Y | Use multi-session transfer. max 128.<br/>Each participant on one host needs an independent UDP (-O) port.<br/>Large files are split between sessions only when transferring with resume_policy=none.<br/><br/>(&lt;special&gt;) |
-| multi_session_threshold | int | Y | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Split files across multiple ascp sessions if their size in bytes is greater than or equal to the specified value.<br/>(0=no file is split)<br/>(--multi-session-threshold {int}) |
+| multi_session_threshold | int | Y | Y | Y | &nbsp; | &nbsp; | &nbsp; | Split files across multiple ascp sessions if their size in bytes is greater than or equal to the specified value.<br/>(0=no file is split)<br/>(--multi-session-threshold {int}) |
 | obfuscate_file_names | bool | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Y | &nbsp; | HTTP Gateway obfuscates file names when set to true.<br/>(&lt;ignored&gt;) |
 | overwrite | string | Y | Y | Y | Y | Y | Y | Overwrite destination files with the source files of the same name.<br/>Allowed values: never, always, diff, older, diff+older<br/>(--overwrite {enum}) |
-| password | string | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Password for local Windows user when transfer user associated with node api user is not the same as the one running asperanoded.<br/>Allows impersonating the transfer user and have access to resources (e.g. network shares).<br/>Windows only, node api only.<br/>(&lt;ignored&gt;) |
+| password | string | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Password for local Windows user when transfer user associated with node api user is not the same as the one running asperanoded.<br/>Allows impersonating the transfer user and have access to resources (e.g. network shares).<br/>Windows only, node api only.<br/>(&lt;ignored&gt;) |
 | paths | array | Y | Y | Y | Y | Y | Y | Array of path to the source (required) and a path to the destination (optional).<br/>(&lt;special&gt;) |
 | precalculate_job_size | bool | Y | Y | Y | Y | Y | Y | Specifies whether to precalculate the job size.<br/>(--precalculate-job-size) |
 | preserve_access_time | bool | Y | Y | Y | Y | Y | Y | Preserve the source-file access timestamps at the destination.<br/>Because source access times are updated by the transfer operation,<br/>the timestamp that is preserved is the one just before to the transfer.<br/>(--preserve-access-time) |
-| preserve_acls | string | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Preserve access control lists.<br/>Allowed values: none, native, metafile<br/>(--preserve-acls {enum}) |
+| preserve_acls | string | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Preserve access control lists.<br/>Allowed values: none, native, metafile<br/>(--preserve-acls {enum}) |
 | preserve_creation_time | bool | Y | Y | Y | Y | Y | Y | (Windows only) Preserve source-file creation timestamps at the destination.<br/>Only Windows systems retain information about creation time.<br/>If the destination is not a Windows computer, this option is ignored.<br/>(--preserve-creation-time) |
 | preserve_extended_attrs | string | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Preserve the extended attributes.<br/>Allowed values: none, native, metafile<br/>(--preserve-xattrs {enum}) |
-| preserve_file_owner_gid | bool | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Preserve the group ID for a file owner<br/>(--preserve-file-owner-gid) |
-| preserve_file_owner_uid | bool | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Preserve the user ID for a file owner<br/>(--preserve-file-owner-uid) |
+| preserve_file_owner_gid | bool | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Preserve the group ID for a file owner<br/>(--preserve-file-owner-gid) |
+| preserve_file_owner_uid | bool | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Preserve the user ID for a file owner<br/>(--preserve-file-owner-uid) |
 | preserve_modification_time | bool | Y | Y | Y | Y | Y | Y | Set the modification time, the last time a file or directory was modified (written), of a transferred file<br/>to the modification of the source file or directory.<br/>Preserve source-file modification timestamps at the destination.<br/>(--preserve-modification-time) |
-| preserve_remote_acls | string | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Preserve remote access control lists.<br/>Allowed values: none, native, metafile<br/>(--remote-preserve-acls {enum}) |
-| preserve_source_access_time | bool | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Preserve the time logged for when the source file was accessed<br/>(--preserve-source-access-time) |
-| preserve_times | bool | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Preserve file timestamps.<br/>(--preserve-times) |
-| proxy | string | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Specify the address of the Aspera high-speed proxy server.<br/>dnat(s)://[user[:password]@]server:port<br/>Default ports for DNAT and DNATS protocols are 9091 and 9092.<br/>Password, if specified here, overrides the value of environment variable ASPERA_PROXY_PASS.<br/>(--proxy {string}) |
+| preserve_remote_acls | string | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Preserve remote access control lists.<br/>Allowed values: none, native, metafile<br/>(--remote-preserve-acls {enum}) |
+| preserve_source_access_time | bool | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Preserve the time logged for when the source file was accessed<br/>(--preserve-source-access-time) |
+| preserve_times | bool | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Preserve file timestamps.<br/>(--preserve-times) |
+| proxy | string | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Specify the address of the Aspera high-speed proxy server.<br/>dnat(s)://[user[:password]@]server:port<br/>Default ports for DNAT and DNATS protocols are 9091 and 9092.<br/>Password, if specified here, overrides the value of environment variable ASPERA_PROXY_PASS.<br/>(--proxy {string}) |
 | rate_policy | string | Y | Y | Y | Y | Y | Y | The transfer rate policy to use when sharing bandwidth.<br/>Allowed values: low, fair, high, fixed<br/>(--policy {enum}) |
 | rate_policy_allowed | string | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Y | Specifies most aggressive rate policy that is allowed.<br/>Returned by node API.<br/>Allowed values: low, fair, high, fixed<br/>(&lt;ignored&gt;) |
 | read_threads | int | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | ascp4 only<br/>(&lt;ignored&gt;) |
@@ -3258,33 +3272,33 @@ Columns:
 | remote_host | string | Y | Y | Y | Y | Y | Y | IP or fully qualified domain name of the remote server<br/>(--host {string}) |
 | remote_password | string | Y | Y | Y | Y | Y | Y | SSH session password<br/>(env:ASPERA_SCP_PASS) |
 | remote_user | string | Y | Y | Y | Y | Y | Y | Remote user. Default value is "xfer" on node or connect.<br/>(--user {string}) |
-| remove_after_transfer | bool | Y | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Remove SRC files after transfer success<br/>(--remove-after-transfer) |
-| remove_empty_directories | bool | Y | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Specifies whether to remove empty directories.<br/>(--remove-empty-directories) |
-| remove_empty_source_directory | bool | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Remove empty source subdirectories and remove the source directory itself, if empty<br/>(--remove-empty-source-directory) |
-| remove_skipped | bool | Y | Y | &nbsp; | &nbsp; | &nbsp; | Y | Must also have remove_after_transfer set to true, Defaults to false, if true, skipped files will be removed as well.<br/>(--remove-skipped) |
+| remove_after_transfer | bool | Y | Y | Y | &nbsp; | &nbsp; | &nbsp; | Remove SRC files after transfer success<br/>(--remove-after-transfer) |
+| remove_empty_directories | bool | Y | Y | Y | &nbsp; | &nbsp; | &nbsp; | Specifies whether to remove empty directories.<br/>(--remove-empty-directories) |
+| remove_empty_source_directory | bool | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Remove empty source subdirectories and remove the source directory itself, if empty<br/>(--remove-empty-source-directory) |
+| remove_skipped | bool | Y | Y | Y | &nbsp; | &nbsp; | Y | Must also have remove_after_transfer set to true, Defaults to false, if true, skipped files will be removed as well.<br/>(--remove-skipped) |
 | resume_policy | string | Y | Y | Y | Y | Y | Y | If a transfer is interrupted or fails to finish, resume without re-transferring the whole files.<br/>Allowed values: none, attrs, sparse_csum, full_csum<br/>(-k (conversion){enum}) |
-| retry_duration | string<br/>int | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Y | Specifies how long to wait before retrying transfer. (e.g. "5min")<br/>(&lt;ignored&gt;) |
+| retry_duration | string<br/>int | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Y | Specifies how long to wait before retrying transfer. (e.g. "5min")<br/>(&lt;ignored&gt;) |
 | source_root | string | Y | Y | Y | Y | Y | Y | Path to be prepended to each source path.<br/>This is either a conventional path or it can be a URI but only if there is no root defined.<br/>(--source-prefix64 (conversion){string}) |
-| source_root_id | string | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | The file ID of the source root directory. Required when using Bearer token auth for the source node.<br/>(&lt;ignored&gt;) |
-| src_base | string | Y | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Specify the prefix to be stripped off from each source object.<br/>The remaining portion of the source path is kept intact at the destination.<br/>Special care must be taken when used with cloud storage.<br/>(--src-base64 (conversion){string}) |
+| source_root_id | string | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | The file ID of the source root directory. Required when using Bearer token auth for the source node.<br/>(&lt;ignored&gt;) |
+| src_base | string | Y | Y | Y | &nbsp; | &nbsp; | &nbsp; | Specify the prefix to be stripped off from each source object.<br/>The remaining portion of the source path is kept intact at the destination.<br/>Special care must be taken when used with cloud storage.<br/>(--src-base64 (conversion){string}) |
 | ssh_args | string | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Array of arguments to pass to SSH. Use with caution.<br/>(&lt;ignored&gt;) |
 | ssh_port | int | Y | Y | Y | Y | Y | Y | Specifies SSH (TCP) port. Default: local:22, other:33001<br/>(-P {int}) |
-| ssh_private_key | string | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Private key used for SSH authentication.<br/>Shall look like: -----BEGIN RSA PRIV4TE KEY-----\nMII...<br/>Note the JSON encoding: \n for newlines.<br/>(env:ASPERA_SCP_KEY) |
-| ssh_private_key_passphrase | string | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | The passphrase associated with the transfer user's SSH private key. Available as of 3.7.2.<br/>(env:ASPERA_SCP_PASS) |
+| ssh_private_key | string | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Private key used for SSH authentication.<br/>Shall look like: -----BEGIN RSA PRIV4TE KEY-----\nMII...<br/>Note the JSON encoding: \n for newlines.<br/>(env:ASPERA_SCP_KEY) |
+| ssh_private_key_passphrase | string | Y | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | The passphrase associated with the transfer user's SSH private key. Available as of 3.7.2.<br/>(env:ASPERA_SCP_PASS) |
 | sshfp | string | Y | Y | Y | Y | Y | Y | Check it against server SSH host key fingerprint<br/>(--check-sshfp {string}) |
 | symlink_policy | string | Y | Y | Y | Y | Y | Y | Handle source side symbolic links<br/>Allowed values: follow, copy, copy+force, skip<br/>(--symbolic-links {enum}) |
 | tags | hash | Y | Y | Y | Y | Y | Y | Metadata for transfer as JSON. Key `aspera` is reserved. Key `aspera.xfer_retry` specified a retry timeout for node api initiated transfers.<br/>(--tags64 (conversion){hash}) |
 | target_rate_cap_kbps | int | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Y | Returned by upload/download_setup node API.<br/>(&lt;ignored&gt;) |
 | target_rate_kbps | int | Y | Y | Y | Y | Y | Y | Specifies desired speed for the transfer.<br/>(-l {int}) |
 | target_rate_percentage | string | Y | Y | Y | Y | Y | Y | TODO: remove ?<br/>(&lt;ignored&gt;) |
-| title | string | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | Y | Title of the transfer<br/>(&lt;ignored&gt;) |
+| title | string | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | Y | Title of the transfer<br/>(&lt;ignored&gt;) |
 | token | string | Y | Y | Y | Y | Y | Y | Authorization token: Bearer, Basic or ATM (Also arg -W)<br/>(env:ASPERA_SCP_TOKEN) |
-| use_ascp4 | bool | Y | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | specify version of protocol<br/>(&lt;special&gt;) |
+| use_ascp4 | bool | Y | Y | Y | &nbsp; | &nbsp; | &nbsp; | specify version of protocol<br/>(&lt;special&gt;) |
 | use_system_ssh | string | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | TODO, comment...<br/>(&lt;ignored&gt;) |
 | write_threads | int | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | ascp4 only<br/>(&lt;ignored&gt;) |
 | wss_enabled | bool | Y | Y | Y | Y | Y | Y | Server has Web Socket service enabled<br/>(&lt;special&gt;) |
 | wss_port | int | Y | Y | Y | Y | Y | Y | TCP port used for websocket service feed<br/>(&lt;special&gt;) |
-| xfer_max_retries | int | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | &nbsp; | maximum number of retries, for node API initiated transfers. Shall not exceed aspera.conf `transfer_manager_max_retries` (default 5).<br/>(&lt;ignored&gt;) |
+| xfer_max_retries | int | &nbsp; | Y | &nbsp; | &nbsp; | &nbsp; | &nbsp; | maximum number of retries, for node API initiated transfers. Shall not exceed aspera.conf `transfer_manager_max_retries` (default 5).<br/>(&lt;ignored&gt;) |
 
 #### Destination folder for transfers
 
@@ -3729,7 +3743,7 @@ ascli server upload "faux:///mydir?file=testfile&count=1m&size=0&inc=2&seq=seque
 ```text
 ascli -h
 NAME
-        ascli -- a command line tool for Aspera Applications (v4.21.1)
+        ascli -- a command line tool for Aspera Applications (v4.22.0.pre)
 
 SYNOPSIS
         ascli COMMANDS [OPTIONS] [ARGS]
@@ -3802,7 +3816,8 @@ OPTIONS: global
         --key-path=VALUE             Wizard: path to private key for JWT
         --ascp-path=VALUE            Path to ascp
         --use-product=VALUE          Use ascp from specified product
-        --sdk-url=VALUE              URL to get SDK
+        --sdk-url=VALUE              URL to get Aspera Transfer Daemon
+        --locations-url=VALUE        URL to get locations of Aspera Transfer Daemon
         --sdk-folder=VALUE           SDK folder path
         --progress-bar=ENUM          Display progress bar: [no], yes
         --smtp=VALUE                 SMTP configuration (Hash)
@@ -3821,7 +3836,7 @@ OPTIONS: global
         --to-folder=VALUE            Destination folder for transferred files
         --sources=VALUE              How list of transferred files is provided (@args,@ts,Array)
         --src-type=ENUM              Type of file list: [list], pair
-        --transfer=ENUM              Type of transfer agent: node, [direct], alpha, transferd, httpgw, connect
+        --transfer=ENUM              Type of transfer agent: desktop, node, [direct], transferd, httpgw, connect
         --transfer-info=VALUE        Parameters for transfer agent (Hash)
 
 COMMAND: config
@@ -3966,10 +3981,10 @@ OPTIONS:
         --thumb-vid-scale=VALUE      Png: video: size (ffmpeg scale argument)
         --thumb-vid-fraction=VALUE   Png: video: time percent position of snapshot
         --thumb-img-size=VALUE       Png: non-video: height (and width)
-        --thumb-text-font=VALUE      Png: plaintext: font to render text with imagemagick convert (identify -list font)
+        --thumb-text-font=VALUE      Png: plaintext: font for text rendering: `magick identify -list font`
         --video-conversion=ENUM      Mp4: method for preview generation: [reencode], blend, clips
         --video-png-conv=ENUM        Mp4: method for thumbnail generation: [fixed], animated
-        --video-scale=VALUE          Mp4: all: video scale (ffmpeg)
+        --video-scale=VALUE          Mp4: all: video scale (ffmpeg scale argument)
         --video-start-sec=VALUE      Mp4: all: start offset (seconds) of video preview
         --reencode-ffmpeg=VALUE      Mp4: reencode: options to ffmpeg
         --blend-keyframes=VALUE      Mp4: blend: # key frames
@@ -5007,7 +5022,7 @@ To list packages in a shared inbox, the query has to be specified with the the s
 Additional parameters can be specified, as supported by the API (to find out available filters, consult the API definition, or use the web interface in developer mode).
 The current workspace is added unless specified in the query.
 
-> **Note:** By default, `exclude_dropbox_packages` is set to true for user packages, and to false for shared inbox packages. This can be overridden in the query.
+> **Note:** By default, `exclude_dropbox_packages` is set to `true` for user packages, and to false for shared inbox packages. This can be overridden in the query.
 
 Using shared inbox name:
 
@@ -5287,7 +5302,9 @@ admin package list --http-options=@json:'{"read_timeout":120.0}'
 admin saml_configuration list
 admin self show
 admin short_link list
-admin subscription
+admin subscription account
+admin subscription usage
+admin subscription usage MONTH
 admin user list
 admin user modify %name:my_user_email @json:'{"deactivated":false}'
 admin workspace list
@@ -5310,8 +5327,8 @@ files browse my_remote_file
 files browse my_remote_folder
 files browse my_remote_folder/
 files delete /testsrc
-files download --transfer=alpha testdst/test_file.bin
 files download --transfer=connect testdst/test_file.bin
+files download --transfer=desktop testdst/test_file.bin
 files find /
 files find / '\.partial$'
 files find / @ruby:'->(f){f["type"].eql?("file")}'
@@ -5740,10 +5757,10 @@ Examples of expressions:
   ascli node access_keys do self find /Documents '*.txt'
   ```
 
-The following are examples of `ruby_lambda` to be provided in the following template command:
+The following are examples of Ruby lambda code to be provided in the following template command:
 
 ```bash
- ascli node access_keys do self find / @ruby:'ruby_lambda'
+ ascli node access_keys do self find / @ruby:'->(f){[code here]}'
 ```
 
 > **Note:** Single quotes are used here above to protect the whole **Ruby** expression from the shell. Then double quotes are used for strings in the **Ruby** expression to not mix with the shell.
@@ -5791,7 +5808,7 @@ ascli node access_keys do self find / @ruby:'->(f){f["type"].eql?("file") and (D
 When a transfer is run, its information is stored (typicall, 1 day) in the HSTS database (Redis).
 This information can be retrieved with command: `transfer list`.
 
-If the number of transfer is too large, then the list will be retrieved in several API calls.
+If the number of transfers is too large, then the list will be retrieved using several API calls.
 
 In addition, it is possible to list "only new information" using option `once_only`.
 
@@ -5799,7 +5816,7 @@ In addition, it is possible to list "only new information" using option `once_on
 ascli node transfer list --once-only=yes
 ```
 
-The `iteratin_token` that keeps memory of latest event is stored in the persistance repository of `ascli`.
+The `iteration_token` that keeps memory of latest event is stored in the persistance repository of `ascli`.
 To reset it, add option: `--query=@json:'{"reset": true}'`.
 To list only a number of events, use the `max` parameter in query.
 Other parameters are directly transmitted to the underlying API (`GET /ops/transfers`).
@@ -5961,6 +5978,8 @@ Bearer tokens can be generated using command `bearer_token`: it takes two argume
 
 | parameter                 | Default                     | type      | description                                              |
 | ------------------------  |-----------------------------|-----------|----------------------------------------------------------|
+| _scope                    | `user:all`                  | Special   | Either `user:all` or `admin:all`                         |
+| _validity                 | 86400                       | Special   | Validity in seconds from now.                            |
 | user_id                   | -                           | Mandatory | Identifier of user                                       |
 | scope                     | `node.<access_key>:<_scope>`| Mandatory | API scope, e.g. `node.<access_key>:<node scope>`         |
 | expires_at                | `now+<_validity>`           | Mandatory | Format: `%Y-%m-%dT%H:%M:%SZ` e.g. `2021-12-31T23:59:59Z` |
@@ -5968,12 +5987,10 @@ Bearer tokens can be generated using command `bearer_token`: it takes two argume
 | group_ids                 | -                           | Optional  | List of group ids                                        |
 | organization_id           | -                           | Optional  | Organization id                                          |
 | watermarking_json_base64  | -                           | Optional  | Watermarking information (not used)                      |
-| _scope                    | `user:all`                  | Special   | Either `user:all` or `admin:all`                         |
-| _validity                 | 86400                       | Special   | Validity in seconds from now.                            |
 
 > **Note:** For convenience, `ascli` provides additional parameters `_scope` and `_validity`.
 > They are not part of the API and are removed from the final payload.
-> They are used respectively to build the default value of `scope` and `expires_at`.
+> They are used respectively to easily set a value for `scope` and `expires_at`.
 
 #### Bearer token: Environment
 
@@ -6087,6 +6104,7 @@ access_key do my_ak_name show %id:1
 access_key do my_ak_name show /test_nd_ak3
 access_key do my_ak_name upload 'faux:///test_nd_ak3?100k' --default-ports=no
 access_key do self permission %id:root_id create @json:'{"access_type":"user","access_id":"666"}'
+access_key do self permission / show 1
 access_key do self show / --fields=id --output=root_id
 access_key list
 access_key set_bearer_key self @file:my_private_key
@@ -6303,6 +6321,7 @@ ascli config preset update f5boot --url=https://localhost/aspera/faspex --auth=b
 
 ```bash
 admin accounts list
+admin alternate_addresses list
 admin clean_deleted
 admin contacts list
 admin distribution_lists create @json:'{"name":"test4","contacts":[{"name":"john@example.com"}]}'
@@ -6312,7 +6331,12 @@ admin event app --query=@json:'{"max":20}'
 admin event web
 admin jobs list --query=@json:'{"job_type":"email","status":"failed"}' --fields=id,error_desc
 admin metadata_profiles list
+admin node browse %name:Local
 admin node list
+admin node shared_folders %name:Local list
+admin node shared_folders %name:Local show %name:Main
+admin node shared_folders %name:Local user %name:Main list
+admin node show %name:Local
 admin oauth_clients list --query=@json:'[["client_types[]","public"]]'
 admin registrations list
 admin saml_configs list
@@ -6331,6 +6355,8 @@ gateway --pid-file=pid_f5_fxgw https://localhost:12346/aspera/faspex &
 health
 invitation list
 invitations create @json:'{"email_address":"aspera.user1+u@gmail.com"}'
+packages browse f5_pack_id --query=@json:'{"recursive":true}'
+packages delete f5_pack_id
 packages list --box=my_shared_box_name
 packages list --box=my_workgroup --group-type=workgroups
 packages list --query=@json:'{"mailbox":"inbox","status":"completed"}'
@@ -6338,8 +6364,8 @@ packages receive --box=my_shared_box_name package_box_id1 --to-folder=.
 packages receive --box=my_workgroup --group-type=workgroups workgroup_package_id1 --to-folder=.
 packages receive ALL --once-only=yes --to-folder=.
 packages receive INIT --once-only=yes
-packages receive f5_p31 --to-folder=. --ts=@json:'{"content_protection_password":"my_secret_here"}'
-packages send --shared-folder=%name:my_shared_folder_name @json:'{"title":"test title","recipients":["my_email_internal"]}' my_shared_folder_file
+packages receive f5_pack_id --to-folder=. --ts=@json:'{"content_protection_password":"my_secret_here"}'
+packages send --shared-folder=%name:my_shared_folder_name @json:'{"title":"test title","recipients":["my_email_internal"]}' my_shared_folder_file --fields=id --display=data --output=test
 packages send --url=my_public_link_send_f5_user @json:'{"title":"test title"}' test_file.bin
 packages send --url=my_public_link_send_shared_box @json:'{"title":"test title"}' test_file.bin
 packages send @json:'{"title":"test title","recipients":["my_shared_box_name"],"metadata":{"Options":"Opt1","TextInput":"example text"}}' test_file.bin
@@ -6347,8 +6373,8 @@ packages send @json:'{"title":"test title","recipients":["my_workgroup"]}' test_
 packages send @json:'{"title":"test title","recipients":[{"name":"my_username"}]my_meta}' test_file.bin --ts=@json:'{"content_protection_password":"my_secret_here"}'
 packages show --box=my_shared_box_name package_box_id1
 packages show --box=my_workgroup --group-type=workgroups workgroup_package_id1
-packages show f5_p31
-packages status f5_p31
+packages show f5_pack_id
+packages status f5_pack_id
 postprocessing --pid-file=pid_f5_postproc @json:'{"url":"http://localhost:8088/asclihook","processing":{"script_folder":""}}' &
 shared browse %name:my_src
 shared list
@@ -7127,7 +7153,7 @@ ascli cos node info
 ascli cos node upload 'faux:///sample1G?1g'
 ```
 
-> **Note:** A dummy file `sample1G` of size 2GB is generated using the `faux` PVCL (man `ascp` and section above), but you can, of course, send a real file by specifying a real file path instead.
+> **Note:** A dummy file `sample1G` of size 2GB is generated using the `faux` PVCL scheme (see previous section and `man ascp`), but you can, of course, send a real file by specifying a real file path instead.
 
 ### Cos sample commands
 
@@ -7217,13 +7243,17 @@ To display the value, use `asuserdata`:
 
 ```bash
 asuserdata -a | grep max_request_file_create_size_kb
+```
 
+```console
   max_request_file_create_size_kb: "1024"
+```
 
+```bash
 asconfigurator -x "server; max_request_file_create_size_kb,16384"
 ```
 
-If you use a value different than 16777216, then specify it using option `max_size`.
+If you use a value different than `16777216`, then specify it using option `max_size`.
 
 > **Note:** The HSTS parameter (`max_request_file_create_size_kb`) is in **kiloBytes** while the generator parameter is in **Bytes** (factor of 1024).
 
@@ -7231,12 +7261,12 @@ If you use a value different than 16777216, then specify it using option `max_si
 
 `ascli` requires the following external tools available in the `PATH`:
 
-- **ImageMagick** : `convert` `composite`
+- **ImageMagick** v7+: `magick` `composite`
 - **OptiPNG** : `optipng`
 - **FFmpeg** : `ffmpeg` `ffprobe`
-- **Libreoffice** : `libreoffice`
+- **Libreoffice** : `unoconv`
 
-Here shown on Redhat/CentOS.
+Here shown on Redhat/Rocky Linux.
 
 Other OSes should work as well, but are note tested.
 
@@ -7270,9 +7300,9 @@ curl -s https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.ta
 
 If you don't want to have preview for office documents or if it is too complex you can skip office document preview generation by using option: `--skip-types=office`
 
-The generation of preview in based on the use of `unoconv` and `libreoffice`
+The generation of preview in based on the use of Libreoffice's `unoconv`.
 
-- CentOS 8
+- RHEL 8/Rocky Linux 8+
 
 ```bash
 dnf install unoconv