salt.modules.pkgng

Support for pkgng, the new package manager for FreeBSD

警告

This module has been completely rewritten. Up to and including 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
salt.modules.pkgng.audit(jail=None, chroot=None)

Audits installed packages against known vulnerabilities

CLI 范例:

salt '*' pkg.audit
jail

Audit packages within the specified jail

CLI 范例:

salt '*' pkg.audit jail=<jail name or id>
chroot

Audit packages within the specified chroot (ignored if jail is specified)

CLI 范例:

salt '*' pkg.audit chroot=/path/to/chroot
salt.modules.pkgng.autoremove(jail=None, chroot=None, dryrun=False)

Delete packages which were automatically installed as dependencies and are not required anymore.

dryrun
Dry-run mode. The list of changes to packages is always printed, but no changes are actually made.

CLI 范例:

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
salt.modules.pkgng.backup(file_name, jail=None, chroot=None)

Export installed packages into yaml+mtree file

CLI 范例:

salt '*' pkg.backup /tmp/pkg
jail

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 范例:

salt '*' pkg.backup /tmp/pkg jail=<jail name or id>
chroot

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 范例:

salt '*' pkg.backup /tmp/pkg chroot=/path/to/chroot
salt.modules.pkgng.check(jail=None, chroot=None, depends=False, recompute=False, checksum=False)

Sanity checks installed packages

jail

Perform the sanity check in the specified jail

CLI 范例:

salt '*' pkg.check jail=<jail name or id>
chroot

Perform the sanity check in the specified chroot (ignored if jail is specified)

CLI 范例:

salt '*' pkg.check chroot=/path/to/chroot

Of the below, at least one must be set to True.

depends

Check for and install missing dependencies.

CLI 范例:

salt '*' pkg.check recompute=True
recompute

Recompute sizes and checksums of installed packages.

CLI 范例:

salt '*' pkg.check depends=True
checksum

Find invalid checksums for installed packages.

CLI 范例:

salt '*' pkg.check checksum=True
salt.modules.pkgng.clean(jail=None, chroot=None)

Cleans the local cache of fetched remote packages

CLI 范例:

salt '*' pkg.clean
salt '*' pkg.clean jail=<jail name or id>
salt '*' pkg.clean chroot=/path/to/chroot
salt.modules.pkgng.fetch(name, jail=None, chroot=None, fetch_all=False, quiet=False, fromrepo=None, glob=True, regex=False, pcre=False, local=False, depends=False)

Fetches remote packages

CLI 范例:

salt '*' pkg.fetch <package name>
jail

Fetch package in the specified jail

CLI 范例:

salt '*' pkg.fetch <package name> jail=<jail name or id>
chroot

Fetch package in the specified chroot (ignored if jail is specified)

CLI 范例:

salt '*' pkg.fetch <package name> chroot=/path/to/chroot
fetch_all

Fetch all packages.

CLI 范例:

salt '*' pkg.fetch <package name> fetch_all=True
quiet

Quiet mode. Show less output.

CLI 范例:

salt '*' pkg.fetch <package name> quiet=True
fromrepo

Fetches packages from the given repo if multiple repo support is enabled. See pkg.conf(5).

CLI 范例:

salt '*' pkg.fetch <package name> fromrepo=repo
glob

Treat pkg_name as a shell glob pattern.

CLI 范例:

salt '*' pkg.fetch <package name> glob=True
regex

Treat pkg_name as a regular expression.

CLI 范例:

salt '*' pkg.fetch <regular expression> regex=True
pcre

Treat pkg_name is an extended regular expression.

CLI 范例:

salt '*' pkg.fetch <extended regular expression> pcre=True
local

Skip updating the repository catalogs with pkg-update(8). Use the local cache only.

CLI 范例:

salt '*' pkg.fetch <package name> local=True
depends

Fetch the package and its dependencies as well.

CLI 范例:

salt '*' pkg.fetch <package name> depends=True
salt.modules.pkgng.install(name=None, fromrepo=None, pkgs=None, sources=None, jail=None, chroot=None, orphan=False, force=False, glob=False, local=False, dryrun=False, quiet=False, reinstall_requires=False, regex=False, pcre=False, **kwargs)

Install package(s) from a repository

name

The name of the package to install

CLI 范例:

salt '*' pkg.install <package name>
jail
Install the package into the specified jail
chroot
Install the package into the specified chroot (ignored if jail is specified)
orphan

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 范例:

salt '*' pkg.install <package name> orphan=True
force

Force the reinstallation of the package if already installed.

CLI 范例:

salt '*' pkg.install <package name> force=True
glob

Treat the package names as shell glob patterns.

CLI 范例:

salt '*' pkg.install <package name> glob=True
local

Do not update the repository catalogs with pkg-update(8). A value of True here is equivalent to using the -U flag with pkg install.

CLI 范例:

salt '*' pkg.install <package name> local=True
dryrun

Dru-run mode. The list of changes to packages is always printed, but no changes are actually made.

CLI 范例:

salt '*' pkg.install <package name> dryrun=True
quiet

