[Pvfs2-users] libpvfs2 API specification

[Sam Lang]

The client interfaces are all defined in pvfs2-sysint.h (system  
interfaces) and pvfs2-mgmt.h (management interfaces).  They include  
some documentation.  There's an online version of the 1.5.1 release at:

http://www.pvfs.org/doxygen/

The interfaces haven't changed since 1.5.1, so that specific  
documentation should still be up-to-date, although we should update  
that.  With doxygen installed, you can also generate docs yourself by  
running:

doxygen pvfs-2.6.2/doc/doxygen/pvfs2-doxygen.conf

To get programmatic information about the server configurations, you  
will need to use the management interfaces:

http://www.pvfs.org/doxygen/group__mgmtint.html

Namely, the PVFS_mgmt_get_server_array wil be useful to you.  You can  
specify the type of servers you want to have returned in the  
server_type parameter with PVFS_MGMT_IO_SERVER,  
PVFS_MGMT_META_SERVER, or an or-ing of the two for all of them.

Some other interfaces that will be useful to you are declared in the  
pvfs2-util.h header (not documented).  They include functions like  
PVFS_util_init_defaults, which groups the initialization of different  
interfaces and parsing of the tab file for PVFS volumes.  Also,  
PVFS_util_resolve will give you an fsid and path rooted on the PVFS  
volume based on a local path.

-sam

On Feb 8, 2007, at 1:05 AM, Suneet Chandok wrote:

> Hi,
>
> Is there any documentation for set of API' s supported by  
> libpvfs2.a library as I couldn't find it on web also. I am more  
> interested in querying to check which nodes are running I/O server  
> and which are running meta data server making my application to  
> generic enough to run on any node of cluster.
>
> -- 
> Suneet Chandok
> Research Assistant
> Parallel Software Technologies Laboratory
> Department of Computer Science
> University of Houston
>
> Cell: 704-248-0718
> Email: schandok at cs.uh.edu
> _______________________________________________
> Pvfs2-users mailing list
> Pvfs2-users at beowulf-underground.org
> http://www.beowulf-underground.org/mailman/listinfo/pvfs2-users