Programmer sous FreeDOS 1.4

FreeDOS 1.4 est sorti en avril 2025.

Quelques notes, pour mémoire.

Site officiel
Dépôts officiels FreeDOS
Site YouTube FreeDOS

Après avoir installé la version minimale de FreeDOS 1.4 dans VirtualBox, je monte l’image du BonusCD (téléchargée depuis le site officiel sous le nom FD14BNS.iso) dans le lecteur optique virtuel de la machine.

FDIMPLES est un outil visuel et interactif de FreeDOS qui permet de parcourir, installer et supprimer des paquets inclus sur les supports de distribution de FreeDOS (comme les CD Live, BonusCD, etc.). Il s’agit d’un gestionnaire de paquets qui lit les médias d’installation pour identifier les logiciels disponibles à l’installation ou à la suppression. Pour l’utiliser, il suffit de lancer la commande FDIMPLES depuis l’invite de commandes de FreeDOS.

Pour programmer, j’ai choisi le compilateur Open Watcom C/C++et l’ éditeur de texte FED car il permet de plier / déplier le code. J’ai également installé l’assembleur NASM et l’éditeur hexadécimal uHex.

Dans C:\>FDAUTO.BAT, je rajoute à la fin :

cd PERSO

REM *** FED 2.24c ***
alias fed=C:\APPS\FED\FED.EXE

REM *** OPEN WATCOM C/C++ 1.9 ***      => à mettre en dernier
C:\DEVEL\WATCOMC\OWSETENV.BAT

Mémo FED :
Alt pour accéder au menu
CTRL-C pour fermer
CTRL-F pour plier / déplier le code

En pratique, pour être efficace, je n’utilise pas l’éditeur de texte sous FreeDOS :
1 – Je code avec mon éditeur sous Debian.
2 – Dans VirtualBox, Je vérifie que la machine virtuelle FreeDOS 1.4 est éteinte.
3 – J’exécute ce fichier bash (Vers_FreeDOS.sh), le paquet libguestfs-tools étant installé :

#!/bin/bash
# Interpréteur : on utilise bash explicitement

# Si on n'est pas dans un terminal, se relancer dans un terminal graphique
if ! [ -t 1 ]; then
    mate-terminal -e "bash -c '$0; read -p \"Appuie sur Entrée pour fermer...\"'"
    exit
fi

set -e
# Arrête le script immédiatement si une commande échoue (exit on error)
# Évite que les erreurs passent silencieusement et causent des dégâts en cascade

set -x
# Mode debug : affiche chaque commande avant de l'exécuter (précédée de "+")
# Utile pour suivre l'exécution pas à pas

mkdir ~/VHD
# Crée un répertoire temporaire "VHD" dans le dossier home (~)
# Ce dossier servira de point de montage pour l'image disque

cd "/media/$USER/Fichiers Eric/VirtualBox/FreeDOS 1.4"
# Se déplace dans le répertoire contenant l'image VHD
# $USER est automatiquement remplacé par le nom de l'utilisateur courant

guestmount -a "FreeDOS 1.4.vhd" -m /dev/sda1 ~/VHD
# Monte l'image disque VHD via libguestfs (paquet guestfs-tools)
#   -a "FreeDOS 1.4.vhd" : spécifie le fichier image à utiliser
#   -m /dev/sda1         : monte la première partition du disque virtuel
#   ~/VHD                : point de montage (le dossier créé plus haut)
# Permet d'accéder au contenu de la VM sans la démarrer

cp -R "/media/$USER/Fichiers Eric/VirtualBox/FreeDOS 1.4/PERSO" ~/VHD
# Copie récursivement le dossier PERSO dans l'image montée
#   -R : copie les sous-dossiers et fichiers récursivement
# C'est l'opération principale : injecter des fichiers dans la VM

guestunmount ~/VHD
# Démonte proprement l'image VHD
# Équivalent d'un umount, mais adapté aux images guestfs
# Important : à faire avant de supprimer le point de montage

rm -r ~/VHD
# Supprime le répertoire de montage temporaire devenu inutile
#   -r : suppression récursive (nécessaire pour un dossier)
# Nettoyage final — le dossier devrait être vide après guestunmount

# --- Message de succès ---
set +x  # On désactive le mode debug pour un affichage propre
echo ""
echo "✅ Succès ! Le dossier PERSO a été copié dans l'image FreeDOS."
echo ""

4 – Dans VirtualBox, je démarre la machine virtuelle FreeDOS 1.4
5 – Sous FreeDOS, je compile mon fichier source avec : wcl source.c -q

Mon programme de test du mode 13h est ici :
https://github.com/eserandour/Mode13h_OpenWatcom_FreeDOS

https://allthingsopen.org/articles/how-to-write-your-first-freedos-program
https://www.both.org/?p=12007
https://opensource.com/article/21/9/programming-dos-conio