Index for Section 3

Alphabetical listing for F

Bottom of page

fs_get_fset_list(3)
NAME
  fs_get_fset_list - Obtains a list of all the filesets in an AdvFS domain.

SYNOPSIS
  #include <stocfg/fs_config.h>

    char *fs_get_fset_list(
		  char *domain_name,
		  char **err_buf);

  );

LIBRARY
  File System & Storage Configuration Library libstocfg

PARAMETERS
  *domain_name
      Points to a domain name.

   **err_buf
      Points to a pointer in which the function stores an error message.

DESCRIPTION
  This function obtains a list of names of all filesets in a named AdvFS
  domain.  Names of both mounted filesets and unmounted filesets are
  returned.  Both active and inactive domains can be queried.

NOTES
  The calling function is responsible for freeing memory allocated for the
  message.

RETURN VALUES
  On successful completion, returns a pointer to a character buffer with a
  list of AdvFS fileset names expressed in XML markup.

  On failure, returns a NULL if there is no fileset in the domain and sets
  *err_buf to point to the error message.

  See EXAMPLES for more information.

EXAMPLES
  The following example shows how to obtain a fileset list by using the
  fs_get_fset_list function.

       #include <sys/types.h>
	       #include <stdio.h>
	       #include <stocfg/fs_config.h>
	       main(int argc, char **argv)
	       {
		  char *fsetlist=NULL,*err_buf=NULL;
		  if(argc < 2)
		  {
		     printf("Usage: %s: <domain_name>\n",*argv);
		     exit(0);
		  }
		  fsetlist = fs_get_fset_list(*(argv + 1), &err_buf);
	       }
       output
       .
       .
       .
       <fset_name>usr</fset_name>
       <fset_name>var</fset_name>

SEE ALSO
  Functions: fs_get_dom_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