U
vfN% @ s@ d Z ddlZddlZddlZddlZddlZddlmZmZm Z m
Z
m Z m Z ddl
mZ d5ddZd6d d
Zd7d d
Zdd Zdd Zdd Zdd Zdd Zdd Zdd Zd d Zd d Ze a da e a d d! Z efd"d#Z!G d$d% d%Z"e" Z#d&d' Z$d(d) Z%G d*d+ d+Z&d,d- Z'd.d/ Z(d8d1d2Z)d9d3d4Z*dS ):z0
Useful functions used by the rest of paramiko.
N)DEBUG zero_byte xffffffffmax_bytebyte_ordbyte_chr) SSHConfigFc C s d}d}|s,t | dkr,t| d dkr,d}t | d r\t}|rDt}|dt | d | } tdt | dD ](}|d> td| ||d d }ql|r|ddt | > 8 }|S )zTturns a normalized byte string into a long-int
(adapted from Crypto.Util.number)r >I )lenr r r rangestructunpack)sZalways_positiveoutnegativeZfilleri r >/opt/alt/python38/lib/python3.8/site-packages/paramiko/util.py inflate_long) s &r Tc C s t }t| } | dkr<| dkr s*
r! c sp d}g }t | |d kr<|t| ||d |d7 }q|t | k r^|t| |d fdd|D S )Nr c s g | ] } | qS r r ).0lineprefixr r
e s z!format_binary..)r appendformat_binary_line)datar' xr r r& r
format_binary] s
r- c C s4 d dd | D }d dd | D }d||S )N c S s g | ]}d t|qS )z{:02X}formatr r$ cr r r r( i s z&format_binary_line..r" c S s* g | ]"}d t|t|d d qS )z.{:c}..? _ r/ r1 r r r r( k s z {:50s} {})joinr0 )r+ leftrightr r r r* h s
r* c C sR d}| D ]D}t |}d| kr(dkr:n n|t|7 }q|td|7 }q|S )N r z%{:02X})r r br0 )r r r2 r r r r safe_stringp s r; c C sr z
| W S tk
rl t| d}t|d }|dkr>Y dS t|d }|d@ sd|dK }|d8 }qJ| Y S X d S )NFr r
r r )
bit_lengthAttributeErrorr! r r )r ZnormZhbyteZbitlenr r r r< { s
r< c C s d tjt dS )Nr"
)r5 tracebackformat_exceptionsysexc_infosplitr r r r
tb_strings s rD c C s t }t }t|dkr$|dd }|dkr| }t|dkrH|| |t| || | }t|t|}||d| 7 }||8 }q$|S )a)
Given a password, passphrase, or other human-source key, scramble it
through a secure hash into some keyworthy bytes. This specific algorithm
is used for encrypting/decrypting private key files.
:param function hash_alg: A function which creates a new hash object, such
as ``hashlib.sha256``.
:param salt: data to salt the hash with.
:type bytes salt: Hash salt bytes.
:param str key: human-entered password or passphrase.
:param int nbytes: number of bytes to generate.
:return: Key data, as `bytes`.
r Nr )r r updater: digestmin)Zhash_algsaltkeynbytesZkeydatarF Zhash_objsizer r r generate_key_bytes s
rL c C s ddl m} || S )a
Read a file of known SSH host keys, in the format used by openssh, and
return a compound dict of ``hostname -> keytype ->`` `PKey
`. The hostname may be an IP address or DNS name. The
keytype will be either ``"ssh-rsa"`` or ``"ssh-dss"``.
This type of file unfortunately doesn't exist on Windows, but on posix,
it will usually be stored in ``os.path.expanduser("~/.ssh/known_hosts")``.
Since 1.5.3, this is just a wrapper around `.HostKeys`.
:param str filename: name of the file to read host keys from
:return:
nested dict of `.PKey` objects, indexed by hostname and then keytype
r )HostKeys)Zparamiko.hostkeysrM )filenamerM r r r load_host_keys s rO c C s t }|| |S )z
Provided only as a backward-compatible wrapper around `.SSHConfig`.
.. deprecated:: 2.7
Use `SSHConfig.from_file` instead.
)r parse)Zfile_objconfigr r r parse_ssh_config s
rR c C s
| | S )zM
Provided only as a backward-compatible wrapper around `.SSHConfig`.
)lookup)hostnamerQ r r r lookup_ssh_host_config s rU c C s| dd| }}}dd| }}}|dkrh|| }|||| }}|||| }}|||| }}q |dk rx||7 }|S )Nr
r r ) r, mu1u2u3v1v2Zv3qr r r mod_inverse s r] c C sF zt jW S tk
r@ t td7 att _W 5 Q R X t j Y S X d S )Nr
)_g_thread_dataidr= _g_thread_lock_g_thread_counterr r r r
get_thread_id s rb c C sf t d}t|jdkr dS || t| d}t |}d}|d7 }|t |d | | dS )zKsend paramiko logs to a logfile,
if they're not already going somewhereZparamikor Naz>%(levelname)-.3s [%(asctime)s.%(msecs)03d] thr=%(_threadid)-3dz %(name)s: %(message)sz%Y%m%d-%H:%M:%S)
logging getLoggerr handlerssetLevelopen
StreamHandler setFormatter Formatter
addHandler)rN levelloggerfhandlerfrmr r r log_to_file s
rr c @ s e Zd Zdd ZdS )PFilterc C s t |_dS )NT)rb Z _threadid)selfrecordr r r filter s zPFilter.filterN)__name__
__module__ __qualname__rv r r r r rs s rs c C s t | }|t |S N)rd re addFilter_pfilter)namern r r r
get_logger
s
r~ c C sN t | t |krdS d}tt | D ] }|t| | t|| A O }q$|dkS )NFr )r r r )rc r: resr r r r constant_time_bytes_eq s r c @ s e Zd Zdd Zdd ZdS )ClosingContextManagerc C s | S rz r )rt r r r __enter__ s z ClosingContextManager.__enter__c C s | d S rz )close)rt typevaluer? r r r __exit__! s z ClosingContextManager.__exit__N)rw rx ry r r r r r r r s r c C s t | t||S rz )maxrG )minimumvalmaximumr r r clamp_value% s r c C sP z
t | W S tk
rJ z| W Y S tk
rD | Y Y S X Y nX dS )z:
Coerce to bytes if possible or return unchanged.
N)r: TypeErrorasbytesr= )r r r r r ) s
r utf8c C s8 t | tr| S t | tr"| |S tdt| dS )z cast unicode or bytes to bytes Expected unicode or bytes, got N)
isinstancer strencoder r r encodingr r r r: ? s
r: c C s8 t | tr| |S t | tr"| S tdt| dS )z cast bytes or unicode to unicoder N)r r decoder r r r r r r uJ s
r )F)T)r" )r )r )+__doc__rA r r? threadingrd Zparamiko.commonr r r r r r Zparamiko.configr r r! r- r* r; r< rD rL rO rR rU r] localr^ ra Lockr` rb rr rs r| r~ r r r r r: r r r r r sB