Current File : //lib/python2.7/site-packages/salt/states/win_network.pyo
�
���^c @@ s� 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
m Z d d l m
Z
d d l m Z e j e � Z d Z d Z d
� Z d � Z d � Z d
� Z d d d d d e d � Z d S( u
Configuration of network interfaces on Windows hosts
====================================================
.. versionadded:: 2014.1.0
This module provides the ``network`` state(s) on Windows hosts. DNS servers, IP
addresses and default gateways can currently be managed.
Below is an example of the configuration for an interface that uses DHCP for
both DNS servers and IP addresses:
.. code-block:: yaml
Local Area Connection #2:
network.managed:
- dns_proto: dhcp
- ip_proto: dhcp
.. note::
Both the ``dns_proto`` and ``ip_proto`` arguments are required.
Static DNS and IP addresses can be configured like so:
.. code-block:: yaml
Local Area Connection #2:
network.managed:
- dns_proto: static
- dns_servers:
- 8.8.8.8
- 8.8.4.4
- ip_proto: static
- ip_addrs:
- 10.2.3.4/24
.. note::
IP addresses are specified using the format
``<ip-address>/<subnet-length>``. Salt provides a convenience function
called :mod:`ip.get_subnet_length <salt.modules.win_ip.get_subnet_length>`
to calculate the subnet length from a netmask.
Optionally, if you are setting a static IP address, you can also specify the
default gateway using the ``gateway`` parameter:
.. code-block:: yaml
Local Area Connection #2:
network.managed:
- dns_proto: static
- dns_servers:
- 8.8.8.8
- 8.8.4.4
- ip_proto: static
- ip_addrs:
- 10.2.3.4/24
- gateway: 10.2.3.1
i ( t absolute_importt unicode_literalst print_functionN( t range( t CommandExecutionError( t sixu staticu dhcpu networkc C@ s& t j j j � r" d t k r" t St S( ub
Confine this module to Windows systems with the required execution module
available.
u ip.get_interface( t saltt utilst platformt
is_windowst __salt__t __virtualname__t False( ( ( s; /usr/lib/python2.7/site-packages/salt/states/win_network.pyt __virtual__T s c C@ s� g } | d k r1 | d k r� | j d � q� n� t | � j � d k rL nx t | t � sk | j d � nY g | D]$ } t j j j j
| � sr | ^ qr } | r� | j d j d j | � � � n | d k r | d k r� | j d � n | d k r�| j d � q�n� | s!| j d
� n� t | t � s@| j d � n� g | D]$ } t j j j j
| � sG| ^ qG} | r�| j d j d j | � � � n | d k r�t j j j j
| � s�| j d
j | � � q�n | S( uo
Ensure that the configuration passed is formatted correctly and contains
valid IP addresses, etc.
u dhcpuJ The dns_servers param cannot be set if unless dns_proto is set to 'static'u noneu []u1 The dns_servers param must be formatted as a listu Invalid DNS server IPs: {0}u , uF The ip_addrs param cannot be set if unless ip_proto is set to 'static'u@ A gateway IP cannot be set if unless ip_proto is set to 'static'u0 The ip_addrs param is required to set static IPsu. The ip_addrs param must be formatted as a listu) The following static IPs are invalid: {0}u Gateway IP {0} is invalidN( u noneu [](
t Nonet appendt strt lowert
isinstancet listR R t validatet nett ipv4_addrt formatt join( t dns_protot dns_serverst ip_protot ip_addrst gatewayt errorst xt bad_ips( ( s; /usr/lib/python2.7/site-packages/salt/states/win_network.pyt _validate^ sJ
$
$ c C@ s; g | D]0 } d j | d | d j d d � d � ^ q S( uq
Extracts a list of IP/CIDR expressions from a list of addrdicts, as
retrieved from ip.get_interface
u {0}/{1}u
IP Addressu Subnetu /i i����( R t rsplit( t addrsR ( ( s; /usr/lib/python2.7/site-packages/salt/states/win_network.pyt _addrdict_to_ip_addrs� s c C@ s� i } d | k r d n d } | d k r� t | d t � rJ | d } n
| d g } t | pf d g � t | � k r� | | d <q� nV d | k r� | d } | d k r� t | p� d g � t | � k r� | | d <q� q� n | d d k r� d n d } t | j d g � � }
| j d
� } | | k r:| | d <n | | k rS| | d <n t | p_g � t |
� k r�| d k r�| | d <q�n | | k r�| d k r�| | d
<q�n | S( u�
Compares the current interface against the desired configuration and
returns a dictionary describing the changes that need to be made.
u! Statically Configured DNS Serversu staticu dhcpu Noneu dns_serversu# DNS servers configured through DHCPu DHCP enabledu Nou ip_addrsu Default Gatewayu dns_protou ip_protou gateway( R R t setR$ t get( t curR R R R R t changest
cur_dns_protot cur_dns_serverst cur_ip_protot cur_ip_addrst cur_gateway( ( s; /usr/lib/python2.7/site-packages/salt/states/win_network.pyt _changes� s8
!
!
c
K@ sm i | d 6i d 6t d 6d j | � d 6} t j | � j � } t j | � j � } g } | t k r� t | d <| j d j d j t � � � n | t k r� | j d j d j t � � � n | r� t | d <d j | � | d <| Sy t d
| � }
Wn t
k
rt }
n X| s�|
r�t d rLd0 | d <d j | � | d <q�t d
| � | d <| d s�d j | � | d <q�n | d c d 7<| S|
s�t d r�d0 | d <d j | � | d <q�t d | � s�t | d <d j | � | d <| Sn t
| | | | | � } | rCt | d <d j d j | � � | d <| St d | � } | szt | d <d j | � | d <| St | | | | | | � } t | � j � d k r�| j d d0 � n | s�| St d rGg }
d | k r|
j d j | d � � n | d k rgd | k rgt | d � d k rA|
j d � qg|
j d j d j | d � � � n d | k r�|
j d j | d � � n | d k rd! | k r�|
j d" j d j | d! � � � n d# | k r| d# d0 k r�|
j d$ � q|
j d% j | d# � � qn d0 | d <d& j | d j |
� � | d <| S| j d � d' k rmt d( | � nJ d | k r�t | d � d k r�g g | d <n t d) | | d � n | j d � d' k r�t d* | � n| j d! � s| j d# � s| j d � d k r�| j d# � r<| j d! � r<| | d! <n | j d � d k rn| j d! � rn| | d! <n xz t t | d! � � D]_ } | d k r�t d+ | | d! | d, | d- t �q�t d+ | | d! | d, d0 d- t �q�Wn t d | � } t j j j | | � | d <t | | | | | | � rRt | d <d. j | � | d <n d/ j | � | d <| Sd0 S(1 uR
Ensure that the named interface is configured properly.
Args:
name (str):
The name of the interface to manage
dns_proto (str): None
Set to ``static`` and use the ``dns_servers`` parameter to provide a
list of DNS nameservers. set to ``dhcp`` to use DHCP to get the DNS
servers.
dns_servers (list): None
A list of static DNS servers. To clear the list of DNS servers pass
an empty list (``[]``). ``None`` will make no changes.
ip_proto (str): None
Set to ``static`` and use the ``ip_addrs`` and (optionally)
``gateway`` parameters to provide a list of static IP addresses and
the default gateway. Set to ``dhcp`` to use DHCP.
ip_addrs (list): None
A list of static IP addresses with netmask flag, ie: 192.168.0.11/24
gateway (str): None
The gateway to set for the interface
enabled (bool): True
Set to ``False`` to ensure that this interface is disabled.
Returns:
dict: A dictionary of old and new settings
Example:
.. code-block:: yaml
Ethernet1:
network.managed:
- dns_proto: static
- dns_servers:
- 8.8.8.8
- 8.8.8.4
- ip_proto: static
- ip_addrs:
- 192.168.0.100/24
Clear DNS entries example:
.. code-block:: yaml
Ethernet1:
network.managed:
- dns_proto: static
- dns_servers: []
- ip_proto: dhcp
u nameu changesu resultu Interface '{0}' is up to dateu commentu+ dns_proto must be one of the following: {0}u , u* ip_proto must be one of the following: {0}u
u
ip.is_enabledu testu Interface '{0}' will be disabledu
ip.disableu! Failed to disable interface '{0}'u (already disabled)u Interface '{0}' will be enabledu ip.enableu0 Failed to enable interface '{0}' to make changesu; The following SLS configuration errors were detected:
- {0}u
- u ip.get_interfaceu7 Unable to get current configuration for interface '{0}'u noneu dns_serversu dns_protou$ DNS protocol will be changed to: {0}u statici u' The list of DNS servers will be clearedu- DNS servers will be set to the following: {0}u ip_protou# IP protocol will be changed to: {0}u ip_addrsu. IP addresses will be set to the following: {0}u gatewayu Default gateway will be removedu" Default gateway will be set to {0}u< The following changes will be made to interface '{0}':
- {1}u dhcpu ip.set_dhcp_dnsu ip.set_static_dnsu ip.set_dhcp_ipu ip.set_static_ipR R u@ Failed to set desired configuration settings for interface '{0}'u6 Successfully updated configuration for interface '{0}'N( t TrueR R t text_typeR t
__VALID_PROTOR R R R
R t __opts__R R! R. R t popt lenR& R R R t datat
compare_dicts( t nameR R R R R t enabledt kwargst retR t currently_enabledt oldR( t commentst idxt new( ( s; /usr/lib/python2.7/site-packages/salt/states/win_network.pyt managed� s B
3
%
( u staticu dhcp( t __doc__t
__future__R R R t loggingt salt.utils.dataR t salt.utils.platformt salt.utils.validate.nett salt.ext.six.movesR t salt.exceptionsR t salt.extR t getLoggert __name__t logR1 R R
R! R$ R. R R/ R@ ( ( ( s; /usr/lib/python2.7/site-packages/salt/states/win_network.pyt <module>= s*
? *
Mini Shell