File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/__pycache__/win_system.cpython-310.pyc
Back
o ;j�9 � @ s� d Z ddlZddlZddlZz ddlZddlZdZW n ey% dZY nw e� e �Z dZ dZ dZdd � Zd d � Zd d � Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"d#� Z d$d%� Z dS )&zx Win System Utils Functions shared with salt.modules.win_system and salt.grains.pending_reboot .. versionadded:: 3001 � NTFZ win_systemz;SYSTEM\CurrentControlSet\Services\salt-minion\Volatile-DatazReboot requiredc C s t jj�� sdS ts dS tS )z' Only works on Windows systems )FzNwin_system salt util failed to load: The util will only run on Windows systems)�salt�utils�platformZ is_windows�HAS_WIN32_MODS�__virtualname__� r r �I/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/win_system.py� __virtual__" s r c C s t �tj�} | r | S dS )aZ Get the Windows computer name. Uses the win32api to get the current computer name. .. versionadded:: 3001 Returns: str: Returns the computer name if found. Otherwise returns ``False``. Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_computer_name() F)�win32apiZGetComputerNameEx�win32conZ ComputerNamePhysicalDnsHostname)�namer r r �get_computer_name5 s r c C sX t � } ztjjjdddd�d }W n ty Y dS w |r*|�� | �� kr(|S dS dS )a� Get a pending computer name. If the computer name has been changed, and the change is pending a system reboot, this function will return the pending computer name. Otherwise, ``None`` will be returned. If there was an error retrieving the pending computer name, ``False`` will be returned, and an error message will be logged to the minion log. .. versionadded:: 3001 Returns: str: Returns the pending name if pending restart. Returns ``None`` if not pending restart. Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_computer_name() �HKLMz2SYSTEM\CurrentControlSet\Services\Tcpip\Parametersz NV Hostname��hive�key�vname�vdataN)r r r �win_reg� read_value� TypeError�lower)�current�pendingr r r �get_pending_computer_nameJ s �� ��r c C �< d} d}|D ]}d� | |f�}tjjjd|d�r dS qdS )a� Determine whether there are pending Component Based Servicing tasks that require a reboot. If any the following registry keys exist then a reboot is pending: ``HKLM:\\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootPending`` ``HKLM:\\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootInProgress`` ``HKLM:\\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\PackagesPending`` .. versionadded:: 3001 Returns: bool: ``True`` if there are pending Component Based Servicing tasks, otherwise ``False`` CLI Example: .. code-block:: bash salt '*' system.get_pending_component_servicing zCSOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing)Z RebootPendingZRebootInProgressZPackagesPending�\r �r r TF��joinr r r Z key_exists�Zbase_keyZsub_keysZsub_keyr r r r � get_pending_component_servicingo s �r! c C r )a@ Determine whether there is a pending domain join action that requires a reboot. If any the following registry keys exist then a reboot is pending: ``HKLM:\\SYSTEM\CurrentControlSet\Services\Netlogon\AvoidSpnSet`` ``HKLM:\\SYSTEM\CurrentControlSet\Services\Netlogon\JoinDomain`` .. versionadded:: 3001 Returns: bool: ``True`` if there is a pending domain join action, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_domain_join() z*SYSTEM\CurrentControlSet\Services\Netlogon)Z AvoidSpnSetZ JoinDomainr r r TFr r r r r �get_pending_domain_join� s �r" c C sL d} d}| D ] }t jjjd||d�}|d r#|d r#|d dkr# dS qd S ) a� Determine whether there are pending file rename operations that require a reboot. A reboot is pending if any of the following value names exist and have value data set: - ``PendingFileRenameOperations`` - ``PendingFileRenameOperations2`` in the following registry key: ``HKLM:\\SYSTEM\CurrentControlSet\Control\Session Manager`` .. versionadded:: 3001 Returns: bool: ``True`` if there are pending file rename operations, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_file_rename() )ZPendingFileRenameOperationsZ PendingFileRenameOperations2z0SYSTEM\CurrentControlSet\Control\Session Managerr r �successr z(value not set)TF)r r r r )Zvnamesr r �reg_retr r r �get_pending_file_rename� s �r% c C sZ d} d}t jjjd|| d�}|d r+zt|d �dkr W dS W d S ty* Y d S w d S ) a@ Determine whether there are pending Server Manager tasks that require a reboot. A reboot is pending if the ``CurrentRebootAttempts`` value name exists and has an integer value. The value name resides in the following registry key: ``HKLM:\\SOFTWARE\Microsoft\ServerManager`` .. versionadded:: 3001 Returns: bool: ``True`` if there are pending Server Manager tasks, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_servermanager() ZCurrentRebootAttemptsz SOFTWARE\Microsoft\ServerManagerr r r# r r TF�r r r r �int� ValueError)r r r$ r r r �get_pending_servermanager� s � ��r) c C s t jjjdddd�S )a� Determine whether the DVD Reboot flag is set. The system requires a reboot if the ``DVDRebootSignal`` value name exists at the following registry location: ``HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce`` .. versionadded:: 3001 Returns: bool: ``True`` if the above condition is met, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_dvd_reboot() r z1SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnceZDVDRebootSignalr )r r r Z value_existsr r r r �get_pending_dvd_reboot s �r* c C r )ag Determine whether there are pending updates that require a reboot. If either of the following registry keys exists, a reboot is pending: ``HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired`` ``HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\PostRebootReporting`` .. versionadded:: 3001 Returns: bool: ``True`` if any of the above conditions are met, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_update() zCSOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update)ZRebootRequiredZPostRebootReportingr r r TFr r r r r �get_pending_update s ��r+ c C s t jjjdttd�} | d dkS )a> Determine if at any time during the current boot session the salt minion witnessed an event indicating that a reboot is required. This function will return ``True`` if an install completed with exit code 3010 during the current boot session and can be extended where appropriate in the future. If the ``Reboot required`` value name exists in the following location and has a value of ``1`` then the system is pending reboot: ``HKLM:\\SYSTEM\CurrentControlSet\Services\salt-minion\Volatile-Data`` .. versionadded:: 3001 Returns: bool: ``True`` if the ``Requires reboot`` registry flag is set to ``1``, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_reboot_required_witnessed() r r r � )r r r r �MINION_VOLATILE_KEY�REBOOT_REQUIRED_NAME)Z value_dictr r r � get_reboot_required_witnessedB s � r/ c C s t jjjdtdtddd�S )a� This function is used to remember that an event indicating that a reboot is required was witnessed. This function relies on the salt-minion's ability to create the following volatile registry key in the *HKLM* hive: *SYSTEM\CurrentControlSet\Services\salt-minion\Volatile-Data* Because this registry key is volatile, it will not persist beyond the current boot session. Also, in the scope of this key, the name *'Reboot required'* will be assigned the value of *1*. For the time being, this function is being used whenever an install completes with exit code 3010 and can be extended where appropriate in the future. .. versionadded:: 3001 Returns: bool: ``True`` if successful, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.set_reboot_required_witnessed() r Tr, Z REG_DWORD)r r Zvolatiler r Zvtype)r r r Z set_valuer- r. r r r r � set_reboot_required_witnessedd s �r0 c C sV d} t jjjd| dd�}|d r)zt|d �dkr W dS W d S ty( Y d S w d S ) a� Determine whether there is a volatile update exe that requires a reboot. Checks ``HKLM:\Microsoft\Updates``. If the ``UpdateExeVolatile`` value name is anything other than 0 there is a reboot pending .. versionadded:: 3001 Returns: bool: ``True`` if there is a volatile exe, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_update_exe_volatile() zSOFTWARE\Microsoft\Updatesr ZUpdateExeVolatiler r# r r TFr& )r r$ r r r � get_pending_update_exe_volatile� s �� ��r1 c C s t jj�� S )a� Check the Windows Update system for a pending reboot state. This leverages the Windows Update System to determine if the system is pending a reboot. .. versionadded:: 3001 Returns: bool: ``True`` if the Windows Update system reports a pending update, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_windows_update() )r r Z win_updateZ needs_rebootr r r r �get_pending_windows_update� s r2 c C s2 t ttttttttt f } | D ]}|� r dS qdS )a/ Determine whether there is a reboot pending. .. versionadded:: 3001 Returns: bool: ``True`` if the system is pending reboot, otherwise ``False`` Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_reboot() TF) r+ r2 r1 r% r) r! r* r/ r r" )Zchecks�checkr r r �get_pending_reboot� s � �r4 c C s2 t � t� dut� t� t� t� t� t� t� t � d� S )a� Determine which check is signalling that the system is pending a reboot. Useful in determining why your system is signalling that it needs a reboot. .. versionadded:: 3001 Returns: dict: A dictionary of the results of each function that checks for a pending reboot Example: .. code-block:: python import salt.utils.win_system salt.utils.win_system.get_pending_reboot_details() N) zPending Component ServicingzPending Computer RenamezPending DVD RebootzPending File RenamezPending Join DomainzPending ServerManagerzPending UpdatezPending Windows UpdatezReboot Required WitnessedzVolatile Update Exe) r! r r* r% r" r) r+ r2 r/ r1 r r r r �get_pending_reboot_details� s �r5 ) �__doc__�loggingZsalt.utils.win_regr Zsalt.utils.win_updater r r � ImportError� getLogger�__name__�logr r- r. r r r r! r" r% r) r* r+ r/ r0 r1 r2 r4 r5 r r r r �<module> s< � %"#&( #"& %
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings