docs: update generated docs (#981)
diff --git a/docs/dyn/clouddebugger_v2.debugger.debuggees.breakpoints.html b/docs/dyn/clouddebugger_v2.debugger.debuggees.breakpoints.html
index d573552..347d8ea 100644
--- a/docs/dyn/clouddebugger_v2.debugger.debuggees.breakpoints.html
+++ b/docs/dyn/clouddebugger_v2.debugger.debuggees.breakpoints.html
@@ -81,10 +81,10 @@
<code><a href="#get">get(debuggeeId, breakpointId, clientVersion=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets breakpoint information.</p>
<p class="toc_element">
- <code><a href="#list">list(debuggeeId, waitToken=None, clientVersion=None, action_value=None, includeAllUsers=None, includeInactive=None, stripResults=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(debuggeeId, includeInactive=None, stripResults=None, waitToken=None, action_value=None, includeAllUsers=None, clientVersion=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all breakpoints for the debuggee.</p>
<p class="toc_element">
- <code><a href="#set">set(debuggeeId, body=None, canaryOption=None, clientVersion=None, x__xgafv=None)</a></code></p>
+ <code><a href="#set">set(debuggeeId, body=None, clientVersion=None, canaryOption=None, x__xgafv=None)</a></code></p>
<p class="firstline">Sets the breakpoint to the debuggee.</p>
<h3>Method Details</h3>
<div class="method">
@@ -139,12 +139,6 @@
# ## Breakpoint (the resource)
#
# Represents the breakpoint specification, status and results.
- "expressions": [ # List of read-only expressions to evaluate at the breakpoint location.
- # The expressions are composed using expressions in the programming language
- # at the source location. If the breakpoint action is `LOG`, the evaluated
- # expressions are included in log statements.
- "A String",
- ],
"evaluatedExpressions": [ # Values of evaluated expressions at breakpoint time.
# The evaluated expressions appear in exactly the same order they
# are listed in the `expressions` field.
@@ -261,9 +255,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -304,194 +295,96 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
+ "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+ # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
+ "status": { # Represents a contextual status message. # Breakpoint status.
+ #
+ # The status includes an error flag and a human readable message.
+ # This field is usually unset. The message can be either
+ # informational or an error message. Regardless, clients should always
+ # display the text message back to the user.
+ #
+ # Error status indicates complete failure of the breakpoint.
+ #
+ # Example (non-final state): `Still loading symbols...`
+ #
+ # Examples (final state):
+ #
+ # * `Invalid line number` referring to location
+ # * `Field f not found in class C` referring to condition
+ # The message can indicate an error or informational status, and refer to
+ # specific parts of the containing object.
+ # For example, the `Breakpoint.status` field can indicate an error referring
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
+ "isError": True or False, # Distinguishes errors from informational messages.
+ "description": { # Represents a message with parameters. # Status message text.
+ "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
+ # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
+ # character.
+ #
+ # Examples:
+ #
+ # * `Failed to load '$0' which helps debug $1 the first time it
+ # is loaded. Again, $0 is very important.`
+ # * `Please pay $$10 to use $0 instead of $1.`
+ "parameters": [ # Optional parameters to be embedded into the message.
+ "A String",
+ ],
+ },
+ "refersTo": "A String", # Reference to which the message applies.
+ },
+ "expressions": [ # List of read-only expressions to evaluate at the breakpoint location.
+ # The expressions are composed using expressions in the programming language
+ # at the source location. If the breakpoint action is `LOG`, the evaluated
+ # expressions are included in log statements.
+ "A String",
+ ],
+ "labels": { # A set of custom breakpoint properties, populated by the agent, to be
+ # displayed to the user.
+ "a_key": "A String",
+ },
+ "logMessageFormat": "A String", # Only relevant when action is `LOG`. Defines the message to log when
+ # the breakpoint hits. The message may include parameter placeholders `$0`,
+ # `$1`, etc. These placeholders are replaced with the evaluated value
+ # of the appropriate expression. Expressions not referenced in
+ # `log_message_format` are not logged.
+ #
+ # Example: `Message received, id = $0, count = $1` with
+ # `expressions` = `[ message.id, message.count ]`.
+ "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+ "location": { # Represents a location in the source code. # Breakpoint source location.
+ "path": "A String", # Path to the source file within the source context of the target binary.
+ "line": 42, # Line inside the file. The first line in the file has the value `1`.
+ "column": 42, # Column within a line. The first column in a line as the value `1`.
+ # Agents that do not support setting breakpoints on specific columns ignore
+ # this field.
+ },
"isFinalState": True or False, # When true, indicates that this is a final result and the
# breakpoint state will not change from here on.
+ "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
+ "id": "A String", # Breakpoint identifier, unique in the scope of the debuggee.
+ "action": "A String", # Action that the agent should perform when the code at the
+ # breakpoint location is hit.
+ "finalTime": "A String", # Time this breakpoint was finalized as seen by the server in seconds
+ # resolution.
+ "state": "A String", # The current state of the breakpoint.
"stackFrames": [ # The stack at breakpoint time, where stack_frames[0] represents the most
# recently entered function.
{ # Represents a stack frame context.
- "locals": [ # Set of local variables at the stack frame location.
- # Note that this might not be populated for all stack frames.
- { # Represents a variable or an argument possibly of a compound object type.
- # Note how the following variables are represented:
- #
- # 1) A simple variable:
- #
- # int x = 5
- #
- # { name: "x", value: "5", type: "int" } // Captured variable
- #
- # 2) A compound object:
- #
- # struct T {
- # int m1;
- # int m2;
- # };
- # T x = { 3, 7 };
- #
- # { // Captured variable
- # name: "x",
- # type: "T",
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # 3) A pointer where the pointee was captured:
- #
- # T x = { 3, 7 };
- # T* p = &x;
- #
- # { // Captured variable
- # name: "p",
- # type: "T*",
- # value: "0x00500500",
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # 4) A pointer where the pointee was not captured:
- #
- # T* p = new T;
- #
- # { // Captured variable
- # name: "p",
- # type: "T*",
- # value: "0x00400400"
- # status { is_error: true, description { format: "unavailable" } }
- # }
- #
- # The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
- #
- # Note that a null pointer should not have members.
- #
- # 5) An unnamed value:
- #
- # int* p = new int(7);
- #
- # { // Captured variable
- # name: "p",
- # value: "0x00500500",
- # type: "int*",
- # members { value: "7", type: "int" } }
- #
- # 6) An unnamed pointer where the pointee was not captured:
- #
- # int* p = new int(7);
- # int** pp = &p;
- #
- # { // Captured variable
- # name: "pp",
- # value: "0x00500500",
- # type: "int**",
- # members {
- # value: "0x00400400",
- # type: "int*"
- # status {
- # is_error: true,
- # description: { format: "unavailable" } }
- # }
- # }
- # }
- #
- # To optimize computation, memory and network traffic, variables that
- # repeat in the output multiple times can be stored once in a shared
- # variable table and be referenced using the `var_table_index` field. The
- # variables stored in the shared table are nameless and are essentially
- # a partition of the complete variable. To reconstruct the complete
- # variable, merge the referencing variable with the referenced variable.
- #
- # When using the shared variable table, the following variables:
- #
- # T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
- #
- # { name: "x", var_table_index: 3, type: "T" } // Captured variables
- # { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
- #
- # { // Shared variable table entry #3:
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # Note that the pointer address is stored with the referencing variable
- # and not with the referenced variable. This allows the referenced variable
- # to be shared between pointers and references.
- #
- # The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
- "status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
- # unset. A status of a single variable only applies to that variable or
- # expression. The rest of breakpoint data still remains valid. Variables
- # might be reported in error state even when breakpoint is not in final
- # state.
- #
- # The message may refer to variable name with `refers_to` set to
- # `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`.
- # In either case variable value and members will be unset.
- #
- # Example of error message applied to name: `Invalid expression syntax`.
- #
- # Example of information message applied to value: `Not captured`.
- #
- # Examples of error message applied to value:
- #
- # * `Malformed string`,
- # * `Field f not found in class C`
- # * `Null pointer dereference`
- # The message can indicate an error or informational status, and refer to
- # specific parts of the containing object.
- # For example, the `Breakpoint.status` field can indicate an error referring
- # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
- "isError": True or False, # Distinguishes errors from informational messages.
- "description": { # Represents a message with parameters. # Status message text.
- "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
- # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
- # character.
- #
- # Examples:
- #
- # * `Failed to load '$0' which helps debug $1 the first time it
- # is loaded. Again, $0 is very important.`
- # * `Please pay $$10 to use $0 instead of $1.`
- "parameters": [ # Optional parameters to be embedded into the message.
- "A String",
- ],
- },
- "refersTo": "A String", # Reference to which the message applies.
- },
- "name": "A String", # Name of the variable, if any.
- "type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
- # `var_table_index`, `type` goes next to `value`. The interpretation of
- # a type is agent specific. It is recommended to include the dynamic type
- # rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
- "varTableIndex": 42, # Reference to a variable in the shared variable table. More than
- # one variable can reference the same variable in the table. The
- # `var_table_index` field is an index into `variable_table` in Breakpoint.
- },
- ],
- "location": { # Represents a location in the source code. # Source location of the call site.
- "path": "A String", # Path to the source file within the source context of the target binary.
- "column": 42, # Column within a line. The first column in a line as the value `1`.
- # Agents that do not support setting breakpoints on specific columns ignore
- # this field.
- "line": 42, # Line inside the file. The first line in the file has the value `1`.
- },
"function": "A String", # Demangled function name at the call site.
"arguments": [ # Set of arguments passed to this function.
# Note that this might not be populated for all stack frames.
@@ -604,9 +497,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -647,75 +537,198 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
+ "locals": [ # Set of local variables at the stack frame location.
+ # Note that this might not be populated for all stack frames.
+ { # Represents a variable or an argument possibly of a compound object type.
+ # Note how the following variables are represented:
+ #
+ # 1) A simple variable:
+ #
+ # int x = 5
+ #
+ # { name: "x", value: "5", type: "int" } // Captured variable
+ #
+ # 2) A compound object:
+ #
+ # struct T {
+ # int m1;
+ # int m2;
+ # };
+ # T x = { 3, 7 };
+ #
+ # { // Captured variable
+ # name: "x",
+ # type: "T",
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # 3) A pointer where the pointee was captured:
+ #
+ # T x = { 3, 7 };
+ # T* p = &x;
+ #
+ # { // Captured variable
+ # name: "p",
+ # type: "T*",
+ # value: "0x00500500",
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # 4) A pointer where the pointee was not captured:
+ #
+ # T* p = new T;
+ #
+ # { // Captured variable
+ # name: "p",
+ # type: "T*",
+ # value: "0x00400400"
+ # status { is_error: true, description { format: "unavailable" } }
+ # }
+ #
+ # The status should describe the reason for the missing value,
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ #
+ # Note that a null pointer should not have members.
+ #
+ # 5) An unnamed value:
+ #
+ # int* p = new int(7);
+ #
+ # { // Captured variable
+ # name: "p",
+ # value: "0x00500500",
+ # type: "int*",
+ # members { value: "7", type: "int" } }
+ #
+ # 6) An unnamed pointer where the pointee was not captured:
+ #
+ # int* p = new int(7);
+ # int** pp = &p;
+ #
+ # { // Captured variable
+ # name: "pp",
+ # value: "0x00500500",
+ # type: "int**",
+ # members {
+ # value: "0x00400400",
+ # type: "int*"
+ # status {
+ # is_error: true,
+ # description: { format: "unavailable" } }
+ # }
+ # }
+ # }
+ #
+ # To optimize computation, memory and network traffic, variables that
+ # repeat in the output multiple times can be stored once in a shared
+ # variable table and be referenced using the `var_table_index` field. The
+ # variables stored in the shared table are nameless and are essentially
+ # a partition of the complete variable. To reconstruct the complete
+ # variable, merge the referencing variable with the referenced variable.
+ #
+ # When using the shared variable table, the following variables:
+ #
+ # T x = { 3, 7 };
+ # T* p = &x;
+ # T& r = x;
+ #
+ # { name: "x", var_table_index: 3, type: "T" } // Captured variables
+ # { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
+ #
+ # { // Shared variable table entry #3:
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # Note that the pointer address is stored with the referencing variable
+ # and not with the referenced variable. This allows the referenced variable
+ # to be shared between pointers and references.
+ #
+ # The type field is optional. The debugger agent may or may not support it.
+ "status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
+ # unset. A status of a single variable only applies to that variable or
+ # expression. The rest of breakpoint data still remains valid. Variables
+ # might be reported in error state even when breakpoint is not in final
+ # state.
+ #
+ # The message may refer to variable name with `refers_to` set to
+ # `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`.
+ # In either case variable value and members will be unset.
+ #
+ # Example of error message applied to name: `Invalid expression syntax`.
+ #
+ # Example of information message applied to value: `Not captured`.
+ #
+ # Examples of error message applied to value:
+ #
+ # * `Malformed string`,
+ # * `Field f not found in class C`
+ # * `Null pointer dereference`
+ # The message can indicate an error or informational status, and refer to
+ # specific parts of the containing object.
+ # For example, the `Breakpoint.status` field can indicate an error referring
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
+ "isError": True or False, # Distinguishes errors from informational messages.
+ "description": { # Represents a message with parameters. # Status message text.
+ "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
+ # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
+ # character.
+ #
+ # Examples:
+ #
+ # * `Failed to load '$0' which helps debug $1 the first time it
+ # is loaded. Again, $0 is very important.`
+ # * `Please pay $$10 to use $0 instead of $1.`
+ "parameters": [ # Optional parameters to be embedded into the message.
+ "A String",
+ ],
+ },
+ "refersTo": "A String", # Reference to which the message applies.
+ },
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
+ "type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
+ # `var_table_index`, `type` goes next to `value`. The interpretation of
+ # a type is agent specific. It is recommended to include the dynamic type
+ # rather than a static type of an object.
+ "name": "A String", # Name of the variable, if any.
+ "varTableIndex": 42, # Reference to a variable in the shared variable table. More than
+ # one variable can reference the same variable in the table. The
+ # `var_table_index` field is an index into `variable_table` in Breakpoint.
+ },
+ ],
+ "location": { # Represents a location in the source code. # Source location of the call site.
+ "path": "A String", # Path to the source file within the source context of the target binary.
+ "line": 42, # Line inside the file. The first line in the file has the value `1`.
+ "column": 42, # Column within a line. The first column in a line as the value `1`.
+ # Agents that do not support setting breakpoints on specific columns ignore
+ # this field.
+ },
},
],
+ "userEmail": "A String", # E-mail address of the user that created this breakpoint
"condition": "A String", # Condition that triggers the breakpoint.
# The condition is a compound boolean expression composed using expressions
# in a programming language at the source location.
- "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
- # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
- "status": { # Represents a contextual status message. # Breakpoint status.
- #
- # The status includes an error flag and a human readable message.
- # This field is usually unset. The message can be either
- # informational or an error message. Regardless, clients should always
- # display the text message back to the user.
- #
- # Error status indicates complete failure of the breakpoint.
- #
- # Example (non-final state): `Still loading symbols...`
- #
- # Examples (final state):
- #
- # * `Invalid line number` referring to location
- # * `Field f not found in class C` referring to condition
- # The message can indicate an error or informational status, and refer to
- # specific parts of the containing object.
- # For example, the `Breakpoint.status` field can indicate an error referring
- # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
- "isError": True or False, # Distinguishes errors from informational messages.
- "description": { # Represents a message with parameters. # Status message text.
- "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
- # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
- # character.
- #
- # Examples:
- #
- # * `Failed to load '$0' which helps debug $1 the first time it
- # is loaded. Again, $0 is very important.`
- # * `Please pay $$10 to use $0 instead of $1.`
- "parameters": [ # Optional parameters to be embedded into the message.
- "A String",
- ],
- },
- "refersTo": "A String", # Reference to which the message applies.
- },
- "state": "A String", # The current state of the breakpoint.
- "userEmail": "A String", # E-mail address of the user that created this breakpoint
- "action": "A String", # Action that the agent should perform when the code at the
- # breakpoint location is hit.
- "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
- "id": "A String", # Breakpoint identifier, unique in the scope of the debuggee.
- "location": { # Represents a location in the source code. # Breakpoint source location.
- "path": "A String", # Path to the source file within the source context of the target binary.
- "column": 42, # Column within a line. The first column in a line as the value `1`.
- # Agents that do not support setting breakpoints on specific columns ignore
- # this field.
- "line": 42, # Line inside the file. The first line in the file has the value `1`.
- },
- "finalTime": "A String", # Time this breakpoint was finalized as seen by the server in seconds
- # resolution.
"variableTable": [ # The `variable_table` exists to aid with computation, memory and network
# traffic optimization. It enables storing a variable once and reference
# it from multiple variables, including variables stored in the
@@ -837,9 +850,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -880,54 +890,44 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
- "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
- "logMessageFormat": "A String", # Only relevant when action is `LOG`. Defines the message to log when
- # the breakpoint hits. The message may include parameter placeholders `$0`,
- # `$1`, etc. These placeholders are replaced with the evaluated value
- # of the appropriate expression. Expressions not referenced in
- # `log_message_format` are not logged.
- #
- # Example: `Message received, id = $0, count = $1` with
- # `expressions` = `[ message.id, message.count ]`.
- "labels": { # A set of custom breakpoint properties, populated by the agent, to be
- # displayed to the user.
- "a_key": "A String",
- },
},
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(debuggeeId, waitToken=None, clientVersion=None, action_value=None, includeAllUsers=None, includeInactive=None, stripResults=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(debuggeeId, includeInactive=None, stripResults=None, waitToken=None, action_value=None, includeAllUsers=None, clientVersion=None, x__xgafv=None)</code>
<pre>Lists all breakpoints for the debuggee.
Args:
debuggeeId: string, Required. ID of the debuggee whose breakpoints to list. (required)
+ includeInactive: boolean, When set to `true`, the response includes active and inactive
+breakpoints. Otherwise, it includes only active breakpoints.
+ stripResults: boolean, This field is deprecated. The following fields are always stripped out of
+the result: `stack_frames`, `evaluated_expressions` and `variable_table`.
waitToken: string, A wait token that, if specified, blocks the call until the breakpoints
list has changed, or a server selected timeout has expired. The value
should be set from the last response. The error code
`google.rpc.Code.ABORTED` (RPC) is returned on wait timeout, which
should be called again with the same `wait_token`.
- clientVersion: string, Required. The client version making the call.
-Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
action_value: string, Only breakpoints with the specified action will pass the filter.
includeAllUsers: boolean, When set to `true`, the response includes the list of breakpoints set by
any user. Otherwise, it includes only breakpoints set by the caller.
- includeInactive: boolean, When set to `true`, the response includes active and inactive
-breakpoints. Otherwise, it includes only active breakpoints.
- stripResults: boolean, This field is deprecated. The following fields are always stripped out of
-the result: `stack_frames`, `evaluated_expressions` and `variable_table`.
+ clientVersion: string, Required. The client version making the call.
+Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -937,6 +937,8 @@
An object of the form:
{ # Response for listing breakpoints.
+ "nextWaitToken": "A String", # A wait token that can be used in the next call to `list` (REST) or
+ # `ListBreakpoints` (RPC) to block until the list of breakpoints has changes.
"breakpoints": [ # List of breakpoints matching the request.
# The fields `id` and `location` are guaranteed to be set on each breakpoint.
# The fields: `stack_frames`, `evaluated_expressions` and `variable_table`
@@ -945,12 +947,6 @@
# ## Breakpoint (the resource)
#
# Represents the breakpoint specification, status and results.
- "expressions": [ # List of read-only expressions to evaluate at the breakpoint location.
- # The expressions are composed using expressions in the programming language
- # at the source location. If the breakpoint action is `LOG`, the evaluated
- # expressions are included in log statements.
- "A String",
- ],
"evaluatedExpressions": [ # Values of evaluated expressions at breakpoint time.
# The evaluated expressions appear in exactly the same order they
# are listed in the `expressions` field.
@@ -1067,9 +1063,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -1110,194 +1103,96 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
+ "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+ # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
+ "status": { # Represents a contextual status message. # Breakpoint status.
+ #
+ # The status includes an error flag and a human readable message.
+ # This field is usually unset. The message can be either
+ # informational or an error message. Regardless, clients should always
+ # display the text message back to the user.
+ #
+ # Error status indicates complete failure of the breakpoint.
+ #
+ # Example (non-final state): `Still loading symbols...`
+ #
+ # Examples (final state):
+ #
+ # * `Invalid line number` referring to location
+ # * `Field f not found in class C` referring to condition
+ # The message can indicate an error or informational status, and refer to
+ # specific parts of the containing object.
+ # For example, the `Breakpoint.status` field can indicate an error referring
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
+ "isError": True or False, # Distinguishes errors from informational messages.
+ "description": { # Represents a message with parameters. # Status message text.
+ "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
+ # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
+ # character.
+ #
+ # Examples:
+ #
+ # * `Failed to load '$0' which helps debug $1 the first time it
+ # is loaded. Again, $0 is very important.`
+ # * `Please pay $$10 to use $0 instead of $1.`
+ "parameters": [ # Optional parameters to be embedded into the message.
+ "A String",
+ ],
+ },
+ "refersTo": "A String", # Reference to which the message applies.
+ },
+ "expressions": [ # List of read-only expressions to evaluate at the breakpoint location.
+ # The expressions are composed using expressions in the programming language
+ # at the source location. If the breakpoint action is `LOG`, the evaluated
+ # expressions are included in log statements.
+ "A String",
+ ],
+ "labels": { # A set of custom breakpoint properties, populated by the agent, to be
+ # displayed to the user.
+ "a_key": "A String",
+ },
+ "logMessageFormat": "A String", # Only relevant when action is `LOG`. Defines the message to log when
+ # the breakpoint hits. The message may include parameter placeholders `$0`,
+ # `$1`, etc. These placeholders are replaced with the evaluated value
+ # of the appropriate expression. Expressions not referenced in
+ # `log_message_format` are not logged.
+ #
+ # Example: `Message received, id = $0, count = $1` with
+ # `expressions` = `[ message.id, message.count ]`.
+ "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+ "location": { # Represents a location in the source code. # Breakpoint source location.
+ "path": "A String", # Path to the source file within the source context of the target binary.
+ "line": 42, # Line inside the file. The first line in the file has the value `1`.
+ "column": 42, # Column within a line. The first column in a line as the value `1`.
+ # Agents that do not support setting breakpoints on specific columns ignore
+ # this field.
+ },
"isFinalState": True or False, # When true, indicates that this is a final result and the
# breakpoint state will not change from here on.
+ "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
+ "id": "A String", # Breakpoint identifier, unique in the scope of the debuggee.
+ "action": "A String", # Action that the agent should perform when the code at the
+ # breakpoint location is hit.
+ "finalTime": "A String", # Time this breakpoint was finalized as seen by the server in seconds
+ # resolution.
+ "state": "A String", # The current state of the breakpoint.
"stackFrames": [ # The stack at breakpoint time, where stack_frames[0] represents the most
# recently entered function.
{ # Represents a stack frame context.
- "locals": [ # Set of local variables at the stack frame location.
- # Note that this might not be populated for all stack frames.
- { # Represents a variable or an argument possibly of a compound object type.
- # Note how the following variables are represented:
- #
- # 1) A simple variable:
- #
- # int x = 5
- #
- # { name: "x", value: "5", type: "int" } // Captured variable
- #
- # 2) A compound object:
- #
- # struct T {
- # int m1;
- # int m2;
- # };
- # T x = { 3, 7 };
- #
- # { // Captured variable
- # name: "x",
- # type: "T",
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # 3) A pointer where the pointee was captured:
- #
- # T x = { 3, 7 };
- # T* p = &x;
- #
- # { // Captured variable
- # name: "p",
- # type: "T*",
- # value: "0x00500500",
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # 4) A pointer where the pointee was not captured:
- #
- # T* p = new T;
- #
- # { // Captured variable
- # name: "p",
- # type: "T*",
- # value: "0x00400400"
- # status { is_error: true, description { format: "unavailable" } }
- # }
- #
- # The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
- #
- # Note that a null pointer should not have members.
- #
- # 5) An unnamed value:
- #
- # int* p = new int(7);
- #
- # { // Captured variable
- # name: "p",
- # value: "0x00500500",
- # type: "int*",
- # members { value: "7", type: "int" } }
- #
- # 6) An unnamed pointer where the pointee was not captured:
- #
- # int* p = new int(7);
- # int** pp = &p;
- #
- # { // Captured variable
- # name: "pp",
- # value: "0x00500500",
- # type: "int**",
- # members {
- # value: "0x00400400",
- # type: "int*"
- # status {
- # is_error: true,
- # description: { format: "unavailable" } }
- # }
- # }
- # }
- #
- # To optimize computation, memory and network traffic, variables that
- # repeat in the output multiple times can be stored once in a shared
- # variable table and be referenced using the `var_table_index` field. The
- # variables stored in the shared table are nameless and are essentially
- # a partition of the complete variable. To reconstruct the complete
- # variable, merge the referencing variable with the referenced variable.
- #
- # When using the shared variable table, the following variables:
- #
- # T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
- #
- # { name: "x", var_table_index: 3, type: "T" } // Captured variables
- # { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
- #
- # { // Shared variable table entry #3:
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # Note that the pointer address is stored with the referencing variable
- # and not with the referenced variable. This allows the referenced variable
- # to be shared between pointers and references.
- #
- # The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
- "status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
- # unset. A status of a single variable only applies to that variable or
- # expression. The rest of breakpoint data still remains valid. Variables
- # might be reported in error state even when breakpoint is not in final
- # state.
- #
- # The message may refer to variable name with `refers_to` set to
- # `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`.
- # In either case variable value and members will be unset.
- #
- # Example of error message applied to name: `Invalid expression syntax`.
- #
- # Example of information message applied to value: `Not captured`.
- #
- # Examples of error message applied to value:
- #
- # * `Malformed string`,
- # * `Field f not found in class C`
- # * `Null pointer dereference`
- # The message can indicate an error or informational status, and refer to
- # specific parts of the containing object.
- # For example, the `Breakpoint.status` field can indicate an error referring
- # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
- "isError": True or False, # Distinguishes errors from informational messages.
- "description": { # Represents a message with parameters. # Status message text.
- "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
- # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
- # character.
- #
- # Examples:
- #
- # * `Failed to load '$0' which helps debug $1 the first time it
- # is loaded. Again, $0 is very important.`
- # * `Please pay $$10 to use $0 instead of $1.`
- "parameters": [ # Optional parameters to be embedded into the message.
- "A String",
- ],
- },
- "refersTo": "A String", # Reference to which the message applies.
- },
- "name": "A String", # Name of the variable, if any.
- "type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
- # `var_table_index`, `type` goes next to `value`. The interpretation of
- # a type is agent specific. It is recommended to include the dynamic type
- # rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
- "varTableIndex": 42, # Reference to a variable in the shared variable table. More than
- # one variable can reference the same variable in the table. The
- # `var_table_index` field is an index into `variable_table` in Breakpoint.
- },
- ],
- "location": { # Represents a location in the source code. # Source location of the call site.
- "path": "A String", # Path to the source file within the source context of the target binary.
- "column": 42, # Column within a line. The first column in a line as the value `1`.
- # Agents that do not support setting breakpoints on specific columns ignore
- # this field.
- "line": 42, # Line inside the file. The first line in the file has the value `1`.
- },
"function": "A String", # Demangled function name at the call site.
"arguments": [ # Set of arguments passed to this function.
# Note that this might not be populated for all stack frames.
@@ -1410,9 +1305,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -1453,75 +1345,198 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
+ "locals": [ # Set of local variables at the stack frame location.
+ # Note that this might not be populated for all stack frames.
+ { # Represents a variable or an argument possibly of a compound object type.
+ # Note how the following variables are represented:
+ #
+ # 1) A simple variable:
+ #
+ # int x = 5
+ #
+ # { name: "x", value: "5", type: "int" } // Captured variable
+ #
+ # 2) A compound object:
+ #
+ # struct T {
+ # int m1;
+ # int m2;
+ # };
+ # T x = { 3, 7 };
+ #
+ # { // Captured variable
+ # name: "x",
+ # type: "T",
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # 3) A pointer where the pointee was captured:
+ #
+ # T x = { 3, 7 };
+ # T* p = &x;
+ #
+ # { // Captured variable
+ # name: "p",
+ # type: "T*",
+ # value: "0x00500500",
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # 4) A pointer where the pointee was not captured:
+ #
+ # T* p = new T;
+ #
+ # { // Captured variable
+ # name: "p",
+ # type: "T*",
+ # value: "0x00400400"
+ # status { is_error: true, description { format: "unavailable" } }
+ # }
+ #
+ # The status should describe the reason for the missing value,
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ #
+ # Note that a null pointer should not have members.
+ #
+ # 5) An unnamed value:
+ #
+ # int* p = new int(7);
+ #
+ # { // Captured variable
+ # name: "p",
+ # value: "0x00500500",
+ # type: "int*",
+ # members { value: "7", type: "int" } }
+ #
+ # 6) An unnamed pointer where the pointee was not captured:
+ #
+ # int* p = new int(7);
+ # int** pp = &p;
+ #
+ # { // Captured variable
+ # name: "pp",
+ # value: "0x00500500",
+ # type: "int**",
+ # members {
+ # value: "0x00400400",
+ # type: "int*"
+ # status {
+ # is_error: true,
+ # description: { format: "unavailable" } }
+ # }
+ # }
+ # }
+ #
+ # To optimize computation, memory and network traffic, variables that
+ # repeat in the output multiple times can be stored once in a shared
+ # variable table and be referenced using the `var_table_index` field. The
+ # variables stored in the shared table are nameless and are essentially
+ # a partition of the complete variable. To reconstruct the complete
+ # variable, merge the referencing variable with the referenced variable.
+ #
+ # When using the shared variable table, the following variables:
+ #
+ # T x = { 3, 7 };
+ # T* p = &x;
+ # T& r = x;
+ #
+ # { name: "x", var_table_index: 3, type: "T" } // Captured variables
+ # { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
+ #
+ # { // Shared variable table entry #3:
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # Note that the pointer address is stored with the referencing variable
+ # and not with the referenced variable. This allows the referenced variable
+ # to be shared between pointers and references.
+ #
+ # The type field is optional. The debugger agent may or may not support it.
+ "status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
+ # unset. A status of a single variable only applies to that variable or
+ # expression. The rest of breakpoint data still remains valid. Variables
+ # might be reported in error state even when breakpoint is not in final
+ # state.
+ #
+ # The message may refer to variable name with `refers_to` set to
+ # `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`.
+ # In either case variable value and members will be unset.
+ #
+ # Example of error message applied to name: `Invalid expression syntax`.
+ #
+ # Example of information message applied to value: `Not captured`.
+ #
+ # Examples of error message applied to value:
+ #
+ # * `Malformed string`,
+ # * `Field f not found in class C`
+ # * `Null pointer dereference`
+ # The message can indicate an error or informational status, and refer to
+ # specific parts of the containing object.
+ # For example, the `Breakpoint.status` field can indicate an error referring
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
+ "isError": True or False, # Distinguishes errors from informational messages.
+ "description": { # Represents a message with parameters. # Status message text.
+ "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
+ # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
+ # character.
+ #
+ # Examples:
+ #
+ # * `Failed to load '$0' which helps debug $1 the first time it
+ # is loaded. Again, $0 is very important.`
+ # * `Please pay $$10 to use $0 instead of $1.`
+ "parameters": [ # Optional parameters to be embedded into the message.
+ "A String",
+ ],
+ },
+ "refersTo": "A String", # Reference to which the message applies.
+ },
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
+ "type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
+ # `var_table_index`, `type` goes next to `value`. The interpretation of
+ # a type is agent specific. It is recommended to include the dynamic type
+ # rather than a static type of an object.
+ "name": "A String", # Name of the variable, if any.
+ "varTableIndex": 42, # Reference to a variable in the shared variable table. More than
+ # one variable can reference the same variable in the table. The
+ # `var_table_index` field is an index into `variable_table` in Breakpoint.
+ },
+ ],
+ "location": { # Represents a location in the source code. # Source location of the call site.
+ "path": "A String", # Path to the source file within the source context of the target binary.
+ "line": 42, # Line inside the file. The first line in the file has the value `1`.
+ "column": 42, # Column within a line. The first column in a line as the value `1`.
+ # Agents that do not support setting breakpoints on specific columns ignore
+ # this field.
+ },
},
],
+ "userEmail": "A String", # E-mail address of the user that created this breakpoint
"condition": "A String", # Condition that triggers the breakpoint.
# The condition is a compound boolean expression composed using expressions
# in a programming language at the source location.
- "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
- # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
- "status": { # Represents a contextual status message. # Breakpoint status.
- #
- # The status includes an error flag and a human readable message.
- # This field is usually unset. The message can be either
- # informational or an error message. Regardless, clients should always
- # display the text message back to the user.
- #
- # Error status indicates complete failure of the breakpoint.
- #
- # Example (non-final state): `Still loading symbols...`
- #
- # Examples (final state):
- #
- # * `Invalid line number` referring to location
- # * `Field f not found in class C` referring to condition
- # The message can indicate an error or informational status, and refer to
- # specific parts of the containing object.
- # For example, the `Breakpoint.status` field can indicate an error referring
- # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
- "isError": True or False, # Distinguishes errors from informational messages.
- "description": { # Represents a message with parameters. # Status message text.
- "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
- # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
- # character.
- #
- # Examples:
- #
- # * `Failed to load '$0' which helps debug $1 the first time it
- # is loaded. Again, $0 is very important.`
- # * `Please pay $$10 to use $0 instead of $1.`
- "parameters": [ # Optional parameters to be embedded into the message.
- "A String",
- ],
- },
- "refersTo": "A String", # Reference to which the message applies.
- },
- "state": "A String", # The current state of the breakpoint.
- "userEmail": "A String", # E-mail address of the user that created this breakpoint
- "action": "A String", # Action that the agent should perform when the code at the
- # breakpoint location is hit.
- "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
- "id": "A String", # Breakpoint identifier, unique in the scope of the debuggee.
- "location": { # Represents a location in the source code. # Breakpoint source location.
- "path": "A String", # Path to the source file within the source context of the target binary.
- "column": 42, # Column within a line. The first column in a line as the value `1`.
- # Agents that do not support setting breakpoints on specific columns ignore
- # this field.
- "line": 42, # Line inside the file. The first line in the file has the value `1`.
- },
- "finalTime": "A String", # Time this breakpoint was finalized as seen by the server in seconds
- # resolution.
"variableTable": [ # The `variable_table` exists to aid with computation, memory and network
# traffic optimization. It enables storing a variable once and reference
# it from multiple variables, including variables stored in the
@@ -1643,9 +1658,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -1686,39 +1698,27 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
- "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
- "logMessageFormat": "A String", # Only relevant when action is `LOG`. Defines the message to log when
- # the breakpoint hits. The message may include parameter placeholders `$0`,
- # `$1`, etc. These placeholders are replaced with the evaluated value
- # of the appropriate expression. Expressions not referenced in
- # `log_message_format` are not logged.
- #
- # Example: `Message received, id = $0, count = $1` with
- # `expressions` = `[ message.id, message.count ]`.
- "labels": { # A set of custom breakpoint properties, populated by the agent, to be
- # displayed to the user.
- "a_key": "A String",
- },
},
],
- "nextWaitToken": "A String", # A wait token that can be used in the next call to `list` (REST) or
- # `ListBreakpoints` (RPC) to block until the list of breakpoints has changes.
}</pre>
</div>
<div class="method">
- <code class="details" id="set">set(debuggeeId, body=None, canaryOption=None, clientVersion=None, x__xgafv=None)</code>
+ <code class="details" id="set">set(debuggeeId, body=None, clientVersion=None, canaryOption=None, x__xgafv=None)</code>
<pre>Sets the breakpoint to the debuggee.
Args:
@@ -1730,12 +1730,6 @@
# ## Breakpoint (the resource)
#
# Represents the breakpoint specification, status and results.
- "expressions": [ # List of read-only expressions to evaluate at the breakpoint location.
- # The expressions are composed using expressions in the programming language
- # at the source location. If the breakpoint action is `LOG`, the evaluated
- # expressions are included in log statements.
- "A String",
- ],
"evaluatedExpressions": [ # Values of evaluated expressions at breakpoint time.
# The evaluated expressions appear in exactly the same order they
# are listed in the `expressions` field.
@@ -1852,9 +1846,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -1895,194 +1886,96 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
+ "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+ # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
+ "status": { # Represents a contextual status message. # Breakpoint status.
+ #
+ # The status includes an error flag and a human readable message.
+ # This field is usually unset. The message can be either
+ # informational or an error message. Regardless, clients should always
+ # display the text message back to the user.
+ #
+ # Error status indicates complete failure of the breakpoint.
+ #
+ # Example (non-final state): `Still loading symbols...`
+ #
+ # Examples (final state):
+ #
+ # * `Invalid line number` referring to location
+ # * `Field f not found in class C` referring to condition
+ # The message can indicate an error or informational status, and refer to
+ # specific parts of the containing object.
+ # For example, the `Breakpoint.status` field can indicate an error referring
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
+ "isError": True or False, # Distinguishes errors from informational messages.
+ "description": { # Represents a message with parameters. # Status message text.
+ "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
+ # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
+ # character.
+ #
+ # Examples:
+ #
+ # * `Failed to load '$0' which helps debug $1 the first time it
+ # is loaded. Again, $0 is very important.`
+ # * `Please pay $$10 to use $0 instead of $1.`
+ "parameters": [ # Optional parameters to be embedded into the message.
+ "A String",
+ ],
+ },
+ "refersTo": "A String", # Reference to which the message applies.
+ },
+ "expressions": [ # List of read-only expressions to evaluate at the breakpoint location.
+ # The expressions are composed using expressions in the programming language
+ # at the source location. If the breakpoint action is `LOG`, the evaluated
+ # expressions are included in log statements.
+ "A String",
+ ],
+ "labels": { # A set of custom breakpoint properties, populated by the agent, to be
+ # displayed to the user.
+ "a_key": "A String",
+ },
+ "logMessageFormat": "A String", # Only relevant when action is `LOG`. Defines the message to log when
+ # the breakpoint hits. The message may include parameter placeholders `$0`,
+ # `$1`, etc. These placeholders are replaced with the evaluated value
+ # of the appropriate expression. Expressions not referenced in
+ # `log_message_format` are not logged.
+ #
+ # Example: `Message received, id = $0, count = $1` with
+ # `expressions` = `[ message.id, message.count ]`.
+ "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+ "location": { # Represents a location in the source code. # Breakpoint source location.
+ "path": "A String", # Path to the source file within the source context of the target binary.
+ "line": 42, # Line inside the file. The first line in the file has the value `1`.
+ "column": 42, # Column within a line. The first column in a line as the value `1`.
+ # Agents that do not support setting breakpoints on specific columns ignore
+ # this field.
+ },
"isFinalState": True or False, # When true, indicates that this is a final result and the
# breakpoint state will not change from here on.
+ "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
+ "id": "A String", # Breakpoint identifier, unique in the scope of the debuggee.
+ "action": "A String", # Action that the agent should perform when the code at the
+ # breakpoint location is hit.
+ "finalTime": "A String", # Time this breakpoint was finalized as seen by the server in seconds
+ # resolution.
+ "state": "A String", # The current state of the breakpoint.
"stackFrames": [ # The stack at breakpoint time, where stack_frames[0] represents the most
# recently entered function.
{ # Represents a stack frame context.
- "locals": [ # Set of local variables at the stack frame location.
- # Note that this might not be populated for all stack frames.
- { # Represents a variable or an argument possibly of a compound object type.
- # Note how the following variables are represented:
- #
- # 1) A simple variable:
- #
- # int x = 5
- #
- # { name: "x", value: "5", type: "int" } // Captured variable
- #
- # 2) A compound object:
- #
- # struct T {
- # int m1;
- # int m2;
- # };
- # T x = { 3, 7 };
- #
- # { // Captured variable
- # name: "x",
- # type: "T",
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # 3) A pointer where the pointee was captured:
- #
- # T x = { 3, 7 };
- # T* p = &x;
- #
- # { // Captured variable
- # name: "p",
- # type: "T*",
- # value: "0x00500500",
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # 4) A pointer where the pointee was not captured:
- #
- # T* p = new T;
- #
- # { // Captured variable
- # name: "p",
- # type: "T*",
- # value: "0x00400400"
- # status { is_error: true, description { format: "unavailable" } }
- # }
- #
- # The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
- #
- # Note that a null pointer should not have members.
- #
- # 5) An unnamed value:
- #
- # int* p = new int(7);
- #
- # { // Captured variable
- # name: "p",
- # value: "0x00500500",
- # type: "int*",
- # members { value: "7", type: "int" } }
- #
- # 6) An unnamed pointer where the pointee was not captured:
- #
- # int* p = new int(7);
- # int** pp = &p;
- #
- # { // Captured variable
- # name: "pp",
- # value: "0x00500500",
- # type: "int**",
- # members {
- # value: "0x00400400",
- # type: "int*"
- # status {
- # is_error: true,
- # description: { format: "unavailable" } }
- # }
- # }
- # }
- #
- # To optimize computation, memory and network traffic, variables that
- # repeat in the output multiple times can be stored once in a shared
- # variable table and be referenced using the `var_table_index` field. The
- # variables stored in the shared table are nameless and are essentially
- # a partition of the complete variable. To reconstruct the complete
- # variable, merge the referencing variable with the referenced variable.
- #
- # When using the shared variable table, the following variables:
- #
- # T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
- #
- # { name: "x", var_table_index: 3, type: "T" } // Captured variables
- # { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
- #
- # { // Shared variable table entry #3:
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # Note that the pointer address is stored with the referencing variable
- # and not with the referenced variable. This allows the referenced variable
- # to be shared between pointers and references.
- #
- # The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
- "status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
- # unset. A status of a single variable only applies to that variable or
- # expression. The rest of breakpoint data still remains valid. Variables
- # might be reported in error state even when breakpoint is not in final
- # state.
- #
- # The message may refer to variable name with `refers_to` set to
- # `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`.
- # In either case variable value and members will be unset.
- #
- # Example of error message applied to name: `Invalid expression syntax`.
- #
- # Example of information message applied to value: `Not captured`.
- #
- # Examples of error message applied to value:
- #
- # * `Malformed string`,
- # * `Field f not found in class C`
- # * `Null pointer dereference`
- # The message can indicate an error or informational status, and refer to
- # specific parts of the containing object.
- # For example, the `Breakpoint.status` field can indicate an error referring
- # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
- "isError": True or False, # Distinguishes errors from informational messages.
- "description": { # Represents a message with parameters. # Status message text.
- "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
- # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
- # character.
- #
- # Examples:
- #
- # * `Failed to load '$0' which helps debug $1 the first time it
- # is loaded. Again, $0 is very important.`
- # * `Please pay $$10 to use $0 instead of $1.`
- "parameters": [ # Optional parameters to be embedded into the message.
- "A String",
- ],
- },
- "refersTo": "A String", # Reference to which the message applies.
- },
- "name": "A String", # Name of the variable, if any.
- "type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
- # `var_table_index`, `type` goes next to `value`. The interpretation of
- # a type is agent specific. It is recommended to include the dynamic type
- # rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
- "varTableIndex": 42, # Reference to a variable in the shared variable table. More than
- # one variable can reference the same variable in the table. The
- # `var_table_index` field is an index into `variable_table` in Breakpoint.
- },
- ],
- "location": { # Represents a location in the source code. # Source location of the call site.
- "path": "A String", # Path to the source file within the source context of the target binary.
- "column": 42, # Column within a line. The first column in a line as the value `1`.
- # Agents that do not support setting breakpoints on specific columns ignore
- # this field.
- "line": 42, # Line inside the file. The first line in the file has the value `1`.
- },
"function": "A String", # Demangled function name at the call site.
"arguments": [ # Set of arguments passed to this function.
# Note that this might not be populated for all stack frames.
@@ -2195,9 +2088,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -2238,75 +2128,198 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
+ "locals": [ # Set of local variables at the stack frame location.
+ # Note that this might not be populated for all stack frames.
+ { # Represents a variable or an argument possibly of a compound object type.
+ # Note how the following variables are represented:
+ #
+ # 1) A simple variable:
+ #
+ # int x = 5
+ #
+ # { name: "x", value: "5", type: "int" } // Captured variable
+ #
+ # 2) A compound object:
+ #
+ # struct T {
+ # int m1;
+ # int m2;
+ # };
+ # T x = { 3, 7 };
+ #
+ # { // Captured variable
+ # name: "x",
+ # type: "T",
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # 3) A pointer where the pointee was captured:
+ #
+ # T x = { 3, 7 };
+ # T* p = &x;
+ #
+ # { // Captured variable
+ # name: "p",
+ # type: "T*",
+ # value: "0x00500500",
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # 4) A pointer where the pointee was not captured:
+ #
+ # T* p = new T;
+ #
+ # { // Captured variable
+ # name: "p",
+ # type: "T*",
+ # value: "0x00400400"
+ # status { is_error: true, description { format: "unavailable" } }
+ # }
+ #
+ # The status should describe the reason for the missing value,
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ #
+ # Note that a null pointer should not have members.
+ #
+ # 5) An unnamed value:
+ #
+ # int* p = new int(7);
+ #
+ # { // Captured variable
+ # name: "p",
+ # value: "0x00500500",
+ # type: "int*",
+ # members { value: "7", type: "int" } }
+ #
+ # 6) An unnamed pointer where the pointee was not captured:
+ #
+ # int* p = new int(7);
+ # int** pp = &p;
+ #
+ # { // Captured variable
+ # name: "pp",
+ # value: "0x00500500",
+ # type: "int**",
+ # members {
+ # value: "0x00400400",
+ # type: "int*"
+ # status {
+ # is_error: true,
+ # description: { format: "unavailable" } }
+ # }
+ # }
+ # }
+ #
+ # To optimize computation, memory and network traffic, variables that
+ # repeat in the output multiple times can be stored once in a shared
+ # variable table and be referenced using the `var_table_index` field. The
+ # variables stored in the shared table are nameless and are essentially
+ # a partition of the complete variable. To reconstruct the complete
+ # variable, merge the referencing variable with the referenced variable.
+ #
+ # When using the shared variable table, the following variables:
+ #
+ # T x = { 3, 7 };
+ # T* p = &x;
+ # T& r = x;
+ #
+ # { name: "x", var_table_index: 3, type: "T" } // Captured variables
+ # { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
+ #
+ # { // Shared variable table entry #3:
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # Note that the pointer address is stored with the referencing variable
+ # and not with the referenced variable. This allows the referenced variable
+ # to be shared between pointers and references.
+ #
+ # The type field is optional. The debugger agent may or may not support it.
+ "status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
+ # unset. A status of a single variable only applies to that variable or
+ # expression. The rest of breakpoint data still remains valid. Variables
+ # might be reported in error state even when breakpoint is not in final
+ # state.
+ #
+ # The message may refer to variable name with `refers_to` set to
+ # `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`.
+ # In either case variable value and members will be unset.
+ #
+ # Example of error message applied to name: `Invalid expression syntax`.
+ #
+ # Example of information message applied to value: `Not captured`.
+ #
+ # Examples of error message applied to value:
+ #
+ # * `Malformed string`,
+ # * `Field f not found in class C`
+ # * `Null pointer dereference`
+ # The message can indicate an error or informational status, and refer to
+ # specific parts of the containing object.
+ # For example, the `Breakpoint.status` field can indicate an error referring
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
+ "isError": True or False, # Distinguishes errors from informational messages.
+ "description": { # Represents a message with parameters. # Status message text.
+ "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
+ # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
+ # character.
+ #
+ # Examples:
+ #
+ # * `Failed to load '$0' which helps debug $1 the first time it
+ # is loaded. Again, $0 is very important.`
+ # * `Please pay $$10 to use $0 instead of $1.`
+ "parameters": [ # Optional parameters to be embedded into the message.
+ "A String",
+ ],
+ },
+ "refersTo": "A String", # Reference to which the message applies.
+ },
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
+ "type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
+ # `var_table_index`, `type` goes next to `value`. The interpretation of
+ # a type is agent specific. It is recommended to include the dynamic type
+ # rather than a static type of an object.
+ "name": "A String", # Name of the variable, if any.
+ "varTableIndex": 42, # Reference to a variable in the shared variable table. More than
+ # one variable can reference the same variable in the table. The
+ # `var_table_index` field is an index into `variable_table` in Breakpoint.
+ },
+ ],
+ "location": { # Represents a location in the source code. # Source location of the call site.
+ "path": "A String", # Path to the source file within the source context of the target binary.
+ "line": 42, # Line inside the file. The first line in the file has the value `1`.
+ "column": 42, # Column within a line. The first column in a line as the value `1`.
+ # Agents that do not support setting breakpoints on specific columns ignore
+ # this field.
+ },
},
],
+ "userEmail": "A String", # E-mail address of the user that created this breakpoint
"condition": "A String", # Condition that triggers the breakpoint.
# The condition is a compound boolean expression composed using expressions
# in a programming language at the source location.
- "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
- # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
- "status": { # Represents a contextual status message. # Breakpoint status.
- #
- # The status includes an error flag and a human readable message.
- # This field is usually unset. The message can be either
- # informational or an error message. Regardless, clients should always
- # display the text message back to the user.
- #
- # Error status indicates complete failure of the breakpoint.
- #
- # Example (non-final state): `Still loading symbols...`
- #
- # Examples (final state):
- #
- # * `Invalid line number` referring to location
- # * `Field f not found in class C` referring to condition
- # The message can indicate an error or informational status, and refer to
- # specific parts of the containing object.
- # For example, the `Breakpoint.status` field can indicate an error referring
- # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
- "isError": True or False, # Distinguishes errors from informational messages.
- "description": { # Represents a message with parameters. # Status message text.
- "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
- # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
- # character.
- #
- # Examples:
- #
- # * `Failed to load '$0' which helps debug $1 the first time it
- # is loaded. Again, $0 is very important.`
- # * `Please pay $$10 to use $0 instead of $1.`
- "parameters": [ # Optional parameters to be embedded into the message.
- "A String",
- ],
- },
- "refersTo": "A String", # Reference to which the message applies.
- },
- "state": "A String", # The current state of the breakpoint.
- "userEmail": "A String", # E-mail address of the user that created this breakpoint
- "action": "A String", # Action that the agent should perform when the code at the
- # breakpoint location is hit.
- "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
- "id": "A String", # Breakpoint identifier, unique in the scope of the debuggee.
- "location": { # Represents a location in the source code. # Breakpoint source location.
- "path": "A String", # Path to the source file within the source context of the target binary.
- "column": 42, # Column within a line. The first column in a line as the value `1`.
- # Agents that do not support setting breakpoints on specific columns ignore
- # this field.
- "line": 42, # Line inside the file. The first line in the file has the value `1`.
- },
- "finalTime": "A String", # Time this breakpoint was finalized as seen by the server in seconds
- # resolution.
"variableTable": [ # The `variable_table` exists to aid with computation, memory and network
# traffic optimization. It enables storing a variable once and reference
# it from multiple variables, including variables stored in the
@@ -2428,9 +2441,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -2471,35 +2481,25 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
- "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
- "logMessageFormat": "A String", # Only relevant when action is `LOG`. Defines the message to log when
- # the breakpoint hits. The message may include parameter placeholders `$0`,
- # `$1`, etc. These placeholders are replaced with the evaluated value
- # of the appropriate expression. Expressions not referenced in
- # `log_message_format` are not logged.
- #
- # Example: `Message received, id = $0, count = $1` with
- # `expressions` = `[ message.id, message.count ]`.
- "labels": { # A set of custom breakpoint properties, populated by the agent, to be
- # displayed to the user.
- "a_key": "A String",
- },
}
- canaryOption: string, The canary option set by the user upon setting breakpoint.
clientVersion: string, Required. The client version making the call.
Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
+ canaryOption: string, The canary option set by the user upon setting breakpoint.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -2514,12 +2514,6 @@
# ## Breakpoint (the resource)
#
# Represents the breakpoint specification, status and results.
- "expressions": [ # List of read-only expressions to evaluate at the breakpoint location.
- # The expressions are composed using expressions in the programming language
- # at the source location. If the breakpoint action is `LOG`, the evaluated
- # expressions are included in log statements.
- "A String",
- ],
"evaluatedExpressions": [ # Values of evaluated expressions at breakpoint time.
# The evaluated expressions appear in exactly the same order they
# are listed in the `expressions` field.
@@ -2636,9 +2630,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -2679,194 +2670,96 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
+ "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+ # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
+ "status": { # Represents a contextual status message. # Breakpoint status.
+ #
+ # The status includes an error flag and a human readable message.
+ # This field is usually unset. The message can be either
+ # informational or an error message. Regardless, clients should always
+ # display the text message back to the user.
+ #
+ # Error status indicates complete failure of the breakpoint.
+ #
+ # Example (non-final state): `Still loading symbols...`
+ #
+ # Examples (final state):
+ #
+ # * `Invalid line number` referring to location
+ # * `Field f not found in class C` referring to condition
+ # The message can indicate an error or informational status, and refer to
+ # specific parts of the containing object.
+ # For example, the `Breakpoint.status` field can indicate an error referring
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
+ "isError": True or False, # Distinguishes errors from informational messages.
+ "description": { # Represents a message with parameters. # Status message text.
+ "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
+ # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
+ # character.
+ #
+ # Examples:
+ #
+ # * `Failed to load '$0' which helps debug $1 the first time it
+ # is loaded. Again, $0 is very important.`
+ # * `Please pay $$10 to use $0 instead of $1.`
+ "parameters": [ # Optional parameters to be embedded into the message.
+ "A String",
+ ],
+ },
+ "refersTo": "A String", # Reference to which the message applies.
+ },
+ "expressions": [ # List of read-only expressions to evaluate at the breakpoint location.
+ # The expressions are composed using expressions in the programming language
+ # at the source location. If the breakpoint action is `LOG`, the evaluated
+ # expressions are included in log statements.
+ "A String",
+ ],
+ "labels": { # A set of custom breakpoint properties, populated by the agent, to be
+ # displayed to the user.
+ "a_key": "A String",
+ },
+ "logMessageFormat": "A String", # Only relevant when action is `LOG`. Defines the message to log when
+ # the breakpoint hits. The message may include parameter placeholders `$0`,
+ # `$1`, etc. These placeholders are replaced with the evaluated value
+ # of the appropriate expression. Expressions not referenced in
+ # `log_message_format` are not logged.
+ #
+ # Example: `Message received, id = $0, count = $1` with
+ # `expressions` = `[ message.id, message.count ]`.
+ "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+ "location": { # Represents a location in the source code. # Breakpoint source location.
+ "path": "A String", # Path to the source file within the source context of the target binary.
+ "line": 42, # Line inside the file. The first line in the file has the value `1`.
+ "column": 42, # Column within a line. The first column in a line as the value `1`.
+ # Agents that do not support setting breakpoints on specific columns ignore
+ # this field.
+ },
"isFinalState": True or False, # When true, indicates that this is a final result and the
# breakpoint state will not change from here on.
+ "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
+ "id": "A String", # Breakpoint identifier, unique in the scope of the debuggee.
+ "action": "A String", # Action that the agent should perform when the code at the
+ # breakpoint location is hit.
+ "finalTime": "A String", # Time this breakpoint was finalized as seen by the server in seconds
+ # resolution.
+ "state": "A String", # The current state of the breakpoint.
"stackFrames": [ # The stack at breakpoint time, where stack_frames[0] represents the most
# recently entered function.
{ # Represents a stack frame context.
- "locals": [ # Set of local variables at the stack frame location.
- # Note that this might not be populated for all stack frames.
- { # Represents a variable or an argument possibly of a compound object type.
- # Note how the following variables are represented:
- #
- # 1) A simple variable:
- #
- # int x = 5
- #
- # { name: "x", value: "5", type: "int" } // Captured variable
- #
- # 2) A compound object:
- #
- # struct T {
- # int m1;
- # int m2;
- # };
- # T x = { 3, 7 };
- #
- # { // Captured variable
- # name: "x",
- # type: "T",
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # 3) A pointer where the pointee was captured:
- #
- # T x = { 3, 7 };
- # T* p = &x;
- #
- # { // Captured variable
- # name: "p",
- # type: "T*",
- # value: "0x00500500",
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # 4) A pointer where the pointee was not captured:
- #
- # T* p = new T;
- #
- # { // Captured variable
- # name: "p",
- # type: "T*",
- # value: "0x00400400"
- # status { is_error: true, description { format: "unavailable" } }
- # }
- #
- # The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
- #
- # Note that a null pointer should not have members.
- #
- # 5) An unnamed value:
- #
- # int* p = new int(7);
- #
- # { // Captured variable
- # name: "p",
- # value: "0x00500500",
- # type: "int*",
- # members { value: "7", type: "int" } }
- #
- # 6) An unnamed pointer where the pointee was not captured:
- #
- # int* p = new int(7);
- # int** pp = &p;
- #
- # { // Captured variable
- # name: "pp",
- # value: "0x00500500",
- # type: "int**",
- # members {
- # value: "0x00400400",
- # type: "int*"
- # status {
- # is_error: true,
- # description: { format: "unavailable" } }
- # }
- # }
- # }
- #
- # To optimize computation, memory and network traffic, variables that
- # repeat in the output multiple times can be stored once in a shared
- # variable table and be referenced using the `var_table_index` field. The
- # variables stored in the shared table are nameless and are essentially
- # a partition of the complete variable. To reconstruct the complete
- # variable, merge the referencing variable with the referenced variable.
- #
- # When using the shared variable table, the following variables:
- #
- # T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
- #
- # { name: "x", var_table_index: 3, type: "T" } // Captured variables
- # { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
- #
- # { // Shared variable table entry #3:
- # members { name: "m1", value: "3", type: "int" },
- # members { name: "m2", value: "7", type: "int" }
- # }
- #
- # Note that the pointer address is stored with the referencing variable
- # and not with the referenced variable. This allows the referenced variable
- # to be shared between pointers and references.
- #
- # The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
- "status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
- # unset. A status of a single variable only applies to that variable or
- # expression. The rest of breakpoint data still remains valid. Variables
- # might be reported in error state even when breakpoint is not in final
- # state.
- #
- # The message may refer to variable name with `refers_to` set to
- # `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`.
- # In either case variable value and members will be unset.
- #
- # Example of error message applied to name: `Invalid expression syntax`.
- #
- # Example of information message applied to value: `Not captured`.
- #
- # Examples of error message applied to value:
- #
- # * `Malformed string`,
- # * `Field f not found in class C`
- # * `Null pointer dereference`
- # The message can indicate an error or informational status, and refer to
- # specific parts of the containing object.
- # For example, the `Breakpoint.status` field can indicate an error referring
- # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
- "isError": True or False, # Distinguishes errors from informational messages.
- "description": { # Represents a message with parameters. # Status message text.
- "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
- # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
- # character.
- #
- # Examples:
- #
- # * `Failed to load '$0' which helps debug $1 the first time it
- # is loaded. Again, $0 is very important.`
- # * `Please pay $$10 to use $0 instead of $1.`
- "parameters": [ # Optional parameters to be embedded into the message.
- "A String",
- ],
- },
- "refersTo": "A String", # Reference to which the message applies.
- },
- "name": "A String", # Name of the variable, if any.
- "type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
- # `var_table_index`, `type` goes next to `value`. The interpretation of
- # a type is agent specific. It is recommended to include the dynamic type
- # rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
- "varTableIndex": 42, # Reference to a variable in the shared variable table. More than
- # one variable can reference the same variable in the table. The
- # `var_table_index` field is an index into `variable_table` in Breakpoint.
- },
- ],
- "location": { # Represents a location in the source code. # Source location of the call site.
- "path": "A String", # Path to the source file within the source context of the target binary.
- "column": 42, # Column within a line. The first column in a line as the value `1`.
- # Agents that do not support setting breakpoints on specific columns ignore
- # this field.
- "line": 42, # Line inside the file. The first line in the file has the value `1`.
- },
"function": "A String", # Demangled function name at the call site.
"arguments": [ # Set of arguments passed to this function.
# Note that this might not be populated for all stack frames.
@@ -2979,9 +2872,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -3022,75 +2912,198 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
+ "locals": [ # Set of local variables at the stack frame location.
+ # Note that this might not be populated for all stack frames.
+ { # Represents a variable or an argument possibly of a compound object type.
+ # Note how the following variables are represented:
+ #
+ # 1) A simple variable:
+ #
+ # int x = 5
+ #
+ # { name: "x", value: "5", type: "int" } // Captured variable
+ #
+ # 2) A compound object:
+ #
+ # struct T {
+ # int m1;
+ # int m2;
+ # };
+ # T x = { 3, 7 };
+ #
+ # { // Captured variable
+ # name: "x",
+ # type: "T",
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # 3) A pointer where the pointee was captured:
+ #
+ # T x = { 3, 7 };
+ # T* p = &x;
+ #
+ # { // Captured variable
+ # name: "p",
+ # type: "T*",
+ # value: "0x00500500",
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # 4) A pointer where the pointee was not captured:
+ #
+ # T* p = new T;
+ #
+ # { // Captured variable
+ # name: "p",
+ # type: "T*",
+ # value: "0x00400400"
+ # status { is_error: true, description { format: "unavailable" } }
+ # }
+ #
+ # The status should describe the reason for the missing value,
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ #
+ # Note that a null pointer should not have members.
+ #
+ # 5) An unnamed value:
+ #
+ # int* p = new int(7);
+ #
+ # { // Captured variable
+ # name: "p",
+ # value: "0x00500500",
+ # type: "int*",
+ # members { value: "7", type: "int" } }
+ #
+ # 6) An unnamed pointer where the pointee was not captured:
+ #
+ # int* p = new int(7);
+ # int** pp = &p;
+ #
+ # { // Captured variable
+ # name: "pp",
+ # value: "0x00500500",
+ # type: "int**",
+ # members {
+ # value: "0x00400400",
+ # type: "int*"
+ # status {
+ # is_error: true,
+ # description: { format: "unavailable" } }
+ # }
+ # }
+ # }
+ #
+ # To optimize computation, memory and network traffic, variables that
+ # repeat in the output multiple times can be stored once in a shared
+ # variable table and be referenced using the `var_table_index` field. The
+ # variables stored in the shared table are nameless and are essentially
+ # a partition of the complete variable. To reconstruct the complete
+ # variable, merge the referencing variable with the referenced variable.
+ #
+ # When using the shared variable table, the following variables:
+ #
+ # T x = { 3, 7 };
+ # T* p = &x;
+ # T& r = x;
+ #
+ # { name: "x", var_table_index: 3, type: "T" } // Captured variables
+ # { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
+ #
+ # { // Shared variable table entry #3:
+ # members { name: "m1", value: "3", type: "int" },
+ # members { name: "m2", value: "7", type: "int" }
+ # }
+ #
+ # Note that the pointer address is stored with the referencing variable
+ # and not with the referenced variable. This allows the referenced variable
+ # to be shared between pointers and references.
+ #
+ # The type field is optional. The debugger agent may or may not support it.
+ "status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
+ # unset. A status of a single variable only applies to that variable or
+ # expression. The rest of breakpoint data still remains valid. Variables
+ # might be reported in error state even when breakpoint is not in final
+ # state.
+ #
+ # The message may refer to variable name with `refers_to` set to
+ # `VARIABLE_NAME`. Alternatively `refers_to` will be set to `VARIABLE_VALUE`.
+ # In either case variable value and members will be unset.
+ #
+ # Example of error message applied to name: `Invalid expression syntax`.
+ #
+ # Example of information message applied to value: `Not captured`.
+ #
+ # Examples of error message applied to value:
+ #
+ # * `Malformed string`,
+ # * `Field f not found in class C`
+ # * `Null pointer dereference`
+ # The message can indicate an error or informational status, and refer to
+ # specific parts of the containing object.
+ # For example, the `Breakpoint.status` field can indicate an error referring
+ # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
+ "isError": True or False, # Distinguishes errors from informational messages.
+ "description": { # Represents a message with parameters. # Status message text.
+ "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
+ # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
+ # character.
+ #
+ # Examples:
+ #
+ # * `Failed to load '$0' which helps debug $1 the first time it
+ # is loaded. Again, $0 is very important.`
+ # * `Please pay $$10 to use $0 instead of $1.`
+ "parameters": [ # Optional parameters to be embedded into the message.
+ "A String",
+ ],
+ },
+ "refersTo": "A String", # Reference to which the message applies.
+ },
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
+ "type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
+ # `var_table_index`, `type` goes next to `value`. The interpretation of
+ # a type is agent specific. It is recommended to include the dynamic type
+ # rather than a static type of an object.
+ "name": "A String", # Name of the variable, if any.
+ "varTableIndex": 42, # Reference to a variable in the shared variable table. More than
+ # one variable can reference the same variable in the table. The
+ # `var_table_index` field is an index into `variable_table` in Breakpoint.
+ },
+ ],
+ "location": { # Represents a location in the source code. # Source location of the call site.
+ "path": "A String", # Path to the source file within the source context of the target binary.
+ "line": 42, # Line inside the file. The first line in the file has the value `1`.
+ "column": 42, # Column within a line. The first column in a line as the value `1`.
+ # Agents that do not support setting breakpoints on specific columns ignore
+ # this field.
+ },
},
],
+ "userEmail": "A String", # E-mail address of the user that created this breakpoint
"condition": "A String", # Condition that triggers the breakpoint.
# The condition is a compound boolean expression composed using expressions
# in a programming language at the source location.
- "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
- # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
- "status": { # Represents a contextual status message. # Breakpoint status.
- #
- # The status includes an error flag and a human readable message.
- # This field is usually unset. The message can be either
- # informational or an error message. Regardless, clients should always
- # display the text message back to the user.
- #
- # Error status indicates complete failure of the breakpoint.
- #
- # Example (non-final state): `Still loading symbols...`
- #
- # Examples (final state):
- #
- # * `Invalid line number` referring to location
- # * `Field f not found in class C` referring to condition
- # The message can indicate an error or informational status, and refer to
- # specific parts of the containing object.
- # For example, the `Breakpoint.status` field can indicate an error referring
- # to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
- "isError": True or False, # Distinguishes errors from informational messages.
- "description": { # Represents a message with parameters. # Status message text.
- "format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
- # `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
- # character.
- #
- # Examples:
- #
- # * `Failed to load '$0' which helps debug $1 the first time it
- # is loaded. Again, $0 is very important.`
- # * `Please pay $$10 to use $0 instead of $1.`
- "parameters": [ # Optional parameters to be embedded into the message.
- "A String",
- ],
- },
- "refersTo": "A String", # Reference to which the message applies.
- },
- "state": "A String", # The current state of the breakpoint.
- "userEmail": "A String", # E-mail address of the user that created this breakpoint
- "action": "A String", # Action that the agent should perform when the code at the
- # breakpoint location is hit.
- "logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
- "id": "A String", # Breakpoint identifier, unique in the scope of the debuggee.
- "location": { # Represents a location in the source code. # Breakpoint source location.
- "path": "A String", # Path to the source file within the source context of the target binary.
- "column": 42, # Column within a line. The first column in a line as the value `1`.
- # Agents that do not support setting breakpoints on specific columns ignore
- # this field.
- "line": 42, # Line inside the file. The first line in the file has the value `1`.
- },
- "finalTime": "A String", # Time this breakpoint was finalized as seen by the server in seconds
- # resolution.
"variableTable": [ # The `variable_table` exists to aid with computation, memory and network
# traffic optimization. It enables storing a variable once and reference
# it from multiple variables, including variables stored in the
@@ -3212,9 +3225,6 @@
# to be shared between pointers and references.
#
# The type field is optional. The debugger agent may or may not support it.
- "members": [ # Members contained or pointed to by the variable.
- # Object with schema name: Variable
- ],
"status": { # Represents a contextual status message. # Status associated with the variable. This field will usually stay
# unset. A status of a single variable only applies to that variable or
# expression. The rest of breakpoint data still remains valid. Variables
@@ -3255,30 +3265,20 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
- "name": "A String", # Name of the variable, if any.
+ "value": "A String", # Simple value of the variable.
+ "members": [ # Members contained or pointed to by the variable.
+ # Object with schema name: Variable
+ ],
"type": "A String", # Variable type (e.g. `MyClass`). If the variable is split with
# `var_table_index`, `type` goes next to `value`. The interpretation of
# a type is agent specific. It is recommended to include the dynamic type
# rather than a static type of an object.
- "value": "A String", # Simple value of the variable.
+ "name": "A String", # Name of the variable, if any.
"varTableIndex": 42, # Reference to a variable in the shared variable table. More than
# one variable can reference the same variable in the table. The
# `var_table_index` field is an index into `variable_table` in Breakpoint.
},
],
- "createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
- "logMessageFormat": "A String", # Only relevant when action is `LOG`. Defines the message to log when
- # the breakpoint hits. The message may include parameter placeholders `$0`,
- # `$1`, etc. These placeholders are replaced with the evaluated value
- # of the appropriate expression. Expressions not referenced in
- # `log_message_format` are not logged.
- #
- # Example: `Message received, id = $0, count = $1` with
- # `expressions` = `[ message.id, message.count ]`.
- "labels": { # A set of custom breakpoint properties, populated by the agent, to be
- # displayed to the user.
- "a_key": "A String",
- },
},
}</pre>
</div>