FreeBSD Manual Pages
PKG-LOCK(8) 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 impossible 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: * Attempts to reinstall, upgrade, downgrade, or delete the locked package itself. * Installation, upgrade, or downgrade of a package where the resultant package would have a dependency on a different version of the locked package. * Deletion, upgrade, or downgrade of any package the locked package de- pends upon, either directly or as a consequence of installing or up- grading 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. This is the default, unless modified by set- ting CASE_SENSITIVE_MATCH to false in pkg.conf. -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. -l, --show-locked Show a list of all locked packages. This can be used without locking or unlocking any packages, in which case privileged access to the package database is not required. Otherwise it will be displayed af- ter any lock or unlock operations. -q, --quiet Operate quietly: do not output anything other than confirmatory ques- tions. -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_checksum(3), pkg_create(3), pkg_printf(3), pkg_repo_create(3), pkg_re- pos(3), pkg-keywords(5), pkg-lua-script(5), pkg-repository(5), pkg- script(5), pkg-triggers(5), pkg.conf(5), pkg(8), pkg-add(8), pkg-alias(8), pkg-annotate(8), pkg-audit(8), pkg-autoremove(8), pkg-check(8), pkg-check- sum(8), pkg-clean(8), pkg-config(8), pkg-create(8), pkg-delete(8), pkg- fetch(8), pkg-help(8), pkg-info(8), pkg-install(8), pkg-key(8), pkg-plug- ins(8), pkg-query(8), pkg-register(8), pkg-repo(8), pkg-repositories(8), pkg-rquery(8), pkg-rwhich(8), pkg-search(8), pkg-set(8), pkg-shell(8), pkg- shlib(8), pkg-ssh(8), pkg-stats(8), pkg-triggers(8), pkg-unregister(8), pkg-update(8), pkg-updating(8), pkg-upgrade(8), pkg-version(8), pkg- which(8) FreeBSD ports 15.quarterly March 19, 2024 PKG-LOCK(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkg-lock&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>