UPGRADEPKG

NAME

upgradepkg − upgrade and install new Slackware and Tukaani compatible packages.

SYNOPSIS

upgradepkg [--warn] [--install-new] [--reinstall] [--quiet] [−−root /otherroot] newpackagename [newpackagename2]

upgradepkg [--warn] [--install-new] [--reinstall] [--quiet] [−−root /otherroot] oldpackagename%newpackagename [old2%new2]

DESCRIPTION

upgradepkg upgrades a Slackware/Tukaani package from an older version to a newer one. It does this by INSTALLING the new package onto the system, and then REMOVING any files from the old package that aren’t in the new package. If the old and new packages have the same basename, a single argument is all that is required. If the packages have different basenames, supply the name of the old package followed by a percent symbol (%), then the name of the new package. Do not add any extra whitespace between pairs of old/new package names.

If upgradepkg finds more than one installed package matching the old package’s basename, it will remove them all.

OPTIONS

-w, −−warn, --dry-run

Output a report about which packages would be installed or upgraded but don’t actually perform the upgrades.

-i, −−install−new

Normally upgradepkg only upgrades packages that are already installed on the system, and will skip any packages that do not already have a version installed. If −−install−new is specified, the behavior is modified to install new packages in addition to upgrading existing ones.

-r, −−reinstall

Upgradepkg usually skips packages if the exact same package (matching name, version, arch, and build number) is already installed on the system. Use the --reinstall option if you want to upgrade all packages even if the same version is already installed.

−g, −−gpg

Force the verification of GPG signatures overriding the options set in the configuration file. Only packages that have been signed with a known valid key are installed. The signature files have .asc extension e.g. signature file of foo-0.12-i486-1barney.tgz is foo-0.12-i486-1barney.tgz.asc.

−G, −−no-gpg

Forcibly disable the verfication of GPG signatures overriding the settings set in the configuration file.

−v, −−verbose

List all the files being removed. Normally only warnings and errors are shown, e.g. if some files were not found.

-q, −−quiet

Suppress all messages except wget download information.

−R /otherroot, −−root /otherroot

Install using a location other than / (the default) as the root of the filesystem to install on. In the example given, use /otherroot instead. Setting the ROOT environment variable does the same thing.

−K, −−keep−dotnew

Warning: This option is only for experts!
While packages are installed, information about files having extension .new is collected to a temporary file. Normally the list is shown at the end of the installation process and the temporary file is removed. Specifying −−keep−dotnew prevents upgradepkg from showing those files and deleting the temporary file which is stored to $ROOT/var/log/setup/tmp/dotnew. In practice this is only useful when upgradepkg is called from other scripts.

BUGS

Before upgrading a package, save any configuration files (such as in /etc) that you wish to keep. Sometimes these will be preserved, but it depends on the package structure. If you want to force new versions of the config files to be installed, remove the old ones manually prior to running upgradepkg.

AUTHORS

Original by Patrick J. Volkerding <volkerdi at slackware.com>

Revised for Tukaani Linux by Lasse Collin <lasse.collin at tukaani.org> and Ville Koskinen <w−ber at iki.fi>

SEE ALSO

pkgtool(8), installpkg(8), removepkg(8), upgradepkg(8), viewpkg(1), explodepkg(1), makepkg(1), convertpkg(1), makerepo(1)