Force quiet output, except when dryrun is used, where pkg install will always show packages to be installed, upgraded or deleted.

CLI 范例:

salt '*' pkg.install <package name> quiet=True
reinstall_requires

When used with force, reinstalls any packages that require the given package.

CLI 范例:

salt '*' pkg.install <package name> reinstall_requires=True force=True

在 2014.7.0 版更改: require kwarg renamed to reinstall_requires

fromrepo

In multi-repo mode, override the pkg.conf ordering and only attempt to download packages from the named repository.

CLI 范例:

salt '*' pkg.install <package name> fromrepo=repo
regex

Treat the package names as a regular expression

CLI 范例:

salt '*' pkg.install <regular expression> regex=True
pcre

Treat the package names as extended regular expressions.

CLI 范例:

salt '*' pkg.install <extended regular expression> pcre=True
salt.modules.pkgng.latest_version(*names, **kwargs)

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 范例:

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
salt.modules.pkgng.list_pkgs(versions_as_list=False, jail=None, chroot=None, with_origin=False, **kwargs)

List the packages currently installed as a dict:

{'<package_name>': '<version>'}
jail
List the packages in the specified jail
chroot
List the packages in the specified chroot (ignored if jail is specified)
with_origin : False

Return a nested dictionary containing both the origin name and version for each installed package.

2014.1.0 新版功能.

CLI 范例:

salt '*' pkg.list_pkgs
salt '*' pkg.list_pkgs jail=<jail name or id>
salt '*' pkg.list_pkgs chroot=/path/to/chroot
salt.modules.pkgng.parse_config(file_name='/usr/local/etc/pkg.conf')

Return dict of uncommented global variables.

CLI 范例:

salt '*' pkg.parse_config

NOTE: not working properly right now

salt.modules.pkgng.refresh_db(jail=None, chroot=None, force=False)

Refresh PACKAGESITE contents

注解

This function can accessed using pkg.update in addition to pkg.refresh_db, to more closely match the CLI usage of pkg(8).

CLI 范例:

salt '*' pkg.refresh_db
jail
Refresh the pkg database within the specified jail
chroot
Refresh the pkg database within the specified chroot (ignored if jail is specified)
force

Force a full download of the repository catalog without regard to the respective ages of the local and remote copies of the catalog.

CLI 范例:

salt '*' pkg.refresh_db force=True
salt.modules.pkgng.remove(name=None, pkgs=None, jail=None, chroot=None, all_installed=False, force=False, glob=False, dryrun=False, recurse=False, regex=False, pcre=False, **kwargs)

Remove a package from the database and system

注解

This function can accessed using pkg.delete in addition to pkg.remove, to more closely match the CLI usage of pkg(8).

name

The package to remove

CLI 范例:

salt '*' pkg.remove <package name>
jail
Delete the package from the specified jail
chroot
Delete the package from the specified chroot (ignored if jail is specified)
all_installed

Deletes all installed packages from the system and empties the database. USE WITH CAUTION!

CLI 范例:

salt '*' pkg.remove all all_installed=True force=True
force

Forces packages to be removed despite leaving unresolved dependencies.

CLI 范例:

salt '*' pkg.remove <package name> force=True
glob

Treat the package names as shell glob patterns.

CLI 范例:

salt '*' pkg.remove <package name> glob=True
dryrun

Dry run mode. The list of packages to delete is always printed, but no packages are actually deleted.

CLI 范例:

salt '*' pkg.remove <package name> dryrun=True
recurse

Delete all packages that require the listed package as well.

CLI 范例:

salt '*' pkg.remove <package name> recurse=True
regex

Treat the package names as regular expressions.

CLI 范例:

salt '*' pkg.remove <regular expression> regex=True
pcre

Treat the package names as extended regular expressions.

CLI 范例:

salt '*' pkg.remove <extended regular expression> pcre=True
salt.modules.pkgng.restore(file_name, jail=None, chroot=None)

Reads archive created by pkg backup -d and recreates the database.

CLI 范例:

salt '*' pkg.restore /tmp/pkg
jail

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 范例:

salt '*' pkg.restore /tmp/pkg jail=<jail name or id>
chroot

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 范例:

salt '*' pkg.restore /tmp/pkg chroot=/path/to/chroot
salt.modules.pkgng.search(name, jail=None, chroot=None, exact=False, glob=False, regex=False, pcre=False, comment=False, desc=False, full=False, depends=False, size=False, quiet=False, origin=False, prefix=False)

Searches in remote package repositories

CLI 范例:

salt '*' pkg.search pattern
jail

Perform the search using the pkg.conf(5) from the specified jail

CLI 范例:

salt '*' pkg.search pattern jail=<jail name or id>
chroot

Perform the search using the pkg.conf(5) from the specified chroot (ignored if jail is specified)

CLI 范例:

salt '*' pkg.search pattern chroot=/path/to/chroot
exact

Treat pattern as exact pattern.

CLI 范例:

salt '*' pkg.search pattern exact=True
glob

Treat pattern as a shell glob pattern.

CLI 范例:

