1 .TH llapi_pcc_state_get 3 "2019 April 20" "Lustre User API"
3 llapi_pcc_state_get, llapi_pcc_state_get_fd, \- get the current PCC state
7 .B #include <lustre/lustreapi.h>
9 .BI "int llapi_pcc_state_get(const char *" path ", struct lu_pcc_state *" state ");"
11 .BI "int llapi_pcc_state_get_fd(int " fd ", struct lu_pcc_state *" state ");"
16 .BR llapi_pcc_state_get()
18 .BR llapi_pcc_state_get_fd()
19 returns the PCC state information for the file referenced by
23 Information is returned in the
25 argument which should be already allocated, which is a
27 data structure, which contains the following fields:
31 __u32 pccs_type; /* enum lu_pcc_type */
32 __u32 pccs_open_count;
33 __u32 pccs_flags; /* enum lu_pcc_state_flags */
35 char pccs_path[PATH_MAX];
40 specifies the PCC mode for the given file, which is actual an
45 indicates the opener count for the given file on the client.
48 is PCC flags for the given file, not used currently.
51 is the full path of the cached file on the PCC backend.
54 .B llapi_pcc_state_get()
56 .B llapi_pcc_state_get_fd()
57 return 0 on success or a negative errno value on failure.
61 Insufficient memory to complete operation.
64 Memory region is not properly mapped.
67 One or more invalid arguments are given.
70 PCC state operation is not supported.
72 .BR llapi_pcc_attach (3),