# Lock

Tooz provides distributed locks. A lock is identified by a name, and a lock can only be acquired by one coordinator at a time.

    # Copyright (C) 2020 Red Hat, Inc.
    #
    # Licensed under the Apache License, Version 2.0 (the "License");
    # you may not use this file except in compliance with the License.
    # You may obtain a copy of the License at
    #
    #    http://www.apache.org/licenses/LICENSE-2.0
    #
    # Unless required by applicable law or agreed to in writing, software
    # distributed under the License is distributed on an "AS IS" BASIS,
    # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
    # implied.
    # See the License for the specific language governing permissions and
    # limitations under the License.

    from tooz import coordination

    coordinator = coordination.get_coordinator('redis://localhost:6379', b'host-1')
    coordinator.start()

    # Create a lock
    lock = coordinator.get_lock("foobar")
    with lock:
        print("Do something that is distributed")

    coordinator.stop()

The method `tooz.coordination.CoordinationDriver.get_lock()` allows to create a lock identified by a name. Once you retrieve this lock, you can use it as a context manager or use the `tooz.locking.Lock.acquire()` and `tooz.locking.Lock.release()` methods to acquire and release the lock.

this page last updated: 2026-03-22 10:15:37

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug