1 .TH lustreapi 3 "2019 Jul 10" "Lustre User API"
3 llapi_get_fsname_instance - get the client filesystem name and instance
5 llapi_get_fsname - get the filesystem fsname from path
7 llapi_get_instance - get the client filesystem instance from path
9 llapi_getname - get the client filesystem identifier from path
12 .B #include <sys/types.h>
13 .B #include <sys/stat.h>
15 .B #include <lustre/lustreapi.h>
17 .BI "int llapi_getname(const char *" path ", char *" name ", size_t " namelen );
19 .BI "int llapi_get_fsname_instance(const char *" path ", char *" fsname ,
20 .BI size_t " fsname_len" ", char *" instance ,
21 .BI size_t " instance_len" );
23 .BI "int llapi_get_fsname(const char *" path ", char *" fsname ,
24 .BI size_t " fsname_len" );
26 .BI "int llapi_get_instance(const char *" path ", char *" instance ,
27 .BI size_t " instance_len" );
30 .B llapi_get_fsname_instance()
31 retrieves the filesystem fsname and instance for the specified
33 and stores them in the
37 buffers respectively, each of which can respectively hold at least
46 If only the fsname or instance identifier is needed, then the respective
47 .BR llapi_get_fsname (3)
49 .BR llapi_get_instance (3)
50 function can be used. The
52 function returns the combined
62 used to identify the filesystem on the clients and servers for mounting
63 and configuration. The
65 is a client-unique temporary identifier like
66 .RB ' ffff8803c9c0f000 '
67 that differentiates multiple mounts of the same filesystem on the same
68 client. The instance is not guaranteed to be unique between different clients,
69 nor is it expected to be the same for repeated mounts on the same client.
71 The filesystem identifier is used in client-side parameters, like
72 .BI mdc. fsname -MDT0000-mdc- instance .max_rpcs_in_flight
73 for MDC and OSC devices, or
74 .BI llite. fsname - instance .max_cached_mb
75 and similar for llite tunable values and statistics.
82 error code on failure and sets errno appropriately.
86 Invalid filesystem information found.
94 buffer length was not large enough to hold the string.