LazDebuggerFp: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | > **Note:** For more information about the Free Pascal debugger see\ | |
| 2 | 2 | > \ | |
| 3 | 3 | > * [[Debugger Status]] for supported features | |
| 4 | 4 | > | |
| 5 | 5 | > - [[FpDebug]] for info on this debugger | |
| 6 | 6 | > | |
| 7 | 7 | > \ | |
| 8 | 8 | ||
| 9 | 9 | > **Tip:** **LazDebuggerFp** works best with **DWARF 3** | |
| 10 | 10 | ||
| 11 | 11 | - **LazDebuggerFp** is a [[Debugger|debugger]] integrated into the IDE based on [[FpDebug]]. | |
| 12 | 12 | - It many cases it is simply referred to as **FpDebug** (making that term ambiguous)... | |
| 13 | 13 | - **LazDebuggerFp** requires [[DWARF]] debug info to be enabled in the project options. | |
| 14 | 14 | ||
| 15 | 15 | ## Using LazDebuggerFp in the IDE | |
| 16 | 16 | ||
| 17 | 17 | The package is installed in the IDE by default. | |
| 18 | 18 | ||
| 19 | 19 | The debugger can be selected in Tools \> Options \> Debugger \> Debugger Backend | |
| 20 | 20 | ||
| 21 | 21 | ## Related topics | |
| 22 | 22 | ||
| 23 | 23 | - [[FpDebug-Watches-FunctionEval|Function evaluation in watches (Calling functions in the debugged app)]] | |
| 24 | 24 | - [[FpDebug-Watches-Intrinsic-Functions|Intrinsic (build in) helper functions]] | |
| 25 | 25 | ||
| 26 | 26 | ## Debugger specific options | |
| 27 | 27 | ||
| 28 | - | ||
| 28 | + | ```text | |
| 29 | + | Tools | Options | Debugger | Debugger Backend | FpDebug integrated Dwarf-debugger | |
| 30 | + | ``` | |
| 29 | 31 | ||
| 30 | 32 | ConsoleTty | |
| 31 | 33 | (Linux only) Redirect StdOut to an existing tty | |
| 32 | 34 | ||
| 33 | 35 | ForceNewConsole | |
| 34 | 36 | (Windows only) If the IDE has a console, debugging an app that also has a console will normally share the existing console. Setting this to "True" will open a new console for the debugged app. | |
| 35 | 37 | ||
| 36 | 38 | IntrinsicPrefix | |
| 37 | 39 | See [[FpDebug-Watches-Intrinsic-Functions|FpDebug-Watches-Intrinsic-Functions#Settings]] | |
| 38 | 40 | ||
| 39 | 41 | NextOnlyStopOnStartLine | |
| 40 | 42 | By default "Step out" will return to the caller, and pause execution in the middle of the line from which the call originally came. This allows to "Step in" again, if several calls are made on that line.\ | |
| 41 | 43 | For example; Foo(Func1(), Func2()); contains 3 calls, each of the 3 can be stepped in (if they have debug info) | |
| 42 | 44 | ||
| 43 | 45 | HandleDebugBreakInstruction | |
| 44 | 46 | If the debugger should stop at hardcoded "int3" breakpoints. [<https://bugs.freepascal.org/view.php?id=37292>](https://bugs.freepascal.org/view.php?id=37292) | |
| 45 | 47 | ||
| 46 | 48 | MaxMemReadSize | |
| 47 | 49 | Limits the amount of Memory the debugger will use for a single read. This can prevent errors if incorrect size information proclaims a structure is tens of Gigabyte big.\ | |
| 48 | 50 | This may also protect from dummy declarations like "type TMaxArray = array \[0..\$7FFFFFFF\] of byte; PMaxArray = ^TMaxArray". Such types are never fully allocated. They only act as accessor.\ | |
| 49 | 51 | The limit applies to the structure as a whole. Individual fields/elements can be read if they are smaller than the limit. | |
| 50 | 52 | ||
| 51 | 53 | MaxStringLen | |
| 52 | 54 | Length in chars to cut off strings. Protects against corrupted data. | |
| 53 | 55 | ||
| 54 | 56 | MaxArrayLen | |
| 55 | 57 | Length in elements to cut off array. Protects against corrupted data. | |
| 56 | 58 | ||
| 57 | 59 | MaxNullStringSearchLen | |
| 58 | 60 | PChar (and strings in dwarf2) have no length info (or not determinable to the debugger). The debugger must read memory until it finds a \#0. If no \#0 is found the debugger will stop searching at this length. | |
| 59 | 61 | ||
| 60 | 62 | MaxStackStringLen, MaxStackArrayLen, MaxStackNullStringSearchLen | |
| 61 | 63 | Same as above, but applied when evaluating stack-frames (content for the Stack window). Due to the limited space in the stack window, one might choose lower limits. | |
| 62 | 64 | ||
| 63 | 65 | MaxArrayConversionCnt | |
| 64 | 66 | If configured, the debugger can run [[IDE Window: Ide Options - Backend Value Converter|converters (See here)]] on data (Currently only passing **variant** to **SysVarToLStr**). In arrays and structures each entry/field will be converted if it is a variant. This limits the amount of entries in an array that will be converted.\ | |
| 65 | 67 | If an array contains structures with several variant fields, then each field is counted as conversion.\ | |
| 66 | 68 | If the debug inspector fetches an array, then this limit does not apply to the array as a whole. It will rather apply to each entry within the array (should those entries be themself arrays). This is so, that the limit applies to each row displayed by the Inspector. | |
| 67 | 69 | ||
| 68 | 70 | MaxTotalConversionCnt | |
| 69 | 71 | Similar to **MaxArrayConversionCnt**, but applies to all conversions. I.e., also outside of arrays, like fields of a class.\ | |
| 70 | 72 | This limit also applies to the whole of an inspected value in the inspector.\ | |
| 71 | 73 | Unlike what happens in the inspector, in the watches window an expanded watch (sub-watches) does not count as a whole. Each sub-watch counts individually. | |
| 72 | 74 | ||
| 73 | 75 | The debugger currently does not give an indication if a value was cut off. This will be implemented in future. | |
| 74 | 76 | ||
| 75 | 77 | --- | |
| 76 | 78 | *From the Free Pascal wiki, page "LazDebuggerFp", as it stood on 2023-03-12 after a change by Martin, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 77 | 79 | Category: Debugging |