From: Andre Noll Date: Mon, 10 Nov 2008 09:23:15 +0000 (+0100) Subject: Merge commit 'meins/master' X-Git-Tag: v0.0.5~1 X-Git-Url: http://git.tuebingen.mpg.de/?a=commitdiff_plain;h=3bb9b0ca535be1eb28b64972bdf0e205e6afc93e;hp=-c;p=adu.git Merge commit 'meins/master' --- 3bb9b0ca535be1eb28b64972bdf0e205e6afc93e diff --combined select.ggo index d02fcd3,140311b..c4e1ec0 --- a/select.ggo +++ b/select.ggo @@@ -35,37 -35,70 +35,70 @@@ details= (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 #~~~~~~~~~~~~~~~~~~~~~ "How to print the results of the query" enum typestr="" - values="global_list","global_summary","user_list","user_summary" - default="global_list" + values="user_summary","user_list","global_summary","global_list" + 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 @@@ -83,32 -116,11 +116,32 @@@ details= option "output" o #~~~~~~~~~~~~~~~~ "file to write output to" -string typestr="" +string typestr="path" optional default="-" details=" - If empty, or not given, use stdout. + If empty, or not given, use stdout. The following conventions + cause the output to be written differently: + + An output file name of \"-\" means stdout. + + \"path\" may be prepended by '>' which instructs adu to + truncate the output file to length zero. If \"path\" does + not start with '>' and \"path\" already exists, the select + query is being aborted. Otherwise, \"path\" is created and + output is written to \"path\". + + If the first two characters of \"path\" are '>', the output + file (given by removing the leading \">>\" from \"path\") + is being opened in append mode. It is no error if the output + file does not exist but, as above, the output file name \">>\" + is considered invalid. + + If the first character of \"path\" is '|', a pipe is created + and the rest of \"path\" is being executed with its standard in + redirected to the reading end of the pipe. The output of adu + is written to the writing end of the pipe. Again, specifying + only \"|\" is considered invalid and causes an error. " option "user-summary-sort" - @@@ -141,12 -153,12 +174,12 @@@ optiona 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 @@@ -156,7 -168,7 +189,7 @@@ 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 @@@ -216,19 -228,20 +249,20 @@@ 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.