snaplock legal-hold show
Show status of a legal-hold operation.
Description
The snaplock legal-hold show command displays the status of a legal-hold operation. Information about completed operations will be cleaned up after an hour of completion. Only a user with security login role vsadmin-snaplock is allowed to perform this operation.
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 Name
- If this parameter is specified, the command displays all legal-hold operations that match the specified Vserver.
- [-operation-id <integer>] - Operation ID
- If this parameter is specified, the command displays all legal-hold operations that match the specified operation ID.
- [-volume <volume name>] - Volume Name
- If this parameter is specified, the command displays all legal-hold operations that match the specified volume. The parameter specifies the volume on which legal-hold operation is running or has completed.
- [-path <text>] - Path
- If this parameter is specified, the command displays all legal-hold operations that match the specified path. The parameter specifies the path on which legal-hold operation is running or has completed.
- [-litigation-name <text>] - Litigation Name
- If this parameter is specified, the command displays all legal-hold operations that match the specified litigation name. The parameter specifies the legal-hold litigation name.
- [-operation-type {unknown|begin|end|dump-files}] - Operation Type
- If this parameter is specified, the command displays all legal-hold operations that match the specified operation type. The parameter specifies the type of legal-hold operation.
- [-operation-status {Unknown|In-Progress|Failed|Aborting|Completed}] - Operation Status
- If this parameter is specified, the command displays all legal-hold operations that match the specified operation status. The parameter specifies the status of legal-hold operation.
- [-num-files-processed <integer>] - Number of Files Processed
- If this parameter is specified, the command displays all legal-hold operations that match the specified number of files processed. The parameter specifies the number of files on which legal-hold operation was successful.
- [-num-files-failed <integer>] - Number of Files Failed
- If this parameter is specified, the command displays all legal-hold operations that match the specified number of files failed. The parameter specifies the number of files on which legal-hold operation failed.
- [-num-files-skipped <integer>] - Number of Files Skipped
- If this parameter is specified, the command displays all legal-hold operations that match the specified number of files skipped.
The parameter specifies the number of files on which legal-hold begin operation was skipped. The legal-hold begin operation is skipped on a file if it is already under hold for a given litigation or if it is a hard link to a file that is already under hold for a given litigation.
- [-num-inodes-ignored <integer>] - Number of Inodes Ignored
- If this parameter is specified, the command displays all legal-hold operations that match the specified number of inodes ignored. The parameter specifies the number of inodes on which the legal-hold operation was not attempted because they were not regular files.
- [-status-details <text>] - Status Details
- If this parameter is specified, the command displays all legal-hold operations that match the specified status details. The parameter specifies the status details of an legal-hold operation.
Examples
The following examples show the status of legal-hold operations for Vserver vs1 and volume slc_vol1 and the status of legal-hold operation for operation ID 16842786 respectively:
vs1::> snaplock legal-hold show -volume slc_vol1
Operation
Operation Operation ID Vserver Volume Status
------------- --------------- --------- ------- ---------
begin 16842784 vs1 slc_vol1
Completed
begin 16842786 vs1 slc_vol1
Completed
begin 16842788 vs1 slc_vol1
In-Progress
dump-files 16842790 vs1 slc_vol1
Completed
end 16842794 vs1 slc_vol1
Completed
5 entries were displayed.
vs1::> snaplock legal-hold show -operation-id 16842786
Vserver: vs1
Volume: slc_vol1
Operation ID: 16842786
Litigation Name: litigation1
Path: /
Operation Type: begin
Status: Completed
Number of Files Processed: 100
Number of Files Failed: 15
Number of Files Skipped: 20
Number of Inodes Ignored: 0
Status Details: No error