volume file fingerprint dump
Display fingerprint of a file
Availability: This command is available to cluster and Vserver administrators at the admin privilege level.
Description
The volume file fingerprint dump
command displays the following information given the -session-id
of the fingerprint operation:
-
Vserver:
The Vserver on which the file exists.
* Session-ID:
A unique identifier for the fingerprint operation. This session-id is returned when the fingerprint operation is started on a file. The session-id of the fingerprint operation can be used to get the progress of an ongoing fingerprint operation as well as the complete fingerprint output for the file once the operation is completed.
* Volume:
The name of the volume on which the file resides.
* Path:
The absolute path of the file on which the fingerprint is calculated. The value begins with /vol/<volumename>.
* Data Fingerprint:
The digest value of data of the file. The fingerprint is base64 encoded. This field is not included if the scope is metadata-only
.
* Metadata Fingerprint:
The digest value of metadata of the file. The metadata fingerprint is calculated for file size, file ctime, file mtime, file crtime, file retention time, file uid, file gid, and file type. The fingerprint is base64 encoded. This field is not included if the scope is data-only
.
* Fingerprint Algorithm:
The digest algorithm which is used for the fingerprint computation. Fingerprint is computed using md5
or sha-256
digest algorithm.
* Fingerprint Scope:
The scope of the file which is used for the fingerprint computation. Fingerprint is computed over data-only
, metadata-only
, or data-and-metadata
.
* Fingerprint Start Time:
The start time of the fingerprint computation in seconds since 1 January 1970 00:00:00 in GMT timezone.
* Formatted Fingerprint Start Time:
The start time of the fingerprint computation in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
* Fingerprint Version:
The version of the fingerprint output format.
* SnapLock License:
The status of the SnapLock license.
* Vserver UUID:
A universal unique identifier for the Vserver on which the file exists.
* Volume MSID:
The mirror set identifier of the volume where the file resides.
* Volume DSID:
The data set identifier of the volume where the file resides.
* Hostname:
The name of the storage system where the fingerprint operation is performed.
* Filer ID:
The NVRAM identifier of the storage system.
* Volume Containing Aggregate:
The name of the aggregate in which the volume resides.
* Aggregate ID:
A universal unique identifier for the aggregate containing the volume.
* SnapLock System ComplianceClock:
The System ComplianceClock time in seconds since 1 January 1970 00:00:00 in GMT timezone if it is initialized.
* Formatted SnapLock System ComplianceClock:
The System ComplianceClock time in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone if it is initialized.
* Volume SnapLock Type:
The type of the SnapLock volume. This value is only given for SnapLock volumes. Possible values are compliance
and enterprise
.
* Volume ComplianceClock:
The volume ComplianceClock time in seconds since 1 January 1970 00:00:00 in GMT timezone. This has a value only for SnapLock volumes.
* Formatted Volume ComplianceClock:
The volume ComplianceClock time in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone. This has a value only for SnapLock volumes.
* Volume Expiry Date:
The expiry date of the SnapLock volume in seconds since 1 January 1970 00:00:00 in GMT timezone. The volume expiry date can be in wraparound format.
* Is Volume Expiry Date Wraparound:
The value is true
if the volume expiry date is in wraparound format. The wraparound format indicates that dates after 19 January 2038 are mapped from 1 January 1970 through 31 December 2002 to 19 January 2038 through 19 January 2071.
* Formatted Volume Expiry Date:
The expiry date of the SnapLock volume in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone. The volume expiry date can be in wraparound format.
* Filesystem ID:
The filesystem identifier of the volume on which the file resides.
* File ID:
A unique number within the filesystem identifying the file.
* File Type:
The type of the file. Possible values include: worm
, worm_appendable
, worm_active_log
, worm_log
, and regular
.
* File Size:
The size of the file in bytes.
* Creation Time:
The creation time of the file in seconds since 1 January 1970 00:00:00 in GMT timezone.
* Formatted Creation Time:
The creation time of the file in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
* Modification Time:
The last modification time of the file in seconds since 1 January 1970 00:00:00 in GMT timezone.
* Formatted Modification Time:
The last modification time of the file in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
* Changed Time:
The last changed time of the file attributes in seconds since 1 January 1970 00:00:00 in GMT timezone. Time is taken from the system clock for regular files and from the volume ComplianceClock for WORM files when they are committed. The changed time can be in wraparound format.
* Is Changed Time Wraparound:
The value is true
if the last changed time of the file attributes is in wraparound format. The wraparound format indicates that dates after 19 January 2038 are mapped from 1 January 1970 through 31 December 2002 to 19 January 2038 through 19 January 2071.
* Formatted Changed Time:
The last changed time of the file attributes in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone. The changed time can be in wraparound format.
* Retention Time:
The retention time of the files committed to WORM on SnapLock volumes in seconds since 1 January 1970 00:00:00 in GMT timezone. The retention time can be in wraparound format.
* Is Retention Time Wraparound:
The value is true
if the retention time of the file is in wraparound format. The wraparound format indicates that dates after 19 January 2038 are mapped from 1 January 1970 through 31 December 2002 to 19 January 2038 through 19 January 2071.
* Formatted Retention Time:
The retention time of the files protected by SnapLock in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone. The retention time can be in wraparound format.
* Access Time:
The last access time of the regular files on SnapLock volumes and files on non-SnapLock volumes attributes in seconds since 1 January 1970 00:00:00 in GMT timezone.
* Formatted Access Time:
The last access time of the regular files on SnapLock volumes and files on non-SnapLock volumes attributes in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
* Owner ID:
The integer identifier of the owner of the file.
* Group ID:
The integer identifier of the group owning the file.
* Owner SID:
The security identifier of the owner of the file when it has NTFS security style.
* Fingerprint End Time:
The end time of the fingerprint computation in seconds since 1 January 1970 00:00:00 in GMT timezone.
* Formatted Fingerprint End Time:
The end time of the fingerprint computation in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
* Litigation Count:
The number of litigations on the file.
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. -session-id <integer>
- Session ID of Fingerprint Operation-
Specifies the session-id of the fingerprint operation whose output is to be displayed. It is a unique identifier for the fingerprint operation. This session-id is returned when the fingerprint operation is started on a file.
Examples
The following example displays the fingerprint information of the fingerprint session identified by session-id 17039367
:
cluster1::> volume file fingerprint dump -session-id 17039367 Vserver:vs1 Session-ID:17039367 Volume:nfs_slc Path:/vol/nfs_slc/worm Data Fingerprint:MOFJVevxNSJm3C/4Bn5oEEYH51CrudOzZYK4r5Cfy1g= Metadata Fingerprint:8iMjqJXiNcqgXT5XuRhLiEwIrJEihDmwS0hrexnjgmc= Fingerprint Algorithm:SHA256 Fingerprint Scope:data-and-metadata Fingerprint Start Time:1460612586 Formatted Fingerprint Start Time:Thu Apr 14 05:43:06 GMT 2016 Fingerprint Version:3 SnapLock License:available Vserver UUID:acf7ae64-00d6-11e6-a027-0050569c55ae Volume MSID:2152884007 Volume DSID:1028 Hostname:cluster1 Filer ID:5f18eda2-00b0-11e6-914e-6fb45e537b8d Volume Containing Aggregate:slc_aggr Aggregate ID:c84634aa-c757-4b98-8f07-eefe32565f67 SnapLock System ComplianceClock:1460610635 Formatted SnapLock System ComplianceClock:Thu Apr 14 05:10:35 GMT 2016 Volume SnapLock Type:compliance Volume ComplianceClock:1460610635 Formatted Volume ComplianceClock:Thu Apr 14 05:10:35 GMT 2016 Volume Expiry Date:1465880998 Is Volume Expiry Date Wraparound:false Formatted Volume Expiry Date:Tue Jun 14 05:09:58 GMT 2016 Filesystem ID:1028 File ID:96 File Type:worm File Size:1048576 Creation Time:1460612515 Formatted Creation Time:Thu Apr 14 05:41:55 GMT 2016 Modification Time:1460612515 Formatted Modification Time:Thu Apr 14 05:41:55 GMT 2016 Changed Time:1460610598 Is Changed Time Wraparound:false Formatted Changed Time:Thu Apr 14 05:09:58 GMT 2016 Retention Time:1465880998 Is Retention Time Wraparound:false Formatted Retention Time:Tue Jun 14 05:09:58 GMT 2016 Access Time:- Formatted Access Time:- Owner ID:0 Group ID:0 Owner SID:- Fingerprint End Time:1460612586 Formatted Fingerprint End Time:Thu Apr 14 05:43:06 GMT 2016 Litigation Count:0