Warning

The product is in closed beta and not open to the public.

lock-info

vb lock-info [PATH...] [OPTIONS]

Description

Show all branch lock information for the specified file.

Options

-u, --user Name

List locks for the specified user; repeatable

--exclude-user Name

Exclude locks owned by the specified user; repeatable

-b, --branch Name

List locks on the specified branch; repeatable

--exclude-branch Name

Exclude locks on the specified branch; repeatable

-v, --verbose

List every file in each lock group

Use G with –branch or –exclude-branch to include or exclude global locks.

Examples

  • Show all locks:

    $ vb lock-info
    alice locked 2 files on trunk, expires 2026-10-16 10:30:00; comment: Character update
    buildbot locked 1 file on G, expires 2026-10-16 18:00:00
    
  • Show detailed lock information, including every locked file:

    $ vb lock-info --verbose
    alice locked 2 files on trunk, expires 2026-10-16 10:30:00
      comment: Character update
      files:
        Content/Characters/Hero.uasset
        Content/Characters/Hero_Skeleton.uasset
    
    buildbot locked 1 file on G, expires 2026-10-16 18:00:00
      files:
        Config/DefaultGame.ini
    
  • Show the lock for a file:

    $ vb lock-info Content/Characters/Hero.uasset
    alice locked 1 file on trunk, expires 2026-10-16 10:30:00; comment: Character update
    
  • Show locks for all tracked files in a directory:

    $ vb lock-info Content/Characters
    alice locked 2 files on trunk, expires 2026-10-16 10:30:00; comment: Character update
    
  • Include locks owned by specific users:

    $ vb lock-info --user alice --user bob
    alice locked 2 files on trunk, expires 2026-10-16 10:30:00; comment: Character update
    
  • Exclude locks owned by a user:

    $ vb lock-info --exclude-user buildbot
    alice locked 2 files on trunk, expires 2026-10-16 10:30:00; comment: Character update
    
  • Include locks from specific branches:

    $ vb lock-info --branch trunk --branch release
    alice locked 2 files on trunk, expires 2026-10-16 10:30:00; comment: Character update
    
  • Show global locks:

    $ vb lock-info --branch G
    buildbot locked 1 file on G, expires 2026-10-16 18:00:00
    
  • Combine path, user, and branch filters:

    $ vb lock-info Content/Characters --user alice --branch trunk --verbose
    alice locked 2 files on trunk, expires 2026-10-16 10:30:00
      comment: Character update
      files:
        Content/Characters/Hero.uasset
        Content/Characters/Hero_Skeleton.uasset
    

See Also