NAME    [Toc]    [Back]

       fs_get_fset_list  -  Obtains a list of all the filesets in
       an AdvFS domain.

SYNOPSIS    [Toc]    [Back]

       #include <stocfg/fs_config.h>

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

       );

LIBRARY    [Toc]    [Back]

       File System & Storage Configuration Library libstocfg

PARAMETERS    [Toc]    [Back]

       Points to a domain name.  Points to a pointer in which the
       function stores an error message.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

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

RETURN VALUES    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Functions:   fs_get_dom_list(3),    fs_config_get_devs(3),
       fs_restore_config(3), fs_save_config(3)

       Files: fs_config_data(4)



                                              fs_get_fset_list(3)