Current File : //lib/python2.7/site-packages/salt/modules/dnsutil.pyc
�
���^c @@ sD d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l
Z d d l Z d d l m
Z
e j e � Z d � Z d d d � Z d d d d � Z d d d � Z d d d
� Z d � Z d � Z d
� Z d d � Z d d � Z e d d � Z d d d � Z e d d � Z d e d � Z! d S( u|
Compendium of generic DNS utilities.
.. note::
Some functions in the ``dnsutil`` execution module depend on ``dig``.
i ( t absolute_importt print_functiont unicode_literalsN( t sixc C@ s t S( u�
Generic, should work on any platform (including Windows). Functionality
which requires dependencies outside of Python do not belong in this module.
( t True( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt __virtual__ s u
/etc/hostsc C@ s� | s^ y@ t j j j | d � �" } t j j j | j � � } Wd QXWq^ t k
rZ d SXn i } xn | j � D]` } | s� qq n | j d � r� qq n | j
� } | d } | d } | j | g � j | � qq W| S( ur
Parse /etc/hosts file.
CLI Example:
.. code-block:: bash
salt '*' dnsutil.parse_hosts
u rNu Error: hosts data was not foundu #i i (
t saltt utilst filest fopent stringutilst
to_unicodet readt Exceptiont
splitlinest
startswitht splitt
setdefaultt extend( t hostsfilet hostst fp_t hostsdictt linet compst ipt aliases( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt parse_hosts s"
%
c C@ s� | j d � } t d | � } | | k r^ x1 | D]& } | | | k r1 | j | � q1 q1 Wn | sq d j | � Sd j | d j | � � } t j j j | d � �# } | j t j j
j | � � Wd QXd j | | � S( u�
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
u ,R u% No additional hosts were added to {0}u
{0} {1}u u aNu' The following line was added to {0}:{1}( R R t removet formatt joinR R R R t writeR
t to_str( R t ip_addrt entriest host_listR t hostt append_lineR ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt hosts_append? s
" c C@ sa t j j j | d � �" } t j j j | j � � } Wd QX| j d � } t j j j | d � �� } x� | j � D]� } | s� | j � j
d � r� | j t j j j d j
| � � � qs n | j � } x. | D]& } | | d k r� | j | � q� q� Wt | � d k rs | j t j j j d j | � � � | j t j j j d � � qs qs WWd QXd S(
u�
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
u rNu ,u wu #u {0}
i u u
( R R R R R
R R R R t stripR R R R R t lenR ( R R" R R R# t out_fileR R R$ ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt hosts_remove[ s
! %
%c C@ s� | r] y@ t j j j | d � �" } t j j j | j � � } Wd QXWq] t k
rY q] Xn | sg d Si } d } x]| j � D]O} | j d � } | d j
� } | s� q� n | j � } | j d � r� | d | | d j d d � <q� n d
| k rd | k rd } d } n | d k ro| d
j
| � 7} d | k r� d } | j d
d � j d d � } qoq� n d | k r�| j d | d � j � } n | j � } d | k r}| d d k r�| j d � n | d | d <| d | d <| d | d <| d j d d d � | d <| d | d <t | d � | d <t | d � | d <t | d � | d <t | d � | d! <q� n | d d k r�| j d | d � n | d j d � r�d" | k r�d# j
| d | d � | d <n | d$ d" k r| j d" g � j | d � q� | d$ d% k rfd% | k r�| j d% g � j i | d d& 6| d d' 6� q�q� | d d, k r�i | d d* 6| d d+ 6| j | d i � | d <q� | d | j | d$ i � | d <q� W| S(- u�
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
u rNu Error: Zone data was not foundu singleu ;i u $i u u (u )u multiu {0}u ORIGINu @u SOAu INu NETWORKi u SOURCEi u .u CONTACTi u SERIALi u REFRESHi u RETRYi u EXPIREi u MINTTLu NSu {0}.{1}i u MXu priorityu hostu Au AAAAu TARGETu TTL( u Au AAAA( R R R R R
R R R
R R R' R t replaceR t popt _to_secondst insertt endswithR t append( t zonefilet zoneR t zonedictt modeR R t multi( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt
parse_zonez sx
%
! ! )&c C@ s� | j � } d | k r7 t | j d d � � d } nj d | k rb t | j d d � � d } n? d | k rw d } n* y t | � } Wn t k
r� d } n X| d k r� d } n | S( u�
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).
u Hu i u Di�Q u Wi�: ( t uppert intR+ t
ValueError( t timestrt seconds( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyR- � s
c C@ s t j j j d � d k S( u�
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.
u digN( R R t patht whicht None( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt _has_dig� s c C@ s t � r t d | � Sd S( u�
Check that string ip_addr is a valid IP
CLI Example:
.. code-block:: bash
salt ns1 dnsutil.check_ip 127.0.0.1
u dig.check_ipu< This function requires dig, which is not currently available( R? t __salt__( R! ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt check_ip� s
c C@ s� t � r t d | | � S| d k r� yD g t j | d t j d t j � D] } | d d ^ qK } | SWq� t j k
r� d j | � SXn d S( u�
Return the A record(s) for ``host``.
Always returns a list.
CLI Example:
.. code-block:: bash
salt ns1 dnsutil.A www.google.com
u dig.Ai i u Unable to resolve {0}u< This function requires dig, which is not currently availableN( R? R@ R> t sockett getaddrinfot AF_INETt SOCK_RAWt gaierrorR ( R$ t
nameservert sockt addresses( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt A� s <c C@ s� t � r t d | | � S| d k r� yD g t j | d t j d t j � D] } | d d ^ qK } | SWq� t j k
r� d j | � SXn d S( u�
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
u dig.AAAAi i u Unable to resolve {0}u< This function requires dig, which is not currently availableN( R? R@ R> RB RC t AF_INET6RE RF R ( R$ RG RH RI ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt AAAA s <c C@ s! t � r t d | | | � Sd S( u�
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
u dig.NSu< This function requires dig, which is not currently available( R? R@ ( t domaint resolveRG ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt NS- s
u SPFc C@ s! t � r t d | | | � Sd S( u^
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
u dig.SPFu< This function requires dig, which is not currently available( R? R@ ( RM t recordRG ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt SPF@ s c C@ s! t � r t d | | | � Sd S( u
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
u dig.MXu< This function requires dig, which is not currently available( R? R@ ( RM RN RG ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt MXT s u c C@ s� i } d } | r( | d j | � 7} n t d d | � } t j d � } | sZ | pY | S| r� | | k r� t j t | � d � } n | } t d d | d | � | S( u#
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
u dnsserialu _{0}u
grains.gett keyu %Y%m%d01i u
grains.setvalt val( R R@ t timet strftimeR t text_typeR8 ( R2 t updatet grainsRS t storedt presentt current( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt serialk s
(" t __doc__t
__future__R R R t loggingRB RU t salt.utils.filesR t salt.utils.patht salt.utils.stringutilst salt.extR t getLoggert __name__t logR R> R R& R* R6 R- R? RA RJ RL R RO RQ t FalseRR R] ( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/dnsutil.pyt <module> s. N
Mini Shell