volume file fingerprint start

Start a file fingerprint computation on a file

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

Description

The volume file fingerprint start command starts the fingerprint computation on a file. The fingerprint computation is started on the file, and a session-id is returned. This session-id is an unique identifier for the fingerprint operation and 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.

Parameters

-vserver <vserver name> - Vserver
Specifies the name of the vserver which owns the volume on which the file resides.
-file </vol/<volume name>/<file path>> - Path
Specifies the absolute path of the file on which fingerprint needs to be calculated. The value begins with /vol/<volumename>.
[-algorithm {MD5|SHA256}] - Fingerprint Algorithm
Specifies the digest algorithm which is used for the fingerprint computation.
Fingerprint can be computed using one of the following digest algorithms:
  • md5
  • sha-256
[-scope {data-and-metadata|data-only|metadata-only}] - Fingerprint Scope
Specifies the scope of the file which is used for the fingerprint computation.
Fingerprint can be computed using one of the following scope:
  • data-only
  • metadata-only
  • data-and-metadata

Examples

The following example starts computing fingerprint over data and metadata for file /vol/nfs_slc/worm using md5 hash algorithm. The file /vol/nfs_slc/worm is stored in volume nfs_slc on Vserver vs0.

cluster1::> volume file fingerprint start -vserver vs0 -scope data-and-metadata -algorithm md5 -file /vol/nfs_slc/worm
File fingerprint operation is queued. Run "volume file fingerprint show -session-id 16973825" to view the fingerprint session status.