Whamcloud - gitweb
LU-10092 llite: Add persistent cache on client
[fs/lustre-release.git] / lustre / doc / lctl-pcc.8
1 .TH lctl-pcc 8 2019-04-15 "Lustre" "configuration Utilities"
2 .SH NAME
3 lctl pcc commands used to interact with PCC features.
4 .SH SYNOPSIS
5 .B lctl pcc add \fR<\fImntpath\fR> <\fIpccpath\fR> [\fB--param\fR|\fB-p\fR <\fIparam\fR>]
6 .br
7 .B lctl pcc del <\fImntpath\fR> <\fIpccpath\fR>
8 .br
9 .B lctl pcc clear <\fImntpath\fR>
10 .br
11 .B lctl pcc list <\fImntpath\fR>
12 .SH DESCRIPTION
13 .TP
14 .B lctl pcc add \fR<\fImntpath\fR> <\fIpccpath\fR> [\fB--param\fR|\fB-p\fR <\fIparam\fR>]
15 Add a PCC backend specified by HSM root path
16 .IR pccpath
17 on a Lustre filesystem client instances with the mount point referenced by
18 .IR mntpath .
19 The parameter
20 .IR param
21 is a string to config the PCC backend such as read-write attach id (archive ID)
22 and auto-caching project id. i.e. the string "2 100" means that the read-write
23 attach id is 2, and the project ID is 100 for the PCC backend. On this client
24 any subsequently created files with the project ID of 100 will be persistently
25 cached automatically.
26 .TP
27 .B lctl pcc del <\fImntpath\fR> <\fIpccpath\fR>
28 Delete a PCC backend specified by path
29 .IR pccpath
30 on a Lustre client referenced by the mount point of
31 .IR mntpath .
32 .TP
33 .B lctl pcc clear <\fImntpath\fR>
34 Remove all PCC backend on a Lustre client referenced by the mount point of
35 .IR mntpath .
36 .TP
37 .B lctl pcc list <\fImntpath\fR>
38 List all PCC backends on a Lustre client referenced by the mount point of
39 .IR mntpath .
40 .SH OPTIONS
41 .TP
42 .B --param | -p
43 Specifies the configuration parameters for a PCC backend.
44 .TP
45 .SH SEE ALSO
46 .BR lfs (1),
47 .BR lfs-hsm (1),
48 .BR lfs-pcc (1)