function oinfo = info(id,opt)
%INFO return information about the state of the MULTI(R) debugger.
% IID = INFO(id) returns information about the state of MULTI(R) debugger.
% The resulting information is returned as a structure IID. The following
% list describes the elements of IID:
% IID.CurBrkPt - If the debugger is stopped at break point, this field
% gives the index of the break point. Else, it is -1.
% IID.File - The current file shown in the source pane of the debugger.
% IID.Line - The current line of the cursor in the source pane of the
% IID.MultiDir - The MULTI root directory.
% IID.PID - The process id reported by the debug server in MULTI.
% IID.Procedure- The current procedure shown in the source pane of the
% IID.Process - The MULTI-defined program number of the current program.
% IID.Remote - The status of the target connection: 'Not connected' or
% IID.Selection- The string highlighted in MULTI debugger.'(null)' if none
% is selected in the debugger.
% IID.State - The current process state. It is one of: 'No child',
% 'Stopped', 'Running', 'Dying', Just Forked', 'Just
% exec''ed', 'About to resume' or 'Zombied.' For more
% information about the states, refer to MULTI debugger
% IID.Target - A unique identifier indicating the processor family and
% IID.TargetOS - A [2x1 double] giving major and minor revisions of the
% RTOS, if one is available.
% IID.TargetSeries- Indicates if the processor belongs to a series of
% processors. For more information, refer to MULTI debugger
% Note: INFO is valid only when a program is open in MULTI debugger.
% See also GHSMULTI/DISP, GHSMULTI/OPEN, GHSMULTI/LOAD, GHSMULTI/CONNECT.
% Copyright 2012 The MathWorks, Inc.