---
title: "cluster list-open-protocol-handles"
slug: "cluster-list-open-protocol-handles"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/cluster-list-open-protocol-handles"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cluster list-open-protocol-handles

This command lists open file handles.

## **Usage**

```plaintext
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**

```plaintext
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                 |
+-----------------+-----------------+-------------+--------------+-------------+-----------+------------+----------+------------+------------+------------------+---------------------+
```