Initial commit: apt-ostree project with 100% rpm-ostree CLI compatibility
This commit is contained in:
robojerk
commit
a48ad95d70
81 changed files with 28515 additions and 0 deletions
493
.notes/rpm-ostree/cli-help.txt
Normal file
493
.notes/rpm-ostree/cli-help.txt
Normal file
|
|
@ -0,0 +1,493 @@
|
|||
$ rpm-ostree --help
|
||||
Usage:
|
||||
rpm-ostree [OPTION…] COMMAND
|
||||
|
||||
Builtin Commands:
|
||||
apply-live Apply pending deployment changes to booted deployment
|
||||
cancel Cancel an active transaction
|
||||
cleanup Clear cached/pending data
|
||||
compose Commands to compose a tree
|
||||
db Commands to query the RPM database
|
||||
deploy Deploy a specific commit
|
||||
initramfs Enable or disable local initramfs regeneration
|
||||
initramfs-etc Add files to the initramfs
|
||||
install Overlay additional packages
|
||||
kargs Query or modify kernel arguments
|
||||
override Manage base package overrides
|
||||
rebase Switch to a different tree
|
||||
refresh-md Generate rpm repo metadata
|
||||
reload Reload configuration
|
||||
reset Remove all mutations
|
||||
rollback Revert to the previously booted tree
|
||||
search Search for packages
|
||||
status Get the version of the booted system
|
||||
uninstall Remove overlayed additional packages
|
||||
upgrade Perform a system upgrade
|
||||
usroverlay Apply a transient overlayfs to /usr
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
|
||||
$ rpm-ostree apply-live --help
|
||||
Usage: rpm-ostree [OPTIONS]
|
||||
|
||||
Options:
|
||||
--target <TARGET> Target provided commit instead of pending deployment
|
||||
--reset Reset back to booted commit
|
||||
--allow-replacement Allow replacement of packages/files (default is pure additive)
|
||||
-h, --help Print help
|
||||
$ rpm-ostree cancel --help
|
||||
Usage:
|
||||
rpm-ostree cancel [OPTION…]
|
||||
|
||||
Cancel an active transaction
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree cleanup --help
|
||||
Usage:
|
||||
rpm-ostree cleanup [OPTION…]
|
||||
|
||||
Clear cached/pending data
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
-b, --base Clear temporary files; will leave deployments unchanged
|
||||
-p, --pending Remove pending deployment
|
||||
-r, --rollback Remove rollback deployment
|
||||
-m, --repomd Delete cached rpm repo metadata
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree compose --help
|
||||
Usage:
|
||||
rpm-ostree compose [OPTION…] COMMAND
|
||||
|
||||
Commands to compose a tree
|
||||
|
||||
Builtin "compose" Commands:
|
||||
build-chunked-oci Generate a "chunked" OCI archive from an input rootfs
|
||||
commit Commit a target path to an OSTree repository
|
||||
container-encapsulate Generate a reproducible "chunked" container image (using RPM data) from an OSTree commit
|
||||
extensions Download RPM packages guaranteed to depsolve with a base OSTree
|
||||
image Generate a reproducible "chunked" container image (using RPM data) from a treefile
|
||||
install Install packages into a target path
|
||||
postprocess Perform final postprocessing on an installation root
|
||||
rootfs Generate a root filesystem tree from a treefile
|
||||
tree Process a "treefile"; install packages and commit the result to an OSTree repository
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree db --help
|
||||
Usage:
|
||||
rpm-ostree db [OPTION…] COMMAND
|
||||
|
||||
Commands to query the RPM database
|
||||
|
||||
Builtin "db" Commands:
|
||||
diff Show package changes between two commits
|
||||
list List packages within commits
|
||||
version Show rpmdb version of packages within the commits
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree deploy --help
|
||||
Usage:
|
||||
rpm-ostree deploy [OPTION…] REVISION
|
||||
|
||||
Deploy a specific commit
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
-r, --reboot Initiate a reboot after operation is complete
|
||||
--preview Just preview package differences
|
||||
-C, --cache-only Do not download latest ostree and RPM data
|
||||
--download-only Just download latest ostree and RPM data, don't deploy
|
||||
--skip-branch-check Do not check if commit belongs on the same branch
|
||||
--disallow-downgrade Forbid deployment of chronologically older trees
|
||||
--unchanged-exit-77 If no new deployment made, exit 77
|
||||
--register-driver=DRIVERNAME Register the calling agent as the driver for updates; if REVISION is an empty string, register driver without deploying
|
||||
--bypass-driver Force a deploy even if an updates driver is registered
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--install=PKG Overlay additional package
|
||||
--uninstall=PKG Remove overlayed additional package
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree initramfs --help
|
||||
Usage:
|
||||
rpm-ostree initramfs [OPTION…]
|
||||
|
||||
Enable or disable local initramfs regeneration
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
--enable Enable regenerating initramfs locally using dracut
|
||||
--arg=ARG Append ARG to the dracut arguments
|
||||
--disable Disable regenerating initramfs locally
|
||||
-r, --reboot Initiate a reboot after operation is complete
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree initramfs-etc --help
|
||||
Usage:
|
||||
rpm-ostree initramfs-etc [OPTION…]
|
||||
|
||||
Add files to the initramfs
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
--force-sync Deploy a new tree with the latest tracked /etc files
|
||||
--track=FILE Track root /etc file
|
||||
--untrack=FILE Untrack root /etc file
|
||||
--untrack-all Untrack all root /etc files
|
||||
-r, --reboot Initiate a reboot after operation is complete
|
||||
--unchanged-exit-77 If no new deployment made, exit 77
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree install --help
|
||||
Usage:
|
||||
rpm-ostree install [OPTION…] PACKAGE [PACKAGE...]
|
||||
|
||||
Overlay additional packages
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--uninstall=PKG Remove overlayed additional package
|
||||
-C, --cache-only Do not download latest ostree and RPM data
|
||||
--download-only Just download latest ostree and RPM data, don't deploy
|
||||
-A, --apply-live Apply changes to both pending deployment and running filesystem tree
|
||||
--force-replacefiles Allow package to replace files from other packages
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
-r, --reboot Initiate a reboot after operation is complete
|
||||
-n, --dry-run Exit after printing the transaction
|
||||
-y, --assumeyes Auto-confirm interactive prompts for non-security questions
|
||||
--allow-inactive Allow inactive package requests
|
||||
--idempotent Do nothing if package already (un)installed
|
||||
--unchanged-exit-77 If no overlays were changed, exit 77
|
||||
--enablerepo Enable the repository based on the repo id. Is only supported in a container build.
|
||||
--disablerepo Only disabling all (*) repositories is supported currently. Is only supported in a container build.
|
||||
--releasever Set the releasever. Is only supported in a container build.
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree kargs --help
|
||||
Usage:
|
||||
rpm-ostree kargs [OPTION…]
|
||||
|
||||
Query or modify kernel arguments
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
--deploy-index=INDEX Modify the kernel args from a specific deployment based on index. Index is in the form of a number (e.g. 0 means the first deployment in the list)
|
||||
--reboot Initiate a reboot after operation is complete
|
||||
--append=KEY=VALUE Append kernel argument; useful with e.g. console= that can be used multiple times. empty value for an argument is allowed
|
||||
--replace=KEY=VALUE=NEWVALUE Replace existing kernel argument, the user is also able to replace an argument with KEY=VALUE if only one value exist for that argument
|
||||
--delete=KEY=VALUE Delete a specific kernel argument key/val pair or an entire argument with a single key/value pair
|
||||
--append-if-missing=KEY=VALUE Like --append, but does nothing if the key is already present
|
||||
--delete-if-present=KEY=VALUE Like --delete, but does nothing if the key is already missing
|
||||
--unchanged-exit-77 If no kernel args changed, exit 77
|
||||
--import-proc-cmdline Instead of modifying old kernel arguments, we modify args from current /proc/cmdline (the booted deployment)
|
||||
--editor Use an editor to modify the kernel arguments
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree override --help
|
||||
Usage:
|
||||
rpm-ostree override [OPTION…] COMMAND
|
||||
|
||||
Manage base package overrides
|
||||
|
||||
Builtin "override" Commands:
|
||||
remove Remove packages from the base layer
|
||||
replace Replace packages in the base layer
|
||||
reset Reset currently active package overrides
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree rebase --help
|
||||
Usage:
|
||||
rpm-ostree rebase [OPTION…] REFSPEC [REVISION]
|
||||
|
||||
Switch to a different tree
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
-b, --branch=BRANCH Rebase to branch BRANCH; use --remote to change remote as well
|
||||
-m, --remote=REMOTE Rebase to current branch name using REMOTE; may also be combined with --branch
|
||||
-r, --reboot Initiate a reboot after operation is complete
|
||||
--skip-purge Keep previous refspec after rebase
|
||||
-C, --cache-only Do not download latest ostree and RPM data
|
||||
--download-only Just download latest ostree and RPM data, don't deploy
|
||||
--custom-origin-description Human-readable description of custom origin
|
||||
--custom-origin-url Machine-readable description of custom origin
|
||||
--experimental Enable experimental features
|
||||
--disallow-downgrade Forbid deployment of chronologically older trees
|
||||
--bypass-driver Force a rebase even if an updates driver is registered
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--install=PKG Overlay additional package
|
||||
--uninstall=PKG Remove overlayed additional package
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree refresh-md --help
|
||||
Usage:
|
||||
rpm-ostree refresh-md [OPTION…]
|
||||
|
||||
Generate rpm repo metadata
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
-f, --force Expire current cache
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree reload --help
|
||||
Usage:
|
||||
rpm-ostree reload [OPTION…]
|
||||
|
||||
Reload configuration
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree reset --help
|
||||
Usage:
|
||||
rpm-ostree reset [OPTION…]
|
||||
|
||||
Remove all mutations
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
-r, --reboot Initiate a reboot after transaction is complete
|
||||
-l, --overlays Remove all overlayed packages
|
||||
-o, --overrides Remove all overrides
|
||||
-i, --initramfs Stop regenerating initramfs or tracking files
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--install=PKG Overlay additional package
|
||||
--uninstall=PKG Remove overlayed additional package
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree rollback --help
|
||||
Usage:
|
||||
rpm-ostree rollback [OPTION…]
|
||||
|
||||
Revert to the previously booted tree
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
-r, --reboot Initiate a reboot after operation is complete
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree search --help
|
||||
Usage:
|
||||
rpm-ostree search [OPTION…] PACKAGE [PACKAGE...]
|
||||
|
||||
Search for packages
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--uninstall=PKG Remove overlayed additional package
|
||||
-C, --cache-only Do not download latest ostree and RPM data
|
||||
--download-only Just download latest ostree and RPM data, don't deploy
|
||||
-A, --apply-live Apply changes to both pending deployment and running filesystem tree
|
||||
--force-replacefiles Allow package to replace files from other packages
|
||||
--install=PKG Overlay additional package
|
||||
--all Remove all overlayed additional packages
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
-r, --reboot Initiate a reboot after operation is complete
|
||||
-n, --dry-run Exit after printing the transaction
|
||||
-y, --assumeyes Auto-confirm interactive prompts for non-security questions
|
||||
--allow-inactive Allow inactive package requests
|
||||
--idempotent Do nothing if package already (un)installed
|
||||
--unchanged-exit-77 If no overlays were changed, exit 77
|
||||
--enablerepo Enable the repository based on the repo id. Is only supported in a container build.
|
||||
--disablerepo Only disabling all (*) repositories is supported currently. Is only supported in a container build.
|
||||
--releasever Set the releasever. Is only supported in a container build.
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree status --help
|
||||
Usage:
|
||||
rpm-ostree status [OPTION…]
|
||||
|
||||
Get the version of the booted system
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
-v, --verbose Print additional fields (e.g. StateRoot); implies -a
|
||||
-a, --advisories Expand advisories listing
|
||||
--json Output JSON
|
||||
-J, --jsonpath=EXPRESSION Filter JSONPath expression
|
||||
-b, --booted Only print the booted deployment
|
||||
--pending-exit-77 If pending deployment available, exit 77
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree uninstall --help
|
||||
Usage:
|
||||
rpm-ostree uninstall [OPTION…] PACKAGE [PACKAGE...]
|
||||
|
||||
Remove overlayed additional packages
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--install=PKG Overlay additional package
|
||||
--all Remove all overlayed additional packages
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
-r, --reboot Initiate a reboot after operation is complete
|
||||
-n, --dry-run Exit after printing the transaction
|
||||
-y, --assumeyes Auto-confirm interactive prompts for non-security questions
|
||||
--allow-inactive Allow inactive package requests
|
||||
--idempotent Do nothing if package already (un)installed
|
||||
--unchanged-exit-77 If no overlays were changed, exit 77
|
||||
--enablerepo Enable the repository based on the repo id. Is only supported in a container build.
|
||||
--disablerepo Only disabling all (*) repositories is supported currently. Is only supported in a container build.
|
||||
--releasever Set the releasever. Is only supported in a container build.
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree upgrade --help
|
||||
Usage:
|
||||
rpm-ostree upgrade [OPTION…]
|
||||
|
||||
Perform a system upgrade
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--stateroot=STATEROOT Operate on provided STATEROOT
|
||||
-r, --reboot Initiate a reboot after operation is complete
|
||||
--allow-downgrade Permit deployment of chronologically older trees
|
||||
--preview Just preview package differences (implies --unchanged-exit-77)
|
||||
--check Just check if an upgrade is available (implies --unchanged-exit-77)
|
||||
-C, --cache-only Do not download latest ostree and RPM data
|
||||
--download-only Just download latest ostree and RPM data, don't deploy
|
||||
--unchanged-exit-77 If no new deployment made, exit 77
|
||||
--bypass-driver Force an upgrade even if an updates driver is registered
|
||||
--sysroot=SYSROOT Use system root SYSROOT (default: /)
|
||||
--peer Force a peer-to-peer connection instead of using the system message bus
|
||||
--install=PKG Overlay additional package
|
||||
--uninstall=PKG Remove overlayed additional package
|
||||
--version Print version information and exit
|
||||
-q, --quiet Avoid printing most informational messages
|
||||
|
||||
$ rpm-ostree usroverlay --help
|
||||
Usage:
|
||||
ostree admin unlock [OPTION…]
|
||||
|
||||
Make the current deployment mutable (as a hotfix or development)
|
||||
|
||||
Help Options:
|
||||
-h, --help Show help options
|
||||
|
||||
Application Options:
|
||||
--sysroot=PATH Create a new OSTree sysroot at PATH
|
||||
--hotfix Retain changes across reboots
|
||||
--transient Mount overlayfs read-only by default
|
||||
-v, --verbose Print debug information during command processing
|
||||
--version Print version information and exit
|
||||
|
||||
$ rpm-ostree --version
|
||||
rpm-ostree:
|
||||
Version: '2025.8'
|
||||
Git: 966eee9be1b9d89aaccef2c6a1eadcdb40494542
|
||||
Features:
|
||||
- rust
|
||||
- compose
|
||||
- container
|
||||
- fedora-integration
|
||||
Loading…
Add table
Add a link
Reference in a new issue