1 .TH llapi_group_lock 3 "2014 Oct 03" "Lustre User API"
3 llapi_group_lock, llapi_group_unlock, llapi_group_lock64, llapi_group_unlock64 \- get and put a Lustre group lock.
6 .B #include <lustre/lustreapi.h>
8 .BI "int llapi_group_lock(int "fd ", int "gid );
9 .BI "int llapi_group_lock64(int "fd ", __u64 "gid );
11 .BI "int llapi_group_unlock(int "fd ", int "gid );
12 .BI "int llapi_group_unlock64(int "fd ", __u64 "gid );
17 .BR llapi_group_lock()
19 .BR llapi_group_lock64()
20 take a group lock on the file descriptor
27 .BR llapi_group_unlock()
29 .BR llapi_group_unlock64()
30 release a group lock identified by group identifier
32 (int or __u64 type) on the file descriptor
35 The group lock is a whole file lock that blocks concurrent I/O originating from descriptors that have not been locked. Multiple processes can acquire a lock by specifying the same group identifier.
39 .B llapi_group_lock(\|),
40 .B llapi_group_lock64(\|),
41 .B llapi_group_unlock(\|)
43 .B llapi_group_unlock64(\|)
44 return 0 on success or a negative errno value on failure.
49 is not a valid file descriptor.
53 does not describe an object suitable for this request.
57 is already group locked with a different group identifier.