owut 命令

常用示例

说明

owut (OpenWrt Upgrade Tool) is a command-line utility that upgrades OpenWrt router firmware by creating custom images through the Attended Sysupgrade (ASU) server. It builds personalized firmware images that retain all currently installed packages and configuration, then downloads, verifies, and installs them. The tool communicates with the ASU server to request a build matching the device's current package set, optionally adding or removing packages. It handles the entire upgrade workflow: collecting device information, requesting a build, monitoring progress, downloading the image, verifying its integrity, and performing the sysupgrade.

参数

-V _version_, --version-to _version_

Specify the target version. Defaults to the currently installed version.

-R _code_, --rev-code _code_

Specify a version code. Literal none is allowed. Defaults to latest build.

-a _package_, --add _package_

Add a new package to the build list. Can be repeated.

-r _package_, --remove _package_

Remove an installed package from the build list. Can be repeated.

-i _path_, --image _path_

Image file path for download, verify, install and upgrade. Defaults to /tmp/firmware.bin.

-I _path_, --init-script _path_

Path to a uci-defaults script to run on first boot. Use - to read from stdin.

-F _type_, --fstype _type_

Desired root file system type: squashfs, ext4, ubifs, or jffs2.

-S _size_, --rootfs-size _size_

Root file system size in MB. Use with caution.

-p _script_, --pre-install _script_

Script to execute just prior to launching the final sysupgrade.

-f _format_, --format _format_

Format for list output: fs-user, fs-all, or config.

-k, --keep

Save all downloaded working files.

--force

Force a build even when there are downgrades or no changes.

--clean-slate

Remove all but default packages from the build.

-v, --verbose

Print various diagnostics. Repeat for more output.

-q, --quiet

Reduce verbosity. Repeat for total silence.

-h, --help

Display help information.

--version

Display version information.