1 .TH llapi_layout_pool_name_get 3 "2013 Oct 31" "Lustre User API"
3 llapi_layout_pool_name_get, llapi_layout_pool_name_set \- get or set the
4 OST pool name of a Lustre file
7 .B #include <lustre/lustreapi.h>
9 .BI "int llapi_layout_pool_name_get(const struct llapi_layout *" layout ",
10 .BI " char *" pool_name ", size_t " n ");
12 .BI "int llapi_layout_pool_name_set(struct llapi_layout *" layout ",
13 .BI " const char *" pool_name );
17 .B llapi_layout_pool_name_get()
22 characters of the name of the pool of OSTS associated with
25 .B llapi_layout_pool_name_set()
26 sets the OST pool name of
32 uses "fsname.pool" notation to qualify the pool name
33 with a filesystem name, the "fsname." portion will be silently
34 discarded before storing the value.
36 .B llapi_layout_pool_name_set()
37 does not validate that
39 names an existing non-empty pool, since it is not known a priori which
42 will be applied to. However, the function
43 .B llapi_layout_file_create()
46 with a pool that does not exist or contains no OSTs.
49 .B llapi_layout_pool_name_get()
51 .B llapi_layout_pool_name_set()
52 return 0 on success, or -1 if an error occurred (in which case, errno is
57 An invalid argument was specified.
60 A pool defines a set of OSTs from which objects may be allocated
61 to store a file in a Lustre filesystem.
62 Pools are created by the filesystem administrator using the
64 command. This API allows an application to create a file within an
65 existing pool, or to query the name of a pool that a file was created
66 in. It does not provide an interface for creating or destroying pools.
67 Refer to the Lustre Operations Manual for detailed background material
70 .BR llapi_layout_alloc (3),
71 .BR llapi_layout_file_open (3),