Xbox Debug Monitor - Revision history

CrunchBite: Correct XBDM.dll path

2025-10-29T01:48:20Z

Correct XBDM.dll path

JayFoxRox: /* delete (Delete file) */

2019-02-16T16:09:33Z

‎delete (Delete file)

JayFoxRox: /* magicboot */

2018-10-07T14:02:27Z

‎magicboot

JayFoxRox: /* getsum */

2018-10-07T13:43:58Z

‎getsum

JayFoxRox: /* drivelist (List drive letters) */

2018-10-06T02:06:23Z

‎drivelist (List drive letters)

JayFoxRox: There's a prefix for the number of bytes, this must be skipped and is important if you try to read beyond the end of the file

2018-10-06T02:04:16Z

There's a prefix for the number of bytes, this must be skipped and is important if you try to read beyond the end of the file

JayFoxRox: /* External Links */

2017-05-27T23:01:02Z

‎External Links

Furon: /* Commands */

2017-05-27T01:34:36Z

‎Commands

Furon: /* Remote Debugging and Control Protocol */

2017-05-26T23:16:46Z

‎Remote Debugging and Control Protocol

Furon: /* adminpw (Set administrator password) */

2017-05-25T21:11:20Z

‎adminpw (Set administrator password)

← Older revision		Revision as of 01:48, 29 October 2025
Line 1:		Line 1:
−	The '''Xbox Debug Monitor''' ('''XBDM''') is a feature of Xbox Development Kits that provides remote debugging, file management, console discovery, and other services on TCP/UDP port 731. It is loaded by debug kernels at startup from <code>C:\xbdm.dll</code> and its configuration is read from <code>E:\xbdm.ini</code>. XBDM is distinct from KD and uses a different wire protocol.	+	The '''Xbox Debug Monitor''' ('''XBDM''') is a feature of Xbox Development Kits that provides remote debugging, file management, console discovery, and other services on TCP/UDP port 731. It is loaded by debug kernels at startup from <code>E:\xbdm.dll</code> and its configuration is read from <code>E:\xbdm.ini</code>. XBDM is distinct from KD and uses a different wire protocol.

	==Name Answering Protocol==		==Name Answering Protocol==

@@ Line 175: / Line 175: @@
 ====<span id="cmd_dedicate">dedicate</span> (Dedicate connection)====
 ====<span id="cmd_deftitle">deftitle</span>====
-====<span id="cmd_delete">delete</span> (Delete file)====
+====<span id="cmd_delete">delete</span> (Delete file or directory)====
 ====<span id="cmd_dirlist">dirlist</span> (List files in directory)====
 ====<span id="cmd_dmversion">dmversion</span> (Get debug monitor version)====

@@ Line 240: / Line 240: @@
 ====<span id="cmd_lockmode">lockmode</span>====
 ====<span id="cmd_lop">lop</span>====
-====<span id="cmd_magicboot">magicboot</span>====
+====<span id="cmd_magicboot">magicboot (Boot into new title)</span>====
 ====<span id="cmd_memtrack">memtrack</span>====
 ====<span id="cmd_mkdir">mkdir</span> (Create directory)====

@@ Line 213: / Line 213: @@
 ====<span id="cmd_getpalette">getpalette</span>====
 ====<span id="cmd_getpid">getpid</span>====
