rbh-find(1)

💅 rbh-find(1) 💅

okay bestie, welcome to the rbh-find(1) manual page — yes, the find clone that queries the robinhood DB. it's giving "find but make it Robinhood", and we're gonna go through every flag, filter, format directive, and caveat together. no cap. ✨

🌸 NAME 🌸

rbh-find — find clone that query robinhood DB

✨ SYNOPSIS ✨

the whole summoning spell is literally:

rbh-find [options] [path|fid]...

🎀 FILTERS 🎀

okay so these are the filters, bestie — the way you narrow down what you're looking for. iykyk. 💖

• -user user — user, bestie. 💅
• -group group — group, same energy. 🫶
• -nouser — no user.
• -nogroup — no group.
• -type type — the type values are 'f' (file), 'd' (dir), 'l' (symlink), 'b' (block), 'c' (char), 'p' (named pipe/FIFO), 's' (socket). 🦋
• -size size_crit — size crit, in the format [-|+]<val>[K|M|G|T]. iconic. 🔥
• -name filename — filename, literally. 🎀
• -crtime time_crit — time crit in the format [-|+]<val>[s|m|h|d|y] (s: sec, m: min, h: hour, d: day, y: year; default unit is days). 🕰️
• -ctime time_crit — same format: [-|+]<val>[s|m|h|d|y] (s: sec, m: min, h: hour, d: day, y: year; default unit is days).
• -mtime time_crit — same format: [-|+]<val>[s|m|h|d|y] (s: sec, m: min, h: hour, d: day, y: year; default unit is days).
• -mmin minute_crit — same as '-mtime Nm'.
• -msec second_crit — same as '-mtime Ns'.
• -atime time_crit — same format: [-|+]<val>[s|m|h|d|y] (s: sec, m: min, h: hour, d: day, y: year; default unit is days).
• -amin minute_crit — same as '-atime Nm'.
• -links count — count, no cap. 💀
• -ost ost_index — OST index, bestie. 💜
• -pool ost_pool — OST pool.
• -status status_name:status_value — status match in the format status_name:status_value. 🌈
• -class class — class, iykyk.
• -not, -! — Negate next argument. periodt. ✨

🌈 OUTPUT OPTIONS 🌈

this is where you decide how the matching entries get shown off. main character energy only. 👑

• -ls — Display attributes. 👑
• -lsost — Display OST information. 🦋
• -lsclass — Display fileclass information. 🎀
• -lsstatus[=policy] — Display status information (optionally: only for the given policy). 💅
• -print — Display the fullpath of matching entries (this is the default, unless -ls, -lsost or -exec are used). ✨
• -printf — Format string to display the matching entries. The supported escapes and directives are a subset of those of find, with some Robinhood additions prefixed with %R:
  • %% — Escapes %
  • %A — Robinhood’s "last access time", which is a compound of the file's atime and mtime, unless the global configuration last_access_only_atime is set, in which case it is exactly the atime of the file. An strftime(1) directive must be added. For example: %Ap %AT. This option can also take an strftime format option between brackets. For instance: %A{%A, %B %dth, %Y %F}. 🕰️
  • %b — Number of blocks
  • %C — Robinhood’s "last MD change" which is the ctime of the file.
  • %d — Depth
  • %f — File name, without its path
  • %g — Group name
  • %M — File mode as a string, similar to the output of ls
  • %m — File mode in octal
  • %n — Number of hard links
  • %p — Full file name
  • %s — File size
  • %T — Robinhood’s "modification time", which is the file's mtime.
  • %u — File owner
  • %Y — Full file type (file, dir, fifo, ...)
  • %y — File type as one letter (f, d, p, ...)
  • %RC — Robinhood’s "creation time", which is the oldest ctime seen for that file. It is always lesser or equal to the current ctime of the file. When Lustre changelogs are used, "creation time" is really the creation time. An strftime(1) directive must be added. For example: %RCc. This option can also take an strftime format option between curly brackets. For instance: %RC{%A, %B %dth, %Y %F}. 🕰️
  • %Rc — File class
  • %Rf — Lustre FID
  • %Rm — Status manager module attribute, with the name specified between curly bracket. The name is the status manager module name, followed by a dot, followed by the attribute name. For example: %Rm{lhsm.archive_id}.
  • %Ro — Lustre OSTS
  • %Rp — Lustre parent FID
  • \\ — Escapes \
  • \n — Newline
  • \t — Tab
  • \NNN — Byte with octal value NNN (1 to 3 digits)
  • \xHH — Byte with hexadecimal value HH (1 to 2 digits)
• -escaped — When -printf is used, escape unprintable characters. 🙈
• -print0 — Print file name followed by a null character. Same as -printf "%p\0". 💖

🔥 ACTIONS 🔥

• -exec "cmd" — Execute the given command for each matching entry. Unlike classical 'find', cmd must be a single (quoted) shell param, not necessarily terminated with ';'. The '{}' placeholder is replaced by the entry path. Example: -exec 'md5sum {}'. 🔥

🦋 BEHAVIOR 🦋

• -nobulk — When running rbh-find on the filesystem root, rbh-find automatically switches to bulk DB request instead of browsing the namespace from the DB. This speeds up the query, but this may result in an arbitrary output ordering, and a single path may be displayed in case of multiple hardlinks. Use -nobulk to disable this optimization. 🦋

🎀 PROGRAM OPTIONS 🎀

• -f config_file — config file, bestie. 💅
• -d log_level — log level. the valid levels are 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-report(1)
• rbh-du(1)
• rbh-diff(1)

---

okay that's the whole page, bestie 🫶 it's from Robinhood 3.0 and dated 07 July 2016. go forth, query that DB, and slay 💅✨