NAME¶

rbh-report - querying command for robinhood policy engine

SYNOPSIS¶

  rbh-report [options]

AVAILABLE STATS¶

--activity, -a

Display stats about daemon activity.

--fs-info, -i

Display statistics about filesystem contents.

--class-info[=class_expr]

Display Fileclasses summary. Use optional parameter class_expr for retrieving stats about matching fileclasses.

--status-info status_name[:status_value]

Display status summary for the given policy or status name. Optionally filter on status_value.

--entry-info path|id, -e path|id

Display all information about the given entry.

--user-info[=username], -u username

Display user statistics. Use optional parameter username for retrieving stats about a single user.

--group-info[=groupname], -g groupname

Display group statistics. Use optional parameter groupname for retrieving stats about a single group.

--top-dirs[=cnt], -d cnt

Display largest directories. Optional argument indicates the number of directories to be returned (default: 20).

--top-size[=cnt], -s cnt

Display largest files. Optional argument indicates the number of files to be returned (default: 20).

--top-users[=cnt], -U cnt

Display top disk space consumers. Optional argument indicates the number of users to be returned (default: 20).

--oldest-files[=cnt], -o cnt

Display oldest files in the filesystem (ordered by access time). Optional argument indicates the number of entries to be displayed (default: 20). Tip: use '--reverse' option to display newest files.

--oldest-empty-dirs[=cnt], -O cnt

Display oldest empty directories in the filesystem (ordered by modification time). Optional argument indicates the number of dirs to be returned (default: 20).

--deferred-rm, -R

Display files to be removed from HSM.

--dump, -D

Dump all filesystem entries.

--dump-user username

Dump all entries for the given user.

--dump-group groupname

Dump all entries for the given group.

--dump-ost ost_index|ost_set

Dump all entries on the given OST or set of OSTs (e.g. 3,5-8).

--dump-status status_name:status_value

Dump all entries with the given status (e.g. lhsm_status:released).

MAINTENANCE SCHEDULING¶

--next-maintenance[=date_time]

Set/display time of the next maintenance. Expected date_time format is yyyymmddHHMM[SS].

--cancel-maintenance

Cancel the next scheduled maintenance.

FILTER OPTIONS¶

The following filters can be specified for reports:

-P path, --filter-path path

Display the report only for objects in the given path.

-C class_expr, --filter-class class_expr

Only report entries in the matching fileclasses.

--count-min cnt

Display only topuser/userinfo with at least cnt entries

ACCOUNTING REPORT OPTIONS¶

--size-profile, --szprof

Display size profile statistics

--by-count

Sort by count

--by-avgsize

Sort by average file size

--by-size-ratio range, --by-szratio range

Sort on the ratio of files in the given size-range range: <val><sep><val>- or <val><sep><val-1> or <val><sep>inf <val>: 0, 1, 32, 1K 32K, 1M, 32M, 1G, 32G, 1T <sep>: ~ or .. e.g: 1G..inf, 1..1K-, 0..31M

--reverse

Reverse sort order

-S, --split-user-groups

Display the report by user AND group

-F, --force-no-acct

Generate the report without using accounting table (slower)

CONFIG FILE OPTIONS¶

-f cfg_file, --config-file=cfg_file

Path to configuration file (or short name).

OUTPUT FORMAT OPTIONS¶

-c , --csv

Output stats in a csv-like format for parsing

-q , --no-header

Don't display column headers/footers

MISCELLANEOUS OPTIONS¶

-l loglevel, --log-level=loglevel

Force the log verbosity level (overides configuration value). Allowed values: CRIT, MAJOR, EVENT, VERB, DEBUG, FULL.

-h, --help

Display a short help about command line options.

-V, --version

Display version info

SEE ALSO¶

robinhood(1), rbh-find(1), rbh-du(1), rbh-diff(1)