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)