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-conflictstill 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