NAME

cheribsd-update — fetch and install binary updates to CheriBSD

SYNOPSIS

DESCRIPTION

The cheribsd-update tool is used to fetch and install binary updates to the CheriBSD base system.

Although the author has taken every effort to handle errors and corner cases, bugs may exist and users of this tool should back up their system to avoid possible data loss.

OPTIONS

The following options are supported:

-D destdir

Update the system installed to destdir rather than the current system.

-h

Print usage and exit.

COMMANDS

update [-y] [-a arch] current new

Update from CheriBSD version current to new. These can be released CheriBSD versions, such as 24.05, a branch snapshot in the form branch@version, such as main@2024-07-19, or a path or URL to an FTP distribution area.

Pass -y to run without prompting for confirmation.

Pass -a arch to specify the architecture if it differs from the host. This can be of the form machine (if machine and machine_arch are the same), machine/machine_arch or machine.machine_arch. For example, use amd64 for 64-bit Intel/AMD or arm64.aarch64c for Morello.

resume

Resume an in-progress update, such as after rebooting when prompted to use an updated kernel.

abort [-f]

Abort an in-progress update.

Pass -f to abort even when it cannot be done cleanly. This option should be used with care as it will leave the system in an inconsistent state.

AUTHORS

Jessica Clarke