o

�N�g��@s$dZd
d�Z
d	dd�
Zd
dd�
ZdS)av
Dynamic DNS updates
===================

Ensure a DNS record is present or absent utilizing RFC 2136
type dynamic updates.

:depends: - `dnspython <http://www.dnspython.org/>`_

.. note::
    The ``dnspython`` module is required when managing DDNS using a TSIG key.
    If you are not using a TSIG key, DDNS is allowed by ACLs based on IP
    address and the ``dnspython`` module is not required.

Example:

.. code-block:: yaml

    webserver:
      ddns.present:
        - zone: example.com
        - ttl: 60
        - data: 111.222.333.444
        - nameserver: 123.234.345.456
        - keyfile: /srv/salt/dnspy_tsig_key.txt
cCsd
tvrdSdS)N�ddns.updateZddns)Fzddns module could not be loaded)
�__salt__�rr�D/opt/saltstack/salt/lib/python3.10/site-packages/salt/states/ddns.py�__virtual__s


r�
AcKs�|id
dd�}tdrd|d<|�d|�d�|d	<|St
d
|
||||fi|�
�
}|dur<d|d<d�|||�|d	<|S|rYd|d<d
|�d|�d�|d	<||
|||d�|d<|Sd
|d<d�||�|d	<|S)uW
    Ensures that the named DNS record is present with the given ttl.

    name
        The host portion of the DNS record, e.g., 'webserver'. Name and zone
        are concatenated when the entry is created unless name includes a
        trailing dot, so make sure that information is not duplicated in these
        two arguments.

    zone
        The zone to check/update

    ttl
        TTL for the record

    data
        Data for the DNS record. E.g., the IP address for an A record.

    rdtype
        DNS resource type. Default 'A'.

    ``**kwargs``
        Additional arguments the ddns.update function may need (e.g.
        nameserver, keyfile, keyname).  Note that the nsupdate key file can’t
        be reused by this function, the keyfile and other arguments must
        follow the `dnspython <http://www.dnspython.org/>`_ spec.
    F���name�changes�result�comment�testNr�	 record "z" will be updatedrr
Tz-{} record "{}" already present with ttl of {}zUpdated z
 record for "�
")r	�zone�ttl�rdtype�datar
z-Failed to create or update {} record for "{}")�__opts__r�format)r	rrrr�kwargs�ret�statusrrr�present#s6





��






��

�rNcKs�|id
dd�}tdrd|d<|�d|�d�|d	<|St
d
|
|||fi|�
�
}|dur6d|d<d|d	<|S|rKd|d<d
|d	<d||
d�i
|d<|Sd
|d<d|d	<|S)u�
    Ensures that the named DNS record is absent.

    name
        The host portion of the DNS record, e.g., 'webserver'. Name and zone
        are concatenated when the entry is created unless name includes a
        trailing dot, so make sure that information is not duplicated in these
        two arguments.

    zone
        The zone to check

    data
        Data for the DNS record. E.g., the IP address for an A record. If omitted,
        all records matching name (and rdtype, if provided) will be purged.

    rdtype
        DNS resource type. If omitted, all types will be purged.

    ``**kwargs``
        Additional arguments the ddns.update function may need (e.g.
        nameserver, keyfile, keyname).  Note that the nsupdate key file can’t
        be reused by this function, the keyfile and other arguments must
        follow the `dnspython <http://www.dnspython.org/>`_ spec.
    Frrr
Nrrz" will be deletedrzddns.deleteTz!No matching DNS record(s) presentzDeleted DNS record(s)ZDeleted)r	rr
zFailed to delete DNS record(s))rr)r	rrrrrrrrr�absent_s$




�


�

r)
r)NN)�__doc__rrrrrrr�<module>
s
<