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:- Synchronizing the distribution's repositories
- If any modifications found at the previous step, running
egencacheandeix-update - Updating the revision and rewriting the world file
- Updating the packages
- Updating Python/Perl; if broken packages are detected, all of them will be recompiled
- Deleting orphaned packages
- Recompiling kernel modules if needed
- Recompiling other affected packages if any
- Recompiling Xorg-related packages (if needed)
- 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.