volume clone show
Display a list of FlexClones
Availability: This command is available to cluster and Vserver administrators at the admin privilege level.
Description
The volume clone show command displays information about FlexClone clone volumes. This command is only supported for flexible volumes. By default, the command displays the following information about all FlexClone volume clones:
- Vserver name
- FlexClone volume name
- Parent volume name
- Parent snapshot name
- Whether a FlexClone volume is online or offline
Parameters
- { [-fields <fieldname>, ...]
- Selects the fields to be displayed.
- | [-estimate ]
- Displays an estimate of the free disk space required in the aggregate to split the indicated clone volume from its underlying parent volume. The value reported may differ from the space actually required to perform the split, especially if the clone volume is changing when the split is being performed.
- | [-instance ]}
- Displays detailed information about FlexClone volumes. If -flexclone is also specified, the command displays detailed information about the FlexClone volume.
- [-vserver <vserver name>] - Vserver Name
- Selects summary information for the FlexClone volumes on the specified Vserver. If -flexclone is also specified, the command displays detailed information about the specified FlexClone volume.
- [-flexclone <volume name>] - FlexClone Volume
- Selects summary information for the specified FlexClone volume. If -vserver is also specified, the command displays detailed information about the specified FlexClone volume.
- [-type {RW|DP}] - FlexClone Type
- Selects information for the specified type of FlexClone volume. The type can be specified as either read-only (DP) or read-write (RW).
- [-parent-vserver <vserver name>] - FlexClone Parent Vserver
- Selects summary information for the FlexClone volumes that are clone volumes in the specified parent Vserver.
- [-parent-volume | -b <volume name>] - FlexClone Parent Volume
- Selects summary information for the FlexClone volumes that are clones of the specified parent volume.
- [-parent-snapshot <snapshot name>] - FlexClone Parent Snapshot
- Selects summary information for the FlexClone volumes that are clones of the parent volume to which the specified snapshot belongs.
- [-state {online|restricted|offline|force-online|force-offline|mixed}] - FlexClone Volume State
- Selects summary information for the FlexClone volumes that are in the specified state.
- [-junction-path <junction path>] - Junction Path
- Selects summary information for the FlexClone volumes that have the specified junction path.
- [-junction-active {true|false}] - Junction Active
- Selects summary information for the FlexClone volumes that have the specified junction path status.
- [-space-guarantee | -s {none|volume}] - Space Guarantee Style
- If this parameter is specified, the command displays information only about the volumes that have the specified space guarantee style.
- [-space-guarantee-enabled {true|false}] - Space Guarantee In Effect
- Selects summary information for the FlexClone volumes that have the specified space-guarantee setting.
- [-aggregate <aggregate name>] - FlexClone Aggregate
- Selects summary information for the FlexClone volumes that reside on the specified storage aggregate.
- [-dsid <integer>] - FlexClone Data Set ID
- Selects summary information for the FlexClone volumes that have the specified Data Set ID.
- [-msid <integer>] - FlexClone Master Data Set ID
- Selects summary information for the FlexClone volumes that have the specified Master Data Set ID.
- [-size {<integer>[KB|MB|GB|TB|PB]}] - FlexClone Size
- Selects summary information for the FlexClone volumes that have the specified size.
- [-used {<integer>[KB|MB|GB|TB|PB]}] - Used Size
- Selects summary information for the FlexClone volumes that have the specified amount of used space.
- [-split-estimate {<integer>[KB|MB|GB|TB|PB]}] - Split Estimate
- Selects summary information for the FlexClone volumes that require the specified amount of free disk space for splitting from the parent.
- [-blocks-scanned <integer>] - Blocks Scanned
- Selects summary information for the FlexClone volumes that have the specified number of blocks scanned for splitting the FlexClone volume from its parent volume.
- [-blocks-updated <integer>] - Blocks Updated
- Selects summary information for the FlexClone volumes that have the specified number of blocks updated for after splitting the FlexClone volume from its parent volume.
- [-comment <text>] - Comment
- Selects summary information for the FlexClone volumes that have the specified comment.
- [-qos-policy-group <text>] - QoS Policy Group Name
- Selects summary information for the FlexClone volumes that have the specified QoS policy group.
- [-qos-adaptive-policy-group <text>] - QoS Adaptive Policy Group Name
- Selects summary information for the FlexClone volumes that have the specified QoS adaptive policy group.
- [-caching-policy <text>] - Caching Policy Name
- This optionally specifies the caching policy to apply to the volume. A caching policy defines how the system caches this volume's data in Flash Cache modules. If a caching policy is not assigned to this volume, the system uses the caching policy that is assigned to the containing Vserver. If a caching policy is not assigned to the containing Vserver, the system uses the default cluster-wide policy. The available caching policies are:
- none - Does not cache any user data or metadata blocks.
- auto - Read caches all metadata and randomly read user data blocks, and write caches all randomly overwritten user data blocks.
- meta - Read caches only metadata blocks.
- random_read - Read caches all metadata and randomly read user data blocks.
- random_read_write - Read caches all metadata, randomly read and randomly written user data blocks.
- all_read - Read caches all metadata, randomly read, and sequentially read user data blocks.
- all_read_random_write - Read caches all metadata, randomly read, sequentially read and randomly written user data.
- all - Read caches all data blocks read and written. It does not do any write caching.
- noread-random_write - Write caches all randomly overwritten user data blocks. It does not do any read caching.
- meta-random_write - Read caches all metadata and write caches randomly overwritten user data blocks.
- random_read_write-random_write - Read caches all metadata, randomly read and randomly written user data blocks. It also write caches randomly overwritten user data blocks.
- all_read-random_write - Read caches all metadata, randomly read, and sequentially read user data blocks. It also write caches randomly overwritten user data blocks.
- all_read_random_write-random_write - Read caches all metadata, randomly read, sequentially read and randomly written user data. It also write caches randomly overwritten user data blocks.
- all-random_write - Read caches all data blocks read and written. It also write caches randomly overwritten user data blocks.
- [-parent-vol-type <volAccessType>] - Parent volume type (privilege: advanced)
- Selects summary information for the FlexClone volumes that are clones of the parent volumes with the specified type.
- [-flexclone-used-percent <percent>] - FlexClone Used Percentage
- Selects summary information for the FlexClone volumes that have the specified percentage of used space.
- [-vserver-dr-protection {protected|unprotected}] - Vserver DR Protection
- Selects summary information for the FlexClone volumes that have the specified type of Vserver SnapMirror protection. This parameter is applicable only if the Vserver is the source of a Vserver level SnapMirror relationship.
- [-block-percentage-complete <integer>] - Percentage Complete
- Selects summary information for the FlexClone volumes that have specified percentage of Blocks processed for splitting the FlexClone volume from its parent volume.
- [-uid <integer>] - Volume-Level UID
- Selects summary information for the FlexClone volumes that are created with the specified volume-level UID.
- [-gid <integer>] - Volume-Level GID
- Selects summary information for the FlexClone volumes that are created with the specified volume-level GID.
- [-is-constituent {true|false}] - Is Constituent Volume
- If this parameter is specified, the command displays information only about volumes that either are or are not constituents of a FlexGroup, depending on the value provided.
- [-is-flexgroup {true|false}] - Is Volume a FlexGroup
- If this parameter is specified, the command displays information only about the volume or volumes that are either FlexGroups or not, depending on the value provided.
- [-volume-style-extended {flexvol|flexgroup|flexgroup-constituent}] - Extended Volume Style
- If this parameter is specified, the command displays information only about the volumes that are configured with the specified extended style. Possible values are flexvol for FlexVol volumes, flexgroup for FlexGroups and flexgroup-constituent for FlexGroup constituents.
Examples
Give documentation feedback