slackware-current/source/a/pkgtools/manpages/upgradepkg.8
Patrick J Volkerding 8f0b1c57c9 Fri Jun 8 20:37:06 UTC 2018
a/glibc-solibs-2.27-x86_64-3.txz:  Rebuilt.
a/pkgtools-15.0-noarch-16.txz:  Rebuilt.
  upgradepkg: clean up --help output and add options
  upgradepkg: accept -help option (not just --help)
  upgradepkg: don't omit error messages in --terse mode
  upgradepkg: only print missing new package in old%new mode
  upgradepkg.8: move information about config file handling from BUGS to the
    DESCRIPTION section
  Thanks to Xsane.
ap/vim-8.1.0039-x86_64-1.txz:  Upgraded.
l/glibc-2.27-x86_64-3.txz:  Rebuilt.
  When installing the package, remove old versions of the glibc shared
  libraries. In addition to eliminating residue on the system from old
  package versions, this change will make it possible in the future to
  revert to older glibc packages using upgradepkg.
l/glibc-i18n-2.27-x86_64-3.txz:  Rebuilt.
l/glibc-profile-2.27-x86_64-3.txz:  Rebuilt.
n/gnupg2-2.2.8-x86_64-1.txz:  Upgraded.
  Sanitize the diagnostic output of the original file name in verbose mode.
  By using a made up file name in the message it was possible to fake status
  messages. Using this technique it was for example possible to fake the
  verification status of a signed mail.
  For more information, see:
    https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2018-12020
  (* Security fix *)
xap/vim-gvim-8.1.0039-x86_64-1.txz:  Upgraded.
2018-06-09 01:06:22 +02:00

116 lines
2.9 KiB
Groff

.\" -*- nroff -*-
.ds g \" empty
.ds G \" empty
.\" Like TP, but if specified indent is more than half
.\" the current line-length - indent, use the default indent.
.de Tp
.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
.el .TP "\\$1"
..
.TH UPGRADEPKG 8 "31 May 2002" "Slackware Version 8.1.0"
.SH NAME
upgradepkg \- upgrade Slackware packages.
.SH SYNOPSIS
.B upgradepkg
[
.B --dry-run
]
[
.B --install-new
]
[
.B --reinstall
]
[
.B \--terse
]
[
.B \--terselength <length>
]
[
.B --verbose
]
.BI newpackagename
.BI [ newpackagename2 ]
.LP
.B upgradepkg
[
.B --dry-run
]
[
.B --install-new
]
[
.B --reinstall
]
[
.B \--terse
]
[
.B \--terselength <length>
]
[
.B --verbose
]
.BI oldpackagename%newpackagename
.BI [ old2%new2 ]
.SH DESCRIPTION
.B upgradepkg
upgrades a Slackware package from an older version to a
newer one. It does this by
.B INSTALLING
the new package onto the system, and then
.B REMOVING
any files from the old package that aren't in the new package.
If the old and new packages have the same name, a single argument is all that
is required. If the packages have different names, 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.
.P
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.
.P
If upgradepkg finds more than one installed package matching the old package's
name, it will remove them all.
.TP
To upgrade in a directory other than / (such as /mnt):
.TP
ROOT=/mnt upgradepkg package.txz (or .tbz, .tgz, .tlz)
.SH OPTIONS
.TP
.B \--dry-run
Output a report about which packages would be installed or upgraded
but don't actually perform the upgrades.
.TP
.B \--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
.B --install-new
is specified, the behavior is modified to install new packages in addition to upgrading
existing ones.
.TP
.B \--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.
.TP
.B \--terse
Upgrade the package displaying only a single description line to stdout.
.TP
.B \--terselength <length>
Maximum line length of --terse mode output. Default is the number of terminal columns.
.TP
.B \--verbose
Show all the gory details of the upgrade.
.SH AUTHOR
Patrick J. Volkerding <volkerdi@slackware.com>
.SH "SEE ALSO"
.BR makepkg(8),
.BR installpkg(8),
.BR removepkg(8),
.BR explodepkg(8),
.BR pkgtool(8)