File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/dnsutil.cpython-310.pyc
Back
o ;j�- � @ s� d Z ddlZddlZddlZddlZddlZddlZe�e �Z dd� Z d#dd�Z d$dd �Z d#d d �Zd%d d �Zdd� Zdd� Zdd� Zd&dd�Zd&dd�Zd'dd�Zd(d d�Zd)d d �Zd*d!d"�ZdS )+z| Compendium of generic DNS utilities. .. note:: Some functions in the ``dnsutil`` execution module depend on ``dig``. � Nc C s dS )z� Generic, should work on any platform (including Windows). Functionality which requires dependencies outside of Python do not belong in this module. T� r r r �H/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/dnsutil.py� __virtual__ s r � /etc/hostsc C s� |s0z#t jj�| d��}t jj�|�� �}W d � n1 s w Y W n ty/ Y dS w i }|�� D ]"}|s;q6|� d�rAq6|� � }|d }|dd� }|� |g �� |� q6|S )zr Parse /etc/hosts file. CLI Example: .. code-block:: bash salt '*' dnsutil.parse_hosts �rNz Error: hosts data was not found�#r � ) �salt�utils�files�fopen� stringutils� to_unicode�read� Exception� splitlines� startswith�split� setdefault�extend)� hostsfile�hosts�fp_Z hostsdict�line�comps�ip�aliasesr r r � parse_hosts s( �� � r c C s� |� d�}t| d�}||v r |D ] }||| v r |�|� q|s%d| � �S d�|d�|��}tjj�| d��}|� tjj � |�� W d � n1 sKw Y d| � d |� �S ) z� Append a single line to the /etc/hosts file. CLI Example: .. code-block:: bash salt '*' dnsutil.hosts_append /etc/hosts 127.0.0.1 ad1.yuk.co,ad2.yuk.co �,)r z"No additional hosts were added to z {} {}� �aNz The following line was added to �:) r r �remove�format�joinr r r r �writer �to_str)r �ip_addr�entries� host_listr �hostZ append_liner r r r � hosts_append; s � �r+ c C s$ t jj�| d��}t jj�|�� �}W d � n1 s w Y |�d�}t jj�| d��Z}|�� D ]L}|r>|� � � d�rL|� t jj� |� d��� q3|�� }|D ]}||dd� v ra|� |� qRt|�dkr|� t jj� d�|��� |� t jj� d�� q3W d � dS 1 s�w Y dS ) a� Remove a host from the /etc/hosts file. If doing so will leave a line containing only an IP address, then the line will be deleted. This function will leave comments and blank lines intact. CLI Examples: .. code-block:: bash salt '*' dnsutil.hosts_remove /etc/hosts ad1.yuk.co salt '*' dnsutil.hosts_remove /etc/hosts ad2.yuk.co,ad1.yuk.co r Nr �wr � r r )r r r r r r r r r �stripr r% r& r" �lenr$ ) r r( r r r) �out_filer r r* r r r � hosts_removeV s( � � ��"�r1 c C s� | r/z#t jj�| d��}t jj�|�� �}W d � n1 s w Y W n ty. Y nw |s3dS i }d}|�� D �]5}|� d�}|d � � }|sLq;|� � }|� d�rb|d ||d � dd �< q;d |v rnd |vrnd }d }|d kr�|d |� �7 }d |v r�d}|� d d �� d d �}nq;d|v r�|� d|d �� � }n|� � }d|v r�|d dkr�|� d� |d |d< |d |d< |d |d< |d � ddd�|d< |d |d< t|d �|d< t|d �|d < t|d �|d < t|d �|d!< q;|d dkr�|�d|d � |d �d��sd"|v�rd#�|d |d �|d< |d$ d"k�r+|�d"g ��|d � q;|d$ d%k�rHd%|v�rG|�d%g ��|d |d d&�� q;|d d'v �rc|d |d d(�|�|d i �|d < q;|d |�|d$ i �|d < q;|S ))z� Parses a zone file. Can be passed raw zone data on the API level. CLI Example: .. code-block:: bash salt ns1 dnsutil.parse_zone /var/lib/named/example.com.zone r Nz Error: Zone data was not foundZsingle�;r �$r � �(�)�multir ZORIGIN�@ZSOA�INZNETWORK� ZSOURCE� �.ZCONTACT� ZSERIAL� ZREFRESH� ZRETRY� ZEXPIRE� ZMINTTL�NSz{}.{}� �MX)�priorityr* )�A�AAAA)�TARGETZTTL)r r r r r r r r r r r. r �replace�pop� _to_seconds�insert�endswithr# r �append)Zzonefile�zoner Zzonedict�moder r r7 r r r � parse_zoneu s� �� � �� � rQ c C s� | � � } d| v rt| �dd��d }n(d| v r"t| �dd��d }nd| v r)d}nzt| �}W n ty: d}Y nw |dkrAd}|S )z� Converts a time value to seconds. As per RFC1035 (page 45), max time is 1 week, so anything longer (or unreadable) will be set to one week (604800 seconds). �Hr4 i �Di�Q �Wi�: )�upper�intrI � ValueError)Ztimestr�secondsr r r rK � s �rK c C s t jj�d�duS )z� The dig-specific functions have been moved into their own module, but because they are also DNS utilities, a compatibility layer exists. This function helps add that layer. �digN)r r �path�whichr r r r �_has_dig� s r\ c C s t � r td | �S dS )z� Check that string ip_addr is a valid IP CLI Example: .. code-block:: bash salt ns1 dnsutil.check_ip 127.0.0.1 z dig.check_ip�<This function requires dig, which is not currently available�r\ �__salt__)r' r r r �check_ip� s r` c C �f t � r td | |�S |du r1zdd� t�| dtjdtj�D �}|W S tjy0 d| � � Y S w dS )z� Return the A record(s) for ``host``. Always returns a list. CLI Example: .. code-block:: bash salt ns1 dnsutil.A www.google.com zdig.ANc S � g | ]}|d d �qS �r; r r ��.0�sockr r r � <listcomp> � ��zA.<locals>.<listcomp>r �Unable to resolve r] )r\ r_ �socket� getaddrinfo�AF_INET�SOCK_RAW�gaierror�r* � nameserver� addressesr r r rF � s ���rF c C ra )z� Return the AAAA record(s) for ``host``. Always returns a list. .. versionadded:: 2014.7.5 CLI Example: .. code-block:: bash salt ns1 dnsutil.AAAA www.google.com zdig.AAAANc S rb rc r rd r r r rg & rh zAAAA.<locals>.<listcomp>r ri r] )r\ r_ rj rk �AF_INET6rm rn ro r r r rG s ���rG Tc C � t � r td | ||�S dS )z� Return a list of IPs of the nameservers for ``domain`` If 'resolve' is False, don't resolve names. CLI Example: .. code-block:: bash salt ns1 dnsutil.NS google.com zdig.NSr] r^ ��domain�resolverp r r r rB 3 s rB �SPFc C rs )a^ Return the allowed IPv4 ranges in the SPF record for ``domain``. If record is ``SPF`` and the SPF record is empty, the TXT record will be searched automatically. If you know the domain uses TXT and not SPF, specifying that will save a lookup. CLI Example: .. code-block:: bash salt ns1 dnsutil.SPF google.com zdig.SPFr] r^ )ru �recordrp r r r rw F s Fc C rs )a Return a list of lists for the MX of ``domain``. If the 'resolve' argument is True, resolve IPs for the servers. It's limited to one IP, because although in practice it's very rarely a round robin, it is an acceptable configuration and pulling just one IP lets the data be similar to the non-resolved version. If you think an MX has multiple IPs, don't use the resolver here, resolve them in a separate step. CLI Example: .. code-block:: bash salt ns1 dnsutil.MX google.com zdig.MXr] r^ rt r r r rD Z s rD r4 c C st i }d}| r |d| � �7 }t d |d�}t�d�}|s |p |S |r.||kr.tt|�d �}n|}t d ||d� |S ) a# Return, store and update a dns serial for your zone files. zone: a keyword for a specific zone update: store an updated version of the serial in a grain If ``update`` is False, the function will retrieve an existing serial or return the current date if no serial is stored. Nothing will be stored If ``update`` is True, the function will set the serial to the current date if none exist or if the existing serial is for a previous date. If a serial for greater than the current date is already stored, the function will increment it. This module stores the serial in a grain, you can explicitly set the stored value as a grain named ``dnsserial_<zone_name>``. CLI Example: .. code-block:: bash salt ns1 dnsutil.serial example.com Z dnsserial�_z grains.get)�keyz%Y%m%d01r z grains.setval)rz �val)r_ �time�strftime�strrV )rO �updateZgrainsrz ZstoredZpresent�currentr r r �serialq s r� )r N)r NN)NN)N)TN)rw N)FN)r4 F)�__doc__�loggingrj r| Zsalt.utils.filesr Zsalt.utils.pathZsalt.utils.stringutils� getLogger�__name__�logr r r+ r1 rQ rK r\ r` rF rG rB rw rD r� r r r r �<module> s, O
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings