<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
On Jun 14, 2022, at 05:32, John Bauer <<a href="mailto:bauerj@iodoctors.com" class="">bauerj@iodoctors.com</a>> wrote:<br class="">
<div>
<blockquote type="cite" class=""><br class="Apple-interchange-newline">
<div class="">
<div class="">I have had little success in my search for documentation on pool functions in llapi. I've looked in:<br class="">
<br class="">
<a href="https://wiki.lustre.org/PFL2_High_Level_Design" class="">https://wiki.lustre.org/PFL2_High_Level_Design</a><br class="">
<br class="">
https://doc.lustre.org/lustre_manual.xhtml#managingstripingfreespace<br class="">
<br class="">
<br class="">
I'm looking for info on llapi_get_poollist() and llapi_get_poolmembers(). I've found the prototype in /usr/include/lustre/lustreapi.h, but that's about it.<br class="">
<br class="">
Can anyone point me to some documentation?<br class="">
</div>
</div>
</blockquote>
<br class="">
</div>
<div>it looks like there aren't man pages for these functions, just the function comment blocks</div>
<div>in the code, and their usage internally:</div>
<div><br class="">
</div>
<div>/**<br class="">
* Get the list of pools in a filesystem.<br class="">
* \param name filesystem name or path<br class="">
* \param poollist caller-allocated array of char*<br class="">
* \param list_size size of the poollist array<br class="">
* \param buffer caller-allocated buffer for storing pool names<br class="">
* \param buffer_size size of the buffer<br class="">
*<br class="">
* \return number of pools retrieved for this filesystem<br class="">
* \retval -error failure<br class="">
*/<br class="">
int llapi_get_poollist(const char *name, char **poollist, int list_size,<br class="">
char *buffer, int buffer_size)</div>
<div><br class="">
</div>
<div>/**<br class="">
* Get the list of pool members.<br class="">
* \param poolname string of format \<fsname\>.\<poolname\><br class="">
* \param members caller-allocated array of char*<br class="">
* \param list_size size of the members array<br class="">
* \param buffer caller-allocated buffer for storing OST names<br class="">
* \param buffer_size size of the buffer<br class="">
*<br class="">
* \return number of members retrieved for this pool<br class="">
* \retval -error failure<br class="">
*/<br class="">
int llapi_get_poolmembers(const char *poolname, char **members,<br class="">
int list_size, char *buffer, int buffer_size)</div>
<div><br class="">
</div>
<div>Patches to add llapi_get_poollist.3 and llapi_get_poolmembers.3 (and related) man</div>
<div>pages welcome. The pool related functions should probably be moved into a new</div>
<div>liblustreapi_pool.c file to reduce the size of liblustreapi.c.</div>
<br class="">
<div class="">
<div dir="auto" style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div dir="auto" style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div dir="auto" style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div dir="auto" style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div dir="auto" style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div dir="auto" style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">
<div>Cheers, Andreas</div>
<div>--</div>
<div>Andreas Dilger</div>
<div>Lustre Principal Architect</div>
<div>Whamcloud</div>
<div><br class="">
</div>
<div><br class="">
</div>
<div><br class="">
</div>
</div>
</div>
</div>
</div>
</div>
<br class="Apple-interchange-newline">
</div>
<br class="Apple-interchange-newline">
<br class="Apple-interchange-newline">
</div>
<br class="">
</body>
</html>