Store peripheral component interconnect (PCI) function controls instruction

• US 9,134,911 B2
• Filed: 12/11/2013
• Issued: 09/15/2015
• Est. Priority Date: 06/23/2010
• Status: Active Grant

• Current Assignee: International Business Machines Corporation
• Original Assignee: International Business Machines Corporation
• Inventors: Craddock, David, Farrell, Mark S., Glendening, Beth A., Gregg, Thomas A., Greiner, Dan F., Sittmann, Gustav E. III, Szwed, Peter K.
• Primary Examiner(s): Partridge, William B
• Application Number:
  US14/102,952
• Publication Number:
  US 20140101400A1
• Time in Patent Office: 643 Days
• Field of Search: None
• US Class Current: 1/1
• CPC Class Codes: G06F 21/6218 to a system of files or objects, e.g. local or distributed file system or database
• CPC Class Codes: G06F 21/71 to assure secure computing or processing of information
• CPC Class Codes: G06F 21/85 interconnection devices, e.g. bus-connected or in-line devices
• CPC Class Codes: G06F 2221/2101 Auditing as a secondary aspect
• CPC Class Codes: G06F 2221/2105 Dual mode as a secondary aspect
• CPC Class Codes: G06F 2221/2141 Access rights, e.g. capability lists, access control lists, access tables, access matrices
• CPC Class Codes: G06F 3/0619 in relation to data integrity, e.g. data losses, bit errors
• CPC Class Codes: G06F 3/065 Replication mechanisms
• CPC Class Codes: G06F 3/067 Distributed or networked storage systems, e.g. storage area networks [SAN], network attached storage [NAS]
• CPC Class Codes: G06F 9/30003 Arrangements for executing specific machine instructions
• CPC Class Codes: G06F 9/4411 Configuring for operating with peripheral devices; Loading of device drivers

Abstract

An instruction is provided that includes an opcode field to identify a store instruction to store in a designated location current values of operational parameters of an adapter function of an adapter; a first field to identify a location, the contents of which include a function handle identifying a handle of the adapter function for which the store instruction is being performed, and an indication of an address space associated with the adapter function identified by the function handle to which the store instruction applies; and a second field to identify the designated location of where a result of the store instruction is to be stored. Execution of the instruction includes obtaining information from a function information block associated with the adapter function; and copying the information from the function information block into the designated location, based on completion of one or more validity checks with one or more predefined results.

Claims

1. A computer program product for executing a machine instruction in a central processing unit, the computer program product comprising:

a non-transitory computer readable storage medium readable by a processing circuit and storing instructions for execution by the processing circuit for performing a method comprising;

obtaining a machine instruction for execution, the machine instruction being defined for computer execution according to a computer architecture, the machine instruction comprising;

an opcode field to identify a store instruction to store in a designated location current values of operational parameters of an adapter function of an adapter;

a first field to identify a location, the contents of which include a function handle identifying a handle of the adapter function for which the store instruction is being performed, and an indication of an address space associated with the adapter function identified by the function handle to which the store instruction applies; and

a second field to identify the designated location of where a result of the store instruction is to be stored; and

executing the machine instruction, the executing comprising;

obtaining information from a function information block associated with the adapter function, the function information block including information regarding the adapter function, the information comprising control information to be used to control access by the adapter function; and

copying the information from the function information block into the designated location, based on completion of one or more validity checks with one or more predefined results.

2. The computer program product of claim 1, wherein the contents further include status regarding the store instruction when the store instruction completes with a predefined code.

3. The computer program product of claim 1, wherein the control information to be used to control access by the adapter function comprises control information to be used by an input/output hub coupled to the adapter function to control access by the adapter function.

4. The computer program product of claim 1, wherein the one or more validity checks comprise at least one of:

a determination of whether the designated location is of a size to fit the information from the function information block, and a determination of whether the address space is valid.

5. The computer program product of claim 1, wherein the executing comprises:

using the function handle to locate a function table entry corresponding to the adapter function for which the store instruction is being performed; and

performing at least one validity check of the one or more validity checks using information from the function table entry.

6. The computer program product of claim 1, wherein the one or more validity checks include determining whether the adapter function is enabled, and based on the adapter function being enabled and other validity checks, if any, being successful, performing the copying.

7. The computer program product of claim 6, wherein the executing further comprises:

determining whether the function handle is enabled; and

based on the adapter function and the function handle being enabled, and other validity checks, if any, being successful, performing the copying.

8. The computer program product of claim 7, wherein based on the adapter function being enabled, the other validity checks, if any, being successful, and the function handle not being enabled, performing the copying and replacing the function handle with an enabled function handle.

9. The computer program product of claim 6, wherein the executing further comprises:

determining whether the function handle is enabled; and

