From: Andre Noll Date: Sat, 22 Nov 2008 22:38:39 +0000 (+0100) Subject: Merge commit 'fml/master' X-Git-Tag: v0.1.0~23 X-Git-Url: http://git.tuebingen.mpg.de/?p=adu.git;a=commitdiff_plain;h=22a0aa79753b19604a6fa4273f1479ef71dbf06d;hp=-c Merge commit 'fml/master' --- 22a0aa79753b19604a6fa4273f1479ef71dbf06d diff --combined select.c index 7d1212c,d658585..4417880 --- a/select.c +++ b/select.c @@@ -559,6 -559,9 +559,9 @@@ static int print_user_summary(struct fo case user_summary_sort_arg_size: comp = size_comp; break; + default: /* this should never happen, but anyway */ + comp = size_comp; + break; } sort_hash_table(comp); ret = for_each_admissible_user(print_user_summary_line, &usli); @@@ -939,33 -942,7 +942,33 @@@ static int setup_format_string(char *fm return parse_format_string(fmt, atoms, fi); } -/* return: < 0: error, >0: OK, == 0: help given */ +/** + * Parse a given format string. + * + * \param string The format string to parse. + * \param params gengetopt parameters. + * \param admissible_uids The array of admissible uid ranges. + * \param fi The format info to be used with format_items(). + * + * If \a string is not \p NULL, it is broken down into its components using + * \ref create_argv() and the resulting argument vector is passed together with + * \a params to gengetopt's command line parser. If --help or --detailed-help + * was specified in \a string, the corresponding help text is printed and the + * function returns zero. + * + * Otherwise, any --uid or --user options are parsed and transformed into an + * array of admissible uids which is returned via \a admissible_uids. + * + * Finally, the format string given by --format (or the default format string + * for the given select mode if no --format option was given in \a string) is + * parsed as well resulting in a format_info structure which is returned via + * \a fi. The caller uses the \a fi pointer later to format each output line. + * + * \return Negative on errors, zero if --help or --detailed-help was given, + * positive otherwise. + * + * \sa format_items(). + */ int parse_select_options(char *string, struct select_cmdline_parser_params *params, struct uid_range **admissible_uids, struct format_info **fi) {