advfs_get_fdmn_list(3) Library Functions Manual advfs_get_fdmn_list(3)
NAME
advfs_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 structures.
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.
Compaq recommends 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)