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
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.
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
Directory of valid AdvFS file domains.
Commands: mkfdmn(8), rmfdmn(8)
File Formats: advfs(4)
[ Back ]