defgroup "mode"
#==============
groupdesc="
- adu may started in one of two possible modes, each of which
+ adu may be started in one of two possible modes, each of which
corresponds to a different command line option. Exactly one
of these options must be given.
"directory to traverse"
string typestr="path"
dependon="create"
-required
+optional
details="
- The base directory to be traversed recursively. A warning
- message is printed for each subdirectory that could not be
- read because of insufficient permission. These directories
- will be ignored when computing statistics.
+ The base directory to be traversed recursively. Must be
+ given if --create mode was selected. A warning message is
+ printed for each subdirectory that could not be read because
+ of insufficient permission. These directories will be ignored
+ when computing statistics.
"
option "one-file-system" x
one that the argument being processed is on.
"
+option "hash-table-bits" -
+#~~~~~~~~~~~~~~~~~~~~~~~~~
+"specify the size of the uid hash table"
+int typestr="num"
+dependon="create"
+default="10"
+optional
+details="
+ Use a hash table of size 2^num for the uid entries. If more than
+ 2^num different uids own at least one regular file under base-dir,
+ the command fails. Increase this value if you have more than 1024
+ users. Decreasing the value causes adu to use slightly less memory.
+"
+
+
##############################
section "Options for --select"
##############################
number/10^15. The default is to print numbers in human-readable
format.
"
+
+option "user-summary-sort" -
+#~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"how to sort the user-summary"
+enum typestr="col_spec"
+values="name","uid","dir_count","file_count","size"
+default="size"
+optional
+details="
+ It is enough to specify the first letter of the column specifier,
+ e.g. \"--user-summary-sort f\" sorts by file count.
+"