Warning

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

lock-keepalive

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

Description

Extend the lock duration for the specified files. If no duration is specified, the default duration is used, which can be configured via set lock-time.

Options

-s, --skip-conflict

Skip files that conflict with this operation

-g, --global

Apply keepalive to global branch

-v, --verbose

List files when the operation conflicts

-n, --dry-run

Show what would be renewed without making changes

-t, --time DURATION

Set lock duration (ISO 8601 format), e.g.: PnYnMnDTnHnMnS or simplified forms like P1D, PT2H30M

Examples

  • Lock and then renew a file on the current branch:

    $ vb lock Content/Hero.uasset
    LOCK trunk Content/Hero.uasset
    $ vb lock-keepalive Content/Hero.uasset --time PT2H
    KEEPALIVE trunk Content/Hero.uasset
    
  • Lock and then renew multiple files:

    $ vb lock Config/DefaultGame.ini Content/Maps/Start.umap
    LOCK trunk Config/DefaultGame.ini
    LOCK trunk Content/Maps/Start.umap
    $ vb lock-keepalive Config/DefaultGame.ini Content/Maps/Start.umap --time PT4H
    KEEPALIVE trunk Config/DefaultGame.ini
    KEEPALIVE trunk Content/Maps/Start.umap
    
  • Lock and then renew all files in a directory:

    $ vb lock Content/Characters
    LOCK trunk Content/Characters/Hero.uasset
    LOCK trunk Content/Characters/Hero_Skeleton.uasset
    $ vb lock-keepalive Content/Characters --time P1D
    KEEPALIVE trunk Content/Characters/Hero.uasset
    KEEPALIVE trunk Content/Characters/Hero_Skeleton.uasset
    
  • Create and then renew a global lock:

    $ vb lock Content/Maps/Start.umap --global
    LOCK G Content/Maps/Start.umap
    $ vb lock-keepalive Content/Maps/Start.umap --global --time PT30M
    KEEPALIVE G Content/Maps/Start.umap
    
  • Renew locks owned by the current user and skip files that are not locked:

    $ vb lock Config/DefaultGame.ini
    LOCK trunk Config/DefaultGame.ini
    $ vb lock-keepalive Config/DefaultGame.ini Content/Hero.uasset --time PT4H --skip-conflict
    KEEPALIVE trunk Config/DefaultGame.ini
    
  • --skip-conflict still fails when none of the selected files are locked by the current user:

    $ vb lock-keepalive Content/Hero.uasset --time PT4H --skip-conflict
    lock-keepalive: cannot renew 1 file
      1 file not locked on trunk
    lock-keepalive: use --verbose to list affected files
    
  • Show detailed conflict information:

    $ vb lock-keepalive Content/Hero.uasset Config/DefaultGame.ini --time PT4H --verbose
    lock-keepalive: cannot renew 2 files
      locked by another user:
        alice locked 1 file on trunk, expires 2026-10-16 10:30:00
          comment: Character update
          files:
            Content/Hero.uasset
    
      not locked on trunk:
        Config/DefaultGame.ini
    

See Also

See also

lock, unlock, lock-info