volume show-footprint

Description​

The volume show-footprint command displays information about the space used in associated aggregates by volumes and features enabled in volumes. The command output depends on the parameter or parameters specified with the command. If no parameters are specified, the command displays the following information about all volumes. If the associated aggregates have an object-store attached to them, then the command displays a more detailed split up of the space used in each tier. This additional information is useful to show per-tier space usage which can be used to estimate the space requirements and transfer duration when moving a volume to a different tier with volume move.

Parameters​

{ [-fields <fieldname>, ...]

If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ]}

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver

If this parameter and the -volume parameter are specified, the command displays detailed information about the specified volume. If this parameter is specified by itself, the command displays information about volumes on the specified Vserver.

[-volume <volume name>] - Volume Name

If this parameter and the -vserver parameter are specified, the command displays detailed information about the specified volume. If this parameter is specified by itself, the command displays information about all volumes matching the specified name.

[-volume-msid <integer>] - Volume MSID

If this parameter is specified, the command displays information only about the volume that has the specified MSID.

[-volume-dsid <integer>] - Volume DSID

If this parameter is specified, the command displays information only about the volume that has the specified DSID.

[-vserver-uuid <UUID>] - Vserver UUID

If this parameter is specified, the command displays information only about the volume on the vserver which has the specified UUID.

[-aggregate <aggregate name>] - Aggregate Name

If this parameter is specified, the command displays information only about the volumes that are associated with the specified aggregate.

[-aggregate-uuid <UUID>] - Aggregate UUID

If this parameter is specified, the command displays information only about the volumes on the aggregate which have the specified UUID.

[-hostname <text>] - Hostname

If this parameter is specified, the command displays information only about the volumes that belong to the specified host.

[-tape-backup-metafiles-footprint {<integer>[KB|MB|GB|TB|PB]}] - Tape Backup Metadata Footprint

If this parameter is specified, the command displays information only about the volumes whose tape backup metafiles use the specified amount of space in the aggregate.

[-tape-backup-metafiles-footprint-percent <percent>] - Tape Backup Metadata Footprint Percent

If this parameter is specified, the command displays information only about the volumes whose tape backup metafiles use the specified percentage of space in the aggregate.

[-dedupe-metafiles-footprint {<integer>[KB|MB|GB|TB|PB]}] - Deduplication Footprint

If this parameter is specified, the command displays information only about the volumes whose deduplication metafiles use the specified amount of space in the aggregate.

[-dedupe-metafiles-footprint-percent <percent>] - Deduplication Footprint Percent

If this parameter is specified, the command displays information only about the volumes whose deduplication metafiles use the specified percentage of space in the aggregate.

[-dedupe-metafiles-temporary-footprint {<integer>[KB|MB|GB|TB|PB]}] - Temporary Deduplication Footprint

If this parameter is specified, the command displays information only about the volumes whose temporary deduplication metafiles use the specified amount of space in the aggregate.

[-dedupe-metafiles-temporary-footprint-percent <percent>] - Temporary Deduplication Footprint Percent

If this parameter is specified, the command displays information only about the volumes whose temporary deduplication metafiles use the specified percentage of space in the aggregate.

[-cross-volume-dedupe-metafiles-footprint {<integer>[KB|MB|GB|TB|PB]}] - Cross Volume Deduplication Footprint

If this parameter is specified, the command displays information only about the volumes whose cross volume deduplication metafiles use the specified amount of space in the aggregate.

[-cross-volume-dedupe-metafiles-footprint-percent <percent>] - Cross Volume Deduplication Footprint Percent

If this parameter is specified, the command displays information only about the volumes whose cross volume deduplication metafiles use the specified percentage of space in the aggregate.

[-cross-volume-dedupe-metafiles-temporary-footprint {<integer>[KB|MB|GB|TB|PB]}] - Cross Volume Temporary Deduplication Footprint

If this parameter is specified, the command displays information only about the volumes whose cross volume deduplication temporary metafiles use the specified amount of space in the aggregate.

[-cross-volume-dedupe-metafiles-temporary-footprint-percent <percent>] - Cross Volume Temporary Deduplication Footprint Percent

If this parameter is specified, the command displays information only about the volumes whose cross volume deduplication temporary metafiles use the specified percentage of space in the aggregate.

[-volume-blocks-footprint {<integer>[KB|MB|GB|TB|PB]}] - Volume Data Footprint

If this parameter is specified, the command displays information only about the volumes whose data blocks use the specified amount of space in the aggregate.

This field is the total amount of data written to the volume. It includes data in the active file system in the volume as well as data that is consumed by volume Snapshot copies. This row only includes data and not reserved space, so when volumes have reserved files, the volume's total used in the volume show-space command output can exceed the value in this row.

[-volume-blocks-footprint-percent <percent>] - Volume Data Footprint Percent

If this parameter is specified, the command displays information only about the volumes whose data blocks use the specified percentage of space in the aggregate.

[-flexvol-metadata-footprint {<integer>[KB|MB|GB|TB|PB]}] - Flexible Volume Metadata Footprint

If this parameter is specified, the command displays information only about the volumes whose file system metadata uses the specified amount of space in the aggregate.

