license

vb license SUBCOMMAND [OPTIONS]

Description

Manage project and third-party SDK licenses.

Subcommands

vb license add (update)

vb license add|update LICENSENAME [OPTIONS] [KEY=VALUE] ...

Description

Add or update a license. KEY=VALUE pairs set fields or labels. If the same field is set by both an option and KEY=VALUE, the option wins. Special keys (case insensitive): version, type, homepage, checkin. All other keys are treated as label keys and can be repeated. A single argument may also contain multiple labels separated by ,. Label syntax: KEY is 1-63 chars of [A-Z a-z 0-9 _ . -] and must start/end with alnum; KEY must not be in or notin. VALUE is empty or 1-63 chars of [A-Z a-z 0-9 _ . -] (no spaces) and must start/end with alnum. For update, KEY= (or KEY=””) deletes that label. When using comma-separated labels, VALUE must not contain ,. LICENSENAME must be a well-formed license name: 1-100 characters, no leading/trailing spaces, no control characters (tab/newline), and no consecutive spaces.

Options

-f, --file FILE

Path to the license content file.

-v, --version VERSION

SDK version.

-t, --type TYPE

License type, such as MIT, BSD, GPL, etc.

-h, --homepage URL

SDK homepage URL.

-c, --checkin HASH

Check-in hashes associated with the license (space or , separated).

vb license remove

vb license remove LICENSENAME VALUE ...

Description

remove one or more fields from a license. VALUEs include version, type, homepage, checkins, labels or a specific label name.

vb license enable (disable)

vb license enable|disable LICENSENAME

Description

Mark a license as disable, or enable a previously disable license.

vb license import

vb license import FILE...

Description

Import licenses from TOML export files. Existing licenses are updated in place; missing licenses are created. Checkins entries are validated as checkins and stored in long-hash form; labels are upserted

vb license export

vb license export [LICENSENAME] [OPTIONS]

Description

Export licenses to stdout or a file in toml, text, json, or xlsx format. By default, all licenses are exported. Use -t|--type to choose the format (toml, text, json, xlsx). Use -o|--output to write to a file (required for xlsx).

Options

-t, --type TYPE

Export type, such as toml, text, json, xlsx.

-o, --output FILE

Output file path.

-f, --format FORMAT

Entry format. If --type is toml, license labels must appear at the end. A string which can contain the following placeholders:

%n  license name
%d  date
%u  last changed user
%v  license version
%t  license type
%h  license homepage
%c  license content
%C  Checkin hash
%L  license label
%N  Newline (only for text export)
--date DATE_FORMAT

Specify the output date format. Allowed values include:

iso     ISO-8601 timestamp.
short   Date only, YYYY-MM-DD.
rfc     RFC822 format.

vb license ls (list)

vb license ls|list [OPTIONS]

Description

List licenses.

Options

-F, --format FORMAT

Entry format. A string which can contain the following placeholders:

%n  license name
%d  date
%u  last changed user
%v  license version
%t  license type
%h  license homepage
%N  Newline
--date DATE_FORMAT

Specify the output date format. Allowed values include:

iso     ISO-8601 timestamp.
short   Date only, YYYY-MM-DD.
rfc     RFC822 format.
Filter options
--all

include disabled licenses.

--disabled

only show disabled licenses.

--verbose

show License content in the listing.

--type TYPE

filter by type.

--checkin HASH

filter by checkin.

--label SELECTOR

filter by label selector (key, !key, key=value, key!=value, key in (v1,v2), key notin (v1,v2)); use , for AND; type is treated as a special label.

Examples

  • Create a repository

$ vb init license_repo.vbyte
project-id: b10d6bf41059c6530d628ce0f306e6a756e37f27
server-id:  441d30f8e0769964280ff16a66711db4611bdd62
admin-user: ubuntu (initial remote-access password is "a4hHZkqsYv")
$ vb open -f license_repo.vbyte
project-name: <unnamed>
repository:   /tmp/sphinx_tests/68672033/license_repo/license_repo.vbyte
local-root:   /tmp/sphinx_tests/68672033/license_repo/
config-db:    /tmp/sphinx_tests/68672033/.visionbyte
project-code: b10d6bf41059c6530d628ce0f306e6a756e37f27
checkout:     ef90d806230b24f550a88fcb032acedf52ae4a0b 2026-03-20 03:03:24 UTC
tags:         trunk
comment:      initial empty check-in (user: ubuntu)
check-ins:    1

  • Add zlib license

