NAME    [Toc]    [Back]

       advfs_get_fdmn_list - Get an AdvFS file domain list

SYNOPSIS    [Toc]    [Back]

       #include <sys/advfs_syscalls.h>

       int advfs_get_fdmn_list(
               unsigned long arraySize,
               unsigned long *offset,
               unsigned long *numDomains,
               domainInfoT domainInfo[] );

LIBRARY    [Toc]    [Back]

       AdvFS Library (libadvfs)

PARAMETERS    [Toc]    [Back]

       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.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Directory of valid AdvFS file domains.

SEE ALSO    [Toc]    [Back]

       Commands: mkfdmn(8), rmfdmn(8)

       File Formats: advfs(4)



                                           advfs_get_fdmn_list(3)