Skip to main content

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

To display detailed information about all FlexClone volumes, run the command with the -instance parameter.

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.

Note that in a caching-policy name, a hyphen (-) separates read and write policies. Default caching-policy is auto.
[-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.

Examples