Modules/dos

dos

Code: dos.h

Category: Core

Dependencies: None

Samples:

• s_dos
• s_dos2

✍

The dos module provides access to the functionality of MSX-DOS 1 or 2.

You can found the complete list of MSX-DOS functions on the MSX-DOS 2 Program Interface Specification on the MSX Assembly Page site.

Usage

To use this module, include "dos.h" in your source code, and add "dos" to the modules list (LibModules) in your project's configuration file (project_config.js).

✍

This module simply wraps the MSX-DOS routines. For its use, please refer to the documents describing MSX-DOS features:

• MSX-DOS 2 Program Interface Specification (MSX Assembly Page),
• MSX-DOS 2 Function Specification (MSX Assembly Page),
• MSX2 Technical Handbook - Chapter 3 - MSX-DOS (Konamiman).

Note: Not all MSX-DOS routines have function in this module to encapsulate them in C. If you want certain functions to be added, please ask on the MSXgl's Discord server.

Samples

See module use cases in the sample programs:

• s_dos
• s_dos2

Settings

✍

Library configuration (msxgl_config.h):

#define DOS_USE_FCB					TRUE	// Add support for file managment features through FCB structure
#define DOS_USE_HANDLE				TRUE	// Add support for file managment features through file handle
#define DOS_USE_UTILITIES			TRUE	// Add support for file managment features through filename
#define DOS_USE_VALIDATOR			TRUE	// Add support for last error backup and return value validation

Dependencies

Dependency on other modules: None