HOME

�
��\c@s�dd
lZdd
l
jZdd
lZdd
lZdd
lZddlmZ
dd
l	Z	ddl
mZmZ
ej
j�Zdef
d��YZd
S(i����N(
tcommands(tPopentPIPEtPlugincBsoeZ
dZd
�Zd�Zd�Zed��
Zed��
Z	ed��
Z
ed��
Zd�Zd	�Z
d
�Zd�Zd�Zd
�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zed�
Zd�Zd�Z d�Z!ed�
Z"d�Z#d�Z$ed �
Z%d!�Z&d"�Z'd#�Z(d$�Z)d%�Z*d&�Z+d=d=d=d'�Z-d=d(�
Z.d=d)�
Z/d=d*�
Z0d+�Z1d,�Z2d-�Z3d.�Z4d/�Z5d=ed0�Z6d=d=d1�Z7d2�Z8d3�Z9d4�Z:d=d5�
Z;d=d6�
Z<d7�Z=d8�Z>d9�Z?d:�Z@d;�ZAd<�ZBRS(>s

	Base class for all plugins.

	Plugins change various system settings in order to get desired performance or power
	saving. Plugins use Monitor objects to get information from the running system.

	Intentionally a lot of logic is included in the plugin to increase plugin flexibility.
	c		Cs�|j|j
j�
|_|
|_||_||_||_||_t	j
�|_|j�
||_
||_t|_t|_|j�|_t�|_d
S(sPlugin constructor.N(tcreatet	__class__t__name__t_storaget_monitors_repositoryt_hardware_inventoryt_device_matchert_device_matcher_udevt_instance_factorytcollectionstOrderedDictt
_instancest_init_commandst_global_cfgt
_variablestFalset_has_dynamic_optionst_devices_initedt#_get_config_options_used_by_dynamict_options_used_by_dynamicRt_cmd(	tselftmonitors_repositorytstorage_factorythardware_inventorytdevice_matchertdevice_matcher_udevtinstance_factoryt
global_cfgt	variables((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt__init__s
	
	
	
	
	

	
	
	
	c


Cs|j�
dS(
N(
tdestroy_instances(
R((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytcleanup,s
c

Cs#|js|j
�
t|_ndS(
N(Rt
_init_devicestTrue(
R((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytinit_devices/s
	


c

Cs'|jj
jd
�
djdd�dS(Nt
.i����t
_i
(Rt
__module__tsplit(
R((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytname4sc


CsiS(
s-Default configuration options for the plugin.((
R((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_get_config_options<sc


CsiS(
s*Explanation of each config option function((
tcls((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytget_config_options_hintsAsc


CsgS(
snList of config options used by dynamic tuning. Their previous values will be automatically saved and restored.((
R((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyRFscCsj|j�j
�}xQ|
D]I}||ks4|jrE|
|||<qtjd
||jjf�

qW|S(s3Merge provided options with plugin default options.s$Unknown option '%s' for plugin '%s'.(R-tcopyRtlogtwarnRR(Rtoptionst	effectivetkey((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_get_effective_optionsKs



!
cCs>t|
�
t
kr|
St|
�
j�}
|
d
kp=|
dkS(Nttruet
1(ttypetbooltstrtlower(Rtvalue((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_option_boolVs



c	Csf|
|jkr"t
d
|
�
�
n|j|�
}|jj||
|||||�}||j|
<|S(s8Create new instance of the plugin and seize the devices.s.Plugin instance with name '%s' already exists.(Rt	ExceptionR6RR(	RR,tdevices_expressiontdevices_udev_regext
script_pretscript_postR3teffective_optionstinstance((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytcreate_instance`s




cCs{|
j|kr(t
d
|
|f�
�
n|
j|jkrMt
d|
�
�
n|j|
j}
|j|
�

|j|
j=dS(sDestroy existing instance.s9Plugin instance '%s' does not belong to this plugin '%s'.s+Plugin instance '%s' was already destroyed.N(t_pluginR?R,Rt_destroy_instance(RRE((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytdestroy_instancels





cCs.tj
d
|
j|jf�

|j|
�

dS(sInitialize an instance.sinitializing instance %s (%s)N(R1tdebugR,t_instance_init(RRE((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytinitialize_instancews
c
Cs[xGt|j
j��
D]0}
tjd
|
j|jf�

|j|
�

qW|j
j�
dS(sDestroy all instances.sdestroying instance %s (%s)N(tlistRtvaluesR1RJR,RHtclear(RRE((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR#|s


cCs|j|
�

|j
|
�

dS(
N(trelease_devicest_instance_cleanup(RRE((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyRH�s


c
Cs
t��
dS(
N(
tNotImplementedError(RRE((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyRK�s
c
Cs
t��
dS(
N(
RR(RRE((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyRQ�s
c

Cs%t|_
t�|_t�|_dS(
N(Rt_devices_supportedtsett_assigned_devicest
_free_devices(
R((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR%�s
	

c
Csd
S(s�Override this in a subclass to transform a list of device names (e.g. ['sda'])
		   to a list of pyudev.Device objects, if your plugin supports itN(
tNone(Rtdevices((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_get_device_objects�scCs�|
jdkr+t|jj|
j|��
S|j|�
}|dkr`tjd
|j	�
t�S|j
j|
j|�}tg|D]}|j^q��
SdS(Ns<Plugin '%s' does not support the 'devices_udev_regex' option(RARWRTR
t
match_listR@RYR1terrorR,Rtsys_name(RRERXtudev_devicest
x((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_get_matching_devices�s






cCs�|js
dSt
jd
|
j�

|j|
|j�}t|�
dk|
_|
jskt
jd|
j�

n}|
j}|
j|jkr�|d|j7}nt
j	d|dj
|�
f�

|
jj|�

|j
|O_
|j|8_dS(Ns assigning devices to instance %sis*instance %s: no matching devices availables (%s)s!instance %s: assigning devices %ss, (RSR1RJR,R_RVtlentactiveR2tinfotjointassigned_devicestupdateRU(RREt	to_assignR,((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytassign_free_devices�s
	



	
	


 


cCsi|js
dS|
j
|
jB|j@}t|
_|
j
j�
|
jj�
|j|8_|j|O_dS(
N(RStprocessed_devicesRdRURRaRORV(RREt
to_release((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyRP�s
	



	





cCs7|jsdg
}nx|D]}||
|�
qWdS(
N(RSRW(RREtcallbackRXtdevice((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_run_for_each_device�s
	


c
CsdS(
N((RREtenabling((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_instance_pre_static�s
c
CsdS(
N((RRERm((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_instance_post_static�s
cCs�
|dkrdSt
|�
d
kr@tjd|
j|f�

dS|jd�
sdtjdd�

tStj	j
|�
}t}xR
|D]J
}tj}	|	j
|jj��

|g
}
|r�|
jd�

n|
j|�

tjd|t|
�
f�

tjdtt|	j��
�
�

y�t|g
|
d	td
tdtd|	d
|dt�
}|j�\}}
|jr�
tjd||j|
d f�

t}nWq�ttfk
r�

}
tjd||f�

t}q�Xq�W|S(Nis1Instance '%s': no device to call script '%s' for.t
/s<Relative paths cannot be used in script_pre or script_post. sUse ${i:PROFILE_DIR}.t
full_rollbacks'calling script '%s' with arguments '%s'susing environment '%s'tstdouttstderrt	close_fdstenvtcwdtuniversal_newlinessscript '%s' error: %d, '%s'i����sscript '%s' error: %s(RWR`R1R2R,t
startswithR[RtostpathtdirnameR&tenvironReRtget_envtappendRbR;RJRMtitemsR
Rtcommunicatet
returncodetOSErrortIOError(RREtscripttopRXRqtdir_nametrettdevR|t	argumentstproctoutterrt
e((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_call_device_script�sB






	






	

	





#






	
!





cCs�|
js
d
S|
j
r~|j|
|
jd|
j�
|j|
t�
|j|
�

|j|
t�
|j|
|
j	d|
j�
n|
j
r�|jjt
jt
j�r�|j|
|j|
j�
n|
jj|
j�

|
jj�
d
S(sG
		Apply static and dynamic tuning if the plugin instance is active.
		Ntapply(Rathas_static_tuningR�RBRdRnR&t_instance_apply_staticRoRCthas_dynamic_tuningRtgettconststCFG_DYNAMIC_TUNINGtCFG_DEF_DYNAMIC_TUNINGRlt_instance_apply_dynamicRhReRO(RRE((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytinstance_apply_tuning�s	
	









$


cCs�|
js
dSt|
j�
d
krBtjddj|
j�
�

n|
jj�}|
j	r�|j
|
|
jd|�tkrtS|j
|
||�tkr�tS|j
|
|
jd|�tkr�tStSdSdS(s<
		Verify static tuning if the plugin instance is active.
		is)BUG: Some devices have not been tuned: %ss, tverifyN(RaRWR`RdR1R[RcRhR0R�R�RBRt_instance_verify_staticRCR&(RREtignore_missingRX((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytinstance_verify_tuning
s	

	


	
!



!

cCsW|
js
d
S|
j
rS|jjtjtj�rS|j|
|j|
j	j
��
nd
S(s<
		Apply dynamic tuning if the plugin instance is active.
		N(RaR�RR�R�R�R�Rlt_instance_update_dynamicRhR0(RRE((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytinstance_update_tuning$
s	

$
cCs�|
jr@|j
jtjtj�r@|j|
|j|
j�
n|
j	r�|j
|
|
jd
|
jd|�

|j|
t
�
|j|
|�
|j|
t
�
|j
|
|
jd
|
jd|�

ndS(s8
		Remove all tunings applied by the plugin instance.
		tunapplyRqN(R�RR�R�R�R�Rlt_instance_unapply_dynamicRhR�R�RCRnRt_instance_unapply_staticRoRB(RRERq((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pytinstance_unapply_tuning-
s$

	






cCs$|j|
�

|j
|
|
j�
dS(
N(t _execute_all_non_device_commandst_execute_all_device_commandsRd(RRE((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�<
s


cCsOt}|j
|
|�tkr't}n|j|
||�tkrKt}n|S(
N(R&t_verify_all_non_device_commandsRt_verify_all_device_commands(RRER�RXR�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�@
s


	

	
cCs$|j|
|
j
�
|j|
�

dS(
N(t_cleanup_all_device_commandsRht _cleanup_all_non_device_commands(RRERq((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�H
s
	


cCswx`g|jD].}|j
|
|j||�dkr
|^q
D] }|j|
|j||�
q?W|j|
|�
dS(
N(Rt_storage_gett	_commandsRWt_check_and_save_valueR�(RRERktopttoption((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�M
s
E
c
Cs
t��
dS(
N(
RR(RRERk((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�S
s
c
Cs
t��
dS(
N(
RR(RRERk((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�V
s
c

Cs'tj
�|_|j�
|j�
d
S(s
		Initialize commands.
		N(R
RR�t_autoregister_commandst_check_commands(
R((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR]
s


c
Cs\
x%
|jj
D]
}
|
jd
�
r(q
nt||
�}t|d�sLq
n|jd}|jj|i
|d6�}d|jkr�d|d<||d<|jd|d<|jd|d<nZd|jkr�||d<n>d|jkr
||d<|jd|d<|jd|d<n||j|<q
Wt	j
tt|jj
��
d	d
��

�
|_dS(sd
		Register all commands marked using @command_set, @command_get, and @command_custom decorators.
		t__t_commandR,RTtcustomt
per_devicetpriorityR�R5c

Ss|d
dS(Ni
R�((
t	name_info((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt<lambda>�
sN(Rt__dict__RxtgetattrthasattrR�R�R�RWR
RtsortedtiterR(Rtmember_nametmembertcommand_nameRb((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�e
s*




















c
Csmxft|j
j��
D]O\}
}|jd
t�r:qnd|ksRd|krtd|
�
�
qqWdS(s2
		Check if all commands are defined correctly.
		R�R�RTs,Plugin command '%s' is not defined correctlyN(RMR�RR�Rt	TypeError(RR�tcommand((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR��
s
"

cCskt|�
j
}|
dkr!d
n|
}
|dkr9d
n|}|dkrQd
n|}d||
||fS(Nts%s/%s/%s/%s(R9RRW(Rt
instance_nameR�tdevice_namet
class_name((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_storage_key�
s



	
cCs3|j|
j
|d
|�}|jj||�
dS(NR,(R�R,RRT(RRER�R=R�R5((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_storage_set�
s

cCs,|j|
j
|d
|�}|jj|�
S(NR,(R�R,RR�(RRER�R�R5((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR��
s

cCs,|j|
j
|d
|�}|jj|�
S(NR,(R�R,Rtunset(RRER�R�R5((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_storage_unset�
s

cCs�x�gt|j
j��
D]}|d
s|^qD]M}|jj|
jj|dd��
}|dk	r3|j|
||�
q3q3WdS(NR�R,(	RMR�RNRtexpandR3R�RWt_execute_non_device_command(RRER�t	new_value((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR��
s
9
%

cCs�x�gt|j
j��
D]}|d
r|^qD]d}|jj|
jj|dd��
}|dkrpq3nx$|D]}|j|
|||�
qwWq3WdS(NR�R,(	RMR�RNRR�R3R�RWt_execute_device_command(RRERXR�R�Rk((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR��
s
9
%




cCs�t}x�gt
|jj��
D]}|d
s|^qD]a}|jj|
jj|dd��
}|dk	r9|j	|
|||�t
kr�t
}q�q9q9W|S(NR�R,(R&RMR�RNRR�R3R�RWt_verify_non_device_commandR(RRER�R�R�R�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR��
s

9
%



cCs�t}x�gt
|jj��
D]}|d
r|^qD]l}|
jj|dd�}|dkrjq9nx8|D]0}|j|
||||�tkrqt}qqqqWq9W|S(NR�R,(	R&RMR�RNR3R�RWt_verify_device_commandR(RRERXR�R�R�R�Rk((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR��
s

9





!

cCs�|
dk	r�t
|
�
}t|�
d
k
r.|
S|d
 }|d
}|dkrb|dkr^|S|
Syb|dkr�t|�
t|�
kr�|SdSn/|dkr�t|�
t|�
kr�|SdSnWq�tk
r�


tjd||||
f�

q�Xn|
S(Ni
t
<t
>shcannot compare new value '%s' with current value '%s' by operator '%s', using '%s' directly as new value(R�R�(RWR;R`tintt
ValueErrorR1R2(RR�t
current_valuetnwsR�tval((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_process_assignment_modifiers�
s(



















$
cCs/|dk	r |
d
|d|�

S|
d
�SdS(NR�R�(
RW(RR�RkR�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_get_current_value�
s

cCsY|j||�}|j
||�}|dk	rU|dk	rU|j|
|||�
n|S(
N(R�R�RWR�(RRER�RkR�R�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR��
s





cCso|d
dk	r-|d
t
||tt�
n>|j|
|||�}|dk	rk|d||dt�

ndS(NR�RTtsim(RWR&RR�(RRER�RkR�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR��
s




cCsi|d
dk	r*|d
t
|tt�
n;|j|
|d|�}|dk	re|d|dt�


ndS(NR�RTR�(RWR&RR�(RRER�R�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR��
s




cCsA|jj
t|
�
�
}tjd
|�r=tjdd|�S|S(Ns\s*(0+,?)+([\da-fA-F]*,?)*\s*$s^\s*(0+,?)+R�(RtunquoteR;tretmatchtsub(RR=t
v((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt_norm_values



c	Cs�
|dkrdSt
}|dkri|ri|dkrKtjtj|
�

ntjtj||
f�

tS|dk	re
|j|�
}|j|�
}yt	|�
t	|�
k}Wqe
t
k
ra



y"t	|d
�t	|d
�k}Wqb
t
k
r]



t|�
t|�
k}|s^
t|�
jd�
}x3|D](}|j
�}||k}|r+
Pq+
q+
Wq^
qb
Xqe
Xn|j|
|||d|�

|S(Nit
|Rk(RWRR1RbR�t STR_VERIFY_PROFILE_VALUE_MISSINGt'STR_VERIFY_PROFILE_DEVICE_VALUE_MISSINGR&R�R�R�R;R+tstript_log_verification_result(	RR,R�R�R�RkR�tvalsR�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt
_verify_value
s8














"














cCs�|rh|dkr;t
jtj|
t|�
j�f�

n)t
jtj||
t|�
j�f�

tS|dkr�t
j	tj
|
t|�
j�t|�
j�f�

n8t
j	tj||
t|�
j�t|�
j�f�

tSdS(
N(
RWR1RbR�tSTR_VERIFY_PROFILE_VALUE_OKR;R�t"STR_VERIFY_PROFILE_DEVICE_VALUE_OKR&R[tSTR_VERIFY_PROFILE_VALUE_FAILt$STR_VERIFY_PROFILE_DEVICE_VALUE_FAILR(RR,tsuccessR�R�Rk((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�*s

))

88
cCs�|d
dk	r*|d
t
||t
|�S|j||d|�
}|j||�}|dkrddS|d||t
�}|j|d||||�S(NR�R�RTR,(RWR&R�R�R�(RRER�RkR�R�R�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�9s







cCs�|d
dk	r'|d
t
|t
|�S|j|�
}|j||�}|dkrXdS|d|t
�}|j|d|||�S(NR�RTR,(RWR&R�R�R�(RRER�R�R�R�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�Cs







cCs�x�tgt
|jj��
D]}|d
s|^q�
D]K}|
jj|dd�dk	sq|d|jkr9|j|
|�
q9q9WdS(NR�R,(	treversedRMR�RNR3R�RWRt_cleanup_non_device_command(RRER�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�Ms
?
2
cCs�x�tgt
|jj��
D]}|d
r|^q�
D]_}|
jj|dd�dk	sq|d|jkr9x$|D]}|j|
||�
qxWq9q9WdS(NR�R,(	R�RMR�RNR3R�RWRt_cleanup_device_command(RRERXR�Rk((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�Rs
?
2


cCs|d
dk	r-|d
t
d|t
t
�
nN|j|
||�}|dk	rh|d||dt
�

n|j|
||�
dS(NR�RTR�(RWRR�R�(RRER�Rkt	old_value((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�Xs




cCss|d
dk	r*|d
t
dt
t
�
nE|j|
|�}|dk	r_|d|dt
�


n|j|
|�
dS(NR�RTR�(RWRR�R�(RRER�R�((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyR�as




N(CRR*t__doc__R"R$R'tpropertyR,tclassmethodR-R/RR6R>RFRIRLR#RHRKRQR%RYR_RgRPRlRnRoRR�R�R�R�R�R�R�R�R�R�R�RR�R�RWR�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�(((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyRs|					
															#												
									!	
	
				(R�ttuned.constsR�ttuned.profiles.variablesttunedt
tuned.logsR
ttuned.utils.commandsRRyt
subprocessR
RtlogsR�R1tobjectR(((s6/usr/lib/python2.7/site-packages/tuned/plugins/base.pyt<module>
s