Controlling operation of a run-time instrumentation facility from a lesser-privileged state

Patent metadata

Field	Value
Publication number	US-9280448-B2
Application number	US-201313792268-A
Country	US
Kind code	B2
Filing date	Mar 11, 2013
Priority date	Mar 16, 2012
Publication date	Mar 8, 2016
Grant date	Mar 8, 2016

Abstract

Aspects relate to enabling and disabling execution of a run-time instrumentation facility. An instruction for execution by the processor in a lesser privileged state is fetched by the processor. It is determined, by the processor, that the run-time instrumentation facility permits execution of the instruction in the lesser-privileged state and that controls associated with the run-time instrumentation facility are valid. The run-time instrumentation facility is disabled based on the instruction being a run-time instrumentation facility off (RIOFF) instruction. The disabling includes updating a bit in a program status word (PSW) of the processor to indicate that run-time instrumentation data should not be captured by the processor. The run-time instrumentation facility is enabled based on the instruction being a run-time instrumentation facility on (RION) instruction. The enabling includes updating the bit in the PSW to indicate that run-time instrumentation data should be captured by the processor.

First claim

What is claimed is:

1. A method for enabling and disabling execution of a run-time instrumentation facility on a processor, the method comprising:
fetching, by a processor, an instruction of a currently executing thread in a multi-threaded environment for execution by the processor in a first state, the instruction one of a run-time instrumentation facility off (RIOFF) instruction and a run-time instrumentation facility on (RION) instruction;
based on determining, by the processor, that the run-time instrumentation facility permits execution of the instruction in the first state and that controls associated with the run-time instrumentation facility are valid, executing the instruction, the executing comprising any one of:
disabling the run-time instrumentation facility based on the instruction being the RIOFF instruction, the disabling including updating a run-time instrumentation facility state bit in a program status word (PSW) of the processor to indicate that run-time instrumentation data should not be captured by the processor; and
enabling the run-time instrumentation facility based on the instruction being the RION instruction, the enabling including updating the run-time instrumentation facility state bit in the PSW to indicate that run-time instrumentation data should be captured by the processor,

wherein the PSW is associated with the executing thread, and a state of the run-time instrumentation facility for the executing thread is maintained in the PSW across dispatches of the executing thread.

2. The method of claim 1 , further comprising:
fetching, by the processor, a run-time instrumentation control block (RICCB) that includes a problem state execution control bit previously set to a value by a program executing in a privileged state, wherein the determining that the run-time instrumentation facility permits execution of the instruction in the first state is based on the value of the problem state execution control bit, wherein the first state is different than the privilege state.

3. The method of claim 1 , further comprising:
fetching, by the processor, a run-time instrumentation control block (RICCB) that includes a validity bit previously set to a value by a program executing in a privileged state, wherein the determining that controls associated with the run-time instrumentation facility are valid is based on the value of the validity bit.

4. The method of claim 1 , further comprising, based on the enabling:
capturing, by the processor, the run-time instrumentation data based on an instruction stream of instructions of an application program executing on the processor, the capturing comprising storing the run-time instrumentation data in a collection buffer of the processor;
detecting, by the processor, a run-time instrumentation sample point trigger; and
copying contents of the collection buffer into a program buffer as a reporting group based on the detecting the run-time instrumentation sample point trigger, the program buffer located in main storage in an address space that is accessible by the application program.

5. The method of claim 4 , further comprising capturing, in the collection buffer, instruction addresses and metadata corresponding to events detected during the executing of the instruction stream.

6. The method of claim 4 , wherein the reporting group includes a predetermined number of one or more instrumentation records comprising contents of the collection buffer and system information records.

7. The method of claim 4 , wherein the copying includes copying the reporting group into the program buffer starting at a current address of the program buffer, the program buffer stored at a program buffer origin address specified by an instruction accessible control block that also specifies an address of a last byte in the program buffer and the current address in the program buffer.

8. The method of claim 1 , further comprising:
saving a remaining sample interval count (RSIC) field based on the disabling;
fetching, by the processor, a RION instruction; and
restoring the RSIC field.

Assignees

• IBM

Inventors

• Farrell Mark S
• Gainey Jr Charles W
• Mitran Marcel
• Shum Chung-Lung K
• Slegel Timothy J
• Smith Brian L
• Stoodley Kevin A

Classifications

• G06F9/30101

  Special purpose registers · CPC title

• G06F11/34 Primary

  Recording or statistical evaluation of computer activity, e.g. of down time, of input/output operation {; Recording or statistical evaluation of user activity, e.g. usability assessment} · CPC title

• G06F11/3644 Primary

  by instrumenting at runtime · CPC title

• G06F11/3648

  using additional hardware · CPC title

• G06F11/3636 Primary

  by tracing the execution of the program · CPC title