volume file show-disk-usage

Show disk usage of file

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

This command requires a path to a file in a volume and displays the following information: If not logged in as Vserver administrator, the command also requires a Vserver name.
Note: The "-instance" option provides the same result as the default as there are no extra fields to display.

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.
| [-h ]
If this parameter is specified, the command displays total bytes used by the file in human readable form.
| [-k ]
If this parameter is specified, the command displays total bytes used by the file in kilobytes.
| [-m ]
If this parameter is specified, the command displays total bytes used by the file in megabytes.
| [-u ]
If this parameter is specified, the command displays the unique bytes used by the file (bytes that are not shared with any other file in the volume due to deduplication or FlexClone files) in kilobytes.
| [-uh ]
If this parameter is specified, the command displays the unique bytes used by the file in human readable form.
| [-uk ]
If this parameter is specified, the command displays the unique bytes used by the file in kilobytes.
| [-um ]
If this parameter is specified, the command displays the unique bytes used by the file in megabytes.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
-vserver <vserver name> - Vserver
This parameter is used to specify the Vserver that contains the file for which the command displays the total bytes used. It is required if not logged in as Vserver administrator.
-path </vol/<volume name>/<file path>> - Full Path
This required parameter is used to specify the path of the file for which the command displays the total bytes used.
[-range | -r <<start offset>:<end offset>>] - Block Range
If this parameter is specified, the command displays the total bytes used by the file in the specified block range.

Examples

The following example displays the disk-usage of the file file1.txt in volume /vol/root_vs0.
cluster1::> volume file show-disk-usage -vserver vs0 -path /vol/root_vs0/file1.txt

Vserver          Total                  Path 
--------         ------                 -----         
vs0              1408KB                 /vol/root_vs0/file1.txt
cluster1::> volume file show-disk-usage -m -vserver vs0 -path /vol/root_vs0/file1.txt

Vserver          Total                  Path 
--------         ------                 -----         
vs0              1MB                    /vol/root_vs0/file1.txt
vs0::> volume file show-disk-usage -um -path /vol/root_vs0/file1.txt

Vserver       Total             Unique              Path
--------      -----             ------              -------        
vs0           1MB               1MB                 /vol/root_vs0/file1.txt