File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/yumpkg.cpython-310.pyc
Back
o ;j�� � @ sr d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlZ ddlmZmZmZ ddlmZ e� e �Z dZ dZ dZ!dZ"d d � Z#d d � Z$d d� Z%e dfdd�Z&dd� Z'dd� Z(dd� Z)d�dd�Z*dd� Z+d d � Z,d�d d �Z-d�d d!�Z.d�d"d#�Z/d$d%� Z0d&d'� Z1d(d)� Z2e j3j4�5e2d*�Z6d+d,� Z7d-d.� Z8d�d0d1�Z9d2d3� Z:d�d4d5�Z;d6d7� Z<d�d8d9�Z=e j3j4�5e=d:�Z>d;d<� Z?d=d>� Z@d?d@� ZAdAdB� ZBG dCdD� dDe j3jCjD�ZE / / / / / E /d�dFdG�ZF / / d�dHdI�ZG / / /d�dJdK�ZHd�dLdM�ZId�dNdO�ZJ d�dPdQ�ZKd�dRdS�ZLe dfdTdU�ZMd�dVdW�ZNe j3j4�5eMdX�ZOdYdZ� ZPd[d\� ZQd�d]d^�ZRd_d`� ZSd�dbdc�ZTe j3j4�5eTdd�ZUd�dedf�ZVd�dgdh�ZWd�didj�ZXd�dkdl�ZYd�dmdn�ZZdodp� Z[dqdr� Z\dsdt� Z]dudv� Z^dwdx� Z_dydz� Z`d�d{d|�Zad�d}d~�Zbdd�� Zcd�d�� ZddS )�ak Support for YUM/DNF .. 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>`. .. note:: DNF is fully supported as of version 2015.5.10 and 2015.8.4 (partial support for DNF was initially added in 2015.8.0), and DNF is used automatically in place of YUM in Fedora 22 and newer. .. versionadded:: 3003 Support for ``tdnf`` on Photon OS. .. versionadded:: 3006.10 Support for ``dnf5``` on Fedora 41 � N)�CommandExecutionError� MinionError�SaltInvocationError�� LooseVersionz[\w+]+(?:[.-][^-]+)*z/etc/dnf/versionlock.toml�.�pkgc C sn t �d�dkr dS ztd �� } td �� }W n ty! Y dS w d}|dks,| |v r5t� d u r3d S tS dS ) z2 Confine this module to yum based systems Z yum_providerZ yumpkg_api)Fz0Module yumpkg: yumpkg_api provider not available�os� os_family)Fz+Module yumpkg: no yum based system detected)ZamazonZxcpZ xenserverZvirtuozzolinuxZ virtuozzoz issabel pbxZ openeulerZredhatN)FzDNF nor YUM found)�__opts__�get� __grains__�lower� Exception�_yum�__virtualname__)Zos_grainr �enabled� r �G/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/yumpkg.py� __virtual__= s � r c G sN |sd}ndd� |D �}d}t jj�| d�D ]}|�� |vr$||d 7 }q|S )N)zinstalled packageszavailable packageszavailable upgradeszupdated packageszupgraded packagesc S � g | ]}|� � �qS r )r ��.0�xr r r � <listcomp>d � z"_strip_headers.<locals>.<listcomp>� � )�salt�utils� itertools�splitr )�output�argsZargs_lc�ret�liner r r �_strip_headersZ s �r& c C s4 | � dd�d } | � dd�} d| d � d| d � �S )N�:� �/z copr:copr.fedorainfracloud.org:r )r! )�coprr r r �_get_copr_repol s r+ Tc C s� |rt � dv rd|� d�}nd|� d�}nt � dv r!d|� d�}nd|� d�}t�|| �}|rQ|sL|�d��dd�d }|�d d�d }|�d d�d S |�d�S d S ) z� Resolve a package name from a line containing the hold expression. If the regex is not matched, None is returned. yum ==> 2:vim-enhanced-7.4.629-5.el6.* dnf ==> vim-enhanced-2:7.4.827-1.fc22.* ��dnf�dnf5�(z-\S+)z(\d+:z\d+:(r( r r �-N)r �re�search�group�rsplit)r% �pattern�fullZlock_re�matchZwoarchZworelr r r � _get_holdr s r8 c s� ddl � � fdd�} zt}W n ty i }Y nw d}||vrk� j�d� j��� j�D ]>}| � j� |d��r=d||< n.| � j� |d��rLd||< n | � j� |d ��r[d ||< n| � j� |d ��rjd ||< nq,|�|�S ) zm Determine package manager name (yum or dnf[5]), depending on the executable existence in $PATH. r Nc s. � j �| �o� �| � j� jB �o� j �| � S �N)�path�exists�access�F_OK�X_OK�isdir)�file�r r r �_check� s � �z_yum.<locals>._checkZyum_bin�PATHr. r- �tdnf�yum) r � __context__� NameError�environr �defpathr! �pathsepr: �join)rB �context� contextkey�dirr rA r r � s0 � � r c K sz ddt jj�t� �d�}|�|� g }t jj�t�r(t d dd�r(|� ddg� |� t � � |� | � t d |fi |��S ) z Call yum/dnf. �traceF)�output_loglevel� python_shell�envz config.getz systemd.scopeTz systemd-runz--scopez cmd.run_all) r r Z environmentZget_module_environment�globals�update�systemdZ has_scoperF �__salt__�extend�appendr )r# �kwargs�params�cmdr r r � _call_yum� s � � r\ c c s � i }t �d�}tjj �t| ��}td }t||�D ]h\}}|dkrSz|�dd�\|d< |d< W n t yA ||d< ||d< Y nw tjj j � |d |d |�|d< q|dkr]|� d�}n |d krf|�d �}|||< |d kr�tjj j jd i |��}i }|d ur�|V qd S ) z� Parse yum/dnf output (which could contain irregular line breaks if package names are long) retrieving the name, version, etc., and return a list of pkginfo namedtuples. )�name�version�repoid�osarchr] r r( �archr^ r0 r_ �@Nr )r �cycler r r! r& r �zipr4 � ValueErrorr �rpm� resolve_name�rstrip�lstrip�pkginfo)r" Zcur�keys�valuesr` �key�valuerj r r r � _yum_pkginfo� s8 � � � ��ro c C s� | du rt } t� dv r-| d �� dkr t| �d��dkr dS dS t| �d ��d kr+dS d S t� d kr6td ��t| �d ��dkrAdS dS )z3 Determine versionlock plugin package name Nr, r ZfedoraZ osrelease� z python3-dnf-plugin-versionlockz&python3-dnf-plugins-extras-versionlock�osmajorrelease� z python2-dnf-plugin-versionlockrD z'Cannot proceed, no versionlock for tdnf� zyum-versionlockzyum-plugin-versionlock)r r r �intr r )Zgrainsr r r �_versionlock_pkg� s& ��� ���ru c C s$ t � } | t� vrtd| � d���dS )zC Ensure that the appropriate versionlock plugin is present zCannot proceed, z is not installed.N)ru � list_pkgsr )Z vl_pluginr r r �_check_versionlock s �rw c K s* | � dd�}| � dd�}| � dd�}| � dd�}| � dd�}| � dd�}| � dd �}|d u r1g }ntjj�|�}| � d d �}|rD|sD|}g } |rYt�d |� | �d d|� �g� n>|rxt|t �sc|gn|} t�dd� | �� | �dd� | D �� |r�t|t �s�|gn|} t�dd� | �� | �dd� | D �� |r�t�d|� | � d|� �� |r�t�d|� | � d|� �� |D ]} t�d| � | �d| � �g� q�|�rt | �D ]7} | � d�r�q�| | } t| t�r�t�d | | � | � d | � d | � �� q�| d u �r t�d | � | � d | � �� q�| �rt�d!| � | S )"zi Returns a list of options to be used in the yum/dnf[5] command, based on the kwargs passed. �fromrepor �repo� disablerepo� enablerepo�disableexcludes�branch�setoptN�get_extra_optionsFzRestricting to repo '%s'z--disablerepo=*� --enablerepo=zDisabling repo(s): %s�, c S � g | ]}d |� ��qS )z--disablerepo=r r r r r r 9 � z _get_options.<locals>.<listcomp>zEnabling repo(s): %sc S r� )r� r r r r r r = r� zDisabling excludes for '%s'z--disableexcludes=zAdding branch '%s'z --branch=z Adding configuration option '%s'z --setopt=�__zFound extra option --%s=%sz--�=TzFound extra option --%szAdding extra options: %s)�popr r r# � split_input�log�inforW � isinstance�listrK rX �sorted� startswith�str)rY rx ry rz r{ r| r} r~ r r$ �targets�itemrm rn r r r � _get_options sd � � r� c C s� dddgi}d}d}|D ] }t j�|�r|} nq |s"td|� ���tj| d�}z|�|� W n tyE } z td|� d |� ���d}~ww |�d �rr|� d �D ] }|d v rgd d � |� d |�� d�D �||< qP|� d |�||< qP|S t � d|� |S )aa Returns a dict representing the yum config options and values. We try to pull all of the yum config options into a standard dict object. This is currently only used to get the reposdir settings, but could be used for other things if needed. We try to read the yum.conf directly ourselves with a minimal set of "defaults". �reposdirz/etc/yum/repos.dz/etc/yum.repos.dN)z/etc/yum/yum.confz /etc/yum.confz/etc/dnf/dnf.confz/etc/tdnf/tdnf.confz&No suitable yum config file found in: ��strictzUnable to read from z: �main)r� ZcommandsZexcludesc S r r ��stripr r r r r � r z#_get_yum_config.<locals>.<listcomp>�,z<Could not find [main] section in %s, using internal defaults)r r: r; r � configparser� ConfigParser�read�OSErrorZ has_section�optionsr r! r� �warning)� strict_parser�conf�fn�pathsr: Zcp�exc�optr r r �_get_yum_config] s4 � � �� " �r� c C s t |�}| |v r |�| �S dS )zB Look for a specific config variable and return its value N)r� r )r] � strict_configr� r r r �_get_yum_config_value� s r� c C sR t | t�rdd� | �d�D �} | du rg } | s td|�} t | t�r#| s'td��| S )z� Takes a basedir argument as a string or a list. If the string or list is empty, then look up the default from the 'reposdir' option in the yum config. Returns a list of directories. c S r r r� r r r r r � r z&_normalize_basedir.<locals>.<listcomp>r� Nr� z(Could not determine any repo directories)r� r� r! r� r� r )�basedirr� r r r �_normalize_basedir� s r� c C s� z| � td�d }|tjjjjd vr| W S W n ty" | Y S w | dt|�d � }tjjj� ||t d �|kr>|S | S )ab Strips the architecture from the specified package name, if necessary. Circumstances where this would be done include: * If the arch is 32 bit and the package name ends in a 32-bit arch. * If the arch matches the OS arch, or is ``noarch``. CLI Example: .. code-block:: bash salt '*' pkg.normalize_name zsh.x86_64 r( �����noarchNr` ) r4 �PKG_ARCH_SEPARATORr r r rf �ARCHESre �lenrg r )r] ra Z stripped_namer r r �normalize_name� s � ��r� c C sV d\}}z | � td�\}}W n ty Y nw |tjjjjd vr&| }d}||d�S )z� Parse name and architecture from the specified package name. CLI Example: .. code-block:: bash salt '*' pkg.parse_arch zsh.x86_64 �NNr( r� N)r] ra )r4 r� re r r r rf r� )r] �_nameZ_archr r r � parse_arch� s � r� c s� t jj�|�dd��}| sdS td i |��}|r td i |�� tdd�� dg}|�|� |�ddg� |�| � t |dd�}|d d krb|d r_t � fd d �| D ��s_t � dd� | �|d � g }n tt|d �dd� dd�}� fdd�}i }| D ]T�z��dd�d } | t jjjjvr�td } W n ty� td } Y nw �fdd�|D �D ] } | jd ks�| j| ks�t jjj�| j�r�|| �r�| j|�< nq�d|�< qyt| �dkr�|| d S |S ) aN 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. A specific repo can be requested using the ``fromrepo`` keyword argument, and the ``disableexcludes`` option is also supported. .. versionadded:: 2014.7.0 Support for the ``disableexcludes`` option CLI Example: .. code-block:: bash salt '*' pkg.latest_version <package name> salt '*' pkg.latest_version <package name> fromrepo=epel-testing salt '*' pkg.latest_version <package name> disableexcludes=main salt '*' pkg.latest_version <package1> <package2> <package3> ... �refreshTr ��versions_as_list�--quietr� � available��ignore_retcode�retcoder �stderrc s g | ]}|� v �qS r r r ��cur_pkgsr r r r z"latest_version.<locals>.<listcomp>z`Problem encountered getting latest version for the following package(s): %s. Stderr follows: %sr� �stdoutc S s t | j�S r9 )r r^ )rj r r r �<lambda> s z latest_version.<locals>.<lambda>)rm �reversec s@ | j � v r � | j D ]}tjjj|d| jtd�r dS q dS dS )N�>=)�ver1�oper�ver2�cmp_funcFT)r] r r �versions�comparer^ � version_cmp)r Zinstalled_versionr� r r � _check_cur$ s ��z"latest_version.<locals>._check_curr r( r� r` c 3 s � | ] }|j � kr|V qd S r9 �r] r r� r r � <genexpr>N s � z!latest_version.<locals>.<genexpr>r� Nr )r r �data�is_truer� r� � refresh_dbrv rW r\ �allr� �errorrK r� ro r4 r rf r� r re ra Zcheck_32r^ r� ) �namesrY r� r� r[ �out�updatesr� r$ ra r r )r� r] r �latest_version� sf � � � � � �� r� �available_versionc K s t | fi |��dkS )z� Check whether or not an upgrade is available for a given package CLI Example: .. code-block:: bash salt '*' pkg.upgrade_available <package name> r )r� )r] rY r r r �upgrade_availablei s r� c O � t d | i |��S )aY 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. CLI Example: .. code-block:: bash salt '*' pkg.version <package name> salt '*' pkg.version <package1> <package2> <package3> ... �pkg_resource.version�rV �r� rY r r r r^ v s r^ Fc K s t d | ||d�S )a� .. versionadded:: 2015.5.4 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. ignore_epoch : False Set to ``True`` to ignore the epoch when comparing versions .. versionadded:: 2015.8.10,2016.3.2 CLI Example: .. code-block:: bash salt '*' pkg.version_cmp '0.2-001' '0.2.0.1-002' zlowpkg.version_cmp)� ignore_epochr� )Zpkg1Zpkg2r� rY r r r r� � s r� c C s t d t| | |�S )z' Use pkg list from __context__ � pkg_resource.format_pkg_list)rV rF )r� rM �attrr r r �_list_pkgs_from_context� s �r� c s� t jj�| �} t� fdd�dD ��ri S � �d�}|dur(|dkr(t jj�|�}d}|tv r:� �dd �r:t | ||�S i }d d d d dt jj j j � dd�d g}td |ddd�}|�� D ]F}t jj j j|td d�}|dur�|j} d} d} d| v r�| �dd�\} } d| v r�| �dd�\} } | | | |j|j|jd�} td ||j| � q[|D ]} t|| d d � d �|| < q�|t|< td t| | |�S )!a� List the packages currently installed as a dict. By default, the dict contains versions as a comma separated string:: {'<package_name>': '<version>[,<version>...]'} versions_as_list: If set to true, the versions are provided as a list {'<package_name>': ['<version>', '<version>']} attr: If a list of package attributes is specified, returned value will contain them in addition to version, eg.:: {'<package_name>': [{'version' : 'version', 'arch' : 'arch'}]} Valid attributes are: ``epoch``, ``version``, ``release``, ``arch``, ``install_date``, ``install_date_time_t``. If ``all`` is specified, all valid attributes will be returned. .. versionadded:: 2018.3.0 CLI Example: .. code-block:: bash salt '*' pkg.list_pkgs salt '*' pkg.list_pkgs attr=version,arch salt '*' pkg.list_pkgs attr='["version", "arch"]' c s g | ] }t jj�� �|���qS r )r r r� r� r r �rY r r r � s z list_pkgs.<locals>.<listcomp>)ZremovedZ purge_desiredr� Nr� � pkg.list_pkgsZ use_contextTrf z-qaz --nodigestz --nosignature� --queryformatz %{REPOID}z(none)r �cmd.runFrO )rQ rP r` )r` r' r( r0 )�epochr^ �releasera � install_date�install_date_time_tzpkg_resource.add_pkgc S s | d S )Nr^ r )�dr r r r� � s zlist_pkgs.<locals>.<lambda>)rm r� )r r r� r� �anyr r# r� rF r� r rf Z QUERYFORMAT�replacerV � splitlinesZ parse_pkginfor r^ r! ra r� r� r] r� )r� rY r� rM r$ r[ r" r% rj �pkgverr� r� Zall_attr�pkgnamer r� r rv � sZ !� � �� �rv c s |� dd�}|� dd�}|� dd�pd}|� dd�pd�|� dd�p#d�td1d|i|��}|rVt|t�sVz dd � |�d �D �}W n tyU d d � t|��d �D �}Y nw �rt�t�sz d d � ��d �D ��W n ty~ d d � t���d �D ��Y nw �r�t�t�s�z dd � ��d �D ��W n ty� dd � t���d �D ��Y nw |r�|�n��fdd �td1i |���� D ��i �dd� � d2� ���fdd� }t � dkr�dnt t d ddgdd�� � d � � �}|�r |t d�k �r d g}|r�|�d � |�d � d D ]} t|| g d d!�} | d" dk�r || d# d d$� �qn|�rY|t d%�k �rYd d&g}|�r5|�d � |�d � d D ]} t|| g d d!�} | d" dk�rV|| d# d d$� �q<nE�D ]B} t � d'k�rld d(| � �d g} nd d&d)| d g} |�r{| �d � | ��� t| d d!�} | d" dk�r�d*| d# v �r��q[|| d# � �q[|�rˈD ]%} �| D ] }td+d,� �| | D �d d-�}d.d � |D ��| |< �q��q��S i }�D ]} �| D ]}|�|g ���| | � �qՐq�|D ]}td/d,� || D �d d-�}d0d � |D �||< �q�|S )3a� .. versionadded:: 2014.1.0 .. versionchanged:: 2014.7.0 All available versions of each package are now returned. This required a slight modification to the structure of the return dict. The return data shown below reflects the updated return dict structure. Note that packages which are version-locked using :py:mod:`pkg.hold <salt.modules.yumpkg.hold>` will only show the currently-installed version, as locking a package will make other versions appear unavailable to yum/dnf. .. versionchanged:: 2017.7.0 By default, the versions for each package are no longer organized by repository. To get results organized by repository, use ``byrepo=True``. Returns all available packages. Optionally, package names (and name globs) can be passed and the results will be filtered to packages matching those names. This is recommended as it speeds up the function considerably. .. warning:: Running this function on RHEL/CentOS 6 and earlier will be more resource-intensive, as the version of yum that ships with older RHEL/CentOS has no yum subcommand for listing packages from a repository. Thus, a ``yum list installed`` and ``yum list available`` are run, which generates a lot of output, which must then be analyzed to determine which package information to include in the return data. This function can be helpful in discovering the version or repo to specify in a :mod:`pkg.installed <salt.states.pkg.installed>` state. The return data will be a dictionary mapping package names to a list of version numbers, ordered from newest to oldest. If ``byrepo`` is set to ``True``, then the return dictionary will contain repository names at the top level, and each repository will map packages to lists of version numbers. For example: .. code-block:: python # With byrepo=False (default) { 'bash': ['4.1.2-15.el6_5.2', '4.1.2-15.el6_5.1', '4.1.2-15.el6_4'], 'kernel': ['2.6.32-431.29.2.el6', '2.6.32-431.23.3.el6', '2.6.32-431.20.5.el6', '2.6.32-431.20.3.el6', '2.6.32-431.17.1.el6', '2.6.32-431.11.2.el6', '2.6.32-431.5.1.el6', '2.6.32-431.3.1.el6', '2.6.32-431.1.2.0.1.el6', '2.6.32-431.el6'] } # With byrepo=True { 'base': { 'bash': ['4.1.2-15.el6_4'], 'kernel': ['2.6.32-431.el6'] }, 'updates': { 'bash': ['4.1.2-15.el6_5.2', '4.1.2-15.el6_5.1'], 'kernel': ['2.6.32-431.29.2.el6', '2.6.32-431.23.3.el6', '2.6.32-431.20.5.el6', '2.6.32-431.20.3.el6', '2.6.32-431.17.1.el6', '2.6.32-431.11.2.el6', '2.6.32-431.5.1.el6', '2.6.32-431.3.1.el6', '2.6.32-431.1.2.0.1.el6'] } } fromrepo : None Only include results from the specified repo(s). Multiple repos can be specified, comma-separated. enablerepo (ignored if ``fromrepo`` is specified) Specify a disabled package repository (or repositories) to enable. (e.g., ``yum --enablerepo='somerepo'``) .. versionadded:: 2017.7.0 disablerepo (ignored if ``fromrepo`` is specified) Specify an enabled package repository (or repositories) to disable. (e.g., ``yum --disablerepo='somerepo'``) .. versionadded:: 2017.7.0 byrepo : False When ``True``, the return data for each package will be organized by repository. .. versionadded:: 2017.7.0 cacheonly : False When ``True``, the repo information will be retrieved from the cached repo metadata. This is equivalent to passing the ``-C`` option to yum/dnf. .. versionadded:: 2017.7.0 setopt A comma-separated or Python list of key=value options. This list will be expanded and ``--setopt`` prepended to each in the yum/dnf command that is run. .. versionadded:: 2019.2.0 CLI Examples: .. code-block:: bash salt '*' pkg.list_repo_pkgs salt '*' pkg.list_repo_pkgs foo bar baz salt '*' pkg.list_repo_pkgs 'samba4*' fromrepo=base,updates salt '*' pkg.list_repo_pkgs 'python2-*' byrepo=True �byrepoF� cacheonlyrx r rz r{ c S r r r� r r r r r � r z"list_repo_pkgs.<locals>.<listcomp>r� c S r r r� r r r r r � r c S � g | ] }|d kr|� � �qS ��*r� r r r r r � � c S r� r� r� r r r r r � r� c S r� r� r� r r r r r � r� c S r� r� r� r r r r r � r� c s8 g | ]\}}|�v s|� vrt |�d d��dkr|�qS )r �1)r� r )r Z repo_nameZ repo_info)rz r{ r r r � s �c S s | D ] }t � ||�r dS qdS )zp Do glob matching on args and return True if a match was found. Otherwise, return False TF��fnmatch)r# r] �argr r r � _check_args� s �z#list_repo_pkgs.<locals>._check_argsc sX t | �D ]%}|r|j�vs� �|j�sq��|ji �}|�|jt� �}|�|j� qd S r9 )ro r_ r] � setdefault�set�addr^ )r" r� r Z repo_dictZ version_list)r� r# �reposr$ r r � _parse_output� s �z%list_repo_pkgs.<locals>._parse_outputrE Nr� z --version�rQ r z3.2.13r� z-Cr� )� installedr� Tr� r� r� r� z3.4.3z--showduplicatesrD r� zrepository-packages�Error:c s � � | ]}t |�V qd S r9 r r r r r r� � � � z!list_repo_pkgs.<locals>.<genexpr>)r� c S � g | ]}|j �qS r �Zvstringr r r r r � � c s r r9 r r r r r r� � r c S r r r r r r r r � r r �F)r� r� r� r� r! �AttributeErrorr� � list_repos�itemsr r rV r� r� rX r\ rW r� r� )r# rY r� r� rx Zrepo_argr� Z yum_version� cmd_prefixZpkg_srcr� ry r[ �reponamer� Zsorted_versionsZ byrepo_retr )r� r# rz r{ r� r$ r �list_repo_pkgs s� x � � � � ���� �� �� � �� ��r c K s� t di |��}tjj�| �rtdddi|�� dg}|�|� |�dt� dv r)dndg� t|dd �}|d d kr?d |v r?i S d d� t |d �D �S )a� Check whether or not an upgrade is available for all packages The ``fromrepo``, ``enablerepo``, and ``disablerepo`` arguments are supported, as used in pkg states, and the ``disableexcludes`` option is also supported. .. versionadded:: 2014.7.0 Support for the ``disableexcludes`` option CLI Example: .. code-block:: bash salt '*' pkg.list_upgrades � check_updateFr� r� r, z --upgradesr� Tr� r� r r c S s i | ]}|j |j�qS r )r] r^ r r r r � <dictcomp> r� z!list_upgrades.<locals>.<dictcomp>r� Nr ) r� r r r� r� r� rW r r\ ro )r� rY r� r[ r� r r r � list_upgrades� s r � list_updatesc K s� t j�dt� �}i }tjj�|�D ]>\}}}t�|d�D ]2}t j�||�}t d |�}t t j� |��} |t j� |�| t j �| ��� d�|�|d i �|d < q q|S )z� .. versionadded:: 2017.7.0 List prefetched packages downloaded by Yum in the local disk. CLI Example: .. code-block:: bash salt '*' pkg.list_downloaded � /var/cachez*.rpm�lowpkg.bin_pkg_info)r: �sizeZcreation_date_time_tZcreation_date_timer] r^ )r r: rK r r r Zos_walkr� �filterrV rt �getctime�getsize�datetime� fromtimestamp� isoformatr� ) rY � CACHE_DIRr$ �root�dirnames� filenames�filename� package_path�pkg_infoZ pkg_timestampr r r �list_downloaded" s" � �� r! c O s� |� dd�}t� }td | i |���� D ]9\}}|r |n|g}|D ]+}t� }|�� D ]\} } | dkr7| |d< q*| || < q*|sC|||< q!|�|g ��|� q!q|S )a� .. versionadded:: 2015.8.1 Return the information of the named package(s), installed on the system. :param all_versions: Include information for all versions of the packages installed on the minion. CLI Example: .. code-block:: bash salt '*' pkg.info_installed <package1> salt '*' pkg.info_installed <package1> <package2> <package3> ... salt '*' pkg.info_installed <package1> <package2> <package3> all_versions=True � all_versionsFz lowpkg.infoZ source_rpm�source)r �dictrV r r� rX ) r� rY r" r$ �pkg_nameZpkgs_nfoZpkg_nfoZ_nfoZt_nform rn r r r �info_installedA s � r& c K s� t jj�t� dddd�}d}| �dd�}tdi | ��}g d�}|�|� t|dd� |rUg d�}t � d �d krDt � d �d krD|� d � |�|� |� t|dd�d d�}|S )a� Check the yum repos for updated packages Returns: - ``True``: Updates are available - ``False``: An error occurred - ``None``: No updates are available repo Refresh just the specified repo disablerepo Do not refresh the specified repo enablerepo Refresh a disabled repo using this option branch Add the specified branch when refreshing disableexcludes Disable the excludes defined in your config files. Takes one of three options: - ``all`` - disable all excludes - ``main`` - disable excludes defined in [main] in yum.conf - ``repoid`` - disable excludes defined for that repo setopt A comma-separated or Python list of key=value options. This list will be expanded and ``--setopt`` prepended to each in the yum/dnf command that is run. .. versionadded:: 2019.2.0 CLI Example: .. code-block:: bash salt '*' pkg.refresh_db TNF)�d r r( r )r� � --assumeyesZcleanz expire-cacher� )r� r( z check-updater ZRedHatrq � z'--setopt=autocheck_running_kernel=falser� r ) r r r Z clear_rtagr r� r� rW r\ r r rX )rY Zretcodesr$ Z check_update_r� Z clean_cmdZ update_cmdr r r r� e s& +� r� c K s t di | ��S )z� .. versionadded:: 2014.1.0 Cleans local yum metadata. Functionally identical to :mod:`refresh_db() <salt.modules.yumpkg.refresh_db>`. CLI Example: .. code-block:: bash salt '*' pkg.clean_metadata Nr )r� r� r r r �clean_metadata� s r* c s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )�AvailablePackagesc s t � �� || _|| _d S r9 )�super�__init__�_args�_kwargs)�selfr# rY �� __class__r r r- � s zAvailablePackages.__init__c C s | � � dS �NT)� _load_all)r0 rm r r r �_load� s zAvailablePackages._loadc C s t | ji | j��| _d| _d S r3 )r r. r/ �_dictZloaded)r0 r r r r4 � s zAvailablePackages._load_all)�__name__� __module__� __qualname__r- r5 r4 � __classcell__r r r1 r r+ � s r+ �basec 3 s� | � d�durt| d �| d< tdFi | ���tjj�|�r$tdFi | �� tjj�|�}ztd | ||f| |o;| � dd�d�| ��\} } W n t yT } zt |��d}~ww | sYi S | � d�}� sft d|d �nt � }� spt dd �nt � }g }g }g }i }| d kr�g }g }| � � D ]*\}}zd |v r�|�|� n|�d �s�|�d�r�|�|� W q� ttfy� Y q�w t|| ddi| ��}| � � }nR| dkr�g }t� }| D ]} | |vr�t d| � d���|�| � q�n2g }| D ]-} dtv r�td | �} nd} | du �rt�d| � |�| g� q�|�| d | | d g� q�g �|D �]�} | d k�r%| \}} n$| dk�r/| }d} nz| \}}!} W n t�yH d}| d }!d} Y nw | du �r�| d k�rm|�rd||v �rd|�||f� �q|�||f� �q| dk�r{|�||f� �q|�||!f� �q| d k�rR| �d�} ||v �r�|� |g �}"tjjj| |"t| d�}#|#du �r���d�|| |"�r�d�|"�nd�� �q|#} t � dk�r�| du �r�| � d d �d } d }$z |� d d �\}%}&W n t�y� Y n w |&tjjj j v �r|&t!d! k�s | � dd��rd |& }$|%}d | v �r5|� |g �}"tjj"�#|"| �}'|'du�r!|'} n��d"�| ||"�r/d�|"�nd#�� �q| du �rD|� d$| � |$� �}(nd%�|| � d d �d |$�}(n|!}(|� |g �})|�r~|)�r~|)D ]}*tjj$j%| d&|*t| d'��rz|�||(f� n�qb�q|)�s�|�||(f� �q|)D ]}*tjj$j%| d(|*t| d'��r�|�||(f� n �q�|du�r�t&�'d)|��r�|�||(f� �q|�||(f� �q� ��fd*d+�}+zt(dd,��W n t)�y� g �t�*d-� Y nw g �t+j,����fd.d/��},g }-|,||-��^ |-�rQ| dk�r d0d1� |-D �}-d2g}.t � d3k�r|.�-d4d5g� |+|.� |.�| dk�r'd6nd7� t � d8k�r7|.�-d4d5g� |.�-|-� t.|.ddd9�}/|/d: dk�rQ��|/d; � W d � n 1 �s\w Y g }-|,||-��0 |-�r�d2g}.|+|.� |.�d<� |.�-|-� t.|.dd=�}/|/d: dk�r���|/d; � W d � n 1 �s�w Y g }-|,||-��0 |-�r�d2g}.|+|.� |.�d>� |.�-|-� t.|.dd=�}/|/d: dk�rш�|/d; � W d � n 1 �s�w Y t/�0d?d� � �s�t d|d �nt � }0tjj�1||0�}1|D ]!\}}2||1v�s ||v �r |1�2||� |d �|0� |d �d@�i� �q���r-��dA�d����� ��rAt dB�|�r8dCnd ��|1dD�dE��|1S )Ga� .. versionchanged:: 2015.8.12,2016.3.3,2016.11.0 On minions running systemd>=205, `systemd-run(1)`_ is now used to isolate commands which modify installed packages from the ``salt-minion`` daemon's control group. This is done to keep systemd from killing any yum/dnf commands spawned by Salt when the ``salt-minion`` service is restarted. (see ``KillMode`` in the `systemd.kill(5)`_ manpage for more information). If desired, usage of `systemd-run(1)`_ can be suppressed by setting a :mod:`config option <salt.modules.config.get>` called ``systemd.scope``, with a value of ``False`` (no quotes). .. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html .. _`systemd.kill(5)`: https://www.freedesktop.org/software/systemd/man/systemd.kill.html Install the passed package(s), add refresh=True to clean the yum database before package is installed. name The name of the package to be installed. Note that this parameter is ignored if either "pkgs" or "sources" is passed. Additionally, please note that this option can only be used to install packages from a software repository. To install a package file manually, use the "sources" option. 32-bit packages can be installed on 64-bit systems by appending the architecture designation (``.i686``, ``.i586``, etc.) to the end of the package name. CLI Example: .. code-block:: bash salt '*' pkg.install <package name> refresh Whether or not to update the yum database before executing. reinstall Specifying reinstall=True will use ``yum reinstall`` rather than ``yum install`` for requested packages that are already installed. If a version is specified with the requested package, then ``yum reinstall`` will only be used if the installed version matches the requested version. Works with ``sources`` when the package header of the source can be matched to the name and version of an installed package. .. versionadded:: 2014.7.0 skip_verify Skip the GPG verification check (e.g., ``--nogpgcheck``) downloadonly Only download the packages, do not install. version Install a specific version of the package, e.g. 1.2.3-4.el5. Ignored if "pkgs" or "sources" is passed. .. note:: Remember that versions that contain a single `.` will be interpreted as numbers and must be double-quoted. For example, version ``3006.10`` will be rendered as ``3006.1``. To pass ``3006.10`` you'll need to use double-quotes. ``version="'3006.10'"`` .. versionchanged:: 2018.3.0 version can now contain comparison operators (e.g. ``>1.2.3``, ``<=2.0``, etc.) update_holds : False If ``True``, and this function would update the package version, any packages held using the yum/dnf "versionlock" plugin will be unheld so that they can be updated. Otherwise, if this function attempts to update a held package, the held package(s) will be skipped and an error will be raised. .. versionadded:: 2016.11.0 setopt A comma-separated or Python list of key=value options. This list will be expanded and ``--setopt`` prepended to each in the yum/dnf command that is run. CLI Example: .. code-block:: bash salt '*' pkg.install foo setopt='obsoletes=0,plugins=0' .. versionadded:: 2019.2.0 Repository Options: fromrepo Specify a package repository (or repositories) from which to install. (e.g., ``yum --disablerepo='*' --enablerepo='somerepo'``) enablerepo (ignored if ``fromrepo`` is specified) Specify a disabled package repository (or repositories) to enable. (e.g., ``yum --enablerepo='somerepo'``) disablerepo (ignored if ``fromrepo`` is specified) Specify an enabled package repository (or repositories) to disable. (e.g., ``yum --disablerepo='somerepo'``) disableexcludes Disable exclude from main, for a repo or for everything. (e.g., ``yum --disableexcludes='main'``) .. versionadded:: 2014.7.0 ignore_epoch : False Only used when the version of a package is specified using a comparison operator (e.g. ``>4.1``). If set to ``True``, then the epoch will be ignored when comparing the currently-installed version to the desired version. .. versionadded:: 2018.3.0 Multiple Package Installation Options: pkgs A list of packages to install from a software repository. Must be passed as a python list. A specific version number can be specified by using a single-element dict representing the package and its version. CLI Examples: .. code-block:: bash salt '*' pkg.install pkgs='["foo", "bar"]' salt '*' pkg.install pkgs='["foo", {"bar": "1.2.3-4.el5"}]' sources A list of RPM packages to install. Must be passed as a list of dicts, with the keys being package names, and the values being the source URI or local path to the package. CLI Example: .. code-block:: bash salt '*' pkg.install sources='[{"foo": "salt://foo.rpm"}, {"bar": "salt://bar.rpm"}]' normalize : True Normalize the package name by removing the architecture. This is useful for poorly created packages which might include the architecture as an actual part of the name such as kernel modules which match a specific kernel version. .. code-block:: bash salt -G role:nsd pkg.install gpfs.gplbin-2.6.32-279.31.1.el6.x86_64 normalize=False .. versionadded:: 2014.7.0 split_arch : True If set to False it prevents package name normalization more strict way than ``normalize`` set to ``False`` does. .. versionadded:: 3006.0 diff_attr: If a list of package attributes is specified, returned value will contain them, eg.:: {'<package>': { 'old': { 'version': '<old-version>', 'arch': '<old-arch>'}, 'new': { 'version': '<new-version>', 'arch': '<new-arch>'}}} Valid attributes are: ``epoch``, ``version``, ``release``, ``arch``, ``install_date``, ``install_date_time_t``. If ``all`` is specified, all valid attributes will be returned. .. versionadded:: 2018.3.0 Returns a dict containing the new package names and versions:: {'<package>': {'old': '<old-version>', 'new': '<new-version>'}} If an attribute list in diff_attr is specified, the dict will also contain any specified attribute, eg.:: {'<package>': { 'old': { 'version': '<old-version>', 'arch': '<old-arch>'}, 'new': { 'version': '<new-version>', 'arch': '<new-arch>'}}} r^ N�pkg_resource.parse_targets� split_archT)�saltenv� normalize� diff_attrF)r� r� r� Z repositoryr� �<�>r� Zadvisoryz Advisory id "z " not foundr z�pkg.install: Unable to get rpm information for %s. Version comparisons will be unavailable, and return data may be inaccurate if reinstall=True.r] r r� )r� r� z9No version matching '{}{}' could be found (available: {})r� rE r' r( r� r r r` z?No version matching '{}' found for package '{}' (available: {})�noner0 �{}-{}{}z==)r� r� r� r� r� r� z^kernel(|-devel)$c s. | � �� �r | �d� � r| �d� dS dS )zI DRY function to add args common to all yum/dnf commands � --nogpgcheckz--downloadonlyN)rW rX )r[ )� downloadonlyr� � skip_verifyr r �_add_common_args� s �z!install.<locals>._add_common_args�r6 zAFailed to get holds, versionlock plugin is probably not installedc 3 s � i }| D ]\}}|�v r�r|||< q�� |� q|� |� q|s'dV dS t�dd�|�� zWz(t|�� �}t|d��� D ]\}}|d rO|� || � q?� � |� q?dV W n tyw } z� � d� d�|�|�� W Y d}~n d}~ww W t |d� dS W t |d� dS t |d� w )z� Temporarily unhold packages that need to be updated. Add any successfully-removed ones (and any packages not in the list of current holds) to the list of targets. NzUnholding packages: %sr� )�pkgs�resultz+Error encountered unholding packages {}: {}) rX r� �debugrK r� rk �unholdr r �format�hold) rJ r� Z to_unholdr� �pkgstrZ unhold_namesZ unheld_pkg�outcomer� )�errors�holds�unhold_prevented� update_holdsr r �_temporarily_unhold� s< � ������z$install.<locals>._temporarily_unholdc S r� )z --advisory=r )r �tr r r r � r� zinstall.<locals>.<listcomp>�-yr- z--bestz--allowerasing�installrT r. )r� �redirect_stderrr� r� Z downgrade)rZ � reinstallr� )�old�newz�The following package(s) could not be updated because they are being held: {}. Set 'update_holds' to True to temporarily unhold these packages so that they can be updated.z&Error occurred installing{} package(s)z /reinstalling�rR �changes�r� r )3r r� r� r r r� r� r� rV r r rv r! r rX r� � TypeErrorre r+ � list_patchesr� r� ri r Z match_versionr� rN rK r r! r4 rf r� r r Zfnmatch_multipler� r� r1 r7 � list_holdsr rL � contextlib�contextmanagerrW r\ rF r� � compare_dictsrT )3r] r� rG rJ �sourcesrF r[ r? rU r> r� rY � pkg_paramsZpkg_typer� r@ r\ Z old_as_listZ to_installZ to_downgradeZ to_reinstallZ _availableZ has_wildcardsZhas_comparisonr� r� Zpkg_params_itemsZ cur_patches� advisory_idZ pkg_sourceZrpm_infoZ pkg_item_listZ version_num�pkgpathZ candidates�targetra �namepart�archpartr7 rP Zcver�verrH rV r� r[ r� r] r$ �_r )rF rR rS r� rG rT rU r rY � s Z����� ��� ����� � �� � � �� � � � �� � � �� �� � �) � � � � � � �� ���� ��rY c K s� t � dv r |s dd� tjj�|�dg ��D �} | �d� | |d< tdddi|��} tjj� |�r7t di |�� t |d�} g } | sB|rlzt d d| |d |d �|��d } W n t yd } zt|��d }~ww | rl| �| � d dg}|�| � |r||�d� |r�|�|s�dnd� nt � dv r�|�|s�dnd� n |�|s�dnd� |�| � t|�}t�dd � t |d�}tjj�| |�}|d d kr�td||d�d��|S )a| Run a full system upgrade (a ``yum upgrade`` or ``dnf upgrade``), or upgrade specified packages. If the packages aren't installed, they will not be installed. .. versionchanged:: 2014.7.0 .. versionchanged:: 2015.8.12,2016.3.3,2016.11.0 On minions running systemd>=205, `systemd-run(1)`_ is now used to isolate commands which modify installed packages from the ``salt-minion`` daemon's control group. This is done to keep systemd from killing any yum/dnf commands spawned by Salt when the ``salt-minion`` service is restarted. (see ``KillMode`` in the `systemd.kill(5)`_ manpage for more information). If desired, usage of `systemd-run(1)`_ can be suppressed by setting a :mod:`config option <salt.modules.config.get>` called ``systemd.scope``, with a value of ``False`` (no quotes). .. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html .. _`systemd.kill(5)`: https://www.freedesktop.org/software/systemd/man/systemd.kill.html .. versionchanged:: 2019.2.0 Added ``obsoletes`` and ``minimal`` arguments Returns a dictionary containing the changes: .. code-block:: python {'<package>': {'old': '<old-version>', 'new': '<new-version>'}} CLI Example: .. code-block:: bash salt '*' pkg.upgrade salt '*' pkg.upgrade name=openssl Repository Options: fromrepo Specify a package repository (or repositories) from which to install. (e.g., ``yum --disablerepo='*' --enablerepo='somerepo'``) enablerepo (ignored if ``fromrepo`` is specified) Specify a disabled package repository (or repositories) to enable. (e.g., ``yum --enablerepo='somerepo'``) disablerepo (ignored if ``fromrepo`` is specified) Specify an enabled package repository (or repositories) to disable. (e.g., ``yum --disablerepo='somerepo'``) disableexcludes Disable exclude from main, for a repo or for everything. (e.g., ``yum --disableexcludes='main'``) .. versionadded:: 2014.7.0 name The name of the package to be upgraded. Note that this parameter is ignored if "pkgs" is passed. 32-bit packages can be upgraded on 64-bit systems by appending the architecture designation (``.i686``, ``.i586``, etc.) to the end of the package name. Warning: if you forget 'name=' and run pkg.upgrade openssl, ALL packages are upgraded. This will be addressed in next releases. CLI Example: .. code-block:: bash salt '*' pkg.upgrade name=openssl .. versionadded:: 2016.3.0 pkgs A list of packages to upgrade from a software repository. Must be passed as a python list. A specific version number can be specified by using a single-element dict representing the package and its version. If the package was not already installed on the system, it will not be installed. CLI Examples: .. code-block:: bash salt '*' pkg.upgrade pkgs='["foo", "bar"]' salt '*' pkg.upgrade pkgs='["foo", {"bar": "1.2.3-4.el5"}]' .. versionadded:: 2016.3.0 normalize : True Normalize the package name by removing the architecture. This is useful for poorly created packages which might include the architecture as an actual part of the name such as kernel modules which match a specific kernel version. .. code-block:: bash salt -G role:nsd pkg.upgrade gpfs.gplbin-2.6.32-279.31.1.el6.x86_64 normalize=False .. versionadded:: 2016.3.0 minimal : False Use upgrade-minimal instead of upgrade (e.g., ``yum upgrade-minimal``) Goes to the 'newest' package match which fixes a problem that affects your system. .. code-block:: bash salt '*' pkg.upgrade minimal=True .. versionadded:: 2019.2.0 obsoletes : True Controls whether yum/dnf should take obsoletes into account and remove them. If set to ``False`` yum will use ``update`` instead of ``upgrade`` and dnf will be run with ``--obsoletes=False`` .. code-block:: bash salt '*' pkg.upgrade obsoletes=False .. versionadded:: 2019.2.0 setopt A comma-separated or Python list of key=value options. This list will be expanded and ``--setopt`` prepended to each in the yum/dnf command that is run. .. versionadded:: 2019.2.0 diff_attr: If a list of package attributes is specified, returned value will contain them, eg.:: {'<package>': { 'old': { 'version': '<old-version>', 'arch': '<old-arch>'}, 'new': { 'version': '<new-version>', 'arch': '<new-arch>'}}} Valid attributes are: ``epoch``, ``version``, ``release``, ``arch``, ``install_date``, ``install_date_time_t``. If ``all`` is specified, all valid attributes will be returned. .. versionadded:: 3006.0 .. note:: To add extra arguments to the ``yum upgrade`` command, pass them as key word arguments. For arguments without assignments, pass ``True`` .. code-block:: bash salt '*' pkg.upgrade security=True exclude='kernel*' r, c S s g | ] }|� d �s|�qS )z obsoletes=�r� )r r� r r r r � s ��zupgrade.<locals>.<listcomp>r~ zobsoletes=Falser T)r� r< N)r] rJ rg r? r r� rX rE �upgradezupgrade-minimalrT zupdate-minimalr� r� z&Problem encountered upgrading packages)r_ rK r` r )r r r r# r� r� rX r� r� r� r� rv rV r r rW r\ rF rf )r] rJ r� rG r? �minimal� obsoletesr@ rY Z_setoptr� r\ r� rh r� r[ rK r] r$ r r r rq ( s^ ,� ����� �rq c K s t | ||||||fi |��S )aS .. versionadded:: 2019.2.0 Calls :py:func:`pkg.upgrade <salt.modules.yumpkg.upgrade>` with ``obsoletes=False``. Mirrors the CLI behavior of ``yum update``. See :py:func:`pkg.upgrade <salt.modules.yumpkg.upgrade>` for further documentation. CLI Example: .. code-block:: bash salt '*' pkg.update )rq )r] rJ r� rG r? rr rs rY r r r rT s ��rT c s� z t d | |�d �W n ty } zt|��d}~ww t� }g }i }t��D ]� d� v r<� �fdd�|D �}��� � q'��|� �D ]f}||vrKqD�| }||v r[|s[|�|� qD||v r�||| �d�v r�d} |} z | � d d �\} } W n t y Y nw | t j j jjv r�| td ks�|�d d �r�d | } | } |�d�| |�dd �d | �� qD|s�i S tddg| �} | d dkr�| d r�| d g}ng }t�dd� t� }t j j�||�}|r�td||d�d��|S )a .. versionchanged:: 2015.8.12,2016.3.3,2016.11.0 On minions running systemd>=205, `systemd-run(1)`_ is now used to isolate commands which modify installed packages from the ``salt-minion`` daemon's control group. This is done to keep systemd from killing any yum/dnf[5] commands spawned by Salt when the ``salt-minion`` service is restarted. (see ``KillMode`` in the `systemd.kill(5)`_ manpage for more information). If desired, usage of `systemd-run(1)`_ can be suppressed by setting a :mod:`config option <salt.modules.config.get>` called ``systemd.scope``, with a value of ``False`` (no quotes). .. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html .. _`systemd.kill(5)`: https://www.freedesktop.org/software/systemd/man/systemd.kill.html Remove packages name The name of the package to be removed Multiple Package Options: pkgs A list of packages to delete. Must be passed as a python list. The ``name`` parameter will be ignored if this option is passed. .. versionadded:: 0.16.0 split_arch : True If set to False it prevents package name normalization by removing arch. .. versionadded:: 3006.0 Returns a dict containing the changes. CLI Example: .. code-block:: bash salt '*' pkg.remove <package name> salt '*' pkg.remove <package1>,<package2>,<package3> salt '*' pkg.remove pkgs='["foo", "bar"]' r< r Nr� c s" i | ] }t � |� �r|�� �qS r r� r �Z pkg_paramrh r r r g s ��zremove.<locals>.<dictcomp>r� r r r( r` r= TrD r' r� rX �remover� r� r� z"Error occurred removing package(s)r^ r` )rV r r rv r� r� rT rX r! r4 re r r r rf r� r r rN r\ rF r� rf )r] rJ rY r� r\ r� Z pkg_matchesrk Zversion_to_removera r� rl rm r� rR r] r$ r rt r ru * sl .�� � � ��� �ru c K s t | |d�S )a� .. versionchanged:: 2015.8.12,2016.3.3,2016.11.0 On minions running systemd>=205, `systemd-run(1)`_ is now used to isolate commands which modify installed packages from the ``salt-minion`` daemon's control group. This is done to keep systemd from killing any yum/dnf[5] commands spawned by Salt when the ``salt-minion`` service is restarted. (see ``KillMode`` in the `systemd.kill(5)`_ manpage for more information). If desired, usage of `systemd-run(1)`_ can be suppressed by setting a :mod:`config option <salt.modules.config.get>` called ``systemd.scope``, with a value of ``False`` (no quotes). .. _`systemd-run(1)`: https://www.freedesktop.org/software/systemd/man/systemd-run.html .. _`systemd.kill(5)`: https://www.freedesktop.org/software/systemd/man/systemd.kill.html Package purges are not supported by yum, this function is identical to :mod:`pkg.remove <salt.modules.yumpkg.remove>`. name The name of the package to be purged Multiple Package Options: pkgs A list of packages to delete. Must be passed as a python list. The ``name`` parameter will be ignored if this option is passed. .. versionadded:: 0.16.0 Returns a dict containing the changes. CLI Example: .. code-block:: bash salt '*' pkg.purge <package name> salt '*' pkg.purge <package1>,<package2>,<package3> salt '*' pkg.purge pkgs='["foo", "bar"]' )r] rJ )ru )r] rJ rY r r r �purge� s *rv c K s� t � | s |s |s td��|r|rtd��g }|r |�|� n|r2|D ] }|�tt|�� ��� q#n|�| � tdd�}i }|D ]�} t| t �rOtt| �� ��} | i ddd�|| < | |vr�dt v rwt d rw|| j dd � d | � d �|| d < q@t d d| g�} | d dkr�|| j dd � d� | �|| d < d|| d d< d|| d d< q@d� | �|| d < q@|| j dd � d� | �|| d < q@|S )a� .. versionadded:: 2014.7.0 Version-lock packages .. note:: Requires the appropriate ``versionlock`` plugin package to be installed: - On RHEL 5: ``yum-versionlock`` - On RHEL 6 & 7: ``yum-plugin-versionlock`` - On Fedora: ``python-dnf-plugins-extras-versionlock`` 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"]' �0One of name, pkgs, or sources must be specified.�-Only one of pkgs or sources can be specified.FrI r �r] r_ rK �comment�testN�rK �Package z is set to be held.rz � versionlockr� r� r Tz Package {} is now being held.rO r_ r] r\ z!Package {} was unable to be held.z%Package {} is already set to be held.)rw r rW rX �next�iterrk rc r� r$ r rT r\ rN ) r] rJ rg r? rY r� r# � current_locksr$ rk r� r r r rO � sN " � ���rO c s� t � | s |s |s td��|r|rtd��g }|r |�|� n|r0|D ] }|�tt|��� q#n|�| � tt� dkd�}i }|D ]�� t� t �rPtt� � � ��� � i ddd�|� < t� dv rh� fd d �|D �}n � fd d �|D �}|r�t d r�|� j d d� d� � �|� d< qAtddg| �} | d dkr�|� j dd� d� � �|� d< d|� d d< d|� d d< qAd� � d �|� d< qA|� j dd� d� � d �|� d< qA|S ) a� .. versionadded:: 2014.7.0 Remove version locks .. note:: Requires the appropriate ``versionlock`` plugin package to be installed: - On RHEL 5: ``yum-versionlock`` - On RHEL 6 & 7: ``yum-plugin-versionlock`` - On Fedora: ``python-dnf-plugins-extras-versionlock`` 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"]' rw rx rE rI Fr ry r, c s g | ]}|� kr|�qS r r r �rk r r r c � zunhold.<locals>.<listcomp>c s4 g | ]}t � |d � � d ��r� t|dd�kr|�qS )r� FrI )r� r8 r r� r r r j s ��r{ Nr| z Package {} is set to be unheld.rz r~ �deleter� r Tz Package {} is no longer held.r_ r] rO r\ r} z was unable to be unheld.z is not being held.)rw r rW rX r r� rc r r� r$ rk r rT rN r\ ) r] rJ rg rY r� r# r� r$ Z search_locksr� r r� r rM & sZ � �� � ��rM c C sp t � t� dvr t|d�S td t� ddgdd�}g }tjj�|d�D ]}t|| |d �}|d ur5|� |� q#|S ) a( .. versionchanged:: 2015.5.10,2015.8.4,2016.3.0 Function renamed from ``pkg.get_locked_pkgs`` to ``pkg.list_holds``. .. note:: On dnf5 (and any newer dnf) systems, holds are read directly from ``/etc/dnf/versionlock.toml`` because ``versionlock list`` no longer emits the legacy text format. The ``pattern`` argument is ignored in that case. List information on locked packages .. note:: Requires the appropriate ``versionlock`` plugin package to be installed: - On RHEL 5: ``yum-versionlock`` - On RHEL 6 & 7: ``yum-plugin-versionlock`` - On Fedora: ``python-dnf-plugins-extras-versionlock`` pattern : \w+(?:[.-][^-]+)* Regular expression used to match the package name full : True Show the full hold definition including version and epoch. Set to ``False`` to return just the name of the package(s) being held. CLI Example: .. code-block:: bash salt '*' pkg.list_holds salt '*' pkg.list_holds full=False )rE r- rD rI r� r~ r� Fr� r )r5 r6 N) rw r �_list_holds_dnf5rV r r r r! r8 rX )r5 r6 r� r$ r% r7 r r r rc � s " �rc c C s� ddl m} ddlm m} z tjj�t�� }|� |�}W d � n1 s'w Y W n, t y> t � dt� g Y S |j yY } zt �dt|� g W Y d}~S d}~ww |�dg �pag }| s�t� }g }|D ]} | �d�} | rx| |v ryqk|�| � |�| � qk|S g } |D ]D} | �d�} | s�q�d} | �dg �p�g D ]} | �d�d kr�| �d �d kr�| �d �} nq�| du r�q�d | vr�d| } | �| � d| � d�� q�| S )ay Parse ``/etc/dnf/versionlock.toml`` to enumerate dnf5 version locks. dnf5's ``versionlock list`` writes a structured human-readable format rather than the legacy ``name-epoch:ver-rel.arch.*`` token that ``_get_hold`` expects, so we read the on-disk configuration directly via the salt TOML serializer (already a dependency of salt's RPM tooling). r Nz7dnf5 versionlock file %s is missing; no holds to reportz,Failed to parse dnf5 versionlock file %s: %s�packagesr] Z conditionsrm �evrZ comparatorr� rn r' z0:r0 z.*)Zsalt.serializers� serializersZsalt.serializers.tomlmod�tomlmodr r �files�fopen�_DNF5_VERSIONLOCK_PATHZ deserializer� r� rL ZDeserializationErrorr� r r� r� rX )r6 r� r� Zfp_r� r� rJ �seenr� r r] r$ r� Zcondr r r r� � sd �� ���� �r� �get_locked_packagesc O r� )a� .. versionadded:: 2014.1.0 Runs an rpm -Va on a system, and returns the results in a dict Pass options to modify rpm verify behavior using the ``verify_options`` keyword argument Files with an attribute of config, doc, ghost, license or readme in the package header can be ignored using the ``ignore_types`` keyword argument CLI Example: .. code-block:: bash salt '*' pkg.verify salt '*' pkg.verify httpd salt '*' pkg.verify 'httpd postfix' salt '*' pkg.verify 'httpd postfix' ignore_types=['config','doc'] salt '*' pkg.verify 'httpd postfix' verify_options=['nodeps','nosize'] z lowpkg.verifyr� r� r r r �verify s r� c C s� g g g g i d�} dddddd�}t d t� d d gd d d �}d}tjj�|d�D ]I}|�� }|dkr4 | S |�|�}|durD||krD|}q'|du rIq'|�� }|dkrY| | � |� q't � d|�}|rp|� � \}} || d�| | |< q'| S )z� .. versionadded:: 2014.1.0 Lists all groups known by yum on this system CLI Example: .. code-block:: bash salt '*' pkg.group_list )r� r� �installed environments�available environments�available languagesr� r� r� r� r� )zinstalled groups:zavailable groups:z installed environment groups:z available environment groups:zavailable language groups:�cmd.run_stdoutZ grouplistZhiddenrO F�rP rQ Nr Zdonez (.+) \[(.+)\])r] �language) rV r r r r r! r r r� rX r1 r7 �groups) r$ Z section_mapr� rm r% Zline_lcZsection_lookupr7 r] �langr r r � group_list sH � �� � �r� c K s� d}i }|D ]}t � ||< qtd#i dd� |�� D ���}t� dg| d| g }td |ddd �} i } tjj�| d �D ] } zd d � | �d �D �\} } | | | � � < W q: t yY Y q:w d| v rcd|d< nd| v rkd|d< | � d�pt| � d�|d< | � d�p�| � d�|d< |d s�|d s�t d| � d���| � dd�|d< |p�g }dd� |� d }|D ]�}d}tjj�| d �D ]z} | �� �tj�} t�|d | � � �}|r�|r� na|�d �|kr�d }q�|�r0|�r)|d dk�r)| r�| |v r�q�t�d | |� |�| � z td | d |d!�}W n t �y t| d |d!�}Y nw |D ]}|| �t || �� �qq�|| �| � q�q�|D ] }t|| �||< �q4|S )$a� .. versionadded:: 2014.1.0 .. versionchanged:: 2015.5.10,2015.8.4,2016.3.0,3001 The return data has changed. A new key ``type`` has been added to distinguish environment groups from package groups. Also, keys for the group name and group ID have been added. The ``mandatory packages``, ``optional packages``, and ``default packages`` keys have been renamed to ``mandatory``, ``optional``, and ``default`` for accuracy, as environment groups include other groups, and not packages. Finally, this function now properly identifies conditional packages. .. versionchanged:: 3006.2 Support for ``fromrepo``, ``enablerepo``, and ``disablerepo`` (as used in :py:func:`pkg.install <salt.modules.yumpkg.install>`) has been added. Lists packages belonging to a certain group name Name of the group to query expand : False If the specified group is an environment group, then the group will be expanded and the return data will include package names instead of group names. .. versionadded:: 2016.3.0 ignore_groups : None This parameter can be used to pass a list of groups to ignore when expanding subgroups. It is used during recursion in order to prevent expanding the same group multiple times. .. versionadded:: 3001 fromrepo Restrict ``yum groupinfo`` to the specified repo(s). (e.g., ``yum --disablerepo='*' --enablerepo='somerepo'``) .. versionadded:: 3006.2 enablerepo (ignored if ``fromrepo`` is specified) Specify a disabled package repository (or repositories) to enable. (e.g., ``yum --enablerepo='somerepo'``) .. versionadded:: 3006.2 disablerepo (ignored if ``fromrepo`` is specified) Specify an enabled package repository (or repositories) to disable. (e.g., ``yum --disablerepo='somerepo'``) .. versionadded:: 3006.2 CLI Example: .. code-block:: bash salt '*' pkg.group_info 'Perl Support' salt '*' pkg.group_info 'Perl Support' fromrepo=base,updates salt '*' pkg.group_info 'Perl Support' enablerepo=somerepo �� mandatory�optional�defaultZ conditionalc S s i | ] \}}|d v r||�qS ))rx r{ rz r )r rm �valr r r r � s �z group_info.<locals>.<dictcomp>r� Z groupinfor� rO Fr� r c s s � | ]}|� � V qd S r9 r� r r r r r� � r z group_info.<locals>.<genexpr>r' zenvironment group�typer3 z package groupzenvironment-idzgroup-id�idzGroup 'z ' not found� descriptionr r/ �|�)z (?:groups|packages):\s*$r( Tz'Adding group "%s" to completed list: %srb )�expand� ignore_groupsNr ) r� r� r r rV r r r r! r re r r rK r� ri �string� punctuationr1 r7 r3 r� rO rX � group_inforT r� r� )r] r� r� rY �pkgtypesr$ �pkgtyper� r[ r� Zg_infor% rm rn Zcompleted_groupsZpkgtypes_capturegroupZ target_foundr7 ZexpandedZp_typer r r r� V s� = �� � � � � ����r� c K s� d}i }|D ] }g g d�||< qt � }t| fddi|��}|D ]"}|�|g �D ]}||v r7|| d �|� q'|| d �|� q'q |S )a� .. versionadded:: 2014.1.0 .. versionchanged:: 2015.5.10,2015.8.4,2016.3.0 Environment groups are now supported. The key names have been renamed, similar to the changes made in :py:func:`pkg.group_info <salt.modules.yumpkg.group_info>`. .. versionchanged:: 3006.2 Support for ``fromrepo``, ``enablerepo``, and ``disablerepo`` (as used in :py:func:`pkg.install <salt.modules.yumpkg.install>`) has been added. Lists which of a group's packages are installed and which are not installed name The name of the group to check fromrepo Restrict ``yum groupinfo`` to the specified repo(s). (e.g., ``yum --disablerepo='*' --enablerepo='somerepo'``) .. versionadded:: 3006.2 enablerepo (ignored if ``fromrepo`` is specified) Specify a disabled package repository (or repositories) to enable. (e.g., ``yum --enablerepo='somerepo'``) .. versionadded:: 3006.2 disablerepo (ignored if ``fromrepo`` is specified) Specify an enabled package repository (or repositories) to disable. (e.g., ``yum --disablerepo='somerepo'``) .. versionadded:: 3006.2 CLI Example: .. code-block:: bash salt '*' pkg.group_diff 'Perl Support' salt '*' pkg.group_diff 'Perl Support' fromrepo=base,updates salt '*' pkg.group_diff 'Perl Support' enablerepo=somerepo r� )r� � not installedr� Tr� r� )rv r� r rX )r] rY r� r$ r� rJ Z group_pkgs�memberr r r � group_diff� s ,�r� r c s t | t�r | �d�n| }|std��t |t�std��t � t�r%� �d�� t � ttf�s0td��t |t�r:|�d�}t |ttf�sEtd��g }|D ] }t|�}|�|�dg �� |�� fdd�|�d g �D �� qI|rp|�|� d d� |D �}|s{i S t d d tt |��i|��S )a| .. versionadded:: 2014.1.0 Install the passed package group(s). This is basically a wrapper around :py:func:`pkg.install <salt.modules.yumpkg.install>`, which performs package group resolution for the user. This function is currently considered experimental, and should be expected to undergo changes. name Package group to install. To install more than one group, either use a comma-separated list or pass the value as a python list. CLI Examples: .. code-block:: bash salt '*' pkg.group_install 'Group 1' salt '*' pkg.group_install 'Group 1,Group 2' salt '*' pkg.group_install '["Group 1", "Group 2"]' skip Packages that would normally be installed by the package group ("default" packages), which should not be installed. Can be passed either as a comma-separated list or a python list. CLI Examples: .. code-block:: bash salt '*' pkg.group_install 'My Group' skip='foo,bar' salt '*' pkg.group_install 'My Group' skip='["foo", "bar"]' include Packages which are included in a group, which would not normally be installed by a ``yum groupinstall`` ("optional" packages). Note that this will not enforce group membership; if you include packages which are not members of the specified groups, they will still be installed. Can be passed either as a comma-separated list or a python list. CLI Examples: .. code-block:: bash salt '*' pkg.group_install 'My Group' include='foo,bar' salt '*' pkg.group_install 'My Group' include='["foo", "bar"]' .. note:: Because this is essentially a wrapper around pkg.install, any argument which can be passed to pkg.install may also be included here, and it will be passed along wholesale. r� zno groups specifiedz'groups' must be a listz'skip' must be a listz'include' must be a listr� c � g | ]}|� vr|�qS r r )r r ��skipr r r v r� z!group_install.<locals>.<listcomp>r� c S s g | ] }|t � vr|�qS r )rv r r r r r } s rJ Nr ) r� r� r! r r� �tupler� rW r rY r� ) r] r� �includerY r� r� r3 Z group_detailrJ r r� r � group_install* s4 4 � r� � groupinstallc K s� |� dd�}t| |�}i }t�d|� |D ]6}tj�|�s qt�|�D ]'}|� d|� �}|�d�s2q#t ||�d }|D ]} || } || d< | || < q;q#q|S )a� Lists all repos in <basedir> (default: all dirs in `reposdir` yum option). Strict parsing of configuration files is the default, this can be disabled using the ``strict_config`` keyword argument set to False CLI Example: .. code-block:: bash salt '*' pkg.list_repos salt '*' pkg.list_repos basedir=/path/to/dir salt '*' pkg.list_repos basedir=/path/to/dir,/path/to/another/dir strict_config=False r� TzSearching for repos in %sr) �.repor( r@ ) r r� r� rL r r: r; �listdir�endswith�_parse_repo_file) r� rY r� �basedirsr� Zbdir�repofileZrepopath� filereposr ry r r r r � s& �� r c K sn t |fi |��}| �d�rt| �} d}|D ] }|| kr!|| d }q|r5|�dd�}t||�d }|| S i S )a? Display a repo from <basedir> (default basedir: all dirs in ``reposdir`` yum option). CLI Examples: .. code-block:: bash salt '*' pkg.get_repo myrepo salt '*' pkg.get_repo myrepo basedir=/path/to/dir salt '*' pkg.get_repo myrepo basedir=/path/to/dir,/path/to/another/dir �copr:r r@ r� Tr( )r r� r+ r r� )ry r� rY r� r� Z list_repor� r� r r r �get_repo� s � r� c K s� | � d�r t| �} |�dd�}t||�}t|fi |��}| |vr(d| � d|� �S d}|D ] }|| kr8|| d }q,d}|D ]}|| krDq=|| d |krNd}q=|r_t�|� d |� d | � d �S t||�\} } | } | �� D ]Z} | | krsqld} d | | �� v r�t j j j � | | d �} | | d = | d | � d�7 } | | D ]#}| | | }t|t�r�d|v r�d�|�d��}| d|� d|� �7 } q�| d| � d�7 } qlt j j�|d��}|�t j j�| �� W d � n1 s�w Y d| � d|� �S )ac Delete a repo from <basedir> (default basedir: all dirs in `reposdir` yum option). If the .repo file in which the repo exists does not contain any other repo configuration, the file itself will be deleted. Strict parsing of configuration files is the default, this can be disabled using the ``strict_config`` keyword argument set to False CLI Examples: .. code-block:: bash salt '*' pkg.del_repo myrepo salt '*' pkg.del_repo myrepo basedir=/path/to/dir strict_config=False salt '*' pkg.del_repo myrepo basedir=/path/to/dir,/path/to/another/dir r� r� Tz Error: the z repo does not exist in r r@ FzFile z containing repo z has been removed�commentsz [�]r � r� �wNzRepo z has been removed from )r� r+ r r� r r ru r� rk r r r rf �combine_commentsr� r� rK r! r� r� �write� stringutils�to_str)ry r� rY r� r� r� r� ZarepoZonlyrepo�headerr� �content�stanzar� r% rn �fileoutr r r �del_repo� sX �� � �r� c s� � fdd�� D ��t �fdd�dD ��rtd��d}| �d�r-| �d d �d }t| �} d }g }t��D ]}�| d krG�| sG�|= |�|� q3d �v rR|�d� n d�v r[|�d � d|v rctd��i }� �dd �}t||�} t | fi � ��}d} d} i } | |v�rd} | D ] }t j � |�r�|} nq�| s�td� | ���| � d| � d�} |r�d}t� dv r�d}nd}td |�s�t|� d���td d |d g�}|d r�td � |t� |d |d! ���t | fi � ��}|| d" } t| |�\} } n1| � d| � d�} d�v�rtd#��d�v�rd �v�rtd$��i | | < n || d" } t| |�\} } d|v �r7d �v�r7d | | v�r7td%��d |v �rLd�v�rLd| | v�rLtd&��|D ]}|| | �� �� v �r`| | |= �qNd'd(� }| | ��� | }| �� D ]T}tjjj�| | �d)g ��}|d*|� d+�7 }| | �� D ].}| | | }t |t ��r�d,|v �r�d-� |�d,��}|d.� |t |t ��s�|n||��7 }�q�||d, 7 }�qstjj �!| d/��}|�"tjj#�$|�� W d � | | iS 1 �s�w Y | | iS )0a� Modify one or more values for a repo. If the repo does not exist, it will be created, so long as the following values are specified: repo name by which the yum refers to the repo name a human-readable name for the repo baseurl the URL for yum to reference mirrorlist the URL for yum to reference Key/Value pairs may also be removed from a repo's configuration by setting a key to a blank value. Bear in mind that a name cannot be deleted, and a baseurl can only be deleted if a mirrorlist is specified (or vice versa). Strict parsing of configuration files is the default, this can be disabled using the ``strict_config`` keyword argument set to False CLI Examples: .. code-block:: bash salt '*' pkg.mod_repo reponame enabled=1 gpgcheck=1 salt '*' pkg.mod_repo reponame basedir=/path/to/dir enabled=1 strict_config=False salt '*' pkg.mod_repo reponame baseurl= mirrorlist=http://host.com/ c s( i | ]}|� d �s|dvr|� | �qS )r� )r> rp r r� r r r 6 s �z mod_repo.<locals>.<dictcomp>c 3 s � | ]}|� v V qd S r9 r r )� repo_optsr r r� : r zmod_repo.<locals>.<genexpr>)� mirrorlist�baseurlz7Only one of 'mirrorlist' and 'baseurl' can be specifiedFr� r' r( Tr r� r� r] z The repo name cannot be deletedr� r NzhThe repo does not exist and needs to be created, but none of the following basedir directories exist: {}r) r� r, zdnf-plugins-corezyum-plugin-coprr� z must be installed to use COPRr* �enablerX r� z<Unable to add COPR '{}'. '{}' exited with status {!s}: '{}' r� r@ zIThe repo does not exist and needs to be created, but a name was not givenzgThe repo does not exist and needs to be created, but either a baseurl or a mirrorlist needs to be givenz3Cannot delete baseurl without specifying mirrorlistz3Cannot delete mirrorlist without specifying baseurlc S s | rdS dS )Nr� �0r )r r r r � _bool_to_str� s z mod_repo.<locals>._bool_to_strr� �[z] r r� z{}={} r� )%r� r r� r! r+ r� rX r r� r r r: r; rN r rV r\ r r� �copyrk rT r r r rf r� r� r� r� rK �boolr� r� r� r� r� )ry r� rY Zuse_coprZ copr_nameZtodeleterm r� r� r� r� r� r� Znewdirr� Zcopr_plugin_namer� r� r� r� r� r% rn r� r )rY r� r �mod_repo s� �� � �� ��� �� � � � � � ��r� c C s� t j|d�}i }z|�| � W n t jy. } zt�d| |j� di fW Y d}~S d}~ww |jD ]}t|j| �}|� dd� |||< q2d}d}t j j � | d��^}|D ]S} t j j�| �} | �� } | �d�r�|du rr|| d 7 }qUz|| �d g �} | �| d d� �� � W qU ty� t�d | | � Y qUw | �d �r�| �d �r�| d d� }qUW d � n1 s�w Y |t j j�|�fS )z- Turn a single repo file into a dict r� z"Failed to parse file %s, error: %sr Nr7 �r�#r r� r( zKFound comment in %s which does not appear to belong to any repo section: %sr� r� r� )r� r� r� ZMissingSectionHeaderErrorr� r� �messageZ _sectionsr$ r� r r r� r� r� Z to_unicoder� r� r� rX ri �KeyErrorrL r� r� �decode) r r� �parsedZconfig�err�sectionZ section_dict�headersr� r% r� r r r r� � sL �� �� �� �r� c O � t d | � S )ar .. versionadded:: 2014.1.0 List the files that belong to a package. Not specifying any packages will return a list of *every* file on the system's rpm database (not generally recommended). CLI Examples: .. code-block:: bash salt '*' pkg.file_list httpd salt '*' pkg.file_list httpd postfix salt '*' pkg.file_list zlowpkg.file_listr� �r� rY r r r � file_list� � r� c O r� )a� .. versionadded:: 2014.1.0 List the files that belong to a package, grouped by package. Not specifying any packages will return a list of *every* file on the system's rpm database (not generally recommended). CLI Examples: .. code-block:: bash salt '*' pkg.file_list httpd salt '*' pkg.file_list httpd postfix salt '*' pkg.file_list zlowpkg.file_dictr� r� r r r � file_dict r� r� c O sr | sdS i }g d�}| D ] }t d ||g ddd�||< d|| �� v r(d||< q t|�dkr7tt|�� ��S |S ) a� .. versionadded:: 2014.7.0 Return the name of the package that owns the file. Multiple file paths can be passed. Like :mod:`pkg.version <salt.modules.yumpkg.version>`, if a single path is passed, a string will be returned, and if multiple paths are passed, a dictionary of file/package name pairs will be returned. If the file is not owned by a package, or is not present on the minion, then an empty string will be returned for that path. CLI Examples: .. code-block:: bash salt '*' pkg.owner /usr/bin/apachectl salt '*' pkg.owner /usr/bin/apachectl /etc/httpd/conf/httpd.conf r )rf z-qfr� z%{name}r� rO Fr� z not ownedr( )rV r r� r r� rl )r� rY r$ r r: r r r �owner s �� r� c O r� )a� List the modified files that belong to a package. Not specifying any packages will return a list of _all_ modified files on the system's RPM database. .. versionadded:: 2015.5.0 Filtering by flags (True or False): size Include only files where size changed. mode Include only files which file's mode has been changed. checksum Include only files which MD5 checksum has been changed. device Include only files which major and minor numbers has been changed. symlink Include only files which are symbolic link contents. owner Include only files where owner has been changed. group Include only files where group has been changed. time Include only files where modification time of the file has been changed. capabilities Include only files where capabilities differ or not. Note: supported only on newer RPM versions. CLI Examples: .. code-block:: bash salt '*' pkg.modified salt '*' pkg.modified httpd salt '*' pkg.modified httpd postfix salt '*' pkg.modified httpd owner=True group=False zlowpkg.modifiedr� )r� �flagsr r r �modifiedA s 0r� c s� t jj�d�s td��| std��tj�dt� d�� tj� � �s%t� � � t� � �}g }| D ]�|� � �fdd�|D �� q.t |�D ](}t�d|� zt�|� W qB tyj } z t�d ||� W Y d }~qBd }~ww dd d � � �g}|� | � td |ddd� i �t� � �D ],}|�d�s�q�d }d } | D ]} |�| � d��r�| }|} nq�| d ur�tj�� | ��|< q��s�td�d�| �����fdd�| D �} | r�d�d�| ���d< �S )a� .. versionadded:: 2015.5.0 Download packages to the local disk. Requires ``yumdownloader`` from ``yum-utils`` or ``dnf-utils`` package. .. note:: ``yum-utils`` or ``dnf-utils`` will already be installed on the minion if the package was installed from the EPEL / Fedora repositories. CLI Example: .. code-block:: bash salt '*' pkg.download httpd salt '*' pkg.download httpd postfix Z yumdownloaderz%'yumdownloader' command not availablezNo packages were specifiedr r� c s* g | ]}|� �� d ��rtj�� |��qS )r0 )r� r r: rK r )r r r r r � s * z download.<locals>.<listcomp>zRemoving cached package %szUnable to remove %s: %sNz-qz --destdir=r� rO Fr� z.rpmr0 z4Unable to download any of the following packages: {}r� c r� r r r )r$ r r r � r� z/The following package(s) failed to download: {}�_error)r r r: �whichr r r rK r r; �makedirsr� rW r� r� rL �unlinkr� r� rV r� r� rN ) r� rY Z cached_pkgsZto_purgeZ purge_targetr� r[ Z dld_resultr% Zpkg_fileZ query_pkgZfailedr )r r r$ r �downloadt sf � �� �����r� c O s� i }i }| D ])}t d |�}|s tj�|�rdpd||< q|�|�du r(g ||< || �|� q|rWt d |�� � }|�� D ]\}}|D ]} t d || d | �pRd|| < qDq>|S ) a� Return a formatted diff between current files and original in a package. NOTE: this function includes all files (configuration and not), but does not work on binary content. :param path: Full path to the installed file :return: Difference string or raises and exception if examined file is binary. CLI Example: .. code-block:: bash salt '*' pkg.diff /etc/apache2/httpd.conf /etc/sudoers z lowpkg.ownerz Not managedzN/ANz pkg.downloadz lowpkg.diffr: Z Unchanged)rV r r: r; r rX rk r ) r� rY r$ Z pkg_to_pathsZpthZpth_pkgZ local_pkgsr r� r: r r r �diff� s$ ��r� c C s� i }t � ddddg}td |dd�}d}tjj�|tj�D ]B}zt� d|�� � \}}}} W n t y8 d }Y q w ||vrL|d krCd nd| gd �||< q || d � | � |d kr_d|| d < q |rkt �dd�|�� | rvdd� |�� D �}|S )z* List all known patches in repos. r� Z updateinfor� r� r� Fr� z'([i|\s])? ?([^\s]+) +([^\s]+) +([^\s]+)T�i)r� �summaryr� r� zVSkipped some unexpected output while running '%s' to list patches. Please check output� c S s i | ] \}}|d r||�qS )r� r )r �k�vr r r r s z _get_patches.<locals>.<dictcomp>)r rV r r r r! r �linesepr1 r7 r� r rX r� r� rK r ) �installed_onlyZpatchesr[ r$ Zparsing_errorsr% �instri Zsevr r r r � _get_patches� s> �� � � ��r� c K s | rt � t� S )a: .. versionadded:: 2017.7.0 List all known advisory patches from available repos. refresh force a refresh if set to True. If set to False (default) it depends on yum if a refresh is executed. CLI Examples: .. code-block:: bash salt '*' pkg.list_patches )r� r� )r� rY r r r rb s rb c K s t dd�S )z� .. versionadded:: 2017.7.0 List installed advisory patches on the system. CLI Examples: .. code-block:: bash salt '*' pkg.list_installed_patches T)r� )r� r� r r r �list_installed_patches$ s r� c K s� t � dvr td��tjj�t�std��t � dkr g d�}ng d�}td |dd �}|s.g S t� }|� d �D ] }|� d �\}}}|rRtjj� |� � �}|rR|� |� q6t|�S ) a .. versionadded:: 3003 List services that use files which have been changed by the package manager. It might be needed to restart them. Requires systemd. CLI Examples: .. code-block:: bash salt '*' pkg.services_need_restart r, z2dnf or dnf5 is required to list outdated services.z.systemd is required to list outdated services.r. )r. r� �needs-restarting)r- r� r� r� Fr� r r' )r r r r rU ZbootedrF rV r� r! � partitionZpid_to_servicer� r� r� ) rY r[ Z dnf_outputZservicesr% �pidZ has_delimro Zservicer r r �services_need_restart3 s* � �r� r9 )Tr3 r ) NFFNNFFTFr; F)NNTFTFTN)NNTFTFFr� )NNNT)NNN)FN)r r )e�__doc__r� rd r r� r �loggingr r1 r� Zsalt.utils.argsr Zsalt.utils.dataZsalt.utils.environmentZsalt.utils.filesZsalt.utils.functoolsZsalt.utils.itertoolsZsalt.utils.lazyZsalt.utils.pathZsalt.utils.pkgZsalt.utils.pkg.rpmZsalt.utils.systemdZsalt.utils.versionsZsalt.exceptionsr r r r � getLoggerr7 r� Z__HOLD_PATTERNr� r� r r r& r+ r8 r r\ ro ru rw r� r� r� r� r� r� r� r � functoolsZalias_functionr� r� r^ r� r� rv r r r r! r& r� r* ZlazyZLazyDictr+ rY rq rT ru rv rO rM rc r� r� r� r� r� r� r� r� r r� r� r� r� r� r� r� r� r� r� r� rb r� r� r r r r �<module> s ( & G 4 ~� Z ! $I � ` � g � w. � Xd 4A� 9 <Z # N 20"3I ' )
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings