�
�Udac @ s i d d 6d g d 6d d 6Z d Z d Z d Z d d
l m Z m Z m Z d d l m Z m Z d d l m
Z
d d
l m Z d d l
Z
d d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z e d k re � n d S( s 1.1t metadata_versiont previewt statust networkt supported_bys1
---
module: nxos_igmp_interface
extends_documentation_fragment: nxos
version_added: "2.2"
short_description: Manages IGMP interface configuration.
description:
- Manages IGMP interface configuration settings.
author:
- Jason Edelman (@jedelman8)
- Gabriele Gerbino (@GGabriele)
notes:
- Tested against NXOSv 7.3.(0)D1(1) on VIRL
- When C(state=default), supported params will be reset to a default state.
These include C(version), C(startup_query_interval),
C(startup_query_count), C(robustness), C(querier_timeout), C(query_mrt),
C(query_interval), C(last_member_qrt), C(last_member_query_count),
C(group_timeout), C(report_llg), and C(immediate_leave).
- When C(state=absent), all configs for C(oif_ps), and
C(oif_routemap) will be removed.
- PIM must be enabled to use this module.
- This module is for Layer 3 interfaces.
- Route-map check not performed (same as CLI) check when configuring
route-map with 'static-oif'
- If restart is set to true with other params set, the restart will happen
last, i.e. after the configuration takes place. However, 'restart' itself
is not idempotent as it is an action and not configuration.
options:
interface:
description:
- The full interface name for IGMP configuration.
e.g. I(Ethernet1/2).
required: true
version:
description:
- IGMP version. It can be 2 or 3 or keyword 'default'.
choices: ['2', '3', 'default']
startup_query_interval:
description:
- Query interval used when the IGMP process starts up.
The range is from 1 to 18000 or keyword 'default'.
The default is 31.
startup_query_count:
description:
- Query count used when the IGMP process starts up.
The range is from 1 to 10 or keyword 'default'.
The default is 2.
robustness:
description:
- Sets the robustness variable. Values can range from 1 to 7 or
keyword 'default'. The default is 2.
querier_timeout:
description:
- Sets the querier timeout that the software uses when deciding
to take over as the querier. Values can range from 1 to 65535
seconds or keyword 'default'. The default is 255 seconds.
query_mrt:
description:
- Sets the response time advertised in IGMP queries.
Values can range from 1 to 25 seconds or keyword 'default'.
The default is 10 seconds.
query_interval:
description:
- Sets the frequency at which the software sends IGMP host query
messages. Values can range from 1 to 18000 seconds or keyword
'default'. The default is 125 seconds.
last_member_qrt:
description:
- Sets the query interval waited after sending membership reports
before the software deletes the group state. Values can range
from 1 to 25 seconds or keyword 'default'. The default is 1 second.
last_member_query_count:
description:
- Sets the number of times that the software sends an IGMP query
in response to a host leave message.
Values can range from 1 to 5 or keyword 'default'. The default is 2.
group_timeout:
description:
- Sets the group membership timeout for IGMPv2.
Values can range from 3 to 65,535 seconds or keyword 'default'.
The default is 260 seconds.
report_llg:
description:
- Configures report-link-local-groups.
Enables sending reports for groups in 224.0.0.0/24.
Reports are always sent for nonlink local groups.
By default, reports are not sent for link local groups.
type: bool
immediate_leave:
description:
- Enables the device to remove the group entry from the multicast
routing table immediately upon receiving a leave message for
the group. Use this command to minimize the leave latency of
IGMPv2 group memberships on a given IGMP interface because the
device does not send group-specific queries.
The default is disabled.
type: bool
oif_routemap:
description:
- Configure a routemap for static outgoing interface (OIF) or
keyword 'default'.
oif_prefix:
description:
- This argument is deprecated, please use oif_ps instead.
Configure a prefix for static outgoing interface (OIF).
oif_source:
description:
- This argument is deprecated, please use oif_ps instead.
Configure a source for static outgoing interface (OIF).
oif_ps:
description:
- Configure prefixes and sources for static outgoing interface (OIF). This
is a list of dict where each dict has source and prefix defined or just
prefix if source is not needed. The specified values will be configured
on the device and if any previous prefix/sources exist, they will be removed.
Keyword 'default' is also accepted which removes all existing prefix/sources.
version_added: 2.6
restart:
description:
- Restart IGMP. This is NOT idempotent as this is action only.
type: bool
default: False
state:
description:
- Manages desired state of the resource.
default: present
choices: ['present', 'absent', 'default']
s�
- nxos_igmp_interface:
interface: ethernet1/32
startup_query_interval: 30
oif_ps:
- { 'prefix': '238.2.2.6' }
- { 'source': '192.168.0.1', 'prefix': '238.2.2.5'}
state: present
s3
proposed:
description: k/v pairs of parameters passed into module
returned: always
type: dict
sample: {"startup_query_count": "30",
"oif_ps": [{'prefix': '238.2.2.6'}, {'source': '192.168.0.1', 'prefix': '238.2.2.5'}]}
existing:
description: k/v pairs of existing igmp_interface configuration
returned: always
type: dict
sample: {"startup_query_count": "2", "oif_ps": []}
end_state:
description: k/v pairs of igmp interface configuration after module execution
returned: always
type: dict
sample: {"startup_query_count": "30",
"oif_ps": [{'prefix': '238.2.2.6'}, {'source': '192.168.0.1', 'prefix': '238.2.2.5'}]}
updates:
description: commands sent to the device
returned: always
type: list
sample: ["interface Ethernet1/32", "ip igmp startup-query-count 30",
"ip igmp static-oif 238.2.2.6", "ip igmp static-oif 238.2.2.5 source 192.168.0.1"]
changed:
description: check to see if a change was made on the device
returned: always
type: bool
sample: true
i����( t
get_configt load_configt run_commands( t nxos_argument_spect
check_args( t get_interface_type( t
AnsibleModuleNt cli_showc C sJ | d k r& i | d 6d d 6g } n i | d 6d d 6g } t | | � S( Nt cli_show_asciit commandt textt outputt json( R ( R t modulet command_typet cmds( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt execute_show_command� s
c C s� d j | � } i } d } | d k r� t | | � d } | d d } t | j d d � � } | d
k sx | d k r� d } q� n! | d
k s� | d k r� d } n | S( Ns show interface {0}t unknownt ethernett portchanneli t TABLE_interfacet
ROW_interfacet eth_modet layer3t accesst trunkt layer2t loopbackt svi( R R ( t formatR t strt get( t interfacet intf_typeR R t modet bodyt interface_table( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt get_interface_mode� s c C sk i } x^ | j � D]P \ } } | j | � } | r | j | � } | rV | | | <qc | | | <q q W| S( N( t itemsR$ ( t key_mapt tablet new_dictt keyt valuet new_key( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt
apply_key_map� s
c C sG g } x: | D]2 } t | t � r2 | j | � q
| j | � q
W| S( N( t
isinstancet listt extendt append( t
command_listst flat_command_listR ( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt flatten_list� s
c C s
d j | � } i } i
d d 6d d 6d d 6d d 6d
d 6d d
6d d 6d d 6d d 6d d 6} t | | � d } | rNd | k r� | S| d d d d } t | | � } t | d � j � } | d k r� t | d <n | d k r� t | d <n t | d � j � } t j d! | � r,t | d" <qNt j d# | � rNt | d" <qNn d$ j | � } t | | d% d& �d } g } | r�| j d' � }
d( } d) } x|
D]� }
i } y, t j
| |
t j � } | j � d* } Wn t
k
r�d+ } n Xy< t j
| |
t j � } | j � } | d, } | d- } Wn t
k
rQd+ } d+ } n X| re| | d* <n | rx| | d, <n | r�| | d- <n | r�| j | � q�q�Wn d | d. <g | d/ <| r t | � d0 k r�| d j d* � r�| d d* | d. <q | | d/ <n | S(1 Ns show ip igmp interface {0}t versiont IGMPVersiont startup_query_intervalt ConfiguredStartupQueryIntervalt startup_query_countt StartupQueryCountt
robustnesst RobustnessVariablet querier_timeoutt ConfiguredQuerierTimeoutt query_mrtt ConfiguredMaxResponseTimet query_intervalt ConfiguredQueryIntervalt last_member_qrtt
LastMemberMTRt last_member_query_countt LastMemberQueryCountt
group_timeoutt ConfiguredGroupTimeouti s not runningt TABLE_vrft ROW_vrft TABLE_ift ROW_ift ReportingForLinkLocalt truet
report_llgt falset ImmediateLeaves ^en|^true|^enabledt immediate_leaves ^dis|^false|^disableds show run interface {0} | inc oifR R
s
s5 .*ip igmp static-oif route-map\s+(?P<route_map>\S+).*sO .*ip igmp static-oif\s+(?P<prefix>((\d+.){3}\d+))(\ssource\s(?P<source>\S+))?.*t route_mapt t prefixt sourcet oif_routemapt oif_prefix_sourcei ( R" R R2 R# t lowert Truet Falset ret searcht splitt matcht DOTALLt groupdictt AttributeErrorR6 t Nonet lenR$ ( R R% R t igmpR, R( t resourceRT RW t staticoift
split_bodyt route_map_regext prefix_source_regext linet tempt match_route_mapRX t match_prefix_sourcet prefix_source_groupRZ R[ ( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt get_igmp_interface� s�
%
c C s5 i d d 6d d 6d d 6d d 6d d
6d d 6d
d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6d d 6} g } d } t � } x�| j � D]�\ } } | d k r�| d k r�x� | D]� } | | k r� | j | � q� | d! }
d" } d# | j � k r
| d# } n | r8| j | j d � j |
| � � q� | j | j d � j |
� � q� W| rx� | D]� } | d! }
d" } d# | j � k r�| d# } n | r�| j d$ | j d � j |
| � � qh| j d$ | j d � j |
� � qhWqn | d k rf| d k rK| j | � rcd$ | j | � j | j | � � } qcq| j | � j | � } n� | r�| d k r�| j | � | j | � k r�| j | � j | j | � � } q�q| j | � j | � } n* | sd% j | j | � j | � � } n | r'| | k r'| j | � q'n d } q� W| S(& Ns ip igmp version {0}R: s" ip igmp startup-query-interval {0}R< s ip igmp startup-query-count {0}R> s ip igmp robustness-variable {0}R@ s ip igmp querier-timeout {0}RB s# ip igmp query-max-response-time {0}RD s ip igmp query-interval {0}RF s+ ip igmp last-member-query-response-time {0}RH s# ip igmp last-member-query-count {0}RJ s ip igmp group-timeout {0}RL s ip igmp report-link-local-groupsRT s ip igmp immediate-leaveRW s" ip igmp static-oif {0} source {1} R] s ip igmp static-oif route-map {0}R\ s ip igmp static-oif {0}t
oif_prefixt oif_pst defaultRZ RY R[ s no s no {0}( Rh t get_igmp_interface_defaultsR+ t removet keysR6 R$ R" ( t deltat existingt existing_oif_prefix_sourcet CMDSt commandsR t def_valsR/ R0 t eacht pft src( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt config_igmp_interfaceZ sr
%#
)- + '$
c C s� d } d } d } d } d } d } d } d } d } d } t }
t } t d | d | d
| d | d | d
| d | d | d | d | d |
d | � } t d � | j � D� � }
|
S( Nt 2t 31t 255t 10t 125t 1t 260R: R< R> R@ RB RD RF RH RJ RL RT RW c s s- | ]# \ } } | d k r | | f Vq d S( N( Rh ( t .0t paramR0 ( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pys <genexpr>� s ( R` t dictR+ ( R: R< R> R@ RB RD RF RH RJ RL RT RW t argsRx ( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyRy � s* c C s g } t � } t t | j � � j | j � � � } | r{ t | | d d �} | r{ x | D] } | j | � q^ Wq{ n | S( NR~ ( Ry R� t setR+ t
differenceR� Rh R6 ( R} R| R� t proposedR R� ( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt config_default_igmp_interface� s '
c C s� g } d } | j d � r= | j d j | j d � � � n� | r� x� | D]� } | j d � r� | j d � r� d j | j d � | j d � � } n* | j d � r� d j | j d � � } n | r� | j | � n d } qJ Wn | S( NR\ s# no ip igmp static-oif route-map {0}RZ R[ s% no ip igmp static-oif {0} source {1} s no ip igmp static-oif {0}( Rh R$ R6 R" ( R} R~ R� R R� ( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt config_remove_oif� s "
!
c + s� t d t d t d d � d t d t d d � d t d t d d � d t d t d d � d t d t d d � d t d t d d � d
t d t d d � d t d t d d � d t d t d d � d
t d t d d � d t d t d d � d t d d � d t d d � d t d t d d � d t d t d d d d � d t d t d d d d � d t d t d d � d t d d d t � d t d d d d g d d � � } | j t � d< d= d> d? g } t d | d | d! t � } t � } t | | � | j d } | j d } | j d } | j d } | j d } | j d } | r_| r_| j d" d# � nF | r�| r�i | d$ 6| d% 6g } n | r�| r�i | d% 6g } n t
| � }
t | |
| � d& k r�| j d" d' � n t | | � } | j
� } | }
| j d � s | j d" d( � n | j d) � } | j d) � | rZ| rZ| j d" d* � n | r�| j d � r�| j d" d+ � n d d d d d d
d d d
d d d d g
� t } g } t � f d, � | j j � D� � } d d d d d d
d d d
d d d g } | d k rIx0 | D]% } | | k r | j d" d- � q q Wn t t | j � � j | j � � � } | r�| d k r�g | d <q�| | d <n | d k r�| r�t | | | � } | r�| j | � q�q�n� | d k rt | | � } | r�| j | � q�nw | d k r�d } | j d � s7| rIt | | � } n | r_| j | � n t | | � } | r�| j | � q�n g } i } | r$| j d. d/ j | � g � t | � } | j r�| j d0 t d1 | � q$t | | � t } t | | � }
d2 | k r$| j d. � q$n | j d rUi d3 d4 6d5 d6 6} t | | � n | | d7 <| | d8 <| | d9 <| | d0 <| | d: <|
| d; <| j | � d S(@ NR% t requiredt typeR# R: R< R> R@ RB RD RF RH RJ RL RT t boolRW R\ Rv t removed_in_versions 2.10t
oif_sourceRw t rawt restartRx t statet choicest presentt absentt
argument_spect mutually_exclusivet supports_check_modet msgs+ oif_prefix required when setting oif_sourceR[ RZ R s, this module only works on Layer 3 interfacess( pim needs to be enabled on the interfaceR] sP Delete static-oif configurations on this interface if you want to use a routemaps` Delete static-oif route-map configuration on this interface if you want to config static entriesc 3 s9 | ]/ \ } } | d k r | � k r | | f Vq d S( N( Rh ( R� t kt v( R� ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pys <genexpr>? s sW only params: oif_prefix, oif_source, oif_ps, oif_routemap can be used when state=absenti s
interface {0}t changedR� t configures restart igmpR R R R� R} t updatest warningst end_state( Rw Rv ( Rw R� ( Rw R\ ( Rv R\ ( R� R_ R` t updateR R R4 R t paramst fail_jsonR
R* Ru t copyR$ t popR+ R� R� R� R6 R� Rh R� t insertR" R9 t
check_modet exit_jsonR R ( R� R� R R� R� R% Rv R� R\ Rw R& R} t
existing_copyR� R~ R� R� R� t
CANNOT_ABSENTR� R| R R t resultst cmd( ( R� sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt main� s�
%
'
t __main__( t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURNt& ansible.module_utils.network.nxos.nxosR R R R R R
t ansible.module_utils.basicR Ra R R* R2 R9 Ru R� Ry R� R� R� t __name__( ( ( sT /usr/lib/python2.7/site-packages/ansible/modules/network/nxos/nxos_igmp_interface.pyt <module> s,
�
\ H �
Anons79 File Manager Version 1.0, Coded By Anons79
Email: [email protected]
Anons79 Mini Shell