listing for A
advfs_get_fdmn_list - Get an AdvFS file domain list
unsigned long arraySize,
unsigned long *offset,
unsigned long *numDomains,
domainInfoT domainInfo );
AdvFS Library (libadvfs)
Contains the number of domainInfoT cells that have been malloced for
the domainInfo array.
A pointer for the next iteration of the function: 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 structures.
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].
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
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.
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
Directory of valid AdvFS file domains.
Commands: mkfdmn(8), rmfdmn(8)
File Formats: advfs(4)
listing for A