Abstract:
A remote debugging technique provides anonymity of program variables and selective debugging capability by providing a registration facility by which program variables are registered locally with a debugging module. An external program then communicates with the debugging modules and observes and/or modifies the program variables by specifying either an index or a variable name. The need to publish symbols is thereby averted and only the variables that a developer is interested in observing need be registered.

Description:
This U.S. patent application is a Continuation of U.S. patent application Ser. No. 13/957,528 filed on Aug. 2, 2013, and published as U.S. Patent Publication No. U.S. 20130318502 on Nov. 28, 2013, which is a Continuation of U.S. patent application Ser. No. 12/908,100 filed on Oct. 20, 2010, and issued as U.S. Pat. No. 8,589,887 on Nov. 19, 2013, and claims priority thereto under 35 U.S.C. §120. This U.S. patent application claims priority under 35 U.S.C. §120 to the above-referenced U.S. patent applications, the disclosures of which are incorporated herein by reference. 
    
    
     BACKGROUND OF THE INVENTION 
     1. Field of the Invention 
     The present invention is related to program debuggers, and more specifically to a program debugger that provides remote watch and modify features by providing a registration facility. 
     2. Description of Related Art 
     Debuggers are used in both development and field environments to determine if program code is operating properly, and to investigate faults that cause improper program behavior that is apparent, such as non-terminating behavior. Debuggers generally provide views of the various aspects of internal program function and structure, such as traces of program execution path and views of program variables, in addition to hardware observation capabilities such as register and memory value snooping. 
     In order to provide the capabilities pointed out above, development systems typically provide the program developer with the capability of generating a debugging version of program code, which contains information allowing a debugging program to determine symbolic links to the program code and data storage areas. The symbol information may be embedded in the debug version of the program, or may be stored in one or more external files. A non-debug version of the program code is typically devoid of symbolic information. 
     BRIEF SUMMARY OF THE INVENTION 
     The invention is embodied in a method, computer system and computer program product that provide for observing data values within storage locations of a computer program during execution of the computer program within the computer system. The method is a method of operation of the computer system and the computer program product is a set of program instructions embodied in tangible form in computer readable storage media such as optical, magnetic or electrical removable or non-removable memory. 
     The computer program registers individual storage locations that store the data values with a debugging module located in the same address space as the computer program. The debugging module receives requests from an external program that specify data values corresponding to storage locations that have been registered by the registering. In response to the requests, the debugging module retrieves or modifies the particular data values and for read requests, sends the particular data values from the debugging module to the external program, where the data values are displayed. 
     The foregoing and other objectives, features, and advantages of the invention will be apparent from the following, more particular, description of the preferred embodiment of the invention, as illustrated in the accompanying drawings. 
    
    
     
       BRIEF DESCRIPTION OF THE SEVERAL VIEWS OF THE DRAWING 
       The novel features believed characteristic of the invention are set forth in the appended claims. The invention itself, however, as well as a preferred mode of use, further objectives, and advantages thereof, will best be understood by reference to the following detailed description of the invention when read in conjunction with the accompanying Figures, wherein like reference numerals indicate like components, and: 
         FIG. 1  is a block diagram illustrating a processing system in which program code according to an embodiment of the present invention is generated and executed. 
         FIG. 2  is a memory diagram illustrating program code and data organization in accordance with an embodiment of the present invention. 
         FIG. 3  is a flow chart depicting a method in accordance with an embodiment of the present invention. 
         FIG. 4  is a flow chart depicting a method in accordance with another embodiment of the present invention. 
     
    
    
     DETAILED DESCRIPTION OF THE INVENTION 
     The present invention relates to methods and programs that provide remote debugging capability by permitting an external debugging program to view and/or modify program variables (i.e., data values stored in program storage locations). The viewable/modifiable program variables are restricted to variables that have been registered with a debugging module located in the same memory space as the computer program. The debugging module can be selectively linked with the program, so that non-debug versions of the program do not contain the debugging module and the calls to register the program variables can either be stubbed or conditioned on a debugging constant so that the non-debug version can be generated from the same program code as the debug version. Permissions are supported by the debug module, so that the program may register some program variables as read-only and others as read-write (read-modify). Since no breakpoints are required to observe or modify the program variables, the debugging scheme is suitable for debugging real-time systems such as control systems. Also, by providing/altering the program values from within the program space using a debugging module, no overhead is present unless the debug module is actually retrieving or modifying a program variable, which also makes the debugging scheme useful in debugging real-time systems. Further, by registering only key variables, both security and compactness are achieved, since only those variables the programmer wishes to expose are exposed. The compactness of the scheme is suitable for embedded systems, in which the large amount of memory required for complete symbol tables may exceed the resources available. 
     Referring now to  FIG. 1 , a computer system in which techniques in accordance with an embodiment of the present invention are practiced, is shown. The depicted computer system includes a workstation computer system  10  coupled to a debugger platform  10 A. The depicted computer system configuration is illustrative, and processing systems in accordance with other embodiments of the present invention include special purpose computer systems in place of workstation  10 , and/or other systems in which the debugger is executed by the same computer system. A processor  11  is coupled to a memory  12 , which contains program instructions implementing a computer program executed by processor  11  that, in at least a debug version, includes debug functionality in accordance with an embodiment of the present invention as described in detail below. Debugger platform  10 A includes a processor  11 A that is coupled to a memory  12 A for storing data and program code implementing a debugger that communicates with one or more debug modules in the computer program executed by workstation computer system  10 . Processor  11  in workstation computer  10  is also coupled to a storage interface  13 , which couples processor  11  and memory  12  to storage devices such as hard disc drive  15  and an optical drive  14 . Embodiments of the invention include computer program products that contain the debug module of the present invention stored in memory  12  as well as stored on tangible media such as a CD-ROM  16  that may be inserted into optical drive  14  to transfer computer program and other programs memory  12  for execution by processor  11 . Similarly, debugger platform  10 A includes hard disk drives  15  and optical drives  14  for accepting media such as optical storage  16 A containing the debugger program and other data and/or program code. The illustrated workstation computer system also includes input/output (I/O) interfaces and devices  19  such as mice and keyboards for receiving user input and graphical displays for displaying information, such as user interfaces constituting output of the computer program being debugged. Further, debugger platform  10 A also includes input/output (I/O) interfaces and devices  19 A such as mice and keyboards for receiving user input and graphical displays for displaying information, such as user interfaces of the debugger, that in particular, displays values of program variables of a program executing within workstation computer  10 . 
     Workstation computer system  10  is coupled to debugger platform  10 A by an interface  18  that couples to interface  18 A, through a wired, optical or wireless connection that may be proprietary, or take the form of a standardized serial or parallel bus such as an Ethernet connection. Debugger platform  10 A sends commands to workstation computer system  10 . The commands include commands to examine program variables of a program executing within workstation computer system  10  and commands to modify those program variables, among other commands. While the system illustrated in  FIG. 1  is a remote computer debugging arrangement, it is understood that in accordance with other embodiments of the present invention, the debugger may be executed within workstation computer system  10 . Further, in other architectures such as in a distributed processing system, portions of the target program, i.e., the computer program being debugged, and the debugger program that communicates with the target program may be executed by multiple processors within the distributed processing system and may be partially executed by the same processor and partially executed by different processors. Therefore, the terms remote and local as used herein are referring generally to the local program, local tables of variables and local debug module in the sense that they are associated with and locate generally in the same memory space as the computer program, while the remote tables and remote debugger are generally located in at least a different memory space, if not in a separate computer system. 
     Referring now to  FIG. 2 , an arrangement of program code and data within memory  12  of workstation computer system  10  and program code and data within memory  12 A of debugger platform  10 A is shown in accordance with an embodiment of the present invention. The computer program  20  is located in memory  12  is executed by workstation computer system  10 , and includes program variables  22 , which in the sense of the present invention may include constants and other data space such as allocated memory blocks referred to by pointers or other reference. Debugger  28  is executed by debug platform  10 A and communicates with a debug module  24  associated with computer program  20 . In the depicted embodiment, debug module  24  is linked with computer program  20  and forms part of the loadable image of computer program  20 . However, in other embodiments of the present invention, debug module  24  may be a dynamic library or other operating facility that is not part of the loadable image of computer program  20 . 
     In order to make a program variable accessible to debugger  28  executable code within computer program  20  calls an application programming interface (API) of debug module  24  that registers program variables for debugging purposes. Therefore, computer program  20  has complete control over which variables are exposed to debugger  28 . The API used to register program variables of computer program  20  is illustrated as register( ), which may be of the form:
         register(variable_name, variable_reference, size_type, flags),
 
