Skip to content

pkg_replace manual

Jump to bottom
Ken DEGUCHI edited this page Aug 1, 2023 · 16 revisions

NAME

pkg_replace — a utility for upgrading installed packages

SYNOPSIS

pkg_replace [ -habBcCddfFiJknNOpPPqrRRUuvVwW] [ --automatic] [ --batch] [ --clean] [ --cleanup] [ --config] [ --debug][ --force-config] [ --noclean] [ --nocleanup] [ --noconfig] [ --version] [ -j jobs] [ -l file] [ -L prefix] [ -m make_args] [ -M make_env] [-t make_target] [ -x pkgname] pkgname[=package [package] [pkgorigin] . . .]

DESCRIPTION

The pkg_replace command is used to upgrade installed packages.

OPTIONS

The following options are supported:

-h

Show help and exit.

-a

Do with all the installed packages.

-b

Keep backup packages of the old versions. By default, the created backup package will be deleted after installation.

-B

Do not backup old packages.

--automatic

Set automatic flag for the package. This affects the operation of pkg-autoremove(8).

--batch

Run an upgrading process in a batch mode (with BATCH=yes).

-c, --config

Do “make config-conditional” before build.

-C, --force-config

Do “make config” before build.

--clean

Do “make clean” before build.

--cleanup

Do “make clean” after build. This is the default.

-d, -R

In addition to the specified packages, replace all packages that required by those packages as well.

-dd, -RR

Strictly checking dependencies more than -d, -R, e.g. build dependencies. However, this mode is very slow.

--debug

Debug mode. Execute with “set -x” option.

-f

Force to replace packages.

-F

Fetch distfiles or packages, do not replace.

-i

Turn on interactive mode.

-j jobs

Number of parallel jobs. Default value gets from ‘sysctl -n hw.ncpu‘.

-J

Do not install the target packages, but install the dependencies.

-k

Force the upgrade of a package even if some of the requisite packages have failed to upgrade in advance.

-l FILE

Save the results to FILE. By default, pkg_replace does not save results.

-L PREFIX

Save the logs in the files that begins with PREFIX.

-m ARGS

Specify arguments to append to each make(1) command. Please see section EXAMPLES.

-M ARGS

Specify arguments to prepend to each make(1) command.

-n

Do not actually replace any packages.

--noconfig

Do not read the configuration file.

-N

Install new packages, do not replace.

-O

Do not check the dependencies before building the target packages.

-p

Do “make package”.

-P

Use binary packages instead of installing from source. pkg_replace finds them from the directory specified by PKGREPOSITORY, and the remote site specified by PACKAGEROOT.

-PP

Be forced to use binary packages. Never use the port even if a package is not available either locally or remotely.

-r

In addition to the specified packages, replace all packages that depend on those packages as well.

-t make_target

Do “make make_target” only.

-U

Unlock packages before deinstall packages and lock packages again after install.

-u

Do not preserve old shared libraries. By default, pkg_replace preserves old shared libraries in PKGCOMPATDIR.

-v

Turn on verbose output.

-V

List the installed packages that need updating.

--version

Print pkg_replace version.

-w, --noclean

Do not “make clean” before each build. This is the default.

-W, --nocleanup

Do not “make clean” after each installation.

-x GLOB

Do not replace packages matching the specified glob pattern.

EXAMPLES

  • pkgname examples: name-version, name and shell glob.

glib-2.36.3_2, glib and “glib∗”

  • pkgorigin examples:

devel/glib20

  • Path: Absolute and relative paths are allowed.

/home/foo/my_ports/audio/mpg123, ../../audio/mpg123

  • Install glib:

pkg_replace -N devel/glib20

  • Install py-cairo with FLAVOR=py37

pkg_replace -m FLAVOR=py37 -N graphics/py-cairo or pkg_replace -N graphics/py-cairo@py37

  • Replace glib:

pkg_replace glib

  • Replace perl and all packages that depend on it:

pkg_replace -r perl

  • If the xterm package is already installed, replace it with xterm-220:

pkg_replace /usr/ports/packages/All/xterm-220.tbz

  • Replace XFree86-libraries with /usr/ports/x11/xorg-libraries:

pkg_replace XFree86-libraries=/usr/ports/x11/xorg-libraries

  • Replace XFree86-libraries with pkgorigin x11/xorg-libraries:

pkg_replace XFree86-libraries=x11/xorg-libraries

  • Replace XFree86-libraries with /var/tmp/xorg-libraries-6.9.0 package:

pkg_replace XFree86-libraries=/var/tmp/xorg-libraries-6.9.0.tbz

  • Replace graphics/py-cairo with FLAVOR=py37:

pkg_replace -m FLAVOR=py37 graphics/py-cairo or pkg_replace graphics/py-cairo@py37

  • Do “make configure” only:

pkg_replace -t configure pkgname

COMPATIBILITY

The portupgrade(1) options -A, -B, -D, -e, -o, -q, -s, -S and -y are no longer supported.

SEE ALSO

portupgrade(1), pkg(8), ports(7),

AUTHORS

Securedog securedog@users.sourceforge.jp

Ken DEGUCHI kdeguchi@sz.tokoha-u.ac.jp

BUGS

Sure to be some.

Clone this wiki locally