3
\�me�� �
@ s6
d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl
Z
d dl Z d dl Z d dl
Z
d dlZ
d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlm Z d dl m Z m Z d dlm Z d dl!m"Z"m#Z# d dlm$Z$m%Z% d dl&m'Z' d dl(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0 d d l1m2Z2 d d
l3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z= d d l>m?Z? da@e jAeB�ZCe
jDd iZEd
ejF ejG ZH�d}ZI�d~ZJdd� ZKe$� �ddd��ZLe$� �d�dd��ZM�d�d d �ZN�d�d d �ZOePePd!�d"d#�ZQd$d%� ZRG d&d'� d'�ZSG d(d)� d)eT�ZUG d*d+� d+eT�ZVd,d-� ZW�d�d.d/�ZX�d�d0d1�ZY�d�d2d3�ZZ�d�d5d6�Z[�d�d7d8�Z\dd9�e+d:�d;d<�Z]d=d>� Z^d?d@� Z_dAdB� Z`�d�dDdE�ZadFdG� ZbeceddH�dIdJ�ZedKdL� ZfdCdCde jgdCfdMdN�Zhe$� dOdP� �Zie$� dQdR� �Zje$� dSdT� �Zke$� dUdV� �Zle$� dWdX� �Zme$� dYdZ� �Zn�d�d\d]�Zo�d�d^d_�Zp�d�d`da�Zq�d�dbdc�Zre$� ddde� �Zsdfdg� Zte$� dhdi� �Zu�d�djdk�Zv�d�dldm�Zwdndo� Zx�d�dpdq�Zy�d�e/e- eddr�dsdt�Zzej{dudv� �Z|ej{dwdx� �Z}dydz� Z~d{d|� Z�d�dd��Z��d�d�d��Z�dedffd�d��Z��d�d�d��Z�dd9�edd:�d�d��Z�dd9�edd:�d�d��Z��d�d�d��Z��d�d�d��Z�d�d�� Z�e d�d�d�d�g�Z��d�d�d��Z��d�d�d��Z�e�d:�d�d��Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z��d�d�d��Z��d�d�d��Z��d�d�d��Z��d�d�d��Z��d�d�d��Z��d�d�d��Z�d�d�� Z��d�d�d��Z�e$� d�d�� �Z�d�d�� Z�e�d:�d�d��Z��d�d�d��Z��d�d�dZ��d�d�dĄZ�d�dƄ Z�d�dȄ Z�d�dʄ Z��d�ececd˜d�d̈́Z�e
j�ePdΜd�dЄZ�d�d҄ Z�d�dԄ Z�d�dք Z��d�d�dلZ�edffd�dۄZ�d�d݄ Z��d�d�d߄Z�ej{d�d� �Z�d�d� Z��d�d�d�Z�d�d� Z�d�d� Z��d�d�d�Z�d�d� Z�d�d� Zd�d� Z�e$� d�d� �Z�d�d�� Z�d�d�� Z��d�d[d��e�e�dd��d�d��Z�d�d�� Z�d��d � Z�ece��d��d�d�Z�ece��d��d�d�Z�ecec�d��d�d�Z�ecec�d��d �d
�Z�ece,ec �d ��d �d
�Z��d�dCdd�d��d�d�Zd�d� ZÐd��d�d�ZĐd��d�d�ZŐd��d�d�ZƐd �d � Zǐd �d � ZȐd �d!� Zɐd"�d#� Z�e$� �d$�d%� �Zːd&�d'� Z̐d��d)�d*�Z͐d+�d,� Zΐd-�d.� Zϐd/�d0� Z�eCd[f�d1�d2�Zѐd3�d4� ZҐd5�d6� ZӐd7�d8� ZԐd9�d:� ZՐd;�d<� Zd��d=�d>�Z�eCd[f�d?�d@�Z�ece��dA��dB�dC�Z�e0�dD�Zڐd�e)�dEe�f eڐdF��dG�dH�ZېdI�dJ� Z�dde
j�jDf�dK�dL�Zސd��dN�dO�ZߐdP�dQ� Z�d��dR�dS�Z�dT�dU� Z�d��dV�dW�Z�dX�dY� Z�dZ�d[� Z�d��d\�d]�Z�d��d_�d`�Z�da�db� Z�d��dc�dd�Z�de�df� Z�dg�dh� Z�di�dj� Z�d��dm�dn�Z�e%G �do�dp� �dpe �dp�dq�dr�ds�dtg���Z�dd~d[�du�ecece.ec e�e��dv��dw�dx�Z�d~�dy�ecece��dz��d{�d|�Z�dS (� � N)� b64decode)�deque�
namedtuple)�suppress)�EACCES�ENOENT)� lru_cache�total_ordering)�Path)�Callable�Deque�Dict�List�Mapping�Optional�Sequence�TypeVar)�parse)
�features�importer�mergers�net�safeyaml�subp�
temp_utils�
type_utils�
url_helper�version)� CFG_BUILTIN�_z_-.()�true�1�on�yes�off�0�no�falsec C s" t tttj� jjd�d d� ��S )N�.� )�tuple�map�int�os�uname�release�split� r1 r1 �/usr/lib/python3.6/util.py�kernel_versionR s r3 c C s t j ddgd| d�}|jj� S )z�Return the sanitized string output by `dpkg --print-architecture`.
N.B. This function is wrapped in functools.lru_cache, so repeated calls
won't shell out every time.
Zdpkgz--print-architectureT)�capture�target)r �stdout�strip)r5 �outr1 r1 r2 �get_dpkg_architectureV s r9 c s� ddddd�}i � y�t j ddgd| d �}x:|jj� D ],}|jd
�\}}}||kr4|j� � || < q4W � fd d �|j� D �}t|�r�tjd
dj |�� W nF t j
k
r� } z(tjd|� t dd� |j� D ��� W Y d d }~X nX � S )N�codename� description�idr/ )ZCodenameZ DescriptionzDistributor IDZRelease� lsb_releasez--allT)r4 r5 �:c s g | ]}|� kr|�qS r1 r1 )�.0�k)�datar1 r2 �
<listcomp>s s z lsb_release.<locals>.<listcomp>z.Missing fields in lsb_release --all output: %s�,z#Unable to get lsb_release --all: %sc s s | ]}|d fV qdS )Z UNAVAILABLENr1 )r? �vr1 r1 r2 � <genexpr>| s z lsb_release.<locals>.<genexpr>) r r6 �
splitlines� partitionr7 �values�len�LOG�warning�join�ProcessExecutionError�dict) r5 Zfmapr8 �line�fnamer �val�missing�errr1 )rA r2 r= c s( (r= �utf-8c C s t | t�r| S | j|�S )N)�
isinstance�str�decode)�blob�encodingr1 r1 r2 �
decode_binary� s
rZ c C s t | t�r| S | j|�S )N)rU �bytes�encode)�textrY r1 r1 r2 � encode_text� s
r^ )rA �returnc C sB t | t�stdt| � ��y t| dd�S tjk
r< | S X dS )z�base64 decode data
If data is base64 encoded bytes, return b64decode(data).
If not, return data unmodified.
@param data: data as bytes. TypeError is raised if not bytes.
z data is '%s', expected bytesT)ZvalidateN)rU r[ � TypeError�typer �binascii�Error)rA r1 r1 r2 �maybe_b64decode� s
rd c C sP | j dd�}| j� dkrLt|t�rL| j� }|r<|jr<|j}nd}|j|d�S |S )NT)rW r] zutf-8�surrogateescape)Z get_payloadZget_content_maintyperU r[ Z get_charsetZ input_codecrW )�partZ cte_payload�charsetrY r1 r1 r2 �fully_decoded_payload� s
rh c @ s& e Zd Zd dd�Zdd� Zdd� ZdS )
� SeLinuxGuardFc C s< yt jd�| _W n tk
r* d | _Y nX || _|| _d S )N�selinux)r �
import_modulerj � ImportError�path� recursive)�selfrm rn r1 r1 r2 �__init__� s zSeLinuxGuard.__init__c C s | j r| j j� rdS dS d S )NTF)rj �is_selinux_enabled)ro r1 r1 r2 � __enter__� s zSeLinuxGuard.__enter__c C s� | j s| j j� rd S tjj| j�s*d S tjj| j�}y"tj|�}| j j||tj � W n t
k
rn d S X t j d|| j
� y| j j|| j
d� W n4 t
k
r� } zt jd|| j
|� W Y d d }~X nX d S )Nz,Restoring selinux mode for %s (recursive=%s))rn z,restorecon failed on %s,%s maybe badness? %s)rj rq r- rm �lexists�realpath�lstatZ matchpathcon�stat�ST_MODE�OSErrorrJ �debugrn Z
restoreconrK )ro Z excp_typeZ
excp_valueZexcp_tracebackrm Zstats�er1 r1 r2 �__exit__� s,
zSeLinuxGuard.__exit__N)F)�__name__�
__module__� __qualname__rp rr r{ r1 r1 r1 r2 ri � s
ri c @ s e Zd ZdS )�MountFailedErrorN)r| r} r~ r1 r1 r1 r2 r � s r c @ s e Zd ZdS )�DecompressionErrorN)r| r} r~ r1 r1 r1 r2 r� � s r� c O st t j� }|dkr\y| ||� t jd� W qp tk
rX ttdtj| �� t jd� Y qpX ntjd|tj| �� d S )Nr z&Failed forking and calling callback %s� z(Forked child %s who will run callback %s) r- �fork�_exit� Exception�logexcrJ r �obj_namery )Zchild_cb�args�kwargsZfidr1 r1 r2 �fork_cb� s
r� c C sB t | t�r| dkS t}|r&t|�| }t| �j� j� |kr>dS dS )NTF)rU �bool� TRUE_STRINGS�listrV �lowerr7 )rQ �addons� check_setr1 r1 r2 �is_true� s
r� c C sB t | t�r| dkS t}|r&t|�| }t| �j� j� |kr>dS dS )NFT)rU r� �
FALSE_STRINGSr� rV r� r7 )rQ r� r� r1 r1 r2 �is_false s
r� c C s | sdS t | t�r| S t| |�S )NF)rU r� r� )rQ r� r1 r1 r2 �translate_bool s
r� � c s8 t j� � �stjtj �dj� �fdd�td| �D ��S )N� c s g | ]}� j ���qS r1 )Zchoice)r? Z_x)�r� select_fromr1 r2 rB " s z rand_str.<locals>.<listcomp>r )�randomZ SystemRandom�string�
ascii_letters�digitsrL �range)�strlenr� r1 )r� r� r2 �rand_str s r� c C s. |sd}x t dd�d | }|| kr
P q
W |S )Nr� � )r� r )r� )Z
dictionaryZpostfixZnewkeyr1 r1 r2 �
rand_dict_key% s r� )�instance_data_file)r_ c C s� ddl m}m}m} y t| �}W n2 tk
rR } z|jtkr@i S � W Y dd}~X nX |r�tj j
|�r�y ||| |�}t j d|| � W nH |k
r� Y n6 |k
r� } zt j
d||t|�� W Y dd}~X nX |dkr�i S t|i d�S )z>Read a yaml config with optional template, and convert to dictr )�JinjaLoadError�
NotJinjaError� render_jinja_payload_from_fileNz?Applied instance data in '%s' to configuration loaded from '%s'z:Could not apply Jinja template '%s' to '%s'. Exception: %s)�default)Z!cloudinit.handlers.jinja_templater� r� r� � load_file�IOError�errnor r- rm �existsrJ ry rK �repr� load_yaml)rP r� r� r� r� Z config_filerz r1 r1 r2 � read_conf/ s8
r� c G s t t| � �S )N)�sorted�
uniq_merge)�listsr1 r1 r2 �uniq_merge_sorteda s r� c G sJ g }x<| D ]4}t |t�r4|j� jd�}dd� |D �}|j|� q
W t|�S )NrC c S s g | ] }|r|�qS r1 r1 )r? �ar1 r1 r2 rB s s z uniq_merge.<locals>.<listcomp>)rU rV r7 r0 �extend� uniq_list)r� Z
combined_list�a_listr1 r1 r2 r� m s
r� c C sl x t j� D ]\}}| j||�} q
W g }x | D ]}|tkr,|j|� q,W x|D ]}| j|d�} qLW | j� } | S )Nr� )�FN_REPLACEMENTS�items�replace�
FN_ALLOWED�appendr7 )�fnr@ rD Zremovalsr1 r1 r2 �clean_filenamex s
r� Tc C s� yLt jt| ��}tjtjd dd|��� }|r8t|j� �S |j� S W d Q R X W n8 t k
r� } z |rf| S t
t |��|�W Y d d }~X nX d S )N�rbr� ) �io�BytesIOr^ �
contextlib�closing�gzipZGzipFilerZ �readr� r� rV )rA �quietrW �bufZghrz r1 r1 r2 � decomp_gzip� s r� c C s� | sdS | j dd�}|d j� }t|�dkr:|d j� }nd }| sX|dksX|j� dkr\d }| sv|dksv|j� dkrzd }||fS )Nr> r� r r) z-1Znone)NN)r0 r7 rI r� )Zug_pairZ ug_parted�u�gr1 r1 r2 �extract_usergroup� s r� )�root_dirr_ c C sl t � }x`tjtjj| d��D ]H}tjj|�s.q tjj|�dd� }|j� }|r |jd�dkr |||< q W |S )Nz*.pyr � r( r� ������) rN �globr- rm rL �isfile�basenamer7 �find)r� �entriesrP �modnamer1 r1 r2 �get_modules_from_dir� s r� c C s, t | d��}|j|� |j� W d Q R X d S )N�w)�open�write�flush)�conpathr] Zwfhr1 r1 r2 �write_to_console� s
r� c
C s� |rt jj| � |r�d}d}tjj|�rxyt|| � d}W n< tk
rv d}t jj|� d�� |rr|j t
j |� Y nX |r�| r�t jj| � |r�| d dkr�|j || d d� � n |j || � d S ) Nz /dev/consoleFTz Failed to write to /dev/console�
r� r� r� ) �sys�stderrr� r- rm r� r� rx r6 �log�loggingZWARNING) r] Zconsoler� r� Z log_levelZfallback_to_stdoutr� Zwriting_to_console_workedZ
console_errorr1 r1 r2 � multi_log� s(
r� c C s dt j� kS )NZLinux)�platform�systemr1 r1 r1 r2 �is_Linux� s r� c C s$ dt j� krdS t j� dkr dS dS )NZBSDTZ DragonFlyF)r� r� r1 r1 r1 r2 �is_BSD� s
r� c C s t � d dkS )N�variant�freebsd)� system_infor1 r1 r1 r2 �
is_FreeBSD� s r� c C s t � d dkS )Nr� � dragonfly)r� r1 r1 r1 r2 �is_DragonFlyBSD� s r� c C s t � d dkS )Nr� �netbsd)r� r1 r1 r1 r2 � is_NetBSD� s r� c C s t � d dkS )Nr� �openbsd)r� r1 r1 r1 r2 �
is_OpenBSD s r� Fc C s || kr |S t | | �S )N)r� )�yobj�keyr� r1 r1 r2 �get_cfg_option_bool s r� c C s* || kr |S | | }t |t�s&t|�}|S )N)rU rV )r� r� r� rQ r1 r1 r2 �get_cfg_option_str s
r� c C s t t| ||d��S )N)r� )r, r� )r� r� r� r1 r1 r2 �get_cfg_option_int s r� c C s� | sd} t jj| �si S t| �}d}d|kr0d}tj||�}|r�|j� }d|d kr`|d |d< |d j� jd�d |d< |d d kr�d
|d< |d |d |d d �S i S )
z�Return a dictionary of distro info fields from /etc/redhat-release.
Dict keys will align with /etc/os-release keys:
ID, VERSION_ID, VERSION_CODENAME
z/etc/redhat-releasezA(?P<name>.+) release (?P<version>[\d\.]+) \((?P<codename>[^)]+)\)Z Virtuozzoz)(?P<name>.+) release (?P<version>[\d\.]+)�namer: z linuxr zred hat enterprise�redhatr )�ID�
VERSION_ID�VERSION_CODENAME) r- rm r� r� �re�match� groupdictr� rG )Z release_fileZredhat_releaseZ redhat_regexr� �groupr1 r1 r2 �_parse_redhat_release s( r� c C sv d} d}d}i }d}t jjd�r,ttd��}|s:d}t� }|r�|jdd�} |jdd�}d| ksfd| krptj� }nn| d ks�| d
kr�|jd d�}nP| d kr�| r�|jd d�}n4|jd
d�}|s�t j
d|jdd��}|r�|j � d }| dkr�d} n�t � �r
tj
� j� } tj� }nbd}z(y tj� }W n tk
�r2 Y nX W d d }x|D ]}|�rBd}�qBW |�sftjd� X |S | ||fS )Nr� Fz/etc/os-releaseTr� r� �sles�suse�alpine�photonZ PRETTY_NAME� virtuozzor� z [^ ]+ \((?P<codename>[^)]+)\)�VERSIONr: �rhelr� r� zPUnable to determine distribution, template expansion may have unexpected results)r� r� r� )r- rm r� �load_shell_contentr� r� �getr� �machiner� r� r� r� r� r� r/ �distr� rJ rK ) Z distro_nameZdistro_versionZflavorZ
os_releaseZos_release_rhelr� r �found�entryr1 r1 r2 �get_linux_distro@ sZ
r
c C sv | d j � }d}|dkrf| d d j � }|d*kr6|}qr|d+krDd}qr|d krRd}qr|d,kr`d}qrd}n |d-krr|}|S ).Nr� �unknown�linuxr r � almalinuxr� �arch�centos�
cloudlinux�debian� eurolinux�fedora�mariner� miraclelinux� openeuler� opencloudos� openmandrivar r �rockyr� � tencentosr �ubuntu� linuxmint�mintr� �opensuse�
opensuse-leap�opensuse-microos�opensuse-tumbleweed�sle_hpc� sle-micror� �windows�darwinr� r� r� r� )r
r� r r r r r r r r r r r r r r r� r r )r r r )r r r r! r" r# r� )r$ r% r� r� r� r� )r� )�infor� r� Z
linux_distr1 r1 r2 � _get_variant~ s` r' c C s< t j � t j� t j� t j� tt j� �t� d�} t| �| d< | S )N)r� r� r/ �pythonr. r r� )r� r� r/ Zpython_versionr� r. r
r' )r& r1 r1 r2 r� � s
r� c C sX || kr |S | | dkr g S | | }t |t�r@dd� |D �}|S t |t�sRt|�}|gS )a�
Gets the C{key} config option from C{yobj} as a list of strings. If the
key is present as a single string it will be returned as a list with one
string arg.
@param yobj: The configuration object.
@param key: The configuration key to get.
@param default: The default to return if key is not found.
@return: The configuration option as a list of strings or default if key
is not found.
Nc S s g | ]}|�qS r1 r1 )r? rD r1 r1 r2 rB � s z'get_cfg_option_list.<locals>.<listcomp>)rU r� rV )r� r� r� rQ Zcvalr1 r1 r2 �get_cfg_option_list� s
r) c C s> t |t�r|jd�}| }x |D ]}||kr.|S || }q W |S )a� Return the value of the item at path C{keyp} in C{yobj}.
example:
get_cfg_by_path({'a': {'b': {'num': 4}}}, 'a/b/num') == 4
get_cfg_by_path({'a': {'b': {'num': 4}}}, 'c/d') == None
@param yobj: A dictionary.
@param keyp: A path inside yobj. it can be a '/' delimited string,
or an iterable.
@param default: The default to return if the path does not exist.
@return: The value of the item at keyp."
is not found.�/)rU rV r0 )r� Zkeypr� Zcur�tokr1 r1 r2 �get_cfg_by_path� s
r, c C s t | |�\}}t||� ||fS )N)�get_output_cfg�redirect_output)�cfg�mode�outfmt�errfmtr1 r1 r2 � fixup_output� s
r3 c
C s� t tjjd��r tjd� d S |s(tj}|s2tj}dd� }| �rtjd|| � | j dd�\}}|dksn|d kr�d
}|dkr~d }t
||�}n0|d kr�t j |d
t j
|d�} | j}n td| ��|r�tj|j� |j� � || k�rtjd|| � tj|j� |j� � d S |�r�tjd||� |j dd�\}}|dk�s:|d k�rXd
}|dk�rLd }t
||�}n2|d k�r~t j |d
t j
|d�} | j}n td| ��|�r�tj|j� |j� � d S )NZ_CLOUD_INIT_SAVE_STDOUTz5Not redirecting output due to _CLOUD_INIT_SAVE_STDOUTc S s> t jd� ytjd�j} W n tk
r. Y n X t j| � dS )a� Reconfigure umask and group ID to create output files securely.
This is passed to subprocess.Popen as preexec_fn, so it is executed in
the context of the newly-created process. It:
* sets the umask of the process so created files aren't world-readable
* if an adm group exists in the system, sets that as the process' GID
(so that the created file(s) are owned by root:adm)
� ZadmN)r- �umask�grp�getgrnam�gr_gid�KeyError�setgid)Zgroup_idr1 r1 r2 � set_subprocess_umask_and_gid s
z5redirect_output.<locals>.set_subprocess_umask_and_gidzRedirecting %s to %s� r� �>z>>�ab�wb�|T)�shell�stdinZ
preexec_fnz"Invalid type for output format: %sz!Invalid type for error format: %s)r� r- �environr rJ ry r� r6 r� r0 r� �
subprocess�Popen�PIPErB r` �dup2�fileno)
r1 r2 Zo_outZo_errr; r0 �argZowithZnew_fp�procr1 r1 r2 r.
s`
r. )�sourcesr_ c C sV |rt t| ��} i }x<| D ]4}|rtj|�}|s8tj� }tj|�}|j||�}qW |S )aF Merge multiple dicts according to the dict merger rules.
Dict merger rules can be found in cloud-init documentation. If no mergers
have been specified, entries will be recursively added, but no values
get replaced if they already exist. Functionally, this means that the
highest priority keys must be specified first.
Example:
a = {
"a": 1,
"b": 2,
"c": [1, 2, 3],
"d": {
"a": 1,
"b": 2,
},
}
b = {
"a": 10,
"c": [4],
"d": {
"a": 3,
"f": 10,
},
"e": 20,
}
mergemanydict([a, b]) results in:
{
'a': 1,
'b': 2,
'c': [1, 2, 3],
'd': {
'a': 1,
'b': 2,
'f': 10,
},
'e': 20,
}
)r� �reversedr Zdict_extract_mergersZdefault_mergersZ construct�merge)rK �reverseZ
merged_cfgr/ Zmergers_to_applyZmergerr1 r1 r2 �
mergemanydictZ s *
rO c c s. t j� }zt j| � | V W d t j|� X d S )N)r- �getcwd�chdir)ZndirZcurrr1 r1 r2 rQ � s
rQ c c s& t j| �}z
|V W d t j|� X d S )N)r- r5 )Zn_msk�oldr1 r1 r2 r5 � s
r5 c C s dj | |d|d�S )Nz{0:{fill}{align}{size}}�^)�fillZalign�size)�format)r] rT Zmax_lenr1 r1 r2 �center� s rW c C s t jd| � tj| � d S )NzRecursively deleting %s)rJ ry �shutilZrmtree)rm r1 r1 r2 �del_dir� s rY r� � c C sj y.t |||�\}}}|| d< || d< || d< dS tjk
rd } z|jtjkrRdS � W Y d d }~X nX d S )Nz user-dataz vendor-dataz meta-dataTF)� read_seededr �UrlError�codeZ NOT_FOUND)rT �base�ext�timeout�md�ud�vdrz r1 r1 r2 �read_optional_seed� s rd c C s� i }| sddg}n(t jj| jd�d�t jj| jd�d�g}t|�}dd� |D �}d }x2|D ]*}t jjt jj|d��rZt jj|d�}P qZW d }x2|D ]*}t jjt jj|d��r�t jj|d�}P q�W |r�|r�||d < ||d
< n |r�||d < |S ) Nz/var/lib/cloud/data/sslz /var/lib/cloud/instance/data/sslrA Zsslc S s g | ]}|rt jj|�r|�qS r1 )r- rm �isdir)r? �dr1 r1 r2 rB � s z%fetch_ssl_details.<locals>.<listcomp>zcert.pemzkey.pem� cert_file�key_file)r- rm rL Z
get_ipath_curZ get_cpathr� r� )�pathsZ ssl_detailsZssl_cert_pathsrg rf rh r1 r1 r2 �fetch_ssl_details� s0
rj c C s |}t | �} y\tjdt| �|� tj| �}|d krBtjd� |}n t||�sbtd|tj |�f ��|}W n� tj
tt fk
�r } z�d}d }t |d�r�t
|d�r�t
|d�}n t |d�r�t
|d�r�t
|d�}|r�|dj|jd |jd |d �7 }n|d
j|d �7 }tj|� W Y d d }~X nX |S ) NzKAttempting to load yaml from string of length %s with allowed root types %sz-loaded blob returned None, returning default.z2Yaml load allows %s root types, but got %s insteadzFailed loading yaml blobZ context_markZ problem_markz5. Invalid format at line {line} column {col}: "{err}"r� )rO �colrS z. {err})rS )rZ rJ ry rI r �loadrU r` r r� Z YAMLError�
ValueError�hasattr�getattrrV rO �columnrK )rX r� ZallowedZloadedZ convertedrz �msgZmarkr1 r1 r2 r� � s<
r� �
c C sV | j d�dkr@| jdd| �}| jdd| �}| jdd| �}nTtjrj| d dkrjtj| �jdkrj| d7 } d | d|f }d | d|f }d | d|f }tj|||d
�}d } |j � r�t
t |j �i d �} tj|||d
�}
d } |
j � r�|
j } d } ytj|||d
�}
W n2 tj
k
�r. } ztjd |� W Y d d }~X n X |
j � �rB|
j } n
tjd
� | | | fS )Nz%sr z user-dataz vendor-dataz meta-datar� r* r� z%s%s%s)r` �retries)r� z!Error in vendor-data response: %sz Error in vendor-data responser� )r� r� r Z%NOCLOUD_SEED_URL_APPEND_FORWARD_SLASHr �urlparseZqueryr Zread_file_or_url�okr� rZ �contentsr\ rJ ry )r^ r_ r` rs Z file_retriesZud_urlZvd_urlZmd_urlZmd_respra Zud_resprb rc Zvd_resprz r1 r1 r2 r[
s<
r[ c s� t tj� �dd�}dd� |D �}� fdd�|D �}g }xh|D ]`}y |jttjj� |�|d�� W q< tk
r� } z |jt kr�t
j d� |� W Y dd}~X q<X q<W t |�S ) z Read configuration directory.T)rN c S s g | ]}|j d �r|�qS )z.cfg)�endswith)r? �fr1 r1 r2 rB ; s z read_conf_d.<locals>.<listcomp>c s& g | ] }t jjt jj� |��r|�qS r1 )r- rm r� rL )r? rx )�confdr1 r2 rB > s )r� z,REDACTED config part %s/%s for non-root userN)
r� r- �listdirr� r� rm rL rx r� r rJ rK rO )ry r� Zconfs�cfgsr� rz r1 )ry r2 � read_conf_d5 s
r| c C s� t � }i }yt| |d�}W n8 tk
rR } z |jtkrBtjd| � W Y dd}~X n X |j|� d}d|kr�|d }|r�t|t �s�t
d| t j |�f ��q�t |�j
� }n tjj| � d��r�| � d�}|r�tjj|�r�t||d�}|j|� t|�S )a Read yaml file along with optional ".d" directory, return merged config
Given a yaml file, load the file as a dictionary. Additionally, if there
exists a same-named directory with .d extension, read all files from
that directory in order and return the merged config. The template
file is optional and will be applied to any applicable jinja file
in the configs.
For example, this function can read both /etc/cloud/cloud.cfg and all
files in /etc/cloud/cloud.cfg.d and merge all configs into a single dict.
)r� z)REDACTED config part %s for non-root userNr� Zconf_dz8Config file %s contains 'conf_d' with non-string type %sz.d)r r� rx r� r rJ rK r� rU rV r` r r� r7 r- rm re r| �
appendleftrO )Zcfgfiler� r{ r/ rz ry Z confd_cfgr1 r1 r2 �read_conf_with_confdS s.
r~ c C s t t| d��S )N)�cmdline)r� �read_cc_from_cmdline)r r1 r1 r2 �read_conf_from_cmdline s r� c C s� | d krt � } d| � �} d}d}t|�}t|�}t| �}g }| j|�}x`|dkr�| j||| �}|dk rl|}|jtj| || |� j� �jdd�� | j||| �}qHW dj|�S )Nr< z cc:Zend_ccr z\nr� ) � get_cmdlinerI r� r� r Zunquote�lstripr� rL ) r Z tag_beginZtag_endZbegin_lZend_lZclen�tokensZbegin�endr1 r1 r2 r� � s&
r� c C s2 | j d�}|dks"| |d dkr&| S | jdd�S )Nr� r r� �
z
)r� r� )rv �posr1 r1 r2 �dos2unix� s
r� �HostnameFqdnInfo�hostname�fqdn�
is_defaultc C s� d}d| kr,| d }t | d|jd�d �}nld| krf| d jd�dkrf| d }| d d|jd�� }n2|jd|d�j}d| kr�| d }n|j|d �\}}t|||�S )
a� Get hostname and fqdn from config if present and fallback to cloud.
@param cfg: Dictionary of merged user-data configuration (from init.cfg).
@param cloud: Cloud instance from init.cloudify().
@param metadata_only: Boolean, set True to only query cloud meta-data,
returning None if not present in meta-data.
@return: a namedtuple of
<hostname>, <fqdn>, <is_default> (str, str, bool).
Values can be none when
metadata_only is True and no cfg or metadata provides hostname info.
is_default is a bool and
it's true only if hostname is localhost and was
returned by util.get_hostname() as a default.
This is used to differentiate with a user-defined
localhost hostname.
Fr� r� r( r NT)r� �
metadata_only)r� )r� r0 r� � get_hostnamer� r� )r/ Zcloudr� r� r� r� r1 r1 r2 �get_hostname_fqdn� s
r� �
/etc/hostsc C s� d}yvxpt |�j� D ]`}|jd�}|dkr6|d|� }|j� }|sDq|j� }t|�dk rZq| |dd� kr|d }P qW W n tk
r� Y nX |S )a�
For each host a single line should be present with
the following information:
IP_address canonical_hostname [aliases...]
Fields of the entry are separated by any number of blanks and/or tab
characters. Text from a "#" character until the end of the line is a
comment, and is ignored. Host names may contain only alphanumeric
characters, minus signs ("-"), and periods ("."). They must begin with
an alphabetic character and end with an alphanumeric character.
Optional aliases provide for name changes, alternate spellings, shorter
hostnames, or generic hostnames (for example, localhost).
N�#r r� r) r� )r� rF r� r7 r0 rI r� )r� �filenamer� rO Zhashpos�toksr1 r1 r2 �get_fqdn_from_hosts� s$
r� c C s< t j| �}|j}tdkr�t� }d }i }x�|D ]�}ydtj|dddtjtj�}g ||< x>|D ]6\}} }
} } || j d| | d f � |j
| d � qXW W q, tj tj fk
r� Y q,X q,W |a|r�t
jd|� yNtt�� tj|jjd��r�d S W dQ R X tj|d�}|d d
d }
|
tkS tj tj fk
�r6 d S X dS )
a� determine if a url's network address is resolvable, return a boolean
This also attempts to be resilent against dns redirection.
Note, that normal nsswitch resolution is used here. So in order
to avoid any utilization of 'search' entries in /etc/resolv.conf
we have to append '.'.
The top level 'invalid' domain is invalid per RFC. And example.com
should also not exist. The '__cloud_init_expected_not_found__' entry will
be resolved inside the search list.
N�does-not-exist.example.com.�example.invalid.�!__cloud_init_expected_not_found__r z%s: %sz detected dns redirection: %sz[]T� F)r� r� r� )r rt r� �_DNS_REDIRECT_IP�set�socketZ getaddrinfoZ SOCK_STREAMZ AI_CANONNAMEr� �addZgaierror�errorrJ ry r rm r Z
is_ip_addressZnetlocr7 )�urlZ
parsed_urlr� ZbadipsZbadnamesZ
badresultsZiname�resultZ_famZ_stypeZ_protoZcnameZsockaddrZaddrr1 r1 r2 �
is_resolvable s<
r� c C s t j� } | S )N)r� Z gethostname)r� r1 r1 r2 r� ; s r� c C s* yt j| �d S t jk
r$ d S X d S )Nr )r� �
gethostbyaddrZherror)Zipr1 r1 r2 r� @ s r� c C s t tjd| t| fd�S )z5determine if this url is resolvable (existing or ip).zResolving URL: )�logfuncrq �funcr� )�log_timerJ ry r� )r� r1 r1 r2 �is_resolvable_urlG s
r� c C s\ | dkr dS t jd| � x>| D ]6}y t|�r<t jd|� |S W q tk
rR Y q X q W dS )zc
Search through a list of mirror urls for one that works
This needs to return quickly.
Nz%search for mirror in candidates: '%s'zfound working mirror: '%s')rJ ry r� r� )Z
candidatesZcandr1 r1 r2 �search_for_mirrorQ s
r� c
C sD t tjjd��rdS ttj�� } tj| j� tj j� � W dQ R X dS )z�
reopen stdin as /dev/null so even subprocesses or other os level things get
/dev/null as input.
if _CLOUD_INIT_SAVE_STDIN is set in environment to a non empty and true
value then input will not be closed (useful for debugging).
Z_CLOUD_INIT_SAVE_STDINN)
r� r- rC r r� �devnullrG rH r� rB )�fpr1 r1 r2 � close_stdind s r� �devicec C sv g }| s t j d�t j d� S | jd�rL| jd�}dd� d| d| gD �}n&| dkr`t j d�}n| d krrt j d�}|S )
Nz/dev/msdosfs/*z/dev/iso9660/*zLABEL=c S s g | ]}t jj|�r|�qS r1 )r- rm r� )r? �pr1 r1 r2 rB { s z*find_devs_with_freebsd.<locals>.<listcomp>z
/dev/msdosfs/z
/dev/iso9660/z TYPE=vfatz TYPE=iso9660)r� �
startswithr� )�criteria�oformat�tag�no_cacherm �devlist�labelr1 r1 r2 �find_devs_with_freebsdr s
r� c C s� g }d }d }| r8| j d�r$| jd�}| j d�r8| jd�}tjdddgdgd�}xx|jj� D ]j} |sf|r�tjd| gdd gd�\}
} |r�d
| |
kr�qZ|d kr�d |
kr�qZ|d
kr�d |
kr�qZ|jd| � qZW |S )NzLABEL=zTYPE=�sysctlz-nz hw.disknamesr )�rcsZ mscdlabelr� z
label "%s"�iso9660zISO filesystem�vfatz/dev/)r� r� r r6 r0 r� ) r� r� r� r� rm r� r� �_typer8 �devZ
mscdlabel_outr r1 r1 r2 �find_devs_with_netbsd� s(
r� c C s� t j dddgdgd�}g }xd|jj� jd�D ]P}|jd�s<q,|dkrFq,|j|d d� d
� |jd �s,|j|d d� d � q,W d
d� |D �S )Nr� z-nz hw.disknamesr )r� rC r> zfd0:r� r� �cd�ic S s g | ] }d | �qS )z/dev/r1 )r? r� r1 r1 r2 rB � s z*find_devs_with_openbsd.<locals>.<listcomp>r� r� )r r6 �rstripr0 rw r� r� )r� r� r� r� rm r8 r� r r1 r1 r2 �find_devs_with_openbsd� s
r� c C s� t j dddgdgd�}dd� t|jj� dd �D �}| d
krJd d� |D �}n(| dkrbdd� |D �}n| rrtjd| � dd� |D �S )Nr� z-nz
kern.disksr )r� c S s( g | ] }|j d � r|j d� r|�qS )ra Zvn)r� )r? r� r1 r1 r2 rB � s z/find_devs_with_dragonflybsd.<locals>.<listcomp>T)rN z TYPE=iso9660c S s g | ]}|j d�r|�qS )r� �acd)r� r� )r� )r? r� r1 r1 r2 rB � s �LABEL=CONFIG-2� TYPE=vfatc S s g | ]}|j d�s|�qS )r� r� )r� r� )r� )r? r� r1 r1 r2 rB � s zUnexpected criteria: %sc S s g | ] }d | �qS )z/dev/r1 )r? r� r1 r1 r2 rB � s )r� r� )r r� r6 r0 rJ ry )r� r� r� r� rm r8 r� r1 r1 r2 �find_devs_with_dragonflybsd� s r� c
C sJ t � rt| ||||�S t� r,t| ||||�S t� rBt| ||||�S t� rXt| ||||�S dg}g }| rt|jd| � |r�|jd| � |r�|j ddg� |r�|jd| � |r�|j|� || }yt
j
|ddgd �\}} W n: t
j k
�r }
z|
j t
k�rd
}n� W Y d d }
~
X nX g } x*|j� D ] } | j� } | �r$| j| � �q$W | S ) z�
find devices matching given criteria (via blkid)
criteria can be *one* of:
TYPE=<filesystem>
LABEL=<label>
UUID=<uuid>
�blkidz-t%sz-s%sz-cz /dev/nullz-o%sr r) )r� r� N)r� r� r� r� r� r� r� r� r� r� r rM r� r rF r7 )
r� r� r� r� rm Z
blk_id_cmd�options�cmdr8 �_errrz r� rO r1 r1 r2 �find_devs_with� sD
r� c C s� | dkrg } nt | �} dddg}|r2|jddg� |j| � tj|ddd �}i }x:|jj� D ],}|jd
�\}}}t|�||< ||| d < q\W |S ) z�Get all device tags details from blkid.
@param devs: Optional list of device paths you wish to query.
@param disable_cache: Bool, set True to start with clean cache.
@return: Dict of key value pairs of info for the device.
Nr� z-oZfullz-cz /dev/nullTr� )r4 rW r> ZDEVNAME)r� r� r r6 rF rG r ) ZdevsZ
disable_cacher� r8 �retrO r� r rA r1 r1 r2 r� s
r� c C s, g }x"| D ]}||krq
q
|j |� q
W |S )N)r� )Zin_listZout_listr� r1 r1 r2 r� " s
r� c C s� t jd| |� tj� }y(t| d��}t|||d� W d Q R X W n4 tk
rr } z|sV� |jtkrb� W Y d d }~X nX |j � }t jdt
|�| � |r�t |�S |S d S )NzReading from %s (quiet=%s)r� )�chunk_cbzRead %s bytes from %s) rJ ry r� r� r� � pipe_in_outr� r� r �getvaluerI rZ )rP Zread_cbr� rW ZofhZifhrz rv r1 r1 r2 r� , s
r� c C s� t � r\y td�} | jdd�d d� }W q� tk
rX } ztjd|� d}W Y d d }~X q�X n*ytd�j� }W n tk
r� d}Y nX |S ) Nz/proc/1/cmdline� r< r� z"failed reading /proc/1/cmdline: %sr� z
/proc/cmdliner� )� is_containerr� r� r� rJ rK r7 )rv r rz r1 r1 r2 � _get_cmdline? s
r� c C s dt jkrt jd S t� S )NZDEBUG_PROC_CMDLINE)r- rC r� r1 r1 r1 r2 r� R s
r� c C s6 d} yt | �j� }|dkS ttfk
r0 dS X d S )Nz /proc/sys/crypto/fips_enabledr! F)r� r7 r� rx )Z fips_procrv r1 r1 r2 � fips_enabledY s r� � c C sR d}x@| j |�}t|�dkr P q|j|� |t|�7 }|r||� qW |j� |S )Nr )r� rI r� r� )Zin_fhZout_fhZ
chunk_sizer� Z bytes_pipedrA r1 r1 r2 r� e s
r� c C s6 |dkr|dkrd S t jd| ||� tj| ||� d S )Nr� z%Changing the ownership of %s to %s:%sr� )Nr� r� )Nr� )rJ ry r- �chown)rP �uid�gidr1 r1 r2 � chownbyidt s r� c C sn d}d}y$|rt j|�j}|r*tj|�j}W n0 tk
r\ } ztd| �|�W Y d d }~X nX t| ||� d S )Nr� zUnknown user or group: %sr� r� ) �pwd�getpwnamZpw_uidr6 r7 r8 r9 rx r� )rP �userr� r� r� rz r1 r1 r2 � chownbyname| s r� c
C sz d d g}| sd| kr|S | d }||kr4|| }nd|kr@|S |d }t |t�rZ||g}t |t�r�t|�dkr||d |d< t|�dkr�|d |d< t |t�r�d|kr�|d |d< d|kr�|d |d< |d dkr�|d |d< ddd g}x�tt|��D ]|}|| �sq�|| j� }d
}x<|D ]4} |j| ��r d | |t| �d � j� f }d }P �q W |�sjd d|j� f }|||< q�W |S )
N�output�allr r� r� z&1z>>r= r@ Fz%s %sT) rU rV r� rI rN r� r� r� r7 )
r/ r0 r� ZoutcfgZmodecfgZswlistr� rQ r �sr1 r1 r2 r- � sL
r- c C s� g }| st | t� r|S | jd�}|r2|j|� xvt| d�D ]h}|sHq>tjd|�}|sZq>|jd�}|j� }t |�dkr�|j|� q>ddg|dd� kr>|j|d � q>W t
t |��S ) z�Return a list of log file paths from the configuration dictionary.
@param cfg: The cloud-init merged configuration dictionary.
Z def_log_fileNz (?P<type>\||>+)\s*(?P<target>.*)r5 r� �teez-ar) ) rU rN r r� r- r� r� r� r0 rI r� r� )r/ ZlogsZ default_log�fmtr� r5 �partsr1 r1 r2 �get_config_logfiles� s&
r� c G sB |r| j |f|�� tj� }|dkr(d }| j|f|�d|i� d S )N�exc_info)NNN)rK r� r� ry )r� rq r� r� r1 r1 r2 r� � s r� )�routiner_ c C s< t j|�}|jt| �� |j� }|d k r4|d|� S |S d S )Nr )�hashlib�new�updater^ Z hexdigest)rX r� Zmlen�hasher�digestr1 r1 r2 � hash_blob� s
r� )rx r_ c s6 t j� }x$t� fdd�d�D ]}|j|� q W |j� S )z�Hash the content of a binary buffer using SHA1.
@param f: buffered binary stream to hash.
@return: digested data as bytes.
c s � j tj�S )N)r� r� �DEFAULT_BUFFER_SIZEr1 )rx r1 r2 �<lambda>
s z hash_buffer.<locals>.<lambda>� )r� Zsha1�iterr� r� )rx r� �chunkr1 )rx r2 � hash_buffer s r� c C s, yt j| �rdS W n tk
r& dS X d S )NTF)r� r� r9 )r� r1 r1 r2 �is_user s
r� c C s, yt j| �rdS W n tk
r& dS X d S )NTF)r6 r7 r9 )r� r1 r1 r2 �is_group s
r� c C s t jd| |� tj| |� d S )NzRenaming %s to %s)rJ ry r- �rename)�src�destr1 r1 r2 r� s r� �� c C s x| D ]}t ||� qW d S )N)�
ensure_dir)Zdirlistr0 rf r1 r1 r2 � ensure_dirs% s
r� c C sH t jt| ��}t|t|��sDdjdd� |D ��}td|t|�f ��|S )Nz, c S s g | ] }t |��qS r1 )rV )r? �tr1 r1 r2 rB - s z load_json.<locals>.<listcomp>z((%s) root types expected, got %s instead)�json�loadsrZ rU r* rL r` ra )r] Z
root_typesZdecodedZexpected_typesr1 r1 r2 � load_json* s r� c C s< t jj| �}|t jj|�kr | S t jj|�r0| S t|�S dS )z�Get the last directory in a path that does not exist.
Example: when path=/usr/a/b and /usr/a does not exis but /usr does,
return /usr/a
N)r- rm �dirnamere �get_non_exist_parent_dir)rm Zp_pathr1 r1 r2 r� 5 s r� c C s� t jj| �s�t| �}tt jj| �dd�� t j| � W d Q R X t| |� |sP|r�t|||� t | j
|�d dd � �}t |�}x0|j D ]}|j |�}t|||� q�W n
t| |� d S )NT)rn r� )
r- rm re r� ri r� �makedirs�chmodr� r
r0 r� Zjoinpath)rm r0 r� r� Znon_existed_parent_dirZsub_relative_dirZsub_pathrf r1 r1 r2 r� F s
r� c c s( z
| V W d | r"d| g}t j |� X d S )N�umount)r )r� Z
umount_cmdr1 r1 r2 � unmounter] s
r� c
C s i } y�t jjd�r$td�j� }d}ntjd�}|jj� }d}d}x�|D ]�}yV|dkrj|j� \}}}} }
} n4tj ||�} | j
d�}| j
d�}| j
d�}| j
d�} W n t k
r� wFY nX |j d d
�}||| d �| |< qFW t
jd | |� W n$ ttfk
�r tt
d
� Y nX | S )Nz /proc/mountsrJ �mountz*^(/dev/[\S]+) on (/.*) \((.+), .+, (.+)\)$r� r) r� r� z\040r< )�fstype�
mountpoint�optszFetched %s mounts from %sz Failed fetching mount points)r- rm r� r� rF r r6 r0 r� �searchr� r� r� rJ ry r� rx r� )
�mountedZ
mount_locs�methodr8 ZmountreZmpliner� Zmpr r Z_freqZ_passno�mr1 r1 r2 �mountsg s8
r c C s t |t�r|g}n:t |ttf�r*t|�}n"|dkr8d}ntdjt|�d���t� rb|dkr�dg}nVt� r�|dkrzdddg}x<t |�D ](\}}|dkr�d||< |dkr�d||< q�W nd g}t
� }t j � ��@} d }
t
jj| �|kr�|t
jj| � d
} n�d} x�|D ]�}d} yNdddg}
|�r&|
jd|g� |
j| � |
j| � tj|
|d� | }
| } P W nJ ttfk
�r� } z(|�r�tjd| |dj|
�|� |} W Y dd}~X nX � q�W | �s�td| | | f ��| jd��s�| d7 } t|
��$ |dk�r�|| �}n
|| |�}|S Q R X W dQ R X dS )a2
Mount the device, call method 'callback' passing the directory
in which it was mounted, then unmount. Return whatever 'callback'
returned. If data != None, also pass data to callback.
mtype is a filesystem type. it may be a list, string (a single fsname)
or a list of fsnames.
Nz6Unsupported type provided for mtype parameter: {_type})r� �auto�ufsZcd9660Zmsdosr� r� �msdosfsr� Fr r z-oZroz-t)Z
update_envzbFailed to mount device: '%s' with type: '%s' using mount command: '%s', which caused exception: %sr< z#Failed mounting %s to %s due to: %sr* )r� r )rU rV r� r* r` rV ra r� r� � enumerater r Ztempdirr- rm rt r� r� r r� rx rJ ry rL r rw r� )r� �callbackrA ZmtypeZupdate_env_for_mountZ log_errorZmtypes�indexr Ztmpdr� r Zfailure_reasonZmountcmd�excr� r1 r1 r2 �mount_cb� sv
r c C s
t jt�S )N)�obj_copy�deepcopyr r1 r1 r1 r2 �get_builtin_cfg� s r c C s t jd| � tjj| �S )Nz Testing if a link exists for %s)rJ ry r- rm �islink)rm r1 r1 r2 �is_link� s r c C sh t jd|| � |rXtjj|�rXtjjtjj|�dtd� �}tj| |� tj ||� d S tj| |� d S )Nz$Creating symbolic link from %r => %rZtmpr� )
rJ ry r- rm rs rL r� r� �symlinkr� )�source�link�forceZtmp_linkr1 r1 r2 �sym_link� s r c C sP t jd| � ytj| � W n0 tk
rJ } z|jtkr:|�W Y d d }~X nX d S )NzAttempting to remove %s)rJ ry r- �unlinkrx r� r )rm rz r1 r1 r2 �del_file s
r c C s t jd| |� tj| |� d S )NzCopying %s to %s)rJ ry rX �copy)r� r� r1 r1 r2 r s r c C s2 yt jdt j� �} W n tk
r, d} Y nX | S )Nz%a, %d %b %Y %H:%M:%S %zz??)�timeZstrftimeZgmtimer� )Ztsr1 r1 r2 � time_rfc2822 s
r c s� ddl � ddl� d} G � fdd�d� j�}� j� jjd��}� j� }� j|�|_|� }|j d| � j
|�� j
|�dd�d kr�|j |j d S t
d
��dS ) z�Use sysctlbyname(3) via ctypes to find kern.boottime
kern.boottime is of type struct timeval. Here we create a
private class to easier unpack it.
@return boottime: float to be compatible with linux
r N� c s e Zd Zd� jfd� jfgZdS )zboottime.<locals>.timeval�tv_sec�tv_usecN)r| r} r~ Zc_int64Z_fields_r1 )�ctypesr1 r2 �timeval' s r$ �cs
kern.boottimer� g ��.Az/Unable to retrieve kern.boottime on this systemr� )r# Z ctypes.utilZ StructureZCDLL�utilZ find_libraryZc_size_tZsizeof�valueZ sysctlbynameZbyrefr! r" � RuntimeError)Z
NULL_BYTESr$ ZlibcrU r� r1 )r# r2 �boottime s" r) c C st d} d}yDt jjd�r4d}td�}|rJ|j� d } nd}ttj� t� �} W n" tk
rn t t
d| � Y nX | S )Nz??r z /proc/uptimer r# z&Unable to read uptime using method: %s) r- rm r� r� r0 rV r r) r� r� rJ )Z
uptime_strr rv r1 r1 r2 �uptime< s r* c C s t | |dd d� d S )Nr> )�omoder0 )�
write_file)rm �contentr1 r1 r2 � append_fileO s r. � )�
preserve_mode)r0 r0 r_ c C s t | dd||d� d S )Nr� r> )r- r+ r0 r0 )r, )rm r0 r0 r1 r1 r2 � ensure_fileS s r1 c C s& yt | �S ttfk
r d S X d S )N)r, rm r` )Z possible_intr1 r1 r2 �safe_int[ s r2 c
C s4 t |�}| r0|r0t| �� tj| |� W d Q R X d S )N)r2 ri r- r� )rm r0 Z real_moder1 r1 r2 r� b s
r� )�grp_namer_ c C s: d}yt j| �j}W n tk
r4 tjd| � Y nX |S )zt
Returns the group id of a group name, or -1 if no group exists
@param grp_name: the name of the group
r� z"Group %s is not a valid group namer� )r6 r7 r8 r9 rJ ry )r3 r� r1 r1 r2 � get_group_idi s r4 )rm r_ c C s t jtj | �j�S )z�
Returns the octal permissions of the file/folder pointed by the path,
encoded as an int.
@param path: The full path of the file/folder.
)rv �S_IMODEr- �st_mode)rm r1 r1 r2 �get_permissionsw s r7 c C s t j| �}tj|j�jS )zw
Returns the owner of the file/folder pointed by the path.
@param path: The full path of the file/folder.
)r- rv r� �getpwuid�st_uidZpw_name)rm �str1 r1 r2 � get_owner� s
r; c C s t j| �}tj|j�jS )zw
Returns the group of the file/folder pointed by the path.
@param path: The full path of the file/folder.
)r- rv r6 �getgrgid�st_gid�gr_name)rm r: r1 r1 r2 � get_group� s
r? )�usernamer_ c C sN g }x&t j� D ]}| |jkr|j|j� qW tj| �j}|jt j|�j� |S )zp
Returns a list of all groups to which the user belongs
@param username: the user we want to check
) r6 ZgetgrallZgr_memr� r> r� r� Zpw_gidr< )r@ �groupsr� r� r1 r1 r2 �get_user_groups� s
rB r? )�ensure_dir_existsr� r� c ! C s� |r&y t | �}W n tk
r$ Y nX |r@ttjj| �||d� d|j� krZt|�}d}n t|�}d}y d| } W n t k
r� d| } Y nX t
j d| || t |�|� t
| d��. t| |��}
|
j|� |
j� W d Q R X W d Q R X t| |� d S )
a)
Writes a file with the given content and sets the file mode as specified.
Restores the SELinux context if possible.
@param filename: The full path of the file to write.
@param content: The content to write to the file.
@param mode: The filesystem mode to set on the file.
@param omode: The open mode used when opening the file (w, wb, a, etc.)
@param preserve_mode: If True and `filename` exists, preserve `filename`s
current mode instead of applying `mode`.
@param ensure_dir_exists: If True (the default), ensure that the directory
containing `filename` exists before writing to
the file.
@param user: The user to set on the file.
@param group: The group to set on the file.
)r� r� �br[ Z
charactersz%oz%rz Writing to %s - %s: [%s] %s %s)rm N)r7 rx r� r- rm r� r� r^ rZ r` rJ ry rI ri r� r� r� r� ) r� r- r0 r+ r0 rC r� r� Z
write_typeZmode_rZfhr1 r1 r2 r, � s8
r, c C sD x>t j| �D ]0}t jj| |�}t jj|�r4t|� q t|� q W dS )z�
Deletes all contents of a directory without deleting the directory itself.
@param dirname: The directory whose contents should be deleted.
N)r- rz rm rL re rY r )r� ZnodeZ
node_fullpathr1 r1 r2 �delete_dir_contents� s
rE r� �createdc C s6 t j� }t| �}|d|j� |f 7 }|dt� 7 }|S )Nz %s by cloud-init v. %sz on %s)r Zversion_stringrV �titler )Z comment_charr^ Zci_ver�headerr1 r1 r2 � make_header� s
rI c C s� t | ttf�s tdtj| � ��d}|r0|d7 }dd }d}x�| D ]�}t |ttf�r�g }x&|D ] }|jdt|�jd|� � q^W d |d
j |�f }|d 7 }qBt |t�r�d ||f }|d 7 }qB|d kr�qBtd tj|�|f ��qBW t
j d
|� |S )Nz8Input to shellify was type '%s'. Expected list or tuple.r� z
#!/bin/sh
z%s%s%s%s�'�\r z'%s'z%s%s
r< r� zCUnable to shellify type '%s'. Expected list, string, tuple. Got: %szShellified %s commands.)rJ rK rJ rJ ) rU r* r� r` r r� r� rV r� rL rJ ry )ZcmdlistZ
add_headerr- ZescapedZ cmds_mader� Zfixedrx r1 r1 r2 �shellify� s4
rL c C sB |r | j |�r | t|�d � } |r>| j|�r>| d t|� � } | S )N)r� rI rw )rO �prefix�suffixr1 r1 r2 �strip_prefix_suffix" s
rO c C s@ t j| d �d krdS yt j | � W n t jk
r: dS X dS )Nr FT)r �whichrM )r� r1 r1 r2 �_cmd_exits_zero* s rQ c C s t dddg�S )Nzsystemd-detect-virtz--quietz --container)rQ r1 r1 r1 r2 �_is_container_systemd4 s rR c C s
t dg�S )Nzlxc-is-container)rQ r1 r1 r1 r2 �_is_container_old_lxc8 s rS c C sD t � s
dS dddg} tj| d �d kr*dS tj| �\}}|j� dkS )NFr� z-qnzsecurity.jail.jailedr r! )r� r rP r7 )r� r8 r r1 r1 r2 �_is_container_freebsd< s
rT c C s� t ttf} x| D ]}|� rdS qW y$td�}d|kr8dS d|krDdS W n ttfk
r^ Y nX tjjd�r~tjjd� r~dS yHt d�j
� }x6|D ].}|j d�r�|j � j
d d�\}}|d
kr�dS q�W W n ttfk
r� Y nX d S ) zH
Checks to see if this code running in a container of some sort
Tr� Z containerZLIBVIRT_LXC_UUIDz/proc/vzz/proc/bcz/proc/self/statuszVxID:r> r% F)rR rT rS � get_proc_envr� rx r- rm re r� rF r� r7 r0 )Zchecks�helperZpid1env�linesrO Z_keyrQ r1 r1 r2 r� F s4
r� c C s t jjd�S )z2Check to see if we are running in a lxd container.z
/dev/lxd/sock)r- rm r� r1 r1 r1 r2 �is_lxdt s rX r� c C s� t jjdt| �d�}yt|dd�}W n ttfk
r< i S X i }d
\}}|rbd \}}|j||�}x4|j|�D ]&}|sxqn|j|d �\} }
| rn|
|| < qnW |S ) aH
Return the environment in a dict that a given process id was started with.
@param encoding: if true, then decoding will be done with
.decode(encoding, errors) and text will be returned.
if false then binary will be returned.
@param errors: only used if encoding is true.z/procrC F)rW r � =r� �=r� )r rY )r� rZ ) r- rm rL rV r� r� rx rW r0 ) �pidrY �errorsr� rv �envZnullZequalr+ r� rQ r1 r1 r2 rU y s" rU c C sT i }xJ| j � D ]>}y|j dd�\}}W n tk
rB |}d}Y nX |||< qW |S )NrZ r� T)r0 rm )Zkvstringr� r+ r� rQ r1 r1 r2 �keyval_str_to_dict� s
r^ c C s& | j d�r| dd � } tjjd| �S )Nz/dev/rZ z /sys/class/block/%s/partition)r� r- rm r� )r� r1 r1 r2 � is_partition� s
r_ c C s� t |t�s|g}g }x�|D ]�}t |t�r4|j|� qt |ttf�r�t|�dk sZt|�dkrbtd��t|�dkr�|d r�|j| t|� � q|j|d � qtd��qW |S )Nr� r) z Invalid package & version tuple.r zInvalid package type.)rU r� rV r� r* rI r( )Z version_fmtZpkgsZpkglist�pkgr1 r1 r2 �expand_package_list� s
ra c C s� dd� | j d�D �}d}d}d}d}�xHt|�D �]:\} }
|
j � } t| �dk rj|jd| d t| �|
� dS | d } d d� | j d�D �}
t|
�t|�kr�q0tt|
�t|��}|
d
|� |d
|� kr�q0|dk r�t|�t|
�kr�q0y| jd �} W n( tk
�r |jd | d |
� dS X y | | d }| | d
}W n( tk
�rZ |jd| d |
� dS X | }|
}| d }q0W |�r�|�r�|�r�|�r�|�r�||||fS n |�r�|�r�|�r�|||fS dS )zRReturn the mount information for PATH given the lines from
/proc/$$/mountinfo.c S s g | ] }|r|�qS r1 r1 )r? rz r1 r1 r2 rB � s z$parse_mount_info.<locals>.<listcomp>r* Nrr z$Line %d has two few columns (%d): %sr� r� c S s g | ] }|r|�qS r1 r1 )r? rz r1 r1 r2 rB � s r �-z,Did not find column named '-' in line %d: %sr) z/Too few columns after '-' column in line %d: %srZ )r0 r rI ry �minr rm �
IndexError)rm Zmountinfo_linesr� � get_mnt_opts�
path_elements�devpth�fs_type�match_mount_point�match_mount_point_elementsr� rO r� � mount_point�mount_point_elements�x�
mount_optionsr1 r1 r2 �parse_mount_info� sX
ro c C sB x<t d�j� D ],}|j� dd� \}}}|| kr|||fS qW dS )z<On older kernels there's no /proc/$$/mountinfo, so use mtab.z /etc/mtabNr� )r� rF r0 )rm rO rg rk rh r1 r1 r2 �
parse_mtab
s
rp c C s� | j d�}t|�dkr |d S t|�dkr2|d S |d dkr�| d d � }tjd
d d g�\}}x<|j d
�D ].}|j � }t|�dkrj|d |krj|d }P qjW t|�S tjd| � d S )Nr* r� r r� r) r� �gptr
rZ Zglabel�statusz-sr� z)Unexpected input in find_freebsd_part: %s)r� rq r
)r0 rI r rV rJ rK )ZfsZsplittedZ target_labelrf r� Zlabelsr� r1 r1 r2 �find_freebsd_part
s
rs c C sJ d }x@|j d�D ]2}|j � }t|�dkrtjj|d | �r|}P qW |S )Nr� r) r� )r0 rI r- rm r� )rm �mnt_list�
path_foundrO r� r1 r1 r2 �get_path_dev_freebsd/
s rv c C sl t j dd| gddgd�\}}t|�rPt j ddg�\}}t| |�}|d krLd S |}|j� }t|d �}d| S )Nr z-pr r� )r� z/dev/)r rI rv r0 rs )rm r� rS rt ru r� Z
label_partr1 r1 r2 �get_freebsd_devpth9
s
rw c C s� t jjd�stjd� d S ytjdd| g�\}}W n0 tjk
rb } ztjd| |� d S d }~X nX t|�rpd S d}xL|j d�D ]>}t
j ||�r�| |kr�d|kr�|j � d }tjd
| |� |S q�W d S ) Nz/dev/zfsz"Cannot get zpool info, no /dev/zfs�zpoolrr z$Unable to get zpool status of %s: %sz .*(ONLINE).*r� �stater zfound zpool "%s" on disk %s) r- rm r� rJ ry r rM rK rI r0 r� r )rx Z zpoolstatusrS r� rO Zdiskr1 r1 r2 �get_device_info_from_zpoolG
s
rz c C s� t j dg�\}}d}dd� | jd�D �}d}d}d}d} �x8|j� D �]*}
tj||
�} | s\qD| jd�}| jd�}d d� |jd�D �} t| �t|�kr�qDtt| �t|��}
| d
|
� |d
|
� kr�qD| dk r�t| �t| �kr�qD|}| } | jd �}| jd �}|dk �r"d
j| jd �j d
�j � jd��}t
j d||||� tjd|�}| �rbt � �rb|dk�rbt
|�}|}|| krDP qDW | �s�|| k�r�dS |�r�|�r�|�r�|�r�|�r�||||fS n |�r�|�r�|�r�|||fS dS )z�Return the mount information for PATH given the lines ``mount(1)``
This function is compatible with ``util.parse_mount_info()``r ze^(?P<devpth>[\S]+?) on (?P<mountpoint>[\S]+?) (\(|type )(?P<type>[^,\(\) ]+)( \()?(?P<options>.*?)\)$c S s g | ] }|r|�qS r1 r1 )r? rz r1 r1 r2 rB h
s z parse_mount.<locals>.<listcomp>r* Nrg r c S s g | ] }|r|�qS r1 r1 )r? rz r1 r1 r2 rB s
s r ra r� rC z, zNfound line in mount -> devpth: %s, mount_point: %s, fs_type: %s, options: '%s'z^(/dev/.+)[sp]([0-9])$�zfs�nfs)r{ r| )r r0 rF r� r r� rI rc rL r7 rJ ry r� rw )rm re Z mountoutputr� Zregexrf rg rk ri rj rO r rl rm rh rn ZdevmZ match_devpthr1 r1 r2 � parse_mount[
sb
r} c C sT dt j� }t jj|�r2t|�j� }t| |||�S t jjd�rFt| �S t| |�S d S )Nz/proc/%s/mountinfoz /etc/mtab) r- �getpidrm r� r� rF ro rp r} )rm r� re Zmountinfo_pathrW r1 r1 r2 �get_mount_info�
s r )�optr_ c C s t | dd��^ }}||jd�kS )NT)re rC )r r0 )rm r� r Zmnt_optsr1 r1 r2 �
has_mount_opt�
s r� �T.)r� r_ c $ C s� |d kr g }|d kri }t j � }d }|rLytt� �}W n tk
rJ Y nX z|||�}W d t j � | } d }
|d k r�ytt� �| }
W n tk
r� Y nX d| } |r�t|
t�r�| d|
7 } n| d7 } y| || � W n tk
r� Y nX X |S )Nz took %0.3f secondsz (%0.2f)z (N/A))r �floatr* rm rU r� ) r� rq r� r� r� Z
get_uptime�startZustartr� ZdeltaZudeltaZtmsgr1 r1 r2 r� �
s<
r� c C s( | j dd�}t|�dkr |S | d fS d S )Nr( r� )�rsplitrI )Zdottedr� r1 r1 r2 �expand_dotted_devname s r� c C s� |d kr g }|d krg }g }i }xp|| D ]d}y t | | | ddd�||< W q* tk
r� } z$|jtkrj� ||kr||j|� W Y d d }~X q*X q*W t|�r�tdjdj|�d���|S )NF)r� rW z Missing required files: {files}rC )�files) r� r� r� r r� rI rm rV rL )r^ ZrequiredZoptionalZdelimrR r� rx rz r1 r1 r2 �pathprefix2dict s$
r� �
/proc/meminfoc
C s� d d
ddd�}ddd d
�}i }x�t | �j� D ]v}y|j� \}}}W n$ tk
rf |j� \}}d }Y nX |r�t|�|| ||< q,||kr,t|�|| ||| < q,W |S )Nr) rr � r� � )ZkBZmB�BZgBZtotalZfreeZ available)z MemTotal:zMemFree:z
MemAvailable:r� i i i @)r� rF r0 rm r, ) Zmeminfo�raw�mpliersZkmapr� rO r� r' Zunitr1 r1 r2 � read_meminfo2 s
r� c C s� | }| j d�r | dd� } n| j d�r2| dd� } dddddd
�}| }d}x,|D ]$}| j |�rP|}| d t|� � }qPW y t|�}W n0 tk
r� } ztd | �|�W Y dd}~X nX |d k r�td
| ��t||| �S )a} Convert human string or integer to size in bytes
In the original implementation, SI prefixes parse to IEC values
(1KB=1024B). Later, support for parsing IEC prefixes was added,
also parsing to IEC values (1KiB=1024B). To maintain backwards
compatibility for the long-used implementation, no fix is provided for SI
prefixes (to make 1KB=1000B may now violate user expectations).
Future prospective callers of this function should consider implementing a
new function with more standard expectations (1KB=1000B and 1KiB=1024B)
Examples:
10M => 10485760
10MB => 10485760
10MiB => 10485760
ZiBNr) r� r� rr r� r� �( )r� �K�M�Gr� r z'%s' is not valid input.z'%s': cannot be negative���r� i i i @l )rw rI r� rm r, )rU Zsize_inr� ZnumZmplierr rz r1 r1 r2 � human2bytesJ s&
r� c C s< | dkrt j� d } | dkp6| d dko6| dd� dk}|S )z$Return True if platform is x86-basedNr� Zx86_64r r� r) Z86)r- r. )Z
uname_archZx86_arch_matchr1 r1 r2 �is_x86u s
r� c C s, t jd d� dk r"tjtj| ��S tj| �S )Nr) � )r) r� )r� � version_info�emailZmessage_from_filer� �StringIO�message_from_string)r� r1 r1 r2 r� s r� c C s~ t j ddg| dd�}t� }x^|jj� D ]P}y|jd d�\}}}W n tk
rV w&Y nX |jd
�r&|jtj dd |�� q&W |S ) Nz
dpkg-queryz--listT)r5 r4 r) �hi�iiz:.*r� )r� r� )
r r� r6 rF r0 rm r� r� r� �sub)r5 r8 Z pkgs_instrO ry r` r r1 r1 r2 �get_installed_packages� s
r� c C s� d} y,t t| dd��}|jdd�j� dkr.dS W n0 tk
r` } ztjd| |� W Y d d }~X nX t� }d|krtdS td dd�}d|j� kr�dS tj j
d
�r�dS d S ) Nz/etc/os-releaseT)r� r� r� z ubuntu-corez!Unexpected error loading '%s': %sz
snap_core=z /etc/system-image/channel.iniz/etc/system-image/config.d/F) r r� r r� rm rJ rK r� r- rm re )ZorpathZorinforz r r- r1 r1 r2 �system_is_snappy� s r� c C s� d }x(| j � D ] }|jd�r|dd � }P qW |d kr:d S |jd�rH|S |jd�rfd|td�d � S |jd�r�d|td�d � j� S |jd�r�d |td�d � j� }tjj|�r�|S t|�}|r�|d
S |S d| S ) Nzroot=rZ z/dev/zLABEL=z/dev/disk/by-label/zUUID=z/dev/disk/by-uuid/z PARTUUID=z/dev/disk/by-partuuid/r )r0 r� rI r� r- rm r� r� )r r r+ Z
disks_path�resultsr1 r1 r2 �rootdev_from_cmdline� s,
r� c C sJ dd� }i }x8|| �D ],}|j dd�\}}|s2|}|s:|r|||< qW |S )z�Given shell like syntax (key=value
key2=value2
) in content
return the data in dictionary form. If 'add_empty' is True
then add entries in to the returned dictionary for 'VAR='
variables. Set their value to empty_val.c S s t j| dd�S )NT)Zcomments)�shlexr0 )rX r1 r1 r2 � _shlex_split� s z(load_shell_content.<locals>._shlex_splitrZ r� )r0 )r- Z add_emptyZ empty_valr� rA rO r� r' r1 r1 r2 r � s r � �?c C s� t | �}d}xr|t dd� |D ��8 }t|�dkrDtjd||| � g S |dkr\tjd||| � || |krjP tj|� ||7 }qW tjd|||� |S )Nr c S s g | ]}t jj|�r|�qS r1 )r- rm r� )r? rx r1 r1 r2 rB � s z"wait_for_files.<locals>.<listcomp>z)%sAll files appeared after %s seconds: %sz6%sWaiting up to %s seconds for the following files: %sz*%sStill missing files after %s seconds: %s)r� rI rJ ry r Zsleep)�flistZmaxwaitZnaplenZlog_preZneedZwaitedr1 r1 r2 �wait_for_files� s0
r� c C s& t | dd�}|d jd�}|d dkS )z1Check whether the given mount point is mounted rwT)re r� rC r Zrwr� )r r0 )rk r� Z
mount_optsr1 r1 r2 �mount_is_read_write� s r� c C sX t jd�sdS ddg}| r:tjj| �r*dS |jd| g� |rN|jd| g� t j |�S )zAInvoke udevadm settle with optional exists and timeout parametersZudevadmNZsettlez--exit-if-exists=%sz --timeout=%s)r rP r- rm r� r� )r� r` Z
settle_cmdr1 r1 r2 �udevadm_settle s
r� c C s� d}yJt d| dd�}|rLtjdt|��}|r>t|jd��}ntjd| |� W n0 tk
r~ } ztjd| |� W Y d d }~X nX |S )
zH
Return the parent pid of a process by parsing /proc/$pid/stat.
r z
/proc/%s/statT)r� z ^\d+ \(.+\) [RSDZTtWXxKPI] (\d+)r� z6Unable to match parent pid of process pid=%s input: %sz Failed to load /proc/%s/stat. %sN) r� r� r rV r, r� rJ rK r� )r[ �ppidrv r rz r1 r1 r2 �get_proc_ppid_linux s
r� c C s& t j dddt| �g�\}}t|j� �S )z;
Return the parent pid of a process by checking ps
Zpsz-oppid=z-p)r rV r, r7 )r[ r� r r1 r1 r2 �get_proc_ppid_ps. s r� c C s t � rt| �S t| �S dS )z-
Return the parent pid of a process.
N)r� r� r� )r[ r1 r1 r2 �
get_proc_ppid6 s r� r� � Error:
{}c C s& t |j| �tjd� |r"tj|� |S )a
Print error to stderr and return or exit
@param msg: message to print
@param rc: return code (default: 1)
@param fmt: format string for putting message in (default: 'Error:
{}')
@param sys_exit: exit when called (default: false)
)�file)�printrV r� r� �exit)rq Zrcr� Zsys_exitr1 r1 r2 r� @ s
r� c s^ e Zd Zd� fdd� Zeed�dd��Zdd� Zd d
� Zd d � Z d
d� Z
e d�dd�Z � Z
S )�Versionr� c s t t| �j| ||||�S )zPDefault of -1 allows us to tiebreak in favor of the most specific
number)�superr� �__new__)�cls�major�minor�patch�rev)� __class__r1 r2 r� Q s zVersion.__new__)r c C s | t tt|jd���� S )Nr( )r� r+ r, r0 )r� r r1 r1 r2 �from_strV s zVersion.from_strc C s d| j |�kS )Nr� )�_compare_version)ro �otherr1 r1 r2 �__gt__Z s zVersion.__gt__c C s0 | j |j ko.| j|jko.| j|jko.| j|jkS )N)r� r� r� r� )ro r� r1 r1 r2 �__eq__] s zVersion.__eq__c c s8 x2| j | j| j| jfD ]}|dkr.t|�V qP qW dS )z)Iterate over the version (drop sentinels)r� Nr� )r� r� r� r� rV )ro �nr1 r1 r2 �__iter__e s zVersion.__iter__c C s
dj | �S )Nr( )rL )ro r1 r1 r2 �__str__m s zVersion.__str__)r_ c C sP | |kr dS | j |j kr dS | j|jkr,dS | j|jkr<dS | j|jkrLdS dS )z�
return values:
1: self > v2
-1: self < v2
0: self == v2
to break a tie between 3.1.N and 3.1, always treat the more
specific number as larger
r r� r� )r� r� r� r� )ro r� r1 r1 r2 r� p s
zVersion._compare_versionr� r� r� r� )r� r� r� r� )r| r} r~ r� � classmethodrV r� r� r� r� r� r, r� �
__classcell__r1 r1 )r� r2 r� O s r� r� r� r� r� )�
extra_message�schedule�
return_log)�
deprecated�deprecated_versionr� r� r� c
C s� t td�st� t_|pd}t| | | t|� �}tj|�}t|j| |j �}| � d|� d|� d|� �j
� } |rt| S |tjkr�tjj |� t t d�r�t j
| � n
t j| � dS )a� Mark a "thing" as deprecated. Deduplicated deprecations are
logged.
@param deprecated: Noun to be deprecated. Write this as the start
of a sentence, with no period. Version and extra message will
be appended.
@param deprecated_version: The version in which the thing was
deprecated
@param extra_message: A remedy for the user's problem. A good
message will be actionable and specific (i.e., don't use a
generic "Use updated key." if the user used a deprecated key).
End the string with a period.
@param schedule: Manually set the deprecation schedule. Defaults to
5 years. Leave a comment explaining your reason for deviation if
setting this value.
@param return_log: Return log text rather than logging it. Useful for
running prior to logging setup.
Note: uses keyword-only arguments to improve legibility
�_logr� z is deprecated in z and scheduled to be removed in z. r� N)rn � deprecater� r� �hashrV r� r� r� r� r� r� rJ r� rK )
r� r� r� r� r� �messageZdedupr Zversion_removedZ
deprecate_msgr1 r1 r2 r� � s
r� )r� )r� r� r� c s � ��fdd�}|S )a~ Mark a "thing" as deprecated. Deduplicated deprecations are
logged.
@param deprecated_version: The version in which the thing was
deprecated
@param extra_message: A remedy for the user's problem. A good
message will be actionable and specific (i.e., don't use a
generic "Use updated key." if the user used a deprecated key).
End the string with a period.
@param schedule: Manually set the deprecation schedule. Defaults to
5 years. Leave a comment explaining your reason for deviation if
setting this value.
Note: uses keyword-only arguments to improve legibility
c s t j� ���� �fdd��}|S )Nc s �| |�}t � �j��d� |S )N)r� r� r� r� )r� r| )r� r� r8 )r� r� r� r� r1 r2 � decorator� s
z2deprecate_call.<locals>.wrapper.<locals>.decorator)� functools�wraps)r� r� )r� r� r� )r� r2 �wrapper� s z deprecate_call.<locals>.wrapperr1 )r� r� r� r� r1 )r� r� r� r2 �deprecate_call� s r� )r r! r" r# )r$ r% r& r' )N)N)rT )rT )N)N)N)r� N)N)TT)F)N)r )N)N)N)NN)F)r� r� rZ )N)r� r� rZ rr r )N)N)F)r� )Nr� NFN)Nr� NFN)Nr� NFN)Nr� NFN)Nr� NFN)NF)NFT)r� N)NN)NN)N)r� )NNN)NNNT)F)r/ )r/ r? F)r� rF )T)NN)rT r� )F)NNF)r� F)N)N)FN)r� r� )NN)r� r� F)�rb r� r r r� r� r� r6 r� r� r� r� r� r- Zos.pathr� r� r� r� r� rX r� rv r� rD r� r �base64r � collectionsr r r r� r r r r Zpathlibr
Ztypingr r r
r r r r r Zurllibr Z cloudinitr r r r r r r r r r Zcloudinit.settingsr r� Z getLoggerr| rJ �sepr� r� r� r� r� r� r3 r9 r= rZ r^ r[ rd rh ri r� r r� r� r� r� r� r� r� r� r� r� r� r� r� rV rN r� r� �DEBUGr� r� r� r� r� r� r� r� r� r� r� r
r' r� r) r, r3 r. rO �contextmanagerrQ r5 rW rY rd rj r� r[ r| r~ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r- r� r� r� �BufferedIOBaser� r� r� r� r� r� r� r� r� r r r r r r r r) r* r. r, r1 r2 r� r4 r7 r; r? rB r, rE rI rL rO rQ rR rS rT r� rX rU r^ r_ ra ro rp rs rv rw rz r} r r� r� r� r� rm r� r� r� r� r� r� r� r� r r� r� r� r� r� r� r� r� r� r� r1 r1 r1 r2 �<module> s� (
0
.
2
& (>8 P8
!( + , # + (3
?
:
+ X #
4 %
. N
W'
' +
;(,