Support for pkgng, the new package manager for FreeBSD
Warning
This module has been completely rewritten. Up to and includng version 0.17.x, it was available as the pkgng module, (pkgng.install, pkgng.delete, etc.), but moving forward this module will no longer be available as pkgng, as it will behave like a normal Salt pkg provider. The documentation below should not be considered to apply to this module in versions <= 0.17.x. If your minion is running a 0.17.x release or older, then the documentation for this module can be viewed using the sys.doc function:
salt bsdminion sys.doc pkgng
This module provides an interface to pkg(8). It acts as the default package provider for FreeBSD 10 and newer. For FreeBSD hosts which have been upgraded to use pkgng, you will need to override the pkg provider by setting the providers parameter in your Minion config file, in order to use this module to manage packages, like so:
providers:
pkg: pkgng
Audits installed packages against known vulnerabilities
CLI Example:
salt '*' pkg.audit
Audit packages within the specified jail
CLI Example:
salt '*' pkg.audit jail=<jail name or id>
Audit packages within the specified chroot (ignored if jail is specified)
CLI Example:
salt '*' pkg.audit chroot=/path/to/chroot
Delete packages which were automatically installed as dependencies and are not required anymore.
CLI Example:
salt '*' pkg.autoremove
salt '*' pkg.autoremove jail=<jail name or id>
salt '*' pkg.autoremove dryrun=True
salt '*' pkg.autoremove jail=<jail name or id> dryrun=True
Export installed packages into yaml+mtree file
CLI Example:
salt '*' pkg.backup /tmp/pkg
Backup packages from the specified jail. Note that this will run the command within the jail, and so the path to the backup file will be relative to the root of the jail
CLI Example:
salt '*' pkg.backup /tmp/pkg jail=<jail name or id>
Backup packages from the specified chroot (ignored if jail is specified). Note that this will run the command within the chroot, and so the path to the backup file will be relative to the root of the chroot.
CLI Example:
salt '*' pkg.backup /tmp/pkg chroot=/path/to/chroot
Sanity checks installed packages
Perform the sanity check in the specified jail
CLI Example:
salt '*' pkg.check jail=<jail name or id>
Perform the sanity check in the specified chroot (ignored if jail is specified)
CLI Example:
salt '*' pkg.check chroot=/path/to/chroot
Of the below, at least one must be set to True.
Check for and install missing dependencies.
CLI Example:
salt '*' pkg.check recompute=True
Recompute sizes and checksums of installed packages.
CLI Example:
salt '*' pkg.check depends=True
Find invalid checksums for installed packages.
CLI Example:
salt '*' pkg.check checksum=True
Cleans the local cache of fetched remote packages
CLI Example:
salt '*' pkg.clean
salt '*' pkg.clean jail=<jail name or id>
salt '*' pkg.clean chroot=/path/to/chroot
Fetches remote packages
CLI Example:
salt '*' pkg.fetch <package name>
Fetch package in the specified jail
CLI Example:
salt '*' pkg.fetch <package name> jail=<jail name or id>
Fetch package in the specified chroot (ignored if jail is specified)
CLI Example:
salt '*' pkg.fetch <package name> chroot=/path/to/chroot
Fetch all packages.
CLI Example:
salt '*' pkg.fetch <package name> fetch_all=True
Quiet mode. Show less output.
CLI Example:
salt '*' pkg.fetch <package name> quiet=True
Fetches packages from the given repo if multiple repo support is enabled. See pkg.conf(5).
CLI Example:
salt '*' pkg.fetch <package name> fromrepo=repo
Treat pkg_name as a shell glob pattern.
CLI Example:
salt '*' pkg.fetch <package name> glob=True
Treat pkg_name as a regular expression.
CLI Example:
salt '*' pkg.fetch <regular expression> regex=True
Treat pkg_name is an extended regular expression.
CLI Example:
salt '*' pkg.fetch <extended regular expression> pcre=True
Skip updating the repository catalogues with pkg-update(8). Use the local cache only.
CLI Example:
salt '*' pkg.fetch <package name> local=True
Fetch the package and its dependencies as well.
CLI Example:
salt '*' pkg.fetch <package name> depends=True
Install package(s) from a repository
The name of the package to install
CLI Example:
salt '*' pkg.install <package name>
Mark the installed package as orphan. Will be automatically removed if no other packages depend on them. For more information please refer to pkg-autoremove(8).
CLI Example:
salt '*' pkg.install <package name> orphan=True
Force the reinstallation of the package if already installed.
CLI Example:
salt '*' pkg.install <package name> force=True
Treat the package names as shell glob patterns.
CLI Example:
salt '*' pkg.install <package name> glob=True
Do not update the repository catalogues with pkg-update(8). A value of True here is equivalent to using the -U flag with pkg install.
CLI Example:
salt '*' pkg.install <package name> local=True
Dru-run mode. The list of changes to packages is always printed, but no changes are actually made.
CLI Example:
salt '*' pkg.install <package name> dryrun=True
Force quiet output, except when dryrun is used, where pkg install will always show packages to be installed, upgraded or deleted.
CLI Example:
salt '*' pkg.install <package name> quiet=True
When used with force, reinstalls any packages that require the given package.
CLI Example:
salt '*' pkg.install <package name> require=True force=True
In multi-repo mode, override the pkg.conf ordering and only attempt to download packages from the named repository.
CLI Example:
salt '*' pkg.install <package name> fromrepo=repo
Treat the package names as a regular expression
CLI Example:
salt '*' pkg.install <regular expression> regex=True
Treat the package names as extended regular expressions.
CLI Example:
salt '*' pkg.install <extended regular expression> pcre=True
Return the latest version of the named package available for upgrade or installation. If more than one package name is specified, a dict of name/version pairs is returned.
If the latest version of a given package is already installed, an empty string will be returned for that package.
CLI Example:
salt '*' pkg.latest_version <package name>
salt '*' pkg.latest_version <package name> jail=<jail name or id>
salt '*' pkg.latest_version <package name> chroot=/path/to/chroot
List the packages currently installed as a dict:
{'<package_name>': '<version>'}
Return a nested dictionary containing both the origin name and version for each installed package.
New in version 2014.1.0: (Hydrogen)
CLI Example:
salt '*' pkg.list_pkgs
salt '*' pkg.list_pkgs jail=<jail name or id>
salt '*' pkg.list_pkgs chroot=/path/to/chroot
Return dict of uncommented global variables.
CLI Example:
salt '*' pkg.parse_config
NOTE: not working properly right now
Refresh PACKAGESITE contents
Note
This function can accessed using pkg.update in addition to pkg.refresh_db, to more closely match the CLI usage of pkg(8).
CLI Example:
salt '*' pkg.refresh_db
Force a full download of the repository catalogue without regard to the respective ages of the local and remote copies of the catalogue.
CLI Example:
salt '*' pkg.refresh_db force=True
Remove a package from the database and system
Note
This function can accessed using pkg.delete in addition to pkg.remove, to more closely match the CLI usage of pkg(8).
The package to remove
CLI Example:
salt '*' pkg.remove <package name>
Deletes all installed packages from the system and empties the database. USE WITH CAUTION!
CLI Example:
salt '*' pkg.remove all all_installed=True force=True
Forces packages to be removed despite leaving unresolved dependencies.
CLI Example:
salt '*' pkg.remove <package name> force=True
Treat the package names as shell glob patterns.
CLI Example:
salt '*' pkg.remove <package name> glob=True
Dry run mode. The list of packages to delete is always printed, but no packages are actually deleted.
CLI Example:
salt '*' pkg.remove <package name> dryrun=True
Delete all packages that require the listed package as well.
CLI Example:
salt '*' pkg.remove <package name> recurse=True
Treat the package names as regular expressions.
CLI Example:
salt '*' pkg.remove <regular expression> regex=True
Treat the package names as extended regular expressions.
CLI Example:
salt '*' pkg.remove <extended regular expression> pcre=True
Reads archive created by pkg backup -d and recreates the database.
CLI Example:
salt '*' pkg.restore /tmp/pkg
Restore database to the specified jail. Note that this will run the command within the jail, and so the path to the file from which the pkg database will be restored is relative to the root of the jail.
CLI Example:
salt '*' pkg.restore /tmp/pkg jail=<jail name or id>
Restore database to the specified chroot (ignored if jail is specified). Note that this will run the command within the chroot, and so the path to the file from which the pkg database will be restored is relative to the root of the chroot.
CLI Example:
salt '*' pkg.restore /tmp/pkg chroot=/path/to/chroot
Searches in remote package repositories
CLI Example:
salt '*' pkg.search pattern
Perform the search using the pkg.conf(5) from the specified jail
CLI Example:
salt '*' pkg.search pattern jail=<jail name or id>
Perform the search using the pkg.conf(5) from the specified chroot (ignored if jail is specified)
CLI Example:
salt '*' pkg.search pattern chroot=/path/to/chroot
Treat pattern as exact pattern.
CLI Example:
salt '*' pkg.search pattern exact=True
Treat pattern as a shell glob pattern.
CLI Example:
salt '*' pkg.search pattern glob=True
Treat pattern as a regular expression.
CLI Example:
salt '*' pkg.search pattern regex=True
Treat pattern as an extended regular expression.
CLI Example:
salt '*' pkg.search pattern pcre=True
Search for pattern in the package comment one-line description.
CLI Example:
salt '*' pkg.search pattern comment=True
Search for pattern in the package description.
CLI Example:
salt '*' pkg.search pattern desc=True
Displays full information about the matching packages.
CLI Example:
salt '*' pkg.search pattern full=True
Displays the dependencies of pattern.
CLI Example:
salt '*' pkg.search pattern depends=True
Displays the size of the package
CLI Example:
salt '*' pkg.search pattern size=True
Be quiet. Prints only the requested information without displaying many hints.
CLI Example:
salt '*' pkg.search pattern quiet=True
Displays pattern origin.
CLI Example:
salt '*' pkg.search pattern origin=True
Displays the installation prefix for each package matching pattern.
CLI Example:
salt '*' pkg.search pattern prefix=True
Return pkgng stats.
CLI Example:
salt '*' pkg.stats
Display stats only for the local package database.
CLI Example:
salt '*' pkg.stats local=True
Display stats only for the remote package database(s).
CLI Example:
salt '*' pkg.stats remote=True
Retrieve stats from the specified jail.
CLI Example:
salt '*' pkg.stats jail=<jail name or id>
salt '*' pkg.stats jail=<jail name or id> local=True
salt '*' pkg.stats jail=<jail name or id> remote=True
Retrieve stats from the specified chroot (ignored if jail is specified).
CLI Example:
salt '*' pkg.stats chroot=/path/to/chroot
salt '*' pkg.stats chroot=/path/to/chroot local=True
salt '*' pkg.stats chroot=/path/to/chroot remote=True
Updates remote package repo URL, PACKAGESITE var to be exact.
Must use http://, ftp://, or https:// protocol
CLI Example:
salt '*' pkg.update_package_site http://127.0.0.1/
' Displays UPDATING entries of software packages
CLI Example:
salt '*' pkg.updating foo
Perform the action in the specified jail
CLI Example:
salt '*' pkg.updating foo jail=<jail name or id>
Perform the action in the specified chroot (ignored if jail is specified)
CLI Example:
salt '*' pkg.updating foo chroot=/path/to/chroot
Only entries newer than date are shown. Use a YYYYMMDD date format.
CLI Example:
salt '*' pkg.updating foo filedate=20130101
Defines an alternative location of the UPDATING file.
CLI Example:
salt '*' pkg.updating foo filename=/tmp/UPDATING
Upgrade all packages (run a pkg upgrade)
CLI Example:
salt '*' pkg.upgrade
Audit packages within the specified jail
CLI Example:
salt '*' pkg.upgrade jail=<jail name or id>
Audit packages within the specified chroot (ignored if jail is specified)
CLI Example:
salt '*' pkg.upgrade chroot=/path/to/chroot
Any of the below options can also be used with jail or chroot.
Force reinstalling/upgrading the whole set of packages.
CLI Example:
salt '*' pkg.upgrade force=True
Do not update the repository catalogues with pkg-update(8). A value of True here is equivalent to using the -U flag with pkg upgrade.
CLI Example:
salt '*' pkg.upgrade local=True
Dry-run mode: show what packages have updates available, but do not perform any upgrades. Repository catalogues will be updated as usual unless the local option is also given.
CLI Example:
salt '*' pkg.upgrade dryrun=True
Returns a string representing the package version or an empty string if not installed. If more than one package name is specified, a dict of name/version pairs is returned.
Note
This function can accessed using pkg.info in addition to pkg.version, to more closely match the CLI usage of pkg(8).
Return a nested dictionary containing both the origin name and version for each specified package.
New in version 2014.1.0: (Hydrogen)
CLI Example:
salt '*' pkg.version <package name>
salt '*' pkg.version <package name> jail=<jail name or id>
salt '*' pkg.version <package1> <package2> <package3> ...
Displays which package installed a specific file
CLI Example:
salt '*' pkg.which <file name>
Perform the check in the specified jail
CLI Example:
salt '*' pkg.which <file name> jail=<jail name or id>
Perform the check in the specified chroot (ignored if jail is specified)
CLI Example:
salt '*' pkg.which <file name> chroot=/path/to/chroot
Shows the origin of the package instead of name-version.
CLI Example:
salt '*' pkg.which <file name> origin=True
Quiet output.
CLI Example:
salt '*' pkg.which <file name> quiet=True
Current Salt release: 2014.1.6
Docs for previous releases on salt.rtfd.org.