X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/bc206979ee82a00374838fff3044dcaf33338f02..30012ed996dd5336cbfa7394234d1cbbf08a2b78:/doc/sdk/cli/subcommands.html.textile.liquid
diff --git a/doc/sdk/cli/subcommands.html.textile.liquid b/doc/sdk/cli/subcommands.html.textile.liquid
index dddfa30011..3184c0929c 100644
--- a/doc/sdk/cli/subcommands.html.textile.liquid
+++ b/doc/sdk/cli/subcommands.html.textile.liquid
@@ -161,6 +161,80 @@ Available methods: ls, get, put, less, check, docker
+h3(#arv-keep-ls). arv keep ls
+
+
+
+$ arv keep ls --help
+usage: arv-ls [-h] [--retries RETRIES] [-s] locator
+
+List contents of a manifest
+
+positional arguments:
+ locator Collection UUID or locator
+
+optional arguments:
+ -h, --help show this help message and exit
+ --retries RETRIES Maximum number of times to retry server requests that
+ encounter temporary failures (e.g., server down). Default
+ 3.
+ -s List file sizes, in KiB.
+
+
+
+h3(#arv-keep-get). arv keep get
+
+
+
+$ arv keep get --help
+usage: arv-get [-h] [--retries RETRIES]
+ [--progress | --no-progress | --batch-progress]
+ [--hash HASH | --md5sum] [-n] [-r] [-f | --skip-existing]
+ locator [destination]
+
+Copy data from Keep to a local file or pipe.
+
+positional arguments:
+ locator Collection locator, optionally with a file path or
+ prefix.
+ destination Local file or directory where the data is to be written.
+ Default: /dev/stdout.
+
+optional arguments:
+ -h, --help show this help message and exit
+ --retries RETRIES Maximum number of times to retry server requests that
+ encounter temporary failures (e.g., server down). Default
+ 3.
+ --progress Display human-readable progress on stderr (bytes and, if
+ possible, percentage of total data size). This is the
+ default behavior when it is not expected to interfere
+ with the output: specifically, stderr is a tty _and_
+ either stdout is not a tty, or output is being written to
+ named files rather than stdout.
+ --no-progress Do not display human-readable progress on stderr.
+ --batch-progress Display machine-readable progress on stderr (bytes and,
+ if known, total data size).
+ --hash HASH Display the hash of each file as it is read from Keep,
+ using the given hash algorithm. Supported algorithms
+ include md5, sha1, sha224, sha256, sha384, and sha512.
+ --md5sum Display the MD5 hash of each file as it is read from
+ Keep.
+ -n Do not write any data -- just read from Keep, and report
+ md5sums if requested.
+ -r Retrieve all files in the specified collection/prefix.
+ This is the default behavior if the "locator" argument
+ ends with a forward slash.
+ -f Overwrite existing files while writing. The default
+ behavior is to refuse to write *anything* if any of the
+ output files already exist. As a special case, -f is not
+ needed to write to /dev/stdout.
+ --skip-existing Skip files that already exist. The default behavior is to
+ refuse to write *anything* if any files exist that would
+ have to be overwritten. This option causes even devices,
+ sockets, and fifos to be skipped.
+
+
+
h3(#arv-keep-put). arv keep put
@@ -169,7 +243,8 @@ $ arv keep put --help
usage: arv-put [-h] [--max-manifest-depth N | --normalize]
[--as-stream | --stream | --as-manifest | --in-manifest | --manifest | --as-raw | --raw]
[--use-filename FILENAME] [--filename FILENAME]
- [--portable-data-hash] [--project-uuid UUID] [--name NAME]
+ [--portable-data-hash] [--replication N]
+ [--project-uuid UUID] [--name NAME]
[--progress | --no-progress | --batch-progress]
[--resume | --no-resume] [--retries RETRIES]
[path [path ...]]
@@ -215,6 +290,10 @@ optional arguments:
a directory. Implies --manifest.
--portable-data-hash Print the portable data hash instead of the Arvados
UUID for the collection created by the upload.
+ --replication N Set the replication level for the new collection: how
+ many different physical storage devices (e.g., disks)
+ should have a copy of each data block. Default is to
+ use the server-provided default (if any) or 2.
--project-uuid UUID Store the collection in the specified project, instead
of your Home project.
--name NAME Save the collection with the specified name.
@@ -234,59 +313,6 @@ optional arguments:
-h3(#arv-keep-get). arv keep get
-
-
-
-$ arv keep get --help
-usage: arv-get [-h] [--retries RETRIES]
- [--progress | --no-progress | --batch-progress]
- [--hash HASH | --md5sum] [-n] [-r] [-f | --skip-existing]
- locator [destination]
-
-Copy data from Keep to a local file or pipe.
-
-positional arguments:
- locator Collection locator, optionally with a file path or
- prefix.
- destination Local file or directory where the data is to be written.
- Default: /dev/stdout.
-
-optional arguments:
- -h, --help show this help message and exit
- --retries RETRIES Maximum number of times to retry server requests that
- encounter temporary failures (e.g., server down). Default
- 3.
- --progress Display human-readable progress on stderr (bytes and, if
- possible, percentage of total data size). This is the
- default behavior when it is not expected to interfere
- with the output: specifically, stderr is a tty _and_
- either stdout is not a tty, or output is being written to
- named files rather than stdout.
- --no-progress Do not display human-readable progress on stderr.
- --batch-progress Display machine-readable progress on stderr (bytes and,
- if known, total data size).
- --hash HASH Display the hash of each file as it is read from Keep,
- using the given hash algorithm. Supported algorithms
- include md5, sha1, sha224, sha256, sha384, and sha512.
- --md5sum Display the MD5 hash of each file as it is read from
- Keep.
- -n Do not write any data -- just read from Keep, and report
- md5sums if requested.
- -r Retrieve all files in the specified collection/prefix.
- This is the default behavior if the "locator" argument
- ends with a forward slash.
- -f Overwrite existing files while writing. The default
- behavior is to refuse to write *anything* if any of the
- output files already exist. As a special case, -f is not
- needed to write to /dev/stdout.
- --skip-existing Skip files that already exist. The default behavior is to
- refuse to write *anything* if any files exist that would
- have to be overwritten. This option causes even devices,
- sockets, and fifos to be skipped.
-
-
-
h3(#arv-pipeline-run). arv pipeline run
@@ -336,7 +362,7 @@ Options:
h3(#arv-run). arv run
-The @arv-run@ command creates Arvados pipelines at the command line that fan out to multiple concurrent tasks across Arvado compute nodes.
+The @arv-run@ command creates Arvados pipelines at the command line that fan out to multiple concurrent tasks across Arvados compute nodes.
The User Guide has a page on "using arv-run":{{site.baseurl}}/user/topics/arv-run.html.
@@ -361,7 +387,7 @@ optional arguments:
exit
--local Run locally using arv-run-pipeline-instance
--docker-image DOCKER_IMAGE
- Docker image to use, default arvados/jobs
+ Docker image to use, otherwise use instance default.
--ignore-rcode Commands that return non-zero return codes should not
be considered failed.
--no-reuse Do not reuse past jobs.