clonefset(8) [osf1 man page]
clonefset(8) System Manager's Manual clonefset(8) NAME
clonefset - Creates a read-only copy of an AdvFS fileset SYNOPSIS
/usr/sbin/clonefset domain fileset clonename OPERANDS
Specifies the name of an existing AdvFS file 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. DESCRIPTION
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 fileset (and all its files) by using the rmfset command, then create a new one with the new name. RESTRICTIONS
Each fileset within a domain must have a unique name of up to 31 characters. All whitespace characters (tab, new line, space, and so forth) and the / # : * ? characters are invalid for fileset names. Do not create a clone fileset if the available disk space for the file domain is less than 5 percent of the total. When a file domain runs out of disk space, the file system loses its ability to maintain the consistency 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/latest_boot_date/kern.log file. EXAMPLES
The following example creates a read-only copy of the credit_fs fileset that resides in the accounts_dmn file 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 com- plete: # 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 SEE ALSO
Commands: tar(1), showfdmn(8), vdump(8), vrestore(8) Functions: advfs_clonefset(3) File Formats: advfs(4) clonefset(8)
Check Out this Related Man Page
vdf(8) System Manager's Manual vdf(8) NAME
vdf - Display disk information for AdvFS domains and filesets SYNOPSIS
/sbin/advfs/vdf [-k] [-l] domain | domain#fileset OPTIONS
Display disk blocks as 1024-byte blocks instead of the default of 512-byte blocks. When the -l option is specified, the default informa- tion for both the domain and filesets is reformatted to show the relationships between them. For example, any domain metadata displayed is the total metadata shared by filesets in the domain. OPERANDS
The full path name of an AdvFS file domain. When a domain argument is specified, the default display contains information about the number of disk blocks allocated to the domain, the number of disk blocks in use by the domain, and the number of disk blocks that are available to the domain. The name of an AdvFS fileset in an AdvFS file domain. When a domain#fileset argument is specified, the default display contains information about the number of disk blocks allocated to the fileset, the number of disk blocks in use by the fileset, and the number of disk blocks that are available to the fileset. This information is in the same format as that displayed by the df command. DESCRIPTION
The vdf utility is a script that reformats output from the showfdmn, showfsets, shfragbf, and df utilities in order to display information about the disk usage of AdvFS file domains and filesets. In addition, the utility computes and displays the sizes of metadata files in a domain or fileset. NOTES
The disk space used by clone filesets is not calculated. If clone filesets are present in the specified domain, the utility displays the following warning message: Clone fileset(s) in this domain; totals may not be accurate RESTRICTIONS
You must be the root user to use this command. The command cannot be used on filesets that are NFS mounted. All filesets in a domain must be mounted in order to calculate the disk usage of the domain. EXIT STATUS
The utility returns a value of 0 (zero) on successful completion. It returns a value of 1 on failure. EXAMPLES
The following example shows the summary information for a fileset named testfs in a domain named test. The output is the same as for the df command: # vdf test#testfs Filesystem 512-blocks Used Available Capacity Mounted on test#testfs 60000 20800 39200 35% /mnt The following example shows the summary information for a domain named usr_domain where the number of blocks used for meta- data and data equal 89% of the domain's capacity: # vdf usr_domain Domain 512-blocks Metadata Used Available Capacity usr_domain 65536 11219 47549 6768 89% The following example shows a detailed display of the domain that contains the fileset test#testfs. There are two filesets in the domain; each has a quota limit of 60,000 blocks: # vdf -l test#testfs Domain 512-blocks Metadata Used Available Capacity test 266240 5824 29128 231288 13% Fileset QuotaLimit Used Available Capacity testfs 60000 20800 39200 35% testfs2 60000 8328 51672 14% The following example shows a detailed display of a fileset that is the only fileset in the domain and that the fileset has a quota limit that is greater than the domain can hold: # vdf -l test#testfs Domain 512-blocks Metadata Used Avail- able Capacity test 266240 5824 29128 231288 13% Fileset QuotaLimit Used Available Capacity testfs 300000 20800 231288 8% FILES
SEE ALSO
Commands: df(1), showfdmn(8), showfsets(8), shfragbf(8) Files: advfs(4) vdf(8)