Current File : //usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z e j e � Z d d l Z
d d l m Z d Z d g Z
d Z d � Z e d � � Z e d
� � Z e d d � � Z e d � � Z e d
� � Z e d � � Z e d � � Z d S( u�
NAPALM NTP
==========
Manages NTP on network devices.
:codeauthor: Mircea Ulinic <mircea@cloudflare.com> & Jerome Fleury <jf@cloudflare.com>
:maturity: new
:depends: napalm
:platform: unix
Dependencies
------------
- :mod:`NAPALM proxy minion <salt.proxy.napalm>`
- :mod:`NET basic features <salt.modules.napalm_network>`
.. seealso::
:mod:`NTP peers management state <salt.states.netntp>`
.. versionadded:: 2016.11.0
i ( t absolute_importt unicode_literalst print_functionN( t proxy_napalm_wrapu ntpu napalmu
napalm_ntpc C@ s t j j j t t t � S( u_
NAPALM library must be installed for this module to work and run in a (proxy) minion.
( t saltt utilst napalmt virtualt __opts__t __virtualname__t __file__( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyt __virtual__/ s c K@ sZ t j j j t d i � } | j d � s. | St | j d i � j � � } | | d <| S( u~
Returns a list the NTP peers configured on the network device.
:return: configured NTP peers as list.
CLI Example:
.. code-block:: bash
salt '*' ntp.peers
Example output:
.. code-block:: python
[
'192.168.0.1',
'172.17.17.1',
'172.17.17.2',
'2400:cb00:6:1024::c71b:840a'
]
u
get_ntp_peersu resultu out( R R R t callt
napalm_devicet gett listt keys( t kwargst ntp_peerst ntp_peers_list( ( s; /usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyt peers> s
c K@ sZ t j j j t d i � } | j d � s. | St | j d i � j � � } | | d <| S( uP
Returns a list of the configured NTP servers on the device.
CLI Example:
.. code-block:: bash
salt '*' ntp.servers
Example output:
.. code-block:: python
[
'192.168.0.1',
'172.17.17.1',
'172.17.17.2',
'2400:cb00:6:1024::c71b:840a'
]
u get_ntp_serversu resultu out( R R R R R
R R R ( R t ntp_serverst ntp_servers_list( ( s; /usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyt serversj s
c K@ s� t j j j t d i � } | j d � s. | S| j d � } | rw g | D]$ } | j d d � | k rJ | ^ qJ } n | j i | d 6� | S( u
Returns a dictionary containing synchronization details of the NTP peers.
:param peer: Returns only the details of a specific NTP peer.
:return: a list of dictionaries, with the following keys:
* remote
* referenceid
* synchronized
* stratum
* type
* when
* hostpoll
* reachability
* delay
* offset
* jitter
CLI Example:
.. code-block:: bash
salt '*' ntp.stats
Example output:
.. code-block:: python
[
{
'remote' : '188.114.101.4',
'referenceid' : '188.114.100.1',
'synchronized' : True,
'stratum' : 4,
'type' : '-',
'when' : '107',
'hostpoll' : 256,
'reachability' : 377,
'delay' : 164.228,
'offset' : -13.866,
'jitter' : 2.695
}
]
u
get_ntp_statsu resultu outu remoteu ( R R R R R
R t update( t peerR t proxy_outputR t ntp_peer( ( s; /usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyt stats� s 0 4 c
O@ sJ | j d t � } | j d t � } t d d d | d | d | d t �S( uy
Configures a list of NTP peers on the device.
:param peers: list of IP Addresses/Domain Names
:param test (bool): discard loaded config. By default ``test`` is False
(will not dicard the changes)
:commit commit (bool): commit loaded config. By default ``commit`` is True
(will commit the changes). Useful when the user does not want to commit
after each change, but after a couple.
By default this function will commit the config changes (if any). To load without committing, use the `commit`
option. For dry run use the `test` argument.
CLI Example:
.. code-block:: bash
salt '*' ntp.set_peers 192.168.0.1 172.17.17.1 time.apple.com
salt '*' ntp.set_peers 172.17.17.1 test=True # only displays the diff
salt '*' ntp.set_peers 192.168.0.1 commit=False # preserves the changes, but does not commit
u testu commitu net.load_templateu
set_ntp_peersR t testt committ inherit_napalm_device( t popt Falset Truet __salt__R
( R t optionsR R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyt set_peers� s
c
O@ sJ | j d t � } | j d t � } t d d d | d | d | d t �S( u�
Configures a list of NTP servers on the device.
:param servers: list of IP Addresses/Domain Names
:param test (bool): discard loaded config. By default ``test`` is False
(will not dicard the changes)
:commit commit (bool): commit loaded config. By default ``commit`` is True
(will commit the changes). Useful when the user does not want to commit
after each change, but after a couple.
By default this function will commit the config changes (if any). To load without committing, use the `commit`
option. For dry run use the `test` argument.
CLI Example:
.. code-block:: bash
salt '*' ntp.set_servers 192.168.0.1 172.17.17.1 time.apple.com
salt '*' ntp.set_servers 172.17.17.1 test=True # only displays the diff
salt '*' ntp.set_servers 192.168.0.1 commit=False # preserves the changes, but does not commit
u testu commitu net.load_templateu set_ntp_serversR R R R ( R R! R" R# R
( R R$ R R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyt set_servers� s
c
O@ sJ | j d t � } | j d t � } t d d d | d | d | d t �S( u�
Removes NTP peers configured on the device.
:param peers: list of IP Addresses/Domain Names to be removed as NTP peers
:param test (bool): discard loaded config. By default ``test`` is False
(will not dicard the changes)
:param commit (bool): commit loaded config. By default ``commit`` is True
(will commit the changes). Useful when the user does not want to commit
after each change, but after a couple.
By default this function will commit the config changes (if any). To load
without committing, use the ``commit`` option. For a dry run, use the
``test`` argument.
CLI Example:
.. code-block:: bash
salt '*' ntp.delete_peers 8.8.8.8 time.apple.com
salt '*' ntp.delete_peers 172.17.17.1 test=True # only displays the diff
salt '*' ntp.delete_peers 192.168.0.1 commit=False # preserves the changes, but does not commit
u testu commitu net.load_templateu delete_ntp_peersR R R R ( R R! R" R# R
( R R$ R R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyt delete_peers s
c
O@ sJ | j d t � } | j d t � } t d d d | d | d | d t �S( u�
Removes NTP servers configured on the device.
:param servers: list of IP Addresses/Domain Names to be removed as NTP
servers
:param test (bool): discard loaded config. By default ``test`` is False
(will not dicard the changes)
:param commit (bool): commit loaded config. By default ``commit`` is True
(will commit the changes). Useful when the user does not want to commit
after each change, but after a couple.
By default this function will commit the config changes (if any). To load
without committing, use the ``commit`` option. For dry run use the ``test``
argument.
CLI Example:
.. code-block:: bash
salt '*' ntp.delete_servers 8.8.8.8 time.apple.com
salt '*' ntp.delete_servers 172.17.17.1 test=True # only displays the diff
salt '*' ntp.delete_servers 192.168.0.1 commit=False # preserves the changes, but does not commit
u testu commitu net.load_templateu delete_ntp_serversR R R R ( R R! R" R# R
( R R$ R R ( ( s; /usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyt delete_serversB s
( u
napalm_ntp( t __doc__t
__future__R R R t loggingt getLoggerR
t logt salt.utils.napalmR R R t __proxyenabled__t __virtual_aliases__R R R t NoneR R% R& R' R( ( ( ( s; /usr/lib/python2.7/site-packages/salt/modules/napalm_ntp.pyt <module> s" ,)E#"$
Mini Shell