advfs_get_fset_list(3)advfs_get_fset_list(3)NAMEadvfs_get_fset_list - Obtain a list of all the filesets in an AdvFS
file domain
SYNOPSIS
#include <sys/advfs_syscalls.h>
int advfs_get_fset_list(
char domain,
unsigned long arraySize,
unsigned long *offset,
unsigned long *numFilesets,
filesetInfoT filesetInfo[] );
LIBRARY
AdvFS Library (libadvfs)
PARAMETERS
The name of the AdvFS file domain to be searched for filesets. Con‐
tains the number of filesetInfoT cells that have been malloced for the
filesetInfo array. A pointer for the next iteration of the function:
the starting location for the next set of filesets. The total number
of filesets in the specified file domain. The array of fileset infor‐
mation structures that is filled in on successful return from this
function.
DESCRIPTION
Use this function to obtain information about the filesets in an AdvFS
file domain. Information about both mounted and unmounted filesets is
returned. The function returns the information in the “filesetInfo[]”
array.
For an example of programming the advfs_get_fset_list function, see
[reference to be provided].
NOTES
We recommend that the application malloc an array large enough to
gather all fileset information in a single call to the function.
The function can skip filesets or return them multiple times if the
function is using the offset parameter while another user creates or
removes filesets in between the calls that this user makes to the func‐
tion.
This function can take a very long time to complete when it is called
to execute on a file domain with a large number of unmounted filesets.
RETURN VALUES
The function returns a value of 0 (zero) on successful completion. The
function returns a value of -1 on failure and sets the value of errno
to the specific error.
ERRORS
The calling program is not running with root privileges. An I/O error
occurred on one of the disks in the file domain. The file domain spec‐
ified by the domain parameter does not exist. There is not enough mem‐
ory available for the operation
SEE ALSO
Commands: clonefset(8), mkfset(8), renamefset(8), rmfset(8)
Functions: advfs_clonefset(3), advfs_rmfset(3)advfs_get_fset_list(3)