table of contents
rbh-find(1) | Robinhood 3.0 | rbh-find(1) |
NAME¶
rbh-find - find clone that query robinhood DB
SYNOPSIS¶
rbh-find [options] [path|fid]...
FILTERS¶
-user user
-group group
-nouser
-nogroup
- -type type
- ’f' (file), 'd' (dir), 'l' (symlink), 'b' (block), 'c' (char), 'p' (named pipe/FIFO), 's' (socket)
- -size size_crit
- [-|+]<val>[K|M|G|T]
-name filename
- -crtime time_crit
- [-|+]<val>[s|m|h|d|y] (s: sec, m: min, h: hour, d:day, y:year. default unit is days)
- -ctime time_crit
- [-|+]<val>[s|m|h|d|y] (s: sec, m: min, h: hour, d:day, y:year. default unit is days)
- -mtime time_crit
- [-|+]<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
- [-|+]<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
-ost ost_index
-pool ost_pool
-status status_name:status_value
-class class
- -not, -!
- Negate next argument
OUTPUT OPTIONS¶
- -ls
- Display attributes
- -lsost
- Display OST information
- -lsclass
- Display fileclass information
- -lsstatus[=policy]
- Display status information (optionally: only for the given policy).
- 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)
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 ';'. ’{}' 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
- -d log_level
- CRIT, MAJOR, EVENT, VERB, DEBUG, FULL
- -h, --help
- Display a short help about command line options.
- -V, --version
- Display version info
SEE ALSO¶
07 July 2016 |