Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PKG_REPLACE(1)		FreeBSD	General	Commands Manual		PKG_REPLACE(1)

NAME
     pkg_replace -- a utility for upgrading installed packages

SYNOPSIS
     pkg_replace [-habBcCdfFiJknNOpPPqrRuvVwW] [--automatic] [--batch]
		 [--clean] [--cleanup] [--config] [--debug]
		 [--exclude pkgname] [--force-config] [--noclean]
		 [--nocleanup] [--noconfig] [--version]	[-j jobs] [-l file]
		 [-L prefix] [-m make_args] [-M	make_env] [-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 cre-
	      ated 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.

     --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 dependen-
	      cies.

     -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 pack-
	      ages.

     -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.

     -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, --exclude GLOB
	      Do not replace packages matching the specified glob pattern.

EXAMPLES
     +o	 pkgname examples:

	       name-version, name and shell glob.
	       glib-2.36.3_2, glib and "glib*"

     +o	 pkgorigin examples:

	       devel/glib20

     +o	 Path:

	       Absolute	and relative paths are allowed.

     +o	 Install glib:

	       pkg_replace -N devel/glib20

     +o	 Install py-cairo with FLAVOR=py37

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

     +o	 Replace glib:

	       pkg_replace glib

     +o	 Replace perl and all packages that depend on it:

	       pkg_replace -r perl

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

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

     +o	 Replace XFree86-libraries with	/usr/ports/x11/xorg-libraries:

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

     +o	 Replace XFree86-libraries with	pkgorigin x11/xorg-libraries:

	       pkg_replace XFree86-libraries=x11/xorg-libraries

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

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

     +o	 Replace graphics/py-cairo with	FLAVOR=py37

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

COMPATIBILITY
     The portupgrade(1)	options	-A, -B,	-D, -e,	-o, -q,	-s, -S,	-u 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.

FreeBSD	13.0			August 21, 2020			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | COMPATIBILITY | SEE ALSO | AUTHORS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pkg_replace&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help