$ vb sys cat LICENSE-zlib
Copyright notice:

 (C) 1995-2022 Jean-loup Gailly and Mark Adler

  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the authors be held liable for any damages
  arising from the use of this software.

  Permission is granted to anyone to use this software for any purpose,
  including commercial applications, and to alter it and redistribute it
  freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.

  Jean-loup Gailly        Mark Adler
  jloup@gzip.org          madler@alumni.caltech.edu
$ vb license add zlib -f LICENSE-zlib -t zlib -h "https://zlib.net/"
License zlib added

  • Import libuv license from a toml file

$ vb sys cat LICENSE-libuv.toml
[libuv]
Name="libuv"
Version="1.5.10"
Type="MIT"
Homepage="https://github.com/libuv/libuv"
License="""
Copyright (c) 2015-present libuv project contributors.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to
deal in the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
IN THE SOFTWARE.
"""
[libuv.Labels]
Targets="CLI"
Notes="Asynchronous_IO"
$ vb license import LICENSE-libuv.toml
Successfully created license libuv

  • Update zlib license type and version

$ vb license update zlib -t "Zlib License" -v 1.3.1
License zlib updated

  • Remove libuv version information

$ vb license remove libuv version
Successfully removed specified fields from license libuv

  • List all licenses with default format

$ vb license ls
Name:      zlib
Type:      Zlib License
Version:   1.3.1
Homepage:  https://zlib.net/

Name:      libuv
Type:      MIT
Version:   
Homepage:  https://github.com/libuv/libuv

  • Export zlib license to stdout

$ vb license export zlib
Name:zlib
Version:1.3.1
Type:Zlib License
Homepage:https://zlib.net/
User:ubuntu
Date:2026-03-20 03:03:24

Checkins:

License:
Copyright notice:

 (C) 1995-2022 Jean-loup Gailly and Mark Adler

  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the authors be held liable for any damages
  arising from the use of this software.

  Permission is granted to anyone to use this software for any purpose,
  including commercial applications, and to alter it and redistribute it
  freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.

  Jean-loup Gailly        Mark Adler
  jloup@gzip.org          madler@alumni.caltech.edu

  • Export zlib license to TOML format

$ vb license export zlib -t toml
[zlib]
Name="zlib"
Version="1.3.1"
Type="Zlib License"
Homepage="https://zlib.net/"
User="ubuntu"
Date="2026-03-20 03:03:24"
License="""
Copyright notice:

 (C) 1995-2022 Jean-loup Gailly and Mark Adler

  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the authors be held liable for any damages
  arising from the use of this software.

  Permission is granted to anyone to use this software for any purpose,
  including commercial applications, and to alter it and redistribute it
  freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.

  Jean-loup Gailly        Mark Adler
  jloup@gzip.org          madler@alumni.caltech.edu
"""

  • Disable libuv license

$ vb license ls -F "%n"
zlib
libuv
$ vb license disable libuv
Saved new control artifact e71b2610ac2d6085c47e6e1d9d4ec8f2932ffc669b5ca198231d2db407c53fc5 (RID 6).
license libuv disable

  • Enable libuv license

$ vb license enable libuv
Saved new control artifact dc5955fd854f56dc2ac4ff83d0ea891da1694503ddd198f4055d9acf59df4737 (RID 7).
license libuv enable

  • Filter licenses by type

$ vb license ls -type "MIT"
Name:      libuv
Type:      MIT
Version:   
Homepage:  https://github.com/libuv/libuv

  • Filter licenses with a label selector: MIT type and an existing ‘Notes’ label.

$ vb license update libuv Notes=Asyc_IO
License libuv updated
$ vb license ls --label "type=MIT, Notes"
Name:      libuv
Type:      MIT
Version:   
Homepage:  https://github.com/libuv/libuv