This field includes the space used or reserved in the aggregate for metadata associated with this volume.

[-flexvol-metadata-footprint-percent <percent>] - Flexible Volume Metadata Footprint Percent

If this parameter is specified, the command displays information only about the volumes whose file system metadata uses the specified percentage of space in the aggregate.

[-delayed-free-footprint {<integer>[KB|MB|GB|TB|PB]}] - Delayed Free Blocks

If this parameter is specified, the command displays information only about the volumes whose delayed free blocks use the specified amount of space in the aggregate.

When Data ONTAP frees space in a volume, this space is not always immediately shown as free in the aggregate. This is because the operations to free the space in the aggregate are batched for increased performance. Blocks that are declared free in the FlexVol volume but which are not yet free in the aggregate are called "delayed free blocks" until the associated delayed free blocks are processed. For SnapMirror destinations, this row will have a value of 0 and will not be displayed.

[-delayed-free-footprint-percent <percent>] - Delayed Free Blocks Percent

If this parameter is specified, the command displays information only about the volumes that have the specified amount of blocks waiting to be freed in the aggregate. This space is called "delayed free blocks".

[-snapmirror-destination-footprint {<integer>[KB|MB|GB|TB|PB]}] - SnapMirror Destination Footprint

If this parameter is specified, the command displays information only about the volumes whose SnapMirror transfer uses the specified amount of space in the aggregate.

During a SnapMirror transfer, this row will include incoming SnapMirror data and SnapMirror-triggered delayed free blocks from previous SnapMirror transfers.

[-snapmirror-destination-footprint-percent <percent>] - SnapMirror Destination Footprint Percent

If this parameter is specified, the command displays information only about the volumes whose SnapMirror transfer uses the specified percentage of space in the aggregate.

[-volume-guarantee-footprint {<integer>[KB|MB|GB|TB|PB]}] - Volume Guarantee

If this parameter is specified, the command displays information only about the volumes whose guarantees use the specified amount of space in the aggregate.

This field includes the amount of space reserved by this volume in the aggregate for future writes. The amount of space reserved depends on the guarantee type (the provisioning mode) of the volume. For a "volume" guaranteed volume, this is the size of the volume minus the amount in the Volume Data Footprint row. For a "file" guaranteed volume, this is the sum of all of the space reserved for hole fills and overwrites in all of the space reserved files in the volume.

[-volume-guarantee-footprint-percent <percent>] - Volume Guarantee Percent

If this parameter is specified, the command displays information only about the volumes whose guarantees use the specified percentage of space in the aggregate.

[-file-operation-metadata {<integer>[KB|MB|GB|TB|PB]}] - File Operation Metadata

If this parameter is specified, the command displays information only about the volumes that have file operation metadata using the specified amount of space in the aggregate.

This metadata is used by file move and copy operations. Although it is not returned as free space once the operations are complete, it can be reused by future file operations.

[-file-operation-metadata-percent <percent>] - File Operation Metadata Percent

If this parameter is specified, the command displays information only about the volumes that have file operation metadata using the specified percentage of space in the aggregate.

[-total-footprint {<integer>[KB|MB|GB|TB|PB]}] - Total Footprint

If this parameter is specified, the command displays information only about the volumes which use the specified amount of space in the aggregate. This field is the sum of the other rows in this table.

[-total-footprint-percent <percent>] - Total Footprint Percent

If this parameter is specified, the command displays information only about the volumes which use the specified percentage of space in the aggregate.

[-aggregate-size {<integer>[KB|MB|GB|TB|PB]}] - Containing Aggregate Size

If this parameter is specified, the command displays information only about the volumes that are associated with an aggregate of the specified size.

[-bin0-name <text>] - Name for bin0

If this parameter is specified, the command displays information only about volumes whose associated aggregate has an object store attached to it with an active file system tier name matches the specified value.

[-volume-blocks-footprint-bin0 {<integer>[KB|MB|GB|TB|PB]}] - Volume Footprint for bin0

If this parameter is specified, the command displays information only about volumes whose space in use in the performance tier of the aggregate matches the specified value.

[-volume-blocks-footprint-bin0-percent <percent>] - Volume Footprint bin0 Percent

If this parameter is specified, the command displays information only about volumes whose percentage space in use in the performance tier of the aggregate matches the specified value.

[-bin1-name <text>] - Name for bin1

If this parameter is specified, the command displays information only about volumes whose associated aggregate has a cloud tier attached to it with a configuration name that matches the specified value.

[-volume-blocks-footprint-bin1 {<integer>[KB|MB|GB|TB|PB]}] - Volume Footprint for bin1

If this parameter is specified, the command displays information only about volumes whose space in use in the first cloud tier bucket attached to the associated aggregate matches the specified value. This includes the space used by the blocks in the volume that are staged before being moved to the cloud tier.

[-volume-blocks-footprint-bin1-percent <percent>] - Volume Footprint bin1 Percent

If this parameter is specified, the command displays information only about volumes whose percentage space in use in the first cloud tier bucket attached to associated aggregate matches the specified value. This includes the space used by the blocks in the volume that are staged before being moved to the cloud tier.