o

�N�g��@sFdZd
dl
Z
e
�e�
Zdd�Zdd�Zd
dd�
Zd
d	d
�
Zdd�Z	dS)a
Manage kernel packages and active kernel version
=========================================================================

Example state to install the latest kernel from package repositories:

.. code-block:: yaml

    install-latest-kernel:
      kernelpkg.latest_installed: []

Example state to boot the system if a new kernel has been installed:

.. code-block:: yaml

    boot-latest-kernel:
      kernelpkg.latest_active:
        - at_time: 1

Example state chaining the install and reboot operations:

.. code-block:: yaml

    install-latest-kernel:
      kernelpkg.latest_installed: []

    boot-latest-kernel:
      kernelpkg.latest_active:
        - at_time: 1
        - onchanges:
          - kernelpkg: install-latest-kernel

Chaining can also be achieved using wait/listen requisites:

.. code-block:: yaml

    install-latest-kernel:
      kernelpkg.latest_installed: []

    boot-latest-kernel:
      kernelpkg.latest_wait:
        - at_time: 1
        - listen:
          - kernelpkg: install-latest-kernel
�NcCsd
tvrdSdS)zt
    Only make these states available if a kernelpkg provider has been detected or
    assigned for this minion
    �kernelpkg.upgradeT)Fz$kernelpkg module could not be loaded)
�__salt__�rr�I/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/kernelpkg.py�__virtual__4s

rc
Ks�td
�}td�}d|i
}||vr#d|d<d�
|�
|d<i|d<|Std	r8d
|d<i|d<d�
|�
|d<|Std�}d|d<|d
|d<d|d<|S)a8
    Ensure that the latest version of the kernel available in the
    repositories is installed.

    .. note::

        This state only installs the kernel, but does not activate it.
        The new kernel should become active at the next reboot.
        See :py:func:`kernelpkg.needs_reboot <salt.modules.kernelpkg_linux_yum.needs_reboot>` for details on
        how to detect this condition, and :py:func:`~salt.states.kernelpkg.latest_active`
        to initiale a reboot when needed.

    name
        Arbitrary name for the state. Does not affect behavior.
    zkernelpkg.list_installedzkernelpkg.latest_available�nameT�resultz2The latest kernel package is already installed: {}�comment�changes�testNz/The latest kernel package will be installed: {}rZupgradesz@The latest kernel package has been installed, but not activated.�r�formatZ__opts__)r�kwargsZ	installed�upgrade�retrrrr�latest_installed>s.






��



�
�

�rcKs�td
�}td�}d|i
}td�rCd�
|�
|d<tdr-d|d	<d
||d�i
|d<|Std
|
d�

d|d	<d
||d�i
|d<|Sd|d	<d�
|�
|d<i|d<|S)a
    Initiate a reboot if the running kernel is not the latest one installed.

    .. note::

        This state does not install any patches. It only compares the running
        kernel version number to other kernel versions also installed in the
        system. If the running version is not the latest one installed, this
        state will reboot the system.

        See :py:func:`kernelpkg.upgrade <salt.modules.kernelpkg_linux_yum.upgrade>` and
        :py:func:`~salt.states.kernelpkg.latest_installed`
        for ways to install new kernel packages.

        This module does not attempt to understand or manage boot loader configurations
        it is possible to have a new kernel installed, but a boot loader configuration
        that will never activate it. For this reason, it would not be advisable to
        schedule this state to run automatically.

        Because this state function may cause the system to reboot, it may be preferable
        to move it to the very end of the state run.
        See :py:func:`~salt.states.kernelpkg.latest_wait`
        for a waitable state that can be called with the `listen` requesite.

    name
        Arbitrary name for the state. Does not affect behavior.

    at_time
        The wait time in minutes before the system will be rebooted.
    zkernelpkg.activezkernelpkg.latest_installedrzkernelpkg.needs_rebootz0The system will be booted to activate kernel: {}r	rNrZkernel)�old�newr
z
system.reboot)
�at_timeTz1The latest installed kernel package is active: {}r)rrrZactiveZlatestrrrr�
latest_activems*





�

�

	�

�rcKs|id
dd�S)a}
    Initiate a reboot if the running kernel is not the latest one installed. This is the
    waitable version of :py:func:`~salt.states.kernelpkg.latest_active` and
    will not take any action unless triggered by a watch or listen requesite.

    .. note::

        Because this state function may cause the system to reboot, it may be preferable
        to move it to the very end of the state run using `listen` or `listen_in` requisites.

        .. code-block:: yaml

            system-up-to-date:
              pkg.uptodate:
                - refresh: true

            boot-latest-kernel:
              kernelpkg.latest_wait:
                - at_time: 1
                - listen:
                  - pkg: system-up-to-date

    name
        Arbitrary name for the state. Does not affect behavior.

    at_time
        The wait time in minutes before the system will be rebooted.
    T�)rr
rr	r)rrrrrr�latest_wait�srcKs,|
d
vrt|f
i|�
�
S|id�
|
�
dd�S)zC
    Execute a kernelpkg state based on a watch or listen call
    )rrz4kernelpkg.{} does not work with the watch requisite.F)rr
r	r)rr
)rZsfunrrrr�	mod_watch�s



��r)
N)
�__doc__�logging�	getLogger�__name__�logrrrrrrrrr�<module>
s.


/
<