advfs_get_fdmn_list(3)advfs_get_fdmn_list(3)NAMEadvfs_get_fdmn_list - Get an AdvFS file domain list
SYNOPSIS
#include <sys/advfs_syscalls.h>
int advfs_get_fdmn_list(
unsigned long arraySize,
unsigned long *offset,
unsigned long *numDomains,
domainInfoT domainInfo[] );
LIBRARY
AdvFS Library (libadvfs)
PARAMETERS
Contains the number of domainInfoT cells that have been malloced for
the domainInfo array. A pointer for the next iteration of the func‐
tion: the starting location for the next set of file domains. A
pointer to the location that contains the number of file domains that
currently exist on the system. An array of domain information struc‐
tures.
DESCRIPTION
Use this function to obtain information about the AdvFS file domains on
a system. The function returns the information in the domainInfo[]
array.
The information is returned only for valid file domains.
For an example of programming the advfs_get_fdmn_list function, see
[reference to be determined].
NOTES
If an AdvFS file domain becomes corrupt, remove its directory entry in
/etc/fdmns before executing a program that uses the advfs_get_fdmn_list
function. Corrupt file domains can crash the system.
We recommend that the application malloc an array large enough to
gather all domain information in a single call to the function.
By default, only the root user has write access permission to the
/etc/fdmns directory. However, any user who gains this permission
could rename a file domain or make other changes that could invalidate
the return values of this function.
The function can skip file domains or return them multiple times if the
function is using the offset parameter while another user creates or
removes file domains in between the calls that this user makes to the
function.
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. There is not enough
memory available for the operation
FILES
Directory of valid AdvFS file domains.
SEE ALSO
Commands: mkfdmn(8), rmfdmn(8)
File Formats: advfs(4)advfs_get_fdmn_list(3)
