Index for Section 3

Alphabetical listing for F

Bottom of page

fs_get_dom_list(3)
NAME
  fs_get_dom_list - Obtains a list of all AdvFS domains on the current
  system.

SYNOPSIS
  #include <stocfg/fs_config.h>
  char *fs_get_dom_list(
     char **err_buf);

  );

LIBRARY
  File System & Storage Configuration Library libstocfg

PARAMETERS
  **err_buf
      Points to a pointer that points to a location in which the function
      stores error messages.

DESCRIPTION
  This function obtains a list of both active and inactive AdvFS domain names
  on a system.

NOTES
  The calling function is responsible for freeing memory allocated for the
  AdvFS domain name list and the error messages.

RETURN VALUES
  On successful completion, the function returns a pointer, to a character
  buffer containing a list of AdvFS domain names expressed in XML markup.

  On failure, the function sets **err_buf to point to an error message and
  returns a NULL for error conditions, including no domain found.

  See EXAMPLES below for more information.

EXAMPLES
  The following example shows use of the fs_get_dom_list function and output
  from the function.

       #include <sys/types.h>
	       #include <stocfg/fs_config.h>
	       main()
	       {
		  char *domlist=NULL,*err_buf=NULL;

		  domlist = fs_get_dom_list(&err_buf);
	       }
       Output
	  .
	  .
	  .
       <domain_name>root</domain_name>
       <domain_name>usr</domain_name>
       <domain_name>projects</domain_name>

SEE ALSO
  Functions: fs_get_fset_list(3), fs_config_get_devs(3),
  fs_restore_config(3), fs_save_config(3)

  Files: fs_config_data(4)

Index for Section 3

Alphabetical listing for F

Top of page