Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

clonefset(8) [osf1 man page]

clonefset(8)						      System Manager's Manual						      clonefset(8)

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

mkfset(8)						      System Manager's Manual							 mkfset(8)

mkfset - Create a fileset in an existing AdvFS file domain SYNOPSIS
/sbin/mkfset domain fileset OPERANDS
Specifies the name of an existing AdvFS file domain. Specifies the name of the fileset to be created in the specified file domain. DESCRIPTION
The mkfset command creates an AdvFS fileset within an existing file domain. You must create at least one fileset per file domain; however, you can create multiple filesets within a file domain. You can mount and unmount each fileset independently of the other filesets in the file domain. You can assign fileset quotas (block and file usage limits) to filesets. Use the following commands to manipulate filesets: Displays the filesets associated with a domain. Removes a fileset (and all of its files) from the file domain. Assigns a new name to an existing fileset. Changes fileset attributes; specifically fileset quotas. For more information, see the reference pages for each command. RESTRICTIONS
You must be the root user to use this utility. Each fileset within a domain must have a unique name of up to 31 characters. All whitespace characters (tab, new line, space and so on) and the / # : * ? characters are invalid for fileset names. EXAMPLE
The following example creates two filesets, credit_fs and debit_fs, within an existing domain called accounts_dmn. # mkfset accounts_dmn credit_fs # mkfset accounts_dmn debit_fs To mount the newly created credit_fs fileset on the /mnt/credit directory, enter: # mount -t advfs accounts_dmn#credit_fs /mnt/credit You can add filesets to the /etc/fstab file in the same manner that you add any file system. Once added, filesets are mounted each time you reboot the system and fileset quotas are enabled. For example, to automatically mount the credit_fs fileset, add the following line to your fstab file: accounts_dmn#credit_fs /mnt/credit advfs rq, userquota, groupquota SEE ALSO
Commands: chfsets(8), mkfdmn(8), renamefset(8), rmfset(8), showfdmn(8), showfsets(8) File Formats: advfs(4) mkfset(8)
Man Page