Current File : //usr/lib/python2.7/site-packages/salt/modules/win_network.pyo
�
���^c @@ sN 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 Z
d d l
m a m a m a m a m a m a m a m a m a m a m a d d l m Z y d d l Z
e Z Wn e k
re Z n Xd d l! j" j# Z# y d d l$ Z$ Wn e k
r=e Z n Xd d l% m& Z& d Z' d � Z( e e d � Z) d
� Z* d � Z+ d � Z, d
� Z- d � Z. d � Z/ d � Z0 d � Z1 e
j2 j3 j4 e1 d � Z5 d � Z6 d � Z7 d e d d d � Z9 e
j2 j3 j4 e9 d � Z: d e d d � Z; e
j2 j3 j4 e; d � Z< d d � Z= d � Z> d S( u7
Module for gathering and managing network information
i ( t absolute_importt unicode_literalst print_functionN( t wolt get_hostnamet interfacet interface_ipt subnets6t ip_in_subnett convert_cidrt calc_nett get_fqdnt ifacestartswitht iphexval( t namespaced_function( t ipaddressu networkc C@ s� t j j j � s t d f St s, t d f St t t � � a t t t � � a t t
t � � a
t t t � � a t t t � � a t t
t � � a
t t t � � a t t t � � a t t t � � a t t t � � a t t t � � a t S( u'
Only works on Windows systems
u- Module win_network: Only available on Windowsu( Module win_network: Missing dependencies( t saltt utilst platformt
is_windowst Falset HAS_DEPENDENCIESt _namespaced_functionR t globalsR R R R R R R
R R R
t __virtualname__( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt __virtual__) s
c C@ s� | rM t | � d d } d d d d t j | � t j j j | � g } n! d d d t j j j | � g } | r� t d | d t �} | d d
k r� t St Sn t d | d t �Sd S(
u�
Performs a ping to a host
CLI Example:
.. code-block:: bash
salt '*' network.ping archlinux.org
.. versionadded:: 2016.11.0
Return a True or False instead of ping output.
.. code-block:: bash
salt '*' network.ping archlinux.org return_boolean=True
Set the time to wait for a response in seconds.
.. code-block:: bash
salt '*' network.ping archlinux.org timeout=3
i� i u pingu -nu 4u -wu cmd.run_allt python_shellu retcodei u cmd.runN(
t intt sixt text_typeR R t networkt
sanitize_hostt __salt__R t True( t hostt timeoutt return_booleant cmdt ret( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt pingE s 3!c C@ s� g } d d g } t d | d t �j � } x� | D]� } | j � } | j d � r� | j i | d d 6| d d 6| d
d 6| d d
6| d d 6� n | j d � r5 | j i | d d 6| d d 6| d
d 6d d
6| d d 6� q5 q5 W| S( u�
Return information on open ports and states
CLI Example:
.. code-block:: bash
salt '*' network.netstat
u netstatu -naou cmd.runR u TCPi u
local-addressi u protoi u remote-addressi u statei u programu UDPN( R R t
splitlinest splitt
startswitht appendt None( R& R% t linest linet comps( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt netstatn s(
c C@ s� g } d t j j j | � g } t d | d t �j � } xg| D]_} d | k r\ qD n | j d � rq qD n | j d � r� qD n | j � } t | � } | d k ri | d d 6| d
d 6| d d
6| d d 6| d d 6| d d 6} | j
| � qD | d k rbi | d d 6d d 6| d
d
6| d d 6| d d 6| d d 6} | j
| � qD i | d d 6d d 6d d
6d d 6d d 6d d 6} | j
| � qD W| S( u�
Performs a traceroute to a 3rd party host
CLI Example:
.. code-block:: bash
salt '*' network.traceroute archlinux.org
u tracertu cmd.runR u u Tracu overi i u counti u hostnamei u ipi u ms1i u ms2i u ms3N( R R R R R R R( R* R) t lenR+ R, ( R" R& R% R- R. R/ t
complengtht result( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt
traceroute� sN
c C@ s- g } g } d t j j j | � g } t d | d t �j � } x� | D]� } | ro | j | j � � qJ n | j d � r� qJ n d | k r� | j
d d � } | j | d j � � qJ n d | k rJ | j
d d � } | j i | d j � | d j � 6� qJ qJ W| r)| j i | d 6� n | S( u�
Query DNS for information about a domain or ip address
CLI Example:
.. code-block:: bash
salt '*' network.nslookup archlinux.org
u nslookupu cmd.runR u Non-authoritativeu Addressesu :i i ( R R R R R R R( R+ t stripR* R) ( R" R& t addressesR% R- R. R/ ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt nslookup� s(
/c C@ s� d j | � } t d | d d d t �} t j d d t j t j B�} | j | � } i | d 6| j d � d 6| j d
� d
6| j d � d 6} | S( u�
Return routing information for given destination ip
.. versionadded:: 2016.11.5
CLI Example::
salt '*' network.get_route 10.10.10.10
u" Find-NetRoute -RemoteIPAddress {0}u cmd.runt shellu
powershellR u~ ^IPAddress\s+:\s(?P<source>[\d\.:]+)?.*^InterfaceAlias\s+:\s(?P<interface>[\w\.\:\-\ ]+)?.*^NextHop\s+:\s(?P<gateway>[\d\.:]+)t flagsu destinationu gatewayu interfaceu source( t formatR R! t ret compilet MULTILINEt DOTALLt searcht group( t ipR% t outt regexpt mR& ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt get_route� s
c C@ s/ d t j j j | � g } t d | d t �S( u�
Performs a DNS lookup with dig
Note: dig must be installed on the Windows minion
CLI Example:
.. code-block:: bash
salt '*' network.dig archlinux.org
u digu cmd.runR ( R R R R R R ( R" R% ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt dig s c C@ s\ g } t j j j � �> t j � } x* | j d t � D] } | j | j � q8 WWd QX| S( u�
Return a list of all the interfaces names
CLI Example:
.. code-block:: bash
salt '*' network.interfaces_names
t
NetEnabledN(
R R t winapit Comt wmit WMIt Win32_NetworkAdapterR! R+ t NetConnectionID( R& t ct iface( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt interfaces_names s c C@ s t j j j � S( u�
Return a dictionary of information about all the interfaces on the minion
CLI Example:
.. code-block:: bash
salt '*' network.interfaces
( R R R t win_interfaces( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt
interfaces% s
c C@ s t j j j | � S( u�
Return the hardware address (a.k.a. MAC address) for a given interface
CLI Example:
.. code-block:: bash
salt '*' network.hw_addr 'Wireless Connection #1'
( R R R t hw_addr( RO ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyRS 2 s
u hwaddrc C@ s t j j j � S( u�
Returns a list of subnets to which the host belongs
CLI Example:
.. code-block:: bash
salt '*' network.subnets
( R R R t subnets( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyRT C s
c C@ s t j j j | � S( u�
Returns True if host is within specified subnet, otherwise False
CLI Example:
.. code-block:: bash
salt '*' network.in_subnet 10.0.0.0/16
( R R R t in_subnet( t cidr( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyRU P s
c C@ s� t j j j d | d | � } | rV g | D]' } t j j j | | g � r+ | ^ q+ S| d k r� g | D] } t | � si | ^ qi S| d k r� g | D] } t | � r� | ^ q� S| Sd S( u�
Returns a list of IPv4 addresses assigned to the host.
interface
Only IP addresses from that interface will be returned.
include_loopback : False
Include loopback 127.0.0.1 IPv4 address.
cidr
Describes subnet using CIDR notation and only IPv4 addresses that belong
to this subnet will be returned.
.. versionchanged:: 2019.2.0
type
If option set to 'public' then only public addresses will be returned.
Ditto for 'private'.
.. versionchanged:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' network.ip_addrs
salt '*' network.ip_addrs cidr=10.0.0.0/8
salt '*' network.ip_addrs cidr=192.168.0.0/16 type=private
R t include_loopbacku publicu privateN( R R R t ip_addrsRU t
is_private( R RW RV t typet addrst i( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyRX ] s 2 # #u ipaddrsc C@ s^ t j j j d | d | � } | rV g | D]' } t j j j | | g � r+ | ^ q+ S| Sd S( u
Returns a list of IPv6 addresses assigned to the host.
interface
Only IP addresses from that interface will be returned.
include_loopback : False
Include loopback ::1 IPv6 address.
cidr
Describes subnet using CIDR notation and only IPv6 addresses that belong
to this subnet will be returned.
.. versionchanged:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' network.ip_addrs6
salt '*' network.ip_addrs6 cidr=2000::/3
R RW N( R R R t ip_addrs6RU ( R RW RV R[ R\ ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyR] � s
2u ipaddrs6c K@ s� i d d 6d d 6} | s2 t | d <d | d <| S| sP t | d <d | d <| S| j d d � } | j d d � } | j d
d � } t j j j j | � s� t j j j j | � r� | } n d j t j j
j | � � } yO| d k r� t j
} n t j } d } | rF| d
k r%t j } qL| d k r=t j } qLd } n d } t j | | | d | � d \ } }
} } }
t j | |
| � } | j | � | d k rt j � } | j t j j � j d � � | j � } | j | |
� | j d � \ } } | j � n | j |
� | j d � Wn> t k
rl} t | d <d j | |
d | | � | d <| SXt | d <d j | |
d | | � | d <| S( u�
Test connectivity to a host using a particular
port from the minion.
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' network.connect archlinux.org 80
salt '*' network.connect archlinux.org 80 timeout=3
salt '*' network.connect archlinux.org 80 timeout=3 family=ipv4
salt '*' network.connect google-public-dns-a.google.com port=53 proto=udp timeout=3
u resultu u commentu$ Required argument, host, is missing.u$ Required argument, port, is missing.u protou tcpu timeouti u familyu {0}u udpu ipv4u ipv6i u %si� i u. Unable to connect to {0} ({1}) on {2} port {3}u3 Successfully connected to {0} ({1}) on {2} port {3}N(! R, R t getR R t validatet nett ipv4_addrt ipv6_addrR: R R t sockett SOL_UDPt SOL_TCPt AF_INETt AF_INET6t getaddrinfot
settimeoutt hashlibt md5t updatet datetimet nowt strftimet hexdigestt sendtot recvfromt closet connectt shutdownt ExceptionR! ( R" t portt kwargsR& t protoR# t familyt addresst __protot __familyt socktypet _protot garbaget _addresst sktt md5ht msgt recvt svrt exc( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyRt � sb
0 .
c C@ s t j | � j S( u�
Check if the given IP address is a private address
.. versionadded:: 2019.2.0
CLI Example:
.. code-block:: bash
salt '*' network.is_private 10.0.0.3
( R t
ip_addressRY ( t ip_addr( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyRY s (? t __doc__t
__future__R R R R; Rj Rm Rc t salt.utils.networkR t salt.utils.platformt salt.utils.validate.nett salt.modules.networkR R R R R R R R
R R R
t salt.utils.functoolsR R t salt.utils.winapiR! R t ImportErrorR t salt.ext.sixt extR RJ t salt._compatR R R R' R0 R4 R7 RE RF RP RR RS R t functoolst alias_functiont hwaddrRT RU R, RX t ipaddrsR] t ipaddrs6Rt RY ( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_network.pyt <module> sR L
) 6 !
+ \
Mini Shell