File: //opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/pkgng.cpython-310.pyc
o
�N�g�� � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddl Zddl
Zddl Zddl Zddl
mZmZ e�e�ZdZdd� ZdVdd�ZdVd d
�Zd d � ZdWdd�ZdXdd�Zdd� Zejj � ed�Z dYdd�Z ejj � e d�Z dd� Z!ejj � e!d �Z"d d � Z# dZd d �Z$d!d"� Z%d[d#d$�Z&dVd%d&�Z'dVd'd(�Z(dVd)d*�Z) d\d+d,�Z* d]d-d.�Z+ejj � e+d/�Z,ejj � e+d0�Z-d1d2� Z.d^d3d4�Z/dYd5d6�Z0 d_d7d8�Z1d^d9d:�Z2 d`d;d<�Z3 = dad>d?�Z4dbd@dA�Z5dcdBdC�Z6dcdDdE�Z7dFdG� Z8dHdI� Z9dJdK� Z:dLdM� Z;dddNdO�Z<dedPdQ�Z=dRdS� Z>dfdTdU�Z?dS )gas
Support for ``pkgng``, the new package manager for FreeBSD
.. important::
If you feel that Salt should be using this module to manage packages on a
minion, and it is using a different module (or gives an error similar to
*'pkg.install' is not available*), see :ref:`here
<module-provider-override>`.
.. warning::
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
:mod:`sys.doc <salt.modules.sys.doc>` function:
.. code-block:: bash
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 :conf_minion:`providers` parameter in your Minion config
file, in order to use this module to manage packages, like so:
.. code-block:: yaml
providers:
pkg: pkgng
� N)�CommandExecutionError� MinionError�pkgc C s� t d dkrtS t d dkrtt d �dkrtS t d dkrItt d �dkrIi } d tv r0td } t�d
| � | rId | v rI| d d krIt�d
� tS dS )z�
Load as 'pkg' on FreeBSD 10 and greater.
Load as 'pkg' on DragonFly BSD.
Load as 'pkg' on FreeBSD 9 when config option
``providers:pkg`` is set to 'pkgng'.
ZkernelZ DragonFly�osZFreeBSDZ osrelease�
Zosmajorrelease� � providersz__opts__.providers: %sr Zpkgngz_Configuration option 'providers:pkg' is set to 'pkgng', using 'pkgng' in favor of 'freebsdpkg'.)FzwThe pkgng execution module cannot be loaded: only available on FreeBSD 10 or FreeBSD 9 with providers.pkg set to pkgng.)Z
__grains__�__virtualname__�float�int�__opts__�log�debug)r � r �F/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/pkgng.py� __virtual__; s �r c C sH dg}| r|� d| g� |S |r|� d|g� |S |r"|� d|g� |S )zr
Returns the prefix for a pkg command, using -j if a jail is specified, or
-c if chroot is specified.
r z-jz-c�-r)�extend)�jail�chroot�root�retr r r �_pkgX s ��r c C s" t | ||�dg }td |��� S )z%
return the version of 'pkg'
z --version�cmd.run)r �__salt__�strip)r r r �cmdr r r �_get_pkgng_versiong s r c C sX t jj�|d�D ]!}|s
qz
|�dd�\}}W n ty Y qw || kr)| S qdS )z�
``pkg search`` will return all packages for which the pattern is a match.
Narrow this down and return the package version, or None if no exact match.
�
�-� N)�salt�utils� itertools�split�rsplit�
ValueError)�name�results�line�pkgname�pkgverr r r � _get_versiono s ��r, �
pkg.list_pkgsc C sF | r t |�d| � � S |rt |�d|� � S |r!t |�d|� � S |S )z�
As this module is designed to manipulate packages in jails and chroots, use
the passed jail/chroot to ensure that a key in the __context__ dict that is
unique to that jail/chroot is used.
z.jail_z.chroot_z.root_)�str)r r r �prefixr r r � _contextkey� s r0 �/usr/local/etc/pkg.confc C s� i }t j�| �sd| � d�S tjj�| ��*}|D ] }tjj�|�}|� d�s+|� d�r,q|�
d�\}}|||< qW d � n1 sBw Y | |d< |S )z�
Return dict of uncommented global variables.
CLI Example:
.. code-block:: bash
salt '*' pkg.parse_config
``NOTE:`` not working properly right now
zUnable to find z on file system�#r � N� config_file) r �path�isfiler! r" �filesZfopenZ stringutilsZ
to_unicode�
startswithr$ )� file_namer Zifiler) �key�valuer r r � parse_config� s
� �r< c sj |� dd�}td | i |��}tjj�|�s|S t| �dkr$| d |i}t�di �� � fdd�|� � D �S ) a"
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)``.
jail
Get package version information for the specified jail
chroot
Get package version information for the specified chroot (ignored if
``jail`` is specified)
root
Get package version information for the specified root (ignored if
``jail`` is specified)
with_origin : False
Return a nested dictionary containing both the origin name and version
for each specified package.
.. versionadded:: 2014.1.0
CLI Example:
.. code-block:: bash
salt '*' pkg.version <package name>
salt '*' pkg.version <package name> jail=<jail name or id>
salt '*' pkg.version <package1> <package2> <package3> ...
� with_originFzpkg_resource.versionr r �
pkg.originc �$ i | ]\}}|� � |d �|d��qS �� )�origin�version��get��.0�x�y��originsr r �
<dictcomp>� � $ zversion.<locals>.<dictcomp>)
�popr r! r" �data�is_true�len� __context__rE �items)�names�kwargsr= r r rJ r rC � s $ rC �infoFc K sF t jj�t� t| ||�}|�d� |r|�d� td |dd�dkS )aF
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:
.. code-block:: bash
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)
root
Refresh the pkg database within the specified root (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 Example:
.. code-block:: bash
salt '*' pkg.refresh_db force=True
�updatez-fz cmd.retcodeF)� python_shellr )r! r" r Z
clear_rtagr r �appendr )r r r �forcerU r r r r �
refresh_db� s %
r[ rW c
O s, | sdS i }| D ]}d||< q|� d�}|� d�}|� d�}|� d�}t|||d�}| D ][}t|||�ddg } d |v rB| �d
� n| �d � tjj�|�sS| �d � | �|� td
| ddd�}
|
dkr�|
� dd�d } |� |�} | sy| ||< q,tjj
j | d| d�s�| ||< q,t | �dkr�|| d S |S )a,
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:
.. code-block:: bash
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
rA r r �refreshr �r r r �searchz-eqS�/rB r' z-Ur F�trace)rX �output_loglevelr r z>=)Zver1ZoperZver2r )
rE � list_pkgsr rY r! r" rO rP r r% ZversionsZcomparerQ )
rT rU r r' r r r\ r �pkgsr Z
pkg_outputr+ Z installedr r r �latest_version sD
�
�� rd �available_versionc sR t �t| �}| std |� tjj�|�r't�|i �� � fdd�|� � D �S |S )z'
Use pkg list from __context__
�pkg_resource.stringifyc r? r@ rD rF rJ r r rL ] rM z+_list_pkgs_from_context.<locals>.<dictcomp>)
�copy�deepcopyrR r r! r" rO rP rE rS )�versions_as_list�contextkey_pkg�contextkey_originsr= r r rJ r �_list_pkgs_from_contextR s rl c sR t � fdd�dD ��r
i S tjj�| �} t|||�}t|||dd�}|tv r3� �dd�r3t| |||�S i }i �t d t
|||�d d
g d d d
�} tjj � | d�D ]+}
|
sUqPz|
� � \} } | �
dd�\}
}W n tyn Y qPw t d ||
|� | �|
< qPt d |� t�|�t|< �t|< | s�t d |� tjj�|�r��fdd�|�� D �S |S )a�
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)
root
List the packages in the specified root (ignored if ``jail`` is
specified)
with_origin : False
Return a nested dictionary containing both the origin name and version
for each installed package.
.. versionadded:: 2014.1.0
CLI Example:
.. code-block:: bash
salt '*' pkg.list_pkgs
salt '*' pkg.list_pkgs jail=<jail name or id>
salt '*' pkg.list_pkgs chroot=/path/to/chroot
c s g | ] }t jj�� �|���qS r )r! r" rO rP rE �rG rH �rU r r �
<listcomp>� � z list_pkgs.<locals>.<listcomp>)ZremovedZ
purge_desiredr> �r/ Z use_contextT�cmd.run_stdoutrV z-aor` F�ra rX r r r zpkg_resource.add_pkgzpkg_resource.sort_pkglistrf c r? r@ rD rF rJ r r rL � rM z list_pkgs.<locals>.<dictcomp>)�anyr! r" rO rP r0 rR rE rl r r r# r$ r% r& rg rh rS )ri r r r r= rU rj rk r �outr) r rB r* r+ r )rU rK r rb a sJ '� �� �
rb c C s$ t � d }td |dd| � �� dS )z�
Updates remote package repo URL, PACKAGESITE var to be exact.
Must use ``http://``, ``ftp://``, or ``https://`` protocol
CLI Example:
.. code-block:: bash
salt '*' pkg.update_package_site http://127.0.0.1/
r4 zfile.sedz
PACKAGESITE.*zPACKAGESITE : T)r< r )Znew_urlr4 r r r �update_package_site� s
rv c C s| d}| r|d7 }|r|d7 }|r|d7 }t |||�}|�d� |r(|�d| � td |dd d
�}d d � tjj�|d
�D �S )a3
Return pkgng stats.
CLI Example:
.. code-block:: bash
salt '*' pkg.stats
local
Display stats only for the local package database.
CLI Example:
.. code-block:: bash
salt '*' pkg.stats local=True
remote
Display stats only for the remote package database(s).
CLI Example:
.. code-block:: bash
salt '*' pkg.stats remote=True
bytes
Display disk space usage in bytes only.
CLI Example:
.. code-block:: bash
salt '*' pkg.stats bytes=True
jail
Retrieve stats from the specified jail.
CLI Example:
.. code-block:: bash
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).
root
Retrieve stats from the specified root (ignored if ``jail`` is
specified).
CLI Example:
.. code-block:: bash
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
rA �l�r�b�statsr r r` Frs c S s g | ]}|� d ��qS )r3 )r rm r r r ro s zstats.<locals>.<listcomp>r )r rY r r! r" r# r$ ) �localZremoter r r �bytes�optsr ru r r r rz � s A
rz c C s2 t d t|||�dd| g ddd�}|�d�d S ) a8
Export installed packages into yaml+mtree file
CLI Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
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.
root
Backup packages from the specified root (ignored if ``jail`` is
specified). Note that this will run the command within the root, and
so the path to the backup file will be relative to the root of the
root.
CLI Example:
.. code-block:: bash
salt '*' pkg.backup /tmp/pkg chroot=/path/to/chroot
r �backupz-dr` Frs z...r )r r r$ )r9 r r r r r r r r~ s '�r~ c C s$ t d t|||�dd| g ddd�S )a�
Reads archive created by pkg backup -d and recreates the database.
CLI Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
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.
root
Restore database to the specified root (ignored if ``jail`` is
specified). Note that this will run the command within the root, and
so the path to the file from which the pkg database will be restored is
relative to the root of the root.
CLI Example:
.. code-block:: bash
salt '*' pkg.restore /tmp/pkg chroot=/path/to/chroot
r r~ r r` Frs �r r )r9 r r r r r r �restoreE s
'�r� c C s" t d t| ||�ddg ddd�S )aj
Audits installed packages against known vulnerabilities
CLI Example:
.. code-block:: bash
salt '*' pkg.audit
jail
Audit packages within the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.audit jail=<jail name or id>
chroot
Audit packages within the specified chroot (ignored if ``jail`` is
specified)
root
Audit packages within the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.audit chroot=/path/to/chroot
r �auditz-Fr` Frs r r] r r r r� s s
!�r� c !
K s� zt d | ||fi |��\}}W n ty } zt|��d}~ww |s%i S i }d}tjj�|�r4|d7 }tjj�|�r?|d7 }tjj�| �rJ|d7 }tjj�|
�rU|d7 }tjj�| �r`|d7 }tjj�| �rk|d 7 }tjj�|
�rv|d
7 }tjj�|�r�|d 7 }tjj�|�r�|d 7 }tjj�|�r�d
dd�}t|||d�}|dkr�d}d�dd� |D ��}|}n@|dkr�d}|du r�|� d�r�t
|�dkr�| |� d�i}g }|� � D ]\}}|du r�|� |� q�|� |� d|� �� q�ntd��t
|||�} | � |� |�r| �d |g� |�r| � d| � | �|� |dk�r(tjj�| ��r(d �| �S t d | d d |d!�} | d" d#k�rD| d$ �rD| d$ g} ng } t�t|||�d� t�t|||d%d&�d� t|||d�} tjj�|| �} | �rwtd| | d'�d(��| S ))a7
Install package(s) from a repository
name
The name of the package to install
CLI Example:
.. code-block:: bash
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)
root
Install the package into the specified root (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 Example:
.. code-block:: bash
salt '*' pkg.install <package name> orphan=True
force
Force the reinstallation of the package if already installed.
CLI Example:
.. code-block:: bash
salt '*' pkg.install <package name> force=True
glob
Treat the package names as shell glob patterns.
CLI Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
salt '*' pkg.install <package name> quiet=True
reinstall_requires
When used with force, reinstalls any packages that require the
given package.
CLI Example:
.. code-block:: bash
salt '*' pkg.install <package name> reinstall_requires=True force=True
.. versionchanged:: 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 Example:
.. code-block:: bash
salt '*' pkg.install <package name> fromrepo=repo
regex
Treat the package names as a regular expression
CLI Example:
.. code-block:: bash
salt '*' pkg.install <regular expression> regex=True
pcre
Treat the package names as extended regular expressions.
CLI Example:
.. code-block:: bash
batch
Use BATCH=true for pkg install, skipping all questions.
Be careful when using in production.
CLI Example:
.. code-block:: bash
salt '*' pkg.install <package name> batch=True
�pkg_resource.parse_targetsNrI �A�f�g�U�n�q�RrH �X�trueZYES)ZBATCHZASSUME_ALWAYS_YESr] �file�addrA c S s g | ]}|d v r|�qS )ZAfIMqr )rG �optr r r ro Z s zinstall.<locals>.<listcomp>Z
repository�installrC r r z)Problem encountered installing package(s)r � � cmd.run_allr` F)ra rX �env�retcoder �stderrr> rq ��errors�changes�rV )r r r r! r" rO rP rb �joinrE rQ rS rY r r rR rN r0 �
compare_dicts)!r' �fromreporc Zsourcesr r r ZorphanrZ �globr{ �dryrun�quietZreinstall_requires�regex�pcreZbatchrU �
pkg_paramsZpkg_type�excr� r} �oldZpkg_cmd�targets�paramZ version_numr ru r� �newr r r r r� � s� ����
�
� �r� c
s6 ~ z t d | |�d }
W n ty } zt|��d}~ww g }t|||dd�}|
�� D ])}|d �d�dkrG|d � � fdd�|�� D �d }|d |v rT|�|d � q+|sYi S d }tjj �
|�rf|d
7 }tjj �
|�rq|d 7 }tjj �
|�r||d 7 }tjj �
|�r�|d
7 }tjj �
|�s�|d7 }tjj �
| �r�|d7 }tjj �
|
�r�|d7 }tjj �
| �r�|d7 }t |||�}|�d� |r�|�d| � |� |� t d |ddd�}|d dkr�|d r�|d g}ng }t
�t|||�d� t
�t|||dd�d� t|||dd�}tjj �||�}|�rtd ||d �d ��|S ) a!
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)``.
name
The package to remove
CLI Example:
.. code-block:: bash
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)
root
Delete the package from the specified root (ignored if ``jail`` is
specified)
all_installed
Deletes all installed packages from the system and empties the
database. USE WITH CAUTION!
CLI Example:
.. code-block:: bash
salt '*' pkg.remove all all_installed=True force=True
force
Forces packages to be removed despite leaving unresolved
dependencies.
CLI Example:
.. code-block:: bash
salt '*' pkg.remove <package name> force=True
glob
Treat the package names as shell glob patterns.
CLI Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
salt '*' pkg.remove <package name> dryrun=True
recurse
Delete all packages that require the listed package as well.
CLI Example:
.. code-block:: bash
salt '*' pkg.remove <package name> recurse=True
regex
Treat the package names as regular expressions.
CLI Example:
.. code-block:: bash
salt '*' pkg.remove <regular expression> regex=True
pcre
Treat the package names as extended regular expressions.
CLI Example:
.. code-block:: bash
salt '*' pkg.remove <extended regular expression> pcre=True
r� r NT)r r r r= r_ c s g | ] \}}|d � kr|�qS �rB r )rG �k�vr� r r ro rp zremove.<locals>.<listcomp>rA �ar� r� r� rI r� rH r� �deleter r� r` Frs r� r� r> rq z'Problem encountered removing package(s)r� r� )r r r rb rS �findrY r! r" rO rP r r rR rN r0 r� )r' rc r r r Z
all_installedrZ r� r� Zrecurser� r� rU r� r� r� r� r r} r ru r� r� r r r� r �remove� sl m�� �
�r� r� �purgec O s~ |� dd�}|� dd�}|� dd�}|� dd�}|� dd�}|� dd�}|� d d�}|� d
d�} |� d g �}
d } |r>| d
7 } |rD| d7 } | rJ| d7 } |rP| d7 } |sV| d7 } t|||�} | �d� | rj| �d| � | rq| �| � |
rx| �|
� |r�| �d|g� t� }
td | ddd�}t� t|||�d� t� t|||dd�d� t� }tj j
� |
|�}|d dkr�t d ||d �d ��|S ) a
Upgrade named or all packages (run a ``pkg upgrade``). If <package name> is
omitted, the operation is executed on all packages.
Returns a dictionary containing the changes:
.. code-block:: python
{'<package>': {'old': '<old-version>',
'new': '<new-version>'}}
CLI Example:
.. code-block:: bash
salt '*' pkg.upgrade <package name>
jail
Audit packages within the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.upgrade <package name> jail=<jail name or id>
chroot
Audit packages within the specified chroot (ignored if ``jail`` is
specified)
root
Audit packages within the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
salt '*' pkg.upgrade <package name> dryrun=True
fromrepo
In multi-repo mode, override the pkg.conf ordering and only attempt
to upgrade packages from the named repository.
CLI Example:
.. code-block:: bash
salt '*' pkg.upgrade <package name> fromrepo=repo
fetchonly
Do not perform installation of packages, merely fetch
packages that should be upgraded and detect possible conflicts.
CLI Example:
.. code-block:: bash
salt '*' pkg.upgrade <package name> fetchonly=True
r Nr r r� rZ Fr{ r� � fetchonlyrc rA r� r� �Fr� rI �upgrader � --repositoryr� r` rs r> rq r� r z&Problem encountered upgrading packages)r� �resultr� )
rN r rY r rb r rR r0 r! r" rO r� r )rT rU r r r r� rZ r{ r� r� rc r} r r� r� r� r r r r r� C sT _
�r� c C s` d}|r|d7 }|r|d7 }n|d7 }t | ||�}|�d� |r'|�d| � td |dd d
�S ) aA
Cleans the local cache of fetched remote packages
CLI Example:
.. code-block:: bash
salt '*' pkg.clean
jail
Cleans the package cache in the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.clean jail=<jail name or id>
chroot
Cleans the package cache in the specified chroot (ignored if ``jail``
is specified)
root
Cleans the package cache in the specified root (ignored if ``jail``
is specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.clean chroot=/path/to/chroot
clean_all
Clean all packages from the local cache (not just those that have been
superseded by newer versions).
CLI Example:
.. code-block:: bash
salt '*' pkg.clean clean_all=True
dryrun
Dry-run mode. This list of changes to the local cache is always
printed, but no changes are actually made.
CLI Example:
.. code-block:: bash
salt '*' pkg.clean dryrun=True
rA r� r� rI �cleanr r r` Frs �r rY r )r r r Z clean_allr� r} r r r r r� � s 5
r� c C sT d}|r |d7 }n|d7 }t | ||�}|�d� |r!|�d| � td |ddd �S )
a�
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 Example:
.. code-block:: bash
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
rA r� rI �
autoremover r r` Frs r� )r r r r� r} r r r r r� s
r� c C s� t ||||f�s
dS d}|r|d7 }|r|d7 }|r |d7 }|r$|d7 }t| ||�}|�d� |r8|�d| � td |d
d d �S )
a
Sanity checks installed packages
jail
Perform the sanity check in the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.check jail=<jail name or id>
chroot
Perform the sanity check in the specified chroot (ignored if ``jail``
is specified)
root
Perform the sanity check in the specified root (ignored if ``jail``
is specified)
CLI Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
salt '*' pkg.check depends=True
recompute
Recompute sizes and checksums of installed packages.
CLI Example:
.. code-block:: bash
salt '*' pkg.check recompute=True
checksum
Find invalid checksums for installed packages.
CLI Example:
.. code-block:: bash
salt '*' pkg.check checksum=True
checklibs
Regenerates the library dependency metadata for a package.
CLI Example:
.. code-block:: bash
salt '*' pkg.check checklibs=True
zDOne of depends, recompute, checksum or checklibs must be set to TruerA Zdyrx �s�B�checkr r r` Frs )rt r rY r ) r r r �dependsZ recomputeZchecksumZ checklibsr} r r r r r� 5 s K
r� c C s` d}|r|d7 }|r|d7 }t |||�}|�d� |r"|�d| � |�| � td |ddd �S )
a�
Displays which package installed a specific file
CLI Example:
.. code-block:: bash
salt '*' pkg.which <file name>
jail
Perform the check in the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.which <file name> jail=<jail name or id>
chroot
Perform the check in the specified chroot (ignored if ``jail`` is
specified)
root
Perform the check in the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.which <file name> chroot=/path/to/chroot
origin
Shows the origin of the package instead of name-version.
CLI Example:
.. code-block:: bash
salt '*' pkg.which <file name> origin=True
quiet
Quiet output.
CLI Example:
.. code-block:: bash
salt '*' pkg.which <file name> quiet=True
rA r� �o�whichr r r` Frs r� )r5 r r r rB r� r} r r r r r� � s 4
r� c C s� d}|r|d7 }|r|d7 }|r|d7 }|r|d7 }|r |d7 }| r&|d7 }|
r,|d7 }| r2|d 7 }| r8|d
7 }|
r>|d 7 }|rD|d 7 }|rJ|d
7 }t |||�}|�d� |r^|�d| � |�| � td |ddd�S )a�
Searches in remote package repositories
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern
jail
Perform the search using the ``pkg.conf(5)`` from the specified jail
CLI Example:
.. code-block:: bash
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)
root
Perform the search using the ``pkg.conf(5)`` from the specified root
(ignored if ``jail`` is specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern chroot=/path/to/chroot
exact
Treat pattern as exact pattern.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern exact=True
glob
Treat pattern as a shell glob pattern.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern glob=True
regex
Treat pattern as a regular expression.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern regex=True
pcre
Treat pattern as an extended regular expression.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern pcre=True
comment
Search for pattern in the package comment one-line description.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern comment=True
desc
Search for pattern in the package description.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern desc=True
full
Displays full information about the matching packages.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern full=True
depends
Displays the dependencies of pattern.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern depends=True
size
Displays the size of the package
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern size=True
quiet
Be quiet. Prints only the requested information without displaying
many hints.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern quiet=True
origin
Displays pattern origin.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern origin=True
prefix
Displays the installation prefix for each package matching pattern.
CLI Example:
.. code-block:: bash
salt '*' pkg.search pattern prefix=True
rA �er� rH r� �c�Dr� �dr� r� r� �pr^ r r r` Frs r� )r' r r r �exactr� r� r� �comment�desc�fullr� �sizer� rB r/ r} r r r r r^ � s@ !
r^ Tc C s� d} |r| d7 } |r| d7 } |r| d7 } |r| d7 } | r | d7 } |
r&| d7 } | r,| d7 } t |||�}
|
�d d
g� |rB|
�d |g� | rK|
�d | � |
�| � td
|
ddd�S )a:
Fetches remote packages
CLI Example:
.. code-block:: bash
salt '*' pkg.fetch <package name>
jail
Fetch package in the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.fetch <package name> jail=<jail name or id>
chroot
Fetch package in the specified chroot (ignored if ``jail`` is
specified)
root
Fetch package in the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.fetch <package name> chroot=/path/to/chroot
fetch_all
Fetch all packages.
CLI Example:
.. code-block:: bash
salt '*' pkg.fetch <package name> fetch_all=True
quiet
Quiet mode. Show less output.
CLI Example:
.. code-block:: bash
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 Example:
.. code-block:: bash
salt '*' pkg.fetch <package name> fromrepo=repo
glob
Treat pkg_name as a shell glob pattern.
CLI Example:
.. code-block:: bash
salt '*' pkg.fetch <package name> glob=True
regex
Treat pkg_name as a regular expression.
CLI Example:
.. code-block:: bash
salt '*' pkg.fetch <regular expression> regex=True
pcre
Treat pkg_name is an extended regular expression.
CLI Example:
.. code-block:: bash
salt '*' pkg.fetch <extended regular expression> pcre=True
local
Skip updating the repository catalogs with pkg-update(8). Use the
local cache only.
CLI Example:
.. code-block:: bash
salt '*' pkg.fetch <package name> local=True
depends
Fetch the package and its dependencies as well.
CLI Example:
.. code-block:: bash
salt '*' pkg.fetch <package name> depends=True
rA r� r� r� rH r� �Lr� �fetch�-yr r r r` Frs )r r rY r )r' r r r Z fetch_allr� r� r� r� r� r{ r� r} r r r r r� � s. x
r� c C sl d}|r |d|� �7 }|r|d|� �7 }t |||�}|�d� |r(|�d| � |�| � td |ddd �S )
a� '
Displays UPDATING entries of software packages
CLI Example:
.. code-block:: bash
salt '*' pkg.updating foo
jail
Perform the action in the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.updating foo jail=<jail name or id>
chroot
Perform the action in the specified chroot (ignored if ``jail`` is
specified)
root
Perform the action in the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.updating foo chroot=/path/to/chroot
filedate
Only entries newer than date are shown. Use a YYYYMMDD date format.
CLI Example:
.. code-block:: bash
salt '*' pkg.updating foo filedate=20130101
filename
Defines an alternative location of the UPDATING file.
CLI Example:
.. code-block:: bash
salt '*' pkg.updating foo filename=/tmp/UPDATING
rA zd zf �updatingr r r` Frs r� )r' r r r Zfiledate�filenamer} r r r r r� * s 4
r� c K s, g }|r
|� |� n|�| � i }|D ]�}t|t�r"tt|�� ��}|i ddd�||< t|fi |��s�dtv rNtd rN|| j dd� d|� d�|| d < qt
|fi |��rx|| j d
d� d � |�|| d < d || d
d< d|| d
d< qd� |�|| d < q|| j d
d� d� |�|| d < q|S )a�
Version-lock packages
.. note::
This function is provided primarily for compatibility with some
parts of :py:mod:`states.pkg <salt.states.pkg>`.
Consider using Consider using :py:func:`pkg.lock <salt.modules.pkgng.lock>` instead. instead.
name
The name of the package to be held.
Multiple Package Options:
pkgs
A list of packages to hold. Must be passed as a python list. The
``name`` parameter will be ignored if this option is passed.
Returns a dict containing the changes.
CLI Example:
.. code-block:: bash
salt '*' pkg.hold <package name>
salt '*' pkg.hold pkgs='["foo", "bar"]'
FrA �r' r� r� r� �testN�r� �Package z is set to be held.r� Tz Package {} is now being held.�holdr� r� r� z!Package {} was unable to be held.z%Package {} is already set to be held.) r rY �
isinstance�dict�next�iter�keys�lockedr rW �lock�format�r' rc rU r� r �targetr r r r� l s8
���r� c K s& g }|r
|� |� n|�| � i }|D ]}}t|t�r"tt|�� ��}|i ddd�||< t|fi |��r~td rI|| j dd� d�
|�|| d< qt |fi |��rs|| j d d� d
�
|�|| d< d|| d d < d
|| d d< qd|� d�|| d< q|| j d d� d|� d�|| d< q|S )a�
Remove version locks
.. note::
This function is provided primarily for compatibility with some parts of
:py:mod:`states.pkg <salt.states.pkg>`. Consider using
:py:func:`pkg.unlock <salt.modules.pkgng.unlock>` instead.
name
The name of the package to be unheld
Multiple Package Options:
pkgs
A list of packages to unhold. Must be passed as a python list. The
``name`` parameter will be ignored if this option is passed.
Returns a dict containing the changes.
CLI Example:
.. code-block:: bash
salt '*' pkg.unhold <package name>
salt '*' pkg.unhold pkgs='["foo", "bar"]'
FrA r� r� Nr� z Package {} is set to be unheld.r� Tz Package {} is no longer held.r� r� r� r� r� z was unable to be unheld.z is not being held.) r rY r� r� r� r� r� r� r rW r� �unlockr� r r r �unhold� s:
� �
��r� c s � fdd�t dddi� ��D �S )ay
Query the package database those packages which are
locked against reinstallation, modification or deletion.
Returns returns a list of package names with version strings
CLI Example:
.. code-block:: bash
salt '*' pkg.list_locked
jail
List locked packages within the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.list_locked jail=<jail name or id>
chroot
List locked packages within the specified chroot (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.list_locked chroot=/path/to/chroot
root
List locked packages within the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.list_locked root=/path/to/chroot
c s& g | ]}|� d t |fi � ��� ��qS )r )rC )rG r* rn r r ro s ��z list_locked.<locals>.<listcomp>r� r' N�r� ��_lockcmdrn r rn r � list_locked� s
+�r� c K s | t dddi|��v r
dS dS )a�
Query the package database to determine if the named package
is locked against reinstallation, modification or deletion.
Returns True if the named package is locked, False otherwise.
CLI Example:
.. code-block:: bash
salt '*' pkg.locked <package name>
jail
Test if a package is locked within the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.locked <package name> jail=<jail name or id>
chroot
Test if a package is locked within the specified chroot (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.locked <package name> chroot=/path/to/chroot
root
Test if a package is locked within the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.locked <package name> root=/path/to/chroot
r� r' NTFr� r� �r' rU r r r r� s +r� c K � | t d| fi |��v r
dS dS )aZ
Lock the named package against reinstallation, modification or deletion.
Returns True if the named package was successfully locked.
CLI Example:
.. code-block:: bash
salt '*' pkg.lock <package name>
jail
Lock packages within the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.lock <package name> jail=<jail name or id>
chroot
Lock packages within the specified chroot (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.lock <package name> chroot=/path/to/chroot
root
Lock packages within the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.lock <package name> root=/path/to/chroot
r� TFr� r� r r r r� N � *r� c K r� )al
Unlock the named package against reinstallation, modification or deletion.
Returns True if the named package was successfully unlocked.
CLI Example:
.. code-block:: bash
salt '*' pkg.unlock <package name>
jail
Unlock packages within the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.unlock <package name> jail=<jail name or id>
chroot
Unlock packages within the specified chroot (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.unlock <package name> chroot=/path/to/chroot
root
Unlock packages within the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.unlock <package name> root=/path/to/chroot
r� FTr� r� r r r r� ~ r� r� c
K s |� dd�}|� dd�}|� dd�}g }t|||�}|�| � |�d� |�d� |�d� |r5|�|� td |d d
d �}|d d
krPtd| � d�d|id��tjj�|d d�D ] } | s_qZz
| � dd�d
}W n t
yr Y qZw |�|� qZt � dd�
|�� |S )z�
Helper function for lock and unlock commands, because their syntax is identical.
Run the lock/unlock command, and return a list of locked packages
r Nr r r� �--quietz
--show-lockedr� r` Frs r� r zProblem encountered z ing packagesr� r� �stdoutr r r zLocked packages: %sz, )rN r rY r r r! r" r# r$ r% r& r
r r� )
Zsubcmdr* rU r r r Z locked_pkgsr ru r) r r r r� � s6
� � r� c K s� |� dd�}|� dd�}|� dd�}|� dd�}t|||�}|�g d�� | s,|�d� |r5|�d|g� td |d
d d d
�}dd� t|�d �� D �S )a8
List those packages for which an upgrade is available
The ``fromrepo`` argument is also supported, as used in pkg states.
CLI Example:
.. code-block:: bash
salt '*' pkg.list_upgrades
jail
List upgrades within the specified jail
CLI Example:
.. code-block:: bash
salt '*' pkg.list_upgrades jail=<jail name or id>
chroot
List upgrades within the specified chroot (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.list_upgrades chroot=/path/to/chroot
root
List upgrades within the specified root (ignored if ``jail`` is
specified)
CLI Example:
.. code-block:: bash
salt '*' pkg.list_upgrades root=/path/to/chroot
r Nr r r� )r� z --dry-runr� z--no-repo-updater� rr r` FT�ra rX Zignore_retcodec S s i | ] \}}||d d �qS )rC r� r )rG r* Zpkgstatr r r rL s ��z!list_upgrades.<locals>.<dictcomp>r� )rN r r rY r �_parse_upgraderS )r\ rU r r r r� r ru r r r �
list_upgrades� s *
��r� c C s� t �d�}t �d�}t �d�}i i i i i d�}d}tjj�| d�D ]�}|s(d}q!|dkr/d}q!|d kr6d
}q!|d kr=d }q!|d
krDd}q!|dkrKd}q!|dksS|dkr~|�|�}|rw|�d�|�d�d�|�d�|�d�d�|| |�d�< nt� d||� |d
kr�|�|�}|r�d|�d�i|�d�|�d�d�|| |�d�< nt� d||� |d ks�|dkr�|�|�}|r�d|�d�i|�d�|�d�d�|| |�d�< q!t� d||� q!|S ) a�
Parse the output from the ``pkg upgrade --dry-run`` command
Returns a dictionary of the expected actions:
.. code-block:: yaml
'upgrade':
pkgname:
'repo': repository
'reason': reason
'version':
'current': n.n.n
'new': n.n.n
'install':
pkgname:
'repo': repository
'reason': reason
'version':
'current': n.n.n
'reinstall':
pkgname:
'repo': repository
'reason': reason
'version':
'current': n.n.n
'downgrade':
pkgname:
'repo': repository
'reason': reason
'version':
'current': n.n.n
'new': n.n.n
'remove':
pkgname:
'repo': repository
'reason': reason
'version':
'current': n.n.n
zT^\s+([^:]+):\s([0-9a-z_,.]+)\s+->\s+([0-9a-z_,.]+)\s*(\[([^]]+)\])?\s*(\(([^)]+)\))?z?^\s+([^:]+):\s+([0-9a-z_,.]+)\s*(\[([^]]+)\])?\s*(\(([^)]+)\))?z@^\s+(\S+)-(?<=-)([0-9a-z_,.]+)\s*(\[([^]]+)\])?\s*(\(([^)]+)\))?)r� r� � reinstallr� � downgradeNr z"Installed packages to be UPGRADED:r� z New packages to be INSTALLED:r� z%Installed packages to be REINSTALLED:r� z!Installed packages to be REMOVED:r� z$Installed packages to be DOWNGRADED:r� � � )�currentr� � � )rC Zrepo�reasonr zUnable to parse %s: '%s'r� � � )
�re�compiler! r" r# r$ �match�groupr
�error)r� Z
upgrade_regexZ
install_regexZreinstall_regexr� �actionr) r� r r r r� sz *����
�
�
��r� c
K s� ~dddd�}z!ddd| |g}t d |d d
d d �}|d
|v r&||d
W S W dS ty@ } z t�|� W Y d}~dS d}~ww )a
Do a cmp-style comparison on two packages. Return -1 if pkg1 < pkg2, 0 if
pkg1 == pkg2, and 1 if pkg1 > pkg2. Return None if there was a problem
making the comparison.
CLI Example:
.. code-block:: bash
salt '*' pkg.version_cmp '2.1.11' '2.1.12'
���r r )�<�>�=r rC z--test-versionr� r` FTr� r� N)r � Exceptionr
r� )Zpkg1Zpkg2Z ignore_epochrU Zsymr r r� r r r � version_cmp� s& �� ����r� )NNN)NNNr- )r1 )NNNF)FNNNF)FFNNNF)NNNNNNNFFFFFFFFFF) NNNNNFFFFFFF)NNNFF)NNNFFFF)NNNFFFFFFFFFFFF) NNNFFNTFFFF)NNNNN)NN)N)T)F)@�__doc__rg �loggingr r� Zsalt.utils.datar! Zsalt.utils.filesZsalt.utils.functoolsZsalt.utils.itertoolsZsalt.utils.pkgZsalt.utils.stringutilsZsalt.utils.versionsZsalt.exceptionsr r � getLogger�__name__r
r r r r r, r0 r< rC r" � functoolsZalias_functionrV r[ rW rd re rl rb rv rz r~ r� r� r� r� r� r� r� r� r� r� r� r^ r� r� r� r� r� r� r� r� r� r� r� r� r r r r �<module> s &
0
.>�
�Q
Q
/
.)
� u
� 1
D
�
_D
� E
�
B
@@110
0
*A|