4.7 CL-Update

cl-update, as its name suggests, is the system update tool for Calculate Linux, that allows you to handle the whole update procedure.

The script

Our update protocol includes, as follows:
  1. Synchronizing the distribution's repositories
  2. If any modifications found at the previous step, running egencache and eix-update
  3. Updating the revision and rewriting the world file
  4. Updating the packages
  5. Updating Python/Perl; if broken packages are detected, all of them will be recompiled
  6. Deleting orphaned packages
  7. Recompiling kernel modules if needed
  8. Recompiling other affected packages if any
  9. Recompiling Xorg-related packages (if needed)
  10. Running dispatch-conf

Options

When you launch cl-update without options, the default behaviour will be applied, but you can modify it as well, as explained below.

Sync & cache options

-r REPOSITORIES, --repositories REPOSITORIES

Specify the repositories that will be synchronized, 'all' by default (type 'list' to show all available values). This option is useful if you need to sync one repository only.

--branch BRANCHES

Specify the repository branch (the syntax is REPOSITORY:BRANCH). You can choose between master/develop/update branches.

--force-egencache

Force the overlay cache update.

--skip-egencache

Skip the overlay cache update.

--auto-egencache

Update the overlay cache if obsolete (default).

--force-eix-update

Force cache update for the eix database.

--skip-eix-update

Skip eix cache update for the eix database.

--auto-eix-update

Update the eix cache if obsolete (default).

-o [ON/OFF], --update-other [ON/OFF]

Update outside (non Calculate) repositories. Disabled by default. To modify this behaviour, edit the value assigned to cl_update_other_set in the 'update' section. Use the following command to set the flag on:
cl-core-variables --set update.cl_update_other_set=on

-s [ON/OFF], --sync-only [ON/OFF]

Do not update packages, only synchronize and manage revisions.

Templates & revisions options

--rebuild-world [ON/OFF]

Rewrite the 'world' file according to the default templates for the given profile.

--update-rev [ON/OFF]

Update the revision number up to the one effective in templates.

-T TEMPLATES, --templates TEMPLATES

Choose a location for calculate,distros,local,remote,clt templates (use 'list' to show all available values)

--usenew-conf

Use new configuration files.

--skip-conf

Skip the configuration files update.

--dispatch-conf

Update the configuration files manually (this is the default behaviour).

Other options

-p [ON/OFF], --pretend [ON/OFF]

Do not update anything, only list the packages to be installed.

--wait-another-update [ON/OFF]

Wait for another cl-update action to be completed. Disabled by default.

--schedule [ON/OFF]

Consider the updates schedule: no update will be performed when this option is set on, unless the update interval is reached.

-v [ON/OFF], --verbose [ON/OFF]

Enable verbose output.

-f, --force

Run the tool silently.

Thank you!