---
title: "openfilesquery list-open-file-handles"
slug: "openfilesquery-list-open-file-handles"
updated: 2026-10-27T17:24:31Z
published: 2026-10-27T17:24:31Z
canonical: "docs.vastdata.com/openfilesquery-list-open-file-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.

# openfilesquery list-open-file-handles

# 

This command displays a list of open handles for a file.

Before using this command:

1. Run `openfilesquery list-open-files` to obtain the file ID of the file for which you want to list open handles.
2. Run `openfilesquery query-open-file-handles` to retrieve a list of open handles for the file ID.

## Usage

```plaintext
openfilesquery list-open-file-handles --file-id ID
                                     [--page-size COUNT]
                                     [--page PAGE-NUMBER]
```

## Required Parameters

| `--file-id ID` | The ID of the open file for which you want to list open handles. The ID can be obtained with the `openfilesquery list-open-files` command. |
| --- | --- |

## Options

| --page-size COUNT | Sets the maximum number of entries in an output page. Valid values: 1-1000. Default: 100. |
| --- | --- |
| --page PAGE-NUMBER | Displays a particular output page. By default, page 1 is displayed. Using this option requires that the page size (`--page-size`) is specified. |

## Example

To list open file handles for a file with ID 1732781:

```plaintext
vcli: admin> openfilesquery list-open-file-handles --file-id 1732781
Last query was launched at 2025-10-26 13:23:19. Use `openfilesquery query-open-file-handles` to refresh it.
+-------+--------------+-----------+-----------------+-----------------+------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+------------------+----------+-----------+
| ID    | Open-file-id | Tenant-id | Session-id      | Unique-id       | Client-ip  | Share-access | Access-mask                                                                                                                                                                                                                                                             | Has-lease | Username         | Protocol | Has-locks |
+-------+--------------+-----------+-----------------+-----------------+------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+------------------+----------+-----------+
| 10344 | 1732781      | 1         | 0xb21c20000000d | 0xb21c200000004 | N/A        | R+W+D        | ['LIST_DIR_OR_READ_DATA', 'ADD_FILE_OR_WRITE_DATA', 'ADD_SUBDIR_OR_APPEND_DATA', 'FILE_READ_EA', 'FILE_WRITE_EA', 'TRAVERSE_DIR_OR_EXECUTE_FILE', 'FILE_READ_ATTRIBUTES', 'FILE_WRITE_ATTRIBUTES', 'DELETE', 'READ_CONTROL', 'WRITE_DAC', 'WRITE_OWNER', 'SYNCHRONIZE'] | False     | inna@example.com | SMB      | False     |
| 10345 | 1732781      | 1         | 0xb20e20000000e | 0xb20e20000006b | 192.0.2.3  | R+W+D        | ['LIST_DIR_OR_READ_DATA', 'ADD_FILE_OR_WRITE_DATA', 'ADD_SUBDIR_OR_APPEND_DATA', 'FILE_READ_EA', 'FILE_WRITE_EA', 'TRAVERSE_DIR_OR_EXECUTE_FILE', 'FILE_READ_ATTRIBUTES', 'FILE_WRITE_ATTRIBUTES', 'DELETE', 'READ_CONTROL', 'WRITE_DAC', 'WRITE_OWNER', 'SYNCHRONIZE'] | False     | inna@example.com | SMB      | False     |
| 10346 | 1732781      | 1         | 0xb21320000000f | 0xb2132000011d7 | 192.0.2.9  | R+W+D        | ['LIST_DIR_OR_READ_DATA', 'ADD_FILE_OR_WRITE_DATA', 'ADD_SUBDIR_OR_APPEND_DATA', 'FILE_READ_EA', 'FILE_WRITE_EA', 'TRAVERSE_DIR_OR_EXECUTE_FILE', 'FILE_READ_ATTRIBUTES', 'FILE_WRITE_ATTRIBUTES', 'DELETE', 'READ_CONTROL', 'WRITE_DAC', 'WRITE_OWNER', 'SYNCHRONIZE'] | False     | inna@example.com | SMB      | False     |
| 10347 | 1732781      | 1         | 0xb20b20000489b | 0xb20b20000126d | 192.0.2.4  | R+W+D        | ['LIST_DIR_OR_READ_DATA', 'ADD_FILE_OR_WRITE_DATA', 'ADD_SUBDIR_OR_APPEND_DATA', 'FILE_READ_EA', 'FILE_WRITE_EA', 'TRAVERSE_DIR_OR_EXECUTE_FILE', 'FILE_READ_ATTRIBUTES', 'FILE_WRITE_ATTRIBUTES', 'DELETE', 'READ_CONTROL', 'WRITE_DAC', 'WRITE_OWNER', 'SYNCHRONIZE'] | False     | inna@example.com | SMB      | False     |
| 10348 | 1732781      | 1         | 0xb22220000fcb9 | 0xb22220000402b | 192.0.2.6  | R+W+D        | ['LIST_DIR_OR_READ_DATA', 'ADD_FILE_OR_WRITE_DATA', 'ADD_SUBDIR_OR_APPEND_DATA', 'FILE_READ_EA', 'FILE_WRITE_EA', 'TRAVERSE_DIR_OR_EXECUTE_FILE', 'FILE_READ_ATTRIBUTES', 'FILE_WRITE_ATTRIBUTES', 'DELETE', 'READ_CONTROL', 'WRITE_DAC', 'WRITE_OWNER', 'SYNCHRONIZE'] | False     | inna@example.com | SMB      | False     |
| 10349 | 1732781      | 1         | 0xb20b20000489b | 0xb20b200002c9c | 192.0.2.7  | R+W+D        | ['LIST_DIR_OR_READ_DATA', 'ADD_FILE_OR_WRITE_DATA', 'ADD_SUBDIR_OR_APPEND_DATA', 'FILE_READ_EA', 'FILE_WRITE_EA', 'TRAVERSE_DIR_OR_EXECUTE_FILE', 'FILE_READ_ATTRIBUTES', 'FILE_WRITE_ATTRIBUTES', 'DELETE', 'READ_CONTROL', 'WRITE_DAC', 'WRITE_OWNER', 'SYNCHRONIZE'] | False     | inna@example.com | SMB      | False     |
+-------+--------------+-----------+-----------------+-----------------+------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------+------------------+----------+-----------+
```