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

FreeBSD Manual Pages

  
 
  

home | help
PKG-LOCK(8)		FreeBSD	System Manager's Manual		   PKG-LOCK(8)

NAME
     pkg lock, pkg unlock -- lock or unlock packages

SYNOPSIS
     pkg lock [-lqy] [-a]
     pkg lock [-lqy] [-Cgix] pkg-name
     pkg unlock	[-lqy] [-a]
     pkg unlock	[-lqy] [-Cgix] pkg-name

     pkg lock [--{show-locked,quiet,yes}] [--all]
     pkg lock --has-locked-packages
     pkg lock [--{show-locked,quiet,yes}]
	 [--{case-sensitive,glob,case-insensitive,regex}] pkg-name
     pkg unlock	[--{show-locked,quiet,yes}] [--all]
     pkg unlock	[--{show-locked,quiet,yes}]
	 [--{case-sensitive,glob,case-insensitive,regex}] pkg-name

DESCRIPTION
     pkg lock is used to lock packages against reinstallation, modification or
     deletion.	pkg unlock unlocks the named packages.	Either variant only
     has an effect on currently	installed packages.  Consequently it is	impos-
     sible to block installation of a new package by using this	mechanism,
     unless such an installation implies updating a locked package.

     The impact	of locking a package is	wider than simply preventing modifica-
     tions to the package itself.  Any operation implying modification of the
     locked package will be blocked.  This includes:

     +o	 Attempts to reinstall,	up- or downgrade or delete the locked package
	 itself.
     +o	 Installation, up- or downgrade	of a package where the resultant pack-
	 age would have	a dependency on	a different version of the locked
	 package.
     +o	 Deletion, up- or downgrade of any package the locked package depends
	 upon, either directly or as a consequence of installing or upgrading
	 some third package.

OPTIONS
     The following options are supported by pkg	lock:

     -a, ---all
	  Lock or unlock all installed packages.

     -C, --case-sensitive
	  Make the standard or the regular expression (-x) matching against
	  pkg-name case	sensitive.

     -g, --glob
	  Treat	pkg-name as a shell glob pattern.

     -i, --case-insensitive
	  Make the standard or the regular expression (-x) matching against
	  pkg-name case	insensitive.  This is the default, unless modified by
	  setting CASE_SENSITIVE_MATCH to true in pkg.conf.

     -l, --show-locked
	  Show a list of all locked packages.  This can	be used	without	lock-
	  ing or unlocking any packages, in which case privileged access to
	  the package database is not required.	 Otherwise it will be dis-
	  played after any lock	or unlock operations.

     -q, --quiet
	  Operate quietly: do not output anything other	than confirmatory
	  questions.

     -x, --regex
	  Treat	pkg-name as a regular expression according to the "modern" or
	  "extended" syntax of re_format(7).

     -y, --yes
	  Assume "yes" as the answer to	all questions.

     --has-locked-packages
	  Return 0 if at least one package is locked, 1	otherwise

ENVIRONMENT
     The following environment variables affect	the execution of pkg lock.
     See pkg.conf(5) for further description.

     PKG_DBDIR

     DEFAULT_ALWAYS_YES

     ASSUME_ALWAYS_YES

     CASE_SENSITIVE_MATCH

FILES
     See pkg.conf(5).

SEE ALSO
     pkg_printf(3), pkg_repos(3), pkg-repository(5), pkg.conf(5), pkg(8),
     pkg-add(8), pkg-alias(8), pkg-annotate(8),	pkg-audit(8),
     pkg-autoremove(8),	pkg-backup(8), pkg-check(8), pkg-clean(8),
     pkg-config(8), pkg-create(8), pkg-delete(8), pkg-fetch(8),	pkg-info(8),
     pkg-install(8), pkg-query(8), pkg-register(8), pkg-repo(8),
     pkg-rquery(8), pkg-search(8), pkg-set(8), pkg-shell(8), pkg-shlib(8),
     pkg-ssh(8), pkg-stats(8), pkg-update(8), pkg-updating(8), pkg-upgrade(8),
     pkg-version(8), pkg-which(8)

FreeBSD	Ports 11.2		April 14, 2015		    FreeBSD Ports 11.2

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | SEE ALSO

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

home | help