Index for Section 3

Alphabetical listing for A

Bottom of page

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
  arraySize
      Contains the number of domainInfoT cells that have been malloced for
      the domainInfo array.

  *offset
      A pointer for the next iteration of the function:	 the starting
      location for the next set of file domains.

  *numDomains
      A pointer to the location that contains the number of file domains that
      currently exist on the system.

  domainInfo[]
      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.

  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
  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
  [EACCES]
      The calling program is not running with root privileges.

  [EIO]
      An I/O error occurred on one of the disks in the file domain.

  [ENOMEM]
      There is not enough memory available for the operation

FILES
  /etc/fdmns
      Directory of valid AdvFS file domains.

SEE ALSO
  Commands: mkfdmn(8), rmfdmn(8)

  File Formats: advfs(4)

Index for Section 3

Alphabetical listing for A

Top of page