| title | section | header | footer | date |
|---|---|---|---|---|
KT-UPDATE |
8 |
User Manual |
kt-update |
November 2020 |
kt-update - lightweight distribution management.
kt [OPTIONS...] ACTIONS [OPTIONS...] ... [+= PACKAGES...] [-= PACKAGES...]
kt-update [OPTIONS...] ACTIONS [OPTIONS...] ... [+= PACKAGES...] [-= PACKAGES...]
kt is shortest to write. Beside this, both are the same thing.
kt-update wraps apt-get to keep your distribution in a given configuration (an apt source.list containing extensions to list required packages), which may be managed remotely.
It is configurable through files *.conf in /etc/kt-update/conf.d/. Though, the 2 main parameters KT_SERVER_URI and IDENTIFIER are configurable through the saveconf action (cf. /etc/kt-update/conf.d/90user.conf).
-S URI, --ktserver URI : kt server to use to get a distribution configuration
-I ID, --identifier ID : Identifier to get a distribution configuration from kt server
-l, --listids : if kt server provide a list of configuration identifiers, show it and exit
-p, --printconf : print all configurable values and exit
-h, --help : print help and exit
-V, --version : show version and exit
getconf, auth : get a distribution configuration (extended apt sources.list)
check : check packages configuration and packages status
checknfix : check packages conf and status, and try repair if NOK
clean : auto remove obsolete packages and purge downloaded *.deb files
download : only download needed packages (deprecated, use -d option)
printconf : print all configurable values (same as -p option)
saveconf : save given identifier (-I) or ktserver (-S) in configurable values
switch : equivalent to: getconf update saveconf clean upgrade checknfix --force-version --force-integrity clean
up : equivalent to: update upgrade
update : check for packages updates
upgrade, dist-upgrade : install needed packages
+=, install PACKAGES... : install extra packages (if no conflict with distro configuration)
-=, purge PACKAGES... : purge packages (if possible by your distro configuration)
-fv, --force-version : Force error if monitored packages installed and candidate versions differ (as 'v' flag in 'kt:check' directive)
-fi, --force-integrity : Force error if files of monitored packages (except conf files) differs from expected (as 'i' flag in 'kt:check' directive)
-fI, --all-integrity : Force error if files of any installed packages (except conf files) differs from expected (as 'I' flag in 'kt:check' directive)
-df, --disable-flags : Ignore any flags in sources.list 'kt:check' directive
-m, --media PATH : update from a path (eg: mounted ISO) in addition to other sources
-n, --no-ktsource : remove apt source list given by getconf action
-s, --simulate : No-act. Perform ordering simulation
-d, --download-only : Download only ; packages are only retrieved, not unpacked or installed
-a, --ask : interactive mode to set and save main configurable values
-B, --big : remove also all packages not required by your configuration (eg: those set as manually installed)
/etc/apt/sources.list.d/kt-media.list, /etc/apt/sources.list.d/kt-remote.list : apt source lists managed by kt-update
/etc/kt-update/conf.d/*.conf : The configuration files. The variables you can set there are also documented in the configuration example
/var/lib/kt-update/ : kt-update's homedir
*/var/log/kt-update/* * : kt-update's logs
Except PREFIX, following environment variables are read from the configuration files, and should be overwritten by them
cf. also the configuration example /usr/share/doc/kt-update/example.conf
PREFIX : For testing purpose, used also on some special environments (Termux on Android)
KT_SERVER_URI : kt-update configuration server to use
IDENTIFIER : configuration identifier, to get specific apt sources.list with some kt-update's extensions
KT_GETCONF_PERIOD : number of days to auto-run periodically a "getconf" action in the beginning of "update" action
WGET_OPTIONS : options passed to Wget when kt-update uses it
APT_OPTIONS : options passed to apt-get when kt-update uses it
DEBIAN_FRONTEND : user interface for the package manager. As kt-update aims to ease system upgrade, default value is "noninteractive"
ACTION_DIFF_*, ACTION_FILTER_*, ACTION_FAIL_*, **ACTION_SUCCESS_* ** : For each action in "getconf check fix checknfix update download upgrade clean install purge", you may specify a filter or what to do if action fail or success
Example: ACTION_DIFF_update='my_sending_mail_script $PREVIOUS_ACTION_LOG $CURRENT_ACTION_LOG'
Note: The command you will specify have a read-only access to all kt-update's environment variables
returns zero on normal operation, non-zero on errors.
sudo kt up : upgrade your distribution
sudo kt checknfix : Check and possibly fix your distribution (eg: power cut during upgrade)
sudo kt -I testing-games -B switch : change your configuration to the one identified as "testing-games", removing all packages not specified by this configuration
sudo kt += vim -= emacs : install vim, purge emacs (if possible by your configuration)
tasksel, cron-apt, wget, apt-get
Jean-Jacques Brucker [email protected]
SuperSonic Imagine did also develop but unreleased kt-notify, which parse kt-update, or apt-get and display notifications (with progress bar) through libnotify. It support modules to send, maybe in the futur, notifications through dbus or email, etc.