salt '*' pkg.search pattern glob=True
regex

Treat pattern as a regular expression.

CLI 范例:

salt '*' pkg.search pattern regex=True
pcre

Treat pattern as an extended regular expression.

CLI 范例:

salt '*' pkg.search pattern pcre=True
comment

Search for pattern in the package comment one-line description.

CLI 范例:

salt '*' pkg.search pattern comment=True
desc

Search for pattern in the package description.

CLI 范例:

salt '*' pkg.search pattern desc=True
full

Displays full information about the matching packages.

CLI 范例:

salt '*' pkg.search pattern full=True
depends

Displays the dependencies of pattern.

CLI 范例:

salt '*' pkg.search pattern depends=True
size

Displays the size of the package

CLI 范例:

salt '*' pkg.search pattern size=True
quiet

Be quiet. Prints only the requested information without displaying many hints.

CLI 范例:

salt '*' pkg.search pattern quiet=True
origin

Displays pattern origin.

CLI 范例:

salt '*' pkg.search pattern origin=True
prefix

Displays the installation prefix for each package matching pattern.

CLI 范例:

salt '*' pkg.search pattern prefix=True
salt.modules.pkgng.stats(local=False, remote=False, jail=None, chroot=None)

Return pkgng stats.

CLI 范例:

salt '*' pkg.stats
local

Display stats only for the local package database.

CLI 范例:

salt '*' pkg.stats local=True
remote

Display stats only for the remote package database(s).

CLI 范例:

salt '*' pkg.stats remote=True
jail

Retrieve stats from the specified jail.

CLI 范例:

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
chroot

Retrieve stats from the specified chroot (ignored if jail is specified).

CLI 范例:

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
salt.modules.pkgng.update_package_site(new_url)

Updates remote package repo URL, PACKAGESITE var to be exact.

Must use http://, ftp://, or https:// protocol

CLI 范例:

salt '*' pkg.update_package_site http://127.0.0.1/
salt.modules.pkgng.updating(name, jail=None, chroot=None, filedate=None, filename=None)

' Displays UPDATING entries of software packages

CLI 范例:

salt '*' pkg.updating foo
jail

Perform the action in the specified jail

CLI 范例:

salt '*' pkg.updating foo jail=<jail name or id>
chroot

Perform the action in the specified chroot (ignored if jail is specified)

CLI 范例:

salt '*' pkg.updating foo chroot=/path/to/chroot
filedate

Only entries newer than date are shown. Use a YYYYMMDD date format.

CLI 范例:

salt '*' pkg.updating foo filedate=20130101
filename

Defines an alternative location of the UPDATING file.

CLI 范例:

salt '*' pkg.updating foo filename=/tmp/UPDATING
salt.modules.pkgng.upgrade(*names, **kwargs)

Upgrade named or all packages (run a pkg upgrade). If <package name> is omitted, the operation is executed on all packages.

CLI 范例:

salt '*' pkg.upgrade <package name>
jail

Audit packages within the specified jail

CLI 范例:

salt '*' pkg.upgrade <package name> jail=<jail name or id>
chroot

Audit packages within the specified chroot (ignored if jail is specified)

CLI 范例:

salt '*' pkg.upgrade <package name> chroot=/path/to/chroot

Any of the below options can also be used with jail or chroot.

force

Force reinstalling/upgrading the whole set of packages.

CLI 范例:

salt '*' pkg.upgrade <package name> force=True
local

Do not update the repository catalogs with pkg-update(8). A value of True here is equivalent to using the -U flag with pkg upgrade.

CLI 范例:

salt '*' pkg.upgrade <package name> local=True
dryrun

Dry-run mode: show what packages have updates available, but do not perform any upgrades. Repository catalogs will be updated as usual unless the local option is also given.

CLI 范例:

salt '*' pkg.upgrade <package name> dryrun=True
salt.modules.pkgng.version(*names, **kwargs)

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.

注解

This function can accessed using pkg.info in addition to pkg.version, to more closely match the CLI usage of pkg(8).

jail
Get package version information for the specified jail
chroot
Get package version information for the specified chroot (ignored if jail is specified)
with_origin : False

Return a nested dictionary containing both the origin name and version for each specified package.

2014.1.0 新版功能.

CLI 范例:

salt '*' pkg.version <package name>
salt '*' pkg.version <package name> jail=<jail name or id>
salt '*' pkg.version <package1> <package2> <package3> ...
salt.modules.pkgng.which(path, jail=None, chroot=None, origin=False, quiet=False)

Displays which package installed a specific file

CLI 范例:

salt '*' pkg.which <file name>
jail

Perform the check in the specified jail

CLI 范例:

salt '*' pkg.which <file name> jail=<jail name or id>
chroot

Perform the check in the specified chroot (ignored if jail is specified)

CLI 范例:

salt '*' pkg.which <file name> chroot=/path/to/chroot
origin

Shows the origin of the package instead of name-version.

CLI 范例:

salt '*' pkg.which <file name> origin=True
quiet

Quiet output.

CLI 范例:

salt '*' pkg.which <file name> quiet=True