openfilesquery list-open-file-handles

  • Published on Mar 26, 2026
  • 3 minute(s) read
Prev Next

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

NOTE: This command is available starting with VAST Cluster 5.4.1.

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

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:

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

Related articles