where variable_name is the name of the program variable, variable_reference is the storage location of the program variable, the size_type field is an indication of the size and/or type of the program variable, and flags are access and handling flags such as read permission, write permission and whether the program variable is being registered under its human-comprehensible name or whether a hash or index should be used instead. In general, embodiments of the present invention will either implement hashing/indexing of program variable names, or will use the variable names as references, but as illustrated above for generality, anonymity can be selected on an individual basis. If indexing is used, the anonymized variables will be maintained in a separate list by index, and the variable_name argument is not needed. The register( ) API call thus may alternatively be of the form:
   register(variable_reference, size_type, flags).
 
The variable_reference argument is needed in systems in which or variable for which a pointer or other reference must be passed for the debug module to be able to access the storage location containing the program variable. In other systems, such as interpretive languages or scripting languages, the reference is made entirely by the variable name. Therefore, in such systems, the variable_name argument and not the variable_reference argument would be supplied to the register( ) API:
   register(variable_name, size_type, flags).       

     A collection of all of the program variables registered by computer program  20  is maintained in a local table  26 , which may be contained within debug module  24 , within a data area of computer program  20  or may be in a separate location accessible by debug module  24 . An exemplary table suitable for use as local table is shown in Table I below, in which the first row is merely explanatory and not required. 
                                                   TABLE I               Variable Name   Storage Location   Size (or type)   Flags                                icount   00894400A0000100   8   +r, +w       user_data[0]   00894400A00001A0   1024   +r       profile   00894400A0000400   64   +r, +w                    
