Debugger - Stage 3 (artf511247)

[deliverable/titan.core.git] / core / DebugCommands.hh

/******************************************************************************
 * Copyright (c) 2000-2016 Ericsson Telecom AB
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *   
 *   Baranyi, Botond – initial implementation
 *
 ******************************************************************************/

#ifndef DEBUGCOMMANDS_HH
#define DEBUGCOMMANDS_HH

/** list of commands coming from the user interface to the debugger (parameters listed in comments) */

// settings
#define D_SWITCH                   1 // 1, "on" or "off"
#define D_SET_BREAKPOINT           2 // 2-3, module name and line number + optional batch file name
#define D_REMOVE_BREAKPOINT        3 // 1-2, 'all', or module name + 'all' or line number
#define D_SET_AUTOMATIC_BREAKPOINT 4 // 2-3, "error" or "fail", + "off", or "on" + optional batch file name
#define D_SET_OUTPUT               5 // 1-2, "console", or "file" or "both", + file name
#define D_SET_GLOBAL_BATCH_FILE    6 // 1-2, "off", or "on" + batch file name
// printing and overwriting data
#define D_SET_COMPONENT            7 // 1, "mtc" or component reference
#define D_PRINT_CALL_STACK         8 // 0
#define D_SET_STACK_LEVEL          9 // 1, stack level
#define D_LIST_VARIABLES          10 // 1-2, "local", "global", "comp" or "all", + optional filter (pattern)
#define D_PRINT_VARIABLE          11 // 1+, list of variable names
#define D_OVERWRITE_VARIABLE      12 // 2, variable name, new value (in module parameter syntax)
#define D_PRINT_SNAPSHOTS         13 // 0
#define D_SET_SNAPSHOT_BEHAVIOR   14 // TBD
// stepping
#define D_STEP_OVER               15 // 0
#define D_STEP_INTO               16 // 0
#define D_STEP_OUT                17 // 0
#define D_RUN_TO_CURSOR           18 // 2, module name and line number
// the halted state
#define D_HALT                    19 // 0
#define D_CONTINUE                20 // 0
#define D_EXIT                    21 // 1, "test" or "all"
// initialization
#define D_SETUP                   22 // 9+:
                                     // 1 argument for D_SWITCH,
                                     // 2 arguments for D_SET_OUTPUT,
                                     // 2 arguments (2nd and 3rd) for D_SET_AUTOMATIC_BREAKPOINT, where the first argument is "error",
                                     // 2 arguments (2nd and 3rd) for D_SET_AUTOMATIC_BREAKPOINT, where the first argument is "fail",
                                     // 2 arguments for D_SET_GLOBAL_BATCH_FILE,
                                     // + arguments for any number of D_SET_BREAKPOINT commands (optional)

#define D_ERROR                    0 // any

/** names of commands in the user interface */

#define D_SWITCH_TEXT "debug"
#define D_SET_BREAKPOINT_TEXT "dsetbp"
#define D_REMOVE_BREAKPOINT_TEXT "drembp"
#define D_SET_AUTOMATIC_BREAKPOINT_TEXT "dautobp"
#define D_SET_OUTPUT_TEXT "doutput"
#define D_SET_GLOBAL_BATCH_FILE_TEXT "dglobbatch"
#define D_SET_COMPONENT_TEXT "dcomp"
#define D_PRINT_CALL_STACK_TEXT "dprintstack"
#define D_SET_STACK_LEVEL_TEXT "dstacklevel"
#define D_LIST_VARIABLES_TEXT "dlistvar"
#define D_PRINT_VARIABLE_TEXT "dprintvar"
#define D_OVERWRITE_VARIABLE_TEXT "dsetvar"
#define D_PRINT_SNAPSHOTS_TEXT "dprintss"
#define D_SET_SNAPSHOT_BEHAVIOR_TEXT "dsscfg"
#define D_STEP_OVER_TEXT "dstepover"
#define D_STEP_INTO_TEXT "dstepinto"
#define D_STEP_OUT_TEXT "dstepout"
#define D_RUN_TO_CURSOR_TEXT "drunto"
#define D_HALT_TEXT "dhalt"
#define D_CONTINUE_TEXT "dcont"
#define D_EXIT_TEXT "dexit"

/** debugger return value types */

#define DRET_NOTIFICATION   0
#define DRET_SETTING_CHANGE 1
#define DRET_DATA           2
#define DRET_EXIT_ALL       3

#endif /* DEBUGCOMMANDS_HH */