cluster list-open-protocol-handles

  • Updated on Jan 30, 2026
  • 1 minute(s) read
Prev Next

This command lists open file handles.

Usage

cluster list-open-protocol-handles --file-path PATH
                                  [--share SHARE]
                                  [--tenant-name TENANT]
                                  [--cluster-id ID]
                                  [--show-nfs4.1-only-handles]

Required Parameters

--file-path PATH

Specify the file path.

For SMB views, specify the path within the share specified in --share.

Options

--share SHARE

For SMB views, specify the name of the share in which the file resides.

--tenant-name TENANT

Specify the name of the tenant where the file resides.

If this option is not specified, the default tenant is used.

--cluster-id ID

Specify the cluster ID.

You can verify the cluster ID by running cluster list.

Default: 1.

--show-nfsv.1-only-handles

Filters the display to include only handles that can be used by NFSv4.1 clients.

Example

vcli: admin> cluster list-open-protocol-handles --file-path /run_bg_many_mercuries/p_smb-f_SMB-windows--saucy-woodpecker

File handle
+--------------------+----------+----------------+---------------+-------------------------+------------------------------+
|            ehandle | clone_id | delete_pending | has_any_lease | lease_break_in_progress | number_open_protocol_handles |
+--------------------+----------+----------------+---------------+-------------------------+------------------------------+
| 0xec4b600e1132e090 |      0x0 | False          | False         | False                   |                            1 |
+--------------------+----------+----------------+---------------+-------------------------+------------------------------+
Open protocol handles
+-----------------+-----------------+-------------+--------------+-------------+-----------+------------+----------+------------+------------+------------------+---------------------+
|      session_id |       unique_id | client_ip   | share_access | access_mask | has_lease | is_durable | username | proto_type | nfs4_seqid | is_nfs_expirable | nfs_expiration_time |
+-----------------+-----------------+-------------+--------------+-------------+-----------+------------+----------+------------+------------+------------------+---------------------+
| 0x350a200000003 | 0x350a200000534 | 192.0.2.20  | R+W+D        |    0x100081 | False     | False      | UNKNOWN  | SMB        | N/A        | N/A              | N/A                 |
+-----------------+-----------------+-------------+--------------+-------------+-----------+------------+----------+------------+------------+------------------+---------------------+

Related articles