1 .TH llapi_path2parent 3 "2014 Oct 13" "Lustre User API"
3 llapi_path2parent, llapi_fd2parent \- Retrieve <parent FID>/name(s) for an entry
7 .B #include <lustre/lustreapi.h>
9 .BI "int llapi_path2parent(const char *" path ", unsigned int " linkno ","
10 .BI " struct lu_fid *" parent_fid ", char *" name ","
11 .BI " size_t " name_size );
13 .BI "int llapi_fd2parent(int " fd ", unsigned int " linkno ","
14 .BI " struct lu_fid *" parent_fid ", char *" name ","
15 .BI " size_t " name_size );
20 .BR llapi_path2parent()
23 stores the FID of the parent directory into
25 and the zero-terminated name of the entry into the buffer
27 which is expected to be of size
32 behaves similarly except that it operates on an open file descriptor
40 return 0 on success or a negative errno value on failure.
44 linkno has reached the link count.
48 does not reside on a Lustre filesystem.
55 An invalid argument was specified.
58 The given buffer was too small.
61 The file cannot be open by user or CAP_DAC_READ_SEARCH is not granted.