volume file fingerprint dump

Contributors

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