fix: clap CLI definitions and manpage generation

- add #[group(skip)] to all Parser-derived structs
- fix conflicts_with and arg definitions for correct CLI behavior
- refactor bin entry points to support manpage generation
This commit is contained in:
Aiden McClelland
2026-03-18 23:48:13 -06:00
parent b1b7d2fa70
commit bcdeabfe85
471 changed files with 8753 additions and 50 deletions

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-admin-add 1 "add "
.SH NAME
start\-registry\-admin\-add \- Add admin signer
.SH SYNOPSIS
\fBstart\-registry admin add\fR [\fB\-h\fR|\fB\-\-help\fR] <\fISIGNER\fR> [\fIDATABASE\fR]
.SH DESCRIPTION
Add admin signer
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fISIGNER\fR>
Signer identifier
.TP
[\fIDATABASE\fR]
Path to the database file

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-admin-list 1 "list "
.SH NAME
start\-registry\-admin\-list \- List admin signers
.SH SYNOPSIS
\fBstart\-registry admin list\fR [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
List admin signers
.SH OPTIONS
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-admin-remove 1 "remove "
.SH NAME
start\-registry\-admin\-remove \- Remove admin signer
.SH SYNOPSIS
\fBstart\-registry admin remove\fR [\fB\-h\fR|\fB\-\-help\fR] <\fISIGNER\fR>
.SH DESCRIPTION
Remove admin signer
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fISIGNER\fR>
Signer identifier

View File

@@ -0,0 +1,25 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-admin-signer-add 1 "add "
.SH NAME
start\-registry\-admin\-signer\-add \- Add signer
.SH SYNOPSIS
\fBstart\-registry admin signer add\fR <\fB\-n\fR|\fB\-\-name\fR> [\fB\-c\fR|\fB\-\-contact\fR] [\fB\-\-key\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIDATABASE\fR]
.SH DESCRIPTION
Add signer
.SH OPTIONS
.TP
\fB\-n\fR, \fB\-\-name\fR \fI<NAME>\fR
Name of the signer
.TP
\fB\-c\fR, \fB\-\-contact\fR \fI<CONTACT>\fR
Contact information for signer
.TP
\fB\-\-key\fR \fI<KEYS>\fR
Public key for signer
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
[\fIDATABASE\fR]
Path to the database file

View File

@@ -0,0 +1,31 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-admin-signer-edit 1 "edit "
.SH NAME
start\-registry\-admin\-signer\-edit \- Edit signer information
.SH SYNOPSIS
\fBstart\-registry admin signer edit\fR [\fB\-n\fR|\fB\-\-set\-name\fR] [\fB\-c\fR|\fB\-\-add\-contact\fR] [\fB\-k\fR|\fB\-\-add\-key\fR] [\fB\-C\fR|\fB\-\-remove\-contact\fR] [\fB\-K\fR|\fB\-\-remove\-key\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR>
.SH DESCRIPTION
Edit signer information
.SH OPTIONS
.TP
\fB\-n\fR, \fB\-\-set\-name\fR \fI<SET_NAME>\fR
Set the signer name
.TP
\fB\-c\fR, \fB\-\-add\-contact\fR \fI<ADD_CONTACT>\fR
Add contact information to signer
.TP
\fB\-k\fR, \fB\-\-add\-key\fR \fI<ADD_KEY>\fR
Add a public key to signer
.TP
\fB\-C\fR, \fB\-\-remove\-contact\fR \fI<REMOVE_CONTACT>\fR
Remove contact from signer
.TP
\fB\-K\fR, \fB\-\-remove\-key\fR \fI<REMOVE_KEY>\fR
Remove public key from signer
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
Signer identifier

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-admin-signer-list 1 "list "
.SH NAME
start\-registry\-admin\-signer\-list \- List signers
.SH SYNOPSIS
\fBstart\-registry admin signer list\fR [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
List signers
.SH OPTIONS
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,23 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-admin-signer 1 "signer "
.SH NAME
start\-registry\-admin\-signer \- Commands to add or list signers
.SH SYNOPSIS
\fBstart\-registry admin signer\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Commands to add or list signers
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-admin\-signer\-add(1)
Add signer
.TP
start\-registry\-admin\-signer\-edit(1)
Edit signer information
.TP
start\-registry\-admin\-signer\-list(1)
List signers

View File

@@ -0,0 +1,26 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-admin 1 "admin "
.SH NAME
start\-registry\-admin \- Commands to add or list admins or signers
.SH SYNOPSIS
\fBstart\-registry admin\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Commands to add or list admins or signers
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-admin\-add(1)
Add admin signer
.TP
start\-registry\-admin\-list(1)
List admin signers
.TP
start\-registry\-admin\-remove(1)
Remove admin signer
.TP
start\-registry\-admin\-signer(1)
Commands to add or list signers

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-db-apply 1 "apply "
.SH NAME
start\-registry\-db\-apply \- Update a database record
.SH SYNOPSIS
\fBstart\-registry db apply\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIEXPR\fR> [\fIPATH\fR]
.SH DESCRIPTION
Update a database record
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIEXPR\fR>
Database patch expression to apply
.TP
[\fIPATH\fR]
Path to the database file

View File

@@ -0,0 +1,22 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-db-dump 1 "dump "
.SH NAME
start\-registry\-db\-dump \- Filter and query the database
.SH SYNOPSIS
\fBstart\-registry db dump\fR [\fB\-p\fR|\fB\-\-pointer\fR] [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIPATH\fR]
.SH DESCRIPTION
Filter and query the database
.SH OPTIONS
.TP
\fB\-p\fR, \fB\-\-pointer\fR \fI<POINTER>\fR
JSON pointer to object in database to dump
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
[\fIPATH\fR]
Path to the database file

View File

@@ -0,0 +1,20 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-db 1 "db "
.SH NAME
start\-registry\-db \- Commands to interact with the db i.e. dump and apply
.SH SYNOPSIS
\fBstart\-registry db\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Commands to interact with the db i.e. dump and apply
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-db\-apply(1)
Update a database record
.TP
start\-registry\-db\-dump(1)
Filter and query the database

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-index 1 "index "
.SH NAME
start\-registry\-index \- List registry info and packages
.SH SYNOPSIS
\fBstart\-registry index\fR [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
List registry info and packages
.SH OPTIONS
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-info-set-icon 1 "set-icon "
.SH NAME
start\-registry\-info\-set\-icon \- Set the registry icon
.SH SYNOPSIS
\fBstart\-registry info set\-icon\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIICON\fR>
.SH DESCRIPTION
Set the registry icon
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIICON\fR>
Path to service icon file

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-info-set-name 1 "set-name "
.SH NAME
start\-registry\-info\-set\-name \- Set the registry name
.SH SYNOPSIS
\fBstart\-registry info set\-name\fR [\fB\-h\fR|\fB\-\-help\fR] <\fINAME\fR>
.SH DESCRIPTION
Set the registry name
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fINAME\fR>
Name of the registry

View File

@@ -0,0 +1,23 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-info 1 "info "
.SH NAME
start\-registry\-info \- Display registry info
.SH SYNOPSIS
\fBstart\-registry info\fR [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIsubcommands\fR]
.SH DESCRIPTION
Display registry info
.SH OPTIONS
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-info\-set\-icon(1)
Set the registry icon
.TP
start\-registry\-info\-set\-name(1)
Set the registry name

View File

@@ -0,0 +1,25 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-asset-add 1 "add "
.SH NAME
start\-registry\-os\-asset\-add \- Add asset to registry
.SH SYNOPSIS
\fBstart\-registry os asset add\fR <\fB\-p\fR|\fB\-\-platform\fR> <\fB\-v\fR|\fB\-\-version\fR> [\fB\-h\fR|\fB\-\-help\fR] <\fIFILE\fR> <\fIURL\fR>
.SH DESCRIPTION
Add asset to registry
.SH OPTIONS
.TP
\fB\-p\fR, \fB\-\-platform\fR \fI<PLATFORM>\fR
Target platform identifier
.TP
\fB\-v\fR, \fB\-\-version\fR \fI<VERSION>\fR
StartOS version number
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIFILE\fR>
Path to the asset file
.TP
<\fIURL\fR>
URL of the asset

View File

@@ -0,0 +1,25 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-asset-get-img 1 "img "
.SH NAME
start\-registry\-os\-asset\-get\-img \- Download IMG file
.SH SYNOPSIS
\fBstart\-registry os asset get img\fR [\fB\-d\fR|\fB\-\-download\fR] [\fB\-r\fR|\fB\-\-reverify\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIVERSION\fR> <\fIPLATFORM\fR>
.SH DESCRIPTION
Download IMG file
.SH OPTIONS
.TP
\fB\-d\fR, \fB\-\-download\fR \fI<DOWNLOAD>\fR
Directory path to download to
.TP
\fB\-r\fR, \fB\-\-reverify\fR
Verify hash after download completes
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIVERSION\fR>
StartOS version number
.TP
<\fIPLATFORM\fR>
Target platform identifier

View File

@@ -0,0 +1,25 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-asset-get-iso 1 "iso "
.SH NAME
start\-registry\-os\-asset\-get\-iso \- Download ISO file
.SH SYNOPSIS
\fBstart\-registry os asset get iso\fR [\fB\-d\fR|\fB\-\-download\fR] [\fB\-r\fR|\fB\-\-reverify\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIVERSION\fR> <\fIPLATFORM\fR>
.SH DESCRIPTION
Download ISO file
.SH OPTIONS
.TP
\fB\-d\fR, \fB\-\-download\fR \fI<DOWNLOAD>\fR
Directory path to download to
.TP
\fB\-r\fR, \fB\-\-reverify\fR
Verify hash after download completes
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIVERSION\fR>
StartOS version number
.TP
<\fIPLATFORM\fR>
Target platform identifier

View File

@@ -0,0 +1,25 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-asset-get-squashfs 1 "squashfs "
.SH NAME
start\-registry\-os\-asset\-get\-squashfs \- Download squashfs file
.SH SYNOPSIS
\fBstart\-registry os asset get squashfs\fR [\fB\-d\fR|\fB\-\-download\fR] [\fB\-r\fR|\fB\-\-reverify\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIVERSION\fR> <\fIPLATFORM\fR>
.SH DESCRIPTION
Download squashfs file
.SH OPTIONS
.TP
\fB\-d\fR, \fB\-\-download\fR \fI<DOWNLOAD>\fR
Directory path to download to
.TP
\fB\-r\fR, \fB\-\-reverify\fR
Verify hash after download completes
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIVERSION\fR>
StartOS version number
.TP
<\fIPLATFORM\fR>
Target platform identifier

View File

@@ -0,0 +1,23 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-asset-get 1 "get "
.SH NAME
start\-registry\-os\-asset\-get \- Commands to download image, iso, or squashfs files
.SH SYNOPSIS
\fBstart\-registry os asset get\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Commands to download image, iso, or squashfs files
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-os\-asset\-get\-img(1)
Download IMG file
.TP
start\-registry\-os\-asset\-get\-iso(1)
Download ISO file
.TP
start\-registry\-os\-asset\-get\-squashfs(1)
Download squashfs file

View File

@@ -0,0 +1,12 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-asset-remove 1 "remove "
.SH NAME
start\-registry\-os\-asset\-remove
.SH SYNOPSIS
\fBstart\-registry os asset remove\fR [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,22 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-asset-sign 1 "sign "
.SH NAME
start\-registry\-os\-asset\-sign \- Sign file and add to registry
.SH SYNOPSIS
\fBstart\-registry os asset sign\fR <\fB\-p\fR|\fB\-\-platform\fR> <\fB\-v\fR|\fB\-\-version\fR> [\fB\-h\fR|\fB\-\-help\fR] <\fIFILE\fR>
.SH DESCRIPTION
Sign file and add to registry
.SH OPTIONS
.TP
\fB\-p\fR, \fB\-\-platform\fR \fI<PLATFORM>\fR
Target platform identifier
.TP
\fB\-v\fR, \fB\-\-version\fR \fI<VERSION>\fR
StartOS version number
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIFILE\fR>
Path to the asset file

View File

@@ -0,0 +1,25 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-asset 1 "asset "
.SH NAME
start\-registry\-os\-asset \- Commands to add, sign, or get registry assets
.SH SYNOPSIS
\fBstart\-registry os asset\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Commands to add, sign, or get registry assets
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-os\-asset\-add(1)
Add asset to registry
.TP
start\-registry\-os\-asset\-get(1)
Commands to download image, iso, or squashfs files
.TP
start\-registry\-os\-asset\-remove(1)
.TP
start\-registry\-os\-asset\-sign(1)
Sign file and add to registry

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-index 1 "index "
.SH NAME
start\-registry\-os\-index \- List OS versions index
.SH SYNOPSIS
\fBstart\-registry os index\fR [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
List OS versions index
.SH OPTIONS
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,25 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-version-add 1 "add "
.SH NAME
start\-registry\-os\-version\-add \- Add OS version
.SH SYNOPSIS
\fBstart\-registry os version add\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIVERSION\fR> <\fIHEADLINE\fR> <\fIRELEASE_NOTES\fR> <\fISOURCE_VERSION\fR>
.SH DESCRIPTION
Add OS version
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIVERSION\fR>
StartOS version number
.TP
<\fIHEADLINE\fR>
Short headline for the version
.TP
<\fIRELEASE_NOTES\fR>
Release notes for this version
.TP
<\fISOURCE_VERSION\fR>
Source version range for migration

View File

@@ -0,0 +1,28 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-version-get 1 "get "
.SH NAME
start\-registry\-os\-version\-get \- Get OS versions info
.SH SYNOPSIS
\fBstart\-registry os version get\fR [\fB\-\-src\fR] [\fB\-\-target\-version\fR] [\fB\-\-id\fR] [\fB\-\-platform\fR] [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
Get OS versions info
.SH OPTIONS
.TP
\fB\-\-src\fR \fI<SOURCE_VERSION>\fR
Source version to upgrade from
.TP
\fB\-\-target\-version\fR \fI<TARGET_VERSION>\fR
Target version range constraint
.TP
\fB\-\-id\fR \fI<SERVER_ID>\fR
Unique server identifier
.TP
\fB\-\-platform\fR \fI<PLATFORM>\fR
Target platform identifier
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-version-remove 1 "remove "
.SH NAME
start\-registry\-os\-version\-remove \- Remove OS version
.SH SYNOPSIS
\fBstart\-registry os version remove\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIVERSION\fR>
.SH DESCRIPTION
Remove OS version
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIVERSION\fR>
StartOS version number

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-version-signer-add 1 "add "
.SH NAME
start\-registry\-os\-version\-signer\-add \- Add version signer
.SH SYNOPSIS
\fBstart\-registry os version signer add\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIVERSION\fR> <\fISIGNER\fR>
.SH DESCRIPTION
Add version signer
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIVERSION\fR>
.TP
<\fISIGNER\fR>

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-version-signer-list 1 "list "
.SH NAME
start\-registry\-os\-version\-signer\-list \- List version signers
.SH SYNOPSIS
\fBstart\-registry os version signer list\fR [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIVERSION\fR>
.SH DESCRIPTION
List version signers
.SH OPTIONS
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIVERSION\fR>

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-version-signer-remove 1 "remove "
.SH NAME
start\-registry\-os\-version\-signer\-remove \- Remove version signer
.SH SYNOPSIS
\fBstart\-registry os version signer remove\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIVERSION\fR> <\fISIGNER\fR>
.SH DESCRIPTION
Remove version signer
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIVERSION\fR>
.TP
<\fISIGNER\fR>

View File

@@ -0,0 +1,23 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-version-signer 1 "signer "
.SH NAME
start\-registry\-os\-version\-signer \- Add, remove, and list version signers
.SH SYNOPSIS
\fBstart\-registry os version signer\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Add, remove, and list version signers
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-os\-version\-signer\-add(1)
Add version signer
.TP
start\-registry\-os\-version\-signer\-list(1)
List version signers
.TP
start\-registry\-os\-version\-signer\-remove(1)
Remove version signer

View File

@@ -0,0 +1,26 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os-version 1 "version "
.SH NAME
start\-registry\-os\-version \- Commands to add, remove, or list versions or version signers
.SH SYNOPSIS
\fBstart\-registry os version\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Commands to add, remove, or list versions or version signers
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-os\-version\-add(1)
Add OS version
.TP
start\-registry\-os\-version\-get(1)
Get OS versions info
.TP
start\-registry\-os\-version\-remove(1)
Remove OS version
.TP
start\-registry\-os\-version\-signer(1)
Add, remove, and list version signers

View File

@@ -0,0 +1,23 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-os 1 "os "
.SH NAME
start\-registry\-os \- Commands related to OS assets and versions
.SH SYNOPSIS
\fBstart\-registry os\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Commands related to OS assets and versions
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-os\-asset(1)
Commands to add, sign, or get registry assets
.TP
start\-registry\-os\-index(1)
List OS versions index
.TP
start\-registry\-os\-version(1)
Commands to add, remove, or list versions or version signers

View File

@@ -0,0 +1,22 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-add-mirror 1 "add-mirror "
.SH NAME
start\-registry\-package\-add\-mirror \- Add a mirror for an s9pk
.SH SYNOPSIS
\fBstart\-registry package add\-mirror\fR [\fB\-\-no\-verify\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIFILE\fR> <\fIURL\fR>
.SH DESCRIPTION
Add a mirror for an s9pk
.SH OPTIONS
.TP
\fB\-\-no\-verify\fR
Skip signature verification
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIFILE\fR>
Path to s9pk package file
.TP
<\fIURL\fR>
URL of the mirror

View File

@@ -0,0 +1,22 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-add 1 "add "
.SH NAME
start\-registry\-package\-add \- Add package to registry index
.SH SYNOPSIS
\fBstart\-registry package add\fR [\fB\-\-url\fR] [\fB\-\-no\-verify\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIFILE\fR>
.SH DESCRIPTION
Add package to registry index
.SH OPTIONS
.TP
\fB\-\-url\fR \fI<URL>\fR
URL of the package
.TP
\fB\-\-no\-verify\fR
Skip signature verification
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIFILE\fR>
Path to s9pk package file

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-category-add-package 1 "add-package "
.SH NAME
start\-registry\-package\-category\-add\-package \- Add a package to a category
.SH SYNOPSIS
\fBstart\-registry package category add\-package\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR> <\fIPACKAGE\fR>
.SH DESCRIPTION
Add a package to a category
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
.TP
<\fIPACKAGE\fR>

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-category-add 1 "add "
.SH NAME
start\-registry\-package\-category\-add \- Add a category to the registry
.SH SYNOPSIS
\fBstart\-registry package category add\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR> <\fINAME\fR>
.SH DESCRIPTION
Add a category to the registry
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
.TP
<\fINAME\fR>

View File

@@ -0,0 +1,15 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-category-list 1 "list "
.SH NAME
start\-registry\-package\-category\-list
.SH SYNOPSIS
\fBstart\-registry package category list\fR [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-category-remove-package 1 "remove-package "
.SH NAME
start\-registry\-package\-category\-remove\-package \- Remove package from category
.SH SYNOPSIS
\fBstart\-registry package category remove\-package\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR> <\fIPACKAGE\fR>
.SH DESCRIPTION
Remove package from category
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
.TP
<\fIPACKAGE\fR>

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-category-remove 1 "remove "
.SH NAME
start\-registry\-package\-category\-remove \- Remove category from registry
.SH SYNOPSIS
\fBstart\-registry package category remove\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR>
.SH DESCRIPTION
Remove category from registry
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>

View File

@@ -0,0 +1,28 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-category 1 "category "
.SH NAME
start\-registry\-package\-category \- Update categories in registry
.SH SYNOPSIS
\fBstart\-registry package category\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Update categories in registry
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-package\-category\-add(1)
Add a category to the registry
.TP
start\-registry\-package\-category\-add\-package(1)
Add a package to a category
.TP
start\-registry\-package\-category\-list(1)
.TP
start\-registry\-package\-category\-remove(1)
Remove category from registry
.TP
start\-registry\-package\-category\-remove\-package(1)
Remove package from category

View File

@@ -0,0 +1,22 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-download 1 "download "
.SH NAME
start\-registry\-package\-download \- Download s9pk package
.SH SYNOPSIS
\fBstart\-registry package download\fR [\fB\-v\fR|\fB\-\-target\-version\fR] [\fB\-d\fR|\fB\-\-dest\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR>
.SH DESCRIPTION
Download s9pk package
.SH OPTIONS
.TP
\fB\-v\fR, \fB\-\-target\-version\fR \fI<TARGET_VERSION>\fR
Target version range constraint
.TP
\fB\-d\fR, \fB\-\-dest\fR \fI<DEST>\fR
Destination path for download
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
Package identifier

View File

@@ -0,0 +1,40 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-get 1 "get "
.SH NAME
start\-registry\-package\-get \- List installation candidates
.SH SYNOPSIS
\fBstart\-registry package get\fR [\fB\-v\fR|\fB\-\-target\-version\fR] [\fB\-\-source\-version\fR] [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIID\fR] [\fIOTHER_VERSIONS\fR]
.SH DESCRIPTION
List installation candidates
.SH OPTIONS
.TP
\fB\-v\fR, \fB\-\-target\-version\fR \fI<TARGET_VERSION>\fR
Target version range constraint
.TP
\fB\-\-source\-version\fR \fI<SOURCE_VERSION>\fR
Source version to upgrade from
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
[\fIID\fR]
Package identifier
.TP
[\fIOTHER_VERSIONS\fR] [default: none]
Detail level for other versions
.br
.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
none
.IP \(bu 2
short
.IP \(bu 2
full
.RE

View File

@@ -0,0 +1,16 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-index 1 "index "
.SH NAME
start\-registry\-package\-index \- List packages and categories
.SH SYNOPSIS
\fBstart\-registry package index\fR [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH DESCRIPTION
List packages and categories
.SH OPTIONS
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help

View File

@@ -0,0 +1,22 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-remove-mirror 1 "remove-mirror "
.SH NAME
start\-registry\-package\-remove\-mirror \- Remove mirror package
.SH SYNOPSIS
\fBstart\-registry package remove\-mirror\fR <\fB\-\-url\fR> [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR> <\fIVERSION\fR>
.SH DESCRIPTION
Remove mirror package
.SH OPTIONS
.TP
\fB\-\-url\fR \fI<URL>\fR
URL of the mirror
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
Package identifier
.TP
<\fIVERSION\fR>
Package version

View File

@@ -0,0 +1,22 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-remove 1 "remove "
.SH NAME
start\-registry\-package\-remove \- Remove package from registry
.SH SYNOPSIS
\fBstart\-registry package remove\fR [\fB\-\-sighash\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR> <\fIVERSION\fR>
.SH DESCRIPTION
Remove package from registry
.SH OPTIONS
.TP
\fB\-\-sighash\fR \fI<SIGHASH>\fR
Hash for signature verification
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
Package identifier
.TP
<\fIVERSION\fR>
Package version

View File

@@ -0,0 +1,25 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-signer-add 1 "add "
.SH NAME
start\-registry\-package\-signer\-add \- Add package signer
.SH SYNOPSIS
\fBstart\-registry package signer add\fR [\fB\-\-versions\fR] [\fB\-\-merge\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR> <\fISIGNER\fR>
.SH DESCRIPTION
Add package signer
.SH OPTIONS
.TP
\fB\-\-versions\fR \fI<VERSIONS>\fR
Version range constraint
.TP
\fB\-\-merge\fR
Merge with existing version range instead of replacing
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
Package identifier
.TP
<\fISIGNER\fR>
Signer identifier

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-signer-list 1 "list "
.SH NAME
start\-registry\-package\-signer\-list \- List package signers
.SH SYNOPSIS
\fBstart\-registry package signer list\fR [\fB\-\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR>
.SH DESCRIPTION
List package signers
.SH OPTIONS
.TP
\fB\-\-format\fR
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
Package identifier

View File

@@ -0,0 +1,19 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-signer-remove 1 "remove "
.SH NAME
start\-registry\-package\-signer\-remove \- Remove package signer
.SH SYNOPSIS
\fBstart\-registry package signer remove\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIID\fR> <\fISIGNER\fR>
.SH DESCRIPTION
Remove package signer
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
<\fIID\fR>
Package identifier
.TP
<\fISIGNER\fR>
Signer identifier

View File

@@ -0,0 +1,23 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package-signer 1 "signer "
.SH NAME
start\-registry\-package\-signer \- Add, remove, and list package signers
.SH SYNOPSIS
\fBstart\-registry package signer\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Add, remove, and list package signers
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-package\-signer\-add(1)
Add package signer
.TP
start\-registry\-package\-signer\-list(1)
List package signers
.TP
start\-registry\-package\-signer\-remove(1)
Remove package signer

View File

@@ -0,0 +1,41 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry-package 1 "package "
.SH NAME
start\-registry\-package \- Commands to index, add, or get packages
.SH SYNOPSIS
\fBstart\-registry package\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
.SH DESCRIPTION
Commands to index, add, or get packages
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.SH SUBCOMMANDS
.TP
start\-registry\-package\-add(1)
Add package to registry index
.TP
start\-registry\-package\-add\-mirror(1)
Add a mirror for an s9pk
.TP
start\-registry\-package\-category(1)
Update categories in registry
.TP
start\-registry\-package\-download(1)
Download s9pk package
.TP
start\-registry\-package\-get(1)
List installation candidates
.TP
start\-registry\-package\-index(1)
List packages and categories
.TP
start\-registry\-package\-remove(1)
Remove package from registry
.TP
start\-registry\-package\-remove\-mirror(1)
Remove mirror package
.TP
start\-registry\-package\-signer(1)
Add, remove, and list package signers

View File

@@ -0,0 +1,66 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH start-registry 1 "start-registry 0.4.0-alpha.21"
.SH NAME
start\-registry
.SH SYNOPSIS
\fBstart\-registry\fR [\fB\-c\fR|\fB\-\-config\fR] [\fB\-H\fR|\fB\-\-host\fR] [\fB\-r\fR|\fB\-\-registry\fR] [\fB\-\-registry\-hostname\fR] [\fB\-\-s9pk\-s3base\fR] [\fB\-\-s9pk\-s3bucket\fR] [\fB\-t\fR|\fB\-\-tunnel\fR] [\fB\-p\fR|\fB\-\-proxy\fR] [\fB\-\-cookie\-path\fR] [\fB\-\-developer\-key\-path\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIsubcommands\fR]
.SH DESCRIPTION
.SH OPTIONS
.TP
\fB\-c\fR, \fB\-\-config\fR \fI<CONFIG>\fR
Path to configuration file
.TP
\fB\-H\fR, \fB\-\-host\fR \fI<HOST>\fR
URL of the StartOS server
.TP
\fB\-r\fR, \fB\-\-registry\fR \fI<REGISTRY>\fR
URL of the registry
.TP
\fB\-\-registry\-hostname\fR \fI<REGISTRY_HOSTNAME>\fR
Registry server hostname
.TP
\fB\-\-s9pk\-s3base\fR \fI<S9PK_S3BASE>\fR
Base URL for publishing s9pks
.TP
\fB\-\-s9pk\-s3bucket\fR \fI<S9PK_S3BUCKET>\fR
S3 bucket to publish s9pks to (should correspond to s3base)
.TP
\fB\-t\fR, \fB\-\-tunnel\fR \fI<TUNNEL>\fR
Tunnel server address
.TP
\fB\-p\fR, \fB\-\-proxy\fR \fI<PROXY>\fR
HTTP/SOCKS proxy URL
.TP
\fB\-\-cookie\-path\fR \fI<COOKIE_PATH>\fR
Path to cookie file
.TP
\fB\-\-developer\-key\-path\fR \fI<DEVELOPER_KEY_PATH>\fR
Path to developer signing key
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version
.SH SUBCOMMANDS
.TP
start\-registry\-admin(1)
Commands to add or list admins or signers
.TP
start\-registry\-db(1)
Commands to interact with the db i.e. dump and apply
.TP
start\-registry\-index(1)
List registry info and packages
.TP
start\-registry\-info(1)
Display registry info
.TP
start\-registry\-os(1)
Commands related to OS assets and versions
.TP
start\-registry\-package(1)
Commands to index, add, or get packages
.SH VERSION
v0.4.0\-alpha.21