*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> fs_save_config (3)              



NAME    [Toc]    [Back]

       fs_save_config        -  Saves  an AdvFS domain configuration.

SYNOPSIS    [Toc]    [Back]

       #include <stocfg/fs_config.h>

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


LIBRARY    [Toc]    [Back]

       File System & Storage Configuration Library libstocfg

PARAMETERS    [Toc]    [Back]

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

       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,

       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 MOUNTPOINT, an error will
       be returned if the mountpoint is not  associated  with  an
       AdvFS fileset.

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

NOTES    [Toc]    [Back]

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

RESTRICTIONS    [Toc]    [Back]

       You must be the root user to execute this function.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the function returns a pointer
       to a character buffer containing a description of the configuration.
  The configuration 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    [Toc]    [Back]

       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");
            config     =     fs_save_config(*(argv     +1),*(argv

SEE ALSO    [Toc]    [Back]

       Functions: fs_get_dom_list(3),

       fs_get_fset_list(3),                fs_config_get_devs(3),

       Files: fs_config_data(4)

[ Back ]
 Similar pages
Name OS Title
fs_restore_config Tru64 Restores an AdvFS domain configuration.
fs_config_data Tru64 Describes the configuration data for an AdvFS domain.
fs_config_get_devs Tru64 Obtains a list of devices in an AdvFS domain configuration.
mkfdmn Tru64 Creates a new AdvFS domain
advfs_get_fdmn_list Tru64 Get an AdvFS file domain list
nvlogpg Tru64 Displays the log file of an AdvFS domain
showfsets Tru64 Displays information about filesets in an AdvFS domain
stripe Tru64 Stripes a file across several volumes in an AdvFS domain.
switchlog Tru64 moves an AdvFS file domain transaction log
fs_get_fset_list Tru64 Obtains a list of all the filesets in an AdvFS domain.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service