NAME

fs_config_get_devs − Obtains a list of devices in an AdvFS domain configuration. 

SYNOPSIS

#include <stocfg/fs_config.h>
 char  ∗fs_config_get_devs(
    char ∗config,
    char ∗∗err_buf); );

LIBRARY

File System & Storage Configuration Library libstocfg

PARAMETERS

∗config
Points to a domain configuration description expressed in XML format.  See fs_save_config for  information on saving a configuration and its format. 

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

DESCRIPTION

Use this function to obtain a list of devices from which an AdvFS domain is built.  The list, expressed in XML markup, contains physical disks used directly by AdvFS volumes and those used to make up LSM volumes. Different tags show disks used directly for AdvFS volumes or for LSM volumes. 

See EXAMPLES for more information. 

NOTES

The calling function is responsible for freeing memory allocated for the device list and the error message. 

RETURN VALUES

On successful completion, the function returns a pointer to a character buffer. 

On failure, the function returns a NULL and sets ∗∗err_buf to point to an error message. 

ERRORS

The following are some error messages for this function along with suggested solutions:

Empty configuration list −− verify the file path/name

Failed parsing config data −− verify the configuration definition

See /usr/lib/nls/msg/$LANG/stocfg.cat for a complete listing of error messages. 

EXAMPLES

     1.The following program shows how to obtain a device list by using the fs_config_get_devs function. 

#include <sys/types.h>
#include <stdio.h>
#include <stocfg/fs_config.h>
main(int argc, char ∗∗argv)
{
    char ∗devlist=NULL,∗config=NULL,∗err_buf=NULL;
    char ∗getFileContents(char ∗);
    if(argc < 2)
    {
       printf("Usage: %s: <config_file> \n",∗argv);
       exit(0);
    }
    config = getFileContents(∗(argv +1));
    devlist = fs_config_get_devs(config, &err_buf);
}
output
.
.
.
<vol_name>/dev/disk/dsk1</vol_name>
<dg_disk_name>/dev/disk/dsk11</dg_disk_name>
<dg_disk_name>/dev/disk/dsk15</dg_disk_name>

SEE ALSO

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

Files: fs_config_data(4) </docbook>