The volume show-space command displays information about space usage within the volume. 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.

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.
[-user-data {<integer>[KB|MB|GB|TB|PB]}] - User Data: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by user data in the volume.

This is the amount of data written to the volume via CIFS, NFS or SAN protocols plus the space reserved in the volume for these files (hole and overwrite reserves). This is the same information displayed by running the Unix du command on the mount point.
[-user-data-percent <percent_no_limit>] - User Data Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by user data in the volume.
[-dedupe-metafiles {<integer>[KB|MB|GB|TB|PB]}] - Deduplication: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by deduplication metafiles in the volume.
[-dedupe-metafiles-percent <percent>] - Deduplication Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by deduplication metafiles in the volume.
[-dedupe-metafiles-temporary {<integer>[KB|MB|GB|TB|PB]}] - Temporary Deduplication: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by temporary deduplication metafiles in the volume.
[-dedupe-metafiles-temporary-percent <percent>] - Temporary Deduplication Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by temporary deduplication metafiles in the volume.
[-filesystem-metadata {<integer>[KB|MB|GB|TB|PB]}] - Filesystem Metadata: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by file system metadata in the volume.
[-filesystem-metadata-percent <percent>] - Filesystem Metadata Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by file system metadata in the volume.
[-snapmirror-metadata {<integer>[KB|MB|GB|TB|PB]}] - SnapMirror Metadata: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by SnapMirror metafiles in the volume.

Between SnapMirror transfers, some metadata is maintained to support storage-efficient transfers. During transfers, some additional space is used temporarily. This space is used in all SnapMirror destination volumes.
[-snapmirror-metadata-percent <percent>] - SnapMirror Metadata Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by SnapMirror metafiles inside the volume.
[-tape-backup-metadata {<integer>[KB|MB|GB|TB|PB]}] - Tape Backup Metadata: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by tape backup metafiles in the volume.
[-tape-backup-metadata-percent <percent>] - Tape Backup Metadata Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by tape backup metafiles in the volume.
[-quota-metafiles {<integer>[KB|MB|GB|TB|PB]}] - Quota Metadata: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by quota metafiles.
[-quota-metafiles-percent <percent>] - Quota Metadata Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by quota metafiles.
[-inodes {<integer>[KB|MB|GB|TB|PB]}] - Inodes: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by the inode metafile in the volume.

This is the amount of space required to store inodes in the file system and is proportional to the maximum number of files ever created in the volume. The inode file is not compacted or truncated, so if a large number of files are created and then deleted, the inode file does not shrink.
[-inodes-percent <percent>] - Inodes Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by the inode metafile in the volume.
[-inodes-upgrade {<integer>[KB|MB|GB|TB|PB]}] - Inodes Upgrade: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by the inode subsystem for the purpose of upgrading.

