(the default), all users are taken into account.
"
-option "limit" L
+option "limit" l
#~~~~~~~~~~~~~~~
"Limit output"
-int typestr="num"
+int typestr="num"
default="-1"
optional
details="
Only print num lines of output. If negative (the default),
- print all lines.
+ print all lines. This option is honored in all select modes
+ except global_summary (which outputs only one single line).
"
-option "no-headers" -
-#~~~~~~~~~~~~~~~~~~~~
-"suppress descriptions for listings/summaries"
-flag off
+option "pattern" p
+#~~~~~~~~~~~~~~~~~
+"only consider matching directories"
+string typestr="regex"
+optional
+details="
+ Regular expression that must match the directory name for
+ the directory to be considered for the output of the query.
+ See regex(7) for details.
+
+ Depending on whether --print-base-dir is given, the absolute
+ directory name or only the part of the directory name below
+ the base directory is matched against \"regex\".
+
+ If this option is not given (the default) all directories
+ are taken into account.
+
+ If \"regex\" starts with '!', directories are matched against
+ the remaining part of \"regex\" and the sense of matching is
+ reversed.
+"
+
+option "header" H
+#~~~~~~~~~~~~~~~~
+"use a customized header for listings/summaries"
+string typestr="string"
+optional
details="
- This is mostly useful to feed the output of adu to scripts.
+ This option can be used to print any string instead of the
+ default header line (which depends on the selected mode).
+
+ In user_list mode the header is a format string which allows
+ to include the uid and the user name in the header. See the
+ --format option for more details.
+
+ It is possible to set this to the empty string to suppress
+ the header completely. This is mostly useful to feed the
+ output to scripts.
"
option "select-mode" m
default="user_summary"
optional
details="
- global_list: List of directories, regardless of owner.
- global_summary: Only print totals.
+ user_summary: Print totals for each admissible uid.
user_list: Print a list for each admissible uid.
- user_summary Print totals for each admissible uid.
+ global_summary: Only print totals.
+ global_list: List of directories, regardless of owner.
"
option "list-sort" s
details="
A string that specifies how the output of the select query is
- going to be formated. Depending on the chosen select-mode,
+ going to be formated. Depending on the chosen select-mode,
several conversion specifiers are available and a different
default value for this option applies.
adu knows four different types of directives: string, id,
- count and size. These are explained in more detail below.
+ count and size. These are explained in more detail below.
The general syntax for string and id directives is %(name:a:w)
where \"name\" is the name of the directive, \"a\" specifies
The alignment specifier is a single character: Either \"l\",
\"r\", or \"c\" may be given to specify left, right and
centered alignment respectively. The with specifier is a
- positive integer. Both \"a\" and \"w\" are optional.
+ positive integer. Both \"a\" and \"w\" are optional.
A string directive supported by adu is \"dirname\" which is
substituted by the name of the directory. It is available
together with their types, and for which modes each of
them may be used.
- pw_name (string): user name. Available for user_list
- and user_summary
+ pw_name (string): user name. Available for user_list,
+ user_summary and for the header in user_list mode.
- uid (id): user id. Available for user_list and
- user_summary.
+ uid (id): user id. Available for user_list,
+ user_summary and for the header in user_list mode.
- files (count): number of files. Available everywhere.
+ files (count): number of files. Available for all
+ modes.
dirname (string): name of the directory. Available
for user_list and global_list.
size (size): total size/ directory size. Available
- everywhere.
+ for all modes.
dirs (count): number of directories. Available
for user_summary and global_summary.