osf1 man page for advfs_get_fdmn_list

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)