fs_save_config man page on DigitalUNIX

Printed from http://www.polarhome.com/service/man/?qf=fs_save_config&af=0&tf=2&of=DigitalUNIX

fs_save_config(3)					     fs_save_config(3)

NAME
       fs_save_config	    - Saves an AdvFS domain configuration.

SYNOPSIS
       #include <stocfg/fs_config.h>

	 char *fs_save_config(		 char *object_type,
	    char *object_name,		  char **err_buf);

       );

LIBRARY
       File System & Storage Configuration Library libstocfg

PARAMETERS
       Points  to  an  object  type.  Points to an object name; for example, a
       domain name, a fileset name, or	a  directory  path  depending  on  the
       object  type.   Points to a pointer which points to a location in which
       the function stores an error message.

DESCRIPTION
       This function saves the configuration of	 an  AdvFS  domain,  including
       information  about  its	filesets and volumes. Filesets and volumes can
       remain online while the configuration is captured.

       Valid names of object types are ADVFS_DOMAIN,ADVFS_FILESET, and	MOUNT‐
       POINT.

       For ADVFS_DOMAIN, the configuration of the AdvFS domain, all associated
       AdvFS filesets and volumes are captured.

       For each AdvFS volume  that  is	an  LSM	 volume,  the  associated  LSM
       diskgroup configuration is also captured.

       For  ADVFS_FILESET  or  MOUNTPOINT, the configuration of the associated
       AdvFS domain is captured. For each AdvFS volume that is an LSM  volume,
       the associated LSM diskgroup configuration is also captured. For MOUNT‐
       POINT, an error will be returned if the mountpoint  is  not  associated
       with an AdvFS fileset.

       The configuration description contains sufficient information to recre‐
       ate the configuration cloning the associated disks and then  using  the
       fs_restore_config function.

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

RESTRICTIONS
       You must be the root user to execute this function.

RETURN VALUES
       Upon successful completion, the function returns a pointer to a charac‐
       ter buffer containing a description of the configuration.  The configu‐
       ration description is expressed in the XML format.  See	fs_config_data
       for a description of the output format.	Returns NULL and sets *err_buf
       to point to an error message.

EXAMPLES
       The  following  example	saves  a   domain   configuration.    #include
       <sys/types.h> #include <stdio.h> #include <stocfg/fs_config.h> main(int
       argc, char **argv) {
	char *config=NULL,*err_buf=NULL;
	   if(argc < 3)
	   {
	 printf("Usage: %s <object_type> <object_name>\n",*argv);
	      printf("\twhere object_type is one of:\n");
	   printf("\t\tADVFS_DOMAIN\n");
	   printf("\t\tADVFS_FILESET\n");
	      printf("\t\tMOUNTPOINT\n");
	    exit(0);
	   }
	    config = fs_save_config(*(argv +1),*(argv +2),&err_buf);
	       }

SEE ALSO
       Functions: fs_get_dom_list(3),

       fs_get_fset_list(3), fs_config_get_devs(3), fs_restore_config(3)

       Files: fs_config_data(4)

							     fs_save_config(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net