*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> advfs_get_fdmn_list (3)              



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

       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

FILES    [Toc]    [Back]

       Directory of valid AdvFS file domains.

SEE ALSO    [Toc]    [Back]

       Commands: mkfdmn(8), rmfdmn(8)

       File Formats: advfs(4)

[ Back ]
 Similar pages
Name OS Title
advfs_get_fset_list Tru64 Obtain a list of all the filesets in an AdvFS file domain
fs_get_fset_list Tru64 Obtains a list of all the filesets in an AdvFS domain.
fs_config_get_devs Tru64 Obtains a list of devices in an AdvFS domain configuration.
nvlogpg Tru64 Displays the log file of an AdvFS domain
stripe Tru64 Stripes a file across several volumes in an AdvFS domain.
switchlog Tru64 moves an AdvFS file domain transaction log
showfdmn Tru64 Displays attributes of an AdvFS file domain
migrate Tru64 Move a file or file pages to another volume in an AdvFS file domain
rmfset Tru64 Removes a fileset or a clone fileset from an AdvFS file domain
mkfdmn Tru64 Creates a new AdvFS domain
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service