ALARM_ICOUNT
[ALARM]


Classes

class  INSTLIB::ALARM_ICOUNT

Functions

INT64 INSTLIB::ALARM_ICOUNT::Count (UINT32 tid=0) const
VOID INSTLIB::ALARM_ICOUNT::SetAlarm (INT64 count, ALARM_HANDLER handler, VOID *val, UINT32 tid=0, BOOL rearm=FALSE, BOOL always_armed=FALSE)
VOID INSTLIB::ALARM_ICOUNT::Activate ()
VOID INSTLIB::ALARM_ICOUNT::DeActivate ()
BOOL INSTLIB::ALARM_ICOUNT::Active () const

Detailed Description

Signal an alarm when the specified number of instructions has been executed

The example below can be found in InstLibExamples/alarm_icount.cpp

 
Function Documentation





  

    
      

        

          VOID INSTLIB::ALARM_ICOUNT::Activate           
          ( 
                    
           ) 
           [inline, inherited]
        

      

    		
  





  

    
       
    
    



This function initializes an alarm and must be called before PIN_StartProgram. It does turn the alarm on. Use SetAlarm.     

  







  

    
      

        

          BOOL INSTLIB::ALARM_ICOUNT::Active           
          ( 
                    
           ) 
           const [inline, inherited]
        

      

    		
  





  

    
       
    
    



Is this ALARM_ICOUNT active?     

  







  

    
      

        

          INT64 INSTLIB::ALARM_ICOUNT::Count           
          ( 
          UINT32 
           tid = 0          
           ) 
           const [inline, inherited]
        

      

    		
  





  

    
       
    
    




Returns:
Remaining count for this alarm 

    		
  







  

    
      

        

          VOID INSTLIB::ALARM_ICOUNT::DeActivate           
          ( 
                    
           ) 
           [inline, inherited]
        

      

    		
  





  

    
       
    
    



De-activate the counter, should call PIN_RemoveInstrumentation() after de-activating     

  







  

    
      

        

          VOID INSTLIB::ALARM_ICOUNT::SetAlarm           
          ( 
          INT64 
           count, 
        

        

          
          
          ALARM_HANDLER 
           handler, 
        

        

          
          
          VOID * 
           val, 
        

        

          
          
          UINT32 
           tid = 0, 
        

        

          
          
          BOOL 
           rearm = FALSE, 
        

        

          
          
          BOOL 
           always_armed = FALSE
        

        

          
          ) 
           [inline, inherited]
        

      

    		
  





  

    
       
    
    



Turn on an alarm. You should call Activate for this alarm before PIN_StartProgram 
Parameters:

  

    
count Number of times to execution address before alarm fires 

    
handler Call this function when alarm fires 

    
val Pass this value to the handler when the alarm fires 

  



    		
  




Generated on Tue Jan 16 00:09:08 2007 for Pin by 

doxygen 1.4.6