
    f              
           U d Z ddlZddlmZ ddlmZmZ ddlmZ ddl	m
Z
 ddlmZmZ ddlmZ  ej                   e      Zd	d
dZdZdddeg de ed      gdgdZeed<    ee      Z d Zdede
dededdf
dZy)z"Resolv Conf: configure resolv.conf    N)dedent)	templaterutil)Cloud)Config)
MetaSchemaget_meta_doc)PER_INSTANCEzresolv.confzsystemd.resolved.conf)z/etc/resolv.confz/etc/systemd/resolved.confa  Unless manually editing :file:`/etc/resolv.conf` is the correct way to manage
nameserver information on your operating system, you do not want to use
this module. Many distros have moved away from manually editing ``resolv.conf``
so please verify that this is the preferred nameserver management method for
your distro before using this module.

Note that using :ref:`network_config` is preferred, rather than using this
module, when possible.

This module is intended to manage resolv.conf in environments where early
configuration of resolv.conf is necessary for further bootstrapping and/or
where configuration management such as puppet or chef own DNS configuration.

When using a :ref:`datasource_config_drive` and a RHEL-like system,
resolv.conf will also be managed automatically due to the available
information provided for DNS servers in the :ref:`network_config_v2` format.
For those that wish to have different settings, use this module.

In order for the ``resolv_conf`` section to be applied, ``manage_resolv_conf``
must be set ``true``.

.. note::
    For Red Hat with sysconfig, be sure to set PEERDNS=no for all DHCP
    enabled NICs.
cc_resolv_confzResolv ConfzConfigure resolv.conf)alpinefedoramarineropensusezopensuse-leapzopensuse-microoszopensuse-tumbleweedphotonrhelsle_hpcz	sle-microsles	openeulera              manage_resolv_conf: true
            resolv_conf:
              nameservers:
                - 8.8.8.8
                - 8.8.4.4
              searchdomains:
                - foo.example.com
                - bar.example.com
              domain: example.com
              sortlist:
                - 10.0.0.1/255
                - 10.0.0.2
              options:
                rotate: true
                timeout: 1
            manage_resolv_conf)idnametitledescriptiondistros	frequencyexamplesactivate_by_schema_keysmetac                 f   g }g }d|v rQ|d   j                         D ];  \  }}t        |t              s|r|j                  |       +|j                  |       = ||z   D ]  }|d   |= 
 |j	                  d      si |d<   ||d<   t
        j                  d|        t        j                  | ||       y )Noptionsflagsz$Writing resolv.conf from template %s)	items
isinstanceboolappendgetLOGdebugr   render_to_file)template_fnparamstarget_fnamer!   false_flagskeyvalflags           A/usr/lib/python3/dist-packages/cloudinit/config/cc_resolv_conf.pygenerate_resolv_confr2   f   s    EKFy)//1 	,HC#t$LL%&&s+	, # $9d#$ ::i yF7OII4kB[,?    r   cfgcloudargsreturnc                    d|vrt         j                  d|        yt        j                  |dd      st         j                  d|        yd|vrt         j	                  d       y	 |j                  t        |j                  j                           }t        ||d   |j                  j                  	       y# t        $ r t         j	                  d       Y yw xY w)
a[  
    Handler for resolv.conf

    @param name: The module name "resolv_conf" from cloud.cfg
    @param cfg: A nested dict containing the entire cloud config contents.
    @param cloud: The L{CloudInit} object in use.
    @param log: Pre-initialized Python logger object to use for logging.
    @param args: Any module arguments from cloud.cfg
    r   zFSkipping module named %s, no 'manage_resolv_conf' key in configurationNFzGSkipping module named %s, 'manage_resolv_conf' present but set to Falseresolv_confz3manage_resolv_conf True but no parameters provided!z0No template found, not rendering resolve configs)r*   r+   r,   )r'   r(   r   get_cfg_option_boolwarningget_template_filenameRESOLVE_CONFIG_TEMPLATE_MAPdistroresolve_conf_fnKeyErrorr2   )r   r4   r5   r6   r*   s        r1   handlerA   }   s     3&		<	

 	##C)=uE		=	

 	CIJ11'(D(DE
 =!\\11
   FGs   %,B7 7CC)__doc__loggingtextwrapr   	cloudinitr   r   cloudinit.cloudr   cloudinit.configr   cloudinit.config.schemar   r	   cloudinit.settingsr
   	getLogger__name__r'   r=   MODULE_DESCRIPTIONr   __annotations__r2   strlistrA    r3   r1   <module>rQ      s    )   % ! # < +g! &"9 
 8 $% 	
* !55U+j +Z t
@.+ +6 +% +t + +r3   