Merge branch '8784-dir-listings'
[arvados.git] / doc / sdk / cli / reference.html.textile.liquid
index ef9882fdc6a81b20374831eeee2ca66071f73917..cd70dfd4ae8e44a077572c8a9cc0044905d7b737 100644 (file)
@@ -4,6 +4,11 @@ navsection: sdk
 navmenu: CLI
 title: "arv reference"
 ...
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
+
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
 
 _In order to use the @arv@ command, make sure that you have a "working environment.":{{site.baseurl}}/user/getting_started/check-environment.html_
 
@@ -54,12 +59,13 @@ h4. @list@
 Arguments accepted by the @list@ subcommand include:
 
 <pre>
-    --limit, -l <i>:     Maximum number of resources to return.
-   --offset, -o <i>:     Number of users to skip before first returned record.
-  --filters, -f <s>:     Conditions for filtering users.
-    --order, -r <s>:     Order in which to return matching users.
-   --select, -s <s>:     Select which fields to return
-     --distinct, -d:     Return each distinct object
+  -l, --limit=<i>        Maximum number of items to return. (Default: 100)
+  -o, --offset=<i>       Number of items to skip before first returned record. (Default: 0)
+  -f, --filters=<s>      Conditions for filtering items.
+  -r, --order=<s>        Order in which to return matching items.
+  -s, --select=<s>       Select which fields to return.
+  -d, --distinct         Return each distinct object.
+  -c, --count=<s>        Type of count to return in items_available ('none' or 'exact'). (Default: exact)
 </pre>
 
 The @--filters@ option takes a string describing a JSON list of filters on which the returned resources should be returned. Each filter is a three-element list of _[field, operator, value]_, where the _operator_ may be one of @=@, @<@, @<=@, @>@, @>=@, @!=@, @like@, or @ilike@.