DR DOS 9.0 USER GUIDE ========== Copyright (c) 2022-2026 Whitehorn Ltd. Co. All rights reserved. DR DOS is a registered trademark of Whitehorn Ltd. Co. WHITEHORN LTD. CO. 3963 S Highway 97 #214 Sand Springs, OK 74063 DISCLAIMER Whitehorn Ltd. Co. provides this publication "as is" without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability or fitness for a particular purpose. This publication may include technical inaccuracies or typographical errors. Changes are periodically made to the information herein. No part of this publication may be reproduced without the prior written permission of Whitehorn Ltd. Co. Last Modified: February 2026 =============================================================================== TABLE OF CONTENTS =============================================================================== Chapter 1 ......................................... Installing DR DOS Chapter 2 ......................................... Getting Started Chapter 3 ......................................... Working with Files Chapter 4 ......................................... Working with Directories Chapter 5 ......................................... Running Programs Chapter 6 ......................................... Advanced Features Chapter 7 ......................................... Command Reference Reporting Bugs and Issues Appendix A ........................................ Error Messages Glossary =============================================================================== CHAPTER 1: INSTALLING DR DOS =============================================================================== SYSTEM REQUIREMENTS DR DOS 9.0 requires the following hardware: Processor Intel 286 or compatible Memory 2 MB RAM (minimum) Display VGA-compatible display adapter Storage FAT16 hard disk partition BIOS LBA support recommended; CHS fallback available BETA SOFTWARE NOTICE DR DOS 9.0 is currently in beta testing. This means you may encounter bugs, crashes, system freezes, filesystem corruption, or compatibility issues during use. IMPORTANT PRECAUTIONS: - Back up all important data before installation - Do not use DR DOS 9.0 on production systems - Test in a virtual machine or on non-critical hardware - Be prepared for potential data loss Your participation in beta testing helps us identify and fix issues. Please report any problems you encounter (see "Reporting Bugs and Issues" section). SUPPORTED STORAGE DR DOS 9.0 supports FAT16 hard disk partitions only: Supported: FAT16 hard disk partitions LBA disk addressing (preferred) CHS disk addressing (fallback for older systems) Drive letters: C: and D: drives only NOT supported: FAT12 floppy disk boot Additional drives beyond D: INSTALLATION PROCEDURE DR DOS 9.0 is distributed as a pre-configured bootable disk image. CHOOSING A BUILD DR DOS is available in two versions: **Release Build (boot16.img.7z)** - Recommended for most users - Optimized for performance - Smaller kernel size - COM1 serial port available for use - Best for general use and testing applications **Debug Build (boot16-debug.img.7z)** - For advanced troubleshooting - Larger kernel size - Slower performance - Outputs detailed debugging logs to COM1 serial port - COM1 NOT available for other uses (reserved for kernel debugging) - Only needed when reporting complex bugs or system crashes Most users should download the **release build** (boot16.img.7z). Step 1: Obtain the disk image Download boot16.img.7z from the DR DOS website (https://www.dr-dos.com). Step 2: Extract the disk image Use 7-Zip to extract the image file: 7z x boot16.img.7z This creates boot16.img (approximately 120 MB). Step 3: Write the image to bootable media Use dd or a similar disk imaging tool to write the image to a CompactFlash card, USB drive, or virtual disk: dd if=boot16.img of=/dev/sdX bs=4M status=progress Replace /dev/sdX with your target device identifier. IMPORTANT: Ensure you specify the correct device. Writing to the wrong device will destroy data on that device. Step 4: Boot from the media Configure your computer or emulator to boot from the media you created. DR DOS will load automatically and present the command prompt. RUNNING IN QEMU QEMU is a popular open-source emulator for testing DR DOS. Basic command: qemu-system-i386 -m 16m -drive file=boot16.img,format=raw,if=ide -cpu 486 If using the debug build and want to capture debug logs: qemu-system-i386 -m 16m -drive file=boot16-debug.img,format=raw,if=ide -cpu 486 -serial stdio This displays debug output in the terminal. To save to a file instead: qemu-system-i386 -m 16m -drive file=boot16-debug.img,format=raw,if=ide -cpu 486 -serial file:debug.log The debug.log file will contain kernel debugging output. WHAT'S INCLUDED The DR DOS disk image includes: - DR DOS 9.0 kernel and boot loader - COMMAND.COM (command interpreter) - Standard DOS utilities in C:\DOS\ - FAT16 filesystem pre-configured on drive C: KNOWN LIMITATIONS Be aware of the following limitations in this release: Scripting - Batch file (.BAT) execution is not supported - No startup script processing (AUTOEXEC.BAT not supported) File System Operations - Directory removal (RMDIR/RD) is not implemented - File date/time modification is not available Advanced Features - Input redirection (<) is not supported =============================================================================== CHAPTER 2: GETTING STARTED =============================================================================== WHAT IS DR DOS? DR DOS 9.0 is a disk operating system. It provides the essential services that allow you to run programs, manage files, and organize your hard disk. When you turn on your computer, DR DOS loads automatically and presents you with a command prompt. THE COMMAND PROMPT After DR DOS starts, you will see a prompt that looks like this: C:\> This prompt tells you: - The current drive (C:) - The current directory (\, the root) - That the system is ready for your command (>) You type commands at this prompt and press ENTER to execute them. DRIVES AND DRIVE LETTERS DR DOS identifies disk drives with letters: C: First hard disk partition D: Second hard disk partition (if present) NOTE: This version of DR DOS supports C: and D: drives only. Floppy drives (A:, B:) are not supported in this release. To switch to a different drive, type the drive letter followed by a colon and press ENTER: C:\>D: D:\> The prompt changes to show your new current drive. CONVENTIONS USED IN THIS MANUAL Commands are shown in UPPERCASE: DIR COPY Parameters you supply are shown in lowercase: COPY source destination Optional parameters are shown in brackets: DIR [drive:] Literal characters you must type exactly are shown as-is: C:\DOS\ =============================================================================== CHAPTER 3: WORKING WITH FILES =============================================================================== FILE NAMES Every file has a name consisting of up to 8 characters, optionally followed by a period and an extension of up to 3 characters: LETTER.TXT REPORT.DOC COMMAND.COM CONFIG.SYS The extension often indicates the type of file: .COM Executable program .EXE Executable program .TXT Text file .SYS System configuration file File names cannot contain these characters: < > : " | ? * / \ WILDCARD CHARACTERS Two special characters help you work with groups of files: * Matches any sequence of characters ? Matches any single character Examples: *.TXT All files with .TXT extension REPORT.* All files named REPORT with any extension FILE?.DOC FILE1.DOC, FILE2.DOC, FILEA.DOC, etc. VIEWING FILES: DIR The DIR command displays a list of files in a directory. Syntax: DIR [filespec] [/W] Switches: /W Wide format (5 columns, filenames only) Examples: DIR List all files in current directory DIR *.TXT List all .TXT files DIR /W List files in wide format DIR D: List all files on drive D: DIR displays the file name, size in bytes, and the total number of files found. With the /W switch, DIR displays only file names in a compact 5-column format. VIEWING FILE CONTENTS: TYPE The TYPE command displays the contents of a text file on screen. Syntax: TYPE filename Example: TYPE README.TXT NOTE: TYPE is an external command. The file TYPE.COM must be in the current directory or in the C:\DOS\ directory for this command to work. TIP: For long files, use TYPE filename | MORE to page through the output one screen at a time. WARNING: Using TYPE on a program file (.COM or .EXE) will display meaningless characters and may cause your screen to behave erratically. Only use TYPE on text files. COPYING FILES: COPY The COPY command makes a duplicate of a file. Syntax: COPY source destination Examples: COPY LETTER.TXT LETTER.BAK COPY D:DATA.TXT C:\DOCS\DATA.TXT COPY REPORT.DOC D: When copying to a drive without specifying a filename, the original name is preserved. NOTE: The COPY command copies one file at a time. Wildcard characters are not supported in this version. DELETING FILES: DEL The DEL command deletes one or more files from your disk. Syntax: DEL filename ERASE filename Examples: DEL LETTER.TXT ERASE REPORT.DOC DEL *.BAK DEL and ERASE are identical commands. CREATING DIRECTORIES: MD The MD command creates a new directory. Syntax: MD dirname MKDIR dirname Examples: MD DOCS MKDIR BACKUPS MD and MKDIR are identical commands. RENAMING FILES: REN The REN command renames an existing file. Syntax: REN oldname newname RENAME oldname newname Examples: REN OLD.TXT NEW.TXT RENAME LETTER.DOC LETTER.BAK REN and RENAME are identical commands. MOVING FILES: MOVE The MOVE command relocates a file from one location to another. Unlike COPY, the original file is removed after a successful move. Syntax: MOVE source destination Examples: MOVE OLDFILE.TXT NEWFILE.TXT MOVE C:\DOCS\LETTER.TXT D:\BACKUP\ When moving to a directory, if the destination already exists, MOVE will ask whether to overwrite it. NOTE: MOVE is an external command. The file MOVE.COM must be in the current directory or in the C:\DOS\ directory. =============================================================================== CHAPTER 4: WORKING WITH DIRECTORIES =============================================================================== WHAT IS A DIRECTORY? A directory is a container for files. Directories can contain other directories, creating a tree-like structure for organizing your files. Every disk has a root directory, indicated by a single backslash (\). All other directories branch from the root. Example directory structure: C:\ \DOS\ COMMAND.COM TYPE.COM MOVE.COM \DOCS\ LETTER.TXT REPORT.DOC \PROGRAMS\ EDITOR.EXE PATHS A path describes the location of a file or directory. It consists of an optional drive letter, followed by a series of directory names separated by backslashes, ending with a filename: C:\DOCS\LETTER.TXT This path indicates: - Drive C: - In the DOCS directory - The file LETTER.TXT CHANGING DIRECTORIES: CD The CD (Change Directory) command changes your current directory or displays the current directory path. Syntax: CD [path] Examples: CD Display current directory CD \ Go to root directory CD \DOCS Go to DOCS directory CD .. Go to parent directory CD SUBDIR Go to subdirectory named SUBDIR The CD command can also be typed as CHDIR. =============================================================================== CHAPTER 5: RUNNING PROGRAMS =============================================================================== EXECUTABLE FILES Programs are stored as executable files with .COM or .EXE extensions. To run a program, type its name (with or without the extension) and press ENTER: EDIT EDIT.COM MYPROG.EXE DR DOS searches for the program in this order: 1. Current directory, with .COM extension 2. Current directory, with .EXE extension 3. C:\DOS\ directory, with .COM extension 4. C:\DOS\ directory, with .EXE extension NOTE: The search path is fixed to the current directory and C:\DOS\. Unlike some other DOS systems, there is no configurable PATH environment variable. PASSING PARAMETERS TO PROGRAMS Most programs accept parameters that control their behavior. Type the parameters after the program name, separated by spaces: TYPE README.TXT COPY FILE1.TXT FILE2.TXT MOVE /? Consult the documentation for each program to learn its parameters. EXITING PROGRAMS Most programs return to the DOS prompt when they finish. Some programs require you to type a command like EXIT or QUIT, or press a key combination. Consult each program's documentation. THE EXIT COMMAND The EXIT command terminates the command interpreter. On most systems, this will return you to the program that started COMMAND.COM. If you type EXIT at the main DOS prompt (after booting), the system may restart or halt. Use EXIT only when instructed by a program. =============================================================================== CHAPTER 6: ADVANCED FEATURES =============================================================================== OUTPUT REDIRECTION DR DOS supports redirecting a command's output to a file using the greater-than symbol (>). Syntax: command > filename The output that would normally appear on screen is instead written to the specified file. If the file already exists, it will be overwritten without warning. Examples: DIR > FILELIST.TXT DIR *.COM > PROGRAMS.TXT MEM > MEMORY.TXT This feature is useful for: - Saving directory listings to review later - Capturing program output for documentation - Creating text files from command output NOTES: - Only output redirection (>) is supported - Input redirection (<) is not supported PIPING OUTPUT TO MORE DR DOS supports piping command output to the MORE utility using the pipe symbol (|). Syntax: command | MORE The output of the command is displayed one page at a time, allowing you to read through long output without it scrolling off the screen. Examples: DIR | MORE Page through directory listing TYPE README.TXT | MORE Page through file contents MEM /A | MORE Page through memory information Controls when viewing output: Space Display next page (23 lines) Enter Display next line Q or Esc Quit NOTES: - Currently only piping to MORE is supported - Multiple pipes (cmd | cmd | cmd) are not supported - Piping to commands other than MORE may not work as expected CHANGING DRIVES You can change the current drive by typing the drive letter followed by a colon: Syntax: drive: Examples: C: Switch to drive C: D: Switch to drive D: The command prompt will update to show the new current drive. Each drive maintains its own current directory, so switching back to a drive returns you to the directory you were in on that drive. CLEARING THE SCREEN Use the CLS command to clear the screen and position the cursor at the top-left corner. Syntax: CLS NOTE: CLS is an external command. The file CLS.COM must be in the current directory or in the C:\DOS\ directory. =============================================================================== CHAPTER 7: COMMAND REFERENCE =============================================================================== This chapter describes all available DR DOS commands in alphabetical order. ------------------------------------------------------------------------------- CD - Change Directory ------------------------------------------------------------------------------- Changes the current directory or displays the current directory path. Syntax: CD [drive:][path] Parameters: drive: The drive containing the directory (optional) path The directory to change to Examples: CD Display current directory CD \ Change to root directory CD .. Change to parent directory CD \DOS Change to \DOS directory CD SUBDIR Change to SUBDIR within current directory Notes: - CD and CHDIR are identical commands. - To change drives, type the drive letter followed by a colon (for example, D:) rather than using CD. Related commands: DIR ------------------------------------------------------------------------------- CHDIR - Change Directory ------------------------------------------------------------------------------- Identical to CD. See CD for details. ------------------------------------------------------------------------------- CLS - Clear Screen ------------------------------------------------------------------------------- Clears the screen and positions the cursor at the top-left corner. Syntax: CLS Parameters: None Examples: CLS Notes: - CLS is an external command; CLS.COM must be available in the current directory or in C:\DOS\. Related commands: None ------------------------------------------------------------------------------- COPY - Copy Files ------------------------------------------------------------------------------- Copies a file from one location to another. Syntax: COPY source destination Parameters: source The file to copy destination The target filename or directory Examples: COPY README.TXT README.BAK COPY D:DATA.TXT C:\BACKUP\ COPY LETTER.DOC D: Notes: - If the destination is a drive letter only (e.g., D:), the file is copied with the same name. - If the destination file already exists, it is overwritten without warning. - This version of COPY does not support wildcard characters. Related commands: MOVE ------------------------------------------------------------------------------- DATE - Display or Set Date ------------------------------------------------------------------------------- Displays the current system date or sets a new date. Syntax: DATE [mm-dd-yyyy] Parameters: mm-dd-yyyy Optional new date (month-day-year) Examples: DATE Display current date and prompt for new date DATE 12-25-2025 Set date to December 25, 2025 DATE 01/15/2026 Set date to January 15, 2026 Notes: - DATE is an external command; DATE.COM must be available. - When called without parameters, DATE displays the current date with day-of-week and prompts for a new date. - Date format is flexible: use -, /, or other delimiters. - Two-digit years are interpreted as: 80-99 = 19xx, 00-79 = 20xx - Valid year range: 1980-2099 - Press ENTER at the date prompt to keep the current date. Related commands: None ------------------------------------------------------------------------------- DEL - Delete File ------------------------------------------------------------------------------- Deletes one or more files from the disk. Syntax: DEL filename ERASE filename Parameters: filename The file to delete (may include wildcards) Examples: DEL LETTER.TXT ERASE REPORT.DOC DEL *.BAK Notes: - DEL and ERASE are identical commands. - Wildcard characters are supported. - The file cannot be read-only; it must have its read-only attribute cleared first. Related commands: COPY ------------------------------------------------------------------------------- DIR - Directory Listing ------------------------------------------------------------------------------- Displays a list of files and subdirectories in a directory. Syntax: DIR [drive:][path][filespec] [/W] Parameters: drive: The drive to list (optional) path The directory to list (optional) filespec File specification, may include wildcards (optional) Switches: /W Wide format (5 columns, filenames only) Examples: DIR List current directory DIR *.TXT List all .TXT files DIR /W List files in wide format DIR D: List files on drive D: DIR \DOS List files in \DOS directory DIR C:\*.COM List all .COM files in root of C: Output: The listing shows: - Volume label (if any) - Directory path - File names and sizes - Subdirectories (marked with ) - Total number of files and bytes With /W switch, only file names are shown in a compact 5-column format without size or date information. Related commands: CD ------------------------------------------------------------------------------- EDIT - Full-Screen Text Editor ------------------------------------------------------------------------------- Opens a full-screen text editor for creating and editing text files. Syntax: EDIT [filename] Parameters: filename Optional file to open for editing Screen Layout: The editor uses a colored display: - Top row: Menu bar (File, Edit, Search) and current filename - Middle rows: Text editing area (white text on blue background) - Bottom row: Status bar showing line number, column, and modified indicator Menu Access: Alt+F Open File menu (New, Open, Save, Save As, Exit) Alt+E Open Edit menu (Cut, Copy, Paste) Alt+S Open Search menu (Find, Find Next) Navigate menus with arrow keys. Press Enter to select an item or Escape to close the menu. Keyboard Shortcuts: Ctrl+N New file Ctrl+O Open file Ctrl+S Save file Ctrl+F Find F3 Find Next (repeat last search) Ctrl+X Cut line Ctrl+C Copy line Ctrl+V Paste Alt+X Exit editor Navigation: Arrow keys Move cursor Home Move to beginning of line End Move to end of line Page Up Scroll up one page Page Down Scroll down one page Ctrl+Home Move to beginning of file Ctrl+End Move to end of file Editing: Backspace Delete character before cursor Delete Delete character at cursor Enter Insert new line Tab Insert spaces to next tab stop Clipboard Operations (Edit menu): Cut Copy current line to clipboard and delete it Copy Copy current line to clipboard Paste Insert clipboard contents at cursor Examples: EDIT Open editor with empty file EDIT README.TXT Open README.TXT for editing EDIT NEWFILE.TXT Create and edit a new file Notes: - EDIT is an external command; EDIT.COM must be available in the current directory or in C:\DOS\. - Maximum file size is limited by available conventional memory. - Files are saved with CR+LF line endings. - Lines longer than 80 characters are truncated on display. Related commands: TYPE, MORE ------------------------------------------------------------------------------- ERASE - Delete File ------------------------------------------------------------------------------- Identical to DEL. See DEL for details. ------------------------------------------------------------------------------- EXIT - Exit Command Interpreter ------------------------------------------------------------------------------- Terminates the command interpreter (COMMAND.COM). Syntax: EXIT Parameters: None Notes: - If COMMAND.COM was started by another program, EXIT returns to that program. - If EXIT is typed at the initial DOS prompt, results may vary depending on system configuration. WARNING: Do not type EXIT at the main system prompt unless you understand the consequences. ------------------------------------------------------------------------------- HEXDUMP - Display Hex Dump ------------------------------------------------------------------------------- Displays a hexadecimal dump of a binary file. Syntax: HEXDUMP filename Parameters: filename The file to display Examples: HEXDUMP COMMAND.COM HEXDUMP PROGRAM.EXE Output: Each line shows: - Hexadecimal offset from start of file - 16 bytes in hexadecimal format - ASCII representation (non-printable characters shown as ".") Notes: - HEXDUMP is an external command; HEXDUMP.COM must be available. - Handles files larger than 64KB. - Useful for examining binary files, debugging, and data recovery. Related commands: TYPE ------------------------------------------------------------------------------- JMP - Execute Code at Memory Address ------------------------------------------------------------------------------- Performs a far call to a flat 20-bit real-mode memory address, transferring CPU execution to whatever code lives there. Completes the PEEK/POKE/JMP trio for direct memory manipulation. The target address is called (not jumped to), meaning code at that address can return to DOS cleanly by executing a far return (RETF instruction). If the target code never returns — because it jumps elsewhere, resets the machine, or calls INT 20h — JMP.COM simply never returns either. Syntax: JMP address Parameters: address Flat memory address in hex with h suffix, up to 5 digits. Range: 0h to FFFFFh. Examples: JMP FFFF0h Call BIOS cold-reset vector — resets the machine JMP 100h Execute code at 0010:0000 Entry state seen by called code: CS:IP = target address SS:SP = JMP.COM stack; return address on top (use RETF to return) DS,ES = JMP.COM data segment Registers AX-DI: undefined — target should not rely on any value Notes: - JMP is an external command; JMP.COM must be available in the current directory or in C:\DOS\. - The primary workflow is: use POKE to write machine code into a scratch area of RAM, then use JMP to execute it. This gives you an inline code execution capability from the command line. - JMP FFFF0h is a reliable way to cold-reset the machine — it calls the BIOS reset entry point directly, the same vector the CPU jumps to on power-on. - If called code returns via RETF, JMP.COM exits to DOS normally. If called code calls INT 20h or INT 21h AH=4Ch, the process terminates and DOS gets control back either way. WARNING: Jumping to an address that contains garbage or random data will crash the system immediately. Always know what is at an address before jumping to it. Use PEEK and HEXDUMP to inspect memory first. Related commands: PEEK, POKE ------------------------------------------------------------------------------- MD - Make Directory ------------------------------------------------------------------------------- Creates a new directory. Syntax: MD dirname MKDIR dirname Parameters: dirname The name of the new directory Examples: MD DOCS MKDIR BACKUPS Notes: - MD and MKDIR are identical commands. - The parent directory must already exist. - Wildcard characters are not supported. Related commands: CD ------------------------------------------------------------------------------- MEM - Display Memory Information ------------------------------------------------------------------------------- Displays comprehensive system memory information. Syntax: MEM [switches] Switches: /H Display help text /B Show conventional memory blocks (MCB chain) /U Show upper memory blocks (UMB chain) /F Show HMA (High Memory Area) blocks /D Show device drivers /S Show system structures /M Show system memory map with ASCII visualization /A Show all information (combines all modes) /P Pause listing at each page (23 lines) Examples: MEM Display memory summary MEM /B Show conventional memory blocks MEM /M Show memory map with visualization MEM /A Show all available information MEM /A /P Show all information with paging Output: The default output shows a summary table with: - Conventional memory (0-640KB) - High memory area (HMA) - Extended memory (XMS) - Total memory available Additional switches provide detailed block-by-block information including owner, size, and memory visualization. Notes: - MEM is an external command; MEM.COM must be available. - Switches can be combined (e.g., MEM /B /U /P) - The /M switch provides an ASCII art visualization of the entire memory map. - Very useful for diagnosing memory issues and understanding system configuration. Related commands: None ------------------------------------------------------------------------------- MORE - Display Output One Page at a Time ------------------------------------------------------------------------------- Displays a text file one page at a time, pausing after each screenful. Syntax: MORE filename command | MORE Parameters: filename The file to display Controls: Space Display next page (23 lines) Enter Display next line Q or Esc Quit Examples: MORE README.TXT TYPE BIGFILE.TXT | MORE DIR | MORE MEM /A | MORE Notes: - MORE is an external command; MORE.COM must be available in the current directory or in C:\DOS\. - When used with piping (|), the output of the preceding command is displayed one page at a time. - The "-- More --" prompt appears at the bottom of each page. - Use TYPE for quick viewing of short files; use MORE for long files. Related commands: TYPE ------------------------------------------------------------------------------- MOUSE - PS/2 Mouse Driver ------------------------------------------------------------------------------- Loads a resident PS/2 mouse driver that provides the standard INT 33h mouse API used by DOS applications and games. Syntax: MOUSE Parameters: None Examples: MOUSE Load the mouse driver before running applications that require mouse support (e.g., games, editors, menu-driven programs). Output: If a PS/2 mouse is detected, the driver installs itself as a Terminate-and-Stay-Resident (TSR) program and displays: DR DOS 9.0 PS/2 Mouse Driver v1.0 Mouse detected - driver installed. If no PS/2 mouse is detected, the driver displays an error and exits without going resident. Mouse Cursor: Applications control the mouse cursor through INT 33h calls. In text mode, the cursor appears as an inverse-video block character. Notes: - MOUSE is an external command; MOUSE.COM must be available in the current directory or in C:\DOS\. - The driver uses BIOS INT 15h PS/2 pointing device services for hardware access. A PS/2-compatible mouse (or emulation) is required. - Once loaded, the driver remains in memory. Reboot to unload. - Load MOUSE before starting any application that needs mouse input. Related commands: None ------------------------------------------------------------------------------- MKDIR - Make Directory ------------------------------------------------------------------------------- Identical to MD. See MD for details. ------------------------------------------------------------------------------- MOVE - Move Files ------------------------------------------------------------------------------- Moves a file from one location to another, removing the original. Syntax: MOVE source destination Parameters: source The file to move destination The target filename or directory Examples: MOVE OLD.TXT NEW.TXT MOVE C:\DOCS\FILE.TXT D:\BACKUP\ MOVE *.BAK D:\ARCHIVE\ Notes: - MOVE is an external command; MOVE.COM must be available. - If the destination file exists, MOVE will prompt before overwriting. - Enter Y for yes, N for no, or A for all to overwrite all remaining files without prompting. - MOVE supports wildcard characters in the source filespec. Related commands: COPY ------------------------------------------------------------------------------- PEEK - Read Byte from Memory Address ------------------------------------------------------------------------------- Reads a single byte from any flat real-mode memory address and displays it as two uppercase hex digits. Addresses span the full 20-bit real-mode address space (0h through FFFFFh), giving direct access to conventional memory, video RAM, the BIOS data area, and the interrupt vector table. Syntax: PEEK address Parameters: address Flat memory address in hex with h suffix (e.g. B8000h). Up to 5 hex digits. Range: 0h to FFFFFh. Examples: PEEK 0h Read first byte of interrupt vector table PEEK 46Ch Read low byte of BIOS timer tick counter PEEK B8000h Read first character byte of text video RAM PEEK A0000h Read first byte of VGA graphics framebuffer Output: A two-digit uppercase hex value followed by a newline: FF Notes: - PEEK is an external command; PEEK.COM must be available in the current directory or in C:\DOS\. - Addresses are entered in hexadecimal with an h suffix. No 0x prefix is used. Both uppercase and lowercase hex digits are accepted. - The full 1 MB real-mode address space is accessible. There is no memory protection; any address may be read. - See the PC memory map below for notable addresses. PC Memory Map (selected addresses): 0h - 3FFh Interrupt vector table (256 vectors x 4 bytes) 400h - 4FFh BIOS data area (equipment flags, cursor, etc.) 46Ch BIOS timer tick counter low word 472h Warm boot flag (1234h = warm boot) B8000h - BFFFFh CGA/VGA text mode video RAM A0000h - AFFFFh VGA graphics framebuffer (mode 13h, etc.) B0000h - B7FFFh Monochrome display adapter RAM C0000h - EFFFFh ROM space (video BIOS, adapter ROMs) F0000h - FFFFFh System BIOS ROM Related commands: POKE, JMP, HEXDUMP ------------------------------------------------------------------------------- POKE - Write Byte to Memory Address ------------------------------------------------------------------------------- Writes a single byte to any flat real-mode memory address. Like PEEK, addresses span the full 20-bit real-mode address space (0h through FFFFFh). On success, prints "OK" unless suppressed with /S. Syntax: POKE address value [/S] Parameters: address Flat memory address in hex with h suffix (e.g. B8000h). Up to 5 hex digits. Range: 0h to FFFFFh. value Byte value to write, in hex with h suffix (e.g. FFh). Range: 0h to FFh. Switches: /S Silent. Suppresses the "OK" confirmation message. Examples: POKE B8000h 41h Write 'A' to first character of text video RAM POKE B8001h 1Fh Write bright-white-on-blue attribute byte POKE B8001h 80h Set blink attribute on first character POKE 46Ch 0h Reset BIOS timer low byte (sets clock toward midnight) POKE 100h FFh /S Write silently, no output Notes: - POKE is an external command; POKE.COM must be available in the current directory or in C:\DOS\. - Addresses and values are entered in hexadecimal with an h suffix. Both uppercase and lowercase hex digits are accepted. - The /S switch may appear anywhere after the two required arguments. WARNING: POKE has direct, unprotected access to all of physical memory. Writing to the wrong address can crash the system immediately and without any error message. There is no undo. In particular: - Addresses 0h-3FFh are the interrupt vector table. Corrupting a vector will cause a crash the next time that interrupt fires. The hardware timer (INT 8h, vector at 20h-23h) fires approximately 18 times per second; corrupting it will crash the system within milliseconds whether or not you are doing anything. - Addresses 84h-87h hold the INT 21h (DOS API) vector. Corrupting this causes a crash on the very next DOS call, which COMMAND.COM makes constantly. - ROM addresses (C0000h and above) cannot be written. The write will silently have no effect. Related commands: PEEK, JMP, HEXDUMP ------------------------------------------------------------------------------- REBOOT - Restart System ------------------------------------------------------------------------------- Restarts the computer. Syntax: REBOOT Parameters: None Notes: - REBOOT is an external command; REBOOT.COM must be available. - All unsaved work will be lost. - This performs a warm boot (restart) of the system. WARNING: Save all work before using REBOOT. ------------------------------------------------------------------------------- REN - Rename File ------------------------------------------------------------------------------- Renames an existing file. Syntax: REN oldname newname RENAME oldname newname Parameters: oldname The current name of the file newname The new name for the file Examples: REN OLD.TXT NEW.TXT RENAME LETTER.DOC LETTER.BAK Notes: - REN and RENAME are identical commands. - Wildcard characters are not supported. - The new name cannot already exist in the same directory. Related commands: COPY ------------------------------------------------------------------------------- RENAME - Rename File ------------------------------------------------------------------------------- Identical to REN. See REN for details. ------------------------------------------------------------------------------- TYPE - Display File Contents ------------------------------------------------------------------------------- Displays the contents of a text file on screen. Syntax: TYPE filename Parameters: filename The file to display Examples: TYPE README.TXT TYPE C:\DOCS\LETTER.DOC Notes: - TYPE is an external command; TYPE.COM must be available. - Use TYPE only on text files. Binary files will display meaningless characters. - For long files, use TYPE filename | MORE to page through the output one screen at a time. Related commands: COPY, HEXDUMP, MORE ------------------------------------------------------------------------------- VER - Display Version ------------------------------------------------------------------------------- Displays the DR DOS version number. Syntax: VER Parameters: None Output: DR DOS 9.0 Copyright 2022-2026 Whitehorn Ltd. Co., All Rights Reserved =============================================================================== REPORTING BUGS AND ISSUES =============================================================================== DR DOS 9.0 is currently in beta testing. We appreciate your help in making DR DOS better by reporting any issues you encounter. During beta testing, you may experience bugs, crashes, system freezes, filesystem corruption, or hardware and software compatibility issues. These are expected during this phase of development, and your reports help us identify and fix problems. WHAT TO REPORT Please report any of the following: - System crashes or freezes - Filesystem corruption or data loss - Programs that don't run correctly - Unexpected error messages - Hardware or software incompatibilities - Any behavior that seems incorrect or unusual HOW TO REPORT A BUG Send an email to: bugs@dr-dos.com Please include the following information in your report: 1. Version and Revision Run the VER command at the DOS prompt to see your version. It will display something like "DR DOS 9.0 rev 80". Include the complete version string in your report. 2. Hardware or Virtualization Environment Examples: - QEMU 10.2 on Windows 11 - VirtualBox 7.0 on Linux - Intel Pentium II PC with 440LX chipset, 128MB RAM - 86Box emulator 3. What You Were Doing Describe the task you were performing when the issue occurred. Examples: - "I was installing Lotus 1-2-3" - "I was playing Commander Keen Episode 1" - "I was copying files from C: to D:" 4. What Happened Describe what you saw on screen. Screenshots or photos are very helpful if possible. Include any error messages exactly as shown. 5. Debug Logs (Optional) Debug logs are only available if you installed the debug build of DR DOS (boot16-debug.img.7z instead of boot16.img.7z). If you're using the debug build, capture the COM1 serial output (115200 baud, 8 data bits, no parity, 1 stop bit): - QEMU: Add "-serial file:debug.log" to your command line - VirtualBox: Enable serial port, set to "Raw File" mode - Physical hardware: Serial cable at 115200 baud, 8-N-1 Most users run the release build and won't have debug logs. That's perfectly fine - the description and screenshots above are sufficient for most bug reports. GETTING HELP Website: https://www.dr-dos.com Bug Reports: bugs@dr-dos.com Check the website for documentation, updates, and known issues. Thank you for helping us improve DR DOS! =============================================================================== APPENDIX A: ERROR MESSAGES =============================================================================== This appendix lists error messages you may encounter and their meanings. Bad command or file name The command you typed is not a built-in command, and no program with that name was found in the current directory or in C:\DOS\. Solution: Check the spelling of the command. Verify that the program file exists in the expected location. File not found - The file you specified does not exist. Solution: Check the spelling of the filename. Use DIR to verify the file exists in the expected location. Invalid directory The directory path you specified does not exist. Solution: Check the spelling of the directory name. Use DIR to see available directories. Required parameter missing A command requires a parameter that you did not provide. Solution: Check the command syntax and provide all required parameters. Unable to create destination file The system could not create the destination file. Solution: Verify that the destination directory exists and that the disk is not write-protected or full. Read error An error occurred while reading from the disk. Solution: The disk may be damaged. Try the operation again. If the problem persists, the disk may need to be replaced. Write error An error occurred while writing to the disk. Solution: The disk may be full, write-protected, or damaged. Check disk space and write-protect status. Access denied - You attempted to access a file that is protected. Solution: The file may be read-only or in use by another program. Clear the read-only attribute before attempting to modify the file. Unable to create directory The system could not create the directory. Solution: Verify that the parent directory exists. The directory you're trying to create must be inside an existing directory. Duplicate file name or file not found An error occurred while renaming a file. Solution: The new name may already exist, or the old name does not exist. Use DIR to verify the file names. Overwrite (Yes/No/All)? The destination file already exists during a MOVE operation. Solution: Enter Y to overwrite this file, N to skip it, or A to overwrite all remaining files without prompting. Error moving file An error occurred while moving a file. Solution: Check the file names and ensure you have permission to access both the source and destination files. File not found No files were found matching the specified pattern. Solution: Check the filename or pattern. Use DIR to see available files. Invalid parameter An invalid parameter was provided. Solution: Check the command syntax and ensure all parameters are valid. Syntax: MOVE source destination The MOVE command was called with incorrect syntax. Solution: Check the MOVE command syntax and ensure you provide both a source and destination. =============================================================================== GLOSSARY =============================================================================== Boot The process of starting up a computer and loading the operating system. Command interpreter The program (COMMAND.COM) that displays the DOS prompt and executes your commands. Command prompt The text displayed by DOS (e.g., C:\>) indicating it is ready to accept a command. Current directory The directory where DOS looks for files by default. Displayed in the command prompt. Directory A container for files and other directories, used to organize the contents of a disk. Drive A device that reads and writes data to storage media. Identified by a letter (C:, D:, etc.). Extension The part of a filename after the period, typically indicating the file type. Limited to 3 characters. External command A command that exists as a separate program file (.COM or .EXE) rather than being built into COMMAND.COM. FAT16 File Allocation Table (16-bit). The filesystem used by DR DOS to organize files on disk. File A named collection of data stored on disk. Internal command A command built into COMMAND.COM, always available without needing a separate program file. LBA Logical Block Addressing. A method of specifying disk sectors preferred by DR DOS for optimal performance. Available on PCs from 1994 onward. Older systems without LBA support can use CHS (Cylinder-Head-Sector) addressing as a fallback. Parameter Information provided to a command that modifies its behavior. Path The complete specification of a file's location, including drive, directories, and filename. Redirection Sending a command's output to a file instead of the screen, using the > operator. Root directory The top-level directory on a disk, from which all other directories branch. Wildcard A special character (* or ?) that matches multiple characters in a filename, used to specify groups of files. =============================================================================== END OF USER GUIDE =============================================================================== WHITEHORN LTD. CO. 3963 S Highway 97 #214 Sand Springs, OK 74063 DR DOS is a registered trademark of Whitehorn Ltd. Co. Copyright (c) 2022-2026 Whitehorn Ltd. Co. All rights reserved.