The first column contains the variable name, which is used to look up variables for which access is requested by debugger  28 , which are shown as request(read) and request(modify) requests in the illustration. Alternatively, as pointed out above, Table I can contain anonymized values for accessing the program variables, such as an index as illustrated in Table II below:
 
                                 TABLE II                   0   00894400A0000100   8   +r, +w       1   00894400A00001A0   1024   +r       2   00894400A0000400   64   +r, +w                    
or a hash value as illustrated in Table III below:
 
                                         TABLE III                           soenirto#472   00894400A0000100   8   +r, +w           to2es %{circumflex over ( )}&amp;12   00894400A00001A0   1024   +r           23st@352s1   00894400A0000400   64   +r, +w                        
For interpretive and scripting languages, as noted above, the storage location is not directly used by the debug module, and references are made by variable name. In such implementations local table  26  may be of the form shown in Table IV below:
 
     
       
         
               
               
               
               
             
               
               
               
               
             
           
               
                   
                 TABLE IV 
               
               
                   
                   
               
               
                   
                 Variable Name 
                 Size (or type) 
                 Flags 
               
               
                   
                   
               
             
             
               
                   
               
             
          
           
               
                   
                 icount 
                 8 
                 +r, +w 
               
               
                   
                 user_data[0] 
                 1024 
                 +r 
               
               
                   
                   
               
             
          
         
       
     
     Debugger  28  also has an associated table, remote table  26 A, that may match local table  26 , or may be different, in that the flags value is not needed, nor is the actual pointer to the storage location either needed to function, nor desirable to expose external to computer program  20 . In one embodiment, remote table  26 A is not needed, if the values in local table  26  are stored by index and it is desirable to display values only by index on the output display of debugger  28 . In general, remote table  26 A will contain human-readable names and optionally an index, hash or other identifier to be supplied with the read or modify requests sent to debug module  24  from debugger  28 . The received read or modify requests are then satisfied by debug module  24  using a look-up of a storage location based on the index/hash or variable name provided by debugger  28  from remote table  26 A, or for interpretive/scripting languages, by evaluating the value specified by the variable name provided by debugger  28  or a look-up of the variable name using an index, hash or other alias used in remote table  26 A to represent an entry in local table  26 . The information in remote table  26 A can be loaded from a computer-readable media, or transmitted to debugger  28  from local table  26  (or other data source) through interface  18 A that couples debugger  28  to workstation computer  10 , which may be performed when a connection is established between debugger  28  and debug module  24 , or at initialization of computer program  20 . In one embodiment of the invention, in addition to the register( ) API, debug module  24  can support an unregister( ) API, in which case, a transmission to update remote table  26 A may be required, unless it is desirable to merely fail requests to access program variables that are no longer registered. Further, while the exemplary embodiment above indicates that program variables would be registered generally at startup, and that in general, local table  26  would have a fixed set of entries, it is possible for computer program  20  to call the register API (and optionally the unregister API) on the fly to add or remove entries from local table  26 . If such techniques are employed, it would generally be desirable to synchronize remote table  26 A with local table  26  via update transmissions, and in particular if indexes are used and reassigned, such synchronization would be necessary. An example of such a use of on-the-fly program variable registration would be to only register variables in a region of program code that should not be entered under normal operating conditions. Such operation makes it possible to only expose selected program variables and only at certain times or when certain conditions, such as errors, have been encountered. 
     Debugger  28  retrieves and modifies values of program variables  22  within program  20  by transmitting read and modify commands to debug module  24 , which then performs the requested operations if permissions are proper. The read command may take the form &lt;cmd_read&gt;&lt;index&gt; or &lt;cmd_read&gt;&lt;variable_name&gt; where index and variable_name are the identifiers and cmd_read is a constant identifying the command as a read command. In response, debug module  24  returns a packet of data containing the contents of the storage location associated with the program variable that was requested, which may be formatted with a header providing identifying information associated with the command that was sent, in order to permit asynchronous and buffered transmissions of requests. To modify a program variable, debugger sends a modify command, which may take the form &lt;cmd_modify&gt;&lt;index&gt;&lt;data&gt;&lt;size&gt; or &lt;cmd_modify&gt;&lt;variable_name&gt;&lt;data&gt;&lt;size&gt;, where cmd_modify is a constant identifying the command as a modify command, where index and variable_name are the identifiers as above, data is the value to be written to the storage location associated with the program variable to be modified, and size is an optional value that provides a check as to whether the size of data matches the size of the variable to me modified. 
     Referring now to  FIG. 3 , a method for registering program variables with debug module  24  in accordance with an embodiment of the present invention is shown. When debug module  24  receives a request to register a program variable (step  30 ), if debug module  24  is not present (decision  32 ), then the request is not processed, which is accomplished by a stub or other technique as described above. If debug module  24  is present (decision  32 ) if anonymizing is selected (decision  34 ), an index, hash or other anonymous identifier is generated and associated with the program variable (step  38 ), and the storage location of the program variable, the identifier, the program variable size and permission flags are added to local table  26  (step  39 ). Otherwise, if anonymizing is not selected (decision  34 ), the storage location of the program variable, the program variable name, the program variable size and permission flags are added to local table  26  (step  40 ). While the method illustrated in  FIG. 3  provides an example of how to register program variables in accordance with an embodiment of the present invention, other techniques may be employed as well, in accordance with other embodiments of the present invention. 
     Referring now to  FIG. 4 , a method for reading and modifying variables from debugger  28 , in accordance with an embodiment of the present invention, is shown. When debugger  28  transmits a request to debug module  24  (step  40 ), if debug module  24  is not present (decision  41 ), then the request is not received (step  42 ) and no processing occurs. If the debug module  24  is present (decision  41 ), the request is received and the storage location is looked up in local table  26  from the variable name or identifier provided with the request (step  43 ). If the request is a modify request (decision  44 ), the permissions are checked to determine whether permission to modify the program variable was set (decision  45 ). If modify permission was not set, then the request is failed (step  46 ), which may require a response to debugger  28  in some environments so that debugger  28  does not reflect an incorrect value for the program variable due to a failed modify operation. If modify permission was set for the program variable (decision  45 ), the new value supplied with the request is written into the storage location (step  47 ). If the request is a read request (decision  44 ), the value of the storage location is read (step  48 ) and is transmitted to debugger  28  (step  49 ). While the method illustrated in  FIG. 4  provides an example of how to read and modify program variables in accordance with an embodiment of the present invention, other techniques may be employed as well, in accordance with other embodiments of the present invention. 
     As noted above, all or portions of the present invention may be embodied in a computer program product, which may include firmware, an image in system memory or another memory/cache, or stored on a fixed or re-writable media such as an optical disc having computer-readable code stored thereon. Any combination of one or more computer readable medium(s) may store the program in accordance with an embodiment of the invention. The computer readable medium may be a computer readable signal medium or a computer readable storage medium. A computer readable storage medium may be, for example, but not limited to, an electronic, magnetic, optical, electromagnetic, infrared, or semiconductor system, apparatus, or device, or any suitable combination of the foregoing. More specific examples (a non-exhaustive list) of the computer readable storage medium would include the following: an electrical connection having one or more wires, a portable computer diskette, a hard disk, a random access memory (RAM), a read-only memory (ROM), an erasable programmable read-only memory (EPROM or Flash memory), an optical fiber, a portable compact disc read-only memory (CD-ROM), an optical storage device, a magnetic storage device, or any suitable combination of the foregoing. 
     In the context of the present application, a computer readable storage medium may be any tangible medium that can contain, or store a program for use by or in connection with an instruction execution system, apparatus, or device. A computer readable signal medium may include a propagated data signal with computer readable program code embodied therein, for example, in baseband or as part of a carrier wave. Such a propagated signal may take any of a variety of forms, including, but not limited to, electro-magnetic, optical, or any suitable combination thereof. A computer readable signal medium may be any computer readable medium that is not a computer readable storage medium and that can communicate, propagate, or transport a program for use by or in connection with an instruction execution system, apparatus, or device. Program code embodied on a computer readable medium may be transmitted using any appropriate medium, including but not limited to wireless, wireline, optical fiber cable, RF, etc., or any suitable combination of the foregoing. 
     While the invention has been particularly shown and described with reference to the preferred embodiments thereof, it will be understood by those skilled in the art that the foregoing and other changes in form, and details may be made therein without departing from the spirit and scope of the invention.