Function check_lock

ci/util/lock_admin.py:143–189

Check status of a specific lock.

(lock_name: str)

def check_lock(lock_name: str) -> int:
    """Check status of a specific lock."""
    print(f"\n🔍 LOCK INFORMATION: {lock_name}")
    print("=" * 80)

    db = get_lock_database()
    holders = db.get_lock_info(lock_name)

    if not holders:
        print(f"❌ No lock found with name: {lock_name}")
        return 1

    for holder in holders:
        pid = holder["owner_pid"]
        operation = holder["operation"]
        hostname = holder["hostname"]
        mode = holder["lock_mode"]
        acquired_at = holder["acquired_at"]

        print(f"PID: {pid}")
        print(f"Operation: {operation}")
        print(f"Mode: {mode}")
        print(f"Acquired at: {acquired_at}")
        print(f"Hostname: {hostname}")

        if is_process_alive(pid):
            print(f"Process status: 🟢 ALIVE (PID {pid} is running)")
            print("Lock status: ACTIVE")
        else:
            print(f"Process status: 🔴 DEAD (PID {pid} not found)")
            print("Lock status: STALE")

    print("=" * 80)

    # Offer to break stale lock
    stale_holders = [h for h in holders if not is_process_alive(h["owner_pid"])]
    if stale_holders:
        response = input("\nStale holder(s) found. Break them? (yes/no): ")
        if response.lower() == "yes":
            if db.break_stale_lock(lock_name):
                print("✅ Stale lock(s) broken successfully")
                return 0
            else:
                print("❌ Failed to break stale lock(s)")
                return 1

    return 0


def main() -> int: