Table of contents

    Soft Debugger Wire Format

    Introduction

    The Mono Soft Debugger (SDB) is a debugger implemented by the Mono runtime. The Mono runtime exposes an interface that debugger clients can use to debug a Mono application. Mono provides a convenience library in the form of the Mono.Debugger.Soft.dll that can be used to communicate with a running Mono process.

    The Mono.Debugger.Soft.dll library uses a protocol over sockets to debug applications. The wire protocol is inspired by the JDWP (Java Debug Wire Protocol). Familiarity with that specification is a good read.

    This document describes the wire protocol used between debugging clients and the Mono runtime.

    Where possible, the corresponding protocol detail is linked to a function name and file location in Mono source code. These informations are based on Mono master version at revision f42ba4a168e7cb9b9486b8a96c53752e4467be8a.

    Protocol details

    Transport

    Mono SDB protocol, just like its Java counterpart, was designed with no specific transport in mind. However, presently the public Mono SDB only has a TCP/IP transport available (under the transport name of dt_socket). Other transports can be plugged by modifying this interface.

    Bootstraping a connection

    To boostrap a connection, the client send handshake to the server (see debugger-agent.c:1034) in the form of the 13 ASCII characters string “DWP-Handshake” and wait for the server reply which consist of the exact same ASCII character sequence.

    Packets

    Just like JDWP, Mono SDB protocol is packet-based with two types of packet: command and reply. All fields in a packet is sent in big-endian format which is transparently handled in Mono source code with corresponding helper encode/decode functions.

    Command packet are used by either side (client or server) to request information, act on the execution of the debugged program or to inform of some event. Replies is only sent in response to a command with information on the success/failure of the operation and any extra data depending on the command that triggered it.

    Both type of packet contains a header. The header is always 11 bytes long. Their descriptions are given afterwards:

    Command packet header
    byte 1 byte 2 byte 3 byte 4 byte 5 byte 6 byte 7 byte 8 byte 9 byte 10 byte 11
    length id flags command set command

    In Mono SDB source code, the command header is decoded in the server thread debugger_thread function at debugger-agent.c:7583.

    Reply packet header
    byte 1 byte 2 byte 3 byte 4 byte 5 byte 6 byte 7 byte 8 byte 9 byte 10 byte 11
    length id flags error code

    In Mono SDB source code, a reply packet is constructed and sent by the send_reply_packet function in debugger-agent:1514.

    Packet field details

    Common fields

    length
    The total length in byte of the packet including header i.e. this value will be 11 if the packet only consists of header with no other data
    id
    Uniquely identify sent packet command/reply pair so that they can be asynchronously matched. This is in practise a simple monotonic integer counter. Note that client and server may use the same id value when sending their packets as the uniqueness property is only with respect to a specific source.
    flags
    At the moment this value is only used with a reply packet in which case its value is set to 0x80. A command packet should have this value set to 0.

    Command specific fields

    command set
    This value allows grouping commands into similar blocks for quicker processing. The different command sets with their values are given below:
    Command set Value
    Virtual Machine 1
    Object reference 9
    String reference 10
    Threads 11
    Array reference 13
    Event request 15
    Stack frame 16
    AppDomain 20
    Assembly 21
    Method 22
    Type 23
    Module 24
    Events 64
    command
    Tell what command this packet corresponds to. This value is relative to the previously defined command set so the values are reused across different command sets. Definition of each command is given in a later chapter.

    Reply specific fields

    error code
    Define which error occured or if the command was successful. Error code definition is given below:
    Error name Value Mono specific notes
    Success 0  
    Invalid object 20  
    Invalid field ID 25  
    Invalid frame ID 30  
    Not Implemented 100  
    Not Suspended 101  
    Invalid argument 102  
    Unloaded 103 AppDomain has been unloaded
    No Invocation 104 Returned when trying to abort a thread which isn’t in a runtime invocation
    Absent information 105 Returned when a requested method debug information isn’t available
    No seq point at IL Offset 106 Returned when a breakpoint couldn’t be set

    Data type marshalling

    Name Size Description
    byte 1 byte A byte value
    short 2 byte A UInt16 value
    int 4 bytes A UInt32 value
    long 8 bytes A UInt64 value
    id 4 bytes The same size is used for all IDs (ObjectID, PointerID, TypeId, MethodID, AssemblyID, ModuleID, FieldID, PropertyID, DomainID)
    string At least 4 bytes A string consists of a leading int value giving the string size followed by size bytes of character data. Thus an empty string is simply a 4 bytes integer value of 0
    variant At least 1 byte A variant type is a special value which consists of a leading byte giving away the MonoType information of the variant followed directly by its raw value.
    boolean 4 bytes (an int) Tough not strictly a type, a boolean is represented by an int value whose value is 1 for true and 0 for false.

    Most of the encoding function for these types are defined as buffer_add_* functions starting from debugger-agent.c:1429. Their counterpart are of the form decode_* starting from debugger-agent.c:1349.

    A lot command returns or accepts fixed-length list of value. In these case, such a list is always prefixed with an int value giving its length followed by length element of the same type (which needs to be inferred from the context). When such a list is used the term “list” will be used. For clarification, an empty list is thus a single int value equals to 0.

    Various enumeration value definition

    For the record, the following C enumerations define the values used for flags, kind, … parameters in some commands.

    typedef enum {
        EVENT_KIND_VM_START = 0,
        EVENT_KIND_VM_DEATH = 1,
        EVENT_KIND_THREAD_START = 2,
        EVENT_KIND_THREAD_DEATH = 3,
        EVENT_KIND_APPDOMAIN_CREATE = 4,
        EVENT_KIND_APPDOMAIN_UNLOAD = 5,
        EVENT_KIND_METHOD_ENTRY = 6,
        EVENT_KIND_METHOD_EXIT = 7,
        EVENT_KIND_ASSEMBLY_LOAD = 8,
        EVENT_KIND_ASSEMBLY_UNLOAD = 9,
        EVENT_KIND_BREAKPOINT = 10,
        EVENT_KIND_STEP = 11,
        EVENT_KIND_TYPE_LOAD = 12,
        EVENT_KIND_EXCEPTION = 13,
        EVENT_KIND_KEEPALIVE = 14,
        EVENT_KIND_USER_BREAK = 15,
        EVENT_KIND_USER_LOG = 16
    } EventKind;
     
    typedef enum {
        SUSPEND_POLICY_NONE = 0,
        SUSPEND_POLICY_EVENT_THREAD = 1,
        SUSPEND_POLICY_ALL = 2
    } SuspendPolicy;
     
    typedef enum {
        MOD_KIND_COUNT = 1,
        MOD_KIND_THREAD_ONLY = 3,
        MOD_KIND_LOCATION_ONLY = 7,
        MOD_KIND_EXCEPTION_ONLY = 8,
        MOD_KIND_STEP = 10,
        MOD_KIND_ASSEMBLY_ONLY = 11,
        MOD_KIND_SOURCE_FILE_ONLY = 12,
        MOD_KIND_TYPE_NAME_ONLY = 13,
        MOD_KIND_NONE = 14
    } ModifierKind;
     
    typedef enum {
        STEP_DEPTH_INTO = 0,
        STEP_DEPTH_OVER = 1,
        STEP_DEPTH_OUT = 2
    } StepDepth;
     
    typedef enum {
        STEP_SIZE_MIN = 0,
        STEP_SIZE_LINE = 1
    } StepSize;
     
    typedef enum {
        TOKEN_TYPE_STRING = 0,
        TOKEN_TYPE_TYPE = 1,
        TOKEN_TYPE_FIELD = 2,
        TOKEN_TYPE_METHOD = 3,
        TOKEN_TYPE_UNKNOWN = 4
    } DebuggerTokenType;
     
    typedef enum {
        VALUE_TYPE_ID_NULL = 0xf0,
        VALUE_TYPE_ID_TYPE = 0xf1,
        VALUE_TYPE_ID_PARENT_VTYPE = 0xf2
    } ValueTypeId;
     
    typedef enum {
        FRAME_FLAG_DEBUGGER_INVOKE = 1,
    
        // Use to allow the debugger to display managed-to-native transitions in stack frames.
        FRAME_FLAG_NATIVE_TRANSITION = 2
    } StackFrameFlags;
     
    typedef enum {
        INVOKE_FLAG_DISABLE_BREAKPOINTS = 1,
        INVOKE_FLAG_SINGLE_THREADED = 2,
    
        // Allow for returning the changed value types after an invocation
        INVOKE_FLAG_RETURN_OUT_THIS = 4,
    
        // Allows the return of modified value types after invocation
        INVOKE_FLAG_RETURN_OUT_ARGS = 8,
    
        // Performs a virtual method invocation
        INVOKE_FLAG_VIRTUAL = 16
    } InvokeFlags;
    

    Command list

    Types given in each command comments corresponds to the type described above. When there are additional arguments or multiple values in a command’s reply, they are each time described in the order they appear or have to appear in the data part. Not also that there is no kind of separation sequence or added alignement padding between each value.

    In all cases, if you ask for a command that doesn’t exist, a reply will be sent with an error code of NOT_IMPLEMENTED.

    Virtual machine commands

    Name Value Action and type of reply Additional parameters Possible error code returned
    VERSION 1 Returns a mono virtual machine version information (string) followed by two int giving respectively the runtime major and minor version None None
    ALL_THREADS 2 Returns a list of ObjectID each mapping to a System.Threading.Thread instance. None None
    SUSPEND 3 Suspend the VM execution and returns an empty reply None None
    RESUME 4 Resume the VM execution and returns an empty reply None NOT_SUSPENDED
    EXIT 5 Stop VM and returns an empty reply Ask for a exit code (int) to be used by the VM when it exits None
    DISPOSE 6 Clear event requests, resume the VM and disconnect None None
    INVOKE_METHOD 7 Returns a boolean telling if the call was successful followed by an exception object (as a variant) if it was not and by the actual returned value (variant) if it was. Ask for an ObjectID (id) mapping to a System.Threading.Thread instance, a flags value (int) to pass to the invoke request, the MethodID (id) of the method to invoke, a variant value to be used as this (VALUE_TYPE_ID_NULL in case of a valuetype) and a list of variant value representing the parameters of the method. INVALID_OBJECT, NOT_SUSPENDED, INVALID_METHODID, INVALID_ARGUMENT
    SET_PROTOCOL_VERSION 8 Returns an empty reply Ask for two int giving respectively the major and minor version of the procotol to use. None
    ABORT_INVOKE 9 Abort the invocation and returns an empty reply Ask for an ObjectID (id) mapping to a System.Threading.Thread instance and the id (int) of the command packet that set up the invocation to cancel INVALID_OBJECT, NO_INVOCATION
    SET_KEEPALIVE 10 Set up the new keep alive value and returns an empty reply Ask for a timeout value (int) None
    GET_TYPES_FOR_SOURCE_FILE 11 Returns a list of TypeID (id) of class defined inside the supplied file name Ask for a file name (string) and an ignore case flag (byte) although setting it to something different than 0 isn’t currently supported. None
    GET_TYPES 12 Returns a list of TypeID (id) of type which corresponds to the provided type name Ask for type name (string) and a ignore case flag (byte) which acts like a boolean value INVALID_ARGUMENT
    INVOKE_METHODS 13 Batch invocation of methods Ask for an ObjectID (id) mapping to a System.Threading.Thread instance, a flags value (int) to pass to the invoke request, the number of methods to invoke (int), and for each method the the MethodID (id) for each method to invoke, a variant value to be used as this (VALUE_TYPE_ID_NULL in case of a valuetype) and a list of variant value representing the parameters of the method. INVALID_OBJECT, NOT_SUSPENDED, INVALID_METHODID, INVALID_ARGUMENT
    VM_START_BUFFERING 14 Initiates the buffering of reply packets to improve latency. Must be paired with a VM_STOP_BUFFERING command None None
    VM_STOP_BUFFERING 15 Ends the block of buffered commands, must come after a call to VM_START_BUFFERING None None

    The main function handling these commands is vm_commands and is situated at debugger-agent.c:5671

    Events commands

    Events allows the debuggee to act on program execution (stepping) and also to set up things like breakpoints, watchpoints, exception catching, etc.

    Name Value Type of reply Additional parameters Possible error code returned
    REQUEST_SET 1 Returns the request id (int) Ask for 3 bytes giving the event kind (EventKind enumeration), suspend policy (SuspendPolicy enumeration) and a list of modifiers which content is context dependent and given in the table below INVALID_METHODID, INVALID_TYPEID, NO_SEQ_POINT_AT_IL_OFFSET, INVALID_OBJECT, INVALID_ASSEMBLYID
    REQUEST_CLEAR 2 Clear the requested event and returns an empty reply Ask for an event type (byte) and a request id (int) None
    REQUEST_CLEAR_ALL_BREAKPOINTS 3 Returns an empty reply None None

    The main function handling these commands is event_commands and is situated at debugger-agent.c:5916

    Each modifier has the first byte describing the modification it’s carrying out and corresponding to the values found in the ModifierKind enumeration. The following table list the remaining body depending on the modification value.

    Mod value Body
    COUNT a MethodID (id)
    LOCATION_ONLY a MethodID (id) and a location information (long)
    STEP A thread id, size of the step (int) corresponding to the StepSize enumeration and depth of it (int) corresponding to the StepDepth enumeration
    THREAD_ONLY A thread id
    EXCEPTION_ONLY A TypeID representing a exception type and two byte values setting respectively the caught and uncaught filter
    ASSEMBLY_ONLY A list of AssemblyID (id)
    SOURCE_FILE_ONLY A list of source file name (string)
    TYPE_NAME_ONLY A list of type name (string)
    NONE  

    Thread commands

    Each command requires at least one ObjectID (of type id) parameter mapping to a thread instance before any additional parameter the command may require.

    Name Value Type of reply Additional parameters Possible error code returned
    GET_FRAME_INFO 1 Returns a list of quadruplet of frame ID (int), MethodID (id), IL offset (int) and frame flags (byte) Ask for a start frame (currently other value than 0 aren’t supported) as an int and a length as a int INVALID_OBJECT
    GET_NAME 2 Returns the name of the thread as a string None INVALID_OBJECT
    GET_STATE 3 Return the thread state as an int None INVALID_OBJECT
    GET_INFO 4 Returns a byte value telling if the thread is a threadpool thread (1) or not (0) None INVALID_OBJECT
    GET_ID 5 Returns the thread id (address of the object) as a long None INVALID_OBJECT
    GET_TID 6 Returns the proper thread id (or TID) as a long None INVALID_OBJECT
    SET_IP 7 Set the location where execution will return when this thread is resumed Thread ID (int), Method ID (long), IL offset (long) INVALID_ARGUMENT

    The main function handling these commands is thread_commands and is situated at debugger-agent.c:6991

    AppDomains commands

    Name Value Type of reply Additional parameters Possible error code returned
    GET_ROOT_DOMAIN 1 Returns the DomainID of the root domain None None
    GET_FRIENDLY_NAME 2 Returns the friendly name as a string of the provided DomainID Ask for a DomainID (id) INVALID_DOMAINID
    GET_ASSEMBLIES 3 Returns a list of AssemblyID contained inside this AppDomain Ask for a DomainID (id) INVALID_DOMAINID
    GET_ENTRY_ASSEMBLY 4 Returns the entry AssemblyID of this domain Ask for a DomainID (id) INVALID_DOMAINID
    CREATE_STRING 5 Returns the ObjectID of the created string Ask for a DomainID (id) where to create the new string and a string typed value to put inside the domain INVALID_DOMAINID
    GET_CORLIB 6 Returns the AssemblyID of the load corlib inside this AppDomain Ask for a DomainID (id) INVALID_DOMAINID
    CREATE_BOXED_VALUE 7 Returns the ObjectID of the boxed value Ask for a DomainID (id), TypeID of the type that is going to be boxed and a variant value which is going to be put into the boxed value INVALID_DOMAINID, INVALID_TYPEID

    The main function handling these commands is domain_commands and is situated at debugger-agent.c:6104

    Assembly commands

    Each command requires at least one AssemblyID (of type id) parameter before any additional parameter the command may require.

    Name Value Type of reply Additional parameters Possible error code returned
    GET_LOCATION 1 Returns the filename (string) of image associated to the assembly None INVALID_ASSEMBLYID
    GET_ENTRY_POINT 2 Returns the MethodID (id) of the entry point or a 0 id if there is none (in case of dynamic assembly or library for instance) None INVALID_ASSEMBLYID
    GET_MANIFEST_MODULE 3 Returns the ModuleID (id) of the assembly None INVALID_ASSEMBLYID
    GET_OBJECT 4 Returns the ObjectID of the AssemblyID object instance None INVALID_ASSEMBLYID
    GET_TYPE 5 Returns the TypeID of the found type or a null id if it wasn’t found Ask for a type information in form of a string and a byte value to tell if case should be ignored (1) or not (0) INVALID_ASSEMBLYID
    GET_NAME 6 Return the full name of the assembly as a string None INVALID_ASSEMBLYID

    The main function handling these commands is assembly_commands and is situated at debugger-agent.c:6203

    Module commands

    Name Value Type of reply Additional parameters Possible error code returned
    CMD_MODULE_GET_INFO 1 Returns the following strings: basename of the image, scope name, full name, GUID and the image AssemblyID (id) Ask for a ModuleID (id) None

    The main function handling these commands is module_commands and is situated at debugger-agent.c:6295

    Method commands

    Each command requires at least one MethodID (of type id) parameter before any additional parameter the command may require.

    Name Value Type of reply Additional parameters Possible error code returned
    GET_NAME 1 Returns a string of the method name None INVALID_METHODID
    GET_DECLARING_TYPE 2 Returns a TypeID of the declaring type for this method None INVALID_METHODID
    GET_DEBUG_INFO 3 Returns the code size of the method (int), source file name (string) and a list of tuple of IL offset (int) and line numbers (int) for the method None INVALID_METHODID
    GET_PARAM_INFO 4 Returns the call convention (int), parameter count (int), generic parameter count (int), TypeID of the returned value (id), parameter count TypeID for each parameter type and finally parameter count parameter name (string) for each parameter. None INVALID_METHODID
    GET_LOCALS_INFO 5 Returns the number of locals (int) followed by the TypeID (id) for each locals, followed by the name (string) of each locals (empty string if there is none) and finally followed by the scope of each locals which is a tuple of int giving the start address and end offset. None INVALID_METHODID
    GET_INFO 6 Returns 3 int representing respectively the method flags, implementation flags and token None INVALID_METHODID
    GET_BODY 7 Returns a list of byte corresponding to the method IL code. None INVALID_METHODID
    RESOLVE_TOKEN 8 Returns a variant value corresponding to the provided token Ask for a token value (int) INVALID_METHODID
    GET_CATTRS 9 Returns the custom attributes for the methods Method ID, attribute-type ID INVALID_METHODID,LOADER_ERROR
    MAKE_GENERIC_METHOD 10 Makes a generic version of the method Method ID, number of type arguments (int), TypeID for each type argument (int) INVALID_ARGUMENT, INVALID_METHODID

    The main functions handling these commands are method_commands and method_commands_internal and are situated at debugger-agent.c:6968 and debugger-agent.c:6968 respectively.

    Type commands

    Each command requires at least one TypeID (of type id) parameter before any additional parameter the command may require.

    Name Value Type of reply Additional parameters Possible error code returned
    GET_INFO 1 Returns the following informations about the type in that order: namespace (string), class name (string), full name (string), AssemblyID (id), ModuleID (id), TypeID (id), TypeID (id) of underlying type (or a 0 id if there is none), type token (int), type rank (byte), type flags (int), underlying byval type (byte) flags (see after table) and a list of nested type TypeID None INVALID_TYPEID
    GET_METHODS 2 Returns a list of MethodID corresponding to each of the method of the type None INVALID_TYPEID
    GET_FIELDS 3 Returns list of quadruplet of FieldID (id), field name (string), field TypeID (id), field attributes (int) None INVALID_TYPEID
    GET_VALUES 4 Returns a number of variant value equals to the number of FieldID that was passed as parameter. If the field had a ThreadStatic attribute applied to it, value fetched are from the current thread point of view. Ask for a list of FieldID representing this type static fields to the the value of. Only static field are supported. INVALID_TYPEID, INVALID_FIELDID
    GET_OBJECT 5 Returns an ObjectID corresponding to the type instance None INVALID_TYPEID
    GET_SOURCE_FILES 6 Returns the same output than GET_SOURCE_FILES_2 except only the basename of each path is returned None INVALID_TYPEID
    SET_VALUES 7 Returns an empty response Ask for a list of tuple of FieldID and variant value. Only pure static field can be set (i.e. with no extra attribute like ThreadStatic). INVALID_TYPEID, INVALID_FIELDID
    IS_ASSIGNABLE_FROM 8 Returns a boolean equals to true if the type is assignable from the other provided type, false otherwise Ask for an extra TypeID INVALID_TYPEID
    GET_PROPERTIES 9 Returns a list of quadruplet of FieldID (id), get accessor MethodID (string), set accessor MethodID (id), property attributes (int) None INVALID_TYPEID
    GET_CATTRS 10 Returns a list of custom attribute applied on the type. Custom attribute definition is given below. Ask for a TypeID of an custom attribute type INVALID_TYPEID
    GET_FIELD_CATTRS 11 Returns a list of custom attributes of a type’s field. Custom attribute definition is given below. Ask for a FieldID of one the type field and a TypeID of an custom attribute type INVALID_TYPEID, INVALID_FIELDID
    GET_PROPERTY_CATTRS 12 Returns a list of custom attributes of a type’s property. Custom attribute definition is given below. Ask for a PropertyID of one the type field and a TypeID of an custom attribute type INVALID_TYPEID, INVALID_PROPERTYID
    GET_SOURCE_FILES_2 13 Returns a list of source file full paths (string) where the type is defined None INVALID_TYPEID
    GET_VALUES_2 14 Returns a number of variant value equals to the number of FieldID that was passed as parameter. If the field had a ThreadStatic attribute applied to it, value fetched are from the thread parameter point of view. Ask for an ObjectID representing a System.Thread instance and a list of FieldID representing this type static fields to the the value of. Only static field are supported. INVALID_OBJECT, INVALID_TYPEID, INVALID_FIELDID

    The main functions handling these commands are type_commands and type_commands_internal and are situated at debugger-agent.c:6726 and debugger-agent.c:6403 respectively.

    Byval flags is an indication of the type attribute for a parameter when it’s passed by value. A description of these flags follows:

    byte 1 byte 2 byte 3 byte 4 byte 5 byte 6 byte 7 byte 8
    Is a pointer type Is a primitive type Is a value type Is an enumeration Unused Unused Unused Unused

    Custom attribute definition is as follows: MethodID of the attribute ctor, a list of variant objects representing the typed arguments of the attribute prepended by a length attribute (int) and another list representing named arguments of which elements are either tuple of the constant 0x53 followed by a variant value (in case the named argument is a field) or a triplet of the constant 0x54 followed by a PropertyID followed by a variant value (in case the named argument is a property). In both list case, an empty list is simply one int of value 0.

    Stackframe commands

    Each command requires at least one ObjectID (of type id) parameter mapping to a System.Threading.Thread instance and a FrameID (of type id) before any additional parameter the command may require.

    Name Value Type of reply Additional parameters Possible error code returned
    GET_VALUES 1 Returns a list of miscelleanous typed values. If the position information was negative, the value corresponds to a parameter and if it was positive to a local variable. Ask for a list of position (int) information. INVALID_OBJECT, INVALID_FRAMEID, ABSENT_INFORMATION
    GET_THIS 2 Returns the this value prepended by a single byte value describing its type, or the special TYPE_ID_NULL (byte) value which is equal to 0xf0 in case there is no this parameter. None INVALID_OBJECT, INVALID_FRAMEID, ABSENT_INFORMATION
    SET_VALUES 3 Returns an empty reply Ask for a list of pair of position (int) information and variant whose value is going to be used. INVALID_OBJECT, INVALID_FRAMEID, ABSENT_INFORMATION, INVALID_ARGUMENT

    The main function handling these commands is frame_commands and is situated at debugger-agent.c:7082

    Array commands

    Each command requires at least one ObjectID (of type id) parameter mapping to a System.Array instance before any additional parameter the command may require.

    Name Value Type of reply Additional parameters Possible error code returned
    GET_LENGTH 1 Returns an int corresponding to the array rank followed by a set of int pair corresponding respectively to the length and lower bound of each of the array dimensions. In case of a single dimensional zero-based array, the returned data amount to 3 int values with the second being the total length of the array and the third one being 0. None INVALID_OBJECT
    GET_VALUES 2 Returns a list of length elements which individual size in bytes depends on the underlying type of the System.Array instance. Ask for an index (int) and a length (int) to determine the range of value to return INVALID_OBJECT
    SET_VALUES 3 Return an empty reply Ask for an index (int) and a length (int) to determine the range of value to set and a length number of trailing values whose type and byte size match those of the underlying type of the System.Array instance. INVALID_OBJECT

    The main function handling these commands is vm_commands and is situated at debugger-agent.c:5671

    String commands

    Each command requires at least one ObjectID (of type id) parameter mapping to a System.String instance before any additional parameter the command may require.

    Name Value Type of reply Additional parameters Possible error code returned
    GET_VALUE 1 Returns a UTF8-encoded string corresponding to the System.String instance with its length prepended as a int value None INVALID_OBJECT
    GET_LENGTH 2 Returns the length of a UTF8-encoded string corresponding to the System.String instance as an int value None INVALID_OBJECT
    GET_CHARS 3 Returns length short values each encoding a character of the string slice Ask for a start index (long) and a length parameter (long) of the string slice to take. INVALID_OBJECT, INVALID_ARGUMENT

    The main function handling these commands is string_commands and is situated at debugger-agent.c:7293

    Object commands

    Each command requires at least one ObjectID (of type id) parameter before any additional parameter the command may require.

    Name Value Type of reply Additional parameters Possible error code returned
    GET_TYPE 1 Returns the TypeID as an id None INVALID_OBJECT
    GET_VALUES 2 Returns length values of miscellaneous type and size corresponding to the underlying type of each queried field Ask for a list of FieldID to fetch value of INVALID_OBJECT, UNLOADED, INVALID_FIELDID
    IS_COLLECTED 3 Returns an int equals to 1 if the object has been collected by GC, 0 otherwise None None
    GET_ADDRESS 4 Returns a long value corresponding to the address where the object is stored in memory None INVALID_OBJECT
    GET_DOMAIN 5 Returns an id corresponding to the DomainID the object is located in None INVALID_OBJECT
    SET_VALUES 6 Returns an empty reply Ask for a list of tuple of FieldID (id) and of the value that should be set to it INVALID_OBJECT, UNLOADED, INVALID_FIELDID

    The main function handling these commands is object_commands and is situated at debugger-agent.c:7318

    Composite commands

    Name Value Description
    COMPOSITE 100 This command is actually part of the event command set and is used for ?

    Differences with JDWP

    • Handshake ASCII sequence is DWP-Handshake instead of JDWP-Handshake
    • Some new Mono specific command set such as AppDomain, Assembly or Module and removal/renaming of some Java specific set such as InterfaceType, ThreadGroupReference, ClassLoaderReference, etc.
    • Mono SDB protocol has its own specific ID types related to the new command sets.
    • SDB protocol has less error code although some are Mono-specific like “No Invocation”, “Absent Informations” and “No seq point at IL offset” codes.