---
title: "Managing SMB File Locks"
slug: "managing-smb-file-locks"
updated: 2026-10-27T17:24:08Z
published: 2026-10-27T17:24:08Z
canonical: "docs.vastdata.com/managing-smb-file-locks"
---

> ## 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.

# Managing SMB File Locks

You can view and release SMB byte range locks.

## Viewing and Releasing SMB Locks in VAST Web UI

To list all locks held by SMB clients on a given path and to release them:

1. From the left navigation menu, select Element Store.
2. On the Element Store page, select the Locks tab.
3. If you want to list locks for a non-default tenant, select the relevant tenant from the Tenant dropdown.
4. In the Enter Lock Path field, enter the path to the locked file. The path is in the format: `<view>/<filename>`, where `<view>` is the SMB-enabled view on the tenant, and `<filepath>` is the path to the file locked by the client, relative to the mount point.

For example, supposing we created a view called `/ExportExample` and we mounted the view onto a client directory called `/DirectoryExample`. Suppose we create and lock a file under `/DirectoryExample` called `examplefile`. To search for that lock, we need to search for the file path `/ExportExample/examplefile`.
5. Click Find Locks.

Any locks on the specified file are listed.

For each lock, the following information can be displayed:

> [!TIP]
> Tip
> 
> To display or hide fields, click ![column_menu.png](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/img-7f1bcc5ffaeed9cbf182efe768970783(118).png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A37%3A51Z&se=2026-11-08T10%3A37%3A51Z&sr=c&sp=r&sig=9%2Bmam%2Fh5J4DQyw0vjfnky%2FbhFuQm3fixfgh%2Bq70Fkuo%3D) to the right of a column title, and then click ![columns.png](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/img-918b4797fca5961ded0a6026c39d1bb1(126).png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A37%3A51Z&se=2026-11-08T10%3A37%3A51Z&sr=c&sp=r&sig=9%2Bmam%2Fh5J4DQyw0vjfnky%2FbhFuQm3fixfgh%2Bq70Fkuo%3D) to open a dropdown where you can select or unselect fields.

| ID | The ID of the lock. |
| --- | --- |
| Lock Path | The path to the locked file. |
| Lock Type | The lock type: - SMB locks - NLM4 locks taken by NFSv3 clients - NFS4 locks taken by NFSv4.1 clients |
| Create Time | The time the lock was acquired. |
| Caller | An identifier of the the client that acquired the lock. This could be an IP or host name of the client. |
| Owner | An identifier internal to the client kernel for the specific process that owns the lock. |
| Exclusive | Whether the lock is an exclusive (write) lock or a shared (read) lock. - Yes. The lock is an exclusive or write lock acquired by the client. - No. The lock is a shared, or read, lock. Many clients can access the file to read it, but no client may write to the locked byte range. |
| Granted Type | The type of delegation granted to the client. - READ. No other client has the ability to write to the file for the duration of the delegation. - WRITE. no other client has read or write access to the file for the duration of the delegation. |
| Offset | The number of bytes from the beginning of the file's byte range from which the lock begins. |
| Length | The number of bytes of the file locked by the lock. A length of 0 means the lock reaches until the end of the file. If both offset and length are `0`, the entire file is locked. |
| Svid | A kernel identifier of the owning process on the client machine. |
| State | The lock's state ID. |
| Client ID | The lock's client ID. |
| Open ID | The lock's open ID. |
| LOCK ID | The lock's LOCK ID. |
| Tenant Name | The lock's tenant. |
6. If you want to release locks on the path, click Release all locks on the given path.

All the locks listed are removed.

## Managing and Releasing SMB Locks in VAST CLI

To manage SMB locks in [CLI](/docs-5-3/docs/using-the-vast-cli), use the following commands.

> [!TIP]
> Tip
> 
> For full CLI command syntax, including VAST arguments, enter the command at the CLI prompt in the *<command> <subcommand>* format provided in the table, followed by *?*.

| Task | Command |
| --- | --- |
| View all locks on a path | `cluster list-locks` |
| Release all locks on a path | `cluster release-lock` |