vserver locks break

Contributors

Break file locks based on a set of criteria

Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

Description

The vserver locks break command breaks one or more locks.

Parameters

{ -vserver <vserver name> - Vserver

This parameter specifies the Vserver containing the lock.

-volume <volume name> - Volume

This parameter specifies the name of the volume containing the lock.

-lif <lif-name> - Logical Interface

This parameter specifies the logical interface through which the lock was established.

-path <text> - Object Path

This parameter specifies a path to the lock.

| -lockid <UUID> - Lock UUID }

This parameter specifies the universally unique identifier (UUID) for the lock. Queries and wildcard characters are not supported.

-owner-id <text> - Owner ID

This parameter specifies an owner ID for a lock. This parameter must be used with the query notation { } exhibited in the second example.

-protocol <lock protocol> - Lock Protocol

This parameter specifies the protocol that was used to establish a lock. This parameter must be used with the query notation { } exhibited in the second example.

-client-address <IP Address> - Client Address

This parameter specifies a client address associated with a lock. This parameter must be used with the query notation { } exhibited in the second example.

-client-address-type {ipv4|ipv6|ipv6z} - Client Address Type

This parameter specifies the type of ip address a client used to create its lock (ipv4, ipv6). This parameter must be used with the query notation { } exhibited in the second example.

Examples

The following example breaks the locks on all objects on the Vserver named vs0 in the volume named vol0, regardless of the paths to the locked objects and the logical interface through which the locks were established.

cluster1::*> vserver locks break -vserver vs0 -volume vol0 -path * -lif *
WARNING: Breaking file locks can cause applications to become unsynchronized
         and may lead to data corruption.
Do you want to continue? {y|n}: y
1 entry was acted on.

The vserver locks break command can also be issued using a query on the parameters available to the vserver locks show command. The following example breaks all NLM protocol lock objects locked by the client at address 12.34.56.78.

cluster1::*> vserver locks break { -protocol nlm -client-address 12.34.56.78 }
Warning: Breaking file locks can cause applications to become unsynchronized
         and may lead to data corruption.
Do you want to continue? {y|n}: y
1 entry was acted on.