fs_get_dom_list(3)fs_get_dom_list(3)NAMEfs_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
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 charac‐
ter 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 *dom‐
list=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_con‐
fig(3), fs_save_config(3)
Files: fs_config_data(4)fs_get_dom_list(3)