Bundle Commands

Every command the bundle module offers, from its declarations, in order of the resource each acts on. Each command's help says the same.

Bundle

lnk bundle create

Build programs from source for their targets, then seal and sign them

lnk bundle create [name] [--signing-secret <signing-secret>] [--spec <file>] [field flags]

It takes name, position 1, string: A built-in bundle by name (lnk bundle list), its paths the folder it's run in. It takes --signing-secret, path: The signer's secret file, read only once every program is built [default: the named signer's, in ~/.lnk/safe/bundles/signers/<name>/secret]. It reads the bundle spec, from a file or its field flags. It answers bundle.made.

lnk bundle list

List the bundles the module comes with, such as devbox and link

lnk bundle list [--json]

It takes --json, boolean: Print the answer as JSON for other programs. It answers bundle.shelf.

lnk bundle show

Show a bundle's programs, their targets and architectures, its sums and signature checked

lnk bundle show <folder> [--json] [--root] [--signer <signer>]
  • folder, position 1, string, required: The bundle's folder, or its name or version, kept in ~/.lnk/data/bundles
  • --json, boolean: Print the answer as JSON for other programs
  • --root, boolean: Print only its folder, checked, for another program to use
  • --signer, string: The signer it must be signed by: link, staging, or an allowed-signers file [default: Link's signer, said either way]

It answers bundle.contents.

Signer

lnk bundle signer create

Make a signer of your own, kept in the Safe, to sign bundles by its name

lnk bundle signer create <name> [--json]

It takes --json, boolean: Print the answer as JSON for other programs. It takes name, position 1, string, required: Its name: lowercase letters, digits and dashes. It answers bundle.signer.

lnk bundle signer show

Show a signer of your own: its folder in the Safe and the line a machine trusts it by

lnk bundle signer show <name> [--json]

It takes --json, boolean: Print the answer as JSON for other programs. It takes name, position 1, string, required: Its name (lnk bundle create --signer <name> made it, or lnk bundle signer create). It answers bundle.signer.