-====<span id="cmd_getsum">getsum</span>====
+====<span id="cmd_getsum">getsum (Generate memory checksums)</span>====
 ====<span id="cmd_getsurf">getsurf</span>====
 ====<span id="cmd_getuserpriv">getuserpriv</span> (Get user's privilege level)====

@@ Line 180: / Line 180: @@
 ====<span id="cmd_drivefreespace">drivefreespace</span> (Get free space on drive)====
 ====<span id="cmd_drivelist">drivelist</span> (List drive letters)====
 ====<span id="cmd_dvdblk">dvdblk</span> (Read block from DVD)====
 ====<span id="cmd_dvdperf">dvdperf</span>====

@@ Line 195: / Line 195: @@
 Retrieve the entire contents of the named file.
 {{XBDM command|text=getfile name=STRING offset=DWORD size=DWORD}}
 Retrieve <code>size</code> bytes starting at <code>offset</code> from the named file.
 ====<span id="cmd_getfileattributes">getfileattributes</span> (Get file attributes)====

@@ Line 270: / Line 270: @@
 ==External Links==
 * [https://github.com/Ernegien/ViridiX ViridiX] – An open-source collection of Xbox debugging libraries and tools written in C#.
 * [https://github.com/docbrown/xbdm-rs xbdm-rs] - An open-source XBDM client written in Rust.

@@ Line 152: / Line 152: @@
 ====<span id="cmd_adminpw">adminpw</span> (Set administrator password)====
-{| class="wikitable"
+{{XBDM command|version=4039+|text=adminpw none|privs=manage}}
 Clear the administrator password.
-{| class="wikitable"
+{{XBDM command|version=4039+|text=adminpw passwd=QWORD|privs=manage}}
 Set the administrator password to the value of the <code>passwd</code> parameter. Note that <code>passwd</code> is a 64-bit integer instead of a string. The details of the conversion from a string password to a 64-bit integer are currently unknown.
@@ Line 200: / Line 192: @@
 ====<span id="cmd_getfile">getfile</span> (Download file)====
-{| class="wikitable"
+{{XBDM command|text=getfile name=STRING}}
 Retrieve the entire contents of the named file.
-{| class="wikitable"
+{{XBDM command|text=getfile name=STRING offset=DWORD size=DWORD}}
 Retrieve <code>size</code> bytes starting at <code>offset</code> from the named file.

@@ Line 50: / Line 50: @@
 The Remote Debugging and Control Protocol (RDCP) is a text-based protocol transmitted over a TCP connection on port 731. RDCP resembles protocols like FTP and SMTP, making it possible to communicate with XBDM using just a Telnet client in many cases.
-When a connection is established, XBDM sends <code>201- connected</code> (or <code>200- connected</code> in version 3944) followed by <CR><LF> (that is, a carriage return character followed by a line feed character). The RDCP client is then free to send a command followed by <CR><LF> or <CR><NUL>. A command consists of a name and zero or more parameters separated by whitespace characters. The format of the parameters is defined by the command, but most commands use the form <code>key=value</code>. Parameter values that contain whitespace characters must be surrounded by double quotes (e.g. <code>"some value"</code> or <code>key="some value"</code>).
+When a connection is established, XBDM sends <code>201- connected</code> (or <code>200- connected</code> in version 3944) followed by <CR><LF> (that is, a carriage return character followed by a line feed character). The RDCP client is then free to send a [[#Commands|command]] followed by <CR><LF> or <CR><NUL>.
 After executing a command, XBDM replies with a response line consisting of a three-digit status code and message of the form <code>999- message text<CR><LF></code>. Note that unlike similar protocols, the <code>-</code> (dash) is always present in responses and messages cannot span multiple lines.
@@ Line 88: / Line 88: @@
 : An operation was attempted on a thread that does not exist.
 ; <span id="status_406">406-</span>
-: An attempt to set the system time with the <code>setsystime</code> command failed. This status code is undocumented.
+: An attempt to set the system time with the <code>[[#cmd_setsystime|setsystime]]</code> command failed. This status code is undocumented.
 ; <span id="status_407">407- unknown command</span>
 : The command is not recognized.
@@ Line 116: / Line 116: @@
 : The command can only be executed when security is enabled (see [[#Security]]).
 ; <span id="status_421">421- key exchange required</span>
-: The client must perform a key exchange with the <code>keyxchg</code> command (see [[#Security]]).
+: The client must perform a key exchange with the <code>[[#cmd_keyxchg|keyxchg]]</code> command (see [[#Security]]).
 ; <span id="status_422">422- dedicated connection required</span>
 : The command can only be executed on a dedicated connection (see [[#Connection dedication]]).
@@ Line 135: / Line 135: @@
 ''See also: [[XBDM commands by version]]''
 ====<span id="cmd_adminpw">adminpw</span> (Set administrator password)====
@@ Line 187: / Line 201: @@
 {| class="wikitable"
-! 3944-4432
+! 3944+
-| width="99%" | <span style="font: 14px monospace">getfile name=</span>
+| <code>getfile name=STRING</code>
-|-
+|}
 ! 4531+
-| <span style="font: 14px monospace">getfile name= [offset= size=]</span>
+| <code>getfile name=STRING offset=DWORD size=DWORD</code>
 |}
 ====<span id="cmd_getfileattributes">getfileattributes</span> (Get file attributes)====

@@ Line 137: / Line 137: @@
 ====<span id="cmd_adminpw">adminpw</span> (Set administrator password)====
 ====<span id="cmd_altaddr">altaddr</span>====
 ====<span id="cmd_authuser">authuser</span> (Authenticate user)====