Run-time instrumentation directed sampling

• US 9,367,313 B2
• Filed: 03/05/2013
• Issued: 06/14/2016
• Est. Priority Date: 03/16/2012
• Status: Active Grant

• Current Assignee: International Business Machines Corporation
• Original Assignee: International Business Machines Corporation
• Inventors: Stoodley, Kevin, Gainey, Charles W. Jr., Mitran, Marcel, Shum, Chung-Lung K.
• Primary Examiner(s): Coleman, Eric
• Application Number:
  US13/784,861
• Publication Number:
  US 20130246746A1
• Time in Patent Office: 1,197 Days
• US Class Current: 1/1
• CPC Class Codes: G06F 11/3466 Performance evaluation by tracing or monitoring
• CPC Class Codes: G06F 11/3636 by tracing the execution of the program
• CPC Class Codes: G06F 11/3644 by instrumenting at runtime
• CPC Class Codes: G06F 11/3648 using additional hardware
• CPC Class Codes: G06F 9/3005 to perform operations for flow control

Abstract

The invention relates to implementing run-time instrumentation directed sampling. An aspect of the invention includes a method for implementing run-time instrumentation directed sampling. The method includes fetching a run-time instrumentation next (RINEXT) instruction from an instruction stream. The instruction stream includes the RINEXT instruction followed by a next sequential instruction (NSI) in program order. The method further includes executing the RINEXT instruction by a processor. The executing includes determining whether a current run-time instrumentation state enables setting a sample point for reporting run-time instrumentation information during program execution. Based on the current run-time instrumentation state enabling setting the sample point, the NSI is a sample instruction for causing a run-time instrumentation event. Based on executing the NSI sample instruction, the run-time instrumentation event causes recording of run-time instrumentation information into a run-time instrumentation program buffer as a reporting group.

Claims

1. A computer implemented method for implementing run-time instrumentation directed sampling, the method comprising:

fetching a run-time instrumentation next (RINEXT) instruction from an instruction stream, the instruction stream comprising the RINEXT instruction followed by a next sequential instruction (NSI) in program order; and

executing the RINEXT instruction by a processor, the executing comprising;

determining whether a current run-time instrumentation state enables setting a sample point on a sample instruction for reporting run-time instrumentation information during program execution;

based on the current run-time instrumentation state enabling setting the sample point, interpreting the next sequential instruction as an NSI sample instruction for causing a run-time instrumentation event as a trigger to record the run-time instrumentation information comprising data that led up to the NSI sample instruction into a run-time instrumentation program buffer; and

based on executing the NSI sample instruction, causing the run-time instrumentation event to record the run-time instrumentation information into the run-time instrumentation program buffer as a reporting group.

2. The method of claim 1, further comprising:

based on the current run-time instrumentation state not enabling setting the sample point, treating the RINEXT instruction as a no-operation instruction.

3. The method of claim 1, further comprising:

setting a sampling mode to one of a cycle-count mode and an instruction-count mode while the current run-time instrumentation state is enabled to set the sample point based on executing the NSI; and

determining that an instruction in the instruction stream is the sample instruction based on both the NSI and the sampling mode recognizing the instruction as the sample instruction, wherein only a single reporting group is stored into the run-time instrumentation program buffer when both the NSI and the sampling mode recognized the instruction as the sample instruction.

4. The method of claim 1, further comprising:

configuring a run-time-instrumentation control responsive to a load run-time instrumentation controls (LRIC) instruction, the LRIC instruction establishing a sampling mode and an RINEXT control.

5. The method of claim 4, wherein the LRIC instruction further establishes a run-time-instrumentation program buffer current address to store a record of information collected at the sample point, a run-time-instrumentation program-buffer origin address, a run-time-instrumentation program-buffer limit address, a problem-state sample reporting control, a supervisor-state sample reporting control, a scale factor, and a remaining sample-interval count.

6. The method of claim 1, wherein the current run-time instrumentation state is not enabled based on any one of:

run-time instrumentation being not enabled;

in a problem state and problem-state reporting being not permitted;

in a supervisor state and supervisor-state reporting being not permitted;

execution of the RINEXT instruction is not permitted based on a setting of a run-time-instrumentation control; and

the RINEXT instruction has been issued in too close a proximity to a prior RINEXT instruction according to a model-dependent limit.

7. The method of claim 1, wherein the processor is an emulated processor, of an instruction set architecture being emulated on a host processor of another instruction set architecture, and the executing of the RINEXT instruction is performed by one or more emulation software routines configured to emulate execution of the RINEXT instruction.