advfs_get_fdmn_list(3) [osf1 man page]

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)

Check Out this Related Man Page

advfs_get_fset_list(3)					     Library Functions Manual					    advfs_get_fset_list(3)

NAME

       advfs_get_fset_list - Obtain a list of all the filesets in an AdvFS file domain

SYNOPSIS

       #include <sys/advfs_syscalls.h>

       int advfs_get_fset_list(
	       char domain,
	       unsigned long arraySize,
	       unsigned long *offset,
	       unsigned long *numFilesets,
	       filesetInfoT filesetInfo[] );

LIBRARY

       AdvFS Library (libadvfs)

PARAMETERS

       The  name  of the AdvFS file domain to be searched for filesets.  Contains the number of filesetInfoT cells that have been malloced for the
       filesetInfo array.  A pointer for the next iteration of the function:  the starting location for the next set of filesets.  The total  num-
       ber of filesets in the specified file domain.  The array of fileset information structures that is filled in on successful return from this
       function.

DESCRIPTION

       Use this function to obtain information about the filesets in an AdvFS file domain.  Information about both mounted and unmounted  filesets
       is returned. The function returns the information in the "filesetInfo[]" array.

       For an example of programming the advfs_get_fset_list function, see [reference to be provided].

NOTES

       Compaq recommends that the application malloc an array large enough to gather all fileset information in a single call to the function.

       The  function  can  skip filesets or return them multiple times if the function is using the offset parameter while another user creates or
       removes filesets in between the calls that this user makes to the function.

       This function can take a very long time to complete when it is called to execute on a file domain with a large number  of  unmounted  file-
       sets.

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.	 The  file  domain
       specified by the domain parameter does not exist.  There is not enough memory available for the operation

SEE ALSO

       Commands: clonefset(8), mkfset(8), renamefset(8), rmfset(8)

       Functions: advfs_clonefset(3), advfs_rmfset(3)

															    advfs_get_fset_list(3)

Linux and UNIX Man Pages

advfs_get_fdmn_list(3) [osf1 man page]

Check Out this Related Man Page