lustre/doc/lfs-pcc-detach.1

   1 .TH LFS-PCC-DETACH 1 2019-04-15 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lfs pcc detach|detach_fid \- Detach given files from PCC
   4 .SH SYNOPSIS
   5 .B lfs pcc detach [\fB--keep\fR|\fB-k\fR] <\fIfile \fR...>
   6 .br
   7 .B lfs pcc detach_fid [\fB--keep\fR|\fB-k\fR] <\fImntpath\fR> <\fIfid \fR...>
   8 .SH DESCRIPTION
   9 .TP
  10 .B lfs pcc detach [\fB--keep\fR|\fB-k\fR] <\fIfile \fR...>
  11 Detach given files from the persistent client cache.
  12 .TP
  13 .B lfs pcc detach_fid [\fB--keep\fR|\fB-k\fR] <\fImntpath\fR> <\fIfid \fR...>
  14 Detach files from the persistent client cache by FID(s).
  15 .SH OPTIONS
  16 .TP
  17 .B --keep | -k
  18 By default, the detach command will detach the file from PCC permanently and
  19 remove the PCC copy after detach. This option will only detach the file, but
  20 keep the PCC copy in cache. It allows the detaching file to be attached
  21 automatically at next open if the cached copy of the file is still valid.
  22 .SH EXAMPLES
  23 .TP
  24 .B $ lfs pcc detach /mnt/lustre/test
  25 Detach the file permanently from PCC. The cached file on PCC will be removed
  26 after detach. IO to the file will come to Lustre OSTs after this command.
  27 .TP
  28 .B $ lfs pcc detach_fid /mnt/lustre 0x200000401:0x1:0x0
  29 Detach the file referenced by FID "0x200000401:0x1:0x0" from PCC permanently, and
  30 the cached file on PCC will be removed after detach.
  31 .TP
  32 .B $ lfs pcc detach -k /mnt/lustre/test
  33 Detach the file "/mnt/lustre/test" from PCC. The client will try to attach
  34 this file again at the next open if the cached copy is still valid.
  35 .TP
  36 .B $ lfs pcc detach_fid -k /mnt/lustre 0x200000401:0x1:0x0
  37 Detach the file referenced by FID "0x200000401:0x1:0x0" from PCC. The client
  38 will try to attach this file again at the next open if the cached copy is still
  39 valid.
  40 .SH SEE ALSO
  41 .BR lfs (1),
  42 .BR lfs-hsm (1),
  43 .BR lfs-pcc (1),
  44 .BR lctl-pcc (8)