clonefset man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

clonefset(8)							  clonefset(8)

       clonefset - Creates a read-only copy of an AdvFS fileset.

       /usr/sbin/clonefset domain fileset clonename

       Specifies  the name of an existing AdvFS domain.	 Specifies the name of
       the original fileset that the clonefset utility will clone.   Specifies
       the name of the read-only fileset created by the clonefset utility.

       The  clonefset  utility enables you to perform online backups of active
       files by making a read-only copy (clone) of an active fileset. Once you
       create  and  mount a clone fileset, you can back up the clone using the
       vdump command or other supported backup utility (the  dump  command  is
       not  supported  by  AdvFS). Note that the clonefset utility only clones
       AdvFS filesets; it does not clone UFS file systems.

       A clone fileset is a read-only  snapshot	 of  fileset  data  structures
       (metadata).   When  you	clone  a  fileset, the utility copies only the
       structure of the original fileset, not its data. When you modify	 files
       in  the	original fileset, the file system copies the original pages to
       the clone fileset. In this way, the clone fileset contents  remain  the
       same as when you first created it.

       You  can	 create	 new versions of a clone fileset, but you can maintain
       only one clone per fileset at a time. You cannot rename a  clone	 file‐
       set,  but there is a workaround. You can remove an existing clone file‐
       set (and all its files) by using the rmfset command, then create a  new
       one with the new name.

       You must be root user to clone an AdvFS fileset.

       Each  fileset within a domain must have a unique name of up to 31 char‐
       acters.	All whitespace characters (tab, new line, space, and so forth)
       and the / # : * ?  characters are invalid for fileset names.

       The  clonefset  command cannot be used on filesets enabled for the Data
       Management Application Programming Interface (DMAPI), since domains  of
       DAMPI-enabled  file  systems  are limited to one fileset only.  See the
       AdvFS Administration for more information about DMAPI.

       Do not create a clone fileset if	 the  available	 disk  space  for  the
       domain  is  less than 5 percent of the total. When a domain runs out of
       disk space, the file system loses its ability to maintain  the  consis‐
       tency  of  files	 within	 clone	filesets.  When the file system can no
       longer maintain consistency, it displays warning	 messages  similar  to
       the following on the user's terminal and to the console: WARNING: advfs
       cannot copy-on-write data to a clone file.   WARNING:  encountered  the
       following  error:  ENO_MORE_BLKS (-1040) WARNING: do not continue using
       the   clone   fileset.	 WARNING:   original   file   set:   name=mnt,
       id=2c06a73f.00027192.00000001.8001 WARNING: clone file set: name=clone,
       id=2c06a73f.00027192.00000002.8002 WARNING: file id = 0000000a.8002

       This   message	also   appears	 in   the   /var/adm/syslog.dated/lat‐
       est_boot_date/kern.log file.

       The following example creates a read-only copy of the credit_fs fileset
       that resides in the accounts_dmn domain.	 The  clone  fileset  name  in
       this  example  is  credit_clone1.  This example also performs an online
       backup and removes the clone fileset after the backup  is  complete:  #
       mkdir	/mnt/credit_clone1    #	  clonefset   accounts_dmn   credit_fs
       credit_clone1	#    mount    -t    advfs    account_dmn#credit_clone1
       /mnt/credit_clone1     #	    vdump    /mnt/credit_clone1	   #	umount
       /mnt/credit_clone1 # rmfset account_dmn credit_clone1

       Commands: rmfset(8), tar(1), showfdmn(8), vdump(8), vrestore(8)

       Functions: advfs_clonefset(3)

       File Formats: advfs(4)


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]
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