lustre/doc/lfs-heat_get.1

   1 .TH lfs-heat 1 "Feb. 09, 2019" Lustre "Lustre utility"
   2 .SH NAME
   3 lfs-heat_get, lfs-heat_set \- commands used to interact with file heat features
   4 .SH SYNOPSIS
   5 .B lfs heat_get|heat_set
   6 .IR \fR<\fIFILE \fR...>
   7 .br
   8 .SH DESCRIPTION
   9 These are a set of lfs commands used to interact with Lustre file heat feature.
  10 Currently file heat is only stored in memory with file inode, it might be reset
  11 to be zero at any time with the release of the inode due to memory reclaim.
  12 .TP
  13 .B lfs heat_get  \fR<\fIFILE \fR...>
  14 Get file heat on file list.
  15 .TP
  16 .B lfs heat_set [\fB--clear\fR|\fB-c\fR] [\fB--off\fR|\fB-o\fR] [\fB--on\fR|\fB-O\fR] \fR<\fIFILE \fR...>
  17 Set provided file heat flags on file list.
  18 .SH OPTIONS
  19 .TP
  20 .BR --clear | -c
  21 Clear file heat on given files.
  22 .TP
  23 .BR --off | -o
  24 Turn off file heat on given files.
  25 .TP
  26 .BR --on | -O
  27 Turn on file heat on given files.
  28 .SH EXAMPLES
  29 .TP
  30 Turn on file heat support for the Lustre filesystem:
  31 .B $ lctl set_param llite.$FSNAME*.file_heat=1
  32 .TP
  33 Trun off file heat support for the Lustre filesystem:
  34 .B $ lctl set_param llite.$FSNAME*.file_heat=0
  35 .TP
  36 Display current file heat for foo:
  37 .B $ lfs heat_get /mnt/lustre/foo
  38 .br
  39 flags: 0
  40 .br
  41 readsample: 0
  42 .br
  43 writesample: 16
  44 .br
  45 readbyte: 0
  46 .br
  47 writebyte: 16777216
  48 .br
  49
  50 .TP
  51 Clear the file heat for foo:
  52 .B $ lfs heat_set -c /mnt/lustre/foo
  53 .TP
  54 Turn off file heat for foo:
  55 .B $ lfs heat_set -o /mnt/lustre/foo
  56 .TP
  57 Turn on file heat for foo:
  58 .B $ lfs heat_set -O /mnt/lustre/foo
  59 .SH AUTHOR
  60 The
  61 .B lfs heat
  62 command is part of the
  63 .BR Lustre (7)
  64 filesystem.
  65
  66 .SH SEE ALSO
  67 .BR lfs (1)
  68 .BR lustre (7)