based on the function handle and the adapter function not being enabled, storing a predefined value in the designated location.

10. The computer program product of claim 1, wherein the one or more validity checks comprise at least one of:

a determination of whether one or more input operands of the store instruction are aligned;

a determination of whether the designated location is of a size to fit the information from the function information block;

a determination of whether a function table entry corresponding to the adapter function is located;

a determination of whether the adapter function is busy;

a determination as to whether the address space is valid;

a determination as to whether recovery is active for the adapter function;

a determination as to whether recovery is active for the adapter function;

a determination as to whether there is a permanent error;

a determination as to whether the adapter function is enabled;

a determination as to whether the function handle is enabled; and

based on the store instruction being issued by a guest, a determination of whether the adapter function is configured to be used by the guest.

11. A computer system for executing a machine instruction in a central processing unit, the computer system comprising:

a memory; and

a processor in communications with the memory, wherein the computer system is configured to perform a method, said method comprising;

obtaining a machine instruction for execution, the machine instruction being defined for computer execution according to a computer architecture, the machine instruction comprising;

an opcode field to identify a store instruction to store in a designated location current values of operational parameters of an adapter function of an adapter;

a first field to identify a location, the contents of which include a function handle identifying a handle of the adapter function for which the store instruction is being performed, and an indication of an address space associated with the adapter function identified by the function handle to which the store instruction applies; and

a second field to identify the designated location of where a result of the store instruction is to be stored; and

executing the machine instruction, the executing comprising;

obtaining information from a function information block associated with the adapter function, the function information block including information regarding the adapter function, the information comprising control information to be used to control access by the adapter function; and

copying the information from the function information block into the designated location, based on completion of one or more validity checks with one or more predefined results.

12. The computer system of claim 11, wherein the contents further include status regarding the store instruction when the store instruction completes with a predefined code.

13. The computer system of claim 11, wherein the executing further comprises performing the one or more validity checks prior to copying the information, and wherein the one or more validity checks comprise at least one of:

a determination of whether the designated location is of a size to fit the information from the function information block, and a determination of whether the address space is valid.

14. The computer system of claim 11, wherein the executing comprises:

using the function handle to locate a function table entry corresponding to the adapter function for which the store instruction is being performed; and

performing at least one validity check of the one or more validity checks using information from the function table entry.

15. The computer system of claim 11, wherein the one or more validity checks include determining whether the adapter function is enabled, and based on the adapter function being enabled and other validity checks, if any, being successful, performing the copying.

16. The computer system of claim 15, wherein the executing further comprises:

determining whether the function handle is enabled;

based on the adapter function and the function handle being enabled, and other validity checks, if any, being successful, performing the copying;

based on the adapter function being enabled, the other validity checks, if any, being successful, and the function handle not being enabled, performing the copying and replacing the function handle with an enabled function handle; and

based on the function handle and the adapter function not being enabled, storing a predefined value in the designated location.

17. The computer system of claim 11, wherein the one or more validity checks comprise at least one of:

a determination of whether one or more input operands of the store instruction are aligned;

a determination of whether the designated location is of a size to fit the information from the function information block;

a determination of whether a function table entry corresponding to the adapter function is located;

a determination of whether the adapter function is busy;

a determination as to whether the address space is valid;

a determination as to whether recovery is active for the adapter function;

a determination as to whether recovery is active for the adapter function;

a determination as to whether there is a permanent error;

a determination as to whether the adapter function is enabled;

a determination as to whether the function handle is enabled; and

based on the store instruction being issued by a guest, a determination of whether the adapter function is configured to be used by the guest.

18. A method of executing a machine instruction in a central processing unit, the method comprising:

obtaining, by a processor, a machine instruction for execution, the machine instruction being defined for computer execution according to a computer architecture, the machine instruction comprising;

an opcode field to identify a store instruction to store in a designated location current values of operational parameters of an adapter function of an adapter;

a first field to identify a location, the contents of which include a function handle identifying a handle of the adapter function for which the store instruction is being performed, and an indication of an address space associated with the adapter function identified by the function handle to which the store instruction applies; and

a second field to identify the designated location of where a result of the store instruction is to be stored; and

executing the machine instruction, the executing comprising;

obtaining information from a function information block associated with the adapter function, the function information block including information regarding the adapter function, the information comprising control information to be used to control access by the adapter function; and

copying the information from the function information block into the designated location, based on completion of one or more validity checks with one or more predefined results.

19. The method of claim 18, wherein the contents further include status regarding the store instruction when the store instruction completes with a predefined code.

20. The method of claim 18, wherein the executing comprises:

using the function handle to locate a function table entry corresponding to the adapter function for which the store instruction is being performed; and

performing at least one validity check of the one or more validity checks using information from the function table entry.