Current File : //usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyo
�
���^c @@ s d Z d d l m Z m Z m Z d d l Z d d l m Z d d l Z e j
e � Z d � Z
d � Z d � Z d � Z d d
d � Z d � Z d
� Z e d � Z e d � Z e d � Z e d � Z d � Z d � Z d � Z d � Z e d � Z d � Z d d � Z! d S( u�
Support for Open vSwitch - module with basic Open vSwitch commands.
Suitable for setting up Openstack Neutron.
:codeauthor: Jiri Kotlin <jiri.kotlin@ultimum.io>
i ( t absolute_importt print_functiont unicode_literalsN( t sixc C@ s t j j j d � r d St S( u;
Only load the module if Open vSwitch is installed
u ovs-vsctlu openvswitch( t saltt utilst patht whicht False( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt __virtual__ s c C@ s | r
d Sd Sd S( u�
Returns --may-exist parameter for Open vSwitch command.
Args:
may_exist: Boolean whether to use this parameter.
Returns:
String '--may-exist ' or empty string.
u --may-exist u N( ( t may_exist( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt _param_may_exist s
c C@ s | r
d Sd Sd S( u�
Returns --if-exist parameter for Open vSwitch command.
Args:
if_exists: Boolean whether to use this parameter.
Returns:
String '--if-exist ' or empty string.
u --if-exists u N( ( t if_exists( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt _param_if_exists. s
c C@ s | d k r t St Sd S( u�
Evaulates Open vSwitch command`s retcode value.
Args:
retcode: Value of retcode field from response, should be 0, 1 or 2.
Returns:
True on 0, else False
i N( t TrueR ( t retcode( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt _retcode_to_bool> s
u u
c C@ s' | d k r | j | � } | St Sd S( u1
Evaulates Open vSwitch command`s retcode value.
Args:
retcode: Value of retcode field from response, should be 0, 1 or 2.
stdout: Value of stdout filed from response.
splitstring: String used to split the stdout default new line.
Returns:
List or False.
i N( t splitR ( R t stdoutt splitstringt ret( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt _stdout_list_splitN s c C@ s7 d } t d | � } | d } | d } t | | � S( u�
Lists all existing real and fake bridges.
Returns:
List of bridges (or empty list), False on failure.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.bridge_list
u ovs-vsctl list-bru cmd.run_allu retcodeu stdout( t __salt__R ( t cmdt resultR R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt bridge_lista s
c C@ s3 d j | � } t d | � } | d } t | � S( u�
Tests whether bridge exists as a real or fake bridge.
Returns:
True if Bridge exists, else False.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.bridge_exists br0
u ovs-vsctl br-exists {0}u cmd.run_allu retcode( t formatR R ( t brR R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt
bridge_existsv s
c C@ s< t | � } d j | | � } t d | � } t | d � S( uX
Creates a new bridge.
Args:
br: A string - bridge name
may_exist: Bool, if False - attempting to create a bridge that exists returns False.
Returns:
True on success, else False.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.bridge_create br0
u ovs-vsctl {1}add-br {0}u cmd.run_allu retcode( R R R R ( R R
t param_may_existR R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt
bridge_create� s c C@ sB t | � } d j | | � } t d | � } | d } t | � S( uq
Deletes bridge and all of its ports.
Args:
br: A string - bridge name
if_exists: Bool, if False - attempting to delete a bridge that does not exist returns False.
Returns:
True on success, else False.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.bridge_delete br0
u ovs-vsctl {1}del-br {0}u cmd.run_allu retcode( R
R R R ( R R t param_if_existsR R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt
bridge_delete� s
c C@ sE t | � } d j | | | � } t d | � } | d } t | � S( u�
Creates on bridge a new port named port.
Returns:
True on success, else False.
Args:
br: A string - bridge name
port: A string - port name
may_exist: Bool, if False - attempting to create a port that exists returns False.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.port_add br0 8080
u ovs-vsctl {2}add-port {0} {1}u cmd.run_allu retcode( R R R R ( R t portR
R R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt port_add� s
c C@ sg t | � } | r. | r. d j | | � } n d j | | | � } t d | � } | d } t | � S( u�
Deletes port.
Args:
br: A string - bridge name (If bridge is None, port is removed from whatever bridge contains it)
port: A string - port name.
if_exists: Bool, if False - attempting to delete a por that does not exist returns False. (Default True)
Returns:
True on success, else False.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.port_remove br0 8080
u ovs-vsctl {1}del-port {0}u ovs-vsctl {2}del-port {0} {1}u cmd.run_allu retcode( R
R R R ( R R! R R R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt port_remove� s
c C@ s@ d j | � } t d | � } | d } | d } t | | � S( u
Lists all of the ports within bridge.
Args:
br: A string - bridge name.
Returns:
List of bridges (or empty list), False on failure.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.port_list br0
u ovs-vsctl list-ports {0}u cmd.run_allu retcodeu stdout( R R R ( R R R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt port_list� s
c C@ s@ d j | � } t d | � } | d } | d } t | | � S( u
Lists tags of the port.
Args:
port: A string - port name.
Returns:
List of tags (or empty list), False on failure.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.port_get_tag tap0
u ovs-vsctl get port {0} tagu cmd.run_allu retcodeu stdout( R R R ( R! R R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt port_get_tag s
c C@ s@ d j | � } t d | � } | d } | d } t | | � S( uG
Port's interface's optional parameters.
Args:
port: A string - port name.
Returns:
String containing optional parameters of port's interface, False on failure.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.interface_get_options tap0
u# ovs-vsctl get interface {0} optionsu cmd.run_allu retcodeu stdout( R R R ( R! R R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt interface_get_options# s
c C@ s@ d j | � } t d | � } | d } | d } t | | � S( u'
Type of port's interface.
Args:
port: A string - port name.
Returns:
String - type of interface or empty string, False on failure.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.interface_get_type tap0
u ovs-vsctl get interface {0} typeu cmd.run_allu retcodeu stdout( R R R ( R! R R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt interface_get_type; s
c C@ s t d � } d | k o$ d k n s- t St | � s= t S| rT | | k rT t S| t | � k r� d j | | � } | r� | d j | � 7} n t d | � } t | d � Sd j | | | � } | r� | d j | � 7} n t d | � } t | d � Sd S(
u�
Isolate VM traffic using VLANs.
Args:
br: A string - bridge name.
port: A string - port name.
id: An integer in the valid range 0 to 4095 (inclusive), name of VLAN.
internal: A boolean to create an internal interface if one does not exist.
Returns:
True on success, else False.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.port_create_vlan br0 tap0 100
u network.interfacesi i� u ovs-vsctl set port {0} tag={1}u# -- set interface {0} type=internalu cmd.run_allu retcodeu" ovs-vsctl add-port {0} {1} tag={2}N( R R R R$ R R ( R R! t idt internalt
interfacesR R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt port_create_vlanS s$
c C@ s� d | k o d
k n s t St d | � s4 t St | � sD t S| t | � k r� d j | | | � } t d | � } t | d � Sd j | | | | � } t d | � } t | d � Sd S( u�
Generic Routing Encapsulation - creates GRE tunnel between endpoints.
Args:
br: A string - bridge name.
port: A string - port name.
id: An integer - unsigned 32-bit number, tunnel's key.
remote: A string - remote endpoint's IP address.
Returns:
True on success, else False.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.port_create_gre br0 gre1 5001 192.168.1.10
i i i u dig.check_ipuJ ovs-vsctl set interface {0} type=gre options:remote_ip={1} options:key={2}u cmd.run_allu retcodeu^ ovs-vsctl add-port {0} {1} -- set interface {1} type=gre options:remote_ip={2} options:key={3}NI ( R R R R$ R R ( R R! R( t remoteR R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt port_create_gre| s c C@ s� d | k o d k n r/ d t j | � n d } d | k oL d
k n sU t St d | � si t St | � sy t S| t | � k r� d j | | | | � } t d | � } t | d
� Sd j | | | | | � } t d | � } t | d
� Sd S( uC
Virtual eXtensible Local Area Network - creates VXLAN tunnel between endpoints.
Args:
br: A string - bridge name.
port: A string - port name.
id: An integer - unsigned 64-bit number, tunnel's key.
remote: A string - remote endpoint's IP address.
dst_port: An integer - port to use when creating tunnelport in the switch.
Returns:
True on success, else False.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' openvswitch.port_create_vxlan br0 vx1 5001 192.168.1.10 8472
i i�� u options:dst_port=u i i@ u dig.check_ipuO ovs-vsctl set interface {0} type=vxlan options:remote_ip={1} options:key={2}{3}u cmd.run_allu retcodeuc ovs-vsctl add-port {0} {1} -- set interface {1} type=vxlan options:remote_ip={2} options:key={3}{4}Nl ( R t text_typeR R R R$ R R ( R R! R( R, t dst_portR R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt port_create_vxlan� s 5 (" t __doc__t
__future__R R R t loggingt salt.extR t salt.utils.pathR t getLoggert __name__t logR R R
R R R R R R R R R" R# R$ R% R& R' R+ R- t NoneR0 ( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/openvswitch.pyt <module> s. ) %
Mini Shell