Mini Shell
3
���U(6 � @ s� d Z ddlZddlZddlZddlZG dd� de�ZG dd� d�ZG dd� d�ZG d d
� d
e�Z G d d � d �Z
d
d� Z d!dd�Z d"dd�Z
dd� Zdd� Zdd� Zdd� Zd d � Zd#d d �ZdS )$zePython NTP library.
Implementation of client-side NTP (RFC-1305), and useful NTP-related
functions.
� Nc @ s e Zd ZdZdS )� NTPExceptionz Exception raised by this module.N)�__name__�
__module__� __qualname__�__doc__� r r � /usr/lib/python3.6/ntplib.pyr % s r c ! @ s� e Zd ZdZejejd�dd� � Zejddd�Z ee j
d d Z dd d
d d d
dddddddddddddddd d d d d d!d"d#d$d%d&d'� Z d(d)d*�Z
d+d,d-d.d/d0d1d2d3�Zd4d5d6d7d8�Zd9S ):�NTPz Helper class defining constants.r � il � � i z)Geostationary Orbit Environment SatellitezGlobal Position SystemzGalileo Positioning SystemzGeneric pulse-per-secondz!Inter-Range Instrumentation Groupz$LF Radio WWVB Ft. Collins, CO 60 kHzz'LF Radio DCF77 Mainflingen, DE 77.5 kHzz LF Radio HBG Prangins, HB 75 kHzz LF Radio MSF Anthorn, UK 60 kHzz2LF Radio JJY Fukushima, JP 40 kHz, Saga, JP 60 kHzz!MF Radio LORAN C station, 100 kHzz MF Radio Allouis, FR 162 kHzz HF Radio CHU Ottawa, Ontarioz HF Radio WWV Ft. Collins, COzHF Radio WWVH Kauai, HIzNIST telephone modemzUSNO telephone modemzEuropean telephone modemzuncalibrated local clockzcalibrated Cesium clockzcalibrated Rubidium clockz OMEGA radionavigation systemzDCN routing protocolzTSP time protocolzDigital Time ServicezAtomic clock (calibrated)zVLF radio (OMEGA,, etc.)zExternal 1 PPS inputz(Internal clock)z(Initialization)ZNULL) ZGOESzGPS zGAL zPPS ZIRIGZWWVBzDCF zHBG zMSF zJJY ZLORCzTDF zCHU zWWV ZWWVHZNISTZACTSZUSNOzPTB ZLOCLZCESMZRBDMZOMEGzDCN zTSP zDTS ZATOMzVLF Z1PPSZFREEZINITz zunspecified or invalidzprimary reference (%s))r r Zreservedzsymmetric activezsymmetric passiveZclientZserverZ broadcastz!reserved for NTP control messageszreserved for private use)r r � r
� � � � z
no warningz%last minute of the day has 61 secondsz%last minute of the day has 59 secondsz unknown (clock unsynchronized))r r r
r
N)r r r r �datetimeZdate�timeZgmtimeZ
_SYSTEM_EPOCHZ
_NTP_EPOCHZdays� NTP_DELTA� REF_ID_TABLE�
STRATUM_TABLE�
MODE_TABLE�
LEAP_TABLEr r r r r * sf r c @ s. e Zd ZdZdZd
dd�Zdd � Zd
d � Zd S )� NTPPacketz:NTP packet class.
This represents an NTP packet.
z !B B B b 11Ir
r
r c C sR d| _ || _|| _d| _d| _d| _d| _d| _d| _d| _ d| _
d| _ || _ dS )z�Constructor.
Parameters:
version -- NTP version
mode -- packet mode (client, server)
tx_timestamp -- packet transmit timestamp
r N)
�leap�version�mode�stratum�poll� precision�
root_delay�root_dispersion�ref_id�
ref_timestamp�orig_timestamp�recv_timestamp� tx_timestamp)�selfr r r& r r r �__init__| s zNTPPacket.__init__c C s� y�t jtj| jd> | jd> B | jB | j| j| j t
| j �d> t | j d�B t
| j
�d> t | j
d�B | jt
| j�t | j�t
| j�t | j�t
| j�t | j�t
| j�t | j��}W n t jk
r� td��Y nX |S )z�Convert this NTPPacket to a buffer that can be sent over a socket.
Returns:
buffer representing this packet
Raises:
NTPException -- in case of invalid field
r r
� zInvalid NTP packet fields.)�struct�packr �_PACKET_FORMATr r r r r r �_to_intr �_to_fracr! r" r# r$ r% r& �errorr )r' Zpackedr r r �to_data� s* zNTPPacket.to_datac C s y"t jtj|dt jtj�� �}W n t jk
r@ td��Y nX |d d? d@ | _|d d? d@ | _|d d@ | _ |d | _
|d | _ |d | _ t
|d �d | _t
|d
�d | _|d | _t|d |d �| _t|d |d
�| _t|d |d �| _t|d |d �| _dS )z�Populate this instance from a NTP packet payload received from
the network.
Parameters:
data -- buffer payload
Raises:
NTPException -- in case of invalid packet format
r zInvalid NTP packet.r r
r r r
r r) r � � �
� � �
� Ni i )r* �unpackr r, �calcsizer/ r r r r r r r �floatr r! r" �_to_timer# r$ r% r& )r' �dataZunpackedr r r � from_data� s$
zNTPPacket.from_dataN)r
r
r )r r r r r, r( r0 r= r r r r r s s
# r c @ sl e Zd ZdZdd� Zedd� �Zedd� �Zedd � �Zed
d � �Z ed d
� �Z
edd� �Z edd� �Z dS )�NTPStatsz�NTP statistics.
Wrapper for NTPPacket, offering additional statistics like offset and
delay, and timestamps converted to system time.
c C s t j| � d| _dS )z Constructor.r N)r r( �dest_timestamp)r' r r r r( � s
zNTPStats.__init__c C s | j | j | j| j d S )�offsetr
)r% r$ r& r? )r' r r r r@ � s
zNTPStats.offsetc C s | j | j | j| j S )zround-trip delay)r? r$ r& r% )r' r r r �delay� s
zNTPStats.delayc C s
t | j�S )z"Transmit timestamp in system time.)�ntp_to_system_timer& )r' r r r �tx_time� s zNTPStats.tx_timec C s
t | j�S )z!Receive timestamp in system time.)rB r% )r' r r r � recv_time� s zNTPStats.recv_timec C s
t | j�S )z#Originate timestamp in system time.)rB r$ )r' r r r � orig_time s zNTPStats.orig_timec C s
t | j�S )z#Reference timestamp in system time.)rB r# )r' r r r �ref_time s zNTPStats.ref_timec C s
t | j�S )z%Destination timestamp in system time.)rB r? )r' r r r � dest_time
s zNTPStats.dest_timeN)
r r r r r( �propertyr@ rA rC rD rE rF rG r r r r r> � s r> c @ s" e Zd ZdZdd� Zd
dd�Zd S ) � NTPClientzNTP client session.c C s dS )z Constructor.Nr )r' r r r r( s zNTPClient.__init__r
�ntpr c C s� t j||�d }|d |d }}t j |t j�}z�yh|j|� td|ttj� �d�} |j| j� |� d}
x"|
d |d kr�|j d�\} }
qjW ttj� �} W n" t j
k
r� t d| ��Y nX W d|j � X t
� }
|
j| � | |
_|
S ) z�Query a NTP server.
Parameters:
host -- server name/address
version -- NTP version to use
port -- server port
timeout -- timeout on socket operations
Returns:
NTPStats object
r r r
)r r r& N� z No response received from %s.)N)�socketZ getaddrinfoZ
SOCK_DGRAMZ
settimeoutr �system_to_ntp_timer Zsendtor0 Zrecvfrom�timeoutr �closer> r= r? )r' �hostr ZportrN ZaddrinfoZfamilyZsockaddr�sZ query_packetZsrc_addrZresponse_packetr? Zstatsr r r �request s&
zNTPClient.requestN)r
rJ r )r r r r r( rR r r r r rI s rI c C s t | �S )z|Return the integral part of a timestamp.
Parameters:
timestamp -- NTP timestamp
Retuns:
integral part
)�int)� timestampr r r r- H s r- � c C s t t| t| � �d| �S )z�Return the fractional part of a timestamp.
Parameters:
timestamp -- NTP timestamp
n -- number of bits of the fractional part
Retuns:
fractional part
r
)rS �absr- )rT �nr r r r. T s
r. c C s | t |�d| S )z�Return a timestamp from an integral and fractional part.
Parameters:
integ -- integral part
frac -- fractional part
n -- number of bits of the fractional part
Retuns:
timestamp
r
)r: )ZintegZfracrW r r r r; a s r; c C s
| t j S )z�Convert a NTP time to system time.
Parameters:
timestamp -- timestamp in NTP time
Returns:
corresponding system time
)r r )rT r r r rB o s rB c C s
| t j S )z�Convert a system time to a NTP time.
Parameters:
timestamp -- timestamp in system time
Returns:
corresponding NTP time
)r r )rT r r r rM { s rM c C s | t jkrt j| S td��dS )z�Convert a leap indicator to text.
Parameters:
leap -- leap indicator value
Returns:
corresponding message
Raises:
NTPException -- in case of invalid leap indicator
zInvalid leap indicator.N)r r r )r r r r � leap_to_text� s
rX c C s | t jkrt j| S td��dS )z�Convert a NTP mode value to text.
Parameters:
mode -- NTP mode
Returns:
corresponding message
Raises:
NTPException -- in case of invalid mode
z
Invalid mode.N)r r r )r r r r � mode_to_text� s
rY c C sT | t jkrt j| | S d| k o*dk n r8d| S | dkrHd| S td��dS )z�Convert a stratum value to text.
Parameters:
stratum -- NTP stratum
Returns:
corresponding message
Raises:
NTPException -- in case of invalid stratum
r r) zsecondary reference (%s)zunsynchronized (%s)z Invalid stratum or reserved.N)r r r )r r r r �stratum_to_text� s
rZ r
c C s� | d? d@ | d? d@ | d? d@ | d@ f}d| ko:dkn rfd| }|t jkr\t j| S d| S n(d | koxdk n r�d
| S td ��d S )
a Convert a reference clock identifier to text according to its stratum.
Parameters:
ref_id -- reference clock indentifier
stratum -- NTP stratum
Returns:
corresponding message
Raises:
NTPException -- in case of invalid stratum
r � r) r1 r r z%c%c%c%cz"Unidentified reference source '%s'r
z %d.%d.%d.%dzInvalid stratum.N)r r r )r" r Zfields�textr r r �ref_id_to_text� s
r] )rU )rU )r
)r r rL r* r � Exceptionr r r r> rI r- r. r; rB rM rX rY rZ r] r r r r �<module> s$ Ij38