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


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


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 the overlay cache update.


Skip the overlay cache update.


Update the overlay cache if obsolete (default).


Force cache update for the eix database.


Skip eix cache update for the eix database.


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.


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


Use new configuration files.


Skip the configuration files update.


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!