This is the amount of space required to store upgrading inodes in the file system and is proportional to the size of the inode metafile. Once the upgrade is complete, the space used by 'inodes' will be replaced with the space used for upgrade.
[-inodes-upgrade-percent <percent>] - Inodes Upgrade Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use for upgrading the inode metafile in the volume.
[-snapshot-reserve {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Reserve: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by the Snapshot reserve in the volume.
[-snapshot-reserve-percent <percent>] - Snapshot Reserve Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by the Snapshot reserve in the volume.
[-snapshot-reserve-unusable {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Reserve Unusable: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space reserved but unusable in the volume.

Snapshot reserve can be diminished under certain conditions to accommodate volume metadata. Creating space in the volume will make this space available.
[-snapshot-reserve-unusable-percent <integer>] - Snapshot Reserve Unusable Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space reserved but unusable.
[-snapshot-spill {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Spill: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by their Snapshot spill.

If Snapshot used space exceeds the Snapshot reserve it is considered to spill out of the reserve. This space cannot be used by the active file system until Snapshots are deleted.
[-snapshot-spill-percent <percent>] - Snapshot Spill Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by the Snapshot spill.
[-performance-metadata {<integer>[KB|MB|GB|TB|PB]}] - Performance Metadata: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use for performance optimization in the volume.
[-performance-metadata-percent <percent>] - Performance Metadata Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use for performance optimization in the volume.
[-total-used {<integer>[KB|MB|GB|TB|PB]}] - Total Used: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by the volume, including the space used by the Snapshot reserve. total-used differs from physical-used space by the sum of of the space that is reserved for future writes and the space that is saved by aggregate storage efficiency savings being removed from total-used .

This is equivalent to the used field in the output of the volume show command.
[-total-used-percent <percent_no_limit>] - Total Used Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by the volume, including the space used by the Snapshot reserve.
[-physical-used {<integer>[KB|MB|GB|TB|PB]}] - Total Physical Used Size: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of physical space in use by the volume.

physical-used differs from total-used space by the sum of the space that is reserved for future writes and the space that is saved saved by aggregate storage efficiency savings being added to physical-used . The value includes blocks in use by Snapshot copies.
[-physical-used-percent <percent_no_limit>] - Physical Used Percentage: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of physical space in use in the volume based on volume size including the space reserved for Snapshot copies.
[-logical-used {<integer>[KB|MB|GB|TB|PB]}] - Logical Used Size: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of logical space in use by the volume. This includes space saved by all the storage efficiency features along with physical used space. This does not include Snapshot reserve but does consider Snapshot spill.
[-logical-used-percent <percent_no_limit>] - Logical Used Percent: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of logical space used in the volume.
[-logical-available {<integer>[KB|MB|GB|TB|PB]}] - Logical Available: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of logical available space in the volume.
[-total-metadata {<integer>[KB|MB|GB|TB|PB]}] - Total Metadata: If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space used by metadata in the volume. This field will not include the metadata of the volume which is residing inside the aggregate.
[-total-metadata-percent <percent>] - Total Metadata Percentage: If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space used by metadata in the volume.

Examples

The following example shows how to display details for all volumes.

cluster1::> volume show-space
Vserver : nodevs
      Volume  : vol0
Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                               163.4MB         3%
      Filesystem Metadata                       172KB         0%
      Inodes                                   2.93MB         0%
      Snapshot Reserve                        292.9MB         5%
      Total Metadata        185KB        0%
Total Used                              459.4MB         8%
Total Physical Used                     166.4MB         3%
Vserver : thevs
      Volume  : rootvol
Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                                 100KB         0%
      Filesystem Metadata                        76KB         0%
      Inodes                                     24KB         0%
      Snapshot Reserve                            1MB         5%
      Total Metadata                            89KB          0%
Total Used                               1.20MB         6%
Total Physical Used                       200KB         1%
Vserver : vs1
      Volume  : vol1
Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                               180.8MB        74%
      Filesystem Metadata                       280KB         0%
      Inodes                                     12KB         0%
      Snapshot Reserve                        12.20MB         5%
      Total Metadata        295KB        0%
Total Used                              193.3MB        79%
Total Physical Used                     192.9MB        79%
3 entries were displayed.

The following example shows all Volumes that have a snap reserve greater than 2 MB:

cluster1::> volume show-space -snapshot-reserve >2m
Vserver : nodevs
      Volume  : vol0
Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                               163.4MB         3%
      Filesystem Metadata                       172KB         0%
      Inodes                                   2.93MB         0%
      Snapshot Reserve                        292.9MB         5%
      Total Metadata                           3.21MB         0%
Total Used                              459.4MB         8%
Total Physical Used                     166.4MB         3%
Vserver : vs1
      Volume  : vol1
Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                               180.8MB        74%
      Filesystem Metadata                       280KB         0%
      Inodes                                     12KB         0%
      Snapshot Reserve                        12.20MB         5%
      Total Metadata                            312KB         0%
Total Used                              193.3MB        79%
Total Physical Used                     192.9MB        79%
2 entries were displayed.

volume show

ONTAP 9.15.1 commands

volume show-space

Description

Parameters

Examples

Related Links