1 .TH llapi_ladvise 3 "2015 Dec 15" "Lustre User API"
3 llapi_ladvise \- give IO advices/hints on a Lustre file to the server
6 .B #include <lustre/lustreapi.h>
8 .BI "int llapi_ladvise(int " fd ", unsigned long long " flags ", int " num_advise ", struct lu_ladvise *" ladvise ");"
14 gives advices to a file specified by the file descriptor
17 points to an array that contains the information of the advices. The number
20 which should be smaller than
22 Each of these advises is given in
24 structure, which contains the following fields:
29 __u64 lla_advice; /* Advice type */
30 __u64 lla_start; /* Start offset of file */
31 __u64 lla_end; /* End offset of file(not included) */
32 __u64 lla_padding; /* Not used yet */
37 In addition, zero or more flags can be
41 The full list of file creation flags and file status flags is as follows:
44 Client return to userspace immediately after submitting ladvise RPCs, leaving
45 server threads to handle the advices asynchronously.
50 return 0 on success, or -1 if an error occurred (in which case, errno is set
55 Insufficient memory to complete operation.
58 One or more invalid arguments are given.
61 memory region pointed by
63 is not properly mapped.
66 Advice type is not supported.