lfs-heat_get(1)

NAME

lfs-heat_get, lfs-heat_set - commands used to interact with file heat features

SYNOPSIS

DESCRIPTION

These are a set of lfs commands used to interact with Lustre file heat feature. Currently file heat is only stored in memory with file inode, it might be reset to be zero at any time with the release of the inode due to memory reclaim. lfs heat_get gets the file heat on the file list. lfs heat_set sets the provided file with heat flags on the file list.

OPTIONS

-c, --clear

Clear file heat on given files.

-h, --help

Print usage message.

-o, --off

Turn off file heat on given files.

-O, --on

Turn on file heat on given files.

EXAMPLES

Turn on file heat support for the Lustre filesystem:

# lctl set_param llite.$FSNAME*.file_heat=1

Turn off file heat support for the Lustre filesystem:

# lctl set_param llite.$FSNAME*.file_heat=0

Display current file heat for foo:

# lfs heat_get /mnt/lustre/foo
flags: 0
readsample: 0
writesample: 16
readbyte: 0
writebyte: 16777216

Clear the file heat for foo:

# lfs heat_set -c /mnt/lustre/foo

Turn off file heat for foo:

# lfs heat_set -o /mnt/lustre/foo

Turn on file heat for foo:

# lfs heat_set -O /mnt/lustre/foo

AVAILABILITY

The lfs heat_get and lfs heat_set commands are part of the lustre(7) filesystem package since release 2.13.0

SEE ALSO

lfs(1), lustre(7)