Current File : //usr/lib/python2.7/site-packages/salt/modules/network.pyc
�
���^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 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 Z d d l Z d d l m Z d d l m Z d d l m Z d d l m Z e j e � Z d � Z d d
d � Z e! e! d � Z" d
� Z# d � Z$ d � Z% d � Z& d � Z' d � Z( d � Z) d � Z* d � Z+ d � Z, d � Z- d � Z. d � Z/ d � Z0 d � Z1 d � Z2 d � Z3 e j4 j5 j6 j7 d � d � � Z8 e j4 j5 j6 j7 d � d! � � Z9 e j4 j5 j6 j7 d" � d# � � Z: d$ � Z; d% � Z< e j4 j= j> e< d& � Z? d' � Z@ d( � ZA d d) � ZC d* � ZD d+ � ZE d, � ZF d- � ZG d d. � ZH d e! d d d/ � ZI e j4 j= j> eI d0 � ZJ d e! d d1 � ZK e j4 j= j> eK d2 � ZL d3 � ZM d4 � ZN d5 � ZO d d6 � ZP d7 � ZQ d8 � ZR d9 � ZS d: � ZT d; � ZU d< � ZV d= � ZW d d> � ZX d d? � ZY d@ � ZZ dA � Z[ dB � Z\ d S(C u7
Module for gathering and managing network information
i ( t absolute_importt unicode_literalst print_functionN( t CommandExecutionError( t six( t range( t ipaddressc C@ s t j j j � r t d f St S( u)
Only work on POSIX-like systems
uR The network execution module cannot be loaded on Windows: use win_network instead.( t saltt utilst platformt
is_windowst Falset True( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt __virtual__" s
u 255.255.255.255i c C@ sn t j j j | � } t j t j t j � } | j t j t j d � | j
d | d | t | � f � t S( u
Send Wake On Lan packet to a host
CLI Example:
.. code-block:: bash
salt '*' network.wol 08-00-27-13-69-77
salt '*' network.wol 080027136977 255.255.255.255 7
salt '*' network.wol 08:00:27:13:69:77 255.255.255.255 7
i s �i i s ������(
R R t networkt mac_str_to_bytest sockett AF_INETt
SOCK_DGRAMt
setsockoptt
SOL_SOCKETt SO_BROADCASTt sendtot intR ( t mact bcastt destportt destt sock( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt wol, s
$c C@ s� | r^ t d d k r: d j | t j j j | � � } q| d j | t j j j | � � } n d j t j j j | � � } | r� t d | � } | d d k r� t St Sn t d | � Sd
S( u�
Performs an ICMP ping to a host
.. versionchanged:: 2015.8.0
Added support for SunOS
CLI Example:
.. code-block:: bash
salt '*' network.ping archlinux.org
.. versionadded:: 2015.5.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
u kernelu SunOSu ping -c 4 {1} {0}u ping -W {0} -c 4 {1}u
ping -c 4 {0}u cmd.run_allu retcodei u cmd.runN( t
__grains__t formatR R R t
sanitize_hostt __salt__R R ( t hostt timeoutt return_booleant cmdt ret( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt ping? s $$ c C@ s< g } d } t d | � } x| j � D] } | j � } | j d � r� | j i | d d 6| d d 6| d d 6| d
d 6| d d
6| d d 6| d d 6| d d 6| d d 6� n | j d � r) | j i | d d 6| d d 6| d d 6| d
d 6| d d
6| d d 6| d d 6| d d 6� q) q) W| S( u6
Return netstat information for Linux distros
u netstat -tulpneau cmd.runu tcpi u protoi u recv-qi u send-qi u
local-addressi u remote-addressi u statei u useri u inodei u programu udp( R! t
splitlinest splitt
startswitht append( R& R% t outt linet comps( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_linuxm s6 c
C@ s/ g } d } t d | � } x | j � D]�} | j � } d } d } d } t | � } | j d � sw | j d � r+d } x� | | d k r'| | j d � }
|
d d
k r� |
d j d � } | d j d � d } n |
d d
k r� |
d } n |
d d k r|
d } n | d 7} q� Wn | j d � r�| d } | d k rYd } n | j i | d d 6| d d 6| d d 6| d d 6| d d 6| d 6| d 6| d 6| d 6� n | j d � r) | j i | d d 6| d d 6| d d 6| d d 6| d d 6| d 6| d 6| d 6� q) q) W| S( uf
Return ss information for Linux distros
(netstat is deprecated and may not be available)
u ss -tulpneau cmd.runi u u tcpu udpi i u :u usersu ,u "u uidu inou ESTABu ESTABLISHEDu protoi u recv-qi u send-qi u
local-addressi u remote-addressu stateu useru inodeu program( R! R( R) t lenR* R+ (
R& R% R, R- R. t ss_usert ss_inodet
ss_programt lengtht it fieldst userst ss_state( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _ss_linux� s\
c C@ s� i } t j d � } t d d � } x�| j � D]�} yF | j d d � \ } } } } } | j | � j � \ } }
} } Wn t t f k
r� q2 n X|
r� |
}
d j
| d k r� d n | � } n' | }
d j
| d k r� d n | � } | rd j d � |
D� � }
n d j |
j d
d � � }
| d k rDd } n d j | j d
d � � } | | j
|
i � j
| i � j
| i � j
| i � d
<| | |
| | | d <q2 W| S( uE
Get process information for network connections using fstat
uK internet(6)? (?:stream tcp 0x\S+ (\S+)|dgram udp (\S+))(?: [<>=-]+ (\S+))?$u cmd.runu fstati u tcp{0}u u udp{0}c s@ s! | ] } | d k r | Vq d S( u []N( ( t .0t x( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pys <genexpr>� s u .u :i u *.*u useru cmdN( t ret compileR! R( R) t Nonet matcht groupst
ValueErrort AttributeErrorR t joint rsplitt
setdefault( R& t _fstat_reR, R- t userR% t pidt _t detailst ipv6t tcpt udpt remote_addrt
local_addrt proto( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netinfo_openbsd� s0 !%$! : c
C@ s i } t d d j t d d k r) d n d � d t �} x� | j � D]� } | j � \ } } } } } } } d j | j d d
� � } d j | j d d
� � } | | j | i � j | i � j | i � j | i � d <| | | | | | d <qH W| S(
uH
Get process information for network connections using sockstat
u cmd.runu sockstat -46 {0} | tail -n+2u kernelu NetBSDu -nu t python_shellu .u :i u useru cmd( R! R R R R( R) RC RD RE (
R& R, R- RG R% RH RI RP RO RN ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netinfo_freebsd_netbsd� s !: c C@ sr i } t d d k r d } n d } t d | d t �} x0 | j � D]" } | j � \ } } | | | <qH W| S( u/
Return a dict of pid to ppid mappings
u kernelu SunOSu ps -a -o pid,ppid | tail +2u ps -ax -o pid,ppid | tail -n+2u cmd.runRR ( R R! R R( R) ( R& R% R, R- RH t ppid( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _ppid s c @ sP g } t d d k r� x�d D]� } d j | � } t d | d t �} x� | j � D]� } | j � } i | d d 6| d
d 6| d d
6| d d 6| d d 6} | d j d � r� | d | d <n | j | � qU Wq Wnd } t d | d t �} xo | j � D]a } | j � } | j i | d d 6| d
d 6| d d
6| d d 6| d d 6| d d 6� q Wd } t d | d t �} xd | j � D]V } | j � } | j i | d d 6| d
d 6| d d
6| d d 6| d d 6� q�Wt � } t d d k rt � } n t d d k r2t
� } n xt t | � � D]} | | d }
| | d } | | d } y | |
| | � Wn t
k
r�qEn Xt � f d � t j | � D� � }
y/ t t � f d � t j |
� D� � � } Wn t k
r qEn X� | d | | d <d j | � | d f � | | d <qEW| S(! u4
Return netstat information for BSD flavors
u kernelu NetBSDu inetu inet6u netstat -f {0} -an | tail -n+3u cmd.runRR i u protoi u recv-qi u send-qi u
local-addressi u remote-addressu tcpi u stateu netstat -p tcp -an | tail -n+3u netstat -p udp -an | tail -n+3u OpenBSDu FreeBSDc 3@ s- | ]# \ } } | � k r | | f Vq d S( N( ( R: R; t y( t ptr( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pys <genexpr>] s c 3@ s' | ] \ } } | � k r | Vq d S( N( ( R: R; RV ( RW ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pys <genexpr>b s u useru /u cmdu program( u inetu inet6( u FreeBSDu NetBSD( R R R! R R( R) R* R+ RU RQ RS R R0 t KeyErrort dictR t iteritemst nextt itert
StopIterationRC ( R& t addr_familyR% R, R- R. t entryRT t netinfot idxt localt remoteRP t conn_ppidt
master_pid( ( RW s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_bsd sv
%)
)c C@ si t j d � g } xOd D]G} d j | � } t d | d t �} x} | j � D]o } | j � } | j i | d k r d n d d 6| d
d 6| d d
6| d d 6| d d 6| d d 6� qR Wd j | � } t d | d t �} xt | j � D]f } | j � } | j i | d k r$d n d d 6| d d 6t | � d k rR| d n d d 6� q� Wq W| S( u6
Return netstat information for SunOS flavors
u- User and program not (yet) supported on SunOSu inetu inet6u# netstat -f {0} -P tcp -an | tail +5u cmd.runRR u tcp6u tcpu protoi u recv-qi u send-qi u
local-addressi u remote-addressi u stateu# netstat -f {0} -P udp -an | tail +5u udp6u udpi u ( u inetu inet6( t logt warningR R! R R( R) R+ R0 ( R& R^ R% R, R- R. ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_sunosk s.
/c C@ s� g } x�d D]�} d j | � } t d | d t �} x|| j � D]n} | j � } t | � d k ro qE n d } t } d | d k s� d | d k r� d } ng d | d k r� d } nN d
| d k s� d | d k r� d
} t } n d | d k r d } t } n | rtt | � d
k r�| j i | d 6| d d 6| d d 6| d d 6| d d 6| d d 6� q�qE t | � d k rE | j i | d 6| d d 6| d d 6� qE qE Wq
W| S( u6
Return netstat information for SunOS flavors
u inetu! netstat -n -a -f {0} | tail -n +3u cmd.runRR i u tcpi u tcp4u tcp6u udpu udp4u udp6i u protoi u recv-qi u send-qi u
local-addressi u remote-addressu state( u inetN( R R! R R( R) R0 R> R R+ ( R& R^ R% R, R- R. t
proto_seent tcp_flag( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_aix� sF
c C@ s� g } d } t d | d t �} xk | j � D]] } | j � } | j i d d 6| d d 6| d d 6| d
d 6| d d
6| d d 6� q/ Wd } t d | d t �} x� | j � D]� } | j � } t | � d k r'| j i d d 6| d d 6| d d 6d d 6| d
d
6| d d 6� q� t | � d k r� | j i d d 6| d d 6| d d 6d d 6| d
d
6| d d 6� q� q� q� W| S( u>
Return netstat routing information for Linux distros
u netstat -A inet -rn | tail -n+3u cmd.runRR u inetu addr_familyi u destinationi u gatewayi u netmaski u flagsi u interfaceu netstat -A inet6 -rn | tail -n+3i u inet6u i ( R! R R( R) R+ R0 ( R& R% R, R- R. ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_route_linux� sD c C@ s� g } d } t d | d t �} x| j � D] } | j � } | d d k rW q/ n | d d k r� d } | d d k r� | d
} n | j i d d 6d
d 6| d d 6d
d 6d d 6| d 6� q/ t | d � } d } | d d k r� | d } n | j i d d 6| d d 6d
d 6| d d 6d d 6| d 6� q/ Wd } t d | d t �} x�| j � D]�} | j � } | d d k r�qgn | d d k r d } | d d k r�| d
} n | j i d d 6d d 6| d d 6d d 6d d 6| d 6� qg| d d k r{d } | d d k r3| d } n | d d } | j i d d 6| d 6d d 6d d 6d d 6| d 6� qgt | d � } d } | d d k r�| d } n | j i d d 6| d d 6d d 6d d 6d d 6| d 6� qgW| S( un
Return ip routing information for Linux distros
(netstat is deprecated and may not be available)
u ip -4 route show table mainu cmd.runRR i u unreachableu defaultu i u devi u inetu addr_familyu 0.0.0.0u destinationi u gatewayu netmasku UGu flagsu interfacei u networku Uu ip -6 route show table allu inet6u ::/0u localu /128u ::( R! R R( R) R+ t convert_cidr( R& R% R, R- R. t ip_interfacet address_maskt
local_address( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _ip_route_linux� s�
c C@ s� g } d } t d | d t �} x� | j � D]� } | j � } t d d k r� t t j d d � � d k r� | j i d d
6| d d 6| d d
6| d d 6| d d 6| d d 6� q/ | j i d d
6| d d 6| d d
6d d 6| d d 6| d d 6� q/ Wd } t d | d t �} xg | j � D]Y } | j � } | j i d d
6| d d 6| d d
6d d 6| d d 6| d d 6� q1W| S( uB
Return netstat routing information for FreeBSD and macOS
u netstat -f inet -rn | tail -n+5u cmd.runRR u osu FreeBSDu osmajorreleasei i
u inetu addr_familyu destinationi u gatewayi u netmaski u flagsi u interfaceu u netstat -f inet6 -rn | tail -n+5u inet6( R! R R( R) R R t getR+ ( R& R% R, R- R. ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_route_freebsdD s@ . c C@ s g } d } t d | d t �} xg | j � D]Y } | j � } | j i d d 6| d d 6| d d 6d
d 6| d d
6| d d 6� q/ Wd } t d | d t �} xg | j � D]Y } | j � } | j i d d 6| d d 6| d d 6d
d 6| d d
6| d d 6� q� W| S( u7
Return netstat routing information for NetBSD
u netstat -f inet -rn | tail -n+5u cmd.runRR u inetu addr_familyi u destinationi u gatewayu u netmaski u flagsi u interfaceu netstat -f inet6 -rn | tail -n+5u inet6( R! R R( R) R+ ( R& R% R, R- R. ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_route_netbsdk s0 c C@ s g } d } t d | d t �} xg | j � D]Y } | j � } | j i d d 6| d d 6| d d 6d
d 6| d d
6| d d 6� q/ Wd } t d | d t �} xg | j � D]Y } | j � } | j i d d 6| d d 6| d d 6d
d 6| d d
6| d d 6� q� W| S( u8
Return netstat routing information for OpenBSD
u netstat -f inet -rn | tail -n+5u cmd.runRR u inetu addr_familyi u destinationi u gatewayu u netmaski u flagsi u interfaceu netstat -f inet6 -rn | tail -n+5u inet6( R! R R( R) R+ ( R& R% R, R- R. ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_route_openbsd� s0 c C@ sF g } d } t d | d t �} x | j � D]q } | j � } | j i d d 6| d d 6| d d 6d
d 6| d d
6t | � d k r� | d n d
d 6� q/ Wd } t d | d t �} x | j � D]q } | j � } | j i d d 6| d d 6| d d 6d
d 6| d d
6t | � d k r3| d n d
d 6� q� W| S( u6
Return netstat routing information for SunOS
u netstat -f inet -rn | tail +5u cmd.runRR u inetu addr_familyi u destinationi u gatewayu u netmaski u flagsi i u interfaceu netstat -f inet6 -rn | tail +5u inet6( R! R R( R) R+ R0 ( R& R% R, R- R. ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_route_sunos� s0 + +c C@ sF g } d } t d | d t �} x | j � D]q } | j � } | j i d d 6| d d 6| d d 6d
d 6| d d
6t | � d k r� | d n d
d 6� q/ Wd } t d | d t �} x | j � D]q } | j � } | j i d d 6| d d 6| d d 6d
d 6| d d
6t | � d k r3| d n d
d 6� q� W| S( u4
Return netstat routing information for AIX
u netstat -f inet -rn | tail -n +5u cmd.runRR u inetu addr_familyi u destinationi u gatewayu u netmaski u flagsi i u interfaceu! netstat -f inet6 -rn | tail -n +5u inet6( R! R R( R) R+ R0 ( R& R% R, R- R. ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _netstat_route_aix� s0 + +c C@ s� t d d k r6 t j j j d � s, t � St � SnE t d d k rM t � St d d k rd t � St d d k r{ t � St
d � � d
S( u�
Return information on open ports and states
.. note::
On BSD minions, the output contains PID info (where available) for each
netstat entry, fetched from sockstat/fstat output.
.. versionchanged:: 2014.1.4
Added support for OpenBSD, FreeBSD, and NetBSD
.. versionchanged:: 2015.8.0
Added support for SunOS
.. versionchanged:: 2016.11.4
Added support for AIX
CLI Example:
.. code-block:: bash
salt '*' network.netstat
u kernelu Linuxu netstatu OpenBSDu FreeBSDu NetBSDu SunOSu AIXu" Not yet supported on this platformN( u OpenBSDu FreeBSDu NetBSD( R R R t patht whichR9 R/ Rf Ri Rl R ( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt netstat� s
c C@ s t d d k r t j j j � St d d k ri } x� t � D]� } | d j d � s_ q@ n | d d k ru q@ n i d j | d j d � d
� d 6d j | d j d � d
� d 6d j | d
j d � d
� d 6d j | d
j d � d
� d 6| t | � d <q@ W| St d d k r
i } x� t
� D]� } | d j d � sTq5n | d d k rjq5n i d j | d j d � d
� d 6d j | d j d � d
� d 6d j | d
j d � d
� d 6d j | d
j d � d
� d 6| t | � d <q5W| Si Sd S( u
Return a dict containing information on all of the running TCP connections (currently linux and solaris only)
.. versionchanged:: 2015.8.4
Added support for SunOS
CLI Example:
.. code-block:: bash
salt '*' network.active_tcp
u kernelu Linuxu SunOSu protou tcpu stateu ESTABLISHEDu .u
local-addressi����u
local_addru
local_portu remote-addressu remote_addru remote_porti u AIXN( R R R R t
active_tcpRi R* RC R) R0 Rl ( R& t
connection( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR| s: !!!6!!!6u
traceroutec C@ s� g } d j t j j j | � � } t d | � } t j j j � sX t j j j � rj d d d g } n� t d d � } y� t j
d | � d } t j d | � g } xF | D]> } y | j
t | � � Wq� t k
r� | j
| � q� Xq� Wt | � d k r| j
d � n t j d | � Wn t k
rGd d d g } n Xx8| j � D]*} t } d | k rvt } n | j d
� r�t } n t j j j � r| j d � r�t } n | j d � r�t } n | j d
� r�t } n | j d � rt } qn | r t j d | � qUn d t j | d � k sad t j | d � k sat d d0 k r~y t j
d | � d }
Wn' t k
r�t j
d | � d }
n Xt j d |
� t j
d t j |
� � } y� |
d d k r�i |
d d 6d d 6} nb i |
d d 6|
d d 6|
d d 6} x8 t d t | � � D]! }
| |
| d j |
d � <q;WWqYt k
rzi } qYXn�| d d k r�| d d! k s�| d d k r�| d d k r�| j d" � } t | � d k r| d d k ri t | d � d 6d d 6} qYt | � d# k r�i t | d � d 6| d j � d d 6| d j � d j d$ � d 6t | d j � d � d% 6t | d j � d � d& 6t | d' j � d � d( 6} qYi } n� | j � } t | � d) k rSi | d d 6| d d 6| d d 6| d' d% 6| d* d& 6| d) d( 6| d d+ 6| d# d, 6| d- d. 6} n i } | j
| � | sUt j d/ | � qUqUW| S(1 u
Performs a traceroute to a 3rd party host
.. versionchanged:: 2015.8.0
Added support for SunOS
.. versionchanged:: 2016.11.4
Added support for AIX
CLI Example:
.. code-block:: bash
salt '*' network.traceroute archlinux.org
u traceroute {0}u cmd.runi u traceroute --versionu% .*[Vv]ersion (\d+)\.([\w\+]+)\.*(\w*)u traceroute_version_raw: %si u traceroute_version: %su u
tracerouteu trying to get source foru source should beu outgoing MTUu fragmentation requiredu# Skipping traceroute output line: %su Darwini u FreeBSDu kernelu SunOSu AIXu" \s*(\d*)\s+(.*)\s+\((.*)\)\s+(.*)$u \s*(\d*)\s+(\*\s+\*\s+\*)u
traceline: %su (\d+\.\d+)\s*msu * * *u countu *u hostnamei u ipu ms{0}i u i u ()u ms1u ms2i u ms3i i u ping1u ping2i u ping3u' Cannot parse traceroute output line: %s( u SunOSu AIX( R R R R R R! R t is_sunost is_aixR< t findallRg t debugR+ R RA R0 t
IndexErrorR( R R R* R t text_typeR R R) t stript floatt warn( R" R& R% R, t traceroute_versiont version_outt version_rawt tR- t skip_linet tracelinet delayst resultRa R. ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt
traceroute: s� $
#
"
!
u digc C@ s, d j t j j j | � � } t d | � S( u�
Performs a DNS lookup with dig
CLI Example:
.. code-block:: bash
salt '*' network.dig archlinux.org
u dig {0}u cmd.run( R R R R R R! ( R" R% ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt dig� s u arpc C@ sL i } t d d � } x/| j � D]!} | j � } t | � d k rM q# n t d d k r� d | d k rs q# n | d | | d <q# t d d k r� | d
d k s# | d d k r� q# n | d
| | d <q# t d d
k r | d
d k r� q# n | d j d � j d � | | d <q# | d j d � j d � | | d <q# W| S( u�
Return the arp table from the minion
.. versionchanged:: 2015.8.0
Added support for SunOS
CLI Example:
.. code-block:: bash
salt '*' network.arp
u cmd.runu arp -ani u kernelu SunOSu :i����i u OpenBSDi u Hostu (incomplete)u AIXu bucketu Thereu (u )i ( u bucketu There( R! R( R) R0 R R� ( R& R, R- R. ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt arp� 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
interfaces( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� � 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 eth0
( R R R t hw_addr( t iface( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� s
u hwaddrc C@ s t j j j | � S( u�
Return the inet address for a given interface
.. versionadded:: 2014.7.0
CLI Example:
.. code-block:: bash
salt '*' network.interface eth0
( R R R t interface( R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� s c C@ s t j j j | � S( u�
Return the inet address for a given interface
.. versionadded:: 2014.7.0
CLI Example:
.. code-block:: bash
salt '*' network.interface_ip eth0
( R R R t interface_ip( R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� ' s c C@ s t j j j | � S( u�
Returns a list of IPv4 subnets to which the host belongs
CLI Example:
.. code-block:: bash
salt '*' network.subnets
salt '*' network.subnets interfaces=eth1
( R R R t subnets( R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� 6 s c C@ s t j j j � S( u�
Returns a list of IPv6 subnets to which the host belongs
CLI Example:
.. code-block:: bash
salt '*' network.subnets
( R R R t subnets6( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� D 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( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� Q s
c C@ s t j j j | | � S( u�
Returns True if given IP is within specified subnet, otherwise False.
CLI Example:
.. code-block:: bash
salt '*' network.ip_in_subnet 172.17.0.4 172.16.0.0/12
( R R R R� ( t ip_addrR� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt ip_in_subnet^ s
c C@ s_ i d d 6d d 6} t | � } t j | � } t j | j � | d <t j | j � | d <| S( u�
returns the network and subnet mask of a cidr addr
.. versionadded:: 2016.3.0
CLI Example:
.. code-block:: bash
salt '*' network.convert_cidr 172.31.0.0/16
u networku netmaskN( R> t calc_netR t
ip_networkR R� t network_addresst netmask( R� R& t network_info( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyRn k s
c C@ s t j j j | | � S( uI
Returns the CIDR of a subnet based on
an IP address (CIDR notation supported)
and optional netmask.
CLI Example:
.. code-block:: bash
salt '*' network.calc_net 172.17.0.5 255.255.255.240
salt '*' network.calc_net 2a02:f6e:a000:80:84d8:8332:7866:4e07/64
.. versionadded:: 2015.8.0
( R R R R� ( R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� � 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. 127.0.0.1 is
ignored, unless 'include_loopback=True' is indicated. If 'interface' is
provided, then only IP addresses from that interface will be returned.
Providing a CIDR via 'cidr="10.0.0.0/8"' will return only the addresses
which are within that subnet. If 'type' is 'public', then only public
addresses will be returned. Ditto for 'type'='private'.
CLI Example:
.. code-block:: bash
salt '*' network.ip_addrs
R� t include_loopbacku publicu privateN( R R R t ip_addrsR� t
is_private( R� R� R� t typet addrsR5 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� � 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. ::1 is ignored,
unless 'include_loopback=True' is indicated. If 'interface' is provided,
then only IP addresses from that interface will be returned.
Providing a CIDR via 'cidr="2000::/3"' will return only the addresses
which are within that subnet.
CLI Example:
.. code-block:: bash
salt '*' network.ip_addrs6
R� R� N( R R R t ip_addrs6R� ( R� R� R� R� R5 ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� � s
2u ipaddrs6c C@ s
t j � S( ui
Get hostname
CLI Example:
.. code-block:: bash
salt '*' network.get_hostname
( R t gethostname( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt get_hostname� s c C@ s
t j � S( ux
Get fully qualified domain name
CLI Example:
.. code-block:: bash
salt '*' network.get_fqdn
( R t getfqdn( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt get_fqdn� s c C@ s^ | d k r t St j j j d � p7 t j j j d � } t j j j � r� t j j j � rd d n t j j j d � } t j j j d � } n | j d � rEt
d d j | � � } d | d k r | d
} xl | j � D]8 } | j
d � } d | d k r� | d
j � } q� q� Wq�t j d j | � � t
d � } n> t j j j � sft j � } n t
d | � j
d � d } | j d � r�t
d d j | | � � } | d d k r8t j d j | | d � � t SnV t j j j � st
d d j | | � � n' t
d d j | | j
d � d � � t j j j d d � �5 } g | j � D] } t j j j | � ^ q`}
Wd QXt j j j d d � �� } x� |
D]� } | j
� } yY | | | j | � <t j j j � r| j
d � d | | j | j
d � d � <n Wn t k
r'n X| j t j j j d j | � d � � q�WWd QXt d d k r�t j j j d! d � �5 } g | j � D] } t j j j | � ^ q�}
Wd QXt j j j d! d � �� } x� |
D]� } | j d" � r\| j
d# d
� d
j � } t j j j | � } | j t j j j d$ j t j j j! | � | � � � q�| j t j j j | � � q�WWd QXnt d d1 k rLt j j j d' d � �' } | j t j j j | d � � Wd QXt d( d) k r�t j j j | � } d* } | d+ j | � 7} t
d | � d d k rIt" d, j | � � � qIq�nT t d d- k r�t j j j d. d � �' } | j t j j j | d � � Wd QXn t j j j � rZt j j j d/ d � �4 } | j t j j j | j
d � d d � � Wd QXt j j j d0 d � �= } | j t j j j d j | j
d � d
� d � � Wd QXn t# S(2 u�
Modify hostname
.. versionchanged:: 2015.8.0
Added support for SunOS (Solaris 10, Illumos, SmartOS)
CLI Example:
.. code-block:: bash
salt '*' network.mod_hostname master.saltstack.com
u hostnamectlu hostnameu /usr/bin/unameu unameu check-hostnameu cmd.run_allu
{0} statusi u retcodeu stdoutu :u Static hostnamei u {0} was unable to get hostnameu network.get_hostnameu cmd.runu i����u {0} set-hostname {1}u* {0} was unable to set hostname. Error: {1}u stderru {0} {1}u
{0} -S {1}u .u
/etc/hostsu rNu wu u
u os_familyu RedHatu /etc/sysconfig/networku HOSTNAMEu =u HOSTNAME={1}{0}{1}
u Debianu NILinuxRTu
/etc/hostnameu lsb_distrib_idu nilrtu /usr/local/natinst/bin/nirtcfgu; --set section=SystemSettings,token='Host_Name',value='{0}'u Couldn't set hostname to: {0}
u OpenBSDu /etc/mynameu
/etc/nodenameu /etc/defaultdomain( u Debianu NILinuxRT($ R> R R R Ry Rz R R~ t
is_smartost endswithR! R R( R) R� Rg R� R R� t filest fopent readlinest stringutilst
to_unicodet indexRA t writet to_strRC R R* t rstript is_quotedt dequoteR R ( t hostnamet hostname_cmdt uname_cmdt check_hostname_cmdR� R, R- t
o_hostnamet fp_t _lt host_ct fh_R" t network_ct nett old_hostnamet
quote_typet str_hostnamet nirtcfg_cmd( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt mod_hostname� s� *-
'1
4
31
)& )!-c 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 | � � } y� | 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 \ } }
} } }
Wn8 t j k
r�t | d <d j | | | � | d <| SXy� t j | |
| � } | j | � | d k rPt j � } | j t j j � j d � � | j � } | j | |
� | j d � \ } } | j � n | j |
� | j d � Wn> t k
r�} 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:: 2014.7.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* Unable to resolve host {0} on {1} port {2}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 Rs R R t validateR� t ipv4_addrt ipv6_addrR R R R t SOL_UDPt SOL_TCPR t AF_INET6t getaddrinfot gaierrort
settimeoutt hashlibt md5t updatet datetimet nowt strftimet hexdigestR t recvfromt closet connectt shutdownt ExceptionR ( R" t portt kwargsR& RP R# t familyt addresst __protot __familyt socktypet _protot garbaget _addresst sktt md5ht msgt recvt svrt exc( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� i sh
0 2
c C@ s t j | � j S( u�
Check if the given IP address is a private address
.. versionadded:: 2014.7.0
.. versionchanged:: 2015.8.0
IPv6 support
CLI Example:
.. code-block:: bash
salt '*' network.is_private 10.0.0.3
( R t
ip_addressR� ( R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� � s c C@ s t j | � j S( u�
Check if the given IP address is a loopback address
.. versionadded:: 2014.7.0
.. versionchanged:: 2015.8.0
IPv6 support
CLI Example:
.. code-block:: bash
salt '*' network.is_loopback 127.0.0.1
( R R� t is_loopback( R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR� � s c C@ s t j | � j S( u�
Returns the reversed IP address
.. versionchanged:: 2015.8.0
IPv6 support
CLI Example:
.. code-block:: bash
salt '*' network.reverse_ip 172.17.0.4
( R R� t reverse_pointer( R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt
reverse_ip� s
c C@ s2 i t d 6} d j | � } t d | � } t j d � } d } x� | j � D]� } | j | � } | r� t | j d � � | | j d � j � j
d d � | <t | d <qN | j d
� r� d } qN | j d � rN d
} qN qN W| d s.| j
� } | d j d � r!d j | d � } n | | d <n | S( uC
Return network interface buffer information using ethtool
u resultu /sbin/ethtool -g {0}u cmd.runu ^(.+):\s+(\d+)$u max-i i u u -u maximums:u -maxu settings:u i u sh:u comment( R R R! R< R= R( R? R t groupt lowert replaceR R� R) RC ( R� R& R% R, t patt suffixR- t rest parts( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _get_bufsize_linux� s(
8
c C@ s3 t d d k r/ t j j d � r/ t | � Sn i S( u�
Return network buffer sizes as a dict (currently linux only)
CLI Example:
.. code-block:: bash
salt '*' network.get_bufsize eth0
u kernelu Linuxu
/sbin/ethtool( R t osRy t existsR� ( R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt get_bufsize s
c
O@ s i t d 6d d 6} d | } | s( | S| re d d j g | D] } t j | � ^ q> � | d <| Sd } xW d d d
d g D]C } | j | � } | d
k r~ | d | d t j | � 7} q~ q~ W| s� | S| | 7} t d | � } | r� | | d <n | j � | d <t | d <| S( u=
Modify network interface buffer sizes using ethtool
u resultu? Requires rx=<val> tx==<val> rx-mini=<val> and/or rx-jumbo=<val>u commentu /sbin/ethtool -G u Unknown arguments: u u u rxu txu rx-miniu rx-jumbou cmd.runN( R RC R R� Rs R> R! R� R (
R� t argsR� R& R% t itemt eargst kwt valueR, ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt _mod_bufsize_linux' s.
' &
c O@ s9 t d d k r5 t j j d � r5 t | | | � Sn t S( u�
Modify network interface buffers (currently linux only)
CLI Example:
.. code-block:: bash
salt '*' network.mod_bufsize tx=<val> rx=<val> rx-mini=<val> rx-jumbo=<val>
u kernelu Linuxu
/sbin/ethtool( R R� Ry R� R R ( R� R� R� ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt mod_bufsizeE s
c C@ sL | d k r< | d k r< | d k r< t d j | � � � n t d d k ry t j j j d � sm t � } qt � } n� t d d k r� t
� } n| t d d k r� t � } n` t d d k r� t � } nD t d d k r� t
� } n( t d d k rt � } n t d � � | s| Sg | D] } | d | k r"| ^ q"} | Sd S( u.
Return currently configured routes from routing table
.. versionchanged:: 2015.8.0
Added support for SunOS (Solaris 10, Illumos, SmartOS)
.. versionchanged:: 2016.11.4
Added support for AIX
CLI Example:
.. code-block:: bash
salt '*' network.routes
u inetu inet6u Invalid address family {0}u kernelu Linuxu netstatu SunOSu osu FreeBSDu MacOSu Darwinu NetBSDu OpenBSDu AIXu" Not yet supported on this platformu addr_familyN( u FreeBSDu MacOSu Darwin( u NetBSD( u OpenBSD( u AIX( R> R R R R R Ry Rz Rr Rm Rw Rt Ru Rv Rx ( R� t routes_t routeR& ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt routesV s* $ )c C@ sm | d k r< | d k r< | d k r< t d j | � � � n t � } i } t d d k r~ d d g | d <d d g | d <nI t d d k s� t d d k r� d g | d <d g | d <n t d � � g } x� | D]� } | r-| d | | k ret d d k r| d | k rq� n | j | � qeq� | d | d k sU| d | d k r� | j | � q� q� W| S( u*
Return default route(s) from routing table
.. versionchanged:: 2015.8.0
Added support for SunOS (Solaris 10, Illumos, SmartOS)
.. versionchanged:: 2016.11.4
Added support for AIX
CLI Example:
.. code-block:: bash
salt '*' network.default_route
u inetu inet6u Invalid address family {0}u kernelu Linuxu 0.0.0.0u defaultu ::/0u osu FreeBSDu NetBSDu OpenBSDu MacOSu Darwinu SunOSu AIXu" Not yet supported on this platformu destinationu addr_familyN( u FreeBSDu NetBSDu OpenBSDu MacOSu Darwin( u SunOSu AIX( R> R R R R R+ ( R� t _routest
default_routeR& R ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyR � s. $
c C@ s t d d k r� d j | � } t d | d t �} t j d � } | j | j � d � } i | d 6| j d � d 6| j d
� d
6| j d � d 6} | St d d k r�d
j | � } t d | d t �} i | d 6d d 6d d
6d d 6} x� | j � D]� } | j d � } d | d k r>| d j � | d <n d | d k re| d j � | d <n d
| d k r| d j � | d
<t
j j j | d j � � | d <qqW| St d d k r�d j | � } t d | d t �} i | d 6d d 6d d
6d d 6} x� | j � D]� } | j d � } d | d k rW| d j � | d <n d | d k r~| d j � | d <n d
| d k r�| d j � | d
<n d | d k r| d j � | d <qqW| St d d k r�d j | � } t d | d t �} i | d 6d d 6d d
6d d 6} x� | j � D]� } | j d � } d | d k rt| d j � | d <n d | d k r�| d j � | d <n d
| d k r�| d j � | d
<n d | d k r8| d j � | d <q8q8W| St d � � d S( ud
Return routing information for given destination ip
.. versionadded:: 2015.5.3
.. versionchanged:: 2015.8.0
Added support for SunOS (Solaris 10, Illumos, SmartOS)
Added support for OpenBSD
.. versionchanged:: 2016.11.4
Added support for AIX
CLI Example::
salt '*' network.get_route 10.10.10.10
u kernelu Linuxu ip route get {0}u cmd.runRR u` (via\s+(?P<gateway>[\w\.:]+))?\s+dev\s+(?P<interface>[\w\.\:\-]+)\s+.*src\s+(?P<source>[\w\.:]+)i u destinationu gatewayu interfaceu sourceu SunOSu /usr/sbin/route -n get {0}u :u route toi u OpenBSDu route -n get {0}u
if addressu AIXu interf addru" Not yet supported on this platformN( R R R! R R< R= t searchR( R� R R> R) R� R R R R� R ( t ipR% R, t regexpt mR& R- ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt get_route� s�
*
c C@ s� t � } g } t j | � } t | � } x� t j | � D]w \ } } d | k r: x\ | d D]M } | d d | !| k r] d | k r� | j | d � q� | j | � q] q] Wq: q: W| S( u�
Retrieve the interface name from a specific CIDR
.. versionadded:: 2016.11.0
CLI Example:
.. code-block:: bash
salt '*' network.ifacestartswith 10.0
u inetu addressi u label( R� R R� R0 RZ R+ ( R� t net_listt intfnamest patternt sizet ifnamet ifvalt inet( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt ifacestartswith8 s c C@ s? | j d � } g | D] } d t | � ^ q } d j | � S( u�
Retrieve the hexadecimal representation of an IP address
.. versionadded:: 2016.11.0
CLI Example:
.. code-block:: bash
salt '*' network.iphexval 10.0.0.1
u .u %02Xu ( R) R RC ( R
t aR; t hexval( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt iphexvalS s #(] t __doc__t
__future__R R R R� R� t loggingR< R� R t salt.utils.decorators.pathR t salt.utils.functoolst salt.utils.filest salt.utils.networkt salt.utils.patht salt.utils.platformt salt.utils.stringutilst salt.utils.validate.nett salt.exceptionsR t salt.extR t salt.ext.six.movesR t salt._compatR t getLoggert __name__Rg R
R R R' R/ R9 RQ RS RU Rf Ri Rl Rm Rr Rt Ru Rv Rw Rx R{ R| R t
decoratorsRy Rz R� R� R� R� R� t functoolst alias_functiont hwaddrR� R� R> R� R� R� R� Rn R� R� t ipaddrsR� t ipaddrs6R� R� R� R� R� R� R� R� R� R R R R R
R R ( ( ( s8 /usr/lib/python2.7/site-packages/salt/modules/network.pyt <module> s�
. ! 9 / M ! / ) ` ' % 2!�!!&
� _ , / �
Mini Shell