|
392 | 392 | "data": { |
393 | 393 | "type": [ "array", "boolean", "integer", "null", "number" , "object", "string" ], |
394 | 394 | "description": "Additional data to report. For the `telemetry` category the data is sent to telemetry, for the other categories the data is shown in JSON format." |
| 395 | + }, |
| 396 | + "locationReference": { |
| 397 | + "type": "integer", |
| 398 | + "description": "A reference that allows the client to request the location where the new value is declared. For example, if the logged value is function pointer, the adapter may be able to look up the function's location. This should be present only if the adapter is likely to be able to resolve the location.\n\nThis reference shares the same lifetime as the `variablesReference`. See 'Lifetime of Object References' in the Overview section for details." |
395 | 399 | } |
396 | 400 | }, |
397 | 401 | "required": ["output"] |
|
508 | 512 | }, |
509 | 513 | "systemProcessId": { |
510 | 514 | "type": "integer", |
511 | | - "description": "The system process id of the debugged process. This property is missing for non-system processes." |
| 515 | + "description": "The process ID of the debugged process, as assigned by the operating system. This property should be omitted for logical processes that do not map to operating system processes on the machine." |
512 | 516 | }, |
513 | 517 | "isLocalProcess": { |
514 | 518 | "type": "boolean", |
|
2231 | 2235 | }, |
2232 | 2236 | "variablesReference": { |
2233 | 2237 | "type": "integer", |
2234 | | - "description": "If `variablesReference` is > 0, the new value is structured and its children can be retrieved by passing `variablesReference` to the `variables` request as long as execution remains suspended. See 'Lifetime of Object References' in the Overview section for details." |
| 2238 | + "description": "If `variablesReference` is > 0, the new value is structured and its children can be retrieved by passing `variablesReference` to the `variables` request as long as execution remains suspended. See 'Lifetime of Object References' in the Overview section for details.\n\nIf this property is included in the response, any `variablesReference` previously associated with the updated variable, and those of its children, are no longer valid." |
2235 | 2239 | }, |
2236 | 2240 | "namedVariables": { |
2237 | 2241 | "type": "integer", |
|
2244 | 2248 | "memoryReference": { |
2245 | 2249 | "type": "string", |
2246 | 2250 | "description": "A memory reference to a location appropriate for this result.\nFor pointer type eval results, this is generally a reference to the memory address contained in the pointer.\nThis attribute may be returned by a debug adapter if corresponding capability `supportsMemoryReferences` is true." |
| 2251 | + }, |
| 2252 | + "valueLocationReference": { |
| 2253 | + "type": "integer", |
| 2254 | + "description": "A reference that allows the client to request the location where the new value is declared. For example, if the new value is function pointer, the adapter may be able to look up the function's location. This should be present only if the adapter is likely to be able to resolve the location.\n\nThis reference shares the same lifetime as the `variablesReference`. See 'Lifetime of Object References' in the Overview section for details." |
2247 | 2255 | } |
2248 | 2256 | }, |
2249 | 2257 | "required": [ "value" ] |
|
2483 | 2491 | "EvaluateRequest": { |
2484 | 2492 | "allOf": [ { "$ref": "#/definitions/Request" }, { |
2485 | 2493 | "type": "object", |
2486 | | - "description": "Evaluates the given expression in the context of the topmost stack frame.\nThe expression has access to any variables and arguments that are in scope.", |
| 2494 | + "description": "Evaluates the given expression in the context of a stack frame.\nThe expression has access to any variables and arguments that are in scope.", |
2487 | 2495 | "properties": { |
2488 | 2496 | "command": { |
2489 | 2497 | "type": "string", |
|
2574 | 2582 | "memoryReference": { |
2575 | 2583 | "type": "string", |
2576 | 2584 | "description": "A memory reference to a location appropriate for this result.\nFor pointer type eval results, this is generally a reference to the memory address contained in the pointer.\nThis attribute may be returned by a debug adapter if corresponding capability `supportsMemoryReferences` is true." |
| 2585 | + }, |
| 2586 | + "valueLocationReference": { |
| 2587 | + "type": "integer", |
| 2588 | + "description": "A reference that allows the client to request the location where the returned value is declared. For example, if a function pointer is returned, the adapter may be able to look up the function's location. This should be present only if the adapter is likely to be able to resolve the location.\n\nThis reference shares the same lifetime as the `variablesReference`. See 'Lifetime of Object References' in the Overview section for details." |
2577 | 2589 | } |
2578 | 2590 | }, |
2579 | 2591 | "required": [ "result", "variablesReference" ] |
|
2657 | 2669 | "memoryReference": { |
2658 | 2670 | "type": "string", |
2659 | 2671 | "description": "A memory reference to a location appropriate for this result.\nFor pointer type eval results, this is generally a reference to the memory address contained in the pointer.\nThis attribute may be returned by a debug adapter if corresponding capability `supportsMemoryReferences` is true." |
| 2672 | + }, |
| 2673 | + "valueLocationReference": { |
| 2674 | + "type": "integer", |
| 2675 | + "description": "A reference that allows the client to request the location where the new value is declared. For example, if the new value is function pointer, the adapter may be able to look up the function's location. This should be present only if the adapter is likely to be able to resolve the location.\n\nThis reference shares the same lifetime as the `variablesReference`. See 'Lifetime of Object References' in the Overview section for details." |
2660 | 2676 | } |
2661 | 2677 | }, |
2662 | 2678 | "required": [ "value" ] |
|
3083 | 3099 | }] |
3084 | 3100 | }, |
3085 | 3101 |
|
| 3102 | + "LocationsRequest": { |
| 3103 | + "allOf": [ { "$ref": "#/definitions/Request" }, { |
| 3104 | + "type": "object", |
| 3105 | + "description": "Looks up information about a location reference previously returned by the debug adapter.", |
| 3106 | + "properties": { |
| 3107 | + "command": { |
| 3108 | + "type": "string", |
| 3109 | + "enum": [ "locations" ] |
| 3110 | + }, |
| 3111 | + "arguments": { |
| 3112 | + "$ref": "#/definitions/LocationsArguments" |
| 3113 | + } |
| 3114 | + }, |
| 3115 | + "required": [ "command", "arguments" ] |
| 3116 | + }] |
| 3117 | + }, |
| 3118 | + "LocationsArguments": { |
| 3119 | + "type": "object", |
| 3120 | + "description": "Arguments for `locations` request.", |
| 3121 | + "properties": { |
| 3122 | + "locationReference": { |
| 3123 | + "type": "integer", |
| 3124 | + "description": "Location reference to resolve." |
| 3125 | + } |
| 3126 | + }, |
| 3127 | + "required": [ "locationReference" ] |
| 3128 | + }, |
| 3129 | + "LocationsResponse": { |
| 3130 | + "allOf": [ { "$ref": "#/definitions/Response" }, { |
| 3131 | + "type": "object", |
| 3132 | + "description": "Response to `locations` request.", |
| 3133 | + "properties": { |
| 3134 | + "body": { |
| 3135 | + "type": "object", |
| 3136 | + "properties": { |
| 3137 | + "source": { |
| 3138 | + "$ref": "#/definitions/Source", |
| 3139 | + "description": "The source containing the location; either `source.path` or `source.sourceReference` must be specified." |
| 3140 | + }, |
| 3141 | + "line": { |
| 3142 | + "type": "integer", |
| 3143 | + "description": "The line number of the location. The client capability `linesStartAt1` determines whether it is 0- or 1-based." |
| 3144 | + }, |
| 3145 | + "column": { |
| 3146 | + "type": "integer", |
| 3147 | + "description": "Position of the location within the `line`. It is measured in UTF-16 code units and the client capability `columnsStartAt1` determines whether it is 0- or 1-based. If no column is given, the first position in the start line is assumed." |
| 3148 | + }, |
| 3149 | + "endLine": { |
| 3150 | + "type": "integer", |
| 3151 | + "description": "End line of the location, present if the location refers to a range. The client capability `linesStartAt1` determines whether it is 0- or 1-based." |
| 3152 | + }, |
| 3153 | + "endColumn": { |
| 3154 | + "type": "integer", |
| 3155 | + "description": "End position of the location within `endLine`, present if the location refers to a range. It is measured in UTF-16 code units and the client capability `columnsStartAt1` determines whether it is 0- or 1-based." |
| 3156 | + } |
| 3157 | + }, |
| 3158 | + "required": [ "source", "line" ] |
| 3159 | + } |
| 3160 | + } |
| 3161 | + }] |
| 3162 | + }, |
| 3163 | + |
3086 | 3164 | "Capabilities": { |
3087 | 3165 | "type": "object", |
3088 | 3166 | "title": "Types", |
|
3515 | 3593 | }, |
3516 | 3594 | "canRestart": { |
3517 | 3595 | "type": "boolean", |
3518 | | - "description": "Indicates whether this frame can be restarted with the `restart` request. Clients should only use this if the debug adapter supports the `restart` request and the corresponding capability `supportsRestartRequest` is true. If a debug adapter has this capability, then `canRestart` defaults to `true` if the property is absent." |
| 3596 | + "description": "Indicates whether this frame can be restarted with the `restartFrame` request. Clients should only use this if the debug adapter supports the `restart` request and the corresponding capability `supportsRestartFrame` is true. If a debug adapter has this capability, then `canRestart` defaults to `true` if the property is absent." |
3519 | 3597 | }, |
3520 | 3598 | "instructionPointerReference": { |
3521 | 3599 | "type": "string", |
|
3632 | 3710 | "memoryReference": { |
3633 | 3711 | "type": "string", |
3634 | 3712 | "description": "A memory reference associated with this variable.\nFor pointer type variables, this is generally a reference to the memory address contained in the pointer.\nFor executable data, this reference may later be used in a `disassemble` request.\nThis attribute may be returned by a debug adapter if corresponding capability `supportsMemoryReferences` is true." |
| 3713 | + }, |
| 3714 | + "declarationLocationReference": { |
| 3715 | + "type": "integer", |
| 3716 | + "description": "A reference that allows the client to request the location where the variable is declared. This should be present only if the adapter is likely to be able to resolve the location.\n\nThis reference shares the same lifetime as the `variablesReference`. See 'Lifetime of Object References' in the Overview section for details." |
| 3717 | + }, |
| 3718 | + "valueLocationReference": { |
| 3719 | + "type": "integer", |
| 3720 | + "description": "A reference that allows the client to request the location where the variable's value is declared. For example, if the variable contains a function pointer, the adapter may be able to look up the function's location. This should be present only if the adapter is likely to be able to resolve the location.\n\nThis reference shares the same lifetime as the `variablesReference`. See 'Lifetime of Object References' in the Overview section for details." |
3635 | 3721 | } |
3636 | 3722 | }, |
3637 | 3723 | "required": [ "name", "value", "variablesReference" ] |
|
0 commit comments