NAME    [Toc]    [Back]

       fs_get_dom_list  -  Obtains a list of all AdvFS domains on
       the current system.

SYNOPSIS    [Toc]    [Back]

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

       );

LIBRARY    [Toc]    [Back]

       File System & Storage Configuration Library libstocfg

PARAMETERS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

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

NOTES    [Toc]    [Back]

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

RETURN VALUES    [Toc]    [Back]

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

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

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

       Files: fs_config_data(4)



                                               fs_get_dom_list(3)