| Current File : //usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyc |
�
.�t_c @ s� d Z d d l Td d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d e f d � � YZ d e f d � � YZ
d
e f d � � YZ d S( s�
StatStruct -- classes for sampling statistics from a VDO via ioctls
$Id: //eng/vdo-releases/magnesium/src/python/vdo/statistics/StatStruct.py#2 $
i����( t *N( t Field( t LabeledValuet Samplesc B s\ e Z d Z d � Z d � Z d � Z e e d � � Z e e d � � Z e d � � Z
RS( sD
An object which represents a collection of samples from a VDO.
c C sF | d | _ g | D]% } | j t j j | d � � ^ q | _ d S( s�
Create a new set of samples by sampling a VDO device.
:param assays: The types of samples to take
:param devices: The device to sample (a dictionary containing
the user-supplied name and the name to use for sampling)
:param mustBeVDO: If set to False, errors resulting from the device not
being a VDO will be suppressed
t usert sampleN( t deviceR t ost patht basenamet samples( t selft assaysR t mustBeVDOt assay( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt __init__' s
c C s | j S( s\
Get the name of the device which was sampled.
:return: The name of the device
( R ( R ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt getDevice5 s c C s | j S( sS
Get the list of samples for the device.
:return: The list of samples
( R
( R ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt
getSamples= s c C s� y t | | | � SWnf t k
r| } | d } | j d k ra | r] t d j | � � � n d St d j | | � � � n Xd S( s�
Assay a device.
:param assays: The types of samples to take
:param devices: The device to sample (a dictionary containing
the user-supplied name and the name to use for sampling)
:param mustBeVDO: If set to False, errors resulting from the device not
being a VDO will be suppressed
:return: The results of the assays or None if the device is not a VDO and
mustBeVDO is set to False
R i s Device {0} is not a VDOs Error sampling device {0}: {1}N( R t IOErrort errnot Exceptiont formatt None( R R R
t ioeR ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR E s
c C s/ t d g | D] } t j | | | � ^ q
� S( s�
Assay a list of devices.
:param assays: The types of samples to take
:param devices: The devices to sample (a list of dictionaries containing
the user-supplied name and the name to use for sampling)
:param mustBeVDO: If set to False, errors resulting from the device not
being a VDO will be suppressed
:return: The results of the assays or None if the device is not a VDO and
mustBeVDO is set to False
N( t filterR R R ( R t devicesR
R ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt assayDevices] s c C s i | d 6| d 6S( s�
Returns a dictionary used for sampling purposes.
The dictionary is structured as:
{ "user" : <user-specified name>,
"sample" : <sample name> }
The user-specified name is used for display purposes.
The sample name is used to perform the actual sampling.
The two names may be identical.
:param user: user-specified name
:param sample: the name to use for sampling
:return: A sampling dictionary.
R R ( ( R R ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt samplingDevicen s ( t __name__t
__module__t __doc__R R R t staticmethodt TrueR R R ( ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR # s t Samplec B s; e Z d Z d � Z d � Z d � Z d � Z d � Z RS( sB
An object which represents a single sample (ioctl) of a VDO.
c C s | | _ | | _ d S( s�
Create a new sample.
:param statStruct: The structure representing the type of this sample
:param sample: The sampled values
N( t
statStructR ( R R" R ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR � s c C s | j S( s�
Get the object representing the type of this sample.
:return: The StatStruct which represents the type of this sample
( R" ( R ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt getType� s c C s | j j | j � S( s
Get the sampled values as a collection of LabeledValues.
:return: A LabeledValue representing the sampled values
( R" t labeledR ( R ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR$ � s c C sN t | t � s | j | S| j } x | d D] } | | } q. W| | d S( s
Get the value of a named statistic.
:param statName: The name of the statistic, either as a string, or as
a list of strings, one for each level of the sample
hierarchy
:return: The value of the named statistic
i����( t
isinstancet listR ( R t statNamet statst name( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt getStat� s
c C s | j | � | j | � k S( sd
Check whether the value of a given statistic is the same in this sample
and some other sample.
:param other: The other sample
:param statName: The name of the statistic as would be specified to
getStat()
:return: True if the value of the named statistic is the same in this and
the other sample
( R* ( R t otherR' ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt statEqual� s ( R R R R R# R$ R* R, ( ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR! � s
t
StatStructc B sV e Z d Z i Z d � Z d � Z d � Z d � Z d � Z d � Z d d � Z
RS( s�
Base class for objects representing a VDO statistics structure. This object
can be used to sample a VDO via an ioctl and convert the result from the
C format in the ioctl to a Sample object.
c K s� | j d d � } | d k r( | d n d | _ | j d d � | _ | j d d � | _ | j d d � | _ | | _ t t | � j | | j
� | � t � | _ x | D] } | | j | j
<q� Wd S( s�
Create a new statistics structure.
:param name: The name of statistics structure
:param fields: A list of Field objects specifying the format of the C
structure returned by the ioctl
:param **kwargs: Keyword args which may be:
labelPrefix: The prefix to prepend to the label for
each field in this structure
ioctl: The value of the ioctl to use for sampling
a VDO
Field: Any of the keyword arguments for the Field
base class
t labelPrefixt t t ioctlt procFilet procRootN( t popR R. R1 R2 R3 t fieldst superR- R t
_getCClasst dictt fieldsByNameR) ( R R) R5 t kwargsR. t field( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR � s "
c C s� t | � j d } | j j | � } | s� g | j D]! } | j r5 | j | j f ^ q5 } t | t f i | d 6� } | | j | <n | S( s�
Get the Structure class which represents the C struct for a StatStruct
or Field. If the Structure class hasn't yet been made for the given type,
it will be created.
:return: The class defined by the specified set of Fields
s .ct _fields_( t typeR t cClassest getR5 t inStructR) t cTypet Structure( R t classNameRA R; t fieldList( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR7 � s ! c C s_ | j � } t j j d | j | | j � } t | d � � } | j | � Wd QX| j | � S( s�
Get a sample from a VDO via an ioctl.
:param name: The name of the proc directory from which to read
:return: The sample
s /proct rbN( RA R R t joinR3 R2 t opent readintot _extract( R R) R( t procPatht fd( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR � s
!c C sC t � } x* | j D] } | j | | � | | j <q Wt | | � S( s�
Extract the sampled values from the return of an ioctl call.
:param stats: The structure returned from an ioctl
:return: The sample as a Sample
( R8 R5 t
extractSampleR) R! ( R R( R R; ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyRI s c C s� t | | j | � } | j d k rS | | k rS g | D] } | j | | � ^ q7 St � } x* | j D] } | j | | � | | j <qf W| S( s
:inherit:
i ( t getattrR) t lengthRL R8 R5 ( R R( t parentt myStatst sR R; ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyRL s # c C s | j | j | | � S( s
Get the value of one of the fields at the current level of the C structure
from the ioctl.
:param stats: The current level of the C structure
:param fieldName: The name of the field to get
:return: The value of the specified field
( R9 RL ( R R( t fieldName( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt getSampleValue$ s
R0 c C s� | | j 7} | | j } t | t � rQ g | D] } | j | | � ^ q0 } n8 g | j D]( } | j r[ | j | | j | � ^ q[ } t j | | � S( s
:inherit:
(
R. t labelR% R& R$ R5 t displayR) R t make( R R t prefixRT RQ t
labeledFieldsR; ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR$ 0 s
(5( R R R R> R R7 R RI RL RS R$ ( ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyR- � s
( R t ctypest collectionst fcntlR t sysR R t objectR R! R- ( ( ( s= /usr/lib/python2.7/site-packages/vdo/statistics/StatStruct.pyt <module> s
_>